Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mmansy19/medscansurg-hospital-management-system

This is the codebase for the Medical Department website. The website provides information about the services, doctors, testimonials, and other relevant details of the medical department.
https://github.com/mmansy19/medscansurg-hospital-management-system

bootstrap css flask html javascript python

Last synced: about 1 month ago
JSON representation

This is the codebase for the Medical Department website. The website provides information about the services, doctors, testimonials, and other relevant details of the medical department.

Host: GitHub
URL: https://github.com/mmansy19/medscansurg-hospital-management-system
Owner: MMansy19
Created: 2023-12-26T13:49:11.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-02-25T17:01:13.000Z (10 months ago)
Last Synced: 2024-02-25T18:25:09.433Z (10 months ago)
Topics: bootstrap, css, flask, html, javascript, python
Language: HTML
Homepage: https://www.linkedin.com/posts/mahmoud-mansy-a189a5232_flask-postgresql-javascript-activity-7148705855813701633-M69Z?utm_source=share&utm_medium=member_desktop
Size: 7.18 MB
Stars: 2
Watchers: 1
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# 𝐌𝐞𝐝𝐒𝐜𝐚𝐧𝐒𝐮𝐫𝐠 𝐂𝐨𝐧𝐧𝐞𝐜𝐭 🌐💻

**MedScanSurg Connect** streamlines and empowers patients, providing a user-friendly portal for scheduling scans, radiology & surgery appointments, and surgeries, fostering efficient healthcare access and choices. This project is a Flask-based web application for managing a Radiology & Surgery Department database. It allows users to login as patients, doctors, or administrators, schedule appointments, and manage user profiles.

## 🎥 [Watch the Demo Video](https://www.linkedin.com/feed/update/urn:li:activity:7148705855813701633/)

## Table of Contents
1. [Project Overview](#project-overview)
2. [Project Structure](#project-structure)
3. [Routes and Functions](#routes-and-functions)
4. [Additional Functions](#additional-functions)
5. [Running the Flask App](#running-the-flask-app)
6. [How to Contribute](#how-to-contribute)
7. [Contact](#contact)

## Project Overview
**MedScanSurg Connect** is a comprehensive full-stack web application designed to cater to the unique needs of the Radiology & Surgery Department. Developed using front-end technologies such as HTML, CSS, and JS, coupled with the Python Flask web micro framework, this project aims to provide a dynamic and responsive system. The application seamlessly integrates essential features of a Hospital Information System (HIS), specifically tailored for the Radiology & Surgery Department.

## ![Project Planning](Planning/project-1.jpeg)

## Planning
![Project Planning](Planning/Planning.jpeg)

## Entity Relationship Model
![Entity Relationship Model](Planning/ER_model.jpg)

## Project Structure

- `website`: Contains the main Flask application.
- `__init__.py`: Initializes the Flask app.
- `models.py`: Defines the database models.
- `views.py`: Contains the main views and routes.

- `static`: Contains static files (CSS, JS, images).
- `profile_pics`: Stores user profile pictures (for patients and Doctors).
- `scans`: Stores scans uploaded by doctors.
- ...

- `templates`: Contains HTML templates for rendering pages.
- `admin.html`: Admin dashboard.
- `appointments.html`: Appointments page.
- `doctor.html`: Doctor dashboard.
- `index.html`: Home page.
- `login.html`: Login and registration page.
- `patient.html`: Patient dashboard.
- ...

- `instance`: Contains instance-specific configuration files.

- `database.db`: SQLite database file.

## Routes and Functions

1. **🏠 Home Page:**
- Route: `/`
- Function: `index`

2. **🔐 Login:**
- Route: `/login`
- Function: `login`

3. **👨‍⚕️ Doctor Profile:**
- Route: `/doctor/`
- Function: `doctor`

4. **📄 Scan Details:**
- Route: `/scan_detail/`
- Function: `scan_detail`

5. **👀 View Patient Information:**
- Route: `/view_patient_info/`
- Function: `view_patient_info`

6. **👩‍⚕️ Patient Dashboard:**
- Route: `/patient/`
- Function: `patient`

7. **🔄 Get Doctors (AJAX):**
- Route: `/get_doctors`
- Function: `get_doctors`

8. **📊 Admin Dashboard:**
- Route: `/admin`
- Function: `admin`

9. **✏️ Edit Doctor's Profile:**
- Route: `/edit_doctor/`
- Function: `edit_doctor`

10. **🗑️ Delete Doctor:**
- Route: `/delete_doctor/`
- Function: `delete_doctor_route`

## Additional Functions

1. ### ✏️ Editing a Doctor's Profile

To edit a doctor's profile, visit the `/edit_doctor/` route. The admin can manage doctors' information, including their profile pictures.

2. ### ➕ Adding a New Doctor

To add a new doctor, go to the `/admin` route and fill in the required information in the form.

3. ### 📅 Managing Appointments

Patients can schedule appointments by visiting the `/appointments/` route. Doctors and administrators can view and manage appointments.

4. ### 📄 Adding Scan

To add a new scan, visit the `/add_scan` route. Doctors can upload scans for further analysis.

5. ### 👀 Showing Patient Info

To view detailed information about a patient, go to the `/view_patient_info/` route. Access patient records and history.

6. ### 🏥 Choosing a Surgery Doctor

Patients can choose a surgery doctor by visiting the `/choose_surgery_doctor` route. Select a doctor and schedule surgery appointments.

## Running the Flask App

1. Open a terminal and navigate to the project directory:

```bash
cd C:\your_path\MedScanSurg-Connect
```

2. If you don't have a virtual environment, create one:

```bash
virtualenv venv
```

3. Activate the virtual environment:

```bash
venv\Scripts\activate
```

4. Install the required packages:

```bash
pip install -r requirements.txt
```

5. Run the Flask app:

```bash
python app.py
```

## How to Contribute

1. Fork the repository.
2. Clone the forked repository to your local machine.
3. Create a new branch for your feature or bug fix: `git checkout -b feature/your-feature-name` or `git checkout -b bugfix/your-bugfix-name`.
4. Make changes and commit them: `git commit -m "Your message here"`.
5. Push the changes to your fork: `git push origin feature/your-feature-name` or `git push origin bugfix/your-bugfix-name`.
6. Create a pull request in the original repository.

## Contact

- [Author](https://github.com/MMansy19)
- [Website](https://mahmoud-mansy-portfolio.netlify.app/)
- [Email](mailto:[email protected])
- [LinkedIn](https://www.linkedin.com/in/mahmoud-mansy-a189a5232)

Happy coding!