--- module: 36 title: Mobile-App (Capacitor-Wrapper) phase: 1 status: detail-spec-draft last_updated: 2026-05-08 session_source: brainstorming-session-2026-05-07-2206.md related_lps: [LP-2, LP-8, LP-9, LP-10, LP-12, LP-13] spec_style: requirements-pur --- # Modul 36 — Mobile-App (Capacitor-Wrapper) > **Detail-Spec gemäß LP-9.** Native Mobile-App für iOS und Android als Capacitor-Wrapper um die mobile-first responsive Web-App. **Kein** echtes Native (LP-8). Pflicht-Native-Features (Push, Face-ID/Touch-ID, Kamera) erfüllen Apple-Guideline 4.2 ("Minimum Functionality"). **Offline-Modus ist Phase-1-Pflicht** (User-Korrektur — kritisch für Baustellen-Use-Case). Apple-Compliance strikt: keinerlei Pricing/Upgrade-UI in der App (LP-8, Guideline 3.1.3(c) Enterprise-Services-Ausnahme). ## Themenblöcke ``` A. Datenmodell (NotificationDevice [Verweis M22], MobileAppSession, OfflineSyncQueue) B. Build-Strategie und Code-Sharing C. Native-Features (Pflicht für Apple-Compliance) D. Offline-Modus (Phase-1-Pflicht) E. Sync-on-Reconnect (Strategien + Konflikt-Resolution) F. Apple-Compliance (Pricing-Block, SIWA-Umgehung, Demo-Account, Privacy-Manifest) G. Account-Löschung in der App (Verweis M35) H. Permissions (App-Level, OS-Level) I. Routes / Tiefen-Verlinkung (Deeplinks) J. Update-Mechanik (Web-Code-Live + Native-Wrapper) K. Submission-Strategie (Google Play zuerst, dann Apple) L. Klartext-Hinweise / Fehler M. Permissions-Anwendung (Tenant-Permissions in der App) N. Phase 2 / spätere Features O. Architektur-Vorschriften (Querschnitt) ``` --- ## Block A — Datenmodell ### A.1 — `NotificationDevice` (in M22 vollständig spec'd) Modul 36 ist **Konsument** dieser Entität, nicht Owner. Verweis auf Modul 22, Block A. Anforderungen aus Sicht der Mobile-App: - Beim ersten Login der App auf einem Gerät: Push-Token holen (APNs-Token auf iOS, FCM-Token auf Android), via `/api/v1/notifications/mobile-device` registrieren - Pro Tenant eigene Registrierung (User mit mehreren Tenants → mehrere Device-Einträge mit gleichem Push-Token, unterschiedlichem `tenant_id`) - Bei Logout: Device wird in M22 revoked - Bei App-Reinstall (neuer Push-Token): alter Eintrag wird automatisch `revoked` gesetzt (Trigger: APNs/FCM `InvalidToken`-Response — siehe M22 Block H) ### A.2 — `MobileAppSession` Tenant-scoped (RLS aktiv). Erweitert die generelle `Session`-Entität aus Modul 27 um Mobile-spezifische Felder. - `id` (UUID) - `tenant_id`, `user_id` - `session_id` (FK auf zentrale `Session`-Tabelle aus M27) - `device_kind` (Enum: `ios | android`) - `device_label` (vom OS oder User benannt) - `os_version` - `app_version` (Capacitor-Wrapper-Version, z.B. `1.4.2`) - `web_bundle_version` (Web-Code-Version, kann durch Live-Update vom Wrapper abweichen) - `biometric_enabled` (Boolean — User hat Face-ID/Touch-ID-Login aktiviert auf diesem Gerät) - `biometric_kind` (Enum: `face_id | touch_id | android_biometric` — gemäß OS-Verfügbarkeit, NULL falls deaktiviert) - `last_foreground_at` (Timestamp — wann war App das letzte Mal aktiv) - `last_sync_at` (Timestamp — wann lief der letzte erfolgreiche Sync) - `created_at`, `updated_at` **Indizes:** `(tenant_id, user_id)`, `(session_id)` unique. **Constraint:** Bei aktivem Biometrie-Login Speicherung des Auth-Secrets im **OS-Keychain** (iOS Keychain Services, Android Keystore) — kein Server-Persistenz des Secrets. ### A.3 — `OfflineSyncQueue` (lokal in IndexedDB, NICHT Cloud) **Wichtig:** Diese Entität existiert ausschließlich client-seitig in IndexedDB. Wird in Phase 1 **nicht** auf den Server synchronisiert (keine Cross-Device-Resume-Funktion). Pro Eintrag: - `id` (lokale UUID, stabil bis erfolgreicher Sync) - `tenant_id` (für Multi-Tenant-Trennung im lokalen Storage) - `user_id` - `created_at` (lokale Zeit) - `entity_type` (Enum: `task | acceptance | photo | note | checklist_item | file_upload | activity_create`) - `entity_id` (lokale UUID falls Append-Only-Create, oder Server-UUID falls Update) - `operation` (Enum: `create | update | delete | append`) - `payload` (JSON — vollständige Operation-Daten) - `binary_blob_ref` (Lokal-Storage-Pfad zu Binary, z.B. Foto-File; NULL falls Text-Only) - `status` (Enum: `pending | syncing | synced | failed | conflict`) - `attempt_count` (Anzahl Sync-Versuche) - `last_attempt_at` - `last_error_message` (Klartext bei `failed`) - `conflict_resolution_required` (Boolean — User-Sichtbarkeit nötig) - `synced_server_id` (Server-UUID nach erfolgreichem Sync — für lokale ID-Auflösung) **Indizes (IndexedDB):** `tenant_id + status`, `entity_type`, `created_at`. **Lokale Aufbewahrung:** - `synced`-Einträge: 7 Tage Aufbewahrung für User-Sichtbarkeit (*„Diese 12 Änderungen wurden synchronisiert"*), dann lokal gelöscht - `failed`-Einträge mit attempt_count >= 5: User-Aufmerksamkeit erforderlich (Sync-Fehler-Liste) - `conflict`-Einträge: bleiben bis User-Resolution ### A.4 — Lokaler Cache (IndexedDB-Stores) **Read-Cache pro Tenant:** - `cache.assigned_projects` — heute zugewiesene Projekte (vorgeladen beim Login) - `cache.assigned_tasks` — heute fällige + offene Tasks - `cache.contacts` — Stammdaten (Kontakte mit Beziehung zu aktiven Projekten) - `cache.checklists` — Checklisten-Definitionen + aktueller Stand - `cache.acceptance_protocols` — Acceptance-Templates - `cache.user_profile` — eigenes User-Profil + Notification-Preferences - `cache.tenant_meta` — Tenant-Branding, Module-Verfügbarkeit, Permissions-Snapshot **Cache-Metadaten pro Store:** - `last_synced_at` - `etag` (für Server-side Diff-Sync) - `tenant_id` (für Multi-Tenant-Trennung) **Cache-Größenlimit:** soft-Limit 100 MB pro Tenant; hard-Limit 250 MB Total. Bei Überschreitung: ältester nicht-essentieller Cache wird verworfen. --- ## Block B — Build-Strategie und Code-Sharing ### B.1 — Ein Code-Base - **Web-App (RR7) ist Single Source of Truth.** Capacitor-Wrapper ist dünner Native-Container. - Web-App ist mobile-first responsive (PWA-fähig) - Capacitor packt die Web-App für iOS/Android mit nativem Hülle drumherum - Native-Plugins werden via Capacitor-API aufgerufen, abstrakte Wrapper im Web-Code (`@/services/native/...`) - Im Browser: Native-Wrapper geben `null` oder Polyfill zurück; im Capacitor-Container: echter Plugin-Aufruf ### B.2 — Build-Tooling - **Capacitor CLI** als primäres Build-Tool - Web-Build wird in Capacitor-Asset-Verzeichnis kopiert - iOS-Build: Xcode-basiert, Apple-Developer-Signing-Zertifikat - Android-Build: Android-Studio (oder Gradle-CLI), Signing-Keystore - Build-Konfiguration: - `capacitor.config.ts` (App-ID, App-Name, Web-Server-URL für Live-Reload im Dev, Plugins-Liste) - `Info.plist` (iOS: Permission-Strings für Kamera, Face-ID, Push) - `AndroidManifest.xml` (Android: Permissions, Intent-Filter für Deeplinks) - `PrivacyInfo.xcprivacy` (iOS: Privacy-Manifest — siehe Modul 35 Block I) ### B.3 — CI/CD - **Auto-Build bei Releases:** - Tag `mobile-vX.Y.Z` triggert Multi-Pipeline - Web-App-Build → Asset-Bundle - iOS-Pipeline: Build, Sign, TestFlight-Upload - Android-Pipeline: Build, Sign, Google-Play-Internal-Testing-Upload - **Web-only-Releases:** triggern keinen Native-Build, sondern nur Live-Update (siehe Block J) - **Versionierung:** - `app_version` (Native-Wrapper-Version, semantic versioning, im App-Store sichtbar) - `web_bundle_version` (Web-Code-Version, separat) - `min_supported_app_version` (Server-side gepflegt — bei zu alter App: Force-Update-Screen) ### B.4 — Lokal-Dev - Capacitor-CLI Live-Reload (Web-App läuft auf Dev-Server, Capacitor-Container lädt von dort) - Push-Notifications mit Test-Tools (APNs-Tester, FCM-Console) - Biometrie-Test im iOS-Simulator (Face-ID-Simulation) und Android-Emulator --- ## Block C — Native-Features (Pflicht) ### C.1 — Push-Notifications **Hintergrund:** Apple-Compliance (Guideline 4.2 — minimaler Native-Mehrwert) und kritischer UX-Bedarf (Monteur bekommt Task-Zuweisung sofort). **Anforderungen:** - Capacitor-Push-Plugin (`@capacitor/push-notifications` oder gleichwertig) - Beim Login auf Mobile-Device: - User-Pre-Prompt-Erklärung *„HiveGrid sendet dir Benachrichtigungen, wenn dir eine Aufgabe zugewiesen wird oder wichtige Updates passieren — möchtest du das aktivieren?"* mit Funktionen *„Ja, aktivieren"* und *„Später"* (Apple-Compliance LP-8: Pre-Prompt vor System-Dialog) - Bei *„Ja"*: nativer Permission-Dialog - Bei *„Erlaubt"*: Token holen, an `/api/v1/notifications/mobile-device` senden (siehe M22 Block H) - Push-Empfang: - App im Vordergrund: visualisiert in App (Toast oder In-App-Banner) - App im Hintergrund: OS-Notification-Center - Klick auf Push: Deeplink in App (siehe Block I) - Bei Permission-Denied: Klartext-Hinweis im `/settings/notifications/` (*„Push ist auf diesem Gerät deaktiviert. [Geräte-Einstellungen öffnen]"*) - iOS: Notification-Permission ist Pflicht-Permission ab iOS 13 (Apple-konform) - Android: ab API 33 ähnlicher Permission-Flow nötig - Versand-Pipeline: Server-Side, Modul 22 — Mobile-App ist nur Empfänger **Provider:** Novu (Modul 22 Block J, EU-Stack LP-13). ### C.2 — Face-ID / Touch-ID Login **Anforderungen:** - Capacitor-Plugin: `capacitor-biometric-auth` (oder gleichwertig — wrappt iOS `LocalAuthentication.framework` und Android `BiometricPrompt`) - **Setup-Flow** in `/{tenant}/settings/security/biometric/`: - Toggle *„Face-ID/Touch-ID-Login auf diesem Gerät aktivieren"* - Bei Aktivieren: User muss aktuelles Passwort eingeben → wird im OS-Keychain mit Biometrie-Schutz hinterlegt - Klartext-Hinweis: *„Beim nächsten Login auf diesem Gerät kannst du dich mit Face-ID statt Passwort anmelden. Funktioniert nur auf diesem Gerät."* - 2FA bleibt **trotzdem aktiv** (Biometrie ersetzt nur Passwort, nicht 2FA — siehe Modul 27 Block B.4) - **Login-Flow:** - App-Start: erkennt registriertes Biometrie-Login → Bietet *„Mit Face-ID anmelden"* an - Bei Erfolg: Auth-Secret aus OS-Keychain → reguläre Session-Erstellung wie Pwd-Login - Bei Biometrie-Fehler 3x in Folge: Fallback auf Passwort-Eingabe - Bei Biometrie-Lockout (OS-Level): Klartext-Hinweis + Fallback - **Deaktivieren:** - Toggle in Settings ausschalten → Auth-Secret aus Keychain löschen - Bei User-Logout (regulär): Biometrie-Token bleibt für nächsten Login (User-Convenience) - Bei User-Logout (forced — Pwd-Reset, 2FA-Reset etc.): Auch Biometrie-Token entfernt - **Pflicht-Strings:** - iOS `Info.plist`: `NSFaceIDUsageDescription` — Klartext: *„HiveGrid nutzt Face-ID für schnellen, sicheren Login auf deinem Gerät — dein Passwort bleibt nur in dir und im sicheren Apple-Speicher."* - Android: `useBiometric` Permission ### C.3 — Kamera (Foto-Upload) **Use-Cases:** - Foto-Upload für Acceptance-Protokoll (Modul 26) - Foto-Checklisten (Modul 4 / 26) - Profilbild-Upload (Modul 27) - Lead-Beleg-Foto (Modul 2) - Inbox-Anhang-Foto (Modul 9) **Anforderungen:** - Capacitor-Plugin: `@capacitor/camera` - Erst-Use-Permission-Pre-Prompt: *„HiveGrid braucht Zugriff auf deine Kamera, um Fotos für Acceptance-Protokolle und Checklisten aufzunehmen — möchtest du das erlauben?"* - Foto-Capture-Optionen: - Direkt aufnehmen (Camera) - Aus Galerie auswählen (Photo-Picker) - User-Wahl pro Use-Case oder kombiniert - Foto-Verarbeitung **lokal** vor Upload: - Resize (max. 2400x2400, JPEG-Qualität 85) - EXIF-Daten beibehalten (für Geo-Tag wenn aktiviert) — Phase 2 Geo - Optionale Komprimierung bei großen Dateien - Upload-Strategie: - Online: direkter Upload via `/api/v1/files/upload` (Modul 23) - Offline: Foto in Lokal-Storage, OfflineSyncQueue-Eintrag mit `binary_blob_ref` (siehe Block D) - Bei Permission-Denied: Klartext im UI (*„Kamera-Zugriff verweigert — bitte in den Geräte-Einstellungen erlauben."*) - Pflicht-Strings: - iOS `Info.plist`: `NSCameraUsageDescription`, `NSPhotoLibraryUsageDescription` - Android: `CAMERA`-Permission, `READ_MEDIA_IMAGES` (API 33+) --- ## Block D — Offline-Modus (Phase-1-Pflicht) > **User-Korrektur:** Offline-Modus ist DRINGEND in Phase 1, nicht Phase 2. Kritisch für Baustellen-Use-Case (Monteur ohne Empfang). ### D.1 — Architektur-Komponenten - **Service-Worker** (Workbox-basiert oder gleichwertig): - Cached statische Web-App-Assets (HTML/JS/CSS/Icons) - Offline-Fallback-Page bei Navigation auf nicht-gecachte Routen - Cache-First-Strategie für Static, Network-First für API-Calls (mit Cache-Fallback) - **IndexedDB** (via Dexie.js oder gleichwertige Abstraktion): - Read-Cache (siehe A.4) - OfflineSyncQueue (siehe A.3) - Binary-Storage für Fotos (Blob-Storage im IDB) - **Network-Status-Detection:** - Capacitor-Plugin `@capacitor/network` für native OS-Level-Erkennung - Browser-API `navigator.onLine` als Fallback - Reachability-Check (Server-Ping alle 30s im Online-Modus, alle 5s wenn unsicher) ### D.2 — Pre-Caching beim Login **Beim Login (online) wird vorgeladen:** - **Heutige Aufträge / Projekte** für eingeloggten User: - Alle Projekte, in denen User Member ist UND die heute aktiv sind (Status `active`, Schedule-Eintrag ≤ heute+1) - **Heute fällige Tasks** des Users - **Stammdaten:** - Kontakte (verknüpft mit aktiven Projekten) - Tenant-Branding, Permissions-Snapshot, User-Profil - **Acceptance-Templates** des Tenants - **Foto-Checklisten** für aktive Projekte **Pre-Cache-Klartext beim Login:** *„Lade Daten für offline-Nutzung — bitte einen Moment Geduld..."* mit Progress-Indikator (Anzahl geladener Entitäten / Gesamt). **User-Konfiguration:** in `/{tenant}/settings/mobile/` Toggle *„Daten für Offline-Nutzung vorladen"* (Default: an für Mobile-User, aus für Büro-User — Heuristik nach UI-Modus aus Modul 27). ### D.3 — Offline-Read **Was funktioniert offline:** - Anzeige der vorgeladenen Daten (Projekte, Tasks, Kontakte, Checklisten, Acceptance-Templates) - Navigation in App (alle Routen, die im Cache sind) - Anzeige von Fotos in Cache - Lesen eigener offline-erzeugter Einträge **Was nicht offline funktioniert:** - Suche über nicht-gecachte Daten (z.B. CRM-Vollsuche) — Klartext: *„Suche nicht verfügbar offline. Wieder verbunden? [Erneut versuchen]"* - Server-side-Renderings (Reports, KI-Antworten) - Email-Inbox (Phase 2 erweitert) - Chat-Real-Time (Read von gecachten Threads ja; senden geht in Queue) **Klartext-Indikator:** prominente Sichtbarkeit des Offline-Status in der App (z.B. Banner oder Status-Marker — Designer-Wahl, kein Layout-Vorschlag). ### D.4 — Offline-Write-Queue **Folgende Operationen können offline ausgeführt werden, landen in OfflineSyncQueue:** | Operation | Modul | `entity_type` | Konflikt-Strategie | |---|---|---|---| | Foto-Upload zu Acceptance | 26 | `photo` | Append-only, kein Konflikt | | Foto-Upload zu Projekt-Files | 23 | `photo` | Append-only | | Foto-Upload zu Task | 4 | `photo` | Append-only | | Note schreiben | div. | `note` | Append-only | | Task-Status ändern (Open → In Progress → Done) | 4 | `update` | Last-Write-Wins mit User-Sichtbarkeit | | Checklist-Item abhaken | 4/26 | `checklist_item` | Last-Write-Wins (selten Konflikt) | | Acceptance-Protokoll erstellen | 26 | `create` | Append-only | | Acceptance-Protokoll abschließen | 26 | `update` | Last-Write-Wins, mit Konflikt-Anzeige | | Activity erzeugen (manueller Eintrag) | 5 | `activity_create` | Append-only | | Termin-Status setzen (Erschienen/Nicht-Erschienen) | 6 | `update` | Last-Write-Wins | | Datei-Anhang | 23 | `file_upload` | Append-only | | Chat-Nachricht in Projekt-Channel | 13 | `create` | Append-only mit Reihenfolge-Garantie pro Author (siehe E.4) | **Was bewusst NICHT offline:** - Anlegen neuer Kontakte / Companies (CRM-Stammdaten — zu hohes Konflikt-Risiko) - Lead-Bearbeitung (Vertriebs-Use-Case ist online-zentriert) - Permissions-/User-Aktionen (Sicherheits-relevant) - Email-Send (Phase 2) - Booking-Bestätigungen (Phase 2) - Automation-Trigger (zu komplex für Phase 1) ### D.5 — Sync-Indikator UI **Benötigte UI-Elemente:** - Sichtbarer Badge mit Anzahl pending Queue-Einträge (z.B. *„3 Änderungen warten auf Upload"*) - Klick öffnet Queue-Übersicht mit: - Liste aller pending Einträge (entity_type, kurze Zusammenfassung, created_at) - Pro Eintrag: Status-Marker (`pending | syncing | failed | conflict`) - Bei `failed`: Klartext-Fehlermeldung + manueller Retry-Button - Bei `conflict`: Resolution-Funktion (siehe Block E) - Globaler Sync-Status (Online + Synced / Online + Syncing / Offline / Sync-Fehler) - Force-Sync-Funktion (User-getriggert) **Klartext:** - Online + Queue leer: *„Alle Änderungen synchronisiert"* - Online + Syncing: *„Synchronisiere 3 Änderungen..."* - Offline: *„Du bist offline. Deine Änderungen werden gespeichert und später hochgeladen."* - Sync-Fehler: *„2 Änderungen konnten nicht hochgeladen werden. [Details anzeigen]"* --- ## Block E — Sync-on-Reconnect ### E.1 — Trigger - Network-Status-Wechsel: `offline → online` (über Capacitor `@capacitor/network`) - App-Foreground-Resume (User öffnet App nach Hintergrund) - Manueller Force-Sync vom User - Periodisch alle 60s wenn online + Queue nicht leer - Beim regulären Login ### E.2 — Sync-Reihenfolge 1. **Read-Cache-Refresh** (etag-basiert): aktualisiere lokale Stores für aktive Module 2. **Write-Queue-Drain** in `created_at`-Reihenfolge: - Pro Queue-Eintrag: API-Call mit Idempotency-Key (lokale UUID) - Bei Erfolg: `synced_server_id` schreiben, Status `synced` - Bei Server-Fehler 5xx oder Timeout: Retry mit exponentiellem Backoff (max. 5 Versuche, dann `failed`) - Bei Server-Fehler 409 (Konflikt): Status `conflict`, User-Resolution erforderlich - Bei Server-Fehler 4xx (Validation, Permission etc.): Status `failed`, Klartext-Fehlermeldung 3. **Read-Cache-Refresh** post-Sync (eigene Änderungen sind jetzt server-side, lokaler Cache wird konsistent) ### E.3 — Konflikt-Strategien (zentral) **Append-only-Daten** (Fotos, Notes, neue Activities, neue Chat-Messages, Acceptance-Protokoll-Erstellung): - **Keine Konflikte möglich** (jeder Eintrag wird neu angelegt mit eigener UUID) - Eindeutigkeit garantiert durch Idempotency-Key (lokale UUID) - Bei Doppel-Sync (Network-Hick-Up): Server erkennt Idempotency-Key, antwortet mit existierendem Server-ID **Status/Felder-Updates** (Task-Status, Checklist-Items, Acceptance-Abschluss, Termin-Status): - **Last-Write-Wins** mit User-Sichtbarkeit - Bei Sync: Server vergleicht lokale `updated_at` mit Server-`updated_at` - Wenn Server-Stand neuer als lokale Basis → Konflikt-Marker setzen, lokale Änderung wird aber **trotzdem übernommen** (Last-Write-Wins) - User bekommt **eigene Konflikt-Resolution-Anzeige** (siehe E.4) mit Klartext: *„Es gab einen Konflikt — deine Änderung wurde übernommen, der vorherige Stand war: [Klartext]. [OK] [Vorherigen Stand wiederherstellen]"* - Audit-Trail dokumentiert beide Stände (siehe Modul 21 + 5) ### E.4 — Konflikt-Resolution-Anzeige (für seltene Konflikt-Fälle) **Benötigte UI-Elemente:** - Liste der Konflikte mit Anzahl-Indikator - Pro Konflikt: - Entity-Typ + Subject-Klartext (z.B. *„Aufgabe ‚Ventil tauschen' — Status"*) - Lokaler Stand (was wurde offline geändert) - Server-Stand (was wurde parallel von wem geändert) inkl. Actor + Timestamp - Auflösungs-Funktionen: *„Meinen Stand behalten"*, *„Server-Stand übernehmen"*, *„Manuell zusammenführen"* (Phase 2) **Default bei No-User-Action nach 7 Tagen:** Lokaler Stand bleibt (Last-Write-Wins-Default), Konflikt-Marker wird automatisch entfernt. **Chat-Message-Reihenfolge:** - Innerhalb gleichem Author: lokale Reihenfolge bleibt (created_at-Order) - Cross-Author: Server-Reihenfolge nach Server-Ankunft (kein Konflikt-Recovery — Chat ist append-only) ### E.5 — Edge-Cases - **Sync läuft, App wird geschlossen:** Sync wird beim nächsten App-Start fortgesetzt (Status `syncing` → `pending` Reset) - **Sync-Token expired during long offline:** Auth-Refresh nötig vor Sync-Drain; bei Refresh-Fehlschlag → Re-Login erforderlich, Queue bleibt erhalten bis Login - **Tenant-Wechsel während Queue nicht leer:** Klartext-Warnung *„3 Änderungen für Tenant X warten noch — bitte erst synchronisieren oder bewusst verwerfen."* - **App-Update während Offline-Queue nicht leer:** Queue-Schema bleibt rückwärts-kompatibel; Migration falls nötig (Phase 2: konkrete Migrations-Strategie) - **Permission-Wechsel server-side während Offline:** lokale Aktion wird beim Sync abgelehnt mit 403 → Klartext im Failed-Eintrag (*„Du hast keine Berechtigung mehr für diese Aktion. [Eintrag verwerfen]"*) ### E.6 — Storage-Limits + Cleanup - Lokale Queue: max. 1.000 Einträge — danach Klartext *„Lokale Warteschlange voll — bitte mit Internet verbinden, um zu synchronisieren."* - Binary-Storage (Fotos): max. 500 MB lokal — bei Überschreitung Klartext, blockiert weiteren Upload bis Sync - Sync-Erfolg: lokale Foto-Datei nach erfolgreichem Server-Empfang lokal gelöscht (Cache wird Server-Pfad) --- ## Block F — Apple-Compliance ### F.1 — Pricing/Upgrade-UI strikt verboten **Konkrete Verbote in der App** (LP-8, Apple Guideline 3.1.3(c) Enterprise-Services-Ausnahme): - **Keine** Pricing-Page - **Keine** *„Upgrade auf Cloud+"-* oder *„Auf Pro wechseln"-Buttons* - **Keine** Links auf `hivegrid.de/pricing`, `app.hivegrid.de/admin/billing` etc. (Subscription-Self-Service nur via Web-Browser auf Desktop) - **Keine** Modals mit Klartext *„Diese Funktion ist im Cloud+-Plan verfügbar — jetzt upgraden"* **Stattdessen:** Klartext bei Feature-Gate-Block in der App: *„Diese Funktion ist im Cloud+-Plan verfügbar. Bitte deinen Workspace-Admin kontaktieren oder hivegrid.de besuchen."* — **kein** Klick-Link. **Tenant-Subscription-Status anzeigen** ist erlaubt (read-only Information): - Status-Badge (Trial / Active / Frozen) — ohne Action - Trial-Verbleibend-Text — ohne CTA-Button **Implementierung:** In M28-Subscription-Modul gibt es einen Build-Flag `IS_MOBILE_APP=true` der alle Pricing-/Upgrade-UI ausblendet (vom Capacitor-Wrapper gesetzt). ### F.2 — Sign-in-with-Apple-Umgehung **Strategie:** Login-only-Framing als „Enterprise SSO". - Login-Screen-Text: *„Mit deinem HiveGrid-Firma-Account anmelden"* (Klartext positioniert als Enterprise-Login) - App-Store-Listing: Kategorie *„Business"* mit Beschreibung als *„Enterprise-CRM für Handwerk"* - App-Review-Notes: Klartext *„This is an enterprise B2B CRM application. Authentication is exclusively via the customer organization's account, per Guideline 4.8 enterprise/business apps exception."* - **Phase 1 nur Email/Pwd + Magic-Link** (umgeht SIWA-Trigger automatisch — siehe Modul 27 B.1, B.2) - **Microsoft-OAuth ist Phase 2 backloggt** (siehe Modul 27 B.3) — wenn implementiert: als „Enterprise SSO" in App-Login-Screen klar gekennzeichnet, **kein** generisches Drittanbieter-Login **Falls Reviewer SIWA-Pflicht durchsetzt** (Reject-Risiko): - Fallback-Implementation: SIWA als zusätzliche Login-Option vorbereitet (~1 Tag Aufwand) — in Phase 1 nicht aktiv, kann bei Reject schnell eingebaut werden ### F.3 — Reviewer-Demo-Account **Pflicht für App-Submit (40% aller Rejects sind „Reviewer kommt nicht rein").** - Dedizierter Tenant `apple-review` mit Mitarbeiter-Account - Beispieldaten: 5-10 Kontakte, 2-3 aktive Projekte, ein paar Tasks, Beispiel-Acceptance-Protokoll - Demo-Permissions: Vertriebler-Rolle (deckt die meisten Funktionen ab) - Login-Credentials in App-Review-Notes: - Tenant: `apple-review` - Email: `reviewer@hivegrid.de` - Pwd: stabiles Test-Pwd (rotiert nicht zu oft, Audit-Eintrag bei Login) - Demo-Account ist **read-only-write** für Reviewer (nicht öffentlich exponiert) - Plattform-Admin pflegt den Demo-Tenant in Modul 37 - Klartext-Hinweis in App-Review-Notes: *„Test credentials provided. The app is a B2B SaaS CRM — login required by enterprise organization. Test data is in the apple-review tenant."* ### F.4 — Privacy-Manifest **Verweis auf Modul 35 Block I — Implementations-Detail liegt in Modul 36:** - `PrivacyInfo.xcprivacy` wird bei jedem Native-Build aus Master-Liste (Modul 37) generiert - Pflicht-Inhalt: - Datentypen: User-Account-Info (Email, Name), User-Content (Notes, Photos, Activities), Identifiers (Device-Token, User-ID), Diagnostics (Crash-Logs, Performance), Usage-Data (Feature-Usage) - Tracking-Domains: keine Drittanbieter-Tracker in Phase 1 (LP-13 EU-Stack) - Required-Reason-APIs: `UserDefaults` (für lokale Settings), `FileTimestamp` (für Sync-Logik), `SystemBootTime` (Phase 2 falls genutzt) - Klartext-Beschreibungen pro Datentyp im Apple-Format **Android Data-Safety-Form:** analog für Google Play Console. ### F.5 — Account-Löschung in der App (Apple-Pflicht 2022) **Verweis Modul 35 Block E + Modul 27 D.3** — komplette Spec dort. Mobile-App-spezifische Anforderungen: - Settings-Route `/{tenant}/settings/account/delete` ist in Mobile-App **identisch** sichtbar wie im Web (gleicher Code-Pfad) - Multi-Step-Bestätigung funktioniert in der Mobile-App vollständig (keine Web-Redirect-Workarounds) - Bei Löschung in Mobile-App: - Lokale Daten werden komplett gelöscht (IndexedDB-Stores leeren, OS-Keychain-Einträge entfernen, Push-Token revoken via M22) - Biometrie-Login deaktiviert - App startet mit leerem Login-Screen - Apple-Compliance-Check: Settings-Screen mit *„Konto löschen"* auf gleicher Ebene wie *„Profil"* sichtbar (Apple-Strenge: Reviewer prüft Sichtbarkeit) --- ## Block G — Account-Löschung in der App (Verweis M35) Siehe F.5. Vollständige Spec in Modul 35 Block E und Modul 27 Block D.3. Mobile-spezifisch: - Pre-Lösch-Optional: User-Daten-Export anbieten (Modul 35 Block C) — auf Mobile kann ZIP zu groß sein, Klartext: *„Export wird per Email an dich gesendet — Download bitte am Computer."* - Lokal-Cleanup nach Lösch-Bestätigung (siehe oben) --- ## Block H — Permissions ### H.1 — App-Level (OS-Permissions, nicht Tenant-Permissions) | Permission | Wann gefragt | Klartext (Pre-Prompt) | |---|---|---| | Push-Notifications | beim Onboarding (nach erstem Login) | *„HiveGrid sendet dir Benachrichtigungen, wenn dir eine Aufgabe zugewiesen wird oder wichtige Updates passieren."* | | Kamera | beim ersten Foto-Use (Acceptance, Checklist, Profil) | *„HiveGrid braucht Zugriff auf deine Kamera, um Fotos für Acceptance-Protokolle und Checklisten aufzunehmen."* | | Photo-Library | beim ersten Galerie-Pick | *„HiveGrid braucht Zugriff auf deine Galerie, um vorhandene Fotos auszuwählen."* | | Face-ID / Touch-ID | beim Aktivieren in Settings | *„HiveGrid nutzt Face-ID für schnellen, sicheren Login auf deinem Gerät."* | | Geolocation | **Phase 2** (für Einsatzort-Erkennung) | nicht in Phase 1 | | Bluetooth | **Phase 2** (Beacon-basierter Standort) | nicht in Phase 1 | | NFC | **Phase 2** (Zeiterfassung) | nicht in Phase 1 | | Mikrofon | **nicht in Phase 1** | — | **Konvention bei Permission-Denied:** - Klartext-Hinweis im UI mit Funktion *„Geräte-Einstellungen öffnen"* (öffnet OS-Settings via Capacitor `@capacitor/app`) - App bleibt funktional ohne diese Permission (Graceful Degradation) - Bei kritischer Funktion (z.B. Foto-Pflicht in Acceptance): Klartext-Block + Settings-Link ### H.2 — Tenant-Permissions in der App - App nutzt **identisches** Permission-System wie Web (Modul 27 Block C) - Permission-Snapshot wird beim Login geladen und im IndexedDB-Cache abgelegt (siehe A.4) - Routen-Schutz funktioniert offline auf Basis des Snapshots (Klartext bei Permission-Mismatch nach Sync) - UI-Modus aus Modul 27 C.2 wird respektiert: Mobile-App default `Baustelle`-Modus (auf Smartphone), `Büro`-Modus auf Tablet möglich (User-Override) --- ## Block I — Routes / Tiefen-Verlinkung (Deeplinks) ### I.1 — Universal Links (iOS) / App Links (Android) - Domain `app.hivegrid.de` ist als Universal-Link / App-Link registriert - Apple `apple-app-site-association` File auf `hivegrid.de/.well-known/` - Android Asset-Links File analog - Push-Klick mit `deeplink`-URL öffnet App auf Ziel-Route (statt Browser) ### I.2 — Deeplink-Schemas - `hivegrid://` als Custom-URL-Scheme (Fallback) - `https://app.hivegrid.de/{tenant}/...` (Universal Link, Default) ### I.3 — Deeplink-Routing-Anforderungen - App parst eingehenden Deeplink, prüft Auth-Status - Bei kein Login: parkt Deeplink, zeigt Login → nach Login navigiert auf Deeplink-Ziel - Bei Login + falscher Tenant: Tenant-Switch-Prompt (*„Diese Notification gehört zu Tenant ‚X' — wechseln?"*) - Bei Permission-Mismatch (User darf Ziel nicht sehen): Klartext + Fallback auf Tenant-Dashboard ### I.4 — Mobile-spezifische Routen-Anpassungen Web-App-Routen funktionieren in der Mobile-App identisch (LP-2 mobile-first responsive). Mobile-spezifische Sub-Routen: - `/{tenant}/settings/security/biometric/` — Biometric-Setup (existiert auch im Web, dort aber kein-op auf Desktop) - `/{tenant}/settings/mobile/` — Mobile-spezifische Settings (Pre-Cache-Toggle, Sync-Verhalten, Storage-Übersicht) - `/{tenant}/settings/mobile/storage/` — lokaler Storage-Verbrauch + Reset-Funktion - `/{tenant}/settings/mobile/queue/` — Sync-Queue-Übersicht (siehe D.5) ### I.5 — Tab-Bar / Native-Navigation (Apple-Compliance) **Apple-Guideline 4.2 verlangt native Navigations-Elemente** (kein reines Hamburger-Menü). **Anforderungen:** - Native-Tab-Bar im Capacitor-Wrapper für die wichtigsten Top-Level-Funktionen - Tab-Konfiguration abhängig vom UI-Modus: - **Baustelle-Modus** (Default Mobile): Heutige Aufträge / Projekte / Tasks / Chat / Mehr - **Büro-Modus**: Dashboard / CRM / Pipeline / Inbox / Mehr - Tab-Bar wird vom Web-Code via Capacitor-API gesteuert (kein echtes Native) - Hamburger-Menü als Sekundär-Navigation (für selten genutzte Funktionen) erlaubt --- ## Block J — Update-Mechanik ### J.1 — Web-Code-Live-Update **Phase 1: Web-Bundle wird als statisches Asset aus Capacitor-Container geladen.** - App-Start prüft Server-Version (`/api/v1/mobile/version-check`) - Bei neuer Web-Bundle-Version: Download im Hintergrund, Klartext-Hinweis *„Update verfügbar — beim nächsten App-Start aktiviert"* - Beim nächsten Cold-Start: neues Bundle wird geladen (Atomic-Swap, kein User-Disruption) - **Kein** Capacitor Live Updates in Phase 1 (Phase 2: ggf. CodePush-ähnliche Lösung) - Server-Endpoint mit `min_supported_app_version`: bei zu alter Wrapper-Version → Force-Update-Screen mit App-Store-Link ### J.2 — Native-Wrapper-Updates - Regulär über App-Stores (TestFlight für Beta, Production via App Store / Google Play) - Wrapper-Updates sind selten (nur bei Native-Plugin-Änderungen, OS-Compatibility, Privacy-Manifest-Updates) - Frequenz: 1-2 Native-Releases pro Quartal Default; Web-Bundle-Updates beliebig häufig - Bei Native-Plugin-Änderung mit API-Bruch: Wrapper-Version-Bump nötig + Web-Code-Compat-Check ### J.3 — Force-Update-Logik **Trigger:** - Web-Bundle inkompatibel mit Wrapper-Version (server-side `min_supported_app_version`) - Sicherheits-kritisches Update (Plattform-Admin-getriggert) - iOS/Android-OS-Mindestversion erhöht **UX:** - Modal-Screen ohne Schließen-Funktion: *„Bitte aktualisiere die HiveGrid-App — diese Version wird nicht mehr unterstützt. [App-Store öffnen]"* - Klartext: *„Grund: [Sicherheits-Update | Neue Funktionen | OS-Kompatibilität]"* --- ## Block K — Submission-Strategie ### K.1 — Reihenfolge: Google Play zuerst, dann Apple **Begründung:** niedrigere Hürde bei Google Play, schnellerer Feedback-Loop, geringere Reject-Risk. **Phasen:** 1. **Google Play Internal Testing** (sofort, max. 100 Tester ohne Review) 2. **Google Play Closed Testing** (mit Review, ~Tage) 3. **Google Play Production** (mit Review, ~Tage) 4. **Apple TestFlight Internal** (sofort, 100 Tester) 5. **Apple TestFlight External** (mit Review, ~1-2 Tage) 6. **Apple App Store Production** (mit Review, mehrere Tage) ### K.2 — Pre-Submission-Checkliste **Vor Apple-Submit:** - App-Review-Notes mit Demo-Account-Credentials (siehe F.3) - Privacy-Policy-URL gesetzt (`hivegrid.de/privacy`) - Privacy-Manifest aktuell (siehe F.4) - Account-Löschung sichtbar getestet (Reviewer prüft das aktiv) - Keine Pricing-/Upgrade-UI im Build (Build-Flag `IS_MOBILE_APP=true` aktiv) - Native-Features funktional getestet (Push, Face-ID, Kamera) — Reviewer testet das - App-Icons + Splash-Screens für alle Device-Größen - Screenshots zeigen ausschließlich Funktionen, die in der App tatsächlich da sind (Guideline 2.3) **Vor Google-Play-Submit:** - Data-Safety-Form ausgefüllt - Account-Löschung in App + externe Lösch-URL als Backup - Privacy-Policy-URL - Permissions-Erklärungen klar ### K.3 — Reject-Recovery **Bei Apple-Reject:** - Klartext-Antwort des Reviewers analysieren - Im Brainstorming dokumentierte Strategien: - 4.2 (Minimum-Functionality): Native-Feature-Liste vorzeigen, Demo-Video - 3.1.1 (IAP): kein Pricing-UI nachweisen, ggf. Build mit zusätzlichen Pricing-Hidden-Toggles - 4.8 (SIWA): SIWA als Backup-Implementation aktivieren (~1 Tag) - 5.1.1 (Account-Löschung): sichtbarer Pfad zeigen - 2.1 (kann nicht einloggen): Demo-Account neu setzen, Klartext in Notes - Re-Submit mit erweiterten Klartext-Notes --- ## Block L — Klartext-Hinweise / -Fehler **Push:** - Permission verweigert: *„Push ist auf diesem Gerät deaktiviert. Du verpasst möglicherweise wichtige Updates. [Geräte-Einstellungen]"* - Token-Registrierung fehlgeschlagen: *„Push-Setup fehlgeschlagen — bitte App neu starten oder Support kontaktieren."* **Biometrie:** - Face-ID-Fehler: *„Face-ID nicht erkannt — bitte erneut versuchen oder Passwort eingeben."* - 3x Fehlschlag: *„Face-ID temporär gesperrt. Bitte mit Passwort anmelden."* - Hardware nicht verfügbar: *„Dieses Gerät unterstützt kein Face-ID/Touch-ID."* - Hardware vorhanden, nicht eingerichtet: *„Bitte zuerst Face-ID in den Geräte-Einstellungen einrichten."* **Kamera:** - Permission verweigert: *„Kamera-Zugriff verweigert. [Geräte-Einstellungen öffnen]"* - Storage voll: *„Lokaler Speicher voll — bitte Sync starten oder lokalen Cache leeren."* **Offline:** - Banner offline: *„Du bist offline — gespeicherte Änderungen werden später hochgeladen."* - Sync-Erfolg: *„Alle 7 Änderungen wurden synchronisiert."* - Sync-Fehler: *„2 Änderungen konnten nicht hochgeladen werden. [Details]"* - Konflikt: *„Es gab einen Konflikt — deine Änderung wurde übernommen, der vorherige Stand ist noch sichtbar. [Anzeigen]"* - Queue voll: *„Lokale Warteschlange voll (1.000 Einträge) — bitte mit Internet verbinden."* - Storage voll (Fotos): *„Foto-Speicher voll (500 MB) — bitte Sync starten oder Fotos später aufnehmen."* **Pre-Cache:** - Beim Login: *„Lade Daten für offline-Nutzung — bitte einen Moment Geduld..."* - Bei Fehler: *„Pre-Caching fehlgeschlagen — App funktioniert online normal, offline möglicherweise eingeschränkt."* **Update:** - Update verfügbar (Web-Bundle): *„Ein Update wurde geladen — beim nächsten App-Start aktiv."* - Force-Update (Wrapper): *„Bitte aktualisiere die HiveGrid-App — diese Version wird nicht mehr unterstützt. [App-Store]"* **Tenant-Wechsel mit Queue:** - *„3 Änderungen für Tenant ‚Geerkens GmbH' warten noch auf Upload — bitte erst synchronisieren."* **Permission-Mismatch nach Sync:** - *„Du hast inzwischen keine Berechtigung mehr für diese Aktion. Eintrag wurde verworfen."* **Apple-Compliance-Boundary (Pricing):** - Bei Feature-Block in App: *„Diese Funktion ist im Cloud+-Plan verfügbar. Bitte Workspace-Admin kontaktieren oder am Computer aktivieren."* (kein Klick-Link) --- ## Block M — Permissions-Anwendung ### M.1 — Permission-IDs | Permission | Erlaubt | |---|---| | (Self-Scope) | Eigene Mobile-Settings, Biometrie-Setup, Sync-Queue, Push-Devices — kein Permission-Bundle nötig | | `mobile.admin` | Mobile-spezifische Tenant-Settings (z.B. Pre-Cache-Default für Tenant, Force-Update-Trigger pro Tenant) — Phase 2 | ### M.2 — Bundle-Mapping (Variante 2) | Bundle | Atomare Permissions | |---|---| | `mobile.user` (jeder User implizit) | Self-Scope-Mobile-Funktionen | | `mobile.admin` (Phase 2) | `mobile.admin` | ### M.3 — Anwendung in Routes - `/{tenant}/settings/security/biometric/` → eingeloggter User - `/{tenant}/settings/mobile/*` → eingeloggter User - `/api/v1/notifications/mobile-device` → eingeloggter User (Self-Scope) - `/api/v1/mobile/version-check` → public (Auth optional, App-Version-Check ohne Login) ### M.4 — App-Level-Permission-Snapshot - Beim Login: Permission-Set des Users in IndexedDB-Cache `cache.tenant_meta` - Bei Permission-Wechsel server-side: nächster Sync-Trigger lädt aktualisiertes Set - Routen-Schutz offline: lokal anhand Cache; bei Mismatch nach Sync → Klartext + Fallback --- ## Block N — Phase 2 / spätere Features - **NFC** für Zeiterfassung (Tap-to-Clock-In) - **Bluetooth** für Beacon-basierte Standort-Erkennung (Baustellen-Auto-Check-In) - **Geolocation** mit User-Consent für Einsatzort-Auto-Tagging - **CodePush / Capacitor Live Updates** für Web-Code-Live-Updates ohne App-Store-Roundtrip - **CRDT-basierte Konflikte** für Multi-User-Co-Editing (z.B. gemeinsames Acceptance-Protokoll) - **Erweiterte Offline-Funktionen:** - Komplette Tenant-Daten lokal indexierbar (CRM-Offline-Suche) - Offline-Email-Lesen (Inbox-Cache) - Offline-Booking-Bestätigungen - Offline-Lead-Bearbeitung - **Silent-Push-Capability** für Hintergrund-Sync (Modul 22 Phase 2) - **Browser-Push-Channel** als 4. Notification-Kanal für Web-Nutzer ohne Mobile-App - **Watch-App-Companion** (Apple Watch / Wear OS) für Quick-Actions - **Mikrofon-Permission** für Voice-Notes / Diktier-Funktion - **Tablet-spezifische UI-Optimierung** (Side-by-Side-Layout im Büro-Modus) - **Dark-Mode-Native-Sync** (Phase 1 nutzt Web-Theme; Phase 2 native OS-Theme-Detection) - **Cross-Device-Read-Sync** für Notifications (M22 Phase 2) - **Subprocessor-Disclosure** im App-Onboarding (M35 Block H) - **Tenant-Admin-konfigurierbare Pre-Cache-Strategien** (welche Daten pro Rolle vorgeladen werden) - **App-Store-In-App-Rating-Prompt** an strategischen Stellen (z.B. nach erfolgreichem Acceptance-Abschluss) - **App-Onboarding-Tour** für Neu-Installs (Native-Tutorial-Screens) --- ## Block O — Architektur-Vorschriften (Querschnitt) - **LP-2 — Mobile-First-Responsive:** Web-App ist primär; Mobile-App ist Native-Wrapper - **LP-8 — App-Store-Strategie:** Capacitor + 3 Native-Features (Push, Face-ID, Kamera); strikt kein Pricing/Upsell in der App; Account-Löschung in App; Privacy-Manifest; Reviewer-Demo-Account; Login-only-Framing - **LP-9 — Spec-Tiefe:** keine UI-Layouts; Anforderungen-pur - **LP-10 — Klartext-Diagnostik:** alle Push-/Sync-/Permission-Fehler mit menschenlesbarem Text + Lösungs-Hinweis (Block L) - **LP-12 — i18n:** Klartext-Strings aus Locale-Files (Phase 1 nur DE) - **LP-13 — EU-Stack:** Push-Provider Novu auf Scaleway; APNs/FCM unausweichlich aber nur Token + minimaler Payload (kein PII-Datenleck) - **AV #1, LP-10:** Klartext überall - **AV #5 — Self-Scope-Default:** User sieht nur eigene Devices, eigene Queue, eigene Biometrie-Settings - **AV #6 — Audit-Trail:** Mobile-spezifische Aktionen (Biometrie-Setup, Account-Löschung, Sync-Konflikt-Resolution) werden geloggt - **AV #16 — Rate-Limiting:** Sync-Endpoints rate-limited (gegen Loop bei kaputtem Client) - **AV #20 — KI-Action-Boundary:** keine KI-Aktionen ohne User-Bestätigung in der App --- ## Detail-Spec-Status: DRAFT Erste vollständige Detail-Spec für Modul 36. **Vor Bau:** Verifizierung mit Noah (gemeinsam mit Pflichtenheft-Sweep), Cross-Check mit Modul 22 (Push-Token-Flow), Modul 27 (Biometrie + Session), Modul 35 (Account-Löschung + Privacy-Manifest), Modul 28 (Subscription-UI-Hide-Flag). **Offene Detail-Punkte (nicht-blockierend, beim Bau zu klären):** - Konkrete Capacitor-Plugin-Auswahl (`@capacitor/push-notifications` vs. Novu-eigenes SDK; `capacitor-biometric-auth` vs. Alternativen) - Privacy-Manifest konkrete Apple-API-Reasons (mit Apple-Doku-Cross-Check beim Bau) - IndexedDB-Library: Dexie.js (default) vs. native IDB-API (Implementierungs-Detail) - Service-Worker-Strategie: Workbox vs. custom (Performance-Trade-off, Build-Komplexität) - Konkretes Schema der Idempotency-Keys serverseitig (mit allen Producer-Modulen abgleichen) - Foto-Komprimierungs-Default (Quality 85 / max-Dim 2400 sind Heuristik — beim Bau mit Real-User-Tests validieren) - Pre-Cache-Größenlimits (100 MB / 250 MB / 500 MB Foto) sind Heuristik; mit Geerkens-Use-Case validieren - Tab-Bar-Konfiguration pro UI-Modus konkret festlegen (mit Subframe-Designs) - Apple-App-Review-Notes-Text-Vorlage (rechtlicher Final-Slug mit Anwalt validieren) - Re-Submit-Strategy bei spezifischen Reject-Grounds (Playbook beim Bau dokumentieren) **Abhängige Module:** - Modul 22 (Notifications) — Push-Token-Registrierung, NotificationDevice-Entity, Push-Versand-Pipeline - Modul 27 (Auth/Multi-Tenancy) — Email/Pwd + Magic-Link-Login, Session-Management, Permissions, Account-Löschung Block D.3 - Modul 35 (DSGVO/Privacy) — Privacy-Manifest, Account-Löschung-Konsolidierung, Subprozessoren-Liste - Modul 28 (Subscription) — `IS_MOBILE_APP=true`-Build-Flag zur Pricing-UI-Ausblendung - Modul 21 (Audit-Log) — Mobile-spezifische Audit-Einträge - Modul 23 (Files) — Foto-Upload, Storage-Pfad-Konvention - Modul 26 (Acceptance) — Foto-Pflicht für Acceptance-Protokoll - Modul 4 (Tasks) — Task-Status-Update offline - Modul 13 (Chat) — Chat-Nachrichten offline-fähig - Modul 30 (i18n) — Klartext-Strings für Mobile-spezifische Hinweise - Modul 31 (Branding) — App-Icons, Splash-Screens, Tenant-Branding (Phase 2 dynamisch) - Modul 37 (Plattform-Admin) — Privacy-Manifest-Master-Liste, Demo-Account-Pflege, `min_supported_app_version`-Steuerung