4.3 KiB
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)
- Touch-Signatur vor Ort (Canvas → ins Angebots-/Abnahme-PDF) + Fern-Link-Signatur (remote annehmen)
- OTP-Identifizierung (E-Mail; SMS als stärkere Zwei-Kanal-Option)
- PDF-Versiegelung (PAdES mit HiveGrid-Organisations-Zertifikat → Änderung bricht Signatur)
- Zeitstempel (TSA, RFC 3161; nicht-qualifiziert genügt)
- Audit-Trail über M001 (Link/Öffnen/OTP/Signatur: wer, wann, IP, Gerät, Geo, PDF-Hash; append-only)
- Completion-Certificate als PDF-Anhang (sichtbare Beweis-Doku)
- 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).
- Signatur-Provider-Frage entschieden: gehärtete SES-Eigenbau, kein externer Provider (AD-25)
- 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.