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

@ -7,6 +7,7 @@ use App\Models\UserAboItem;
use App\Models\UserLevel;
use App\Models\UserSalesVolume;
use App\Services\Backoffice\BackofficeDashboardService;
use App\Services\Backoffice\BackofficeDrilldownService;
use App\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;
@ -31,7 +32,7 @@ function bslMakeLevel(string $name, int $pos): UserLevel
]);
}
function bslMakeUser(?int $sponsorId = null, ?int $levelId = null): User
function bslMakeUser(?int $sponsorId = null, ?int $levelId = null, ?string $activeDate = null): User
{
return User::forceCreate([
'email' => 'bsl-'.uniqid('', true).'@example.com',
@ -39,7 +40,7 @@ function bslMakeUser(?int $sponsorId = null, ?int $levelId = null): User
'lang' => 'de',
'm_level' => $levelId ?? 1,
'm_sponsor' => $sponsorId,
'active_date' => '2026-01-15',
'active_date' => $activeDate ?? '2026-01-15',
'payment_account' => now()->addYear(),
]);
}
@ -288,6 +289,8 @@ it('ergaenzt beim Snapshot-Overlay Linien, die erst nach dem Snapshot entstanden
bslMakeAbo($ben->id, 'me', '2026-07-01');
bslMakeAbo($ben->id, 'ot', '2026-07-02');
$service->flushLineBucketsMemo(); // Struktur hat sich im selben Prozess geändert
$overview = $service->overview($root, 5, 2026);
expect($overview['_meta']['source'])->toBe('snapshot')
@ -433,3 +436,103 @@ it('ignoriert Abo-Punkte geloeschter Produkte im Soll der Top-10-Umsatzliste', f
->and($byPoints[0]['user_id'])->toBe($anna->id)
->and($byPoints[0]['points_target'])->toBe(40.0);
});
it('rankt Recruiter des Monats nach gesponserten Neupartnern inklusive ich', function (): void {
$root = bslMakeUser(); // active_date Januar — selbst kein Neupartner
$anna = bslMakeUser($root->id, null, '2026-06-05');
$ben = bslMakeUser($root->id, null, '2026-06-10');
$carla = bslMakeUser($anna->id, null, '2026-06-12'); // von Anna im selben Monat geworben
bslMakeUser($anna->id, null, '2026-05-12'); // Mai, zaehlt nicht
bslMakeUser($root->id); // Januar-Bestand, zaehlt nicht
// abgelaufener Account: zaehlt nicht als Neupartner
$expired = bslMakeUser($root->id, null, '2026-06-20');
$expired->forceFill(['payment_account' => now()->subDay()])->save();
$ranking = app(BackofficeDashboardService::class)->overview($root, 6, 2026)['recruiter_ranking'];
expect($ranking)->toHaveCount(2)
->and($ranking[0]['user_id'])->toBe($root->id)
->and($ranking[0]['is_self'])->toBeTrue()
->and($ranking[0]['line'])->toBe(0)
->and($ranking[0]['new_partner_count'])->toBe(2)
->and(collect($ranking[0]['partners'])->pluck('user_id')->sort()->values()->all())
->toBe(collect([$anna->id, $ben->id])->sort()->values()->all())
->and($ranking[1]['user_id'])->toBe($anna->id)
->and($ranking[1]['is_self'])->toBeFalse()
->and($ranking[1]['line'])->toBe(1)
->and($ranking[1]['new_partner_count'])->toBe(1)
->and($ranking[1]['partners'][0]['user_id'])->toBe($carla->id);
// Carla erscheint in Roots Detailliste eingerueckt unter Anna
$annaEntry = collect($ranking[0]['partners'])->firstWhere('user_id', $anna->id);
expect($annaEntry['new_partner_count'])->toBe(1)
->and($annaEntry['children'][0]['user_id'])->toBe($carla->id);
});
it('summiert das Recruiter-Volumen aus Eigen- und Kundenpunkten inklusive Kettenvolumen', function (): void {
$root = bslMakeUser();
$anna = bslMakeUser($root->id, null, '2026-06-05'); // Neupartner von Root
$ben = bslMakeUser($anna->id, null, '2026-06-15'); // Neupartner von Anna (Kette)
// Anna: Starterpaket (Status 1, Eigenpunkte) + Kundenumsatz (Status 2)
UserSalesVolume::forceCreate([
'user_id' => $anna->id,
'month' => 6,
'year' => 2026,
'points' => 400,
'status' => 1,
]);
UserSalesVolume::forceCreate([
'user_id' => $anna->id,
'month' => 6,
'year' => 2026,
'points' => 100,
'status' => 2,
]);
// Ben: nur Starterpaket
UserSalesVolume::forceCreate([
'user_id' => $ben->id,
'month' => 6,
'year' => 2026,
'points' => 200,
'status' => 1,
]);
$ranking = collect(app(BackofficeDashboardService::class)->overview($root, 6, 2026)['recruiter_ranking'])->keyBy('user_id');
// Root: Annas 500 (400 eigene + 100 Kunden) + rekursiv Bens 200
expect($ranking->get($root->id)['volume_points'])->toBe(700.0)
->and($ranking->get($root->id)['partners'][0]['total_points'])->toBe(500.0)
->and($ranking->get($root->id)['partners'][0]['children'][0]['total_points'])->toBe(200.0)
// Anna selbst: nur Bens Punkte
->and($ranking->get($anna->id)['volume_points'])->toBe(200.0);
});
it('liefert im Neupartner-Drilldown zusaetzlich die Spalte Punkte gesamt', function (): void {
$root = bslMakeUser();
$partner = bslMakeUser($root->id, null, '2026-06-15');
UserSalesVolume::forceCreate([
'user_id' => $partner->id,
'month' => 6,
'year' => 2026,
'points' => 100,
'status' => 1, // Starterpaket / Eigenpunkte
]);
UserSalesVolume::forceCreate([
'user_id' => $partner->id,
'month' => 6,
'year' => 2026,
'points' => 250,
'status' => 2, // Kundenpunkte
]);
$details = app(BackofficeDrilldownService::class)->details($root, 0, 'new_partners', 6, 2026);
expect($details['rows'])->toHaveCount(1)
->and($details['rows'][0]['customer_points'])->toBe(250.0)
->and($details['rows'][0]['total_points'])->toBe(350.0)
->and($details['summary']['customer_points'])->toBe(250.0)
->and($details['summary']['total_points'])->toBe(350.0);
});