# samadkhan0/bloodbanksystem architecture

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

- Interactive diagram: https://gitdiagram.com/samadkhan0/bloodbanksystem
- Repository: https://github.com/samadkhan0/bloodbanksystem

## Overview

BloodLink is a WinForms blood-bank management application. Staff sign in, then use dashboard pages to manage donors, blood inventory and patient requests; services validate and apply domain rules before repositories persist or query SQL Server. The dashboard also exposes reporting, staff administration and settings, while a timer handles expiry checks. The README documents charts, role-based access and persistent themes. Some page and settings relationships are grounded in the SOURCE INDEX or README because their implementation details were not excerpted.

Main entry points: [`BloodLink/Forms/DashboardShell.cs`](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Forms/DashboardShell.cs) (Dashboard shell), [`BloodLink/Services/BloodUnitService.cs`](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Services/BloodUnitService.cs) (Inventory rules), [`BloodLink/Services/PatientRequestService.cs`](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Services/PatientRequestService.cs) (Request rules), [`BloodLink/Pages/AdminDashboardPage.cs`](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/AdminDashboardPage.cs) (Admin dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application flow"]
  node_startup["Application startup<br/>[Program.cs]"]
  node_login["Sign-in<br/>[LoginForm.cs]"]
  node_shell["Dashboard shell<br/>[DashboardShell.cs]"]
  node_theme["Theme and drawing helpers<br/>[Apptheme.cs]"]
end

subgraph group_operations["Blood bank operations"]
  node_donor_ui["Donor management<br/>[DonorPage.cs]"]
  node_donor_form["Donor editor<br/>[DonorForm.cs]"]
  node_unit_ui["Blood inventory<br/>[BloodUnitPage.cs]"]
  node_unit_form["Blood unit editor<br/>[BloodUnitForm.cs]"]
  node_request_ui["Patient requests<br/>[PatientsPage.cs]"]
  node_request_form["Request editor<br/>[PatientForm.cs]"]
  node_staff_ui["Staff administration<br/>[StaffPage.cs]"]
  node_user_form["Staff editor<br/>[UserForm.cs]"]
end

subgraph group_insights["Dashboard and reporting"]
  node_admin["Admin dashboard"]
  node_reports["Operational reports<br/>[ReportsPage.cs]"]
  node_settings["Application settings<br/>[SettingPage.cs]"]
end

subgraph group_domain["Business and persistence"]
  node_auth_service["Authentication logic<br/>[AuthService.cs]"]
  node_donor_service["Donor rules<br/>[DonorService.cs]"]
  node_unit_service["Inventory rules"]
  node_request_service["Request rules"]
  node_user_repo["User repository<br/>[UserRepository.cs]"]
  node_donor_repo["Donor repository<br/>[DonorRepository.cs]"]
  node_unit_repo["Blood unit repository"]
  node_request_repo["Request repository"]
  node_settings_repo["Settings repository"]
  node_sql[("SQL Server database")]
end

node_staff(("Bank staff"))

node_staff -->|"launches"| node_startup
node_startup -->|"opens"| node_login
node_staff -->|"signs in"| node_login
node_login -->|"authenticates with"| node_auth_service
node_login -->|"opens on success"| node_shell
node_shell -->|"routes to"| node_admin
node_shell -->|"routes to"| node_donor_ui
node_shell -->|"routes to"| node_unit_ui
node_shell -->|"routes to"| node_request_ui
node_shell -->|"routes to"| node_staff_ui
node_shell -->|"routes to"| node_reports
node_shell -->|"routes to"| node_settings
node_shell -->|"checks expiry"| node_unit_service
node_donor_ui -->|"opens"| node_donor_form
node_donor_ui -->|"manages donors through"| node_donor_service
node_donor_form -->|"saves through"| node_donor_service
node_unit_ui -->|"opens"| node_unit_form
node_unit_ui -->|"manages stock through"| node_unit_service
node_unit_form -->|"saves through"| node_unit_service
node_request_ui -->|"opens"| node_request_form
node_request_ui -->|"manages requests through"| node_request_service
node_request_form -->|"saves through"| node_request_service
node_staff_ui -->|"opens"| node_user_form
node_staff_ui -->|"manages accounts through"| node_auth_service
node_user_form -->|"saves through"| node_auth_service
node_admin -->|"loads donor metrics"| node_donor_service
node_admin -->|"loads inventory metrics"| node_unit_service
node_admin -->|"loads request metrics"| node_request_service
node_reports -->|"queries stock and donations"| node_unit_service
node_reports -->|"queries request status"| node_request_service
node_settings -->|"reads and writes"| node_settings_repo
node_shell -->|"loads preferences"| node_settings_repo
node_auth_service -->|"calls"| node_user_repo
node_donor_service -->|"calls"| node_donor_repo
node_unit_service -->|"calls"| node_unit_repo
node_request_service -->|"calls"| node_request_repo
node_user_repo -.->|"queries and writes"| node_sql
node_donor_repo -.->|"queries and writes"| node_sql
node_unit_repo -->|"queries and writes"| node_sql
node_request_repo -.->|"queries and writes"| node_sql
node_settings_repo -.->|"reads and writes"| node_sql
node_shell -.->|"uses theme helpers"| node_theme

click node_startup "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Program.cs"
click node_login "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Forms/LoginForm.cs"
click node_shell "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Forms/DashboardShell.cs"
click node_donor_ui "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/DonorPage.cs"
click node_donor_form "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Forms/DonorForm.cs"
click node_unit_ui "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/BloodUnitPage.cs"
click node_unit_form "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Forms/BloodUnitForm.cs"
click node_request_ui "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/PatientsPage.cs"
click node_request_form "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Forms/PatientForm.cs"
click node_staff_ui "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/StaffPage.cs"
click node_user_form "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Forms/UserForm.cs"
click node_admin "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/AdminDashboardPage.cs"
click node_reports "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/ReportsPage.cs"
click node_settings "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/SettingPage.cs"
click node_auth_service "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Services/AuthService.cs"
click node_donor_service "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Services/DonorService.cs"
click node_unit_service "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Services/BloodUnitService.cs"
click node_request_service "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Services/PatientRequestService.cs"
click node_user_repo "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink.Core/Database/UserRepository.cs"
click node_donor_repo "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink.Core/Database/DonorRepository.cs"
click node_unit_repo "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink.Core/Database/BloodUnitRepository.cs"
click node_request_repo "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink.Core/Database/PatientRequestRepository.cs"
click node_settings_repo "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink.Core/Database/AppSettingRepository.cs"
click node_theme "https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Helpers/Apptheme.cs"

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_startup,node_login,node_shell,node_theme toneBlue
class node_donor_ui,node_donor_form,node_unit_ui,node_unit_form,node_request_ui,node_request_form,node_staff_ui,node_user_form toneAmber
class node_admin,node_reports,node_settings toneMint
class node_auth_service,node_donor_service,node_unit_service,node_request_service,node_user_repo,node_donor_repo,node_unit_repo,node_request_repo,node_settings_repo,node_sql toneRose
class node_staff toneIndigo
```

## Components

### Application flow

- [Application startup](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Program.cs): `BloodLink/Program.cs`
- [Sign-in](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Forms/LoginForm.cs): `BloodLink/Forms/LoginForm.cs`
- [Dashboard shell](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Forms/DashboardShell.cs): `BloodLink/Forms/DashboardShell.cs`
- [Theme and drawing helpers](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Helpers/Apptheme.cs): `BloodLink/Helpers/Apptheme.cs`

### Blood bank operations

- [Donor management](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/DonorPage.cs): `BloodLink/Pages/DonorPage.cs`
- [Donor editor](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Forms/DonorForm.cs): `BloodLink/Forms/DonorForm.cs`
- [Blood inventory](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/BloodUnitPage.cs): `BloodLink/Pages/BloodUnitPage.cs`
- [Blood unit editor](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Forms/BloodUnitForm.cs): `BloodLink/Forms/BloodUnitForm.cs`
- [Patient requests](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/PatientsPage.cs): `BloodLink/Pages/PatientsPage.cs`
- [Request editor](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Forms/PatientForm.cs): `BloodLink/Forms/PatientForm.cs`
- [Staff administration](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/StaffPage.cs): `BloodLink/Pages/StaffPage.cs`
- [Staff editor](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Forms/UserForm.cs): `BloodLink/Forms/UserForm.cs`

### Dashboard and reporting

- [Admin dashboard](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/AdminDashboardPage.cs): `BloodLink/Pages/AdminDashboardPage.cs`
- [Operational reports](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/ReportsPage.cs): `BloodLink/Pages/ReportsPage.cs`
- [Application settings](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Pages/SettingPage.cs): `BloodLink/Pages/SettingPage.cs`

### Business and persistence

- [Authentication logic](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Services/AuthService.cs): `BloodLink/Services/AuthService.cs`
- [Donor rules](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Services/DonorService.cs): `BloodLink/Services/DonorService.cs`
- [Inventory rules](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Services/BloodUnitService.cs): `BloodLink/Services/BloodUnitService.cs`
- [Request rules](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink/Services/PatientRequestService.cs): `BloodLink/Services/PatientRequestService.cs`
- [User repository](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink.Core/Database/UserRepository.cs): `BloodLink.Core/Database/UserRepository.cs`
- [Donor repository](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink.Core/Database/DonorRepository.cs): `BloodLink.Core/Database/DonorRepository.cs`
- [Blood unit repository](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink.Core/Database/BloodUnitRepository.cs): `BloodLink.Core/Database/BloodUnitRepository.cs`
- [Request repository](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink.Core/Database/PatientRequestRepository.cs): `BloodLink.Core/Database/PatientRequestRepository.cs`
- [Settings repository](https://github.com/samadkhan0/bloodbanksystem/blob/master/BloodLink.Core/Database/AppSettingRepository.cs): `BloodLink.Core/Database/AppSettingRepository.cs`
- **SQL Server database**

### Other components

- **Bank staff**

## Connections

- Bank staff → Application startup: launches (evidence: `BloodLink/Program.cs`)
- Application startup → Sign-in: opens (evidence: `BloodLink/Program.cs`)
- Bank staff → Sign-in: signs in (evidence: `README.md`)
- Sign-in → Authentication logic: authenticates with (evidence: `BloodLink/Forms/LoginForm.cs`)
- Sign-in → Dashboard shell: opens on success (evidence: `BloodLink/Forms/LoginForm.cs`)
- Dashboard shell → Admin dashboard: routes to (evidence: `BloodLink/Forms/DashboardShell.cs`)
- Dashboard shell → Donor management: routes to (evidence: `BloodLink/Forms/DashboardShell.cs`)
- Dashboard shell → Blood inventory: routes to (evidence: `BloodLink/Forms/DashboardShell.cs`)
- Dashboard shell → Patient requests: routes to (evidence: `BloodLink/Forms/DashboardShell.cs`)
- Dashboard shell → Staff administration: routes to (evidence: `BloodLink/Forms/DashboardShell.cs`)
- Dashboard shell → Operational reports: routes to (evidence: `BloodLink/Forms/DashboardShell.cs`)
- Dashboard shell → Application settings: routes to (evidence: `BloodLink/Forms/DashboardShell.cs`)
- Dashboard shell → Inventory rules: checks expiry (evidence: `BloodLink/Forms/DashboardShell.cs`)
- Donor management → Donor editor: opens (evidence: `BloodLink/Pages/DonorPage.cs`)
- Donor management → Donor rules: manages donors through (evidence: `BloodLink/Pages/DonorPage.cs`)
- Donor editor → Donor rules: saves through (evidence: `BloodLink/Forms/DonorForm.cs`)
- Blood inventory → Blood unit editor: opens (evidence: `BloodLink/Pages/BloodUnitPage.cs`)
- Blood inventory → Inventory rules: manages stock through (evidence: `BloodLink/Pages/BloodUnitPage.cs`)
- Blood unit editor → Inventory rules: saves through (evidence: `BloodLink/Forms/BloodUnitForm.cs`)
- Patient requests → Request editor: opens (evidence: `BloodLink/Pages/PatientsPage.cs`)
- Patient requests → Request rules: manages requests through (evidence: `BloodLink/Pages/PatientsPage.cs`)
- Request editor → Request rules: saves through (evidence: `BloodLink/Forms/PatientForm.cs`)
- Staff administration → Staff editor: opens (evidence: `BloodLink/Pages/StaffPage.cs`)
- Staff administration → Authentication logic: manages accounts through (evidence: `BloodLink/Pages/StaffPage.cs`)
- Staff editor → Authentication logic: saves through (evidence: `BloodLink/Forms/UserForm.cs`)
- Admin dashboard → Donor rules: loads donor metrics (evidence: `BloodLink/Pages/AdminDashboardPage.cs`)
- Admin dashboard → Inventory rules: loads inventory metrics (evidence: `BloodLink/Pages/AdminDashboardPage.cs`)
- Admin dashboard → Request rules: loads request metrics (evidence: `BloodLink/Pages/AdminDashboardPage.cs`)
- Operational reports → Inventory rules: queries stock and donations (evidence: `BloodLink/Pages/ReportsPage.cs`)
- Operational reports → Request rules: queries request status (evidence: `BloodLink/Pages/ReportsPage.cs`)
- Application settings → Settings repository: reads and writes (evidence: `BloodLink/Pages/SettingPage.cs`)
- Dashboard shell → Settings repository: loads preferences (evidence: `BloodLink/Forms/DashboardShell.cs`)
- Authentication logic → User repository: calls (evidence: `BloodLink/Services/AuthService.cs`)
- Donor rules → Donor repository: calls (evidence: `BloodLink/Services/DonorService.cs`)
- Inventory rules → Blood unit repository: calls (evidence: `BloodLink/Services/BloodUnitService.cs`)
- Request rules → Request repository: calls (evidence: `BloodLink/Services/PatientRequestService.cs`)
- User repository → SQL Server database: queries and writes
- Donor repository → SQL Server database: queries and writes
- Blood unit repository → SQL Server database: queries and writes (evidence: `BloodLink.Core/Database/BloodUnitRepository.cs`)
- Request repository → SQL Server database: queries and writes
- Settings repository → SQL Server database: reads and writes
- Dashboard shell → Theme and drawing helpers: uses theme helpers
