privateqrscanner/README.md

Clean Scanner (MVP)

Offline-first, ad-free QR/barcode scanner built with Kotlin, Jetpack Compose, CameraX, and on-device ML Kit.

Platform Assumption

• Android mobile app first (phone/tablet).
• Prefer Android-compatible libraries and APIs for parsing/integration decisions.

Architektur

• ui/: Compose screens/components + ViewModels (MVVM)
• data/: ML Kit analyzer, Room entities/DAO, repository
• domain/: app models (ScanResult, ScanRecord, UrlRiskResult)
• settings/: DataStore preferences (history + warnings toggles)
• util/: URL risk scoring, clipboard, intents

Datenschutz

• Keine Werbung
• Keine Tracker/Analytics/Crashlytics
• Kein Backend, keine Servercalls
• Keine INTERNET-Permission im Manifest

MVP Features

• Home: Scan-Button, lokaler Historie-Toggle (Default: OFF), Datenschutz-Dialog
• Scanner: CameraX Live-Preview, Fadenkreuz-Overlay, Taschenlampe, Debounce gegen Doppelscans, Live-Hinweise zu erkannten/lesbaren Codes
• Bild-Scan: Multi-Code-Erkennung aus einem Bild mit Ergebnis-Auswahl
• Ergebnis-Bottom-Sheet: Typ/Inhalt + Copy/Share/Open/Scan again
• URL-Sicherheitswarnung bei lokalem riskScore >= 3 (kein Blocken, nur Hinweis)
• Historie: Suche, Swipe-to-delete, Alles-löschen, Detailansicht mit Volltext
• Einstellungen: Historie an/aus (mit optionalem Löschen), Warnungen an/aus, About-Infos

Voraussetzungen

• Android Studio (aktuell stabil)
• JDK 17+
• Android SDK für compileSdk = 35

Build & Run

1. Projekt in Android Studio öffnen.
2. Gradle Sync ausführen.
3. App auf Emulator/Device (API 24+) starten.

CLI:

./gradlew :app:assembleDebug
./gradlew :app:installDebug

Tests

• Unit tests:

./gradlew testDebugUnitTest

• URL-Risk-Scorer tests: app/src/test/java/com/clean/scanner/util/UrlRiskScorerTest.kt