# smiley-wangdu/vital_drop architecture

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

- Interactive diagram: https://gitdiagram.com/smiley-wangdu/vital_drop
- Repository: https://github.com/smiley-wangdu/vital_drop

## Overview

Vital Drop is a blood-donation coordination platform: people register, find compatible donors or blood requests, donate, and participate in campaigns; administrators manage users, campaigns, and requests. Public information pages lead into account and donor workflows, while dashboards expose notifications and activity. The graph includes the database and email transport as internal service layers. The README is empty, and several domain handlers were not excerpted, so some capabilities are represented by their exact tree paths without speculative call links.

Main entry points: [`config/db.php`](https://github.com/smiley-wangdu/vital_drop/blob/main/config/db.php) (Database connection), [`public/index.php`](https://github.com/smiley-wangdu/vital_drop/blob/main/public/index.php) (Public portal), [`admin/index.php`](https://github.com/smiley-wangdu/vital_drop/blob/main/admin/index.php) (Admin dashboard), [`user/dashboard.php`](https://github.com/smiley-wangdu/vital_drop/blob/main/user/dashboard.php) (Donor dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Public discovery"]
  node_public_site["Public portal<br/>[index.php]"]
  node_about["About and guidance<br/>[about.php]"]
  node_how_it_works["How it works<br/>[howitworks.php]"]
  node_contact["Contact<br/>[contact.php]"]
end

subgraph group_identity["Accounts and access"]
  node_auth["Account access<br/>[login.php]"]
  node_registration["Registration and verification<br/>[register_step2.php]"]
  node_session["Session controls<br/>[session.php]"]
end

subgraph group_coordination["Donation coordination"]
  node_user_dashboard["Donor dashboard<br/>[dashboard.php]"]
  node_donor_matching["Compatible donors"]
  node_blood_requests["Blood requests"]
  node_donation["Donation submission"]
  node_donor_status["Donor availability"]
  node_campaigns["Campaign participation<br/>[my_campaigns.php]"]
  node_notifications["Notifications"]
end

subgraph group_operations["Administration"]
  node_admin_dashboard["Admin dashboard<br/>[index.php]"]
  node_admin_users["User management<br/>[users.php]"]
  node_admin_campaigns["Campaign management<br/>[campaigns.php]"]
  node_admin_requests["Request management<br/>[requests.php]"]
end

subgraph group_services["Shared services"]
  node_database_config["Database connection<br/>[db.php]"]
  node_database[("Vital Drop data")]
  node_chatbot_widget["Chatbot widget<br/>[chatbot_widget.php]"]
  node_chatbot_backend["Chatbot handler<br/>[chatbot.php]"]
  node_mail_config["Mail sending<br/>[send_mail.php]"]
  node_phpmailer["PHPMailer transport<br/>[PHPMailer.php]"]
  node_smtp["SMTP transport<br/>[SMTP.php]"]
end

node_visitor(("Visitor"))

node_visitor -->|"visits"| node_public_site
node_public_site -->|"includes"| node_about
node_public_site -->|"includes"| node_how_it_works
node_public_site -->|"includes"| node_contact
node_public_site -->|"links to"| node_auth
node_auth -->|"imports"| node_database_config
node_registration -->|"imports"| node_database_config
node_user_dashboard -->|"requires"| node_session
node_user_dashboard -->|"imports"| node_database_config
node_user_dashboard -->|"includes"| node_chatbot_widget
node_donor_matching -.->|"uses"| node_database_config
node_blood_requests -.->|"uses"| node_database_config
node_donation -->|"imports"| node_session
node_donation -->|"imports"| node_database_config
node_donation -->|"uses helper"| node_notifications
node_donor_status -.->|"uses"| node_database_config
node_campaigns -.->|"uses"| node_database_config
node_notifications -->|"imports"| node_database_config
node_admin_dashboard -->|"imports"| node_database_config
node_admin_dashboard -->|"navigates to"| node_admin_users
node_admin_dashboard -->|"navigates to"| node_admin_campaigns
node_admin_dashboard -->|"navigates to"| node_admin_requests
node_chatbot_backend -->|"imports"| node_session
node_chatbot_backend -->|"imports"| node_database_config
node_mail_config -->|"imports"| node_phpmailer
node_phpmailer -->|"creates transport"| node_smtp

click node_public_site "https://github.com/smiley-wangdu/vital_drop/blob/main/public/index.php"
click node_about "https://github.com/smiley-wangdu/vital_drop/blob/main/public/about.php"
click node_how_it_works "https://github.com/smiley-wangdu/vital_drop/blob/main/public/howitworks.php"
click node_contact "https://github.com/smiley-wangdu/vital_drop/blob/main/public/contact.php"
click node_auth "https://github.com/smiley-wangdu/vital_drop/blob/main/auth/login.php"
click node_registration "https://github.com/smiley-wangdu/vital_drop/blob/main/auth/register_step2.php"
click node_session "https://github.com/smiley-wangdu/vital_drop/blob/main/includes/session.php"
click node_user_dashboard "https://github.com/smiley-wangdu/vital_drop/blob/main/user/dashboard.php"
click node_donor_matching "https://github.com/smiley-wangdu/vital_drop/blob/main/public/compatible_donors.php"
click node_blood_requests "https://github.com/smiley-wangdu/vital_drop/blob/main/public/request_blood_action.php"
click node_donation "https://github.com/smiley-wangdu/vital_drop/blob/main/backend/donor/submit-donation.php"
click node_donor_status "https://github.com/smiley-wangdu/vital_drop/blob/main/backend/donor/update-availability.php"
click node_campaigns "https://github.com/smiley-wangdu/vital_drop/blob/main/user/my_campaigns.php"
click node_notifications "https://github.com/smiley-wangdu/vital_drop/blob/main/user/api/get_unread_notifications.php"
click node_admin_dashboard "https://github.com/smiley-wangdu/vital_drop/blob/main/admin/index.php"
click node_admin_users "https://github.com/smiley-wangdu/vital_drop/blob/main/admin/users.php"
click node_admin_campaigns "https://github.com/smiley-wangdu/vital_drop/blob/main/admin/campaigns.php"
click node_admin_requests "https://github.com/smiley-wangdu/vital_drop/blob/main/admin/requests.php"
click node_database_config "https://github.com/smiley-wangdu/vital_drop/blob/main/config/db.php"
click node_chatbot_widget "https://github.com/smiley-wangdu/vital_drop/blob/main/includes/chatbot_widget.php"
click node_chatbot_backend "https://github.com/smiley-wangdu/vital_drop/blob/main/backend/chatbot.php"
click node_mail_config "https://github.com/smiley-wangdu/vital_drop/blob/main/config/send_mail.php"
click node_phpmailer "https://github.com/smiley-wangdu/vital_drop/blob/main/mail/PHPMailer/src/PHPMailer.php"
click node_smtp "https://github.com/smiley-wangdu/vital_drop/blob/main/mail/PHPMailer/src/SMTP.php"

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_public_site,node_about,node_how_it_works,node_contact toneBlue
class node_auth,node_registration,node_session toneAmber
class node_user_dashboard,node_donor_matching,node_blood_requests,node_donation,node_donor_status,node_campaigns,node_notifications toneMint
class node_admin_dashboard,node_admin_users,node_admin_campaigns,node_admin_requests toneRose
class node_database_config,node_database,node_chatbot_widget,node_chatbot_backend,node_mail_config,node_phpmailer,node_smtp,node_visitor toneIndigo
```

## Components

### Public discovery

- [Public portal](https://github.com/smiley-wangdu/vital_drop/blob/main/public/index.php): `public/index.php`
- [About and guidance](https://github.com/smiley-wangdu/vital_drop/blob/main/public/about.php): `public/about.php`
- [How it works](https://github.com/smiley-wangdu/vital_drop/blob/main/public/howitworks.php): `public/howitworks.php`
- [Contact](https://github.com/smiley-wangdu/vital_drop/blob/main/public/contact.php): `public/contact.php`

### Accounts and access

- [Account access](https://github.com/smiley-wangdu/vital_drop/blob/main/auth/login.php): `auth/login.php`
- [Registration and verification](https://github.com/smiley-wangdu/vital_drop/blob/main/auth/register_step2.php): `auth/register_step2.php`
- [Session controls](https://github.com/smiley-wangdu/vital_drop/blob/main/includes/session.php): `includes/session.php`

### Donation coordination

- [Donor dashboard](https://github.com/smiley-wangdu/vital_drop/blob/main/user/dashboard.php): `user/dashboard.php`
- [Compatible donors](https://github.com/smiley-wangdu/vital_drop/blob/main/public/compatible_donors.php): `public/compatible_donors.php`
- [Blood requests](https://github.com/smiley-wangdu/vital_drop/blob/main/public/request_blood_action.php): `public/request_blood_action.php`
- [Donation submission](https://github.com/smiley-wangdu/vital_drop/blob/main/backend/donor/submit-donation.php): `backend/donor/submit-donation.php`
- [Donor availability](https://github.com/smiley-wangdu/vital_drop/blob/main/backend/donor/update-availability.php): `backend/donor/update-availability.php`
- [Campaign participation](https://github.com/smiley-wangdu/vital_drop/blob/main/user/my_campaigns.php): `user/my_campaigns.php`
- [Notifications](https://github.com/smiley-wangdu/vital_drop/blob/main/user/api/get_unread_notifications.php): `user/api/get_unread_notifications.php`

### Administration

- [Admin dashboard](https://github.com/smiley-wangdu/vital_drop/blob/main/admin/index.php): `admin/index.php`
- [User management](https://github.com/smiley-wangdu/vital_drop/blob/main/admin/users.php): `admin/users.php`
- [Campaign management](https://github.com/smiley-wangdu/vital_drop/blob/main/admin/campaigns.php): `admin/campaigns.php`
- [Request management](https://github.com/smiley-wangdu/vital_drop/blob/main/admin/requests.php): `admin/requests.php`

### Shared services

- [Database connection](https://github.com/smiley-wangdu/vital_drop/blob/main/config/db.php): `config/db.php`
- **Vital Drop data**
- [Chatbot widget](https://github.com/smiley-wangdu/vital_drop/blob/main/includes/chatbot_widget.php): `includes/chatbot_widget.php`
- [Chatbot handler](https://github.com/smiley-wangdu/vital_drop/blob/main/backend/chatbot.php): `backend/chatbot.php`
- [Mail sending](https://github.com/smiley-wangdu/vital_drop/blob/main/config/send_mail.php): `config/send_mail.php`
- [PHPMailer transport](https://github.com/smiley-wangdu/vital_drop/blob/main/mail/PHPMailer/src/PHPMailer.php): `mail/PHPMailer/src/PHPMailer.php`
- [SMTP transport](https://github.com/smiley-wangdu/vital_drop/blob/main/mail/PHPMailer/src/SMTP.php): `mail/PHPMailer/src/SMTP.php`

### Other components

- **Visitor**

## Connections

- Visitor → Public portal: visits (evidence: `public/index.php`)
- Public portal → About and guidance: includes (evidence: `public/index.php`)
- Public portal → How it works: includes (evidence: `public/index.php`)
- Public portal → Contact: includes (evidence: `public/index.php`)
- Public portal → Account access: links to (evidence: `public/index.php`)
- Account access → Database connection: imports (evidence: `auth/login.php`)
- Registration and verification → Database connection: imports (evidence: `auth/register_step2.php`)
- Donor dashboard → Session controls: requires (evidence: `user/dashboard.php`)
- Donor dashboard → Database connection: imports (evidence: `user/dashboard.php`)
- Donor dashboard → Chatbot widget: includes (evidence: `user/dashboard.php`)
- Compatible donors → Database connection: uses
- Blood requests → Database connection: uses
- Donation submission → Session controls: imports (evidence: `backend/donor/submit-donation.php`)
- Donation submission → Database connection: imports (evidence: `backend/donor/submit-donation.php`)
- Donation submission → Notifications: uses helper (evidence: `backend/donor/submit-donation.php`)
- Donor availability → Database connection: uses
- Campaign participation → Database connection: uses
- Notifications → Database connection: imports (evidence: `user/api/get_unread_notifications.php`)
- Admin dashboard → Database connection: imports (evidence: `admin/index.php`)
- Admin dashboard → User management: navigates to
- Admin dashboard → Campaign management: navigates to
- Admin dashboard → Request management: navigates to
- Chatbot handler → Session controls: imports (evidence: `backend/chatbot.php`)
- Chatbot handler → Database connection: imports (evidence: `backend/chatbot.php`)
- Mail sending → PHPMailer transport: imports (evidence: `config/send_mail.php`)
- PHPMailer transport → SMTP transport: creates transport (evidence: `mail/PHPMailer/src/PHPMailer.php`)
