# nas010122/final_citizen_service_request_system_frontend architecture

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

- Interactive diagram: https://gitdiagram.com/nas010122/final_citizen_service_request_system_frontend
- Repository: https://github.com/nas010122/final_citizen_service_request_system_frontend

## Overview

This is a Flutter starter application; the README does not describe a particular domain or product workflow. The tree names authentication, registration, and role-specific dashboards, but no Dart source was excerpted, so their control flow and API behavior cannot be confirmed. The graph preserves those visible components and the sampled native launch scaffolding; edges are limited to relationships shown in excerpts. Platform files are hosts for the Flutter application, not separate product features.

Main entry points: [`windows/runner/flutter_window.h`](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/windows/runner/flutter_window.h) (Windows Flutter host), [`windows/runner/main.cpp`](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/windows/runner/main.cpp) (Windows entry), [`linux/runner/main.cc`](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/linux/runner/main.cc) (Linux entry), [`windows/runner/win32_window.cpp`](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/windows/runner/win32_window.cpp) (Windows window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth_ui["Authentication UI"]
  node_flutter_app["Flutter app<br/>[main.dart]"]
  node_login["Login view<br/>[login_view.dart]"]
  node_register["Registration view<br/>[register_view.dart]"]
end

subgraph group_auth_state["Authentication State"]
  node_auth_bloc["Auth BLoC<br/>[auth_bloc.dart]"]
  node_auth_event["Auth events<br/>[auth_event.dart]"]
  node_auth_state_model["Auth states<br/>[auth_state.dart]"]
  node_api_constants["API constants<br/>[api_constants.dart]"]
end

subgraph group_dashboards["Role Dashboards"]
  node_dashboard_view["Dashboard view"]
  node_citizen_dashboard["Citizen dashboard"]
  node_barangay_dashboard["Barangay dashboard"]
  node_municipal_dashboard["Municipal dashboard"]
  node_provincial_dashboard["Provincial dashboard"]
end

subgraph group_platform["Platform Hosts"]
  node_windows_entry["Windows entry<br/>[main.cpp]"]
  node_windows_flutter_window["Windows Flutter host<br/>[flutter_window.h]"]
  node_windows_base_window["Windows window<br/>[win32_window.cpp]"]
  node_windows_window_header["Windows window API<br/>[win32_window.h]"]
  node_linux_entry["Linux entry<br/>[main.cc]"]
  node_linux_application["Linux application<br/>[my_application.h]"]
  node_ios_delegate["iOS app delegate<br/>[AppDelegate.swift]"]
  node_macos_registrant["macOS plugin registry"]
  node_linux_plugin_api["Linux plugin API"]
  node_windows_plugin_api["Windows plugin API"]
end

node_user(("App user"))

node_windows_entry -->|"creates host"| node_windows_flutter_window
node_windows_flutter_window -->|"inherits from"| node_windows_base_window
node_linux_entry -->|"creates application"| node_linux_application

click node_flutter_app "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/main.dart"
click node_login "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/login_view.dart"
click node_register "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/register_view.dart"
click node_auth_bloc "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/bloc/auth_bloc.dart"
click node_auth_event "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/bloc/auth_event.dart"
click node_auth_state_model "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/bloc/auth_state.dart"
click node_api_constants "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/core/constants/api_constants.dart"
click node_dashboard_view "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/dashboard_view.dart"
click node_citizen_dashboard "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/dashboards/citizen_dashboard_view.dart"
click node_barangay_dashboard "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/dashboards/barangay_dashboard_view.dart"
click node_municipal_dashboard "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/dashboards/municipal_dashboard_view.dart"
click node_provincial_dashboard "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/dashboards/provincial_dashboard_view.dart"
click node_windows_entry "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/windows/runner/main.cpp"
click node_windows_flutter_window "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/windows/runner/flutter_window.h"
click node_windows_base_window "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/windows/runner/win32_window.cpp"
click node_windows_window_header "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/windows/runner/win32_window.h"
click node_linux_entry "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/linux/runner/main.cc"
click node_linux_application "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/linux/runner/my_application.h"
click node_ios_delegate "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/ios/Runner/AppDelegate.swift"
click node_macos_registrant "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift"
click node_linux_plugin_api "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/linux/flutter/generated_plugin_registrant.h"
click node_windows_plugin_api "https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/windows/flutter/generated_plugin_registrant.h"

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_flutter_app,node_login,node_register,node_user toneBlue
class node_auth_bloc,node_auth_event,node_auth_state_model,node_api_constants toneAmber
class node_dashboard_view,node_citizen_dashboard,node_barangay_dashboard,node_municipal_dashboard,node_provincial_dashboard toneMint
class node_windows_entry,node_windows_flutter_window,node_windows_base_window,node_windows_window_header,node_linux_entry,node_linux_application,node_ios_delegate,node_macos_registrant,node_linux_plugin_api,node_windows_plugin_api toneRose
```

## Components

### Authentication UI

- [Flutter app](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/main.dart): `lib/main.dart`
- [Login view](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/login_view.dart): `lib/features/auth/views/login_view.dart`
- [Registration view](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/register_view.dart): `lib/features/auth/views/register_view.dart`

### Authentication State

- [Auth BLoC](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/bloc/auth_bloc.dart): `lib/features/auth/bloc/auth_bloc.dart`
- [Auth events](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/bloc/auth_event.dart): `lib/features/auth/bloc/auth_event.dart`
- [Auth states](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/bloc/auth_state.dart): `lib/features/auth/bloc/auth_state.dart`
- [API constants](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/core/constants/api_constants.dart): `lib/core/constants/api_constants.dart`

### Role Dashboards

- [Dashboard view](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/dashboard_view.dart): `lib/features/auth/views/dashboard_view.dart`
- [Citizen dashboard](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/dashboards/citizen_dashboard_view.dart): `lib/features/auth/views/dashboards/citizen_dashboard_view.dart`
- [Barangay dashboard](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/dashboards/barangay_dashboard_view.dart): `lib/features/auth/views/dashboards/barangay_dashboard_view.dart`
- [Municipal dashboard](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/dashboards/municipal_dashboard_view.dart): `lib/features/auth/views/dashboards/municipal_dashboard_view.dart`
- [Provincial dashboard](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/lib/features/auth/views/dashboards/provincial_dashboard_view.dart): `lib/features/auth/views/dashboards/provincial_dashboard_view.dart`

### Platform Hosts

- [Windows entry](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Windows Flutter host](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/windows/runner/flutter_window.h): `windows/runner/flutter_window.h`
- [Windows window](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/windows/runner/win32_window.cpp): `windows/runner/win32_window.cpp`
- [Windows window API](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/windows/runner/win32_window.h): `windows/runner/win32_window.h`
- [Linux entry](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/linux/runner/main.cc): `linux/runner/main.cc`
- [Linux application](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/linux/runner/my_application.h): `linux/runner/my_application.h`
- [iOS app delegate](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/ios/Runner/AppDelegate.swift): `ios/Runner/AppDelegate.swift`
- [macOS plugin registry](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift): `macos/Flutter/GeneratedPluginRegistrant.swift`
- [Linux plugin API](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/linux/flutter/generated_plugin_registrant.h): `linux/flutter/generated_plugin_registrant.h`
- [Windows plugin API](https://github.com/nas010122/final_citizen_service_request_system_frontend/blob/main/windows/flutter/generated_plugin_registrant.h): `windows/flutter/generated_plugin_registrant.h`

### Other components

- **App user**

## Connections

- Windows entry → Windows Flutter host: creates host (evidence: `windows/runner/main.cpp`)
- Windows Flutter host → Windows window: inherits from (evidence: `windows/runner/flutter_window.h`)
- Linux entry → Linux application: creates application (evidence: `linux/runner/main.cc`)