Kevin 4135726772 Abo-Uebersichten: Team-Ansicht konsolidiert, Monatsfilter, Wachstum & Dashboard-KPIs

- /user/abos/ot: Filter nach Eingangsmonat (start_date) ueber neuen UserAbo-Scope
- Konsolidierte Team-Abo-Ansicht nach Ebenen/Linien (Bestand, neue Abos im Monat,
  Eigen-/Kundenabos, Punkte je Ebene + Summen) via TeamAboOverviewService
- team/customers leitet auf konsolidierte Ansicht um; Navigation bereinigt
- Mitglieder-Detail-Modal mit Abo-Zusammenfassung (Eigen-Abo, Kundenabos,
  Punkte, Beginn, naechste Ausfuehrung, Ausfuehrungen)
- Wachstums-Tabelle (Jahr x Monate) + Liniendiagramm (neue Eigen-/Kundenabos)
- Dashboard-KPI-Kachel (Gesamtabos, Kundenabos, 1000-Punkte-Shops)
- i18n de/en/es/fr, Tests (Filter, Overview, Wachstum, Modal, Redirect)

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-06-23 14:07:29 +00:00

23 KiB

Raw Blame History

Entwicklungsplan: Abo-Übersichten erweitern (eigene Kundenabos, Team-Abos, Dashboard)

Status: In Planung · Erstellt: 2026-06-23 · Briefing: Kundenanfrage + docs/salescenter/Todos Backoffice.md

Dokumentations-Hinweis (verbindlich)

Dieser Plan wird Schritt für Schritt abgearbeitet. Für jede Phase gilt:

Der Umsetzungsstatus in diesem Dokument wird nach Abschluss eines Schritts auf ERLEDIGT gesetzt (mit Datum, betroffenen Dateien, Zeilenangaben und kurzer Begründung).
Alle Phasen, Hinweise und getroffenen Detail-Entscheidungen werden sauber dokumentiert – auch Abweichungen vom Plan und Verworfenes (mit Begründung).
Jede Änderung wird programmatisch getestet (Pest), bevor die Phase als erledigt gilt.
Nach Code-Änderungen läuft ./vendor/bin/pint --dirty.

1. Ziel & Briefing-Zusammenfassung

Die Darstellung/Auflistung der Abos im Sales Center (my.mivita.care) soll erweitert werden. Vier Bausteine:

Eigene Kundenabos (/user/abos/ot): Filter nach Monat & Jahr, in dem das Abo hinzugekommen ist (Eingangsmonat).
Team-Abo-Ansichten zusammenführen (/user/abos/team/show + /user/abos/team/customers): Beide Seiten überschneiden sich stark und sollen zu einer Ansicht „Abos im Team" verschmelzen. Inhalt:
- Wer im Team hat wie viele Kundenabos abgeschlossen?
- Sortierung nach Monaten: Wer im Team hat diesen Monat (Monatsfilter) wie viele neue Abos (Kunden- und Eigen-Abos) abgeschlossen?
- Wer im Team hat selbst ein Abo abgeschlossen?
- Gesamtübersicht: Wie viele Abos haben Team-Mitglieder insgesamt?
- Sortierung nach Ebenen (Linien): Wichtigste Ebene ist die 1. Ebene (Wer hat dort ein Abo, wer nicht?), optional ausbaubar auf den gesamten Baum.
Dashboard ergänzen: Anzahl der „1000-Punkte-Shops" und Gesamtabos im Team.

2. Ist-Zustand (Analyse-Ergebnis)

2.1 Eigene Kundenabos `/user/abos/ot`

Bereich	Status heute	Schlüsseldateien
Controller	`AboController@index($view='ot')` lädt `UserAbo` (`member_id = Auth`, `is_for=ot`, `status>=1`), liefert bereits `chartData` (Jahresfilter)	`app/Http/Controllers/User/AboController.php:62-83`
View	Card-Liste pro Abo, oben Monats-Chart (`_abo_chart`) mit Jahres-Umschaltung	`resources/views/user/abo/index.blade.php`, `resources/views/user/abo/_abo_chart.blade.php`
Monatszählung	`AboHelper::getMonthlyAboCounts()` (Snapshot vergangener Monate + Live aktueller Monat)	`app/Services/AboHelper.php:514-565`
Filter	Nur Jahr (Chart). Keine Filterung der Card-Liste nach Eingangsmonat.	–

Fazit: Jahresfilter existiert über den Chart. Es fehlt ein Monat+Jahr-Filter auf die Liste (Abos, deren start_date im gewählten Monat liegt).

2.2 Team-Abos `/user/abos/team/show` & `/user/abos/team/customers`

Route	Methode	Inhalt heute
`user_abos_team_show`	`TeamController@showAbos`	Flache Card-Liste aller eigenen Team-Abos (`is_for=me`, `user_id ∈ Team`), Jahres-Chart `team_abos`. Eine Card pro Abo.
`user_abos_team_customers`	`TeamController@showTeamCustomerAbos`	Kundenabos im Team (`is_for=ot`, `member_id ∈ Team`), gruppiert pro Team-Mitglied (collapsible), anonymisiert, Jahres-Chart `team_cust_abos`.

Beide nutzen AboHelper::getTeamUserIds($userId) (rekursive Downline über m_sponsor, flach, ohne Linien-Information).
Beide nutzen denselben _abo_chart-Partial (nur Jahr).
Überschneidung: Beide listen Team-Abos, nur unterschiedlich (eigene Abos vs. Kundenabos) und unterschiedlich gruppiert. Keine Ebenen-/Linien-Sortierung, keine „neue Abos diesen Monat"-Aggregation pro Person.
Detailseite: TeamController@detailAbo (user_abos_team_detail).

2.3 Dashboard

Bereich	Status heute	Datei
Dashboard-Home	Karten-Grid; Abo-Bezug nur: Einmalprodukt-Card (`_abo_onetime`)	`resources/views/home.blade.php`, `app/Http/Controllers/HomeController.php:45-92`
Team-/Abo-KPIs	Nicht vorhanden auf dem Dashboard	–

2.4 Bereits vorhandenes Backoffice-Statistik-Modul (WICHTIG – Wiederverwendung!)

Es existiert ein VIP-only Modul, das den Großteil der gewünschten Team-Logik bereits abbildet:

Komponente	Datei	Liefert
Controller	`app/Http/Controllers/User/BackofficeStatisticsController.php`	Übersicht / Drilldown / CSV-Export, Monat+Jahr-Filter (Session-persistiert), nur `isVIP()`
Dashboard-Service	`app/Services/Backoffice/BackofficeDashboardService.php`	`lineBuckets($rootUserId)` = Downline gruppiert nach Linien/Ebenen (1..n); pro Linie: Berater-Zahl, Neupartner, Teamabos (`team_partner_abos`), neue Teamabos (`team_partner_abos_new`), Teamkundenabos (`team_customer_abos`), neue (`team_customer_abos_new`), Punkte-Aufschlüsselung, `shop_1000` (1000-Punkte-Shop-Zähler), Umsatz; plus `totals`-Zeile. Snapshots für abgeschlossene Monate.
Drilldown-Service	`app/Services/Backoffice/BackofficeDrilldownService.php`	Personenlisten je Linie+Metrik (Namen, Punkte, Status, Besteht-seit, nächste Ausführung).
Snapshot-Modell	`app/Models/BackofficeStatisticsSnapshot.php`	Eingefrorene Monatswerte pro User.

Schlüssel-Erkenntnis: Die in der Kundenanfrage gewünschte Ebenen-/Monats-/Gesamtlogik existiert technisch schon in BackofficeDashboardService. Wir bauen nicht neu, sondern (a) machen diese Datenquelle für die Abo-Ansicht wiederverwendbar und (b) liefern eine schlankere, für alle Berater zugängliche Abo-fokussierte Ansicht + Dashboard-Widgets.

Definition „1000-Punkte-Shop" (laut Briefing, bereits im Service implementiert): Teampartner, die mind. 1000 Punkte Kundenumsatz im gewählten Monat erzielen (shop1000Count()).

3. Offene Fragen / Annahmen

#	Thema	Annahme (sofern nicht anders entschieden)
A1	„Eingangsmonat" eines Abos	= `start_date` (Anlage-/Aktivierungsdatum). Filter zeigt Abos mit `start_date` im gewählten Monat/Jahr.
A2	Zugänglichkeit der neuen Team-Ansicht	Für alle aktiven Berater (nicht nur VIP), da rein abo-bezogen und über die eigene Downline. Das umfangreiche Punkte-/Umsatz-Backoffice bleibt VIP-only.
A3	Umfang Ebenen	1. Ebene zwingend als Default sichtbar; weitere Linien aufklappbar; „gesamter Baum" als Summenzeile/optionaler Modus.
A4	„selbst ein Abo abgeschlossen"	Eigen-Abo = `UserAbo is_for=me` des Team-Mitglieds (Spalte/Badge pro Person: ja/nein + Punkte).
A5	Zusammenführen der zwei Routen	Neue konsolidierte Seite unter `user_abos_team_show`; `team/customers` wird Weiterleitung/Tab oder entfällt aus der Navigation (Route bleibt vorerst als Redirect).
A6	Dashboard-Widgets-Zielgruppe	Alle aktiven Berater sehen „Gesamtabos im Team" + „1000-Punkte-Shops"; klickbar → neue Team-Abo-Ansicht.

Diese Annahmen bitte vor Umsetzungsbeginn bestätigen oder korrigieren.

4. Lösungsvorschlag (Architektur)

4.1 Gemeinsame Datenquelle: `TeamAboOverviewService` (neu)

Neuer Service app/Services/Abo/TeamAboOverviewService.php, der die Linien-/Monats-/Gesamtlogik abo-fokussiert kapselt und intern BackofficeDashboardService::lineBuckets() (oder eine extrahierte, gemeinsam genutzte Helper-Methode) wiederverwendet.

Liefert je Linie:

line (1..n), consultants (Anzahl Berater dieser Ebene)
members_with_own_abo / members_total (wer hat selbst ein Abo)
team_partner_abos (Summe Eigen-Abos der Ebene) + _new (neu im Monat)
team_customer_abos (Summe Kundenabos der Ebene) + _new
pro Person (für Drilldown/aufgeklappte Ebene): Name, Karriere-Level, Eigen-Abo (ja/Punkte), #Kundenabos + Punkte, #Teamabos darunter
totals-Zeile über alle Linien

Vorteil: Eine zentrale, getestete Datenquelle für Team-Ansicht und Dashboard-Widgets. Refactoring-Hinweis: Falls lineBuckets()/newAboCount()/shop1000Count() aus BackofficeDashboardService extrahiert werden, in einen gemeinsamen Trait/Helper auslagern, um Duplikate zu vermeiden.