# htetagwin/macs-attendance-app architecture

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

- Interactive diagram: https://gitdiagram.com/htetagwin/macs-attendance-app
- Repository: https://github.com/htetagwin/macs-attendance-app

## Overview

This is a Flutter attendance application with screens for authentication, student attendance, administration, seminars, announcements, feedback, and user management. The likely user journey is sign-in, role-appropriate navigation, then attendance or administrative work backed by Firebase. The README provides no product-specific workflow, and the sampled source covers native platform scaffolding rather than Dart runtime code; dashed edges mark inferred relationships, not verified calls.

Main entry points: [`lib/screens/admin_dashboard.dart`](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/admin_dashboard.dart) (Admin dashboard), [`lib/services/auth_service.dart`](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/services/auth_service.dart) (Auth service), [`lib/services/database_service.dart`](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/services/database_service.dart) (Database service), [`lib/screens/wrapper.dart`](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/wrapper.dart) (Auth gate)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Flow"]
  node_entry["App entry<br/>[main.dart]"]
  node_auth_gate["Auth gate<br/>[wrapper.dart]"]
  node_auth_screens["Authentication screens<br/>[authenticate.dart]"]
  node_sign_in["Sign in<br/>[sign_in.dart]"]
  node_registration["Registration<br/>[register.dart]"]
  node_home["Home navigation<br/>[home.dart]"]
end

subgraph group_attendance["Attendance"]
  node_student_attendance["Student attendance"]
  node_attendance_model["Attendance model"]
end

subgraph group_admin["Administration"]
  node_admin_dashboard["Admin dashboard"]
  node_admin_attendance["Attendance dashboard"]
  node_seminars["Seminar screens"]
  node_seminar_detail["Seminar details"]
  node_announcements["Announcements"]
  node_feedback["Feedback summary"]
  node_user_management["User management"]
end

subgraph group_services["Data and Identity"]
  node_auth_service["Auth service<br/>[auth_service.dart]"]
  node_user_model["User model<br/>[user_model.dart]"]
  node_database_service["Database service"]
  node_firebase_auth["Firebase Auth"]
  node_firestore[("Cloud Firestore")]
end

node_user(("App user"))

node_user -.->|"opens"| node_entry
node_entry -.->|"starts"| node_auth_gate
node_auth_gate -.->|"routes unauthenticated"| node_auth_screens
node_auth_screens -.->|"offers sign-in"| node_sign_in
node_auth_screens -.->|"offers registration"| node_registration
node_sign_in -.->|"uses"| node_auth_service
node_registration -.->|"uses"| node_auth_service
node_auth_service -.->|"authenticates"| node_firebase_auth
node_auth_gate -.->|"routes signed-in"| node_home
node_home -.->|"opens attendance"| node_student_attendance
node_student_attendance -.->|"loads attendance"| node_database_service
node_student_attendance -.->|"uses model"| node_attendance_model
node_home -.->|"opens admin"| node_admin_dashboard
node_admin_dashboard -.->|"opens reports"| node_admin_attendance
node_admin_dashboard -.->|"manages seminars"| node_seminars
node_admin_dashboard -.->|"manages announcements"| node_announcements
node_admin_dashboard -.->|"opens summary"| node_feedback
node_admin_dashboard -.->|"manages users"| node_user_management
node_seminars -.->|"opens details"| node_seminar_detail
node_admin_attendance -.->|"loads records"| node_database_service
node_user_management -.->|"updates users"| node_database_service
node_database_service -.->|"reads and writes"| node_firestore
node_auth_service -.->|"uses model"| node_user_model

click node_entry "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/main.dart"
click node_auth_gate "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/wrapper.dart"
click node_auth_screens "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/authenticate/authenticate.dart"
click node_sign_in "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/authenticate/sign_in.dart"
click node_registration "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/authenticate/register.dart"
click node_auth_service "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/services/auth_service.dart"
click node_user_model "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/models/user_model.dart"
click node_home "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/home.dart"
click node_student_attendance "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/student_attendance_page.dart"
click node_attendance_model "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/models/attendance_model.dart"
click node_admin_dashboard "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/admin_dashboard.dart"
click node_admin_attendance "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/admin_attendance_dashboard.dart"
click node_seminars "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/add_seminar_page.dart"
click node_seminar_detail "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/seminar_detail_page.dart"
click node_announcements "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/add_announcement_page.dart"
click node_feedback "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/feedback_summary_page.dart"
click node_user_management "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/manage_users_page.dart"
click node_database_service "https://github.com/htetagwin/macs-attendance-app/blob/main/lib/services/database_service.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_entry,node_auth_gate,node_auth_screens,node_sign_in,node_registration,node_home,node_user toneBlue
class node_student_attendance,node_attendance_model toneAmber
class node_admin_dashboard,node_admin_attendance,node_seminars,node_seminar_detail,node_announcements,node_feedback,node_user_management toneMint
class node_auth_service,node_user_model,node_database_service,node_firebase_auth,node_firestore toneRose
```

## Components

### Application Flow

- [App entry](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/main.dart): `lib/main.dart`
- [Auth gate](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/wrapper.dart): `lib/screens/wrapper.dart`
- [Authentication screens](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/authenticate/authenticate.dart): `lib/screens/authenticate/authenticate.dart`
- [Sign in](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/authenticate/sign_in.dart): `lib/screens/authenticate/sign_in.dart`
- [Registration](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/authenticate/register.dart): `lib/screens/authenticate/register.dart`
- [Home navigation](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/home.dart): `lib/screens/home.dart`

### Attendance

- [Student attendance](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/student_attendance_page.dart): `lib/screens/student_attendance_page.dart`
- [Attendance model](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/models/attendance_model.dart): `lib/models/attendance_model.dart`

### Administration

- [Admin dashboard](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/admin_dashboard.dart): `lib/screens/admin_dashboard.dart`
- [Attendance dashboard](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/admin_attendance_dashboard.dart): `lib/screens/admin_attendance_dashboard.dart`
- [Seminar screens](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/add_seminar_page.dart): `lib/screens/add_seminar_page.dart`
- [Seminar details](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/seminar_detail_page.dart): `lib/screens/seminar_detail_page.dart`
- [Announcements](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/add_announcement_page.dart): `lib/screens/add_announcement_page.dart`
- [Feedback summary](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/feedback_summary_page.dart): `lib/screens/feedback_summary_page.dart`
- [User management](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/screens/manage_users_page.dart): `lib/screens/manage_users_page.dart`

### Data and Identity

- [Auth service](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/services/auth_service.dart): `lib/services/auth_service.dart`
- [User model](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/models/user_model.dart): `lib/models/user_model.dart`
- [Database service](https://github.com/htetagwin/macs-attendance-app/blob/main/lib/services/database_service.dart): `lib/services/database_service.dart`
- **Firebase Auth**
- **Cloud Firestore**

### Other components

- **App user**

## Connections

- App user → App entry: opens
- App entry → Auth gate: starts
- Auth gate → Authentication screens: routes unauthenticated
- Authentication screens → Sign in: offers sign-in
- Authentication screens → Registration: offers registration
- Sign in → Auth service: uses
- Registration → Auth service: uses
- Auth service → Firebase Auth: authenticates
- Auth gate → Home navigation: routes signed-in
- Home navigation → Student attendance: opens attendance
- Student attendance → Database service: loads attendance
- Student attendance → Attendance model: uses model
- Home navigation → Admin dashboard: opens admin
- Admin dashboard → Attendance dashboard: opens reports
- Admin dashboard → Seminar screens: manages seminars
- Admin dashboard → Announcements: manages announcements
- Admin dashboard → Feedback summary: opens summary
- Admin dashboard → User management: manages users
- Seminar screens → Seminar details: opens details
- Attendance dashboard → Database service: loads records
- User management → Database service: updates users
- Database service → Cloud Firestore: reads and writes
- Auth service → User model: uses model
