# santhosh-m29/bloodbank-manager architecture

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

- Interactive diagram: https://gitdiagram.com/santhosh-m29/bloodbank-manager
- Repository: https://github.com/santhosh-m29/bloodbank-manager

## Overview

This is a Java console blood-bank management application. Its principal workflow moves from donor collection through laboratory approval and bank registration, then hospital request, shortage routing and dispatch, and patient issue. Menus are the user-facing entry point; BloodBankService enforces role/facility authorization and commits operations against the connected system state. The README documents alerts, reports, account administration, and atomic snapshot persistence as additional capabilities. Some service and UI source was not sampled, so workflow links rely on documented behavior where noted; unsampled subsystem internals are not inferred.

Main entry points: [`src/bloodbank/service/BloodBankService.java`](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/BloodBankService.java) (Business service), [`src/bloodbank/ui/Menu.java`](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/ui/Menu.java) (Role menus), [`src/bloodbank/Main.java`](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/Main.java) (Startup), [`src/bloodbank/service/SystemState.java`](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/SystemState.java) (Connected state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Console interaction"]
  node_console_menu["Role menus<br/>[Menu.java]"]
  node_startup["Startup<br/>[Main.java]"]
end

subgraph group_operations["Blood operations"]
  node_service["Business service"]
  node_login["Login sessions<br/>[LoginManager.java]"]
  node_donation["Donation and lab<br/>[BloodDonation.java]"]
  node_requests["Blood requests<br/>[BloodRequest.java]"]
  node_transfers["Blood transfers<br/>[BloodTransfer.java]"]
end

subgraph group_domain["Domain state"]
  node_units["Traceable units<br/>[BloodUnit.java]"]
  node_inventory["Facility inventory<br/>[Inventory.java]"]
  node_people["People and roles<br/>[Person.java]"]
  node_facilities["Facilities<br/>[Organization.java]"]
  node_system_state["Connected state<br/>[SystemState.java]"]
end

subgraph group_support["System support"]
  node_file_manager["Snapshot persistence<br/>[FileManager.java]"]
  node_snapshot[("Version 2 snapshot")]
  node_alerts["Stock and expiry alerts<br/>[AlertManager.java]"]
  node_reports["Operational reports"]
  node_demo_data["First-launch data<br/>[DemoData.java]"]
end

node_donor(("Donor"))
node_bank_admin(("Bank admin"))
node_hospital_staff(("Hospital staff"))
node_patient_actor(("Patient"))

node_donor -->|"uses"| node_console_menu
node_bank_admin -->|"uses"| node_console_menu
node_hospital_staff -->|"uses"| node_console_menu
node_patient_actor -->|"uses"| node_console_menu
node_startup -->|"starts"| node_console_menu
node_console_menu -->|"invokes"| node_service
node_service -->|"uses"| node_login
node_service -->|"validates and updates"| node_system_state
node_service -->|"saves state"| node_file_manager
node_startup -->|"loads state"| node_file_manager
node_startup -->|"initializes"| node_demo_data
node_file_manager -->|"reads and writes"| node_snapshot
node_service -->|"records and tests"| node_donation
node_service -->|"creates and approves"| node_requests
node_service -.->|"dispatches"| node_transfers
node_service -->|"reserves stock"| node_inventory
node_donation -->|"creates units"| node_units
node_transfers -->|"moves units"| node_inventory
node_requests -->|"checks availability"| node_inventory
node_system_state -->|"validates facility references"| node_facilities
node_system_state -->|"validates person references"| node_people
node_console_menu -->|"shows alerts"| node_alerts
node_console_menu -->|"exports reports"| node_reports

click node_console_menu "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/ui/Menu.java"
click node_startup "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/Main.java"
click node_service "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/BloodBankService.java"
click node_login "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/LoginManager.java"
click node_donation "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/BloodDonation.java"
click node_requests "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/BloodRequest.java"
click node_transfers "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/BloodTransfer.java"
click node_units "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/BloodUnit.java"
click node_inventory "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/Inventory.java"
click node_people "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/Person.java"
click node_facilities "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/Organization.java"
click node_system_state "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/SystemState.java"
click node_file_manager "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/utility/FileManager.java"
click node_alerts "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/AlertManager.java"
click node_reports "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/ReportGenerator.java"
click node_demo_data "https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/DemoData.java"

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_console_menu,node_startup toneBlue
class node_service,node_login,node_donation,node_requests,node_transfers toneAmber
class node_units,node_inventory,node_people,node_facilities,node_system_state toneMint
class node_file_manager,node_snapshot,node_alerts,node_reports,node_demo_data toneRose
class node_donor,node_bank_admin,node_hospital_staff,node_patient_actor toneIndigo
```

## Components

### Console interaction

- [Role menus](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/ui/Menu.java): `src/bloodbank/ui/Menu.java`
- [Startup](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/Main.java): `src/bloodbank/Main.java`

### Blood operations

- [Business service](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/BloodBankService.java): `src/bloodbank/service/BloodBankService.java`
- [Login sessions](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/LoginManager.java): `src/bloodbank/service/LoginManager.java`
- [Donation and lab](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/BloodDonation.java): `src/bloodbank/model/BloodDonation.java`
- [Blood requests](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/BloodRequest.java): `src/bloodbank/model/BloodRequest.java`
- [Blood transfers](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/BloodTransfer.java): `src/bloodbank/model/BloodTransfer.java`

### Domain state

- [Traceable units](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/BloodUnit.java): `src/bloodbank/model/BloodUnit.java`
- [Facility inventory](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/Inventory.java): `src/bloodbank/model/Inventory.java`
- [People and roles](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/Person.java): `src/bloodbank/model/Person.java`
- [Facilities](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/model/Organization.java): `src/bloodbank/model/Organization.java`
- [Connected state](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/SystemState.java): `src/bloodbank/service/SystemState.java`

### System support

- [Snapshot persistence](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/utility/FileManager.java): `src/bloodbank/utility/FileManager.java`
- **Version 2 snapshot**
- [Stock and expiry alerts](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/AlertManager.java): `src/bloodbank/service/AlertManager.java`
- [Operational reports](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/ReportGenerator.java): `src/bloodbank/service/ReportGenerator.java`
- [First-launch data](https://github.com/santhosh-m29/bloodbank-manager/blob/main/src/bloodbank/service/DemoData.java): `src/bloodbank/service/DemoData.java`

### Other components

- **Donor**
- **Bank admin**
- **Hospital staff**
- **Patient**

## Connections

- Donor → Role menus: uses (evidence: `README.md`)
- Bank admin → Role menus: uses (evidence: `README.md`)
- Hospital staff → Role menus: uses (evidence: `README.md`)
- Patient → Role menus: uses (evidence: `README.md`)
- Startup → Role menus: starts (evidence: `src/bloodbank/Main.java`)
- Role menus → Business service: invokes (evidence: `src/bloodbank/ui/Menu.java`)
- Business service → Login sessions: uses (evidence: `src/bloodbank/service/BloodBankService.java`)
- Business service → Connected state: validates and updates (evidence: `src/bloodbank/service/BloodBankService.java`)
- Business service → Snapshot persistence: saves state (evidence: `src/bloodbank/service/BloodBankService.java`)
- Startup → Snapshot persistence: loads state (evidence: `src/bloodbank/Main.java`)
- Startup → First-launch data: initializes (evidence: `src/bloodbank/Main.java`)
- Snapshot persistence → Version 2 snapshot: reads and writes (evidence: `README.md`)
- Business service → Donation and lab: records and tests (evidence: `src/bloodbank/service/BloodBankService.java`)
- Business service → Blood requests: creates and approves (evidence: `src/bloodbank/service/BloodBankService.java`)
- Business service → Blood transfers: dispatches (evidence: `src/bloodbank/service/BloodBankService.java`)
- Business service → Facility inventory: reserves stock (evidence: `src/bloodbank/service/BloodBankService.java`)
- Donation and lab → Traceable units: creates units (evidence: `src/bloodbank/model/BloodDonation.java`)
- Blood transfers → Facility inventory: moves units (evidence: `src/bloodbank/model/BloodTransfer.java`)
- Blood requests → Facility inventory: checks availability (evidence: `src/bloodbank/model/BloodRequest.java`)
- Connected state → Facilities: validates facility references (evidence: `src/bloodbank/service/SystemState.java`)
- Connected state → People and roles: validates person references (evidence: `src/bloodbank/service/SystemState.java`)
- Role menus → Stock and expiry alerts: shows alerts (evidence: `src/bloodbank/ui/Menu.java`)
- Role menus → Operational reports: exports reports (evidence: `src/bloodbank/ui/Menu.java`)
