132 lines
6.4 KiB
Markdown
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.
|