Webmedium - Online Medium Consultation Platform

Description

Webmedium is a web-based application that facilitates online consultations between clients and mediums/spiritual advisors. The platform provides a comprehensive system for managing consultations, user profiles, and employee interactions.

Features

• User Authentication and Registration
• Client Profile Management
• Medium/Employee Profile Management
• Consultation Scheduling and Management
• Consultation History Tracking
• Real-time Predictions Generation
• Statistical Analysis and Reporting
• Employee Performance Monitoring

Technical Stack

• Backend: Java EE
• Architecture: MVC (Model-View-Controller)
• Build Tool: Maven
• Server: Apache Tomcat
• Packaging: WAR (Web Application Archive)

Project Structure

src/
├── main/
│   ├── java/
│   │   └── web/
│   │       ├── controleur/    # Servlet and Controller classes
│   │       ├── modele/        # Business logic and Action classes
│   │       └── vue/          # Serialization classes
│   └── webapp/               # Web resources
│       ├── META-INF/
│       ├── WEB-INF/
│       └── *.html           # Web pages

Setup and Installation

Prerequisites Installation

1. Install Java JDK:

   • Download Java JDK 8 or later from Oracle's website or OpenJDK
   • Run the installer
   • Add Java to your system PATH:
     • Open System Properties → Advanced → Environment Variables
     • Add JAVA_HOME variable pointing to your JDK installation folder
     • Add %JAVA_HOME%\bin to your PATH variable
   • Verify installation: Open a new terminal and run java -version

2. Install Apache Maven:

   • Download Maven from Maven's website
   • Extract to a folder (e.g., C:\Program Files\Apache\maven)
   • Add Maven to PATH:
     • Add M2_HOME variable pointing to Maven folder
     • Add %M2_HOME%\bin to PATH
   • Verify installation: Run mvn -version

3. Install Apache Tomcat:

   • Download Tomcat 9.x from Tomcat's website
   • Extract to a folder (e.g., C:\Program Files\Apache\tomcat)
   • Optional: Configure Tomcat as a service
   • Set CATALINA_HOME environment variable to Tomcat installation directory

Project Setup

1. Clone the repository:

   git clone https://github.com/Ibra2477/Webmedium-.git
   cd Webmedium-

2. Build the project:

   mvn clean install

3. Deploy to Tomcat:

   • Copy target/webmedium-1.0-SNAPSHOT.war to %CATALINA_HOME%\webapps\
   • Rename to webmedium.war (optional)

4. Start Tomcat:

   • Go to %CATALINA_HOME%\bin
   • Run startup.bat (Windows) or startup.sh (Linux/Mac)
   • Wait for deployment to complete (check %CATALINA_HOME%\logs\catalina.out)

5. Access the Application:

   • Open your web browser
   • Navigate to http://localhost:8080/webmedium
   • Default port is 8080 (can be changed in Tomcat's server.xml)

Troubleshooting

1. Port Conflicts:

   • If port 8080 is in use, modify %CATALINA_HOME%\conf\server.xml
   • Change the Connector port to an available port

2. Database Connection:

   • Verify database credentials in META-INF/context.xml
   • Ensure database server is running

3. Common Issues:

   • If you see 404 errors, check if the WAR file was deployed correctly
   • For 500 errors, check Tomcat's logs in %CATALINA_HOME%\logs
   • For build errors, ensure Maven can access all required dependencies

Usage

1. Access the application through your web browser
2. New users can register through the inscription page
3. Existing users can log in through the connexion page
4. Clients can:
   • View available mediums
   • Schedule consultations
   • View consultation history
   • Access their profile
5. Employees (Mediums) can:
   • View assigned consultations
   • Manage consultation sessions
   • Access their work history
   • View performance statistics

Key Files

• ActionServlet.class: Main controller servlet
• Action.class: Base class for all actions
• Various action classes for different functionalities:
  • ConnexionAction.class
  • ConsultationEmployeAction.class
  • ContacterMediumAction.class
  • etc.

Pages

• accueil.html: Home page
• connexion.html: Login page
• inscription.html: Registration page
• profilClient.html: Client profile page
• consultationEmploye.html: Employee consultation page
• statistiques.html: Statistics dashboard
• And more...

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

[Add your license information here]

Authors

• Ibra2477