# 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 - [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) - [ ] 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).