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:
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)
|
||||
+45
@@ -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.
|
||||
+43
@@ -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)
|
||||
Reference in new issue
Block a user