5.2 KiB
VA-P28h · Admin Sales Reporting & Dashboard
| Plane | HIVEGRID-196 · Parent HIVEGRID-190 |
| Typ | Dev (Code) |
| Owner | Raffael |
| Phase | P28 — Admin Sales Workspace |
| Cycle/Fenster | Backlog · nach den fachlichen Sales-Event-Verträgen |
| 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; sämtliche Event-/KPI-Quellverträge sowieblocked-by/blocksbleiben unverändert.
Abhängigkeiten & Parallelität
- Blocked by:
VA-P28b; KPI-spezifisch zusätzlichVA-P28c,VA-P28d,VA-P28e,VA-P28fundVA-P28g; außerdemVR-P28a-RBACfür Rollen-, Own-/All-Scope- und serverseitigen Widget-Allowlist-Vertrag. - Blocks: —
- Design:
VD-P28, nach AD-28 kein Dev-Blocker. - Hardgrenze: ausschließlich Admin-Sales-Daten; Tenant-Betriebs-KPIs aus
AK-P19bleiben getrennt.
Was wir bauen
Einen dokumentierten Admin-Sales-KPI-Vertrag, belastbare Aggregate, Ziele/Leaderboard, konfigurierbare Dashboards und geplanten Reportversand für Vertriebsleitung und Geschäftsführung.
Story-Ownership — 13/117
REPORT-01Gewichteten Pipeline-Forecast sehen.REPORT-02Konversion je Stufe sehen.REPORT-03Verteilung der Verlustgründe sehen.REPORT-04Aktivität je Mitarbeiter sehen.REPORT-05Umsatz- und Abschlussziele je Nutzer setzen und verfolgen.REPORT-06Ziele je Team setzen.REPORT-07Leaderboard sehen.REPORT-08Durchschnittliche Zykluszeit/Sales-Velocity sehen.REPORT-09Win-Rate sehen.REPORT-10MRR und ARR auswerten.REPORT-11Churn auswerten.REPORT-12Reports planen und automatisch versenden.REPORT-13Dashboard mit eigenen Kacheln zusammenstellen.
Benötigte Screens
| Screen [Admin-Host-Route] | Kern-Inhalt |
|---|---|
Dashboard [/sales/dashboard] |
frei angeordnete, registrierte KPI-Kacheln |
Pipeline [/sales/reports/pipeline] |
Forecast, Conversion, Loss, Velocity, Win-Rate |
Aktivität [/sales/reports/activity] |
Calls, Mails, Meetings, Tasks und Deals je Mitarbeiter |
Revenue [/sales/reports/revenue] |
Bookings, MRR, ARR, Renewal und Churn |
Ziele [/sales/goals] |
Nutzer-/Teamziele und Leaderboard |
Schedules [/sales/reports/schedules] |
Report, Filter, Empfänger, Frequenz, letzte Zustellung |
Definition of Done
- Jede Kennzahl besitzt eine versionierte, dokumentierte Formel mit Zeitbezug, Zeitzone, Währung, Filterbasis, Ein-/Ausschlüssen und deterministischen Fixtures.
- Forecast, Stage-Conversion, Verlustgründe, Sales-Velocity und Win-Rate basieren auf
AdminDealStageHistory/Events statt nur auf aktuellem Zustand. - Aktivitätsauswertung trennt Call, Mail, Meeting, Task und Deal je AdminUser und respektiert Rollen-/Sichtbarkeitsrechte.
- Nutzer-/Teamziele, Fortschritt und Leaderboard sind perioden- und währungsfest; Zieländerungen werden historisiert und auditiert.
- MRR/ARR basieren auf Revenue-Schedules/Subscription-Link; Churn basiert auf verknüpftem Subscription- Status und dokumentierter Churn-Formel.
- Dashboard Builder verwendet ausschließlich eine registrierte Tile-Allowlist mit sicheren Filtern; keine freie Query, kein freies HTML und keine Codeausführung.
- Geplante Reports speichern Definition/Empfänger/Frequenz, berechnen Berechtigungen zum Ausführungszeitpunkt neu und versenden über zentralen Notification-/Mail-Pfad mit Delivery-Historie.
- Aggregate sind idempotent neu aufbaubar, beobachten Lag/Fehler und stimmen per Contract-Test mit Source-Events überein.
- Admin-RBAC, Audit, i18n, Empty/Loading/Error/404, VM-/Action-Layer sowie Unit-/DB-/Aggregate-/Smoke-/ Hot-Swap-/Visual- und Scheduled-Delivery-Tests sind grün.
Fortschritt: 0/9 DoD = 0 % done.
Technische Bausteine
- Schema:
prisma/schema/adminSalesReporting.prisma. - Modelle:
AdminSalesGoal,AdminSalesTeam,AdminSalesTeamMember,AdminDashboard,AdminDashboardTile,AdminReportDefinition,AdminReportSchedule,AdminReportDeliveryplus versionierte Aggregate/Materialisierungen. - KPI Registry: zentrale ID, Formelversion, benötigte Permission, Filter-/Drilldown-Schema und Renderer-VM.
- Wiederverwendung: Dashboard-Registry/Chart-Komponenten dürfen extrahiert werden; keine Tenant-Queries oder Tenant-KPI-Tabellen als Admin-Source-of-Truth.
Slices und Rollback
KPI-Verträge/Aggregate → Pipeline/Activity/Revenue → Goals/Leaderboard → Dashboard Builder → Scheduled Delivery. Jede Formelversion bleibt reproduzierbar; Rollback setzt Tile/Report auf letzte stabile Version und löscht keine historischen Aggregate.
Quellen
- Ticket-Docs
VA-P28bbisVA-P28g,VD-P28 docs/ARCHITECTURE-DECISIONS.md— AD-27/AD-28- AGENTS.md — Reporting-/Notification-/VM-/Test-Verträge
Dev-Nachzug
- KPI-Formeln, Goal-Perioden und Leaderboard-Sichtbarkeit in der Block-Review bestätigen.
- Berichtsempfänger/Dateiformat/Retention festschreiben.
- Davids
VD-P28-Delta integrieren und Visual-Baselines erneuern.