# ramyars9019-bit/jeevabindu architecture

> Architecture diagram of the GitHub repository ramyars9019-bit/jeevabindu, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ramyars9019-bit/jeevabindu
- Repository: https://github.com/ramyars9019-bit/jeevabindu

## Overview

Jeeva-Bindu is an Android blood-donor directory for rapid, town-level emergency matching. The documented workflow is: donors register and provide eligibility/location details; a requester posts a blood need; a Firebase-triggered function selects verified, available, eligible donors in that town and sends push alerts; a donor can respond, marking the alert as responded. The Android client implementation is largely undocumented in the sampled source, so its documented screens and data flows are represented at the enclosing source directory. The sampled MainActivity is only an empty shell.

Main entry points: [`JeevaBinduProject/database.rules.json`](https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/database.rules.json) (Realtime database), [`JeevaBinduProject/functions/index.js`](https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/functions/index.js) (Alert dispatch), [`JeevaBinduProject/app/src/main/java/com/jeevabindu/app`](https://github.com/ramyars9019-bit/jeevabindu/tree/main/JeevaBinduProject/app/src/main/java/com/jeevabindu/app) (Registration and screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Android client"]
  node_app_shell["Main activity shell<br/>[MainActivity.kt]"]
  node_client_screens["Registration and screens"]
  node_emergency_post["Emergency request"]
  node_donor_response["Donor response"]
  node_health_profile["Health and profile"]
end

subgraph group_matching["Emergency matching"]
  node_eligibility["Eligibility check<br/>[index.js]"]
  node_town_matching["Town donor matching<br/>[index.js]"]
  node_alert_dispatch["Alert dispatch<br/>[index.js]"]
  node_response_handler["Response handler<br/>[index.js]"]
end

subgraph group_data["Application data"]
  node_realtime_db[("Realtime database")]
  node_local_storage[("Local preferences and cache")]
end

subgraph group_integrations["External services"]
  node_firebase_auth["Phone authentication"]
  node_fcm["Firebase messaging"]
  node_location_service["Device location"]
end

node_requester(("Patient or requester"))
node_donor(("Volunteer donor"))

node_requester -->|"posts need"| node_emergency_post
node_donor -->|"registers"| node_client_screens
node_donor -->|"responds"| node_donor_response
node_client_screens -->|"authenticates by phone"| node_firebase_auth
node_client_screens -->|"saves donor details"| node_realtime_db
node_emergency_post -->|"creates alert"| node_realtime_db
node_health_profile -->|"saves donation logs"| node_realtime_db
node_health_profile -->|"captures location"| node_location_service
node_client_screens -->|"stores login details"| node_local_storage
node_realtime_db -->|"triggers on alert"| node_alert_dispatch
node_alert_dispatch -->|"reads donors"| node_realtime_db
node_alert_dispatch -->|"checks cooldown"| node_eligibility
node_alert_dispatch -->|"filters by town"| node_town_matching
node_alert_dispatch -->|"sends notifications"| node_fcm
node_alert_dispatch -->|"updates alert status"| node_realtime_db
node_donor_response -->|"records response"| node_realtime_db
node_realtime_db -->|"triggers on response"| node_response_handler
node_response_handler -->|"marks alert responded"| node_realtime_db

click node_app_shell "https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/app/src/main/java/com/jeevabindu/app/MainActivity.kt"
click node_client_screens "https://github.com/ramyars9019-bit/jeevabindu/tree/main/JeevaBinduProject/app/src/main/java/com/jeevabindu/app"
click node_emergency_post "https://github.com/ramyars9019-bit/jeevabindu/tree/main/JeevaBinduProject/app/src/main/java/com/jeevabindu/app"
click node_donor_response "https://github.com/ramyars9019-bit/jeevabindu/tree/main/JeevaBinduProject/app/src/main/java/com/jeevabindu/app"
click node_health_profile "https://github.com/ramyars9019-bit/jeevabindu/tree/main/JeevaBinduProject/app/src/main/java/com/jeevabindu/app"
click node_eligibility "https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/functions/index.js"
click node_town_matching "https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/functions/index.js"
click node_alert_dispatch "https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/functions/index.js"
click node_response_handler "https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/functions/index.js"
click node_realtime_db "https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/database.rules.json"
click node_local_storage "https://github.com/ramyars9019-bit/jeevabindu/tree/main/JeevaBinduProject/app/src/main/java/com/jeevabindu/app"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app_shell,node_client_screens,node_emergency_post,node_donor_response,node_health_profile toneBlue
class node_eligibility,node_town_matching,node_alert_dispatch,node_response_handler toneAmber
class node_realtime_db,node_local_storage,node_requester toneMint
class node_firebase_auth,node_fcm,node_location_service toneRose
class node_donor toneIndigo
```

## Components

### Android client

- [Main activity shell](https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/app/src/main/java/com/jeevabindu/app/MainActivity.kt): `JeevaBinduProject/app/src/main/java/com/jeevabindu/app/MainActivity.kt`
- [Registration and screens](https://github.com/ramyars9019-bit/jeevabindu/tree/main/JeevaBinduProject/app/src/main/java/com/jeevabindu/app): `JeevaBinduProject/app/src/main/java/com/jeevabindu/app`
- [Emergency request](https://github.com/ramyars9019-bit/jeevabindu/tree/main/JeevaBinduProject/app/src/main/java/com/jeevabindu/app): `JeevaBinduProject/app/src/main/java/com/jeevabindu/app`
- [Donor response](https://github.com/ramyars9019-bit/jeevabindu/tree/main/JeevaBinduProject/app/src/main/java/com/jeevabindu/app): `JeevaBinduProject/app/src/main/java/com/jeevabindu/app`
- [Health and profile](https://github.com/ramyars9019-bit/jeevabindu/tree/main/JeevaBinduProject/app/src/main/java/com/jeevabindu/app): `JeevaBinduProject/app/src/main/java/com/jeevabindu/app`

### Emergency matching

- [Eligibility check](https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/functions/index.js): `JeevaBinduProject/functions/index.js`
- [Town donor matching](https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/functions/index.js): `JeevaBinduProject/functions/index.js`
- [Alert dispatch](https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/functions/index.js): `JeevaBinduProject/functions/index.js`
- [Response handler](https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/functions/index.js): `JeevaBinduProject/functions/index.js`

### Application data

- [Realtime database](https://github.com/ramyars9019-bit/jeevabindu/blob/main/JeevaBinduProject/database.rules.json): `JeevaBinduProject/database.rules.json`
- [Local preferences and cache](https://github.com/ramyars9019-bit/jeevabindu/tree/main/JeevaBinduProject/app/src/main/java/com/jeevabindu/app): `JeevaBinduProject/app/src/main/java/com/jeevabindu/app`

### External services

- **Phone authentication**
- **Firebase messaging**
- **Device location**

### Other components

- **Patient or requester**
- **Volunteer donor**

## Connections

- Patient or requester → Emergency request: posts need (evidence: `README.md`)
- Volunteer donor → Registration and screens: registers (evidence: `README.md`)
- Volunteer donor → Donor response: responds (evidence: `README.md`)
- Registration and screens → Phone authentication: authenticates by phone (evidence: `README.md`)
- Registration and screens → Realtime database: saves donor details (evidence: `README.md`)
- Emergency request → Realtime database: creates alert (evidence: `README.md`)
- Health and profile → Realtime database: saves donation logs (evidence: `README.md`)
- Health and profile → Device location: captures location (evidence: `README.md`)
- Registration and screens → Local preferences and cache: stores login details (evidence: `README.md`)
- Realtime database → Alert dispatch: triggers on alert (evidence: `JeevaBinduProject/functions/index.js`)
- Alert dispatch → Realtime database: reads donors (evidence: `JeevaBinduProject/functions/index.js`)
- Alert dispatch → Eligibility check: checks cooldown (evidence: `JeevaBinduProject/functions/index.js`)
- Alert dispatch → Town donor matching: filters by town (evidence: `JeevaBinduProject/functions/index.js`)
- Alert dispatch → Firebase messaging: sends notifications (evidence: `JeevaBinduProject/functions/index.js`)
- Alert dispatch → Realtime database: updates alert status (evidence: `JeevaBinduProject/functions/index.js`)
- Donor response → Realtime database: records response (evidence: `README.md`)
- Realtime database → Response handler: triggers on response (evidence: `JeevaBinduProject/functions/index.js`)
- Response handler → Realtime database: marks alert responded (evidence: `JeevaBinduProject/functions/index.js`)
