Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/EXT-09.md
T

3.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 In Progress

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). Abweichung vom Pflichtenheft (V.4.4 nannte PandaDoc als den Provider) → AD-25. 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

  • 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)
  • Umsetzung in P16 (AK-P16d) — Touch + Fern-Link + OTP + PAdES-Versiegelung + Audit + Completion-Cert
  • (vor Go-Live) anwaltliche Bestätigung der Beweis-/Form-Einordnung (SES genügt, §650h→QES)

Hinweis

QES-Add-on (Bauvertragskündigung §650h) ist nach EXT-17 ausgelagert (v2, via D-Trust). AES nur bei Bedarf später (Adapter).