docs(p12): add run template and credential variants
This commit is contained in:
1 parent
58df5360aa
commit
2476676771
12 files changed
+126
-87
No files matched your search
@@ -7,7 +7,7 @@ id: S03
|
||||
screen: Lauf-Detail
|
||||
typ: Detail + Timeline
|
||||
umsetzung: Bauen
|
||||
status: In Subframe - V1/V2 zu validieren
|
||||
status: In Subframe - V1/V2/V3 zu validieren
|
||||
route: "/automations/:id/executions/:exec_id"
|
||||
subframe: "https://app.subframe.com/f023064a5ca0/flow/62d8e7ad-c757-4416-b150-ae286310bca9/edit"
|
||||
subframe_v1_name: "S03 Lauf-Detail V1"
|
||||
@@ -16,6 +16,9 @@ subframe_v1: "https://app.subframe.com/f023064a5ca0/design/7f33f9fa-f96b-4c0b-82
|
||||
subframe_v2_name: "S03 Lauf-Detail V2"
|
||||
subframe_v2_page_id: "b6748a04-9385-4646-abba-1837764f3be9"
|
||||
subframe_v2: "https://app.subframe.com/f023064a5ca0/design/b6748a04-9385-4646-abba-1837764f3be9/edit"
|
||||
subframe_v3_name: "S03 Lauf-Detail V3"
|
||||
subframe_v3_page_id: "118793cf-a1e1-43d4-9c54-8bf06de56a6a"
|
||||
subframe_v3: "https://app.subframe.com/f023064a5ca0/design/118793cf-a1e1-43d4-9c54-8bf06de56a6a/edit"
|
||||
source_checked: 2026-08-04
|
||||
---
|
||||
|
||||
@@ -31,17 +34,17 @@ S02 zeigt mehrere vollständige Ausführungen derselben Automation. S03 öffnet
|
||||
|
||||
## Gemeinsamer Funktionsumfang
|
||||
|
||||
- Kopf mit Zusammenfassung, Status, Zeit, Dauer und Laufart.
|
||||
- Kopf mit Zusammenfassung und Status; Laufdaten stehen ausschließlich rechts.
|
||||
- Lesbare Auslöserdaten statt rohem JSON.
|
||||
- Timeline je Schritt mit Status, Klartext, Dauer sowie verständlichem Input/Output.
|
||||
- Fehlgeschlagenen Lauf erneut ausführen.
|
||||
- Ab einem Schritt fortsetzen.
|
||||
- 24-h-Rückgängig an genau einem klaren Ort mit Restzeit und Hinweis auf nicht rückziehbare Wirkungen.
|
||||
- Kompakte Accordion-Liste je Schritt mit Status, Dauer und verständlichem Input/Output beim Aufklappen.
|
||||
- Der eigentliche Fehler steht direkt im betroffenen Schritt; die rechte Spalte erklärt nur die mögliche Behebung.
|
||||
- „Schritt erneut ausführen“ liegt ausschließlich im Drei-Punkte-Menü des jeweiligen Schritts.
|
||||
- Keine Rückgängig- oder Rollback-Funktion.
|
||||
- Zurück zu [[S02 Lauf-Liste]] und Bearbeiten in [[S01 Flow-Editor]].
|
||||
|
||||
## Zustandslogik
|
||||
|
||||
Ein Probelauf schreibt nichts und darf deshalb keine Rückgängig-Aktion anbieten. Produktive und simulierte Läufe müssen klar unterscheidbar sein.
|
||||
Der ausgewählte Schritt steuert den Kontext rechts. Bei einem Fehler bleibt die Fehlermeldung im aufgeklappten Schritt sichtbar; „Fehlerhilfe“ erklärt die Reparatur und verweist anschließend auf das Drei-Punkte-Menü dieses Schritts.
|
||||
|
||||
## Gebaute Varianten
|
||||
|
||||
@@ -49,15 +52,17 @@ Ein Probelauf schreibt nichts und darf deshalb keine Rückgängig-Aktion anbiete
|
||||
|---|---|---|
|
||||
| [V1 öffnen](https://app.subframe.com/f023064a5ca0/design/7f33f9fa-f96b-4c0b-8263-9fd38de2cbb4/edit) | Erfolgreiche Schritte sind ausführlich geöffnet; Fehler, Laufdaten und nächste Aktionen stehen daneben. | Maximale Nachvollziehbarkeit, aber die relevante Fehlerstelle konkurriert mit bereits erledigten Details. |
|
||||
| [V2 öffnen](https://app.subframe.com/f023064a5ca0/design/b6748a04-9385-4646-abba-1837764f3be9/edit) | Erfolgreiche Schritte kompakt, Ergebnis zusammengefasst, fehlgeschlagener Schritt vollständig geöffnet; rechts ein klarer Bereich „Was jetzt?“. | Lenkt direkt vom Befund zur Reparatur. Laufdaten, Wiederholen, Fortsetzen und 24-h-Rückgängig bleiben sichtbar. |
|
||||
| [V3 öffnen](https://app.subframe.com/f023064a5ca0/design/118793cf-a1e1-43d4-9c54-8bf06de56a6a/edit) | Vier echte Accordion-Schritte; der fehlgeschlagene Schritt ist ausgewählt und geöffnet. Laufdaten und Fehlerhilfe stehen rechts. | Verbindet die Detailtiefe aus V1 mit der Dichte aus V2, entfernt doppelte Metadaten und Rückgängig vollständig und ordnet Wiederholen dem einzelnen Schritt zu. |
|
||||
|
||||
Beide Varianten zeigen lesbare Daten statt rohem JSON. Der Beispieldatensatz ist ein produktiver Lauf; deshalb ist die Rückgängig-Aktion hier fachlich korrekt.
|
||||
Alle Varianten zeigen lesbare Daten statt rohem JSON. V3 bildet den aktuellen Feedbackstand ohne Rückgängig- oder Laufart-Logik ab.
|
||||
|
||||
## Vorläufige Empfehlung
|
||||
|
||||
**V2.** Ein Laufdetail ist in erster Linie ein Diagnose- und Reparaturwerkzeug. Erfolgreiches darf kompakt sein; der Fehler und die nächste Handlung brauchen die Fläche.
|
||||
**V3.** Sie beantwortet zuerst „Welcher Schritt ist betroffen?“, hält abgeschlossene Schritte kompakt und zeigt Details nur auf Wunsch. Fehler und Eingabe bleiben zusammen; rechts steht ausschließlich die Hilfe zur Behebung.
|
||||
|
||||
## Subframe
|
||||
|
||||
- [V1 direkt öffnen](https://app.subframe.com/f023064a5ca0/design/7f33f9fa-f96b-4c0b-8263-9fd38de2cbb4/edit)
|
||||
- [V2 direkt öffnen](https://app.subframe.com/f023064a5ca0/design/b6748a04-9385-4646-abba-1837764f3be9/edit)
|
||||
- [V3 direkt öffnen](https://app.subframe.com/f023064a5ca0/design/118793cf-a1e1-43d4-9c54-8bf06de56a6a/edit)
|
||||
- [Verwaltungs-Flow öffnen](https://app.subframe.com/f023064a5ca0/flow/62d8e7ad-c757-4416-b150-ae286310bca9/edit)
|
||||
@@ -7,7 +7,7 @@ id: S04
|
||||
screen: Vorlagen-Katalog
|
||||
typ: Karten-Liste
|
||||
umsetzung: Bauen
|
||||
status: In Subframe - V1/V2 zu validieren
|
||||
status: In Subframe - V1/V2/V3 zu validieren
|
||||
route: "/automations/templates"
|
||||
subframe: "https://app.subframe.com/f023064a5ca0/flow/62d8e7ad-c757-4416-b150-ae286310bca9/edit"
|
||||
subframe_v1_name: "S04 Vorlagen-Katalog V1"
|
||||
@@ -16,6 +16,9 @@ subframe_v1: "https://app.subframe.com/f023064a5ca0/design/2dd7fd2f-c7ce-4492-a1
|
||||
subframe_v2_name: "S04 Vorlagen-Katalog V2"
|
||||
subframe_v2_page_id: "47542e29-c96d-4486-b455-ad0356f16db3"
|
||||
subframe_v2: "https://app.subframe.com/f023064a5ca0/design/47542e29-c96d-4486-b455-ad0356f16db3/edit"
|
||||
subframe_v3_name: "S04 Vorlagen-Katalog V3"
|
||||
subframe_v3_page_id: "7376e365-94b6-4ea7-bc12-da14e1d89016"
|
||||
subframe_v3: "https://app.subframe.com/f023064a5ca0/design/7376e365-94b6-4ea7-bc12-da14e1d89016/edit"
|
||||
source_checked: 2026-08-04
|
||||
---
|
||||
|
||||
@@ -23,16 +26,16 @@ source_checked: 2026-08-04
|
||||
|
||||
## Ziel
|
||||
|
||||
Die spätere Vorlagenstruktur sichtbar machen, obwohl der produktive Katalog zunächst noch leer ist.
|
||||
Einen gemeinsamen, überschaubaren Vorlagenbestand durchsuchen, verwenden und verwalten.
|
||||
|
||||
## Gemeinsamer Funktionsumfang
|
||||
|
||||
- Seitenkopf und Erklärung des Vorlagenprinzips.
|
||||
- Genau **eine illustrative Standardvorlage** als Anschauungsobjekt.
|
||||
- Karte mit Name, kurzer SHK-Anwendung, sichtbarer Schrittfolge und „Verwenden“.
|
||||
- Klare Kennzeichnung als Beispiel-/Standardvorlage; noch keine behaupteten Nutzungszahlen oder große Vorlagenbibliothek.
|
||||
- Optionaler Leerzustand für „Eigene Vorlagen“.
|
||||
- Wird in vereinfachter Form in [[M03 Start-Auswahl]] verwendet.
|
||||
- Vier konkrete Dummy-Vorlagen mit Name, Kurzbeschreibung, Kategorien und sichtbarer Schrittfolge.
|
||||
- Suche und Kategorie ausschließlich über die vorhandene Subframe-Komponente „Filter Bar“.
|
||||
- Keine Trennung oder Tabs für Standard- und eigene Vorlagen.
|
||||
- Drei-Punkte-Menü je Karte mit Verwenden, Duplizieren, Umbenennen und Löschen.
|
||||
- Derselbe Bestand wird direkt im Modal [[M03 Start-Auswahl]] verwendet.
|
||||
- „Verwenden“ öffnet [[S01 Flow-Editor]] vorbefüllt.
|
||||
|
||||
## Gebaute Varianten
|
||||
@@ -41,17 +44,19 @@ Die spätere Vorlagenstruktur sichtbar machen, obwohl der produktive Katalog zun
|
||||
|---|---|---|
|
||||
| [V1 öffnen](https://app.subframe.com/f023064a5ca0/design/2dd7fd2f-c7ce-4492-a1f3-c8e0386e573f/edit) | Fertige Katalogstruktur mit Reitern, Suche und Filter; eine klar markierte Beispielkarte. | Gute Vorschau auf einen später gefüllten Katalog, aktuell aber viel Bedienoberfläche für genau ein Beispiel. |
|
||||
| [V2 öffnen](https://app.subframe.com/f023064a5ca0/design/47542e29-c96d-4486-b455-ad0356f16db3/edit) | Eine Sektion „So können Standardvorlagen aussehen“ plus kompakter Leerzustand für eigene Vorlagen. | Ehrlicher zum jetzigen Produktstand, kürzer und ohne funktionslose Filter. Die Beispielkarte bleibt vollständig. |
|
||||
| [V3 öffnen](https://app.subframe.com/f023064a5ca0/design/7376e365-94b6-4ea7-bc12-da14e1d89016/edit) | Einheitlicher Katalog mit vier Vorlagen, echter Filter Bar und Drei-Punkte-Menü je Karte. | Entfernt die künstliche Standard-/Eigene-Trennung und bildet einen kleinen, aber bereits nutzbaren Vorlagenbestand ab. |
|
||||
|
||||
## Vorläufige Empfehlung
|
||||
|
||||
**V2 für den Start.** V1 wird interessant, sobald mehrere echte Vorlagen vorhanden sind. Bis dahin ist jede Suche, jeder Filter und jeder Reiter zusätzliche Oberfläche ohne echte Auswahl.
|
||||
**V3.** Vier Vorlagen rechtfertigen Suche und Kategorie, aber weiterhin keine Reiter. Verwaltung und Verwendung bleiben direkt an der jeweiligen Karte; das Auswahlmodal nutzt denselben Bestand.
|
||||
|
||||
## Verhältnis zur Entwicklung
|
||||
|
||||
Der Repo-Code war ausdrücklich keine Designvorlage für diesen Neubau. Der abgestimmte Designstand ist produktiv leer und zeigt genau eine klar als Illustration gekennzeichnete Beispielkarte. Eine spätere Implementierung muss auf diese Produktentscheidung ausgerichtet werden.
|
||||
Der Repo-Code war ausdrücklich keine Designvorlage für diesen Neubau. Der aktuelle Feedbackstand definiert vier lösch- und duplizierbare Dummy-Vorlagen sowie einen gemeinsamen Bestand ohne Standard-/Eigene-Typisierung.
|
||||
|
||||
## Subframe
|
||||
|
||||
- [V1 direkt öffnen](https://app.subframe.com/f023064a5ca0/design/2dd7fd2f-c7ce-4492-a1f3-c8e0386e573f/edit)
|
||||
- [V2 direkt öffnen](https://app.subframe.com/f023064a5ca0/design/47542e29-c96d-4486-b455-ad0356f16db3/edit)
|
||||
- [V3 direkt öffnen](https://app.subframe.com/f023064a5ca0/design/7376e365-94b6-4ea7-bc12-da14e1d89016/edit)
|
||||
- [Verwaltungs-Flow öffnen](https://app.subframe.com/f023064a5ca0/flow/62d8e7ad-c757-4416-b150-ae286310bca9/edit)
|
||||
@@ -5,13 +5,20 @@ ticket: D-P12
|
||||
package: WF-P12 Verwaltung
|
||||
id: S06
|
||||
screen: Zugangsdaten
|
||||
subframe_name: "S06 Zugangsdaten"
|
||||
subframe_page_id: "81271b5c-7871-4404-be60-e74423d6a364"
|
||||
typ: Liste / Verwaltung
|
||||
umsetzung: Bauen
|
||||
status: In Subframe - Outline gebaut, Review offen
|
||||
status: In Subframe - V1/V2/V3 zu validieren
|
||||
route: "/automations/credentials"
|
||||
subframe: "https://app.subframe.com/f023064a5ca0/design/81271b5c-7871-4404-be60-e74423d6a364/edit"
|
||||
subframe: "https://app.subframe.com/f023064a5ca0/flow/62d8e7ad-c757-4416-b150-ae286310bca9/edit"
|
||||
subframe_v1_name: "S06 Zugangsdaten"
|
||||
subframe_v1_page_id: "81271b5c-7871-4404-be60-e74423d6a364"
|
||||
subframe_v1: "https://app.subframe.com/f023064a5ca0/design/81271b5c-7871-4404-be60-e74423d6a364/edit"
|
||||
subframe_v2_name: "S06 Zugangsdaten V2 Gesamtliste"
|
||||
subframe_v2_page_id: "b183c6bf-9674-4e97-86d7-d7a8ef9ab17b"
|
||||
subframe_v2: "https://app.subframe.com/f023064a5ca0/design/b183c6bf-9674-4e97-86d7-d7a8ef9ab17b/edit"
|
||||
subframe_v3_name: "S06 Zugangsdaten V3 Gruppiert"
|
||||
subframe_v3_page_id: "4f30c824-ee30-45b6-ab4e-5857c10a6735"
|
||||
subframe_v3: "https://app.subframe.com/f023064a5ca0/design/4f30c824-ee30-45b6-ab4e-5857c10a6735/edit"
|
||||
source_checked: 2026-08-04
|
||||
---
|
||||
|
||||
@@ -19,30 +26,45 @@ source_checked: 2026-08-04
|
||||
|
||||
## Ziel und Rolle im Flow
|
||||
|
||||
Wiederverwendbare Zugangsdaten für Automationen zentral finden und verwalten. Der Einstieg liegt direkt im Kopf von [[S01 Automation-Liste]], weil die Zugangsdaten ein Arbeitsmittel der Automationen sind und nicht zu einer einzelnen Automation gehören.
|
||||
Wiederverwendbare Zugangsdaten für Automationen zentral finden, mögliche Dienste entdecken, neue Verbindungen einrichten und bestehende verwalten. Der Einstieg liegt direkt im Kopf von [[S01 Automation-Liste]], weil die Zugangsdaten ein Arbeitsmittel der Automationen sind und nicht zu einer einzelnen Automation gehören.
|
||||
|
||||
## Sichtbarer Umfang
|
||||
|
||||
- Seitenkopf mit Rückweg zu „Automationen“ und „Zugangsdaten hinzufügen“.
|
||||
- Suche sowie einfache Filter nach Status und Typ.
|
||||
- Tabelle mit Name, Typ, verwendenden Automationen, Status, letzter Änderung und Aktionen.
|
||||
- Sichtbare Zustände „Verbunden“ und „Handlungsbedarf“.
|
||||
- Freitextsuche, Status und Kategorie ausschließlich über die vorhandene Subframe-Komponente „Filter Bar“.
|
||||
- Sichtbarer Katalog mit Google Workspace, Microsoft 365, OpenAI / ChatGPT, Slack, WhatsApp Business, Stripe, SMTP / E-Mail und HubSpot.
|
||||
- Beschränkte Zustände „Verbunden“ und „Nicht eingerichtet“.
|
||||
- Verbundene Einträge zeigen Konto und verwendende Automationen; verfügbare Dienste zeigen „Einrichten“.
|
||||
- Sicherheitshinweis, dass gespeicherte Zugangsdaten nie vollständig angezeigt werden.
|
||||
- Die drei Beispielzeilen sind illustrative Inhalte für die Outline, keine Festlegung des produktiven Datenbestands.
|
||||
|
||||
## Aktionen
|
||||
|
||||
- Zugangsdaten hinzufügen.
|
||||
- Bestehenden Eintrag über das Zeilenmenü verwalten.
|
||||
- Nicht eingerichteten Dienst auswählen und einrichten.
|
||||
- Bestehenden Eintrag verwalten oder über das Zeilenmenü „Verbindung prüfen“, „Bearbeiten“ und „Trennen“ wählen.
|
||||
- Verwendende Automationen als Kontext erkennen.
|
||||
|
||||
Für Anlegen, Bearbeiten, Entfernen und Fehlerbehebung werden im aktuellen Zeitrahmen keine zusätzlichen Detail- oder Error-Screens gestaltet. Die Liste definiert die Informationsarchitektur; konkrete Abläufe und Schutzmechanismen werden in der Entwicklung vervollständigt.
|
||||
|
||||
## Gebaute Varianten
|
||||
|
||||
| Variante | Aufbau | UX-Einschätzung |
|
||||
|---|---|---|
|
||||
| [V1 öffnen](https://app.subframe.com/f023064a5ca0/design/81271b5c-7871-4404-be60-e74423d6a364/edit) | Drei bereits angelegte Zugangsdaten in einer kompakten Tabelle. | Gute Bestandsverwaltung, zeigt aber nicht, welche weiteren Dienste überhaupt eingerichtet werden können. |
|
||||
| [V2 öffnen](https://app.subframe.com/f023064a5ca0/design/b183c6bf-9674-4e97-86d7-d7a8ef9ab17b/edit) | Eine gemeinsame Tabelle für vier verbundene und vier noch nicht eingerichtete Anbieter. | Sehr kompakt und gut filterbar; bei mehreren Konten desselben Dienstes wird das Modell jedoch weniger eindeutig. |
|
||||
| [V3 öffnen](https://app.subframe.com/f023064a5ca0/design/4f30c824-ee30-45b6-ab4e-5857c10a6735/edit) | Oben verbundene Konten, darunter verfügbare Dienste; eine Filter Bar steuert beide Listen. | Trennt Credential-Instanzen sauber von Verbindungstypen und skaliert besser, wenn ein Dienst später mehrere Konten besitzt. |
|
||||
|
||||
## Vorläufige Empfehlung
|
||||
|
||||
**V3.** Sie entspricht dem mentalen Modell „Was ist bereits verbunden?“ versus „Was kann ich noch einrichten?“, ohne dafür Tabs oder zusätzliche Screens einzuführen.
|
||||
|
||||
## Abgrenzung zu Integrationen
|
||||
|
||||
S06 verwaltet die in Automationen verwendbaren Zugangsdaten. Der umfangreichere Lebenszyklus einer App-Verbindung — OAuth-Einrichtung, Verbindungstest, Synchronisation und Abgleich-Verlauf — bleibt beim separaten Paket „Integrationen“. Damit werden keine zwei konkurrierenden Verbindungsverwaltungen geplant.
|
||||
|
||||
## Subframe
|
||||
|
||||
- [Screen direkt öffnen](https://app.subframe.com/f023064a5ca0/design/81271b5c-7871-4404-be60-e74423d6a364/edit)
|
||||
- [V1 direkt öffnen](https://app.subframe.com/f023064a5ca0/design/81271b5c-7871-4404-be60-e74423d6a364/edit)
|
||||
- [V2 direkt öffnen](https://app.subframe.com/f023064a5ca0/design/b183c6bf-9674-4e97-86d7-d7a8ef9ab17b/edit)
|
||||
- [V3 direkt öffnen](https://app.subframe.com/f023064a5ca0/design/4f30c824-ee30-45b6-ab4e-5857c10a6735/edit)
|
||||
- [Verwaltungs-Flow öffnen](https://app.subframe.com/f023064a5ca0/flow/62d8e7ad-c757-4416-b150-ae286310bca9/edit)
|
||||
Reference in new issue
Block a user