--- kind: screen project: HiveGrid Screen Project ticket: D-P5 package: WF-P5 Integrationen id: M02 screen: Assistent API-Schluessel typ: Modal/Wizard umsetzung: Bauen status: Validiert route: "aus S02, Verbinden" subframe: "" --- # M02 — Assistent (API-Schlüssel-Weg) ## Ziel Dienst per kopiertem Schlüssel verbinden (z. B. KWP, Dienste ohne OAuth). ## Pattern / Archetyp A5 mehrstufiger Wizard — gleiche Schritte wie [[M01 Assistent OAuth]], nur der Zugangsdaten-Schritt unterscheidet sich. ## Schritte 1. **Voraussetzungen** — Klartext inkl. »wo finde ich den Schlüssel« (Kurz-Anleitung je App) 2. **Zugangsdaten** — Namens-Label + **auto-generiertes Formular** aus dem App-Schema (Text-/Schlüssel-/Geheimnis-Felder mit Anzeigen-Toggle) 3. **Verbindungs-Test** — automatisch, ✓/✗ mit Klartext 4. **Erster Abgleich** (optional) ## Meldungsentscheidung | Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz | |---|---|---|---|---| | Pflichtfeld leer / Format falsch | Inline-Validierung | ja (Feld) | Nur dokumentieren | — | | Verbindungs-Test fehlgeschlagen | Schritt-Fehler + zurück | ja (Schritt) | Nur dokumentieren | »Schlüssel prüfen« | ## Subframe - (erst nach explizitem OK) ## Notizen - Das Formular kommt aus dem `connection_schema` der jeweiligen App — wir designen die Feld-Typen, nicht die konkreten Felder.