How mrkamanov/scanerandroid works
Сканер тестов 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: BatchProcessingRoute.kt Batch processing · RealtimeScanScreen.kt Quick scan · BatchOmrEngine.kt Sheet OMR · JournalsScreen.kt Class journals
Components 23
Scanning and recognition
- Quick scan
app/src/main/java/com/tscan/scanertestov/feature/realtime/RealtimeScanScreen.kt - Live preview
app/src/main/java/com/tscan/scanertestov/feature/realtime/engine/RealtimePreviewPipeline.kt - Quick OMR
app/src/main/java/com/tscan/scanertestov/feature/realtime/recognition/RealtimeOmrRunner.kt - Batch capture
app/src/main/java/com/tscan/scanertestov/feature/batch/BatchDocumentCameraRoute.kt - Batch processing
app/src/main/java/com/tscan/scanertestov/feature/batch/BatchProcessingRoute.kt - Sheet OMR
app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchOmrEngine.kt - Sheet detection
app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchSheetContourDetector.kt - Grid detection
app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchInnerGridDetector.kt - Answer scoring
app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchScoringEngine.kt - Text recognition
app/src/main/java/com/tscan/scanertestov/ml/ocr/PaddleRecPreprocessor.kt - Batch results
app/src/main/java/com/tscan/scanertestov/feature/batch/BatchResultsRoute.kt
Classroom records
- Class journals
app/src/main/java/com/tscan/scanertestov/feature/journals/JournalsScreen.kt - Journal storage
app/src/main/java/com/tscan/scanertestov/feature/journals/JournalRepository.kt - Reports
app/src/main/java/com/tscan/scanertestov/feature/reports/ReportsScreen.kt - Report export
app/src/main/java/com/tscan/scanertestov/feature/reports/ReportsExcelExporter.kt
Sheet authoring
- Blank editor
app/src/main/java/com/tscan/scanertestov/feature/blankeditor/BlankEditorScreen.kt - Sheet export
app/src/main/java/com/tscan/scanertestov/feature/blankeditor/BlankSheetExport.kt
App navigation and support
- App shell
app/src/main/java/com/tscan/scanertestov/ui/ScanerTestovApp.kt - Main menu
app/src/main/java/com/tscan/scanertestov/feature/mainmenu/MainMenuScreen.kt - Settings
app/src/main/java/com/tscan/scanertestov/feature/settings/SettingsScreen.kt - App settings
app/src/main/java/com/tscan/scanertestov/data/AppSettingsStore.kt - Instructions
app/src/main/java/com/tscan/scanertestov/feature/instructions/InstructionsScreen.kt
Other components
- Teacher
Connections 23
- Teacher → App shell: opens
README.md - App shell → Main menu: shows
- Teacher → Quick scan: starts quick check
README.md - Quick scan → Live preview: processes frames
app/src/main/java/com/tscan/scanertestov/feature/realtime/engine/RealtimePreviewPipeline.kt - Quick scan → Quick OMR: checks captured sheet
- Teacher → Batch capture: adds photos
README.md - Batch capture → Batch processing: submits work
README.md - Batch processing → Sheet OMR: runs recognition
- Sheet OMR → Sheet detection: detects sheet
app/src/main/java/com/tscan/scanertestov/feature/batch/engine/BatchOmrEngine.kt - Sheet OMR → Grid detection: locates answer grid
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
README.md - Batch processing → Class journals: matches roster
README.md - Batch processing → Batch results: presents results
README.md - Teacher → Class journals: manages classes
README.md - Class journals → Journal storage: reads and writes
- Teacher → Reports: reviews results
README.md - Reports → Report export: exports summary
- Teacher → Blank editor: designs template
README.md - Blank editor → Sheet export: exports sheet
README.md - Teacher → Settings: configures app
- Settings → App settings: stores preferences
- Teacher → Instructions: opens guidance
README.md