# nuengone77/projectmobileapp architecture

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

- Interactive diagram: https://gitdiagram.com/nuengone77/projectmobileapp
- Repository: https://github.com/nuengone77/projectmobileapp

## Overview

Kaiwan Chuaiduai is a Flutter counseling prototype with local SQLite storage and no server. Students register with consent, then request general or urgent counseling through chat or book an onsite appointment; staff manage conversations, appointments, summaries, and case reports. The README documents the feature boundaries and provider dependencies, but the Dart sources were not sampled, so edges below are limited to documented relationships.

Main entry points: [`lib/providers/auth_provider.dart`](https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/auth_provider.dart) (Auth state), [`lib/providers/chat_provider.dart`](https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/chat_provider.dart) (Chat state), [`lib/providers/report_provider.dart`](https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/report_provider.dart) (Report state), [`lib/providers/appointment_provider.dart`](https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/appointment_provider.dart) (Appointment state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_app_entry["App entry<br/>[main.dart]"]
  node_provider_setup["Provider setup<br/>[app_providers.dart]"]
  node_student_screens["Student screens"]
  node_staff_screens["Staff screens<br/>[staff_screens.dart]"]
end

subgraph group_identity["Identity and data"]
  node_auth_screens["Auth screens<br/>[auth_screens.dart]"]
  node_auth_provider["Auth state<br/>[auth_provider.dart]"]
  node_registration_rules["Registration rules"]
  node_password_hashing["Password hashing<br/>[passwords.dart]"]
  node_app_data["Seed and constants<br/>[app_data.dart]"]
  node_local_database[("SQLite database<br/>[app_database.dart]")]
end

subgraph group_chat["Counseling chat"]
  node_chat_screens["Chat screens<br/>[chat_screen.dart]"]
  node_chat_views["Chat views"]
  node_chat_provider["Chat state<br/>[chat_provider.dart]"]
  node_attachments["Attachments<br/>[attachments.dart]"]
end

subgraph group_appointments["Appointments"]
  node_booking_screen["Booking screen"]
  node_student_appointments["Student appointments"]
  node_staff_appointments["Staff appointments"]
  node_appointment_provider["Appointment state"]
end

subgraph group_reports["Case reporting"]
  node_report_screen["Report screen<br/>[report_screen.dart]"]
  node_report_provider["Report state"]
  node_report_export["Report export<br/>[report_export.dart]"]
end

node_student(("Student"))
node_staff(("Staff"))

node_student -->|"registers"| node_auth_screens
node_auth_screens -->|"submits auth"| node_auth_provider
node_auth_provider -->|"validates signup"| node_registration_rules
node_auth_provider -->|"hashes passwords"| node_password_hashing
node_auth_provider -->|"stores accounts"| node_local_database
node_provider_setup -->|"provides"| node_auth_provider
node_provider_setup -->|"provides"| node_chat_provider
node_provider_setup -->|"provides"| node_appointment_provider
node_provider_setup -->|"provides"| node_report_provider
node_chat_provider -->|"depends on"| node_auth_provider
node_appointment_provider -->|"depends on"| node_auth_provider
node_report_provider -->|"depends on"| node_auth_provider
node_chat_provider -->|"depends on"| node_report_provider
node_student -->|"chooses counseling"| node_student_screens
node_student_screens -->|"opens chat"| node_chat_screens
node_student_screens -->|"starts booking"| node_booking_screen
node_chat_screens -->|"reads and sends"| node_chat_provider
node_chat_screens -->|"renders messages"| node_chat_views
node_chat_provider -->|"persists chat"| node_local_database
node_chat_provider -->|"handles files"| node_attachments
node_staff -->|"manages cases"| node_staff_screens
node_booking_screen -->|"requests booking"| node_appointment_provider
node_student_appointments -->|"views status"| node_appointment_provider
node_staff_appointments -->|"confirms or proposes"| node_appointment_provider
node_appointment_provider -->|"persists appointments"| node_local_database
node_staff_screens -->|"opens case report"| node_report_screen
node_report_screen -->|"filters cases"| node_report_provider
node_report_provider -->|"reads and saves"| node_local_database
node_report_provider -->|"exports CSV PDF"| node_report_export

click node_app_entry "https://github.com/nuengone77/projectmobileapp/blob/main/lib/main.dart"
click node_provider_setup "https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/app_providers.dart"
click node_student_screens "https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/student_screens.dart"
click node_staff_screens "https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/staff_screens.dart"
click node_auth_screens "https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/auth_screens.dart"
click node_auth_provider "https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/auth_provider.dart"
click node_registration_rules "https://github.com/nuengone77/projectmobileapp/blob/main/lib/data/registration_rules.dart"
click node_password_hashing "https://github.com/nuengone77/projectmobileapp/blob/main/lib/data/passwords.dart"
click node_app_data "https://github.com/nuengone77/projectmobileapp/blob/main/lib/data/app_data.dart"
click node_local_database "https://github.com/nuengone77/projectmobileapp/blob/main/lib/data/app_database.dart"
click node_chat_screens "https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/chat/chat_screen.dart"
click node_chat_views "https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/chat/message_bubble.dart"
click node_chat_provider "https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/chat_provider.dart"
click node_attachments "https://github.com/nuengone77/projectmobileapp/blob/main/lib/data/attachments.dart"
click node_booking_screen "https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/appointment/booking_screen.dart"
click node_student_appointments "https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/appointment/my_appointments.dart"
click node_staff_appointments "https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/appointment/staff_appointments.dart"
click node_appointment_provider "https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/appointment_provider.dart"
click node_report_screen "https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/report_screen.dart"
click node_report_provider "https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/report_provider.dart"
click node_report_export "https://github.com/nuengone77/projectmobileapp/blob/main/lib/data/report_export.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_provider_setup,node_student_screens,node_staff_screens toneBlue
class node_auth_screens,node_auth_provider,node_registration_rules,node_password_hashing,node_app_data,node_local_database toneAmber
class node_chat_screens,node_chat_views,node_chat_provider,node_attachments toneMint
class node_booking_screen,node_student_appointments,node_staff_appointments,node_appointment_provider toneRose
class node_report_screen,node_report_provider,node_report_export,node_student,node_staff toneIndigo
```

## Components

### App and navigation

- [App entry](https://github.com/nuengone77/projectmobileapp/blob/main/lib/main.dart): `lib/main.dart`
- [Provider setup](https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/app_providers.dart): `lib/providers/app_providers.dart`
- [Student screens](https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/student_screens.dart): `lib/screens/student_screens.dart`
- [Staff screens](https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/staff_screens.dart): `lib/screens/staff_screens.dart`

### Identity and data

- [Auth screens](https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/auth_screens.dart): `lib/screens/auth_screens.dart`
- [Auth state](https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/auth_provider.dart): `lib/providers/auth_provider.dart`
- [Registration rules](https://github.com/nuengone77/projectmobileapp/blob/main/lib/data/registration_rules.dart): `lib/data/registration_rules.dart`
- [Password hashing](https://github.com/nuengone77/projectmobileapp/blob/main/lib/data/passwords.dart): `lib/data/passwords.dart`
- [Seed and constants](https://github.com/nuengone77/projectmobileapp/blob/main/lib/data/app_data.dart): `lib/data/app_data.dart`
- [SQLite database](https://github.com/nuengone77/projectmobileapp/blob/main/lib/data/app_database.dart): `lib/data/app_database.dart`

### Counseling chat

- [Chat screens](https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/chat/chat_screen.dart): `lib/screens/chat/chat_screen.dart`
- [Chat views](https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/chat/message_bubble.dart): `lib/screens/chat/message_bubble.dart`
- [Chat state](https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/chat_provider.dart): `lib/providers/chat_provider.dart`
- [Attachments](https://github.com/nuengone77/projectmobileapp/blob/main/lib/data/attachments.dart): `lib/data/attachments.dart`

### Appointments

- [Booking screen](https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/appointment/booking_screen.dart): `lib/screens/appointment/booking_screen.dart`
- [Student appointments](https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/appointment/my_appointments.dart): `lib/screens/appointment/my_appointments.dart`
- [Staff appointments](https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/appointment/staff_appointments.dart): `lib/screens/appointment/staff_appointments.dart`
- [Appointment state](https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/appointment_provider.dart): `lib/providers/appointment_provider.dart`

### Case reporting

- [Report screen](https://github.com/nuengone77/projectmobileapp/blob/main/lib/screens/report_screen.dart): `lib/screens/report_screen.dart`
- [Report state](https://github.com/nuengone77/projectmobileapp/blob/main/lib/providers/report_provider.dart): `lib/providers/report_provider.dart`
- [Report export](https://github.com/nuengone77/projectmobileapp/blob/main/lib/data/report_export.dart): `lib/data/report_export.dart`

### Other components

- **Student**
- **Staff**

## Connections

- Student → Auth screens: registers (evidence: `README.md`)
- Auth screens → Auth state: submits auth (evidence: `README.md`)
- Auth state → Registration rules: validates signup (evidence: `README.md`)
- Auth state → Password hashing: hashes passwords (evidence: `README.md`)
- Auth state → SQLite database: stores accounts (evidence: `README.md`)
- Provider setup → Auth state: provides (evidence: `README.md`)
- Provider setup → Chat state: provides (evidence: `README.md`)
- Provider setup → Appointment state: provides (evidence: `README.md`)
- Provider setup → Report state: provides (evidence: `README.md`)
- Chat state → Auth state: depends on (evidence: `README.md`)
- Appointment state → Auth state: depends on (evidence: `README.md`)
- Report state → Auth state: depends on (evidence: `README.md`)
- Chat state → Report state: depends on (evidence: `README.md`)
- Student → Student screens: chooses counseling (evidence: `README.md`)
- Student screens → Chat screens: opens chat (evidence: `README.md`)
- Student screens → Booking screen: starts booking (evidence: `README.md`)
- Chat screens → Chat state: reads and sends (evidence: `README.md`)
- Chat screens → Chat views: renders messages (evidence: `README.md`)
- Chat state → SQLite database: persists chat (evidence: `README.md`)
- Chat state → Attachments: handles files (evidence: `README.md`)
- Staff → Staff screens: manages cases (evidence: `README.md`)
- Booking screen → Appointment state: requests booking (evidence: `README.md`)
- Student appointments → Appointment state: views status (evidence: `README.md`)
- Staff appointments → Appointment state: confirms or proposes (evidence: `README.md`)
- Appointment state → SQLite database: persists appointments (evidence: `README.md`)
- Staff screens → Report screen: opens case report (evidence: `README.md`)
- Report screen → Report state: filters cases (evidence: `README.md`)
- Report state → SQLite database: reads and saves (evidence: `README.md`)
- Report state → Report export: exports CSV PDF (evidence: `README.md`)
