# Plan: Siri / App Intents – „Besuch dokumentieren" (freihändig)

Stand: 2026-08-07 · Status: **Entwurf zur Freigabe** · kein Code

## Ziel
Die PoC-Thesis ist Effektivität **im Auto**. Fehlt: freihändiger Einstieg. Mit einem App Intent
startet der AD die Doku **ohne Hinsehen/Tippen** per Sprache:
> „Hey Siri, Besuch dokumentieren" → App öffnet (und startet) die Dokumentation für den relevanten Besuch.

Kein CarPlay: dessen Entitlements sind von Apple auf bestimmte Kategorien beschränkt und für einen
generischen Business-PoC praktisch nicht verfügbar. App Intents brauchen **keine** Sonderfreigabe.

## Umfang (PoC)
- **Intent 1 – „Besuch dokumentieren"** (`AppIntent`): wählt den relevanten Besuch (Logik unten) und
  navigiert in den Doku-Flow (`Route.conversation(visit, mode:"dokumentation")`), idealerweise startet
  das Gespräch direkt.
- **Intent 2 (optional) – „Nächsten Besuch vorlesen"**: liest Kunde + Uhrzeit + offene Punkte vor
  (nutzt das bestehende Briefing/`preparation`). Rein sprachlich, ohne UI-Sprung.
- **App Shortcuts** (`AppShortcutsProvider`): feste deutsche Phrasen, damit es ohne manuelles Einrichten
  sofort per „Hey Siri …" funktioniert. Zusätzlich in der Shortcuts-App sichtbar.

## „Welcher Besuch?" – Auswahllogik
1. **Laufender/gerade beendeter Termin:** Besuch, dessen Zeitfenster jetzt/eben war und der noch
   `bericht_status == "keiner"` hat → wahrscheinlichster Doku-Kandidat.
2. Sonst der **letzte vergangene** heutige Besuch ohne Bericht.
3. Sonst **Rückfrage** (Siri-Disambiguation): „Für welchen Kunden?" → Liste heutiger Besuche.
Parameterisierbarer Intent: optionaler `kunde`-Parameter erlaubt „… Besuch bei Bauzentrum Nord dokumentieren".

## Technische Voraussetzungen
1. **AppIntents-Framework** einbinden (der Build meldet aktuell „No AppIntents.framework dependency found").
2. **Intent + AppShortcutsProvider** als neue Dateien (z. B. `App/Intents/`). Deutsche Phrasen +
   `NSUserActivity`/`openAppWhenRun`.
3. **Deep-Link/Navigation aus dem Intent:** analog zu den Notification-Deep-Links – der Intent setzt ein
   „pending Ziel", das der App-Root (`Navigator`/`Route`) beim Aktivwerden abarbeitet. Wiederverwendbar mit
   dem bestehenden `NotoDeepLink`-Muster (ggf. gemeinsames „PendingDeepLink" im Root).
4. **Datenzugriff im Intent:** Besuche laden (HTTP) oder auf den laufenden App-Zustand zugreifen. Für den
   Kaltstart: leichter Fetch wie beim Background-Refresh.
5. **Freihändig starten:** Siri kann die App in den Vordergrund holen; echtes „ohne Entsperren komplett per
   Stimme dokumentieren" ist eingeschränkt (Doku braucht Mikrofon-Session im Vordergrund) → realistisch:
   Siri **öffnet** den Doku-Screen, das Gespräch startet automatisch.

## Schritte (mit Verifikation)
1. AppIntents einbinden + „Besuch dokumentieren"-Intent (öffnet Doku für Kandidat).
   → *verify (Elmar, visuell):* „Hey Siri, Besuch dokumentieren" öffnet den richtigen Doku-Screen.
2. AppShortcutsProvider (deutsche Phrasen) + Disambiguation bei Mehrdeutigkeit.
   → *verify:* Phrase ohne Einrichtung nutzbar; Rückfrage bei mehreren Kandidaten.
3. Optional Intent 2 („Nächsten Besuch vorlesen").
   → *verify:* Siri liest Kunde/Uhrzeit/offene Punkte vor.

## Offene Entscheidungen
- **A.** Nur Intent 1 (dokumentieren) – oder auch Intent 2 (vorlesen)?
- **B.** Soll Siri das Gespräch **direkt starten** oder nur den Doku-Screen öffnen (Nutzer tippt „Start")?
- **C.** Kandidaten-Logik: reicht „letzter heutiger Besuch ohne Bericht", oder immer Rückfrage?