chore(repo): sync wireframe structure and references

This commit is contained in:
david committed 2026-08-08 03:09:06 +02:00
1 parent 05d2d5777f
commit d953a79e95
453 files changed
+36639 -621

No files matched your search

@@ -0,0 +1,36 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P16 (Teil) + AK-P16d
package: WF-P16 E-Signatur
id: M01
screen: Signatur zurückziehen
typ: Confirm-Modal
umsetzung: Bauen
status: Validiert
route: "aus S03"
subframe: ""
---
# M01 — Signatur zurückziehen
## Ziel
Das Büro kann einen laufenden Signaturvorgang bewusst stoppen, ohne den Verlauf zu verlieren.
## Was das Tool können muss
- Zeigt Dokumenttitel, betroffene Unterzeichner und aktuellen Status
- Pflichtfeld: Grund für das Zurückziehen
- Hinweis: Signatur-Link wird ungültig; bereits erzeugte Nachweise/Verläufe bleiben sichtbar
- Option: Unterzeichner per E-Mail informieren
- Bestätigen/Abbrechen; danach Status »zurückgezogen« in S03 und Link-Zustand in S04
- Bulk nicht nötig in v1
## Pattern / Archetyp
A5 Confirm-Modal.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,38 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P16 (Teil) + AK-P16d
package: WF-P16 E-Signatur
id: S01
screen: Signaturen im Projekt
typ: A3/A2 eingebettet
umsetzung: Bauen
status: Validiert
route: "Projekt-Detail, Reiter/Aktion"
subframe: ""
---
# S01 — Signaturen im Projekt
## Ziel
Im Projekt ist sofort sichtbar, welche Dokumente zur Unterschrift raus sind, was offen ist und was abgeschlossen wurde.
## Was das Tool können muss
- Reiter/Sektion im Projekt-Detail: **Signaturen**
- Liste der Signatur-Dokumente: Titel, Status, Unterzeichner-Fortschritt, zuletzt geändert, Ablaufdatum
- Primäraktion: **Zur Signatur senden** → S02
- Zeilen-Klick → S03 (Detail & Status)
- Schnell-Aktionen: erinnern, zurückziehen (M01), Downloads wenn abgeschlossen
- Status-Badges: Entwurf, gesendet, angesehen, teilweise signiert, signiert, abgelehnt, zurückgezogen, abgelaufen, Fehler
- Hinweis: Artefakte liegen in den Projekt-Dateien (Original, signiertes PDF, Abschluss-Nachweis)
- Zustände: leer (CTA »Erstes Dokument senden«), laden, Fehler, keine Berechtigung
## Pattern / Archetyp
A3 Projekt-Detail-Sektion mit A2-Listenmuster; passt in das Karteikarten-Muster aus WF-P9 Projekt-Akte.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,39 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P16 (Teil) + AK-P16d
package: WF-P16 E-Signatur
id: S02
screen: Signatur-Wizard
typ: A5 Wizard
umsetzung: Bauen
status: Validiert
route: "aus Projekt-Detail / S01"
subframe: ""
---
# S02 — Signatur-Wizard
## Ziel
Das Büro verschickt ein PDF zur Unterschrift, ohne sich mit Technik, Provider-Details oder manueller Ablage zu beschäftigen.
## Was das Tool können muss
- Schritt 1: **PDF wählen** aus Projekt-Dateien ODER neues PDF hochladen (Dropzone), Dateiname/Titel prüfen
- Schritt 2: **Unterzeichner**: Name, E-Mail, Rolle, Kontakt-Verknüpfung, Reihenfolge; Kunde aus Projekt/Kontakt vorausgefüllt
- Reihenfolge: parallel oder sequenziell; bei sequenziell klar zeigen, wer zuerst dran ist
- Schritt 3: **Signaturmodus**: Fern-Link + Code (OTP) ODER Vor Ort auf diesem Gerät (V01)
- Optional: PandaDoc BYOK nur anzeigen, wenn verbunden; sonst Default **SES-Eigenbau**
- Nachricht an Unterzeichner: Betreff, kurzer Text, Ablaufdatum
- Zusammenfassung vor dem Senden: Dokument, Unterzeichner, Modus, Reihenfolge, Ablauf
- Senden → S03; Vor-Ort-Modus → V01
- Validierung: PDF fehlt, Fern-Link ohne E-Mail, doppelte E-Mail, ungültige Reihenfolge, Datei nicht PDF
## Pattern / Archetyp
A5 Wizard, bewusst kompakt; technische Provider-Details bleiben im Hintergrund.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,38 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P16 (Teil) + AK-P16d
package: WF-P16 E-Signatur
id: S03
screen: Signatur-Detail & Status
typ: A3 Detail
umsetzung: Bauen
status: Validiert
route: "Signatur öffnen"
subframe: ""
---
# S03 — Signatur-Detail & Status
## Ziel
Alles zu einem Signaturvorgang an einem Ort: wer hat schon unterschrieben, was ist offen, welche Nachweise gibt es.
## Was das Tool können muss
- Kopf: Dokument-Titel, Projekt, Gesamtstatus, Ablaufdatum, Provider (SES Default / PandaDoc BYOK)
- Linke Spalte: Dokumentdaten, Versandtext, Routing-Modus, Datei-Verknüpfungen
- Rechte Spalte: **Unterzeichner-Status** je Person (gesendet, angesehen, signiert, abgelehnt, zurückgezogen), Zeitpunkte, letzte Erinnerung
- Aktionen: Erinnerung senden, Link erneut senden, zurückziehen (M01), Download Original-PDF, signiertes PDF, Abschluss-Nachweis
- Verlauf: erstellt, gesendet, Link geöffnet, OTP bestätigt, signiert, abgelehnt, zurückgezogen, Versiegelung abgeschlossen/fehlgeschlagen
- Wenn abgeschlossen: klare Download-Leiste + Hinweis, dass das signierte PDF in den Projekt-Dateien liegt
- Wenn abgelehnt: Grund anzeigen, erneutes Senden als neuer Vorgang
- Zustände: wartend auf Unterzeichner, abgelaufen, zurückgezogen, Versiegelung fehlgeschlagen, keine Berechtigung
## Pattern / Archetyp
A3 Detail nach Karteikarten-Muster: Daten links, Status/Verlauf rechts, Aktionen im Kopf.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,38 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P16 (Teil) + AK-P16d
package: WF-P16 E-Signatur
id: S04
screen: Signieren per Link
typ: BESPOKE-Public
umsetzung: Bauen
status: Validiert (Delta)
route: "/sign/:token"
subframe: ""
---
# S04 — 🌐 Signieren per Link
## Ziel
Der Kunde kann das Dokument sicher und verständlich unterschreiben, ohne Login und ohne App-Installation.
## Was das Tool können muss
- Firmen-Branding oben, Dokumenttitel, Projekt-/Angebotsbezug in Klartext ohne interne Details
- Schritt 1: Code-Bestätigung (OTP aus Mail) mit »Code erneut senden«
- Schritt 2: PDF ansehen/prüfen, Seiten-Navigation, Download des Original-PDF optional
- Schritt 3: Zustimmung/Intent-Text bestätigen + Unterschrift zeichnen oder tippen
- Abschluss: klare Bestätigung, Hinweis auf E-Mail/Download, keine internen Projektlinks
- Ablehnen: optionaler Grund, Status geht zurück nach S03, Büro bekommt Benachrichtigung
- Zustände: Link ungültig, Link abgelaufen, bereits signiert, zurückgezogen, falscher/abgelaufener Code, PDF lädt nicht, Signatur-Abschluss fehlgeschlagen
- Mobile-first: Unterschrift muss auf Handy sauber funktionieren
## Pattern / Archetyp
BESPOKE-Public. Das ist der öffentliche Trust-Touchpoint; höherer Polish als interne Verwaltungsflächen.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,38 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P16 (Teil) + AK-P16d
package: WF-P16 E-Signatur
id: V01
screen: Vor Ort unterschreiben
typ: BESPOKE-Mobile
umsetzung: Bauen
status: Validiert
route: "aus S02, Touch-Modus"
subframe: ""
---
# V01 — Vor Ort unterschreiben 📱
## Ziel
Der Mitarbeiter kann dem Kunden vor Ort das Gerät geben und die Unterschrift direkt aufnehmen.
## Was das Tool können muss
- Vollbild-/Tablet-tauglicher Modus ohne interne Navigation
- Dokumenttitel + kurze Bestätigung, dass der Kunde gerade unterschreibt
- PDF-Vorschau oder Pflicht-Hinweis »Dokument wurde geprüft« je nach Platz
- Name des Unterzeichners editierbar, Rolle sichtbar
- Touch-Signaturfeld groß genug für Finger/Stift, mit Löschen/Neu zeichnen
- Abschlussknopf mit bewusstem Intent-Text
- Nach Abschluss: Bestätigung und Rückgabe-Hinweis an Mitarbeiter; zurück zu S03
- Zustände: offline/Sync steht aus, Signaturfeld leer, Versiegelung noch ausstehend
## Pattern / Archetyp
BESPOKE-Mobile, verwandt mit WF-P9 Abnahme-Unterschriften, aber für Dokument-Signatur am Projekt.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,57 @@
{
"nodes":[
{"id":"md-paket","type":"file","file":"02 Wireframes/P16 E-Signatur/WF-P16 E-Signatur/WF-P16 E-Signatur.md","x":-80,"y":-440,"width":460,"height":280},
{"id":"group-intern","type":"group","x":-80,"y":-100,"width":1740,"height":660,"label":"Projekt-Team (intern)"},
{"id":"group-public","type":"group","x":1840,"y":-100,"width":1180,"height":660,"label":"Kunde unterschreibt"},
{"id":"group-actions","type":"group","x":3200,"y":-100,"width":620,"height":380,"label":"Aktionen"},
{"id":"note-entry","type":"text","text":"# Einstieg\n\nProjekt-Detail → Reiter »Signaturen« oder Aktion »Zur Signatur senden«.\n\nSignatur hängt am Projekt-Kern, nicht an Deal.","x":0,"y":0,"width":360,"height":200},
{"id":"s01","type":"file","file":"02 Wireframes/P16 E-Signatur/WF-P16 E-Signatur/Screens/S01 Signaturen im Projekt.md","x":560,"y":0,"width":420,"height":200},
{"id":"s02","type":"file","file":"02 Wireframes/P16 E-Signatur/WF-P16 E-Signatur/Screens/S02 Signatur-Wizard.md","x":1120,"y":0,"width":420,"height":200},
{"id":"s03","type":"file","file":"02 Wireframes/P16 E-Signatur/WF-P16 E-Signatur/Screens/S03 Signatur-Detail.md","x":560,"y":300,"width":420,"height":200},
{"id":"note-assets","type":"text","text":"# Artefakte\n\nOriginal-PDF, signiertes PDF und Abschluss-Nachweis landen in den Projekt-Dateien.\n\nDefault: SES-Eigenbau. PandaDoc nur BYOK-Opt-in.","x":1120,"y":300,"width":420,"height":200},
{"id":"s04","type":"file","file":"02 Wireframes/P16 E-Signatur/WF-P16 E-Signatur/Screens/S04 Signieren per Link.md","x":1920,"y":0,"width":420,"height":200},
{"id":"v01","type":"file","file":"02 Wireframes/P16 E-Signatur/WF-P16 E-Signatur/Screens/V01 Vor Ort unterschreiben.md","x":2480,"y":0,"width":420,"height":200},
{"id":"note-public","type":"text","text":"# Public-Delta\n\nD-P16 nennt den Wizard, aber nicht den Kunden-Signierframe. S04 ist trotzdem Pflicht, weil hier Vertrauen + OTP + Signatur passieren.","x":1920,"y":300,"width":460,"height":200},
{"id":"m01","type":"file","file":"02 Wireframes/P16 E-Signatur/WF-P16 E-Signatur/Screens/M01 Zurueckziehen.md","x":3280,"y":0,"width":420,"height":200}
],
"edges":[
{
"id":"e-entry",
"fromNode":"note-entry",
"fromSide":"right",
"toNode":"s01",
"toSide":"left",
"toEnd":"arrow",
"styleAttributes":{"path":"dotted"}
},
{"id":"e-new","fromNode":"s01","fromSide":"right","toNode":"s02","toSide":"left","toEnd":"arrow","label":"Zur Signatur senden"},
{"id":"e-open","fromNode":"s01","fromSide":"bottom","toNode":"s03","toSide":"left","toEnd":"arrow","label":"öffnen"},
{"id":"e-send","fromNode":"s02","fromSide":"right","toNode":"s04","toSide":"left","toEnd":"arrow","label":"Fern-Link + OTP"},
{"id":"e-local","fromNode":"s02","fromSide":"right","toNode":"v01","toSide":"left","toEnd":"arrow","label":"Vor Ort"},
{"id":"e-status","fromNode":"s04","fromSide":"bottom","toNode":"s03","toSide":"right","toEnd":"arrow","label":"Status"},
{"id":"e-local-status","fromNode":"v01","fromSide":"bottom","toNode":"s03","toSide":"right","toEnd":"arrow","label":"Status"},
{
"id":"e-assets",
"fromNode":"note-assets",
"fromSide":"left",
"toNode":"s03",
"toSide":"right",
"toEnd":"arrow",
"styleAttributes":{"path":"dotted"}
},
{
"id":"e-public-note",
"fromNode":"note-public",
"fromSide":"top",
"toNode":"s04",
"toSide":"bottom",
"toEnd":"arrow",
"styleAttributes":{"path":"dotted"}
},
{"id":"e-revoke","fromNode":"s03","fromSide":"right","toNode":"m01","toSide":"left","toEnd":"arrow","label":"zurückziehen"}
],
"metadata":{
"version":"1.0-1.0",
"frontmatter":{}
}
}
@@ -0,0 +1,132 @@
---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-P16 (Teil) + AK-P16d
package: WF-P16 E-Signatur
typ: Flow
status: Validiert
subframe: ""
canvas: "WF-P16 E-Signatur.canvas"
---
# WF-P16 E-Signatur
Status: Validiert (Screen-Liste)
Subframe-Link: -
Canvas: [Canvas](<WF-P16 E-Signatur.canvas>)
Stand: 2026-07-09
---
## 1. Kurzfassung
Digital unterschreiben am Projekt: Das Büro wählt ein PDF aus den Projekt-Dateien oder lädt eines hoch, legt Unterzeichner, Reihenfolge und Versandtext fest und sendet den Signatur-Link. Kunden unterschreiben per 🌐 öffentlichem Link mit Code-Bestätigung oder direkt vor Ort auf dem Gerät. Intern sieht das Team pro Unterzeichner den Status, kann erinnern oder zurückziehen und lädt am Ende Original-PDF, signiertes PDF und Abschluss-Nachweis herunter. Default ist der gehärtete **SES-Eigenbau**; PandaDoc bleibt nur optionaler BYOK-Adapter.
---
## 2. Intent Check
| Frage | Antwort |
|---|---|
| Ticket/Modul | D-P16 (Signatur-Wizard), Dev-Pendant AK-P16d |
| Nutzer-Ziel | Angebot/Projekt-Dokument ohne Medienbruch zur Unterschrift bringen und den Nachweis sauber am Projekt ablegen |
| Quellen geprüft | `ticket-docs/D-P16.md`, `ticket-docs/AK-P16d.md`, Signature-Modelle, HiveGrid Map |
| Sicher im Scope | Projekt-Einstieg, Signatur-Wizard, Status/Detail, 🌐 Kunden-Signierseite, Vor-Ort-Signatur, Erinnerung, Widerruf, Downloads |
| Sicher nicht im Scope | PDF-Editor/Vorlagenbau, qualifizierte elektronische Signatur (QES), PandaDoc als Pflichtprovider, Deal-Objekt |
| Unsichere Annahmen | Öffentliche Signierseite ist als eigener Screen nötig: Dev hat den Flow, D-P16 nennt ihn nicht als separates Screen-Delta |
---
## 3. Scope
| Punkt | Inhalt |
|---|---|
| Startpunkt | Projekt-Detail, Aktion »Zur Signatur senden« oder Reiter »Signaturen« |
| Ziel | Dokument ist versendet oder abgeschlossen; Artefakte liegen am Projekt in Dateien |
| Haupt-Archetyp | A5 Wizard + A3 Detail + BESPOKE-Public |
| Out of scope | Dokument inhaltlich bearbeiten, Unterschriftenfelder frei im PDF platzieren, QES/D-Trust |
---
## 4. Entscheidungen (validiert 2026-07-09)
| Entscheidung | Status | Notiz |
|---|---|---|
| Signatur hängt am Projekt-Kern | genommen | `ProjektSignatureDocument`/`Signer`; kein Deal-Objekt |
| Eigener SES-Flow ist Default | genommen | Fern-Link mit OTP + Touch vor Ort + PAdES/Certificate; PandaDoc nur BYOK-Opt-in |
| Eigene 🌐 Kunden-Signierseite | genommen (Delta) | Als eigener Frame S04, weil sonst der wichtigste externe Touchpoint fehlt |
| Projekt-Reiter/Liste vor Wizard | genommen | Nutzer braucht Überblick über laufende und abgeschlossene Signaturen am Projekt |
| Status-Detail als eigene Karteikarte | genommen | Download, Signer-Status, Reminder, Widerruf und Verlauf gehören an einen Ort |
| Vor-Ort-Signatur als eigener Mobile-/Tablet-Nachweis | genommen | Gleiche Signatur-Engine, aber ohne Mail-Link als Übergabe auf dem Gerät |
| PandaDoc nur optional sichtbar | genommen | Nur zeigen, wenn BYOK verbunden; sonst kein UI-Zwang |
### Happy Path
1. Mitarbeiter öffnet ein Projekt und klickt »Zur Signatur senden«.
2. Im Wizard: PDF auswählen/hochladen, Unterzeichner prüfen, Reihenfolge wählen, Modus »Fern-Link + Code« oder »Vor Ort« einstellen, Nachricht senden.
3. Kunde öffnet den Link, bestätigt den Code, prüft das PDF, setzt die Signatur und schließt ab.
4. Im Projekt springt der Status auf signiert; Original, signiertes PDF und Abschluss-Nachweis sind herunterladbar und in Dateien abgelegt.
### Meldungs-/Error-States (validiert)
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|---|---|---|---|---|
| Kein PDF gewählt | Wizard-Validierung in S02 | ja | Nur dokumentieren | »Wähle ein PDF aus oder lade eins hoch.« |
| Unterzeichner ohne E-Mail bei Fern-Link | Inline-Fehler in S02 | ja | Nur dokumentieren | Vor-Ort-Modus darf ohne Mail gehen, Fern-Link nicht |
| Link abgelaufen/ungültig | 🌐 Klartext-Zustand in S04 | ja | Nur dokumentieren | Keine Projekt-Interna verraten |
| OTP falsch/abgelaufen | Inline-Fehler in S04 | ja | Nur dokumentieren | Neuer Code anfordern |
| Unterzeichner lehnt ab | Status in S03 + Benachrichtigung | nein | Nur dokumentieren | Grund optional, Dokument läuft nicht weiter |
| Dokument zurückgezogen | M01 + Status in S03/S04 | ja | Bauen (M01) | Link wird ungültig, Verlauf bleibt |
| PandaDoc nicht verbunden | Hinweis in S02/S03 | nein | Nur dokumentieren | Default SES bleibt nutzbar |
| PAdES/Versiegelung schlägt fehl | Fehlerzustand in S03 | ja (Abschluss) | Nur dokumentieren | Klartext + Support/erneut versuchen |
---
## 7. Validierte Screen-Liste
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|---|---|---|---|---|---|
| S01 | Signaturen im Projekt | A3/A2 eingebettet | Bauen | Projekt-Detail, Reiter/Aktion | Validiert |
| S02 | Signatur-Wizard | A5 Wizard | Bauen | aus S01 / Projekt-Aktion | Validiert |
| S03 | Signatur-Detail & Status | A3 Detail | Bauen | Signatur öffnen | Validiert |
| S04 | 🌐 Signieren per Link | BESPOKE-Public | Bauen | `/sign/:token` | Validiert (Delta) |
| V01 | Vor Ort unterschreiben 📱 | BESPOKE-Mobile | Bauen | aus S02, Touch-Modus | Validiert |
| M01 | Signatur zurückziehen | Confirm-Modal | Bauen | aus S03 | Validiert |
| D01–D07 | PDF fehlt / Mail fehlt / Link ungültig / OTP / Ablehnung / Provider / Versiegelung | Inline/Zustand | Nur dokumentieren | — | Validiert |
---
## 8. Grid
```text
Projekt-Detail -> S01 (Signaturen im Projekt) -> S02 (Wizard: PDF, Unterzeichner, Reihenfolge, Modus, Nachricht)
S02 -> S04 (Fern-Link + OTP: PDF prüfen, Signatur, Abschluss)
S02 -> V01 (Vor Ort: Gerät übergeben, Touch-Signatur, Abschluss)
S01 -> S03 (Detail: Signer-Status, Verlauf, Downloads)
S03 -> M01 (zurückziehen)
S03: erinnern / signed PDF / Completion Certificate herunterladen
Artefakte: Original-PDF + signiertes PDF + Abschluss-Nachweis -> Projekt-Dateien
Optional: PandaDoc BYOK nur anzeigen, wenn verbunden; Default bleibt SES-Eigenbau
```
---
## 9. Screen-Pakete
- [[S01 Signaturen im Projekt]] · [[S02 Signatur-Wizard]] · [[S03 Signatur-Detail]] · [[S04 Signieren per Link]]
- [[V01 Vor Ort unterschreiben]] · [[M01 Zurueckziehen]]
---
## 10. Offene Fragen
- **Design-Delta:** D-P16 nennt nur den internen Signatur-Wizard; die 🌐 Kunden-Signierseite S04 ist als eigener Screen ergänzt, weil sie für den Flow zwingend sichtbar sein muss.
- PDF-Feldplatzierung: v1 platziert Signatur/Certificate standardisiert; ein frei editierbarer PDF-Tagger bleibt v2.
- Erinnerungsregeln: manuell in v1, automatische Reminder später mit Benachrichtigungen/Automationen klären.
- PandaDoc BYOK: nur zeigen, wenn eine Verbindung existiert; genauer Einstiegsort über WF-P5 Integrationen prüfen.
## Handoff-Check
- [x] Jeder Screen ist mit Umsetzung markiert.
- [x] Meldungs-/Error-State-Matrix ist ausgefüllt.
- [ ] Subframe-Link ist eingetragen. *(Subframe erst nach explizitem OK)*