Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/EXT-09.md
T

62 lines
4.3 KiB
Markdown

# EXT-09 · E-Signatur: gehärtete SES-Eigenbau (kein externer Provider)
| | |
|---|---|
| **Typ** | Architektur-Entscheidung / Setup |
| **Owner** | Raffael |
| **Cycle/Fenster** | v1 — Umsetzung in P16 (AK-P16d) |
| **Status** | Done (2026-06-28) — Entscheidungs-/Setup-Scope erfüllt; Bau ausgelagert nach AK-P16d |
## Entscheidung (2026-06-21) — siehe [[AD-25]]
Default = HiveGrid baut die Signatur (Angebote/Aufträge/Abnahmen) **selbst als gehärtete SES** — souverän, günstig,
rechtlich ausreichend. **PandaDoc bleibt als optionale BYOK-Anbindung** ([[EXT-17]]): Tenant mit eigenem Account
trägt seinen Key ein (Opt-in). AD-25 ersetzt die frühere Annahme, PandaDoc sei der alleinige Provider.
**Yousign/Skribble/DocuSeal fallen weg; PandaDoc nur noch als Opt-in-Adapter, nicht als Default.**
**Warum (Kurzfassung, Details in AD-25):**
- **Rechtlich:** SHK-Dokumente formfrei/Textform → SES genügt (auch Verbraucherbauvertrag §650i = Textform). Einziger QES-Pflichtfall: Bauvertragskündigung §650h (selten → EXT-17/v2).
- **Praxis:** Marktstandard = SES-Touch vor Ort + Fern-Link; alle Handwerker-Tools machen SES, kein AES/QES-Druck.
- **Souveränität:** US-Provider = CLOUD Act (bricht „100 % EU"); EU-Provider/OSS geprüft → Eigenbau gewinnt.
## Was zu bauen ist (gehärtete SES — praktisch auf AES-Beweisniveau)
1. **Touch-Signatur vor Ort** (Canvas → ins Angebots-/Abnahme-PDF) + **Fern-Link-Signatur** (remote annehmen)
2. **OTP-Identifizierung** (E-Mail; SMS als stärkere Zwei-Kanal-Option)
3. **PDF-Versiegelung** (PAdES mit HiveGrid-Organisations-Zertifikat → Änderung bricht Signatur)
4. **Zeitstempel** (TSA, RFC 3161; nicht-qualifiziert genügt)
5. **Audit-Trail** über M001 (Link/Öffnen/OTP/Signatur: wer, wann, IP, Gerät, Geo, PDF-Hash; append-only)
6. **Completion-Certificate** als PDF-Anhang (sichtbare Beweis-Doku)
7. **Einmal-Link** (personengebunden) + expliziter **„Intent to sign"**
## Architektur
- Signatur über **`defineAdapter`** (Apps-Engine, provider-agnostisch). v1-Adapter: **`ses-selfhosted`** (Default) + **`pandadoc-byok`** (optional, Tenant-Key → [[EXT-17]]).
- Spätere Stufen ohne Fachcode-Umbau: **AES** (Yousign managed oder EU-DSS-Library/Java-Sidecar self-hosted), **QES** (D-Trust sign-me, Hash-only) für § 650h.
- **Schon vorhanden** (Bausteine): Auth/Identität (P2-Kette), M001-Audit-Log, PDF-Erzeugung (P16), E-Mail (MailerSend), Datenmodell `ProjektSignatureDocument`/`Signer`.
- **Neu zu bauen:** Touch/Link-Signatur-UI (P16-Wizard), OTP-SMS, Org-Signing-Zertifikat + PAdES-Versiegelung, TSA-Anbindung, Completion-Certificate.
## Warum / was es blockt
- **Blocks:** P16 (Angebot/Signatur, AK-P16d) — dort wird die SES gebaut.
## Abhängigkeiten
- **blocked-by:** — (kein externer Account mehr nötig)
- **blocks:** P16 (AK-P16d)
## Definition of Done
Dies ist ein **Entscheidungs-/Setup-Ticket** — „done" heißt: Provider-Frage geklärt + Architektur festgelegt. Die *Bau*-Umsetzung gehört bewusst nicht hierher (siehe unten).
- [x] Signatur-Provider-Frage entschieden: **gehärtete SES-Eigenbau, kein externer Provider** ([[AD-25]])
- [x] Modell + Architektur festgelegt (7-Punkte-Härtung, `defineAdapter`, AES/QES-Pfad offen)
**Bewusst ausgelagert (nicht Teil dieses Tickets):**
- → **Umsetzung in P16 (`AK-P16d`)** — Touch + Fern-Link + OTP + PAdES-Versiegelung + Audit + Completion-Cert. EXT-09 *blockt* AK-P16d; dort wird gebaut + abgehakt.
- → **Go-Live-Gate (anwaltlich):** Bestätigung der Beweis-/Form-Einordnung (SES genügt, §650h→QES) läuft über [[EXT-03]] kurz vor Launch.
## Hinweis
QES-Add-on (Bauvertragskündigung §650h) ist nach [[EXT-17]] ausgelagert (v2, via D-Trust). AES nur bei Bedarf später (Adapter).
## Umsetzungs-Notiz (2026-06-28)
**Status: Done — 2/2 Entscheidungs-DoD grün = 100 % des Ticket-Scopes.** Die Provider-Frage ist mit [[AD-25]]
abschließend entschieden (gehärtete SES-Eigenbau als Default, PandaDoc nur als optionaler BYOK-Adapter [[EXT-17]]),
die Architektur steht (`defineAdapter` provider-agnostisch, `ses-selfhosted` + `pandadoc-byok`, AES/QES-Pfad offen
ohne Fachcode-Umbau). PandaDoc-BYOK wurde im POC end-to-end validiert (siehe [[EXT-17]]). Die eigentliche
SES-Bau-Arbeit (7-Punkte-Härtung) ist in **AK-P16d** verortet, das EXT-09 blockt — kein Doppel-Tracking hier.
Plane-Titel von „PandaDoc-Sandbox (Provider-Wahl)" auf den realen Scope angeglichen.