RedHope
Smart Blood Donation Platform
A full-stack healthcare application bridging blood donors and hospitals in real-time. Secured with Spring Security + JWT, built with Java 17, and engineered for emergencies where every second counts.
Dashboard Overview
See RedHope in Action
Every screen is carefully designed for donor and hospital workflows. Clean, functional, and built for real emergencies.
Dashboard Overview
Central hub showing blood availability, donor stats, and urgent requests in real-time with live counters.
Why RedHope Exists
The gap between blood supply and demand costs lives. RedHope closes that gap with technology.
The Problem
- Hospital staff manually call contacts when blood is urgently needed
- No centralized database — blood availability unknown across hospitals
- Donors unaware of nearby urgent needs or their own eligibility
- Critical delays in emergencies cost lives every day
- No digital trail for donation history or safety verification
RedHope Solution
- Automated instant alerts to all eligible donors in the area
- Centralized real-time blood inventory across all hospitals
- Smart eligibility checks based on history & medical records
- Sub-second matching between requests and available donors
- Complete Spring Security-protected audit trail
What Makes RedHope Powerful
Every feature is engineered to reduce emergency response time and make blood donation seamless.
Real-Time Donor Matching
Smart algorithm connects emergency blood requests with compatible donors instantly — based on blood type, location radius, and current availability.
JWT Auth & Spring Security
Military-grade security using JWT stateless tokens, BCrypt password hashing, CSRF protection, and fine-grained Role-Based Access Control (RBAC).
Emergency Alert Broadcast
Critical push notification system that broadcasts urgent requests to all eligible donors in configurable radius — reducing response time to under 2 minutes.
Smart Inventory Management
Tracks blood group availability across multiple hospitals with expiry date monitoring, low-stock alerts, and inter-hospital transfer coordination.
Geo-Location Integration
Haversine formula-based proximity queries to find nearest available blood banks and donors — geospatial efficiency for life-critical situations.
Health Analytics Dashboard
Comprehensive analytics for admins showing donation trends, blood group demand heatmaps, donor engagement rates, and system-wide health metrics.
RESTful API Architecture
Clean, well-documented REST APIs with proper HTTP status codes, request validation, pagination, and Swagger/OpenAPI auto-generated docs.
Donor Eligibility Engine
Automatically enforces 90-day donation cooldown, medical eligibility rules, and maintains a complete verifiable donation history for each donor.
4-Tier RBAC System
Each user type has precisely scoped permissions enforced at the Spring Security filter chain level.
- Manage all users & roles
- View system analytics
- Configure alerts & radius
- Audit logs access
- Raise emergency blood requests
- Manage blood inventory
- View matched donors
- Track donation status
- Register & update profile
- View nearby requests
- Accept/decline alerts
- Track donation history
- Find nearest blood bank
- Check blood availability
- View public donor info
- Register as donor
Built with Enterprise-Grade Tech
Every technology choice is intentional — production-ready, scalable, and battle-tested.
How It All Connects
Development Changelog
Active development — each version adds significant new capability.
Emergency Broadcast System
- Implemented real-time alert broadcasting to eligible donors within configurable radius
- Added priority queue for critical blood types (O-, AB-)
- Donor acknowledgment system — accept/decline with reason tracking
Security Hardening
- Migrated from session-based to JWT stateless authentication
- Implemented 4-tier RBAC (Admin / Hospital Staff / Donor / Guest)
- Added BCrypt password hashing with cost factor 12
- CSRF protection enabled for all state-changing endpoints
Geo-Location & Inventory
- Integrated Haversine formula for proximity-based donor search
- Multi-hospital blood inventory tracker with expiry alerts
- Inter-hospital transfer request system implemented
API & Database Refactor
- Redesigned all REST endpoints following proper RESTful conventions
- Added Swagger/OpenAPI auto-generated documentation
- Database schema normalized to 3NF for better performance
- Added input validation with Jakarta Bean Validation
Initial Architecture
- Project scaffolded with Spring Boot 3 + Spring Security
- Core donor and hospital entity models designed
- Basic CRUD APIs for donor registration and blood requests
- MySQL schema created with proper indexing strategy
Full Source Code on GitHub
RedHope is completely open-source. Explore the Spring Boot backend, JWT integration, RBAC implementation, and clean architecture — all in one repo.