# ananta-saha/summer-25-26-emergency-help-hub architecture

> Architecture diagram of the GitHub repository ananta-saha/summer-25-26-emergency-help-hub, 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/ananta-saha/summer-25-26-emergency-help-hub
- Repository: https://github.com/ananta-saha/summer-25-26-emergency-help-hub

## Overview

Emergency Help Hub is a role-based PHP/MySQL emergency-response platform. Citizens find nearby services and submit requests with emergency details; providers manage availability and respond, while organizations coordinate services and funds and administrators oversee requests, users, notifications, and funding. The graph separates the user-facing role workflows from their model and database layer. Several controllers and role capabilities are only listed in the tree or README, so their internal calls are shown as unverified rather than inferred as confirmed.

Main entry points: [`config/db.php`](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/config/db.php) (Database connection), [`controller/auth/login.php`](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/auth/login.php) (Authentication), [`model/provider/ProviderModel.php`](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/provider/ProviderModel.php) (Provider operations), [`controller/citizen/services.php`](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/citizen/services.php) (Find services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and accounts"]
  node_auth_controller["Authentication<br/>[login.php]"]
  node_auth_model["Role authentication<br/>[AuthModel.php]"]
end

subgraph group_citizen["Citizen assistance"]
  node_citizen_services["Find services<br/>[services.php]"]
  node_services_view["Service results<br/>[services.php]"]
  node_request_submit["Request assistance"]
  node_citizen_model["Citizen requests and profile<br/>[CitizenModel.php]"]
  node_request_status["Request status<br/>[request-status.php]"]
end

subgraph group_provider["Provider response"]
  node_provider_dashboard["Provider dashboard<br/>[dashboard.php]"]
  node_provider_requests["Provider requests<br/>[requests.php]"]
  node_provider_status["Update response status<br/>[update-status.php]"]
  node_provider_availability["Availability<br/>[availability.php]"]
  node_provider_model["Provider operations<br/>[ProviderModel.php]"]
end

subgraph group_coordination["Administration and organizations"]
  node_admin_requests["Admin request review"]
  node_admin_request_model["Request management"]
  node_admin_org["Organization management"]
  node_admin_org_model["Organization records"]
  node_admin_provider["Provider management"]
  node_admin_provider_model["Provider records"]
  node_admin_funds["Fund review<br/>[FundController.php]"]
  node_admin_notifications["Notifications"]
  node_org_dashboard["Organization dashboard<br/>[dashboard.php]"]
  node_org_model["Organization services and funds"]
end

subgraph group_data["Persistence"]
  node_db_config["Database connection<br/>[db.php]"]
end

node_citizen_actor(("Citizen"))
node_provider_actor(("Service provider"))
node_org_actor(("Organization"))
node_admin_actor(("Administrator"))
node_mysql[("MySQL database")]

node_citizen_actor -->|"signs in"| node_auth_controller
node_provider_actor -->|"signs in"| node_auth_controller
node_org_actor -->|"signs in"| node_auth_controller
node_admin_actor -->|"signs in"| node_auth_controller
node_auth_controller -->|"authenticates with"| node_auth_model
node_citizen_actor -->|"searches services"| node_citizen_services
node_citizen_services -->|"searches providers"| node_citizen_model
node_citizen_services -->|"renders"| node_services_view
node_services_view -->|"starts request"| node_request_submit
node_citizen_actor -.->|"submits details"| node_request_submit
node_request_submit -.->|"creates request"| node_citizen_model
node_citizen_actor -.->|"checks progress"| node_request_status
node_provider_actor -->|"opens dashboard"| node_provider_dashboard
node_provider_dashboard -->|"loads data"| node_provider_model
node_provider_actor -.->|"reviews requests"| node_provider_requests
node_provider_requests -.->|"loads requests"| node_provider_model
node_provider_actor -->|"updates response"| node_provider_status
node_provider_status -->|"updates request"| node_provider_model
node_provider_actor -.->|"sets availability"| node_provider_availability
node_provider_availability -.->|"updates availability"| node_provider_model
node_admin_actor -->|"reviews requests"| node_admin_requests
node_admin_requests -->|"manages requests"| node_admin_request_model
node_admin_actor -->|"manages organizations"| node_admin_org
node_admin_org -->|"updates records"| node_admin_org_model
node_admin_actor -->|"manages providers"| node_admin_provider
node_admin_provider -->|"updates records"| node_admin_provider_model
node_admin_actor -->|"reviews funds"| node_admin_funds
node_admin_actor -->|"manages notices"| node_admin_notifications
node_org_actor -->|"coordinates support"| node_org_dashboard
node_org_dashboard -->|"loads and updates"| node_org_model
node_auth_model -->|"uses connection"| node_db_config
node_citizen_model -->|"uses connection"| node_db_config
node_provider_model -->|"uses connection"| node_db_config
node_org_model -->|"uses connection"| node_db_config
node_admin_request_model -->|"uses connection"| node_db_config
node_admin_org_model -->|"uses connection"| node_db_config
node_admin_provider_model -->|"uses connection"| node_db_config
node_db_config -->|"connects to"| node_mysql

click node_auth_controller "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/auth/login.php"
click node_auth_model "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/auth/AuthModel.php"
click node_citizen_services "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/citizen/services.php"
click node_services_view "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/view/citizen/services.php"
click node_request_submit "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/citizen/emergency-request.php"
click node_citizen_model "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/citizen/CitizenModel.php"
click node_request_status "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/citizen/request-status.php"
click node_provider_dashboard "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/provider/dashboard.php"
click node_provider_requests "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/provider/requests.php"
click node_provider_status "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/provider/update-status.php"
click node_provider_availability "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/provider/availability.php"
click node_provider_model "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/provider/ProviderModel.php"
click node_admin_requests "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/admin/EmergencyRequestController.php"
click node_admin_request_model "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/admin/EmergencyRequestModel.php"
click node_admin_org "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/admin/OrganizationController.php"
click node_admin_org_model "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/admin/OrganizationManagementModel.php"
click node_admin_provider "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/admin/ProviderController.php"
click node_admin_provider_model "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/admin/ProviderManagementModel.php"
click node_admin_funds "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/admin/FundController.php"
click node_admin_notifications "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/admin/NotificationController.php"
click node_org_dashboard "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/organization/dashboard.php"
click node_org_model "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/organization/OrganizationModel.php"
click node_db_config "https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/config/db.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_auth_controller,node_auth_model toneBlue
class node_citizen_services,node_services_view,node_request_submit,node_citizen_model,node_request_status,node_mysql toneAmber
class node_provider_dashboard,node_provider_requests,node_provider_status,node_provider_availability,node_provider_model toneMint
class node_admin_requests,node_admin_request_model,node_admin_org,node_admin_org_model,node_admin_provider,node_admin_provider_model,node_admin_funds,node_admin_notifications,node_org_dashboard,node_org_model toneRose
class node_db_config,node_citizen_actor,node_provider_actor,node_org_actor,node_admin_actor toneIndigo
```

## Components

### Access and accounts

- [Authentication](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/auth/login.php): `controller/auth/login.php`
- [Role authentication](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/auth/AuthModel.php): `model/auth/AuthModel.php`

### Citizen assistance

- [Find services](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/citizen/services.php): `controller/citizen/services.php`
- [Service results](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/view/citizen/services.php): `view/citizen/services.php`
- [Request assistance](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/citizen/emergency-request.php): `controller/citizen/emergency-request.php`
- [Citizen requests and profile](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/citizen/CitizenModel.php): `model/citizen/CitizenModel.php`
- [Request status](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/citizen/request-status.php): `controller/citizen/request-status.php`

### Provider response

- [Provider dashboard](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/provider/dashboard.php): `controller/provider/dashboard.php`
- [Provider requests](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/provider/requests.php): `controller/provider/requests.php`
- [Update response status](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/provider/update-status.php): `controller/provider/update-status.php`
- [Availability](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/provider/availability.php): `controller/provider/availability.php`
- [Provider operations](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/provider/ProviderModel.php): `model/provider/ProviderModel.php`

### Administration and organizations

- [Admin request review](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/admin/EmergencyRequestController.php): `controller/admin/EmergencyRequestController.php`
- [Request management](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/admin/EmergencyRequestModel.php): `model/admin/EmergencyRequestModel.php`
- [Organization management](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/admin/OrganizationController.php): `controller/admin/OrganizationController.php`
- [Organization records](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/admin/OrganizationManagementModel.php): `model/admin/OrganizationManagementModel.php`
- [Provider management](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/admin/ProviderController.php): `controller/admin/ProviderController.php`
- [Provider records](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/admin/ProviderManagementModel.php): `model/admin/ProviderManagementModel.php`
- [Fund review](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/admin/FundController.php): `controller/admin/FundController.php`
- [Notifications](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/admin/NotificationController.php): `controller/admin/NotificationController.php`
- [Organization dashboard](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/controller/organization/dashboard.php): `controller/organization/dashboard.php`
- [Organization services and funds](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/model/organization/OrganizationModel.php): `model/organization/OrganizationModel.php`

### Persistence

- [Database connection](https://github.com/ananta-saha/summer-25-26-emergency-help-hub/blob/main/config/db.php): `config/db.php`

### Other components

- **Citizen**
- **Service provider**
- **Organization**
- **Administrator**
- **MySQL database**

## Connections

- Citizen → Authentication: signs in
- Service provider → Authentication: signs in
- Organization → Authentication: signs in
- Administrator → Authentication: signs in
- Authentication → Role authentication: authenticates with (evidence: `controller/auth/login.php`)
- Citizen → Find services: searches services (evidence: `controller/citizen/services.php`)
- Find services → Citizen requests and profile: searches providers (evidence: `controller/citizen/services.php`)
- Find services → Service results: renders (evidence: `controller/citizen/services.php`)
- Service results → Request assistance: starts request (evidence: `view/citizen/services.php`)
- Citizen → Request assistance: submits details
- Request assistance → Citizen requests and profile: creates request
- Citizen → Request status: checks progress
- Service provider → Provider dashboard: opens dashboard
- Provider dashboard → Provider operations: loads data (evidence: `controller/provider/dashboard.php`)
- Service provider → Provider requests: reviews requests
- Provider requests → Provider operations: loads requests
- Service provider → Update response status: updates response (evidence: `controller/provider/update-status.php`)
- Update response status → Provider operations: updates request (evidence: `controller/provider/update-status.php`)
- Service provider → Availability: sets availability
- Availability → Provider operations: updates availability
- Administrator → Admin request review: reviews requests
- Admin request review → Request management: manages requests (evidence: `controller/admin/EmergencyRequestController.php`)
- Administrator → Organization management: manages organizations
- Organization management → Organization records: updates records (evidence: `controller/admin/OrganizationController.php`)
- Administrator → Provider management: manages providers
- Provider management → Provider records: updates records (evidence: `controller/admin/ProviderController.php`)
- Administrator → Fund review: reviews funds
- Administrator → Notifications: manages notices
- Organization → Organization dashboard: coordinates support
- Organization dashboard → Organization services and funds: loads and updates (evidence: `controller/organization/dashboard.php`)
- Role authentication → Database connection: uses connection (evidence: `model/auth/AuthModel.php`)
- Citizen requests and profile → Database connection: uses connection (evidence: `model/citizen/CitizenModel.php`)
- Provider operations → Database connection: uses connection (evidence: `model/provider/ProviderModel.php`)
- Organization services and funds → Database connection: uses connection (evidence: `model/organization/OrganizationModel.php`)
- Request management → Database connection: uses connection (evidence: `model/admin/EmergencyRequestModel.php`)
- Organization records → Database connection: uses connection (evidence: `model/admin/OrganizationManagementModel.php`)
- Provider records → Database connection: uses connection (evidence: `model/admin/ProviderManagementModel.php`)
- Database connection → MySQL database: connects to (evidence: `config/db.php`)
