How kaisinux/quran-teacher-application works
É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: teacher_shell.dart Teacher shell · app_router.dart App router · sessions_screen.dart Sessions · grade_entry_screen.dart Grade entry
Components 23
App shell
- App entry
app/lib/main.dart - App router
app/lib/core/router/app_router.dart - Teacher shell
app/lib/features/dashboard/presentation/teacher_shell.dart - Home dashboard
app/lib/features/dashboard/presentation/home_screen.dart - Settings
app/lib/features/settings/presentation/settings_screen.dart
Teaching workflow
- Sessions
app/lib/features/sessions/presentation/sessions_screen.dart - Session overview
app/lib/features/sessions/presentation/session_overview.dart - Session data
app/lib/features/sessions/data/sessions_repository.dart - Grade entry
app/lib/features/grades/presentation/grade_entry_screen.dart - Grade review
app/lib/features/grades/presentation/review_screen.dart - Grade validation
app/lib/features/grades/domain/grade_validator.dart - Grade data
app/lib/features/grades/data/grades_repository.dart
Identity and administration
- Login screen
app/lib/features/auth/presentation/login_screen.dart - Authentication
app/lib/core/auth/auth_controller.dart - Admin dashboard
app/lib/features/admin/presentation/admin_dashboard_screen.dart - Admin data
app/lib/features/admin/data/admin_repository.dart
Offline and sync
- Local database
app/lib/core/database/app_database.dart - Sync service
app/lib/core/sync/sync_service.dart - Sync screen
app/lib/features/sync/presentation/sync_screen.dart - API client
app/lib/core/api/api_client.dart
Other components
- Teacher
- Apps Script API
- Google Sheets
Connections 23
- 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
README.md - Apps Script API → Google Sheets: updates
README.md