Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VA-P28g.md
T

132 lines
6.4 KiB
Markdown

# VA-P28g · Admin Revenue, Angebote & E-Signatur
| | |
|---|---|
| **Plane** | `HIVEGRID-195` · Parent `HIVEGRID-190` |
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P28 — Admin Sales Workspace |
| **Cycle/Fenster** | Backlog · nach CRM und E-Mail |
| **Status** | geplant |
> **Owner-Änderung 2026-07-24:** Raffael übernimmt die Delivery. Working-ID, Scope, Status,
> Termine, DoD und Abhängigkeiten bleiben unverändert.
>
> **Dependency-Nachzug 2026-07-24:** Auch `VA-P28b` liegt jetzt bei Raffael; CRM-, Mail-
> und Billing-Verträge sowie `blocked-by`/`blocks` bleiben unverändert.
> ⚠️ **Providerentscheidung:** `GTM-05` nennt Stripe. AD-27 schreibt für HiveGrid Lago self-hosted plus
> Mollie vor. Dieses Ticket erfüllt das fachliche Ziel „Abos automatisiert abrechnen“ über Lago/Mollie.
> Eine wörtliche Stripe-Integration wird nicht gebaut, solange kein expliziter Change Request AD-27 ändert.
## Abhängigkeiten & Parallelität
- **Blocked by:** `VA-P28b`, `VA-P28c` und der ausgelieferte Admin-Billing-Vertrag aus `BILL-06`.
- **Blocks:** `VA-P28h`.
- **Design:** `VD-P28`, nach AD-28 kein Dev-Blocker.
- **Providerbasis:** SES/PAdES bleibt gemäß AD-25 Standard; PandaDoc ist nur optionaler Adapter und kein
DoD-Blocker. `EXT-17` ist wiederverwendbare Vorarbeit, kein Tenant-Credential-Vertrag für Admin.
- **Hardgrenze:** Angebote/Signaturen gehören zu AdminDeal; `Tenant` wird nur nach bestätigtem Lifecycle verknüpft.
## Was wir bauen
Wiederkehrende Deal-Revenue, Produktkatalog und Positionen, Quote Builder mit PDF/Tracking/Annahme,
E-Signatur sowie den kontrollierten Übergang zu HiveGrids Lago-/Mollie-Subscription.
## Story-Ownership — 17/117
### Pipeline-Revenue
- `PIP-12` Deals als monatlich oder jährlich wiederkehrenden Umsatz führen.
- `PIP-13` Abo-Status Trial, aktiv, Verlängerung oder gekündigt führen.
- `PIP-14` Produkte und Positionen an einen Deal hängen.
- `PIP-15` Vor Vertragsende erinnern.
- `PIP-16` Upsell-Chancen bei Bestandskunden führen.
### Angebot und Quote
- `QUOTE-01` Angebot aus Positionen zusammenstellen.
- `QUOTE-02` Produktkatalog mit Preisliste verwenden.
- `QUOTE-03` Rabatte hinterlegen.
- `QUOTE-04` Angebots-PDF generieren.
- `QUOTE-05` Öffnung und Annahme des Angebots sehen.
- `QUOTE-06` Angenommenes Angebot direkt in die E-Signatur überführen.
- `QUOTE-07` Angebotsvorlagen nutzen.
### E-Signatur
- `SIGN-01` Fertiges PDF zum Signieren hochladen.
- `SIGN-02` Mehrere Unterzeichner festlegen.
- `SIGN-03` Signatur-Status verfolgen.
- `SIGN-04` Säumige Unterzeichner automatisch erinnern.
### Billing
- `GTM-05` HiveGrid-Abos automatisiert abrechnen, gemäß AD-27 über Lago/Mollie.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt |
|---|---|
| Deal-Revenue-Tab | Einmalwert, MRR/ARR, Produkte, Subscription, Renewal, Upsell |
| Produktkatalog [`/sales/products`] | Produkte, Preise, Intervalle, Status |
| Quote Builder im Deal | Positionen, Rabatte, Vorlage, Vorschau, Version/Send |
| Quote-Detail [`/sales/quotes/:id`] | Status, Events, PDF, Annahme, Signaturübergang |
| Signatur-Detail [`/sales/signatures/:id`] | Signer, Reihenfolge, Status, Reminder, Dokumente |
| Öffentliche Quote-/Signaturseite | sichere Ansicht, Annahme oder Signatur |
## Definition of Done
- [ ] Deal-Revenue trennt Einmalwert, MRR und ARR; Subscription-State, Vertragsende, Renewal-Reminder und
Upsell-Verknüpfung erfüllen `PIP-12..16`.
- [ ] Produktkatalog/Preise/Positionen sind versionierbar; Quote-Versionen snapshotten Preis, Währung, Steuer-
und Produkttexte, sodass spätere Änderungen alte Angebote nicht verändern.
- [ ] Rabattlogik besitzt klare Reihenfolge, Grenzen, Rundung und optionales Freigabe-Gate.
- [ ] Quote Builder, Vorlagen und reproduzierbares PDF erfüllen `QUOTE-01..04`/`QUOTE-07`; Uploads/PDFs laufen
durch Größenlimit, ClamAV und EU-Storage.
- [ ] Öffnung und Annahme sind tokenisiert, idempotent und als unveränderliche Events sichtbar; Annahme bindet
exakt die akzeptierte Quote-Version.
- [ ] Quote-to-Signature sowie PDF-Upload, Multi-Signer, Reihenfolge, Status, Reminder, Ablauf und Ablehnung
erfüllen `QUOTE-06` und `SIGN-01..04`.
- [ ] SES/PAdES ist Standard und liefert abgeschlossenes Dokument/Audit-Trail; optionale Provideradapter
verwenden Admin-Credentials und verändern den Standardpfad nicht.
- [ ] Gewonnener Deal verknüpft/erzeugt nach bestätigtem Trial-/Won-Vertrag den Tenant und stößt die bestehende
Lago-/Mollie-Subscription idempotent an; Sales-Daten bleiben Admin-gescopet.
- [ ] Admin-RBAC, Audit/Activity, Notification, i18n, Klartextzustände und VM-/Action-Layer sind vollständig.
- [ ] Unit-, PDF-/Crypto-, DB-/RLS-, Worker-, Webhook-, Smoke-, Hot-Swap-/Visual- und kontrollierte
Lago-/Mollie-/Signatur-Live-Proofs sind grün.
**Fortschritt:** **0/10 DoD = 0 % done**.
## Technische Bausteine
- **Schema:** `prisma/schema/adminRevenue.prisma`, `prisma/schema/adminQuotes.prisma`,
`prisma/schema/adminSignatures.prisma`.
- **Modelle:** `AdminProduct`, `AdminPrice`, `AdminDealLineItem`, `AdminDiscount`,
`AdminRevenueSchedule`, `AdminSubscriptionLink`, `AdminRenewalReminder`, `AdminUpsellLink`,
`AdminQuote`, `AdminQuoteVersion`, `AdminQuoteLineItem`, `AdminQuoteEvent`, `AdminQuoteTemplate`,
`AdminSignatureEnvelope`, `AdminSigner`, `AdminSignatureEvent`, `AdminSignatureReminder`.
- **Billing:** bestehende HiveGrid/Lago/Mollie-Contracts wiederverwenden; keine zweite Billing-Source-of-Truth.
- **Wiederverwendung:** PDF-, PAdES-/SES- und Provideradapter nur als Libraries/Ports; keine Tenant-Quote-
oder Tenant-Credential-Zeilen für Admin-Vorgänge.
## Slices und Rollback
Revenue/Products → Quote Builder/PDF/Events → E-Signature → Subscription/Tenant-Link/Renewal/Upsell.
Neue Quote-Versionen sind append-only; Rollback deaktiviert Send/Accept/Sign/Provision, löscht aber keine
rechtlich oder auditrelevanten Artefakte.
## Quellen
- `.planning/ticket-docs/VA-P28b.md`, `VA-P28c.md`, `BILL-06.md`, `EXT-17.md`, `VD-P28.md`
- `docs/ARCHITECTURE-DECISIONS.md` — AD-25, AD-27, AD-28
- AGENTS.md — EU-Stack, Storage/AV, Audit, forward-only Migration
## Dev-Nachzug
- [ ] In der Block-Review Lago/Mollie als fachliche Erfüllung von `GTM-05` bestätigen oder separaten
AD-27-Change-Request anlegen.
- [ ] Zeitpunkt und Regeln der Tenant-Anlage/Verknüpfung bestätigen.
- [ ] Rabatt-/Approval-, Signer- und Retention-Regeln festschreiben.
- [ ] Davids `VD-P28`-Delta integrieren und Visual-Baselines erneuern.