API endpoints for hospital management using Laravel

The Hospital Management System (HMS) API provides a set of endpoints to manage hospital operations, appointments, departments, doctors, patients, and user authentication. This README file outlines the available endpoints, their functionalities, and installation instructions.

• POST /signup
  • Create a new user account.
• POST /login
  • Authenticate user credentials.

• GET /appointment
  • Retrieve all appointments (Admin only).
• POST /appointment
  • Create a new appointment (Admin or Patient).
• GET /appointment/:id
  • Get details of a specific appointment (Admin or Patient).
• PUT /appointment/:id
  • Update a specific appointment (Admin or Patient).
• DELETE /appointment/:id
  • Delete a specific appointment (Admin or Patient).

• POST /departments
  • Add a new department (Admin only).
• GET /departments
  • Retrieve all departments (Admin only).
• GET /department/doctors/:_id
  • Retrieve doctors in a specific department (Admin only).
• GET /department/patients/:_id
  • Retrieve patients in a specific department (Admin only).
• GET /department/:_id
  • Get details of a specific department (Admin only).
• DELETE /department/:_id
  • Delete a specific department (Admin only).
• PUT /department/:_id
  • Update a specific department (Admin only).

• POST /doctors
  • Add a new doctor (Admin only).
• GET /doctors
  • Retrieve all doctors (Admin only).
• GET /doctor/:id
  • Get details of a specific doctor (Admin or Doctor).
• PUT /doctor/:id
  • Update a specific doctor (Admin or Doctor).
• DELETE /doctor/:id
  • Delete a specific doctor (Admin or Doctor).

• POST /patients
  • Add a new patient (Admin only).
• GET /patients
  • Retrieve all patients (Admin only).
• GET /patient/:_id
  • Get details of a specific patient (Admin or Patient).
• PUT /patient/:_id
  • Update a specific patient (Admin or Patient).
• DELETE /patient/:_id
  • Delete a specific patient (Admin or Patient).

• GET /user
  • Retrieve all users (Admin only).
• GET /user/:_id
  • Get details of a specific user (Admin only).

• Authentication is required for most routes using JWT tokens (protect middleware).
• Different roles (admin, doctor, patient) have different levels of access (restrictedTo middleware).

1. Clone the repository:

   git clone https://github.com/sohilaehab25/hospital_system cd hospital_system

2. Configure environment variables:

   • Copy .env.example to .env and update with your settings in the backend.

3. Install dependencies:

   • Install backend dependencies:

     npm install

   • Run the development server:

     nodemon app.js

Contributions are welcome! Follow these steps:

• Fork the repository.
• Create a new branch: git checkout -b feature/your-feature.
• Commit your changes: git commit -am 'Add new feature'.
• Push to the branch: git push origin feature/your-feature.
• Submit a PR (pull request).

For questions or feedback, contact Sohila Ehab at [email protected] or visit GitHub.