# feeqhai/srs-api-backend architecture

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

- Interactive diagram: https://gitdiagram.com/feeqhai/srs-api-backend
- Repository: https://github.com/feeqhai/srs-api-backend

## Overview

This repository is a PHP API for a community patrol and incident-response system. Patrol members register and authenticate, manage shifts through clock-in/out and equipment logging, and submit incidents or SOS alerts; administrators manage users, squads, schedules, equipment, and incident status, and retrieve operational statistics and reports. The API uses MySQL and JWT utilities. The README is empty, so the product workflow is inferred from endpoint names and sampled handlers; unsampled features are represented at their existing directory paths, without assuming links beyond the indexed imports.

Main entry points: [`config/db_connect.php`](https://github.com/feeqhai/srs-api-backend/blob/main/config/db_connect.php) (MySQL database), [`config/jwt_utils.php`](https://github.com/feeqhai/srs-api-backend/blob/main/config/jwt_utils.php) (JWT utilities), [`attendance`](https://github.com/feeqhai/srs-api-backend/tree/main/attendance) (Shift attendance), [`tracking/sos_alert.php`](https://github.com/feeqhai/srs-api-backend/blob/main/tracking/sos_alert.php) (SOS alert)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity"]
  node_auth_api["Account and profile"]
end

subgraph group_patrol["Patrol Operations"]
  node_attendance_api["Shift attendance"]
  node_equipment_api["Equipment inventory"]
end

subgraph group_response["Incident Response"]
  node_sos_api["SOS alert<br/>[sos_alert.php]"]
  node_incident_api["Incident reports"]
  node_reporting["Incident summaries"]
end

subgraph group_admin["Administration"]
  node_admin_squads["Squad management<br/>[squads.php]"]
  node_admin_schedules["Shift schedules<br/>[schedules.php]"]
  node_admin_users["User administration<br/>[update_user.php]"]
  node_admin_metrics["Shift statistics"]
end

subgraph group_shared["Shared Services"]
  node_jwt["JWT utilities<br/>[jwt_utils.php]"]
  node_database[("MySQL database<br/>[db_connect.php]")]
end

node_caller(("API clients"))

node_caller -->|"requests accounts"| node_auth_api
node_caller -->|"records shifts"| node_attendance_api
node_caller -->|"manages equipment"| node_equipment_api
node_caller -->|"sends SOS"| node_sos_api
node_caller -->|"submits reports"| node_incident_api
node_caller -->|"manages squads"| node_admin_squads
node_caller -->|"manages shifts"| node_admin_schedules
node_caller -->|"updates users"| node_admin_users
node_caller -->|"requests statistics"| node_admin_metrics
node_caller -->|"requests summaries"| node_reporting
node_auth_api -->|"reads and writes"| node_database
node_attendance_api -->|"reads and writes"| node_database
node_equipment_api -->|"reads and writes"| node_database
node_sos_api -->|"records alert"| node_database
node_incident_api -->|"reads and writes"| node_database
node_admin_squads -->|"reads and writes"| node_database
node_admin_schedules -->|"reads and writes"| node_database
node_admin_users -->|"updates users"| node_database
node_admin_metrics -->|"queries metrics"| node_database
node_reporting -->|"queries incidents"| node_database
node_attendance_api -->|"verifies tokens"| node_jwt
node_sos_api -->|"verifies tokens"| node_jwt
node_incident_api -->|"verifies tokens"| node_jwt
node_admin_schedules -->|"verifies tokens"| node_jwt

click node_auth_api "https://github.com/feeqhai/srs-api-backend/tree/main/auth"
click node_attendance_api "https://github.com/feeqhai/srs-api-backend/tree/main/attendance"
click node_equipment_api "https://github.com/feeqhai/srs-api-backend/tree/main/equipment"
click node_sos_api "https://github.com/feeqhai/srs-api-backend/blob/main/tracking/sos_alert.php"
click node_incident_api "https://github.com/feeqhai/srs-api-backend/tree/main/incidents"
click node_admin_squads "https://github.com/feeqhai/srs-api-backend/blob/main/admin/squads.php"
click node_admin_schedules "https://github.com/feeqhai/srs-api-backend/blob/main/admin/schedules.php"
click node_admin_users "https://github.com/feeqhai/srs-api-backend/blob/main/admin/update_user.php"
click node_admin_metrics "https://github.com/feeqhai/srs-api-backend/tree/main/admin"
click node_reporting "https://github.com/feeqhai/srs-api-backend/blob/main/incidents/get_lampiran_6_summary.php"
click node_jwt "https://github.com/feeqhai/srs-api-backend/blob/main/config/jwt_utils.php"
click node_database "https://github.com/feeqhai/srs-api-backend/blob/main/config/db_connect.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_api,node_caller toneBlue
class node_attendance_api,node_equipment_api toneAmber
class node_sos_api,node_incident_api,node_reporting toneMint
class node_admin_squads,node_admin_schedules,node_admin_users,node_admin_metrics toneRose
class node_jwt,node_database toneIndigo
```

## Components

### Identity

- [Account and profile](https://github.com/feeqhai/srs-api-backend/tree/main/auth): `auth`

### Patrol Operations

- [Shift attendance](https://github.com/feeqhai/srs-api-backend/tree/main/attendance): `attendance`
- [Equipment inventory](https://github.com/feeqhai/srs-api-backend/tree/main/equipment): `equipment`

### Incident Response

- [SOS alert](https://github.com/feeqhai/srs-api-backend/blob/main/tracking/sos_alert.php): `tracking/sos_alert.php`
- [Incident reports](https://github.com/feeqhai/srs-api-backend/tree/main/incidents): `incidents`
- [Incident summaries](https://github.com/feeqhai/srs-api-backend/blob/main/incidents/get_lampiran_6_summary.php): `incidents/get_lampiran_6_summary.php`

### Administration

- [Squad management](https://github.com/feeqhai/srs-api-backend/blob/main/admin/squads.php): `admin/squads.php`
- [Shift schedules](https://github.com/feeqhai/srs-api-backend/blob/main/admin/schedules.php): `admin/schedules.php`
- [User administration](https://github.com/feeqhai/srs-api-backend/blob/main/admin/update_user.php): `admin/update_user.php`
- [Shift statistics](https://github.com/feeqhai/srs-api-backend/tree/main/admin): `admin`

### Shared Services

- [JWT utilities](https://github.com/feeqhai/srs-api-backend/blob/main/config/jwt_utils.php): `config/jwt_utils.php`
- [MySQL database](https://github.com/feeqhai/srs-api-backend/blob/main/config/db_connect.php): `config/db_connect.php`

### Other components

- **API clients**

## Connections

- API clients → Account and profile: requests accounts (evidence: `auth/register.php`)
- API clients → Shift attendance: records shifts (evidence: `attendance/clock_in.php`)
- API clients → Equipment inventory: manages equipment (evidence: `equipment/manage_equipment.php`)
- API clients → SOS alert: sends SOS (evidence: `tracking/sos_alert.php`)
- API clients → Incident reports: submits reports (evidence: `incidents/upload_incident.php`)
- API clients → Squad management: manages squads (evidence: `admin/squads.php`)
- API clients → Shift schedules: manages shifts (evidence: `admin/schedules.php`)
- API clients → User administration: updates users (evidence: `admin/update_user.php`)
- API clients → Shift statistics: requests statistics (evidence: `admin/get_stats.php`)
- API clients → Incident summaries: requests summaries (evidence: `incidents/get_lampiran_6_summary.php`)
- Account and profile → MySQL database: reads and writes (evidence: `auth/register.php`)
- Shift attendance → MySQL database: reads and writes (evidence: `attendance/clock_in.php`)
- Equipment inventory → MySQL database: reads and writes (evidence: `equipment/manage_equipment.php`)
- SOS alert → MySQL database: records alert (evidence: `tracking/sos_alert.php`)
- Incident reports → MySQL database: reads and writes (evidence: `incidents/upload_incident.php`)
- Squad management → MySQL database: reads and writes (evidence: `admin/squads.php`)
- Shift schedules → MySQL database: reads and writes (evidence: `admin/schedules.php`)
- User administration → MySQL database: updates users (evidence: `admin/update_user.php`)
- Shift statistics → MySQL database: queries metrics (evidence: `admin/get_stats.php`)
- Incident summaries → MySQL database: queries incidents (evidence: `incidents/get_lampiran_6_summary.php`)
- Shift attendance → JWT utilities: verifies tokens (evidence: `attendance/clock_in.php`)
- SOS alert → JWT utilities: verifies tokens (evidence: `tracking/sos_alert.php`)
- Incident reports → JWT utilities: verifies tokens (evidence: `incidents/upload_incident.php`)
- Shift schedules → JWT utilities: verifies tokens (evidence: `admin/schedules.php`)
