{"id":30523670,"url":"https://github.com/rootcode-creator/web-based-organ-donation-system","last_synced_at":"2026-04-11T03:31:17.609Z","repository":{"id":173894635,"uuid":"651444038","full_name":"rootcode-creator/Web-based-Organ-Donation-System","owner":"rootcode-creator","description":"Web application to facilitate the Organ Donation process","archived":false,"fork":false,"pushed_at":"2026-04-09T05:12:45.000Z","size":19116,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-09T07:25:42.939Z","etag":null,"topics":["backend","bootstrap5","css3","front-end","html5","javascript","mysql","mysql-database","php"],"latest_commit_sha":null,"homepage":"https://organ.kawserahmed.tech","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rootcode-creator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-06-09T08:48:56.000Z","updated_at":"2026-04-09T05:12:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"c9beba4d-a514-4421-b649-02202cca3399","html_url":"https://github.com/rootcode-creator/Web-based-Organ-Donation-System","commit_stats":null,"previous_names":["md-kawser/organdonation","rootcode-creator/web-based-organ-donation-system"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rootcode-creator/Web-based-Organ-Donation-System","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootcode-creator%2FWeb-based-Organ-Donation-System","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootcode-creator%2FWeb-based-Organ-Donation-System/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootcode-creator%2FWeb-based-Organ-Donation-System/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootcode-creator%2FWeb-based-Organ-Donation-System/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rootcode-creator","download_url":"https://codeload.github.com/rootcode-creator/Web-based-Organ-Donation-System/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootcode-creator%2FWeb-based-Organ-Donation-System/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31668046,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T17:19:37.612Z","status":"online","status_checked_at":"2026-04-11T02:00:05.776Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["backend","bootstrap5","css3","front-end","html5","javascript","mysql","mysql-database","php"],"created_at":"2025-08-26T20:43:48.774Z","updated_at":"2026-04-11T03:31:17.601Z","avatar_url":"https://github.com/rootcode-creator.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# web-based-organ-donation-system — README\n\nRole-based PHP/MySQL web application for organ request management, doctor review, admin approval workflow, and prescription-to-medicine fulfillment.\n\n## Table of Contents\n- 🚀 Project intro\n- 📁 Project structure\n- ⭐ Differentiators\n- 🔧 Features\n- 🧰 Tech stack\n- ⚙️ Install methods\n  - 📦 XAMPP / WAMP / LAMP (Apache + PHP + MySQL)\n- 🔐 Configuration\n- 🗄️ Database structure\n- 📜 Entry points\n- 🚀 Deployment notes\n- 🤝 Contributing\n- 📄 License\n\n## 🚀 Project intro\n\n`web-based-organ-donation-system` is a multi-role healthcare workflow app with:\n\n- User registration/login and organ application submission\n- Admin review, doctor assignment, and final approve/reject actions\n- Doctor recommendation and prescription generation\n- Pharmacist medicine inventory and order processing\n- End-to-end medicine ordering and delivery status tracking\n\nIt is designed as an academic/project-friendly foundation for organ donation and associated treatment operations.\n\n## 📁 Project structure\n\n```text\nWeb-based-Organ-Donation-System/\n├── index.html\n├── style.css\n├── README.md\n├── LICENSE\n├── Image/\n├── admins/\n│   ├── dashboard.php\n│   ├── adminsignin.php / adminsignup.php\n│   ├── accept.php / doctorassign.php / assign.php\n│   ├── addpharmacy.php\n│   ├── userdelete.php / doctordelete.php / applicationdelete.php\n│   ├── inc/\n│   │   ├── config.php\n│   │   └── head.php\n│   ├── css/ js/ images/ fonts/\n│   └── ...\n├── users/\n│   ├── dashboard.php\n│   ├── signin.php / signup.php\n│   ├── organ.php\n│   ├── ordermedicine.php / ordermedicinepannel.php\n│   ├── usercomment.php / userpriceacceptreject.php\n│   ├── css/ images/ fonts/\n│   └── ...\n├── doctors/\n│   ├── doctorshomepage.php\n│   ├── doctorsignin.php / doctorsignup.php\n│   ├── accept.php\n│   ├── prescription.php\n│   ├── inc/\n│   │   ├── config.php\n│   │   └── head.php\n│   ├── css/ js/ images/ fonts/\n│   └── ...\n└── pharmacist/\n    ├── dashboard.php\n    ├── pharmacistsignin.php / pharmacistsignup.php\n    ├── addmedicine.php / medicinedetailsupdate.php\n    ├── priceupdate.php / deliverystatuschange.php\n    ├── inc/\n    │   ├── config.php\n    │   └── head.php\n    ├── css/ js/ images/\n    └── ...\n```\n\n## ⭐ Differentiators\n\n- Full role separation (`Admin`, `User`, `Doctor`, `Pharmacist`) with dedicated dashboards\n- Practical workflow from organ request → doctor recommendation → admin decision\n- Integrated post-approval prescription and pharmacy order lifecycle\n- Bootstrap-based UI with modal-driven dashboard operations\n\n## 🔧 Features\n\n### Core features\n\n| Feature | Status | Details |\n|---|---|---|\n| User authentication | ✅ Current | Signup/signin/logout for users |\n| Admin authentication | ✅ Current | Admin account management and dashboard access |\n| Doctor authentication | ✅ Current | Doctor signup/signin and assigned application view |\n| Pharmacist authentication | ✅ Current | Pharmacist signup/signin and medicine/order handling |\n| Organ application | ✅ Current | Users submit organ requests with date/reason |\n| Doctor assignment | ✅ Current | Admin assigns doctors to pending applications |\n| Application decision | ✅ Current | Admin approves/rejects applications |\n| Recommendation flow | ✅ Current | Doctors write recommendation/decision for assigned cases |\n| Prescription flow | ✅ Current | Doctors create prescriptions for approved cases |\n| Medicine order flow | ✅ Current | Users place orders from prescriptions |\n| Pharmacy operations | ✅ Current | Stock updates, pricing, comments, delivery updates |\n\n### Role protection behavior\n\n- Public entry: `/index.html`\n- Admin routes: under `/admins/*` (requires admin session)\n- User routes: under `/users/*` (requires user session)\n- Doctor routes: under `/doctors/*` (requires doctor session)\n- Pharmacist routes: under `/pharmacist/*` (requires pharmacist session)\n\n## 🧰 Tech stack\n\n- Backend: PHP (procedural style with mysqli)\n- Database: MySQL / MariaDB\n- Frontend: HTML, CSS, Bootstrap, JavaScript, jQuery\n- Hosting target: Apache + PHP runtime (XAMPP/WAMP/LAMP compatible)\n\n## ⚙️ Install methods\n\n### 📦 XAMPP / WAMP / LAMP (Apache + PHP + MySQL)\n\nPrerequisites:\n\n- PHP 7.4+ (or newer)\n- MySQL/MariaDB\n- Apache web server\n\n```bash\ngit clone https://github.com/rootcode-creator/Web-based-Organ-Donation-System.git\ncd Web-based-Organ-Donation-System\n```\n\n1. Copy project into your web root (`htdocs` / `www`).\n2. Create/import the MySQL database schema used by this project.\n3. Configure database connection in each role config file:\n   - `admins/inc/config.php`\n   - `doctors/inc/config.php`\n   - `pharmacist/inc/config.php`\n4. Start Apache + MySQL.\n5. Open `http://localhost/Web-based-Organ-Donation-System/`.\n\n## 🔐 Configuration\n\nThis project does not use `.env` by default. It uses direct DB config in PHP files:\n\n```php\n$host = \"localhost\";\n$dbUsername = \"your_db_user\";\n$dbPassword = \"your_db_password\";\n$dbName = \"your_db_name\";\n```\n\nImportant notes:\n\n- Keep the three role config files synchronized.\n- Do not commit real production credentials.\n- Rotate any exposed credentials before deployment.\n\n## 🗄️ Database structure\n\nMain tables used in codebase:\n\n- `users`\n- `admins`\n- `doctors`\n- `pharmacist`\n- `pharmacy`\n- `organ`\n- `prescription`\n- `ordermedicine`\n- `stockmedicine`\n\nTypical relationships/workflow:\n\n- `users` submit to `organ`\n- `admins` assign doctor (`organ.doctor_info`) and set application status\n- `doctors` write recommendations and insert into `prescription`\n- `users` place orders into `ordermedicine`\n- `pharmacist` updates `stockmedicine`, pricing, comments, and delivery status\n\n## 📜 Entry points\n\n- Landing page: `index.html`\n- Admin login: `admins/adminsignin.html`\n- User login: `users/signin.html`\n- Doctor login: `doctors/doctorsignin.html`\n- Pharmacist login: `pharmacist/pharmacistsignin.html`\n\n## 🚀 Deployment notes\n\n- Ensure all module-level `config.php` files point to the same database.\n- Use HTTPS and secure session settings in production.\n- Add server-side validation/sanitization hardening before public deployment.\n- Migrate credentials from source files to environment variables for safer operations.\n\n## 🤝 Contributing\n\n- Fork the repository and create a focused feature branch.\n- Keep pull requests scoped and include test/verification steps.\n- Avoid committing credentials, secrets, or production config.\n\n## 📄 License\n\nThis repository includes a `LICENSE` file. See that file for licensing terms.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frootcode-creator%2Fweb-based-organ-donation-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frootcode-creator%2Fweb-based-organ-donation-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frootcode-creator%2Fweb-based-organ-donation-system/lists"}