How tedmkr/journal-mobile works
This is an Android academic journal app for administrators, teachers, methodists, and students. Users authenticate, enter role-specific navigation, and perform journal, learning, or administration tasks; feature modules access the backend through repositories and JournalApi, with Room-backed session/cache and queued journal edits supporting offline use. The tree documents broad role capabilities, but most feature implementations and repository wiring were not sampled, so their internal calls are omitted. The notification and sync worker relationships shown below are supported by excerpts.
Main entry points: JournalNavHost.kt Role navigation · MainActivity.kt Android entry · AuthViewModel.kt Auth flow · SyncWorker.kt Pending edit sync
Components 24
App shell
- Android entry
app/src/main/java/com/journal/app/MainActivity.kt - Role navigation
app/src/main/java/com/journal/app/navigation/JournalNavHost.kt
Identity
- Sign-in UI
features/auth/src/main/java/com/journal/features/auth/AuthRoute.kt - Auth flow
features/auth/src/main/java/com/journal/features/auth/AuthViewModel.kt - Token exchange
core/data/src/main/java/com/journal/core/data/repository/AuthRepository.kt - Session state
core/data/src/main/java/com/journal/core/data/repository/SessionRepository.kt - Token state
core/common/src/main/java/com/journal/core/common/config/TokenSession.kt
Role features
- Admin tools
features/admin - Teacher journals
features/teacher - Methodist planning
features/methodist - Student portal
features/student
Data services
- Domain repositories
core/data/src/main/java/com/journal/core/data/repository - Journal API
core/network/src/main/java/com/journal/core/network/api/JournalApi.kt - Pending edit sync
core/data/src/main/java/com/journal/core/data/sync/SyncWorker.kt - Grade notifications
core/data/src/main/java/com/journal/core/data/notification/StudentGradeNotificationWorker.kt
Local storage
- Room database
core/database/src/main/java/com/journal/core/database/JournalDatabase.kt - Pending actions
core/database/src/main/java/com/journal/core/database/dao/PendingActionDao.kt - Journal grid cache
core/database/src/main/java/com/journal/core/database/dao/JournalGridCacheDao.kt - Session records
core/database/src/main/java/com/journal/core/database/dao/SessionDao.kt - Student subject cache
core/database/src/main/java/com/journal/core/database/dao/StudentSubjectCardCacheDao.kt
Other components
- App user
- Keycloak
- Journal backend
- Android notifications
Connections 24
- App user → Android entry: opens
app/src/main/java/com/journal/app/MainActivity.kt - Android entry → Role navigation: shows
app/src/main/java/com/journal/app/MainActivity.kt - Role navigation → Sign-in UI: routes to
app/src/main/java/com/journal/app/navigation/JournalNavHost.kt - Sign-in UI → Auth flow: delegates to
features/auth/src/main/java/com/journal/features/auth/AuthRoute.kt - Auth flow → Token exchange: refreshes tokens
features/auth/src/main/java/com/journal/features/auth/AuthViewModel.kt - Token exchange → Keycloak: exchanges tokens
core/data/src/main/java/com/journal/core/data/repository/AuthRepository.kt - Auth flow → Session state: saves session
features/auth/src/main/java/com/journal/features/auth/AuthViewModel.kt - Auth flow → Token state: sets tokens
features/auth/src/main/java/com/journal/features/auth/AuthViewModel.kt - Role navigation → Admin tools: routes by role
app/src/main/java/com/journal/app/navigation/JournalNavHost.kt - Role navigation → Teacher journals: routes by role
app/src/main/java/com/journal/app/navigation/JournalNavHost.kt - Role navigation → Methodist planning: routes by role
app/src/main/java/com/journal/app/navigation/JournalNavHost.kt - Role navigation → Student portal: routes by role
app/src/main/java/com/journal/app/navigation/JournalNavHost.kt - Domain repositories → Journal API: calls
- Journal API → Journal backend: requests
- Android entry → Pending edit sync: enqueues
app/src/main/java/com/journal/app/MainActivity.kt - Pending edit sync → Pending actions: loads and updates
core/data/src/main/java/com/journal/core/data/sync/SyncWorker.kt - Pending edit sync → Journal grid cache: invalidates
core/data/src/main/java/com/journal/core/data/sync/SyncWorker.kt - Pending edit sync → Journal API: dispatches edits
core/data/src/main/java/com/journal/core/data/sync/SyncWorker.kt - Android entry → Grade notifications: enqueues for students
app/src/main/java/com/journal/app/MainActivity.kt - Grade notifications → Journal API: fetches subject cards
core/data/src/main/java/com/journal/core/data/notification/StudentGradeNotificationWorker.kt - Grade notifications → Student subject cache: reads and writes
core/data/src/main/java/com/journal/core/data/notification/StudentGradeNotificationWorker.kt - Grade notifications → Android notifications: reports changes
core/data/src/main/java/com/journal/core/data/notification/StudentGradeNotificationWorker.kt - Session state → Session records: reads and writes
core/data/src/main/java/com/journal/core/data/repository/SessionRepository.kt - Session state → Room database: clears tables
core/data/src/main/java/com/journal/core/data/repository/SessionRepository.kt