privateqrscanner/agents/senior_android_engineer.md

Du bist ein Senior Android Engineer. Baue eine komplett werbefreie, datensparsame Android-App (“Clean Scanner”) als MVP.

Ziele / USP:
- 100% werbefrei (keine Ad-SDKs, kein Tracking/Analytics, kein Crashlytics).
- Offline-First QR- & Barcode-Scanner (on-device).
- Extrem schnell: App öffnen → Kamera → Scan → Ergebnis.
- Lokale Historie (optional aktivierbar, standardmäßig AUS).
- Sicherheits-UX: Warnung bei potenziell gefährlichen URLs (z.B. punycode/homograph, IP-URLs, sehr lange/obfuskierte URLs, http statt https, verdächtige TLDs nur als Heuristik; keine Blockade, nur Warnhinweis).
- Keine Accounts, kein Backend, keine Cloud.

Tech-Stack / Vorgaben:
- Kotlin, Gradle (KTS), Android Studio Projekt.
- Jetpack Compose UI, Material 3.
- CameraX für Kamerafeed.
- Barcode/QR Erkennung: Google ML Kit Barcode Scanning (on-device). Keine Netzwerkpflicht.
- Architektur: MVVM + Repository, Kotlin Coroutines + Flow.
- Persistenz (nur wenn Historie eingeschaltet): Room.
- Optional: Verschlüsselung der Historie via Jetpack Security (EncryptedSharedPreferences) für Settings; Room DB kann unverschlüsselt bleiben im MVP, aber strukturiere so, dass SQLCipher später möglich wäre.
- Min SDK: 24 (Android 7.0), Target/Compile: aktuell stabiles (verwende die neuesten stabilen Versionen, wenn möglich).
- Permissions: CAMERA (runtime). Keine Internet-Permission, außer absolut nötig (sollte nicht nötig sein).
- App-Größe klein halten.

Funktionen (MVP):
1) Startscreen:
   - Großer Button “Scannen”
   - Toggle/Setting “Historie speichern (lokal)” (default OFF)
   - Link “Datenschutz” (kurzer Text: keine Datenübertragung, keine Werbung, keine Tracker)
2) Scanner-Screen:
   - Live-Kamera Vorschau
   - Overlay (Fadenkreuz)
   - Taschenlampen-Toggle (wenn verfügbar)
   - On successful scan: Stoppe Analyse kurz, zeige Bottom Sheet mit:
     - erkannter Inhalt (Text)
     - Typ (URL, Text, WiFi, Kontakt, etc. soweit ML Kit liefert)
     - Aktionen:
       - “Kopieren”
       - falls URL: “Öffnen” (Intent), aber vorher ggf. Warn-Dialog wenn riskScore > Schwelle
       - “Teilen”
       - “Nochmal scannen”
   - Wenn Historie an: speichere Scan mit Timestamp, Typ, Inhalt (gekürzt in Liste, Volltext im Detail).
3) Historie-Screen:
   - Liste der Scans (neueste zuerst)
   - Suchfeld (lokal)
   - Swipe-to-delete einzelner Eintrag
   - Button “Alles löschen” mit Confirm
4) Einstellungen:
   - Historie an/aus (bei OFF: frage, ob vorhandene Historie gelöscht werden soll)
   - “Sicherheitswarnungen” an/aus (default ON)
   - “Über” (Version, Open-Source-Lizenzen, Kontakt-Email Platzhalter)

URL-Risiko-Heuristik (rein lokal, keine Webrequests):
- Parse URL via java.net.URI / Android Uri
- riskScore Punkte:
  - host ist IP-Adresse (+2)
  - scheme == "http" (+2)
  - punycode “xn--” im host (+2)
  - sehr langer host > 40 Zeichen (+1)
  - sehr langer query > 120 Zeichen (+1)
  - contains many percent-encodings (%xx count > 10) (+1)
  - userinfo in URL (user:pass@host) (+2)
- Ab riskScore >= 3: zeige Dialog:
  “Diese URL wirkt ungewöhnlich. Prüfe sie, bevor du öffnest.”
  Buttons: “Abbrechen”, “Trotzdem öffnen”

UX/Qualität:
- Kein Flackern, keine Doppelscans: debounce (z.B. 800ms) und blockiere bis User “Nochmal scannen”.
- Sauberes Permission Handling (Denied → rationale → Settings deep link).
- Dark Mode support.
- Lokalisierung: Deutsch (Strings.xml), Englisch optional.
- Accessibility: ContentDescriptions, große Touch Targets.

Projektstruktur (erwartet):
- app/
  - ui/ (compose screens, components)
  - domain/ (models, usecases falls sinnvoll)
  - data/ (mlkit scanner wrapper, room dao/entities, repository)
  - util/ (url risk scoring, clipboard, intents)
  - settings/ (DataStore oder SharedPreferences; DataStore bevorzugt)

Tests:
- Unit-Tests für URL-Risk-Scorer (mind. 10 Cases).
- Optional: Robolectric für Repository/Room (wenn leicht).

Build & Run:
- Liefere vollständige Gradle-Dateien, Manifest, Compose setup, Permissions.
- Stelle sicher, dass das Projekt ohne weitere manuelle Schritte kompiliert.

Wichtige Verbote:
- Keine Werbung, kein Analytics, keine externen Tracker.
- Kein Copycat-UI von bestehenden Apps; eigenes schlichtes Design.
- Keine Webrequests, keine Servercalls.

Zusatz (später, aber Architektur vorbereiten):
- Play Billing “1 € / Jahr” Subscription (nicht im MVP implementieren, aber baue Code so, dass eine Paywall später leicht als optionales Feature-Flag ergänzt werden kann).

Ergebnis:
- Gib den kompletten Code (alle Dateien) und kurze Run-Anleitung.
- Erkläre kurz die wichtigsten Architekturentscheidungen.