# akki2104/jeeprep architecture

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

- Interactive diagram: https://gitdiagram.com/akki2104/jeeprep
- Repository: https://github.com/akki2104/jeeprep

## Overview

1. **Overall shape**
   - This is a single-APK Android app built around a **single-activity, multi-screen Compose UI**.
   - The core architecture is **MVVM + Repository + Room**, with **Hilt** wiring dependencies and **Kotlin Coroutines/Flow** handling async work and streamed AI output.

2. **App entry and bootstrapping**
   - `JeePrepApp.kt` is the application entry point and appears responsible for **Hilt startup and first-run database seeding**.
   - `MainActivity.kt` hosts the Compose root and navigation graph, so the whole app is routed from one UI shell rather than multiple activities.

3. **Persistence layer**
   - The local database is the center of the app’s state. `AppDatabase.kt` plus the `entity/` and `dao/` packages define the Room schema and access patterns.
   - The schema stores academic content and user state together: **subjects, topics, questions, attempts, notes, memory tricks, mock tests, results, and bookmarks**.
   - `DatabaseInitializer.kt` and `SeedData.kt` populate the baseline subject/topic hierarchy and starter question bank on first launch.

4. **Primary data flow**
   - Screen state flows from **UI → ViewModel → Repository → DAO / AI layer → Room → UI**.
   - The repositories are split by responsibility:
     - `QuestionRepository` for practice questions, AI-generated questions, and bookmarks
     - `NotesRepository` for notes and memory tricks
     - `PerformanceRepository` for analytics, weak areas, and progress summaries

5. **Offline AI subsystem**
   - The AI boundary lives under `app/ai/` and is built for **on-device inference**, not a server round trip.
   - `AiEngine.kt` wraps local LLM execution through **LiteRT-LM** with streaming responses.
   - `ModelDownloadManager.kt` handles the large model download and likely the resume/progress lifecycle for the initial ~2.58 GB payload.
   - `PromptTemplates.kt` centralizes the structured prompts for explanations, MCQ generation, notes, mnemonics, and weakness analysis.
   - `GeminiApiService.kt` is part of that AI boundary, but the repo’s architecture is still centered on **local model execution after download**, not a permanent cloud dependency.

6. **AI content caching boundary**
   - A key architectural choice is that generated AI output is **cached in Room**.
   - That means explanations, notes, and memory tricks can be reused instantly after first generation, reducing repeated inference and keeping the app usable offline.

7. **Practice and PYQ subsystem**
   - The practice area is organized as a guided flow: **subject → topic → question session → submitted answer → AI explanation**.
   - `PracticeScreen`, `QuestionSessionScreen`, and their view models drive this experience.
   - The question bank is seeded from repository data and/or `assets/questions.json`, making PYQ content a local, offline dataset rather than a network-backed catalog.

8. **Mock test subsystem**
   - Mock testing is a separate flow with its own state and results handling.
   - `MockTestScreen`, `MockResultScreen`, and the mock-test view models support **timed exams, question palette behavior, mark-for-review, auto-submit, and result storage**.
   - Results feed back into the performance tables, so mock tests are both a user feature and a source of analytics data.

9. **Study notes and memory tricks**
   - `NotesScreen` and `NotesViewModels` expose AI-generated revision material by topic.
   - These outputs are designed to be concise, formula-heavy, and reusable offline once cached.
   - `PremiumGate.kt` suggests some of these higher-cost AI features are expected to be conditionally exposed by plan or quota.

10. **Progress and analytics**
   - `ProgressScreen` and `PerformanceRepository` form the analytics subsystem.
   - This layer aggregates **accuracy, subject-wise breakdown, topic heatmaps, streaks, mock-test progression, and weak-area analysis** from `user_attempts` and mock-test results.
   - This is the app’s feedback loop: user actions in practice/tests become stored attempts, which then power progress insights and AI study guidance.

11. **Navigation and UI composition**
   - `NavGraph.kt` and `BottomNav.kt` define the app’s primary route structure and persistent navigation affordances.
   - The main user-facing sections are split into distinct screens: **Home, Practice, Notes, Progress, Mock Test, PYQ, Chat, Download, Premium, and Mistakes**.
   - `ui/theme/` provides Material 3 theming and subject/status colors, which helps make the academic domains visually distinct.

12. **Math rendering and content formatting**
   - The presence of `assets/math_renderer.html` and `MathText.kt` shows a dedicated boundary for **rendering LaTeX-style math content** inside the app.
   - This matters because AI-generated notes and explanations can contain formulas, so math rendering is treated as a presentation concern rather than embedded into the data model.

13. **Premium and gating**
   - `premium/PremiumManager.kt` and `ui/components/PremiumGate.kt` isolate entitlement checks from the rest of the app.
   - Architecturally, this keeps “what the user can access” separate from “how the content is generated or stored,” which is important if free-vs-paid limits are enforced later.

14. **Assets and tooling**
   - `questions.json` is a local content source for question seeding, and `tools/generate_questions.py` indicates there is an offline content-generation or dataset-prep workflow outside the Android app.
   - The repo is otherwise a standard Android Gradle project with no backend service in the runtime path; the major external dependency is the **one-time model download** for the on-device LLM.

Main entry points: [`app/src/main/java/com/jeeprep/app/ui/navigation/NavGraph.kt`](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/navigation/NavGraph.kt) (Nav Graph), [`app/src/main/java/com/jeeprep/app/data/repository/QuestionRepository.kt`](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/repository/QuestionRepository.kt) (Question Repo), [`app/src/main/java/com/jeeprep/app/ai/AiEngine.kt`](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ai/AiEngine.kt) (AI Engine), [`app/src/main/java/com/jeeprep/app/ui/screens/mocktest/MockTestScreen.kt`](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/mocktest/MockTestScreen.kt) (Mock Test)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_grp_app["App shell"]
  node_n_app["JeePrepApp<br/>[JeePrepApp.kt]"]
  node_n_main["MainActivity<br/>activity shell<br/>[MainActivity.kt]"]
end

subgraph group_grp_data["Data layer"]
  node_n_db[("App Database<br/>room database<br/>[AppDatabase.kt]")]
  node_n_seed["Seed Data<br/>bootstrap data<br/>[SeedData.kt]"]
  node_n_init["DB Initializer<br/>bootstrap"]
  node_n_qrepo["Question Repo"]
  node_n_nrepo["Notes Repo<br/>[NotesRepository.kt]"]
  node_n_prepo["Performance Repo"]
  node_n_questiondao["Question DAO<br/>room dao<br/>[QuestionDao.kt]"]
  node_n_subjectdao["Subject DAO<br/>room dao<br/>[SubjectTopicDao.kt]"]
  node_n_otherdaos["Other DAOs<br/>room dao bundle<br/>[OtherDaos.kt]"]
  node_n_assets["Questions Asset<br/>content asset<br/>[questions.json]"]
end

subgraph group_grp_ai["AI layer"]
  node_n_ai["AI Engine<br/>local llm<br/>[AiEngine.kt]"]
  node_n_modeldl["Model Download<br/>download manager"]
  node_n_prompts["Prompt Templates<br/>prompt library<br/>[PromptTemplates.kt]"]
  node_n_gemini["Gemini API<br/>ai service"]
end

subgraph group_grp_ui["UI layer"]
  node_n_nav["Nav Graph<br/>navigation<br/>[NavGraph.kt]"]
  node_n_bottomnav["Bottom Nav<br/>navigation ui<br/>[BottomNav.kt]"]
  node_n_home["Home<br/>screen<br/>[HomeScreen.kt]"]
  node_n_practice["Practice<br/>screen<br/>[PracticeScreen.kt]"]
  node_n_session["Question Session<br/>screen"]
  node_n_notes["Notes<br/>screen<br/>[NotesScreen.kt]"]
  node_n_progress["Progress<br/>screen<br/>[ProgressScreen.kt]"]
  node_n_mock["Mock Test<br/>screen<br/>[MockTestScreen.kt]"]
  node_n_mock_result["Mock Result<br/>screen"]
  node_n_pyq["PYQ<br/>screen<br/>[PYQScreen.kt]"]
  node_n_chat["Chat<br/>screen<br/>[ChatScreen.kt]"]
  node_n_download["Model Download<br/>screen"]
  node_n_premium["Premium<br/>screen<br/>[PremiumScreen.kt]"]
  node_n_mistakes["Mistakes<br/>screen"]
  node_n_math["Math Text<br/>ui component<br/>[MathText.kt]"]
  node_n_premium_mgr["Premium Manager<br/>entitlement<br/>[PremiumManager.kt]"]
  node_n_theme["Theme<br/>design system<br/>[Theme.kt]"]
  node_n_math_asset["Math Renderer<br/>asset<br/>[math_renderer.html]"]
end

node_n_app -->|"boots"| node_n_init
node_n_app -->|"starts"| node_n_main
node_n_main -->|"hosts"| node_n_nav
node_n_nav -->|"uses"| node_n_bottomnav
node_n_nav -->|"routes"| node_n_home
node_n_nav -->|"routes"| node_n_practice
node_n_nav -->|"routes"| node_n_notes
node_n_nav -->|"routes"| node_n_progress
node_n_nav -->|"routes"| node_n_mock
node_n_nav -->|"routes"| node_n_pyq
node_n_nav -->|"routes"| node_n_chat
node_n_nav -->|"routes"| node_n_download
node_n_nav -->|"routes"| node_n_premium
node_n_nav -->|"routes"| node_n_mistakes
node_n_practice -->|"opens"| node_n_session
node_n_home -->|"loads"| node_n_qrepo
node_n_practice -->|"reads"| node_n_qrepo
node_n_session -->|"explains"| node_n_ai
node_n_notes -->|"reads"| node_n_nrepo
node_n_chat -->|"converses"| node_n_ai
node_n_download -->|"manages"| node_n_modeldl
node_n_modeldl -->|"feeds"| node_n_ai
node_n_ai -->|"formats"| node_n_prompts
node_n_ai -.->|"boundary"| node_n_gemini
node_n_qrepo -->|"queries"| node_n_questiondao
node_n_qrepo -->|"queries"| node_n_subjectdao
node_n_qrepo -->|"writes"| node_n_otherdaos
node_n_nrepo -->|"uses"| node_n_otherdaos
node_n_prepo -->|"aggregates"| node_n_otherdaos
node_n_questiondao -->|"backed by"| node_n_db
node_n_subjectdao -->|"backed by"| node_n_db
node_n_otherdaos -->|"backed by"| node_n_db
node_n_init -->|"populates"| node_n_seed
node_n_init -->|"loads"| node_n_assets
node_n_mock -->|"consumes"| node_n_qrepo
node_n_mock -->|"stores"| node_n_prepo
node_n_mock -->|"navigates"| node_n_mock_result
node_n_progress -->|"reads"| node_n_prepo
node_n_mistakes -->|"reads"| node_n_prepo
node_n_premium -->|"checks"| node_n_premium_mgr
node_n_notes -->|"gates"| node_n_premium_mgr
node_n_math -->|"renders"| node_n_math_asset
node_n_theme -->|"styles"| node_n_home
node_n_theme -->|"styles"| node_n_practice
node_n_theme -->|"styles"| node_n_notes

click node_n_app "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/JeePrepApp.kt"
click node_n_main "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/MainActivity.kt"
click node_n_nav "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/navigation/NavGraph.kt"
click node_n_bottomnav "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/navigation/BottomNav.kt"
click node_n_home "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/home/HomeScreen.kt"
click node_n_practice "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/practice/PracticeScreen.kt"
click node_n_session "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/practice/QuestionSessionScreen.kt"
click node_n_notes "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/notes/NotesScreen.kt"
click node_n_progress "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/progress/ProgressScreen.kt"
click node_n_mock "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/mocktest/MockTestScreen.kt"
click node_n_mock_result "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/mocktest/MockResultScreen.kt"
click node_n_pyq "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/pyq/PYQScreen.kt"
click node_n_chat "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/chat/ChatScreen.kt"
click node_n_download "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/download/ModelDownloadScreen.kt"
click node_n_premium "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/premium/PremiumScreen.kt"
click node_n_mistakes "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/mistakes/MistakeJournalScreen.kt"
click node_n_math "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/components/MathText.kt"
click node_n_db "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/db/AppDatabase.kt"
click node_n_seed "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/SeedData.kt"
click node_n_init "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/DatabaseInitializer.kt"
click node_n_qrepo "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/repository/QuestionRepository.kt"
click node_n_nrepo "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/repository/NotesRepository.kt"
click node_n_prepo "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/repository/PerformanceRepository.kt"
click node_n_questiondao "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/db/dao/QuestionDao.kt"
click node_n_subjectdao "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/db/dao/SubjectTopicDao.kt"
click node_n_otherdaos "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/db/dao/OtherDaos.kt"
click node_n_ai "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ai/AiEngine.kt"
click node_n_modeldl "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ai/ModelDownloadManager.kt"
click node_n_prompts "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ai/PromptTemplates.kt"
click node_n_gemini "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ai/GeminiApiService.kt"
click node_n_premium_mgr "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/premium/PremiumManager.kt"
click node_n_theme "https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/theme/Theme.kt"
click node_n_assets "https://github.com/akki2104/jeeprep/blob/master/app/src/main/assets/questions.json"
click node_n_math_asset "https://github.com/akki2104/jeeprep/blob/master/app/src/main/assets/math_renderer.html"

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_n_app,node_n_main toneBlue
class node_n_db,node_n_seed,node_n_init,node_n_qrepo,node_n_nrepo,node_n_prepo,node_n_questiondao,node_n_subjectdao,node_n_otherdaos,node_n_assets toneAmber
class node_n_ai,node_n_modeldl,node_n_prompts,node_n_gemini toneMint
class node_n_nav,node_n_bottomnav,node_n_home,node_n_practice,node_n_session,node_n_notes,node_n_progress,node_n_mock,node_n_mock_result,node_n_pyq,node_n_chat,node_n_download,node_n_premium,node_n_mistakes,node_n_math,node_n_premium_mgr,node_n_theme,node_n_math_asset toneRose
```

## Components

### App shell

Android entry points and root navigation

- [JeePrepApp](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/JeePrepApp.kt): application · Hilt app entry and first-run bootstrap · `app/src/main/java/com/jeeprep/app/JeePrepApp.kt`
- [MainActivity](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/MainActivity.kt): activity shell · Single-activity Compose host · `app/src/main/java/com/jeeprep/app/MainActivity.kt`

### Data layer

Room storage, seeding, and repositories

- [App Database](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/db/AppDatabase.kt): room database · Central Room store · `app/src/main/java/com/jeeprep/app/data/db/AppDatabase.kt`
- [Seed Data](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/SeedData.kt): bootstrap data · Initial subjects and questions · `app/src/main/java/com/jeeprep/app/data/SeedData.kt`
- [DB Initializer](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/DatabaseInitializer.kt): bootstrap · First-launch population logic · `app/src/main/java/com/jeeprep/app/data/DatabaseInitializer.kt`
- [Question Repo](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/repository/QuestionRepository.kt): repository · Practice, bookmarks, and question flows · `app/src/main/java/com/jeeprep/app/data/repository/QuestionRepository.kt`
- [Notes Repo](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/repository/NotesRepository.kt): repository · Notes and memory tricks · `app/src/main/java/com/jeeprep/app/data/repository/NotesRepository.kt`
- [Performance Repo](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/repository/PerformanceRepository.kt): repository · Attempts and analytics aggregation · `app/src/main/java/com/jeeprep/app/data/repository/PerformanceRepository.kt`
- [Question DAO](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/db/dao/QuestionDao.kt): room dao · Question and bookmark access · `app/src/main/java/com/jeeprep/app/data/db/dao/QuestionDao.kt`
- [Subject DAO](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/db/dao/SubjectTopicDao.kt): room dao · Subjects and topics access · `app/src/main/java/com/jeeprep/app/data/db/dao/SubjectTopicDao.kt`
- [Other DAOs](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/data/db/dao/OtherDaos.kt): room dao bundle · Notes, attempts, mock results, and related tables · `app/src/main/java/com/jeeprep/app/data/db/dao/OtherDaos.kt`
- [Questions Asset](https://github.com/akki2104/jeeprep/blob/master/app/src/main/assets/questions.json): content asset · Seed question dataset · `app/src/main/assets/questions.json`

### AI layer

Local model execution, prompts, and downloads

- [AI Engine](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ai/AiEngine.kt): local llm · Streaming on-device inference · `app/src/main/java/com/jeeprep/app/ai/AiEngine.kt`
- [Model Download](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ai/ModelDownloadManager.kt): download manager · Large model fetch and resume handling · `app/src/main/java/com/jeeprep/app/ai/ModelDownloadManager.kt`
- [Prompt Templates](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ai/PromptTemplates.kt): prompt library · Structured prompts for generation tasks · `app/src/main/java/com/jeeprep/app/ai/PromptTemplates.kt`
- [Gemini API](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ai/GeminiApiService.kt): ai service · External AI boundary in the app · `app/src/main/java/com/jeeprep/app/ai/GeminiApiService.kt`

### UI layer

Compose screens, navigation, and shared components

- [Nav Graph](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/navigation/NavGraph.kt): navigation · Primary route structure · `app/src/main/java/com/jeeprep/app/ui/navigation/NavGraph.kt`
- [Bottom Nav](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/navigation/BottomNav.kt): navigation ui · Persistent section switching · `app/src/main/java/com/jeeprep/app/ui/navigation/BottomNav.kt`
- [Home](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/home/HomeScreen.kt): screen · Landing dashboard · `app/src/main/java/com/jeeprep/app/ui/screens/home/HomeScreen.kt`
- [Practice](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/practice/PracticeScreen.kt): screen · Subject-topic practice flow · `app/src/main/java/com/jeeprep/app/ui/screens/practice/PracticeScreen.kt`
- [Question Session](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/practice/QuestionSessionScreen.kt): screen · Answering and explanation flow · `app/src/main/java/com/jeeprep/app/ui/screens/practice/QuestionSessionScreen.kt`
- [Notes](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/notes/NotesScreen.kt): screen · Revision notes and mnemonics · `app/src/main/java/com/jeeprep/app/ui/screens/notes/NotesScreen.kt`
- [Progress](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/progress/ProgressScreen.kt): screen · Analytics and weak areas · `app/src/main/java/com/jeeprep/app/ui/screens/progress/ProgressScreen.kt`
- [Mock Test](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/mocktest/MockTestScreen.kt): screen · Timed exam workflow · `app/src/main/java/com/jeeprep/app/ui/screens/mocktest/MockTestScreen.kt`
- [Mock Result](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/mocktest/MockResultScreen.kt): screen · Score and result summary · `app/src/main/java/com/jeeprep/app/ui/screens/mocktest/MockResultScreen.kt`
- [PYQ](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/pyq/PYQScreen.kt): screen · Previous-question-bank browsing · `app/src/main/java/com/jeeprep/app/ui/screens/pyq/PYQScreen.kt`
- [Chat](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/chat/ChatScreen.kt): screen · AI help and explanations · `app/src/main/java/com/jeeprep/app/ui/screens/chat/ChatScreen.kt`
- [Model Download](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/download/ModelDownloadScreen.kt): screen · Local model download progress · `app/src/main/java/com/jeeprep/app/ui/screens/download/ModelDownloadScreen.kt`
- [Premium](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/premium/PremiumScreen.kt): screen · Entitlement and upgrade gate · `app/src/main/java/com/jeeprep/app/ui/screens/premium/PremiumScreen.kt`
- [Mistakes](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/screens/mistakes/MistakeJournalScreen.kt): screen · Error journal and review · `app/src/main/java/com/jeeprep/app/ui/screens/mistakes/MistakeJournalScreen.kt`
- [Math Text](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/components/MathText.kt): ui component · Formula rendering helper · `app/src/main/java/com/jeeprep/app/ui/components/MathText.kt`
- [Premium Manager](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/premium/PremiumManager.kt): entitlement · Access and plan checks · `app/src/main/java/com/jeeprep/app/premium/PremiumManager.kt`
- [Theme](https://github.com/akki2104/jeeprep/blob/master/app/src/main/java/com/jeeprep/app/ui/theme/Theme.kt): design system · Material 3 colors and styling · `app/src/main/java/com/jeeprep/app/ui/theme/Theme.kt`
- [Math Renderer](https://github.com/akki2104/jeeprep/blob/master/app/src/main/assets/math_renderer.html): asset · HTML math rendering bridge · `app/src/main/assets/math_renderer.html`

## Connections

- JeePrepApp → DB Initializer: boots · Initializes first-run data
- JeePrepApp → MainActivity: starts · Launches the single activity
- MainActivity → Nav Graph: hosts · Sets the root navigation graph
- Nav Graph → Bottom Nav: uses · Provides section switching
- Nav Graph → Home: routes · Home destination
- Nav Graph → Practice: routes · Practice destination
- Nav Graph → Notes: routes · Notes destination
- Nav Graph → Progress: routes · Progress destination
- Nav Graph → Mock Test: routes · Mock test destination
- Nav Graph → PYQ: routes · PYQ destination
- Nav Graph → Chat: routes · Chat destination
- Nav Graph → Model Download: routes · Model download destination
- Nav Graph → Premium: routes · Premium destination
- Nav Graph → Mistakes: routes · Mistakes destination
- Practice → Question Session: opens · Drills into a question session
- Home → Question Repo: loads · Surfaces practice content
- Practice → Question Repo: reads · Fetches subjects, topics, and questions
- Question Session → AI Engine: explains · Requests streamed AI explanations
- Notes → Notes Repo: reads · Fetches cached notes and tricks
- Chat → AI Engine: converses · Streams on-device responses
- Model Download → Model Download: manages · Controls model fetch lifecycle
- Model Download → AI Engine: feeds · Prepares local model execution
- AI Engine → Prompt Templates: formats · Uses structured task prompts
- AI Engine → Gemini API: boundary · External AI interface
- Question Repo → Question DAO: queries · Question storage access
- Question Repo → Subject DAO: queries · Subject and topic hierarchy
- Question Repo → Other DAOs: writes · Bookmarks and attempts persistence
- Notes Repo → Other DAOs: uses · Notes and memory trick storage
- Performance Repo → Other DAOs: aggregates · Builds progress analytics
- Question DAO → App Database: backed by · Room access layer
- Subject DAO → App Database: backed by · Room access layer
- Other DAOs → App Database: backed by · Room access layer
- DB Initializer → Seed Data: populates · Seeds baseline data
- DB Initializer → Questions Asset: loads · Imports local question content
- Mock Test → Question Repo: consumes · Pulls exam questions
- Mock Test → Performance Repo: stores · Persists results and attempts
- Mock Test → Mock Result: navigates · Shows result summary
- Progress → Performance Repo: reads · Displays analytics and trends
- Mistakes → Performance Repo: reads · Builds mistake journal from attempts
- Premium → Premium Manager: checks · Evaluates entitlements
- Notes → Premium Manager: gates · Limits higher-cost features
- Math Text → Math Renderer: renders · Displays formula content
- Theme → Home: styles · Shared UI styling
- Theme → Practice: styles · Shared UI styling
- Theme → Notes: styles · Shared UI styling
