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

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