# kaisinux/quran-teacher-application architecture

> Architecture diagram of the GitHub repository kaisinux/quran-teacher-application, 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/kaisinux/quran-teacher-application
- Repository: https://github.com/kaisinux/quran-teacher-application

## Overview

École Misk is an offline-first Flutter app for teachers to enter grades, with synchronization to existing Google Sheets through a Google Apps Script API. The tree shows distinct authentication, session, grading, administration, settings, and sync areas. Dart sources were not included in the excerpts, so internal calls and data flow are unverified; dashed links indicate the likely workflow, while the sync destination is documented in the README.

Main entry points: [`app/lib/features/dashboard/presentation/teacher_shell.dart`](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/dashboard/presentation/teacher_shell.dart) (Teacher shell), [`app/lib/core/router/app_router.dart`](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/core/router/app_router.dart) (App router), [`app/lib/features/sessions/presentation/sessions_screen.dart`](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/sessions/presentation/sessions_screen.dart) (Sessions), [`app/lib/features/grades/presentation/grade_entry_screen.dart`](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/grades/presentation/grade_entry_screen.dart) (Grade entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_main["App entry<br/>[main.dart]"]
  node_router["App router<br/>[app_router.dart]"]
  node_teacher_shell["Teacher shell<br/>[teacher_shell.dart]"]
  node_home["Home dashboard<br/>[home_screen.dart]"]
  node_settings["Settings"]
end

subgraph group_teaching["Teaching workflow"]
  node_sessions["Sessions"]
  node_session_overview["Session overview"]
  node_session_repo["Session data"]
  node_grade_entry["Grade entry"]
  node_grade_review["Grade review<br/>[review_screen.dart]"]
  node_grade_validation["Grade validation"]
  node_grades_repo["Grade data"]
end

subgraph group_identity["Identity and administration"]
  node_login["Login screen<br/>[login_screen.dart]"]
  node_auth["Authentication"]
  node_admin["Admin dashboard"]
  node_admin_repo["Admin data"]
end

subgraph group_platform["Offline and sync"]
  node_local_db[("Local database<br/>[app_database.dart]")]
  node_sync_service["Sync service<br/>[sync_service.dart]"]
  node_sync_screen["Sync screen<br/>[sync_screen.dart]"]
  node_api_client["API client<br/>[api_client.dart]"]
end

node_teacher(("Teacher"))
node_apps_script{{"Apps Script API"}}
node_sheets[("Google Sheets")]

node_teacher -.->|"opens"| node_main
node_main -.->|"starts"| node_router
node_router -.->|"routes to"| node_login
node_router -.->|"routes to"| node_teacher_shell
node_teacher_shell -.->|"shows"| node_home
node_login -.->|"uses"| node_auth
node_teacher_shell -.->|"opens"| node_sessions
node_sessions -.->|"shows"| node_session_overview
node_sessions -.->|"loads"| node_session_repo
node_session_overview -.->|"opens"| node_grade_entry
node_grade_entry -.->|"validates"| node_grade_validation
node_grade_entry -.->|"saves"| node_grades_repo
node_teacher_shell -.->|"opens"| node_admin
node_admin -.->|"uses"| node_admin_repo
node_teacher_shell -.->|"opens"| node_settings
node_grades_repo -.->|"persists"| node_local_db
node_session_repo -.->|"persists"| node_local_db
node_teacher_shell -.->|"opens"| node_sync_screen
node_sync_screen -.->|"uses"| node_sync_service
node_sync_service -.->|"synchronizes"| node_local_db
node_sync_service -.->|"uses"| node_api_client
node_api_client -.->|"sends data"| node_apps_script
node_apps_script -.->|"updates"| node_sheets

click node_main "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/main.dart"
click node_router "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/core/router/app_router.dart"
click node_teacher_shell "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/dashboard/presentation/teacher_shell.dart"
click node_home "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/dashboard/presentation/home_screen.dart"
click node_login "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/auth/presentation/login_screen.dart"
click node_auth "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/core/auth/auth_controller.dart"
click node_sessions "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/sessions/presentation/sessions_screen.dart"
click node_session_overview "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/sessions/presentation/session_overview.dart"
click node_session_repo "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/sessions/data/sessions_repository.dart"
click node_grade_entry "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/grades/presentation/grade_entry_screen.dart"
click node_grade_review "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/grades/presentation/review_screen.dart"
click node_grade_validation "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/grades/domain/grade_validator.dart"
click node_grades_repo "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/grades/data/grades_repository.dart"
click node_admin "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/admin/presentation/admin_dashboard_screen.dart"
click node_admin_repo "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/admin/data/admin_repository.dart"
click node_settings "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/settings/presentation/settings_screen.dart"
click node_local_db "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/core/database/app_database.dart"
click node_sync_service "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/core/sync/sync_service.dart"
click node_sync_screen "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/sync/presentation/sync_screen.dart"
click node_api_client "https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/core/api/api_client.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_router,node_teacher_shell,node_home,node_settings toneBlue
class node_sessions,node_session_overview,node_session_repo,node_grade_entry,node_grade_review,node_grade_validation,node_grades_repo,node_sheets toneAmber
class node_login,node_auth,node_admin,node_admin_repo,node_apps_script toneMint
class node_local_db,node_sync_service,node_sync_screen,node_api_client toneRose
class node_teacher toneIndigo
```

## Components

### App shell

- [App entry](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/main.dart): `app/lib/main.dart`
- [App router](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/core/router/app_router.dart): `app/lib/core/router/app_router.dart`
- [Teacher shell](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/dashboard/presentation/teacher_shell.dart): `app/lib/features/dashboard/presentation/teacher_shell.dart`
- [Home dashboard](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/dashboard/presentation/home_screen.dart): `app/lib/features/dashboard/presentation/home_screen.dart`
- [Settings](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/settings/presentation/settings_screen.dart): `app/lib/features/settings/presentation/settings_screen.dart`

### Teaching workflow

- [Sessions](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/sessions/presentation/sessions_screen.dart): `app/lib/features/sessions/presentation/sessions_screen.dart`
- [Session overview](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/sessions/presentation/session_overview.dart): `app/lib/features/sessions/presentation/session_overview.dart`
- [Session data](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/sessions/data/sessions_repository.dart): `app/lib/features/sessions/data/sessions_repository.dart`
- [Grade entry](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/grades/presentation/grade_entry_screen.dart): `app/lib/features/grades/presentation/grade_entry_screen.dart`
- [Grade review](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/grades/presentation/review_screen.dart): `app/lib/features/grades/presentation/review_screen.dart`
- [Grade validation](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/grades/domain/grade_validator.dart): `app/lib/features/grades/domain/grade_validator.dart`
- [Grade data](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/grades/data/grades_repository.dart): `app/lib/features/grades/data/grades_repository.dart`

### Identity and administration

- [Login screen](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/auth/presentation/login_screen.dart): `app/lib/features/auth/presentation/login_screen.dart`
- [Authentication](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/core/auth/auth_controller.dart): `app/lib/core/auth/auth_controller.dart`
- [Admin dashboard](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/admin/presentation/admin_dashboard_screen.dart): `app/lib/features/admin/presentation/admin_dashboard_screen.dart`
- [Admin data](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/admin/data/admin_repository.dart): `app/lib/features/admin/data/admin_repository.dart`

### Offline and sync

- [Local database](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/core/database/app_database.dart): `app/lib/core/database/app_database.dart`
- [Sync service](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/core/sync/sync_service.dart): `app/lib/core/sync/sync_service.dart`
- [Sync screen](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/features/sync/presentation/sync_screen.dart): `app/lib/features/sync/presentation/sync_screen.dart`
- [API client](https://github.com/kaisinux/quran-teacher-application/blob/claude/flutter-ecole-misk-app-1uq761/app/lib/core/api/api_client.dart): `app/lib/core/api/api_client.dart`

### Other components

- **Teacher**
- **Apps Script API**
- **Google Sheets**

## Connections

- Teacher → App entry: opens
- App entry → App router: starts
- App router → Login screen: routes to
- App router → Teacher shell: routes to
- Teacher shell → Home dashboard: shows
- Login screen → Authentication: uses
- Teacher shell → Sessions: opens
- Sessions → Session overview: shows
- Sessions → Session data: loads
- Session overview → Grade entry: opens
- Grade entry → Grade validation: validates
- Grade entry → Grade data: saves
- Teacher shell → Admin dashboard: opens
- Admin dashboard → Admin data: uses
- Teacher shell → Settings: opens
- Grade data → Local database: persists
- Session data → Local database: persists
- Teacher shell → Sync screen: opens
- Sync screen → Sync service: uses
- Sync service → Local database: synchronizes
- Sync service → API client: uses
- API client → Apps Script API: sends data (evidence: `README.md`)
- Apps Script API → Google Sheets: updates (evidence: `README.md`)
