# 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-P28b` liegt jetzt bei Raffael; sämtliche > Event-/KPI-Quellverträge sowie `blocked-by`/`blocks` bleiben unverändert. ## Abhängigkeiten & Parallelität - **Blocked by:** `VA-P28b`; KPI-spezifisch zusätzlich `VA-P28c`, `VA-P28d`, `VA-P28e`, `VA-P28f` und `VA-P28g`; außerdem `VR-P28a-RBAC` fü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-P19` bleiben 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-01` Gewichteten Pipeline-Forecast sehen. - `REPORT-02` Konversion je Stufe sehen. - `REPORT-03` Verteilung der Verlustgründe sehen. - `REPORT-04` Aktivität je Mitarbeiter sehen. - `REPORT-05` Umsatz- und Abschlussziele je Nutzer setzen und verfolgen. - `REPORT-06` Ziele je Team setzen. - `REPORT-07` Leaderboard sehen. - `REPORT-08` Durchschnittliche Zykluszeit/Sales-Velocity sehen. - `REPORT-09` Win-Rate sehen. - `REPORT-10` MRR und ARR auswerten. - `REPORT-11` Churn auswerten. - `REPORT-12` Reports planen und automatisch versenden. - `REPORT-13` Dashboard 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`, `AdminReportDelivery` plus 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-P28b` bis `VA-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.