# feeqhai/srs-patrol-app architecture

> Architecture diagram of the GitHub repository feeqhai/srs-patrol-app, 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-patrol-app
- Repository: https://github.com/feeqhai/srs-patrol-app

## Overview

This is a Flutter app whose feature tree suggests an SRS field-operations product: users can authenticate, view a dashboard, report and review incidents, record attendance, track locations, and access administrative screens. The tree also exposes shared networking, settings, shell UI, and an SOS service. The README is only Flutter boilerplate, and the sampled source contains platform launchers rather than Dart feature implementations, so feature relationships and backend behavior cannot be verified; dashed links mark the inferred entry into the app, not confirmed calls.

Main entry points: [`lib/main.dart`](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/main.dart) (Flutter Entry), [`lib/core/widgets/main_shell.dart`](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/widgets/main_shell.dart) (App Shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Shell"]
  node_app_entry["Flutter Entry<br/>[main.dart]"]
  node_shell["App Shell<br/>[main_shell.dart]"]
  node_responsive_shell["Responsive Shell"]
end

subgraph group_identity["Identity"]
  node_login["Sign In<br/>[login_screen.dart]"]
  node_registration["Registration"]
  node_profile["User Profile"]
  node_auth_service["Authentication<br/>[auth_service.dart]"]
end

subgraph group_operations["Field Operations"]
  node_dashboard["Dashboard"]
  node_incident_reporting["Incident Reporting"]
  node_incident_review["Incident Review"]
  node_incident_detail["Incident Detail"]
  node_attendance["Attendance"]
  node_tracking["Location Tracking<br/>[map_screen.dart]"]
  node_sos["SOS Alerts"]
end

subgraph group_management["Administration"]
  node_admin["Admin Screens<br/>[admin_shell.dart]"]
  node_analytics["Analytics"]
end

subgraph group_shared["Shared Services"]
  node_api["API Client<br/>[api_client.dart]"]
  node_settings["Settings"]
  node_menu["Global Menu"]
  node_viewer["Image Viewer"]
end

node_user(("App User"))

node_user -.->|"launches"| node_app_entry
node_app_entry -.->|"starts"| node_shell

click node_app_entry "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/main.dart"
click node_shell "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/widgets/main_shell.dart"
click node_responsive_shell "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/widgets/responsive_shell.dart"
click node_login "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/auth/views/login_screen.dart"
click node_registration "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/auth/views/register_screen.dart"
click node_profile "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/auth/views/profile_screen.dart"
click node_auth_service "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/auth/services/auth_service.dart"
click node_dashboard "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/dashboard/views/dashboard_screen.dart"
click node_incident_reporting "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/incident/views/incident_report_screen.dart"
click node_incident_review "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/incident/views/incident_screen.dart"
click node_incident_detail "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/incident/views/incident_detail_screen.dart"
click node_attendance "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/attendance/views/attendance_screen.dart"
click node_tracking "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/tracking/views/map_screen.dart"
click node_sos "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/services/sos_alert_service.dart"
click node_admin "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/post/views/admin_shell.dart"
click node_analytics "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/post/views/analytics_screen.dart"
click node_api "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/network/api_client.dart"
click node_settings "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/providers/settings_provider.dart"
click node_menu "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/widgets/global_menu_button.dart"
click node_viewer "https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/widgets/image_viewer_screen.dart"

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_app_entry,node_shell,node_responsive_shell,node_user toneBlue
class node_login,node_registration,node_profile,node_auth_service toneAmber
class node_dashboard,node_incident_reporting,node_incident_review,node_incident_detail,node_attendance,node_tracking,node_sos toneMint
class node_admin,node_analytics toneRose
class node_api,node_settings,node_menu,node_viewer toneIndigo
```

## Components

### App Shell

- [Flutter Entry](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/main.dart): `lib/main.dart`
- [App Shell](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/widgets/main_shell.dart): `lib/core/widgets/main_shell.dart`
- [Responsive Shell](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/widgets/responsive_shell.dart): `lib/core/widgets/responsive_shell.dart`

### Identity

- [Sign In](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/auth/views/login_screen.dart): `lib/features/auth/views/login_screen.dart`
- [Registration](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/auth/views/register_screen.dart): `lib/features/auth/views/register_screen.dart`
- [User Profile](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/auth/views/profile_screen.dart): `lib/features/auth/views/profile_screen.dart`
- [Authentication](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/auth/services/auth_service.dart): `lib/features/auth/services/auth_service.dart`

### Field Operations

- [Dashboard](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/dashboard/views/dashboard_screen.dart): `lib/features/dashboard/views/dashboard_screen.dart`
- [Incident Reporting](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/incident/views/incident_report_screen.dart): `lib/features/incident/views/incident_report_screen.dart`
- [Incident Review](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/incident/views/incident_screen.dart): `lib/features/incident/views/incident_screen.dart`
- [Incident Detail](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/incident/views/incident_detail_screen.dart): `lib/features/incident/views/incident_detail_screen.dart`
- [Attendance](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/attendance/views/attendance_screen.dart): `lib/features/attendance/views/attendance_screen.dart`
- [Location Tracking](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/tracking/views/map_screen.dart): `lib/features/tracking/views/map_screen.dart`
- [SOS Alerts](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/services/sos_alert_service.dart): `lib/core/services/sos_alert_service.dart`

### Administration

- [Admin Screens](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/post/views/admin_shell.dart): `lib/features/post/views/admin_shell.dart`
- [Analytics](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/features/post/views/analytics_screen.dart): `lib/features/post/views/analytics_screen.dart`

### Shared Services

- [API Client](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/network/api_client.dart): `lib/core/network/api_client.dart`
- [Settings](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/providers/settings_provider.dart): `lib/core/providers/settings_provider.dart`
- [Global Menu](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/widgets/global_menu_button.dart): `lib/core/widgets/global_menu_button.dart`
- [Image Viewer](https://github.com/feeqhai/srs-patrol-app/blob/main/lib/core/widgets/image_viewer_screen.dart): `lib/core/widgets/image_viewer_screen.dart`

### Other components

- **App User**

## Connections

- App User → Flutter Entry: launches
- Flutter Entry → App Shell: starts
