# 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.