Plan Querschnitt-Pakete P3-P5 und Infrastruktur-Entscheidungen

- Feature Map: Regelwerk, Kanten-System, Paket-Canvas-Verknuepfungen, MD-Links
- Infrastruktur & Navigation: Sidebar-Abgleich, Einstellungen-Modell, Mobile, Gating
- WF-P3 Benachrichtigungen + Audit Log (validiert)
- WF-P4 Aufgaben (inkl. Topbar-Drawer-Delta) + Dateien (inkl. Teilen v1, CR an Dev)
- WF-P5 Integrationen (Sync-Verlauf als eigene Seiten)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
davidandClaude Fable 5 committed 2026-07-08 20:47:46 +02:00
1 parent 1363933387
commit e48a5a46e8
38 files changed
+3147 -732

No files matched your search

@@ -0,0 +1,41 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P5
package: WF-P5 Integrationen
id: M01
screen: Assistent OAuth
typ: Modal/Wizard
umsetzung: Bauen
status: Validiert
route: "aus S02, Verbinden"
subframe: ""
---
# M01 — Assistent (OAuth-Weg)
## Ziel
Dienst per »Bei … anmelden«-Knopf verbinden — der bequeme Weg (z. B. Google, AirCall).
## Pattern / Archetyp
A5 mehrstufiger Wizard mit Fortschritts-Anzeige (echtes Modal: DialogLayout → Dialog → Dialog.Content).
## Schritte
1. **Voraussetzungen** — Klartext: was man braucht, was passiert
2. **Anmelden** — Namens-Label vergeben + »Bei [Dienst] anmelden«-Knopf → externe Weiterleitung → zurück
3. **Verbindungs-Test** — automatisch, mit ✓/✗ und Klartext
4. **Erster Abgleich** (optional) — jetzt starten oder später
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Anmeldung abgebrochen/fehlgeschlagen | Schritt-Fehler + erneut versuchen | ja (Schritt) | Nur dokumentieren | Klartext-Grund |
| Verbindungs-Test fehlgeschlagen | Schritt-Fehler + zurück | ja (Schritt) | Nur dokumentieren | Lösungs-Hinweis |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,45 @@
---
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.
@@ -0,0 +1,43 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P5
package: WF-P5 Integrationen
id: M03
screen: Trennen-Bestaetigung
typ: Modal (mehrstufig)
umsetzung: Bauen
status: Validiert
route: "aus S02, Trennen"
subframe: ""
---
# M03 — Trennen-Bestätigung
## Ziel
Verbindung bewusst und informiert trennen — nichts geht versehentlich kaputt.
## Pattern / Archetyp
A5 Bestätigungs-Dialog, mehrstufig.
## Inhalt
- Klartext, was passiert: »Beim Trennen werden alle Abgleich-Jobs gestoppt. Bereits übertragene Daten bleiben erhalten. Die Verbindung wird als getrennt markiert (kein Löschen).«
- Bestätigung (zweiter Schritt / bewusste Aktion)
## Aktionen
- »Trennen« → Card wird grau (getrennt), Toast
- Abbrechen
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Trennen fehlgeschlagen | Toast mit Klartext | nein | Wiederverwenden | erneut versuchen |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,52 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P5
package: WF-P5 Integrationen
id: S01
screen: App-Katalog
typ: Katalog
umsetzung: Bauen
status: Validiert
route: "/admin/integrations"
subframe: ""
---
# S01 — App-Katalog
## Ziel
Auf einen Blick sehen, welche Dienste es gibt und was verbunden ist — der „App-Store" von HiveGrid.
## Pattern / Archetyp
A6 — Karten-Grid, nach Kategorie gruppiert.
## Daten
- Kategorien: ERP · Kommunikation · Kalender · Signatur · Payment · KI/MCP
- Je App-Karte: Logo · Name · Kurzbeschreibung · Status-Ampel (grün läuft / gelb hakt / rot kaputt / grau nicht verbunden) · Anzahl aktiver Verbindungen
- Suche + Filter (Kategorie / Status)
## Aktionen
- App-Karte öffnen → [[S02 App-Seite]]
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Filter ohne Treffer | Leer-Zustand + zurücksetzen | Nur dokumentieren |
| Laden / Fehler / Kein Zugriff | A7 | Wiederverwenden |
## Permissions / Gates
`integrations.read`.
## Subframe
- (erst nach explizitem OK)
## Notizen
- Offen: kommende Apps als Teaser mit Schloss zeigen? (analog Abo-Gating)
@@ -0,0 +1,54 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P5
package: WF-P5 Integrationen
id: S02
screen: App-Seite
typ: Verwaltung
umsetzung: Bauen
status: Validiert
route: "/admin/integrations/:app"
subframe: ""
---
# S02 — App-Seite (Verbindungs-Verwaltung)
## Ziel
Alle Verbindungen einer App verwalten und ihren Zustand in Klartext verstehen.
## Pattern / Archetyp
A6 mit **wiederverwendbarer Connection-Card** (das Muster, das P14/P15/P16 später in ihren Settings nutzen).
## Daten
- Kopf: App-Logo, Beschreibung, Doku-Link
- Je Verbindung eine **Connection-Card**: Namens-Label (z. B. »Büro«) · Status-Ampel · Klartext-Status (»Zugang abgelaufen — neu verbinden«) · letzter Abgleich
- Mehrere Verbindungen pro App möglich
- Letzte Läufe kompakt (Datum, Klartext-Summary) + »Alle Läufe anzeigen« → [[S03 Sync-Verlauf]]
## Aktionen
- »Verbinden« → [[M01 Assistent OAuth]] oder [[M02 Assistent API-Schluessel]] (je nach App)
- Je Card: Neu abgleichen (mit Klartext-Fortschritt) · Neu verbinden (bei gelb/rot) · Trennen → [[M03 Trennen-Bestaetigung]]
## Banner / Hinweise
- Gelb/Rot/Schema geändert → Klartext-Banner mit Lösungs-Knopf
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Keine Verbindung | Leer-Zustand + »Verbinden«-Knopf | Nur dokumentieren |
| Laden / Fehler / Kein Zugriff | A7 | Wiederverwenden |
## Permissions / Gates
`integrations.connect/.disconnect/.manual_sync` — Knöpfe rechte-abhängig.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,44 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P5
package: WF-P5 Integrationen
id: S03
screen: Sync-Verlauf
typ: Liste
umsetzung: Bauen
status: Validiert
route: "/admin/integrations/:app/syncs"
subframe: ""
---
# S03 — Sync-Verlauf
## Ziel
Nachvollziehen, was wann übertragen wurde — jede Zeile in Klartext. **Eigene Seite (Davids Entscheidung, kein Drawer).**
## Pattern / Archetyp
A2 Liste.
## Daten
- Je Lauf: Datum · Art (holen/senden/Webhook/manuell) · Status · Zähler (gesamt/ok/fehlgeschlagen) · **Klartext-Summary** (»14 Aufträge geholt, 2 fehlgeschlagen«)
- Filter: Datum, Status, Art
## Aktionen
- Lauf öffnen → [[S04 Lauf-Detail]]
- Manueller Abgleich anstoßen
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer | »Noch keine Abgleiche gelaufen« | Nur dokumentieren |
| Laden / Fehler / Kein Zugriff | A7 (`integrations.view_logs`) | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,44 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P5
package: WF-P5 Integrationen
id: S04
screen: Lauf-Detail
typ: Detail
umsetzung: Bauen
status: Validiert
route: "/admin/integrations/:app/syncs/:id"
subframe: ""
---
# S04 — Lauf-Detail
## Ziel
Bei Problemen genau sehen, welcher Datensatz warum gescheitert ist. **Eigene Seite (Davids Entscheidung).**
## Pattern / Archetyp
A3 Detail mit Tabelle + Log.
## Daten
- Kopf: Lauf-Infos (Datum, Art, Status, Klartext-Summary)
- Datensatz-Tabelle: HiveGrid-Objekt ↔ externe ID · Vorgang (angelegt/aktualisiert/gelöscht) · Status · **Klartext-Fehler** je gescheitertem Datensatz
- Log-Einträge mit Schweregrad (Info/Warnung/Fehler)
## Aktionen
- Verknüpftes Objekt öffnen (Sprung zur Detailseite)
- Zurück zum Verlauf
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Laden / Fehler / Kein Zugriff | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)