Blood Bank and Donor Management Portal

Blood bank portal with donor eligibility, screening, 42-day blood units, hospital requests with first-expiry-first-out issue, donor alerts, camps and certificates. Python, Flask, Bootstrap, SQLite.

  • Price: ₹1,999
  • Category: Web App
  • Technology: Python, Flask, Bootstrap 5, SQLite, Chart.js
  • Includes: Source code + database
  • Suitable for: BCA / B.Sc CS, MCA / M.Sc CS, B.E / B.Tech CSE & IT

Project overview

This is a full blood bank website that runs on a normal PC. There are three roles. Blood bank staff manage donors, run the donation desk (screening of haemoglobin, weight, pulse and blood pressure), release or discard units after the lab test, watch the stock by blood group (OK, Low, Critical, expiring soon), handle the hospital request queue (emergency first), manage hospitals and camps and read the insights page (stock against demand, days of cover, wastage, top donors, camp results). Hospitals send requests and see the availability. Donors see whether they can donate today (or in how many days), their history, badges (Bronze, Silver, Gold), alerts, blood camps and a QR donor card, and download a PDF certificate for every donation. Anybody can open the public availability board and register as a donor. Security: hashed passwords, a lock after 5 wrong passwords, CSRF tokens in every form, role checks on every page and 15-minute idle logout. 23 rule tests (dates and blood-group compatibility worked out by hand) and 160 web checks are included.

Modules

  1. Login, roles and public pages: Staff, hospital and donor roles; hashed passwords; lock after 5 wrong passwords; donor self-registration; public availability board.
  2. Donors and eligibility: Registration with validation; age 18-65, weight 45 kg, 90-day gap and deferral rules; search, filter (eligible only), CSV; QR donor card.
  3. Donation desk: Screening (haemoglobin, weight, pulse, blood pressure); a failed check defers the donor for 14 days; a good donation makes a unit and links to a camp.
  4. Blood units and stock: 42-day expiry, lab test (release or reactive), discard with reason, stock by group (OK / Low / Critical), expiring soon, CSV.
  5. Hospital requests: Hospitals send requests (urgency, needed-by date); queue with emergency first; issue oldest unit first; compatible groups; partial issue; reject with reason.
  6. Donor suggestions and alerts: Eligible, willing donors with a matching group; exact group first; alert in the donor portal; no repeat alert for 7 days.
  7. Camps: Staff plan camps; donors register if they can donate on that day; collected against target.
  8. Donor portal: Eligibility countdown, history, badges, lives helped, alerts, camps, PDF certificate, switch alerts on or off.
  9. Insights and audit log: Stock against demand, days of cover, wastage percentage, top donors, camp results; every important action is written to an audit log.

Requirements

  • Python 3.11
  • Internet once, to install the libraries (about 2 minutes)
  • Windows 10 / 11

How to run this project

  1. Install Python 3.11 from python.org and tick "Add python.exe to PATH" during setup.
  2. Extract the zip and open the project folder (STUDENT_GUIDE.md explains every step in simple words).
  3. Double-click `1_INSTALL.bat` once and wait until it says [OK] (about 2 minutes; it downloads the libraries into a private .venv folder).
  4. Double-click `2_RUN.bat` to start the project. Your browser opens http://127.0.0.1:5000 by itself. If it does not start, double-click `CHECK_SETUP.bat` and read what it says.
  5. Log in as staff admin / admin123 (hospital hosp1 / demo123, donor dnr0001 / demo123). The public blood board is on the login page.
  6. Open Requests and issue units for the emergency B- request (again with 'use compatible groups'); record a donation at the Donation desk and try a low haemoglobin value to see the 14-day deferral. Log in as donor dnr0001 to see eligibility and download the PDF certificate.

More Web App projects