# mrkamanov/scanerandroid architecture

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

- Interactive diagram: https://gitdiagram.com/mrkamanov/scanerandroid
- Repository: https://github.com/mrkamanov/scanerandroid

## Overview

Сканер тестов is an offline Android app for teachers to scan marked test sheets, score them, manage class rosters, and review results. The primary workflow is camera or gallery input → sheet detection and OMR → answer scoring → results; batch recognition can also read student names and variants for roster matching. Separate capabilities include live single-sheet checking, journal management, reports, blank-sheet creation/export, settings, and in-app instructions. README statements establish the user-facing flows; sampled source confirms parts of the image-analysis and OCR internals, while unsampled subsystem links are omitted or marked unverified.

Main entry points: [`app/src/main/java/com/tscan/scanertestov/feature/batch/BatchProcessingRoute.kt`](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/BatchProcessingRoute.kt) (Batch processing), [`app/src/main/java/com/tscan/scanertestov/feature/realtime/RealtimeScanScreen.kt`](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/realtime/RealtimeScanScreen.kt) (Quick scan), [`app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchOmrEngine.kt`](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchOmrEngine.kt) (Sheet OMR), [`app/src/main/java/com/tscan/scanertestov/feature/journals/JournalsScreen.kt`](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/journals/JournalsScreen.kt) (Class journals)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scan["Scanning and recognition"]
  node_realtime["Quick scan"]
  node_preview["Live preview"]
  node_realtime_omr["Quick OMR"]
  node_batch_capture["Batch capture"]
  node_batch_process["Batch processing"]
  node_omr["Sheet OMR<br/>[BatchOmrEngine.kt]"]
  node_contour["Sheet detection"]
  node_grid["Grid detection"]
  node_scoring["Answer scoring"]
  node_ocr["Text recognition"]
  node_batch_results["Batch results"]
end

subgraph group_classroom["Classroom records"]
  node_journals["Class journals<br/>[JournalsScreen.kt]"]
  node_journal_store[("Journal storage")]
  node_reports["Reports<br/>[ReportsScreen.kt]"]
  node_report_export["Report export"]
end

subgraph group_authoring["Sheet authoring"]
  node_blank_editor["Blank editor"]
  node_blank_export["Sheet export"]
end

subgraph group_app["App navigation and support"]
  node_app_entry["App shell<br/>[ScanerTestovApp.kt]"]
  node_menu["Main menu<br/>[MainMenuScreen.kt]"]
  node_settings["Settings<br/>[SettingsScreen.kt]"]
  node_settings_store[("App settings")]
  node_instructions["Instructions"]
end

node_teacher(("Teacher"))

node_teacher -->|"opens"| node_app_entry
node_app_entry -.->|"shows"| node_menu
node_teacher -->|"starts quick check"| node_realtime
node_realtime -->|"processes frames"| node_preview
node_realtime -.->|"checks captured sheet"| node_realtime_omr
node_teacher -->|"adds photos"| node_batch_capture
node_batch_capture -->|"submits work"| node_batch_process
node_batch_process -.->|"runs recognition"| node_omr
node_omr -->|"detects sheet"| node_contour
node_omr -->|"locates answer grid"| node_grid
node_batch_process -.->|"scores answers"| node_scoring
node_batch_process -.->|"recognizes names and variants"| node_ocr
node_batch_process -->|"matches roster"| node_journals
node_batch_process -->|"presents results"| node_batch_results
node_teacher -->|"manages classes"| node_journals
node_journals -.->|"reads and writes"| node_journal_store
node_teacher -->|"reviews results"| node_reports
node_reports -.->|"exports summary"| node_report_export
node_teacher -->|"designs template"| node_blank_editor
node_blank_editor -->|"exports sheet"| node_blank_export
node_teacher -.->|"configures app"| node_settings
node_settings -.->|"stores preferences"| node_settings_store
node_teacher -->|"opens guidance"| node_instructions

click node_app_entry "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/ui/ScanerTestovApp.kt"
click node_menu "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/mainmenu/MainMenuScreen.kt"
click node_realtime "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/realtime/RealtimeScanScreen.kt"
click node_preview "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/realtime/engine/RealtimePreviewPipeline.kt"
click node_realtime_omr "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/realtime/recognition/RealtimeOmrRunner.kt"
click node_batch_capture "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/BatchDocumentCameraRoute.kt"
click node_batch_process "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/BatchProcessingRoute.kt"
click node_omr "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchOmrEngine.kt"
click node_contour "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchSheetContourDetector.kt"
click node_grid "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchInnerGridDetector.kt"
click node_scoring "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchScoringEngine.kt"
click node_ocr "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/ml/ocr/PaddleRecPreprocessor.kt"
click node_batch_results "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/BatchResultsRoute.kt"
click node_journals "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/journals/JournalsScreen.kt"
click node_journal_store "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/journals/JournalRepository.kt"
click node_reports "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/reports/ReportsScreen.kt"
click node_report_export "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/reports/ReportsExcelExporter.kt"
click node_blank_editor "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/blankeditor/BlankEditorScreen.kt"
click node_blank_export "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/blankeditor/BlankSheetExport.kt"
click node_settings "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/settings/SettingsScreen.kt"
click node_settings_store "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/data/AppSettingsStore.kt"
click node_instructions "https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/instructions/InstructionsScreen.kt"

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_realtime,node_preview,node_realtime_omr,node_batch_capture,node_batch_process,node_omr,node_contour,node_grid,node_scoring,node_ocr,node_batch_results toneBlue
class node_journals,node_journal_store,node_reports,node_report_export toneAmber
class node_blank_editor,node_blank_export toneMint
class node_app_entry,node_menu,node_settings,node_settings_store,node_instructions toneRose
class node_teacher toneIndigo
```

## Components

### Scanning and recognition

- [Quick scan](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/realtime/RealtimeScanScreen.kt): `app/src/main/java/com/tscan/scanertestov/feature/realtime/RealtimeScanScreen.kt`
- [Live preview](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/realtime/engine/RealtimePreviewPipeline.kt): `app/src/main/java/com/tscan/scanertestov/feature/realtime/engine/RealtimePreviewPipeline.kt`
- [Quick OMR](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/realtime/recognition/RealtimeOmrRunner.kt): `app/src/main/java/com/tscan/scanertestov/feature/realtime/recognition/RealtimeOmrRunner.kt`
- [Batch capture](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/BatchDocumentCameraRoute.kt): `app/src/main/java/com/tscan/scanertestov/feature/batch/BatchDocumentCameraRoute.kt`
- [Batch processing](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/BatchProcessingRoute.kt): `app/src/main/java/com/tscan/scanertestov/feature/batch/BatchProcessingRoute.kt`
- [Sheet OMR](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchOmrEngine.kt): `app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchOmrEngine.kt`
- [Sheet detection](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchSheetContourDetector.kt): `app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchSheetContourDetector.kt`
- [Grid detection](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchInnerGridDetector.kt): `app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchInnerGridDetector.kt`
- [Answer scoring](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchScoringEngine.kt): `app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchScoringEngine.kt`
- [Text recognition](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/ml/ocr/PaddleRecPreprocessor.kt): `app/src/main/java/com/tscan/scanertestov/ml/ocr/PaddleRecPreprocessor.kt`
- [Batch results](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/batch/BatchResultsRoute.kt): `app/src/main/java/com/tscan/scanertestov/feature/batch/BatchResultsRoute.kt`

### Classroom records

- [Class journals](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/journals/JournalsScreen.kt): `app/src/main/java/com/tscan/scanertestov/feature/journals/JournalsScreen.kt`
- [Journal storage](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/journals/JournalRepository.kt): `app/src/main/java/com/tscan/scanertestov/feature/journals/JournalRepository.kt`
- [Reports](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/reports/ReportsScreen.kt): `app/src/main/java/com/tscan/scanertestov/feature/reports/ReportsScreen.kt`
- [Report export](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/reports/ReportsExcelExporter.kt): `app/src/main/java/com/tscan/scanertestov/feature/reports/ReportsExcelExporter.kt`

### Sheet authoring

- [Blank editor](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/blankeditor/BlankEditorScreen.kt): `app/src/main/java/com/tscan/scanertestov/feature/blankeditor/BlankEditorScreen.kt`
- [Sheet export](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/blankeditor/BlankSheetExport.kt): `app/src/main/java/com/tscan/scanertestov/feature/blankeditor/BlankSheetExport.kt`

### App navigation and support

- [App shell](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/ui/ScanerTestovApp.kt): `app/src/main/java/com/tscan/scanertestov/ui/ScanerTestovApp.kt`
- [Main menu](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/mainmenu/MainMenuScreen.kt): `app/src/main/java/com/tscan/scanertestov/feature/mainmenu/MainMenuScreen.kt`
- [Settings](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/settings/SettingsScreen.kt): `app/src/main/java/com/tscan/scanertestov/feature/settings/SettingsScreen.kt`
- [App settings](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/data/AppSettingsStore.kt): `app/src/main/java/com/tscan/scanertestov/data/AppSettingsStore.kt`
- [Instructions](https://github.com/mrkamanov/scanerandroid/blob/main/app/src/main/java/com/tscan/scanertestov/feature/instructions/InstructionsScreen.kt): `app/src/main/java/com/tscan/scanertestov/feature/instructions/InstructionsScreen.kt`

### Other components

- **Teacher**

## Connections

- Teacher → App shell: opens (evidence: `README.md`)
- App shell → Main menu: shows
- Teacher → Quick scan: starts quick check (evidence: `README.md`)
- Quick scan → Live preview: processes frames (evidence: `app/src/main/java/com/tscan/scanertestov/feature/realtime/engine/RealtimePreviewPipeline.kt`)
- Quick scan → Quick OMR: checks captured sheet
- Teacher → Batch capture: adds photos (evidence: `README.md`)
- Batch capture → Batch processing: submits work (evidence: `README.md`)
- Batch processing → Sheet OMR: runs recognition
- Sheet OMR → Sheet detection: detects sheet (evidence: `app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchOmrEngine.kt`)
- Sheet OMR → Grid detection: locates answer grid (evidence: `app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchOmrEngine.kt`)
- Batch processing → Answer scoring: scores answers
- Batch processing → Text recognition: recognizes names and variants (evidence: `README.md`)
- Batch processing → Class journals: matches roster (evidence: `README.md`)
- Batch processing → Batch results: presents results (evidence: `README.md`)
- Teacher → Class journals: manages classes (evidence: `README.md`)
- Class journals → Journal storage: reads and writes
- Teacher → Reports: reviews results (evidence: `README.md`)
- Reports → Report export: exports summary
- Teacher → Blank editor: designs template (evidence: `README.md`)
- Blank editor → Sheet export: exports sheet (evidence: `README.md`)
- Teacher → Settings: configures app
- Settings → App settings: stores preferences
- Teacher → Instructions: opens guidance (evidence: `README.md`)
