Skip to content

muhammadjareer24/blood-donation-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Blood Donation Tracker

It's a Flask web application to manage blood donors, record blood donations and check donor eligibility using the 56-day rule. The app provides an interactive dashboard, donor search and real-time eligibility tracking, built with Python, Flask, SQLite, HTML and Tailwind CSS.

Features

✅ Dashboard Overview

  • Total donors, total donations, eligible donors count
  • Recent donation history and blood group-wise statistics

✅ Donor Management

  • Register new donors
  • Search and filter by blood group or name
  • Calculate age and check eligibility automatically

✅ Donation Management

  • Record new donations with date, units, and notes
  • Auto-validate eligibility (56-day gap between donations)

✅ Eligibility Tracking

  • Shows who is eligible or not eligible to donate
  • Displays next possible donation date for each donor

✅ Database

  • Uses SQLite for easy, file-based data storage
  • Automatically initializes all required tables

Tech Stack

  • Backend -> Python (Flask Framework)
  • Frontend -> HTML, Tailwind CSS, Jinja Templates
  • Database -> SQLite3

📸 Screenshots

Dashboard

Register_New_Donor

Registered_Donors

Record_New_Donation

Donation_Records

Donor_Eligibility_Status

Installation and Setup

1. Clone the Repository

git clone https://github.com/yourusername/blood-donation-tracker.git
cd blood-donation-tracker

2. Create a Virtual Environment

python -m venv venv

3. Activate the Virtual Environment

  • Windows:
venv\Scripts\activate
  • macOS/Linux:
source venv/bin/activate

4. Install Dependencies

pip install -r requirements.txt

5. Run the Application

python app.py

Then open your browser and visit:

http://127.0.0.1:5000/

Check my portfolio here:

https://muhammadjareer.vercel.app/

About

Blood Donation Tracker is a Flask-based web application that helps manage blood donors, track donation history and check donor eligibility using the 56-day rule. Built with Python, Flask, SQLite, HTML, and Tailwind CSS, it provides a dashboard view for quick statistics, donor management and donation tracking all in one system.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors