Statistiken: Kundenfeedback 2026-08-19 komplett (N1-N8) + Review-Fixes + VP-/Incentive-Repair gehärtet

Statistik-Änderungen 2026-08-19 (dev/2026-07-22/entwicklungsplan-2026-08-19.md, alle 8 Pakete gemäß beantworteten F-Fragen):
- N1 Monatsstatistik: Team-Cluster (Firstlines klickbar -> neue Seite user_team_firstlines, Teampartner gesamt/Payline [nur aktive], Abos Payline mit +N) + Level-Kachel (Quali-Stufe, fehlende Payline-/persönliche Punkte, Karriere-Level); LiveCommissionService-Snapshot v3 reicht Level-/Quali-Daten durch
- N2 Abo-Kacheln auf Home monatsbezogen (aboStockCount-Rückrechnung über cancel/deleted/Status-Historie; VIP-Statistik bleibt tagesaktuell)
- N3 VIP-Statistik 'Recruiter des Monats' (Neupartner-Definition wie KPI, rekursives Ketten-Volumen als Gesamtpunkte inkl. Starterpaket) + Drilldown/CSV-Spalte 'Punkte gesamt'
- N4 Prognose-Block 'Level & Provision laut Prognose (Stand 25.)' mit unverbindlich-Kennzeichnung (ebenengenaue offene Abo-Punkte + TP-Laufstände)
- N5 Checkout-Herkunft: Dropdown raus, Pflicht-Freitext (lokalisierte Fehlermeldung)
- N6 Berater-Profilfoto (user_accounts.profile_image, Einwilligung als Sprachkey-Platzhalter, DSGVO-Löschung) + teaminterne Top-3-Karte (TopResultsService, Scope-Schalter)
- N7 USt-Optionen: 'nicht umsatzsteuerpflichtig' zuerst + '§ 19 UStG'-Textfix
- N8 Jahresgebühr-Nachfassliste je Berater (AnnualFeeDueService, überfällig/1-3 Monate, Sidenav)

Kontroll-Review (8 Perspektiven) angewendet: next-Level-Fallback im Steady-State (resolveNextLevel — sonst 'Höchstes Level erreicht' für Normalfälle), _calculated-Punktebasis bei mehr Paylines, keine Wiederbelebung deaktivierter Abos in der Monatsrückrechnung, Payline-Abo-Kachel monatskonsistent, Top-3-Nachrücker; Performance: BackofficeDashboardService als Singleton mit lineBuckets-Memo (+flushLineBucketsMemo), level_forecast 6h-Cache; Reuse: User-Scopes firstlinesOf/newPartnerIn, SalesVolumePoints::totalPointsByUser, Slim::storeCroppedImage (3 Upload-Kopien vereinigt), activeAbo-Scope statt Inline-Prädikate, Form::open-Konvention, Return-Types

Repair-Härtung (Kundenentscheide): VP-Nachtrepair dedupliziert über shopping_order_id (Live-Pfad schreibt sie jetzt mit), zählende Alt-Zeilen-Erkennung, Vormonats-Scan für Monatswechsel, Firmenaccount-Buchungen (config mivita.company_user_id) werden automatisch auf den Berater umgebucht (in place bzw. per Gegenbuchung bei geschlossenem Monat; Echtfall Anna Schall Order 58797 -> Christina Schuder), Berater-zu-Berater nur Warnung; Incentive-Repair: m_sponsor=NULL löscht nicht mehr, FK-Repair vor Stale-Bereinigung, gebatchte Lookups, zentrales Incentive::qualificationWindow(); .env aus dem Git-Tracking entfernt (Pflege per SFTP)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Kevin 2026-08-21 10:44:44 +00:00
parent 841d87e161
commit 867dc21b57
87 changed files with 4480 additions and 240 deletions

View file

@ -102,6 +102,7 @@
@elseif ($details['metric'] === 'new_partners')
<th data-sortable="true"><span class="sortable-label">Sponsor <i class="ion ion-ios-swap sort-icon"></i></span></th>
<th class="text-right" data-sortable="true" data-sort-type="number"><span class="sortable-label justify-content-end">Kundenpunkte <i class="ion ion-ios-swap sort-icon"></i></span></th>
<th class="text-right" data-sortable="true" data-sort-type="number" title="Eigen- und Kundenpunkte des Monats zusammen — inkl. Starterpaket"><span class="sortable-label justify-content-end">Punkte gesamt <i class="ion ion-ios-swap sort-icon"></i></span></th>
<th data-sortable="true" data-sort-type="date"><span class="sortable-label">Aktiv seit <i class="ion ion-ios-swap sort-icon"></i></span></th>
<th data-sortable="true" data-sort-type="date"><span class="sortable-label">Account gültig bis <i class="ion ion-ios-swap sort-icon"></i></span></th>
@else
@ -169,6 +170,7 @@
@elseif ($details['metric'] === 'new_partners')
<td>{{ $row['sponsor'] ?? '-' }}</td>
<td class="text-right font-weight-bold">{{ \App\Services\Util::formatNumber($row['customer_points'] ?? 0) }}</td>
<td class="text-right font-weight-bold">{{ \App\Services\Util::formatNumber($row['total_points'] ?? 0) }}</td>
<td>{{ $row['active_date'] ?? '-' }}</td>
<td>{{ $row['payment_account'] ?? '-' }}</td>
@else
@ -211,6 +213,7 @@
@elseif ($details['metric'] === 'new_partners')
<td></td>
<td class="text-right">{{ \App\Services\Util::formatNumber($details['summary']['customer_points'] ?? 0) }}</td>
<td class="text-right">{{ \App\Services\Util::formatNumber($details['summary']['total_points'] ?? 0) }}</td>
<td></td>
<td></td>
@else

View file

@ -432,6 +432,109 @@
</div>
</div>
@php
$recruiterRanking = $statistics['recruiter_ranking'] ?? null;
@endphp
<div class="row">
<div class="col-lg-6 mb-4">
<div class="card">
<div class="card-header d-flex justify-content-between align-items-center">
<div>
<h5 class="mb-0">Recruiter des Monats</h5>
<div class="text-muted small"
title="Neupartner wie in der Neupartner-Kennzahl (aktiver Account, im Monat aktiv geworden). Neues Volumen = Monats-Gesamtpunkte der Neupartner (Eigen- und Kundenpunkte, inkl. Starterpaket) plus Kettenvolumen: Punkte der Neupartner, die diese Neupartner im selben Monat selbst geworben haben.">
{{ $selectedMonthName }} {{ $selectedYear }} · nach Anzahl gesponserter Neupartner
<span class="ion ion-md-information-circle-outline"></span>
</div>
</div>
<span class="display-4 font-weight-bold text-primary mb-0">
{{ number_format((float) ($statistics['totals']['new_partners'] ?? 0), 0, ',', '.') }}
</span>
</div>
@if ($recruiterRanking === null)
<div class="card-body">
<p class="text-muted mb-0">
Für diesen Monat liegt noch ein älterer Snapshot ohne diese Liste vor.
</p>
</div>
@elseif (count($recruiterRanking) === 0)
<div class="card-body">
<p class="text-muted mb-0">In diesem Monat wurden keine Neupartner gesponsert.</p>
</div>
@else
<div class="table-responsive">
<table class="table table-hover mb-0">
<thead>
<tr>
<th>Sponsor</th>
<th class="text-right">Neupartner</th>
<th class="text-right" title="Monats-Gesamtpunkte der Neupartner inkl. Kettenvolumen">neues Volumen</th>
</tr>
</thead>
<tbody>
@foreach ($recruiterRanking as $row)
<tr data-toggle="collapse" data-target="#recruiter-partners-{{ $loop->index }}"
role="button" style="cursor: pointer;"
title="Klick: geworbene Neupartner anzeigen">
<td>
<div class="font-weight-semibold">
{{ $row['name'] }}
@if (!empty($row['is_self']))
<span class="badge badge-pill badge-info ml-1">ich</span>
@endif
</div>
<div class="text-muted small">{{ !empty($row['is_self']) ? 'Eigene Neupartner' : 'Linie '.$row['line'] }} · {{ $row['career_level'] }}</div>
</td>
<td class="text-right align-middle">
<span class="badge badge-pill badge-success backoffice-statistics-click-badge">
+{{ number_format((float) $row['new_partner_count'], 0, ',', '.') }}
</span>
</td>
<td class="text-right align-middle font-weight-bold">
{{ \App\Services\Util::formatNumber($row['volume_points']) }} P.
</td>
</tr>
<tr class="collapse bg-light" id="recruiter-partners-{{ $loop->index }}">
<td colspan="3" class="py-2">
<ul class="list-unstyled small mb-0">
@foreach ($row['partners'] ?? [] as $partner)
<li class="{{ $loop->last ? 'mb-0' : 'mb-1' }}">
<span class="font-weight-semibold">{{ $partner['name'] }}</span>
<span class="text-muted">· {{ $partner['career_level'] }}</span>
· {{ \App\Services\Util::formatNumber($partner['total_points']) }} P.
@if (!empty($partner['children']))
<ul class="list-unstyled text-muted ml-3 mb-0">
@foreach ($partner['children'] as $child)
<li>
↳ {{ $child['name'] }}
· {{ $child['career_level'] }}
· {{ \App\Services\Util::formatNumber($child['total_points']) }} P.
</li>
@endforeach
</ul>
@endif
</li>
@endforeach
</ul>
</td>
</tr>
@endforeach
</tbody>
</table>
</div>
<div class="card-body pt-2 pb-3">
<p class="text-muted small mb-0">
<strong>neues Volumen</strong> = Monats-Gesamtpunkte (Eigen- und Kundenpunkte, inkl. Starterpaket)
der geworbenen Neupartner — plus rekursiv die Punkte der Neupartner, die diese im selben Monat
selbst geworben haben. Klick auf eine Zeile zeigt, wer geworben wurde.
</p>
</div>
@endif
</div>
</div>
</div>
@php
$topCustomerAbos = $statistics['top_customer_abos'] ?? null;
@endphp