Blood 4 Life 🩸

Blood 4 Life is a comprehensive blood donation platform that connects donors, NGOs, and patients through a seamless, user-friendly interface. The application facilitates efficient blood donation management across geographically divided zones within Punjab.

⚠️ IMPORTANT NOTE: Cloud servers are currently shut down due to high server-side costs. As a result, notifications are temporarily disabled, although the feature is fully implemented in the codebase.

🌟 Key Features

For Users

• Quick and frictionless donation request forms
• Real-time notifications (when servers are active)
• Automated donor tracking and availability management
• Independent NGO search functionality
• User-friendly interface for all stakeholders

For NGOs

• Personalized dashboard for donation management
• Custom registration process
• Manual donor assignment within geographical locations
• Credential verification system
• Comprehensive donation tracking

For Administrators

• Super admin panel for platform control
• NGO listing and debarment capabilities
• Complete process oversight through the app

📱 Screenshots

🏗️ Technical Architecture

• Database: NoSQL Firestore for flexible and scalable data management
• Notifications: Cloud functions with 1-minute latency (currently inactive)
• Geographical Data: Custom JSON mapping system for Punjab districts and constituencies
• Infrastructure: Three-way connection system between donors, NGOs, and patients

🚀 Installation

You can download the latest version of the application from our releases page.

📹 Demo

Watch our application demo: Blood 4 Life Demo

💡 Key Technical Highlights

1. Real-time Communication:

   • Cloud functions for instant notifications
   • Geographic zone-based communication system

2. Automated Donor Management:

   • Automatic donor listing/delisting based on donation status
   • Donation history tracking

3. NGO Management System:

   • Custom registration workflow
   • Comprehensive donation oversight
   • Geographical location-based donor assignment

4. Data Architecture:

   • Schemaless NoSQL database
   • Flexible data structures for system evolution
   • Custom geographical data mapping

🤝 Contributing

We welcome contributions to the Blood 4 Life project! Please feel free to submit issues and pull requests.

---

For any questions or support, please open an issue in the repository.