Bloodmap AI: An AI-Driven Framework for Intelligent Blood Donor Matching and Blood Demand Forecasting

Timely identification of suitable blood donors is a critical operational challenge because donor availability, blood-group compatibility, geographical distance, and response behavior can change rapidly. This paper presents BloodMap AI, a web-based intelligent blood donation management framework that combines compatibility-aware donor ranking, location-based scoring, blood-demand forecasting, donor eligibility rules, persistent data management, and an extensible machine-learning/MLOps service. The frontend is implemented with React, Vite, TypeScript, and Supabase, while a Python FastAPI service provides protected matching, forecasting, retraining, health, and Prometheus monitoring endpoints. The donor matching component first removes incompatible donors and then considers blood-group compatibility, Haversine distance, and current availability; an XGBoost-based ranking model can be loaded when a trained model artifact is present, with a deterministic rules-based fallback for service resilience. The demand-forecasting interface aggregates actual blood-request records and produces a short-horizon forecast with lower and upper bounds. The repository also includes data extraction, preprocessing, model-training, model registration, drift monitoring, automated tests, and GitHub Actions workflows for continuous integration and weekly retraining. Functional validation of the uploaded project passed six unit tests covering compatibility, donor ranking, and forecasting behavior. The work demonstrates a practical architecture for AI-assisted blood-resource coordination while identifying the need for larger real-world datasets and statistically validated model benchmarks.