3.3 KiB
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)
- 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
- 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).