System Requirements Document (SRD)

Project Title: dawn-app

1. Introduction

The dawn-app, also known as "Red Drop," is designed to revolutionize the process of blood donation by connecting donors, recipients, and healthcare facilities efficiently. The app aims to simplify the process of finding nearby blood banks, donors, hospitals, and emergency blood needs while ensuring user safety and compliance. Developed for users in India (IN), the app incorporates locale-specific features such as health check-up incentives and robust verification processes to encourage regular donations.

2. System Overview

The dawn-app serves as a comprehensive platform for blood donation and emergency blood needs. Its primary functionalities include:

• Locating nearby blood banks, donors, and hospitals.
• Emergency alert system for urgent blood requirements.
• Blood match finder to identify compatible donors.
• Incentives for frequent donors, such as free health check-up vouchers after the third donation.

The app ensures user safety and compliance by requiring detailed verification during registration, including ID proof scanning, age validation (18+), weight validation (55kg+), and blood test result uploads.

3. Functional Requirements

User Stories:

• As a User, I should be able to locate the nearest blood banks, donors, and hospitals.
• As a User, I should be able to send emergency alerts for urgent blood needs.
• As a User, I should be able to use the blood match finder to find compatible donors.
• As a User, I should be able to register by providing my name, phone number, scanned ID proof, age (18+), weight (55kg+), and blood test results.
• As a User, I should receive a free health check-up voucher after completing three donations.

4. User Personas

1. Donor:

• Description: Individuals willing to donate blood.
• Key Actions: Register, locate recipients, donate blood, and earn health check-up vouchers.

2. Recipient:

• Description: Individuals in need of blood.
• Key Actions: Search for donors, send emergency alerts, and use the blood match finder.

3. Healthcare Facility:

• Description: Blood banks and hospitals.
• Key Actions: Provide blood availability updates, respond to emergency alerts, and manage donor-recipient interactions.

5. Visuals Colors and Theme

Color Palette:

• primary: #D32F2F (Crimson Red)
• primary_light: #FFCDD2 (Soft Pink)
• secondary: #1976D2 (Deep Blue)
• accent: #FFC107 (Golden Amber)
• highlight: #FF5722 (Bright Orange)
• bg: #FAFAFA (Light Gray)
• surface: rgba(255, 255, 255, 0.9) (White with slight transparency)
• text: #212121 (Dark Gray)
• text_muted: #757575 (Muted Gray)
• border: rgba(0, 0, 0, 0.1) (Subtle Black)

6. Signature Design Concept

Concept Name: Interactive Blood Network Map

The homepage of the dawn-app will feature an Interactive Blood Network Map, a dynamic visualization of nearby blood banks, donors, and hospitals.

Features:

• Dynamic Map: Users can zoom, drag, and interact with a map displaying real-time locations of blood banks, donors, and hospitals.
• Hover Interactions: Hovering over a location pin reveals details such as name, contact information, and blood availability.
• Emergency Alerts: Clicking on an alert icon broadcasts urgent blood needs to nearby donors.
• Blood Match Finder: Users can input their blood type, and the map highlights compatible donors in real-time.

Technologies:

• Frontend: React with @react-three/fiber for 3D map rendering.
• Animations: gsap for smooth transitions and hover effects.
• Backend: FastAPI for real-time data updates.

7. Interaction Model & Motion Direction

Interaction Model: Parallax

The landing page will feature a parallax interaction model, creating a layered depth effect as users scroll. Key elements include:

• Layered Backgrounds: Atmospheric gradients and subtle particle animations.
• Scroll-triggered Animations: Sections reveal themselves with smooth transitions.
• Interactive Elements: Hover effects and clickable icons for immediate actions.

Internal pages, such as the dashboard and profile, will follow a static interaction model for clarity and ease of use.

8. Non-Functional Requirements

• Performance: The app must load within 2 seconds on 4G networks.
• Scalability: Support up to 1 million users concurrently.
• Security: Implement end-to-end encryption for user data.
• Compliance: Adhere to Indian healthcare regulations for blood donation.
• Accessibility: Ensure WCAG 2.1 compliance for users with disabilities.

9. Tech Stack

Frontend:

• React for Web
• React Native for Mobile

Backend:

• Python
• FastAPI

Database:

• MySQL for structured data
• MongoDB for unstructured data

AI Models:

• GPT 5.4 for user-friendly responses
• Google Nano Banana for image generation

AI Tools:

• Litellm for LLM Routing
• Langchain

Orchestration:

• Docker for local development
• Kubernetes for server-side orchestration

10. Assumptions and Constraints

• Users must have a stable internet connection to access real-time features.
• The app will initially launch in India, with potential expansion to other regions.
• Emergency alerts will only target donors within a 50km radius.
• Health check-up vouchers will be redeemable at partnered healthcare facilities.

11. Glossary

• Blood Match Finder: A tool to identify compatible blood donors based on blood type.
• Emergency Alert: A notification system to broadcast urgent blood needs.
• Health Check-up Voucher: An incentive for frequent donors, redeemable at partnered facilities.
• ID Proof: Official identification document required for user registration.