5.0 KiB
AK-P16d · P16 Angebot/Signatur (PandaDoc)
| Typ | Dev (Code) |
| Owner | Akeshan |
| Phase | P16 — Kalender, Booking, Forms & Signatur |
| Cycle/Fenster | W4 — USP, Härtung & Launch · fällig 2026-07-07 · Gate W4 |
| Status | geplant |
⚠️ Scope-Update (AD-25, 2026-06-21 — Raffael): Signatur-Default ist jetzt der gehärtete SES-Eigenbau (kein PandaDoc-Zwang), umgesetzt über
defineAdapter(Adapterses-selfhosted). PandaDoc bleibt nur als optionaler BYOK-Adapter (pandadoc-byok, Tenant bringt eigenen Key) — Anbindungs-Spec in EXT-17. Dieses Ticket bitte entsprechend bauen: SES als Default (Touch vor Ort + Fern-Link + OTP + PAdES-Versiegelung + Zeitstempel + M001-Audit + Completion-Certificate, s. EXT-09/AD-25), PandaDoc als Opt-in daneben. DoD unten ist noch PandaDoc-zentriert und wird beim Bau gemäß AD-25 auf „SES-Default + BYOK-Adapter" angepasst. (Rechtlich: SES genügt im SHK; QES nur § 650h, später via D-Trust.)
Abhängigkeiten & Parallelität
- Blocked by:
EXT-09(SES-Eigenbau-Spec + Adapter-Modell; PandaDoc nur noch optional via BYOK EXT-17) - Blocks: — (Endpunkt der P16-Schiene)
- Läuft parallel zu: Raffaels Kern-Kette + den anderen P16-Slices. Implizit auf R-P5 (Signatur =
DataConnectionüber Apps-Engine) und auf den Projekt-Kern (R-P8/P9 — Signatur hängt amProjekt, NICHT „Deal"). Eigeneprisma/schema/signature.prisma(AD-21). - Konflikt-Risiko: gering — additive Tabellen;
apps.prisma/crm.prisma/files.prismanur über Relationen.
Was wir bauen
Multi-Signer-Angebots-Signatur über PandaDoc (DocuSign-Adapter bleibt möglich, läuft über die Apps-Engine M33a): PDF-Upload (aus Files oder neu) → Unterzeichner (Name vorausgefüllt aus Kontakt, Email, Rolle, Reihenfolge sequenziell/parallel) → Senden, mit Webhook-Verarbeitung und Status-Tracking je Unterzeichner (entwurf/gesendet/angesehen/signiert/abgelehnt), Erinnerung, Widerruf und optionalem Auto-Stage-Wechsel. Das signierte PDF landet in Files. Pivot-Hart: Signatur hängt am Projekt-Kern (ProjektSignatureDocument/ProjektSignatureSigner), kein eigenes „Deal"-Objekt — Einstieg lebt im Projekt-Detail (P8/P9).
Benötigte Screens (Backend bedient — Design liefert D-BOOK + D-P16)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Signatur-Wizard [im Projekt-Detail] | PDF-Upload (aus Files/neu) → Unterzeichner (Name aus Kontakt, Email, Rolle, Reihenfolge sequenziell/parallel) → Provider (PandaDoc, Default) → Senden; Status-Tracking je Unterzeichner + Erinnerung + Widerruf; Original- + Signed-PDF-Download |
Definition of Done
- PDF-Upload → Multi-Signer via PandaDoc über die Apps-Engine (M33a)
- Webhook-Verarbeitung + Status-Tracking pro Unterzeichner (entwurf/gesendet/angesehen/signiert/abgelehnt)
- Erinnerung + Widerruf + optionaler Auto-Stage-Wechsel; Signed-PDF landet in Files
- Signatur hängt am
Projekt-Kern (ProjektSignatureDocument/ProjektSignatureSigner) — kein „Deal"-Objekt - Permission-Bundle
signature.*(read/send/revoke/admin) serverseitig Owner-gefiltert - Konnektor
tenantHasModule('signature'); RLS auf allen Tenant-Tabellen
Technische Bausteine
- Entities (eigene
prisma/schema/signature.prisma):SignatureProviderConnection(data_connection_id → Apps-Engine!, provider PandaDoc, is_default),ProjektSignatureDocument(projekt_id, provider_document_id, source_pdf_file_id, status draft/sent/viewed/signed/declined, signed_pdf_file_id — [Soft-Delete]),ProjektSignatureSigner(document_id, signer_email/name, linked_kontakt_id, status, signed_at).apps.prisma/crm.prisma/files.prismanur über Relationen (AD-21). - Signatur = Apps-Engine-Connection (R-P5): OAuth/API-Key + Health vom Framework; hier Provider-Adapter PandaDoc.
- Webhook-Handler (Signatur-Check) → Status-Übergänge je Signer + Activity-Write; Auto-Stage-Wechsel über Pipeline (P8/P9, optional).
- RLS überall;
signature.*-Bundle; signiertes PDF via FileEntityLink an den Projekt-Kern. - Konnektor
tenantHasModule('signature');is_demo_dataauf Demo-Dokumenten.
Quellen (granular)
ENTITY-MODEL.md→ Domäne 9 (SignatureProviderConnection, ProjektSignatureDocument/Signer — am Projekt-Kern, AD-20)REQUIREMENTS.md→REQ-signatur-datenmodell(⚠ Bezeichner „Deal" pre-pivot — giltProjekt),REQ-signatur-providerROADMAP.md→ Phase 16 ·PHASE-SOURCES.md→ Phase 16 (M130-erstellung, M131-pandadoc-docusign, M132-status-tracking)designer-briefs/P16-kalender-booking-forms-signatur.md(Gruppe 4 Signatur; PandaDoc v1, Pivot-Hinweis Projekt-Kern)_bmad-output/specs/M07-angebot-signatur.md(⚠ teils pre-pivot — ENTITY-MODEL hat Vorrang)
Dev-Nachzug (nach Davids D-BOOK/D-P16-Delta)
- Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- REQUIREMENTS/PHASE-SOURCES nachgezogen
- Plane-Ticket
AK-P16daktualisiert