{"id":22807985,"url":"https://github.com/mohdali300/hmsphere","last_synced_at":"2025-04-22T12:42:32.927Z","repository":{"id":265533746,"uuid":"875819509","full_name":"mohdali300/HMSphere","owner":"mohdali300","description":"DEPI - Graduation Project Hospital Management System with ASP.NET MVC","archived":false,"fork":false,"pushed_at":"2024-12-20T13:30:10.000Z","size":6416,"stargazers_count":2,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T15:12:01.136Z","etag":null,"topics":["authentication","clean-architecture","dotnet-core","hospital-management-system","mvc"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mohdali300.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-20T22:40:20.000Z","updated_at":"2025-01-28T12:09:55.000Z","dependencies_parsed_at":"2024-11-29T20:30:52.374Z","dependency_job_id":null,"html_url":"https://github.com/mohdali300/HMSphere","commit_stats":null,"previous_names":["mohdali300/hmsphere"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohdali300%2FHMSphere","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohdali300%2FHMSphere/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohdali300%2FHMSphere/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohdali300%2FHMSphere/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mohdali300","download_url":"https://codeload.github.com/mohdali300/HMSphere/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250242853,"owners_count":21398210,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["authentication","clean-architecture","dotnet-core","hospital-management-system","mvc"],"created_at":"2024-12-12T11:07:26.719Z","updated_at":"2025-04-22T12:42:32.917Z","avatar_url":"https://github.com/mohdali300.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HMSphere - Hospital Management System (V.1)\n\nHMSphere is a web-based hospital management system built using **ASP.NET Core MVC**. The project streamlines hospital operations by managing patient appointments, medical records, and staff scheduling. The system offers role-based access control, ensuring that patients, doctors, and administrators have access only to the features relevant to their roles.\n\n## Table of Contents\n\n1. [Project Features](#project-features)\n2. [Technologies Used](#technologies-used)\n3. [Setup Instructions](#setup-instructions)\n4. [UI](#ui)\n5. [Usage](#usage)\n6. [Team](#contributers-team)\n7. [Contribution Guidelines](#contribution-guidelines)\n8. [Contact Information](#contact-information)\n\n## Project Features\n\n#### Patient Management\n- Patients can book and manage appointments.\n- Access to personal medical records.\n#### Doctor Features\n- View and update patient records.\n- Manage schedules.\n#### Administrative Features\n- Manage doctor schedules and patient records.\n- Oversee staff schedules and hospital operations.\n#### Role-Based Access Control\nEnsures each user role (patients, doctors, administrators) accesses only the data relevant to their role.\n\n## Technologies Used\n\n- **ASP.NET Core MVC**: For building the web application.\n- **Entity Framework Core**: For database management and interactions.\n- **MS SQL Server**: Database provider.\n- **ASP.NET Core Identity**: Role-based authentication and authorization.\n- **MailKit and MimeKit**: For email notifications and services.\n- **AutoMapper and Repository Pattern**: For efficient model mapping and service architecture.\n- **Clean Architecture**: For a layered project structure ensuring scalability and maintainability.\n\n## Setup Instructions\n\n1. **Clone the Repository**:\n```bash\ngit clone https://github.com/mohdali300/HMSphere.git\ncd HMSphere\n```\n2. **Set Up the Database**:\n    - Ensure **MS SQL Server** is installed and running.\n    - Update the `appsettings.json` file with your database connection string:\n      ```json\n      \"ConnectionStrings\": {\n        \"DefaultConnection\": \"Data Source=.;Initial Catalog=HMSphereDB;Integrated Security=True;Trust Server Certificate=True;\"\n      }\n      ```\n3. **Run Database Migrations**:\n    - Open a terminal in the project directory and run:\n      ```bash\n      dotnet ef database update\n      ```\n4. **Install Dependencies**:\n    - Restore NuGet packages:\n      ```bash\n      dotnet restore\n      ```\n5. **Run the Application**:\n    - Start the application using:\n      ```bash\n      dotnet run\n      ```\n    - Open your browser and navigate to `http://localhost:(your local)`.\n6. **Default Roles and Users**:\n    - run data seed in program.cs.\n    - Create accounts for testing or log in with predefined credentials.\n\n## Usage\n\n1. **Patient Portal**: Patients can log in to:\n   - Book and view upcoming appointments.\n   - Access their medical records.\n2. **Doctor Dashboard**: Doctors can:\n   - View their schedules and assigned patients.\n   - Update patient records.\n3. **Admin Panel**: Administrators can:\n   - Manage schedules for doctors and staff.\n   - Oversee patient records and hospital operations.\n\n## UI\nsome UIs:\n\n\u003cimg src=\"HMSphere.MVC/wwwroot/images/ui/Screenshot 2024-12-19 221905.png\" alt=\"1\" width=\"350\"/\u003e \n\u003cimg src=\"HMSphere.MVC/wwwroot/images/ui/Screenshot 2024-12-16 200225.png\" alt=\"1\" width=\"350\"/\u003e\n\u003cimg src=\"HMSphere.MVC/wwwroot/images/ui/Screenshot 2024-12-16 200324.png\" alt=\"1\" width=\"350\"/\u003e\n\u003cimg src=\"HMSphere.MVC/wwwroot/images/ui/Screenshot 2024-12-16 200701.png\" alt=\"1\" width=\"350\"/\u003e\n\u003cimg src=\"HMSphere.MVC/wwwroot/images/ui/Screenshot 2024-12-16 200343.png\" alt=\"1\" width=\"350\"/\u003e\n\u003cimg src=\"HMSphere.MVC/wwwroot/images/ui/Screenshot 2024-12-16 200810.png\" alt=\"1\" width=\"350\"/\u003e\n\u003cimg src=\"HMSphere.MVC/wwwroot/images/ui/Screenshot 2024-12-20 002019.png\" alt=\"1\" width=\"350\"/\u003e\n\u003cimg src=\"HMSphere.MVC/wwwroot/images/ui/Screenshot 2024-12-20 002141.png\" alt=\"1\" width=\"350\"/\u003e\n\n## Contributers Team\n- [**Mohamed Ali**](https://github.com/mohdali300)\n- [**Ahmed Nasser**](https://github.com/AhmedNasser03)\n- [**Rawan Adel**](https://github.com/R0wanAdel)\n- [**Eman Hamam**](https://github.com/EmanHamam)\n- [**Nermeen Ashraf**](https://github.com/0xNermeenaa)\n- [**Nahla Mohamed**](https://github.com/nahla-mo)\n\n## Contribution Guidelines\n\nWe welcome contributions to enhance HMSphere! If you'd like to contribute:\n1. Star and Fork the repository.\n2. Create a new branch for your feature or bugfix.\n3. Submit a pull request describing your changes.\n\n## Contact Information\n\nIf you have any questions or suggestions, feel free to contact us.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohdali300%2Fhmsphere","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmohdali300%2Fhmsphere","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohdali300%2Fhmsphere/lists"}