6.4 KiB
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-P28bliegt jetzt bei Raffael; CRM-, Mail- und Billing-Verträge sowieblocked-by/blocksbleiben unverändert.
⚠️ Providerentscheidung:
GTM-05nennt 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-P28cund der ausgelieferte Admin-Billing-Vertrag ausBILL-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-17ist wiederverwendbare Vorarbeit, kein Tenant-Credential-Vertrag für Admin. - Hardgrenze: Angebote/Signaturen gehören zu AdminDeal;
Tenantwird 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-12Deals als monatlich oder jährlich wiederkehrenden Umsatz führen.PIP-13Abo-Status Trial, aktiv, Verlängerung oder gekündigt führen.PIP-14Produkte und Positionen an einen Deal hängen.PIP-15Vor Vertragsende erinnern.PIP-16Upsell-Chancen bei Bestandskunden führen.
Angebot und Quote
QUOTE-01Angebot aus Positionen zusammenstellen.QUOTE-02Produktkatalog mit Preisliste verwenden.QUOTE-03Rabatte hinterlegen.QUOTE-04Angebots-PDF generieren.QUOTE-05Öffnung und Annahme des Angebots sehen.QUOTE-06Angenommenes Angebot direkt in die E-Signatur überführen.QUOTE-07Angebotsvorlagen nutzen.
E-Signatur
SIGN-01Fertiges PDF zum Signieren hochladen.SIGN-02Mehrere Unterzeichner festlegen.SIGN-03Signatur-Status verfolgen.SIGN-04Säumige Unterzeichner automatisch erinnern.
Billing
GTM-05HiveGrid-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-06undSIGN-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.mddocs/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-05bestä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.