stechuhr3/ANDROID_TECHNICAL_NEXT_STEPS.md

Android Technical Next Steps

Stand: 2026-05-14

OAuth

Ziel: Android soll Google OAuth direkt starten koennen, ohne WebView-Klon.

Empfohlener Ablauf:

1. Backend bekommt einen Android-kompatiblen OAuth-Callback mit App-Link oder Custom-Scheme.
2. Android startet den Google-Flow ueber Browser Custom Tabs.
3. Callback oeffnet die App per Deep Link, z.B. timeclock://oauth-callback?token=....
4. App speichert JWT im bestehenden TokenStore und laedt /auth/me.
5. Fehlerfaelle: abgebrochener Login, abgelaufener Token, fehlender Account, Offline.

Technische Punkte:

• Redirect-URI muss in Google Console und Backend konfiguriert werden.
• Token darf nicht in Logs erscheinen.
• Der bestehende E-Mail/Passwort-Login bleibt Fallback.

Offline-Stempeln

Umgesetzt als Grundfunktion:

• Netzwerkfehler bei clock(action) speichern die Aktion lokal in OfflineClockQueue.
• Beim naechsten erfolgreichen Dashboard-Refresh werden gespeicherte Aktionen in Reihenfolge synchronisiert.

Noch offen fuer produktionsreife Offline-Funktion:

• UI-Hinweis mit Anzahl ausstehender Aktionen.
• Konfliktbehandlung, falls der Serverzustand nicht mehr zur Aktionsfolge passt.
• Persistente Audit-Anzeige fuer synchronisierte/fehlgeschlagene Offline-Aktionen.
• Tests mit simulierten Netzwerkfehlern und Wiederverbindung.

Smartphone/Tablet UI-Feinschliff

Pruefpunkte mit echten Backend-Daten:

• Smartphone: Bottom-Navigation + Submenue fuer Buchungen, Einstellungen, Auswertung und Verwaltung.
• Tablet: linkes Section-Menue, Detailbereiche und breite Listen.
• Lange Namen/E-Mail-Adressen duerfen keine Buttons oder Zeilen sprengen.
• Admin-Listen mit vielen Benutzern/Feiertagen muessen scrollbar bleiben.

Phase 8 Teststrategie

Erste lokale Tests sind angelegt fuer:

• API-Serialisierung wichtiger Backend-Responses.
• Gehashte IDs als Strings auf geschuetzten Endpunkten.
• Offline-Queue-Serialisierung.

Weitere sinnvolle Tests:

• Repository-Tests mit fake API-Schicht.
• ViewModel-Tests fuer Login, Stempeln, Offline-Queue und Rollenwechsel.
• Compose-Screenshot-Checks fuer Smartphone und Tablet.