https://github.com/rootcode-creator/web-based-organ-donation-system
Web application to facilitate the Organ Donation process
https://github.com/rootcode-creator/web-based-organ-donation-system
backend bootstrap5 css3 front-end html5 javascript mysql mysql-database php
Last synced: 2 months ago
JSON representation
Web application to facilitate the Organ Donation process
- Host: GitHub
- URL: https://github.com/rootcode-creator/web-based-organ-donation-system
- Owner: rootcode-creator
- License: mit
- Created: 2023-06-09T08:48:56.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2026-04-09T05:12:45.000Z (2 months ago)
- Last Synced: 2026-04-09T07:25:42.939Z (2 months ago)
- Topics: backend, bootstrap5, css3, front-end, html5, javascript, mysql, mysql-database, php
- Language: PHP
- Homepage: https://organ.kawserahmed.tech
- Size: 18.2 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# web-based-organ-donation-system — README
Role-based PHP/MySQL web application for organ request management, doctor review, admin approval workflow, and prescription-to-medicine fulfillment.
## Table of Contents
- 🚀 Project intro
- 📁 Project structure
- ⭐ Differentiators
- 🔧 Features
- 🧰 Tech stack
- ⚙️ Install methods
- 📦 XAMPP / WAMP / LAMP (Apache + PHP + MySQL)
- 🔐 Configuration
- 🗄️ Database structure
- 📜 Entry points
- 🚀 Deployment notes
- 🤝 Contributing
- 📄 License
## 🚀 Project intro
`web-based-organ-donation-system` is a multi-role healthcare workflow app with:
- User registration/login and organ application submission
- Admin review, doctor assignment, and final approve/reject actions
- Doctor recommendation and prescription generation
- Pharmacist medicine inventory and order processing
- End-to-end medicine ordering and delivery status tracking
It is designed as an academic/project-friendly foundation for organ donation and associated treatment operations.
## 📁 Project structure
```text
Web-based-Organ-Donation-System/
├── index.html
├── style.css
├── README.md
├── LICENSE
├── Image/
├── admins/
│ ├── dashboard.php
│ ├── adminsignin.php / adminsignup.php
│ ├── accept.php / doctorassign.php / assign.php
│ ├── addpharmacy.php
│ ├── userdelete.php / doctordelete.php / applicationdelete.php
│ ├── inc/
│ │ ├── config.php
│ │ └── head.php
│ ├── css/ js/ images/ fonts/
│ └── ...
├── users/
│ ├── dashboard.php
│ ├── signin.php / signup.php
│ ├── organ.php
│ ├── ordermedicine.php / ordermedicinepannel.php
│ ├── usercomment.php / userpriceacceptreject.php
│ ├── css/ images/ fonts/
│ └── ...
├── doctors/
│ ├── doctorshomepage.php
│ ├── doctorsignin.php / doctorsignup.php
│ ├── accept.php
│ ├── prescription.php
│ ├── inc/
│ │ ├── config.php
│ │ └── head.php
│ ├── css/ js/ images/ fonts/
│ └── ...
└── pharmacist/
├── dashboard.php
├── pharmacistsignin.php / pharmacistsignup.php
├── addmedicine.php / medicinedetailsupdate.php
├── priceupdate.php / deliverystatuschange.php
├── inc/
│ ├── config.php
│ └── head.php
├── css/ js/ images/
└── ...
```
## ⭐ Differentiators
- Full role separation (`Admin`, `User`, `Doctor`, `Pharmacist`) with dedicated dashboards
- Practical workflow from organ request → doctor recommendation → admin decision
- Integrated post-approval prescription and pharmacy order lifecycle
- Bootstrap-based UI with modal-driven dashboard operations
## 🔧 Features
### Core features
| Feature | Status | Details |
|---|---|---|
| User authentication | ✅ Current | Signup/signin/logout for users |
| Admin authentication | ✅ Current | Admin account management and dashboard access |
| Doctor authentication | ✅ Current | Doctor signup/signin and assigned application view |
| Pharmacist authentication | ✅ Current | Pharmacist signup/signin and medicine/order handling |
| Organ application | ✅ Current | Users submit organ requests with date/reason |
| Doctor assignment | ✅ Current | Admin assigns doctors to pending applications |
| Application decision | ✅ Current | Admin approves/rejects applications |
| Recommendation flow | ✅ Current | Doctors write recommendation/decision for assigned cases |
| Prescription flow | ✅ Current | Doctors create prescriptions for approved cases |
| Medicine order flow | ✅ Current | Users place orders from prescriptions |
| Pharmacy operations | ✅ Current | Stock updates, pricing, comments, delivery updates |
### Role protection behavior
- Public entry: `/index.html`
- Admin routes: under `/admins/*` (requires admin session)
- User routes: under `/users/*` (requires user session)
- Doctor routes: under `/doctors/*` (requires doctor session)
- Pharmacist routes: under `/pharmacist/*` (requires pharmacist session)
## 🧰 Tech stack
- Backend: PHP (procedural style with mysqli)
- Database: MySQL / MariaDB
- Frontend: HTML, CSS, Bootstrap, JavaScript, jQuery
- Hosting target: Apache + PHP runtime (XAMPP/WAMP/LAMP compatible)
## ⚙️ Install methods
### 📦 XAMPP / WAMP / LAMP (Apache + PHP + MySQL)
Prerequisites:
- PHP 7.4+ (or newer)
- MySQL/MariaDB
- Apache web server
```bash
git clone https://github.com/rootcode-creator/Web-based-Organ-Donation-System.git
cd Web-based-Organ-Donation-System
```
1. Copy project into your web root (`htdocs` / `www`).
2. Create/import the MySQL database schema used by this project.
3. Configure database connection in each role config file:
- `admins/inc/config.php`
- `doctors/inc/config.php`
- `pharmacist/inc/config.php`
4. Start Apache + MySQL.
5. Open `http://localhost/Web-based-Organ-Donation-System/`.
## 🔐 Configuration
This project does not use `.env` by default. It uses direct DB config in PHP files:
```php
$host = "localhost";
$dbUsername = "your_db_user";
$dbPassword = "your_db_password";
$dbName = "your_db_name";
```
Important notes:
- Keep the three role config files synchronized.
- Do not commit real production credentials.
- Rotate any exposed credentials before deployment.
## 🗄️ Database structure
Main tables used in codebase:
- `users`
- `admins`
- `doctors`
- `pharmacist`
- `pharmacy`
- `organ`
- `prescription`
- `ordermedicine`
- `stockmedicine`
Typical relationships/workflow:
- `users` submit to `organ`
- `admins` assign doctor (`organ.doctor_info`) and set application status
- `doctors` write recommendations and insert into `prescription`
- `users` place orders into `ordermedicine`
- `pharmacist` updates `stockmedicine`, pricing, comments, and delivery status
## 📜 Entry points
- Landing page: `index.html`
- Admin login: `admins/adminsignin.html`
- User login: `users/signin.html`
- Doctor login: `doctors/doctorsignin.html`
- Pharmacist login: `pharmacist/pharmacistsignin.html`
## 🚀 Deployment notes
- Ensure all module-level `config.php` files point to the same database.
- Use HTTPS and secure session settings in production.
- Add server-side validation/sanitization hardening before public deployment.
- Migrate credentials from source files to environment variables for safer operations.
## 🤝 Contributing
- Fork the repository and create a focused feature branch.
- Keep pull requests scoped and include test/verification steps.
- Avoid committing credentials, secrets, or production config.
## 📄 License
This repository includes a `LICENSE` file. See that file for licensing terms.