Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,58 @@
|
||||
# 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` (Adapter `ses-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 am `Projekt`, NICHT „Deal"). Eigene `prisma/schema/signature.prisma` (AD-21).
|
||||
- **Konflikt-Risiko:** gering — additive Tabellen; `apps.prisma`/`crm.prisma`/`files.prisma` nur ü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.prisma` nur ü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_data` auf 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 — gilt `Projekt`), `REQ-signatur-provider`
|
||||
- `ROADMAP.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-P16d` aktualisiert
|
||||
Reference in new issue
Block a user