# morpheussss31/hackathon-finaldraft architecture

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

- Interactive diagram: https://gitdiagram.com/morpheussss31/hackathon-finaldraft
- Repository: https://github.com/morpheussss31/hackathon-finaldraft

## Overview

This is a cross-platform Flutter concern-management app, apparently supporting student submissions, administrator review, discussion, audit history, reporting, bulk uploads, notifications, a public knowledge base, and AI chat. Its likely user journey runs from sign-in through concern submission and administrative handling, with comments and audit history supporting follow-up. The tree identifies screens, services, and domain models, but the README is empty and no Dart implementation was sampled, so service wiring and Firebase data flows are left unspecified.

Main entry points: [`my_app/lib/screens/login_screen.dart`](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/login_screen.dart) (Sign in), [`my_app/lib/main.dart`](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/main.dart) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App entry"]
  node_main["App entry<br/>[main.dart]"]
end

subgraph group_user["User workflows"]
  node_login["Sign in<br/>[login_screen.dart]"]
  node_student["Student dashboard"]
  node_form["Submit concern<br/>[student_form.dart]"]
  node_detail["Concern detail"]
  node_profile["User profile"]
  node_knowledge["Knowledge base"]
  node_chat["AI chat"]
end

subgraph group_admin["Administration"]
  node_admin_dash["Admin dashboard"]
  node_admin_list["Concern review"]
  node_audit_view["Audit history"]
end

subgraph group_services["Application services"]
  node_auth["Authentication<br/>[auth_service.dart]"]
  node_users["User service<br/>[user_service.dart]"]
  node_concerns["Concern service"]
  node_reports["Reporting"]
  node_bulk["Bulk upload"]
  node_notify["Notifications"]
  node_storage["File storage"]
  node_ai["AI service<br/>[ai_service.dart]"]
  node_providers["Service providers<br/>[providers.dart]"]
end

subgraph group_domain["Domain models"]
  node_user_model["App user<br/>[app_user.dart]"]
  node_concern_model["Concern<br/>[concern.dart]"]
  node_comment_model["Comment<br/>[comment.dart]"]
  node_audit_model["Audit trail<br/>[audit_trail.dart]"]
end

node_firebase[("Firebase services")]
node_user_actor(("App user"))
node_admin_actor(("Administrator"))

node_user_actor -->|"uses"| node_login
node_admin_actor -->|"uses"| node_login
node_main --> node_login

click node_main "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/main.dart"
click node_login "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/login_screen.dart"
click node_student "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/student_dashboard.dart"
click node_form "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/student_form.dart"
click node_detail "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/concern_detail_screen.dart"
click node_profile "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/profile_screen.dart"
click node_knowledge "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/public_knowledge_base_screen.dart"
click node_chat "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/ai_chat_screen.dart"
click node_admin_dash "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/admin_dashboard.dart"
click node_admin_list "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/admin_concern_list.dart"
click node_audit_view "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/audit_trail_view.dart"
click node_auth "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/auth_service.dart"
click node_users "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/user_service.dart"
click node_concerns "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/concern_service.dart"
click node_reports "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/report_service.dart"
click node_bulk "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/bulk_upload_service.dart"
click node_notify "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/notification_service.dart"
click node_storage "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/storage_service.dart"
click node_ai "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/ai_service.dart"
click node_providers "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/providers.dart"
click node_user_model "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/models/app_user.dart"
click node_concern_model "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/models/concern.dart"
click node_comment_model "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/models/comment.dart"
click node_audit_model "https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/models/audit_trail.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_main,node_user_actor toneBlue
class node_login,node_student,node_form,node_detail,node_profile,node_knowledge,node_chat,node_firebase toneAmber
class node_admin_dash,node_admin_list,node_audit_view toneMint
class node_auth,node_users,node_concerns,node_reports,node_bulk,node_notify,node_storage,node_ai,node_providers toneRose
class node_user_model,node_concern_model,node_comment_model,node_audit_model,node_admin_actor toneIndigo
```

## Components

### App entry

- [App entry](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/main.dart): `my_app/lib/main.dart`

### User workflows

- [Sign in](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/login_screen.dart): `my_app/lib/screens/login_screen.dart`
- [Student dashboard](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/student_dashboard.dart): `my_app/lib/screens/student_dashboard.dart`
- [Submit concern](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/student_form.dart): `my_app/lib/screens/student_form.dart`
- [Concern detail](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/concern_detail_screen.dart): `my_app/lib/screens/concern_detail_screen.dart`
- [User profile](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/profile_screen.dart): `my_app/lib/screens/profile_screen.dart`
- [Knowledge base](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/public_knowledge_base_screen.dart): `my_app/lib/screens/public_knowledge_base_screen.dart`
- [AI chat](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/ai_chat_screen.dart): `my_app/lib/screens/ai_chat_screen.dart`

### Administration

- [Admin dashboard](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/admin_dashboard.dart): `my_app/lib/screens/admin_dashboard.dart`
- [Concern review](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/admin_concern_list.dart): `my_app/lib/screens/admin_concern_list.dart`
- [Audit history](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/screens/audit_trail_view.dart): `my_app/lib/screens/audit_trail_view.dart`

### Application services

- [Authentication](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/auth_service.dart): `my_app/lib/services/auth_service.dart`
- [User service](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/user_service.dart): `my_app/lib/services/user_service.dart`
- [Concern service](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/concern_service.dart): `my_app/lib/services/concern_service.dart`
- [Reporting](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/report_service.dart): `my_app/lib/services/report_service.dart`
- [Bulk upload](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/bulk_upload_service.dart): `my_app/lib/services/bulk_upload_service.dart`
- [Notifications](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/notification_service.dart): `my_app/lib/services/notification_service.dart`
- [File storage](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/storage_service.dart): `my_app/lib/services/storage_service.dart`
- [AI service](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/ai_service.dart): `my_app/lib/services/ai_service.dart`
- [Service providers](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/services/providers.dart): `my_app/lib/services/providers.dart`

### Domain models

- [App user](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/models/app_user.dart): `my_app/lib/models/app_user.dart`
- [Concern](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/models/concern.dart): `my_app/lib/models/concern.dart`
- [Comment](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/models/comment.dart): `my_app/lib/models/comment.dart`
- [Audit trail](https://github.com/morpheussss31/hackathon-finaldraft/blob/main/my_app/lib/models/audit_trail.dart): `my_app/lib/models/audit_trail.dart`

### Other components

- **Firebase services**
- **App user**
- **Administrator**

## Connections

- App user → Sign in: uses
- Administrator → Sign in: uses
- App entry → Sign in