mivita/tests/Feature/TopResultsServiceTest.php
Kevin 867dc21b57 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>
2026-08-21 10:44:44 +00:00

219 lines
7.9 KiB
PHP

<?php
use App\Models\UserAbo;
use App\Models\UserAccount;
use App\Models\UserSalesVolume;
use App\Services\Team\TopResultsService;
use App\User;
use Carbon\Carbon;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\URL;
use Tests\TestCase;
uses(TestCase::class, RefreshDatabase::class);
beforeEach(function () {
Carbon::setTestNow(Carbon::parse('2026-08-15'));
Cache::flush();
});
afterEach(function () {
Carbon::setTestNow();
});
function trsMakeUser(
?int $sponsorId = null,
string $firstName = 'Team',
string $lastName = 'Partner',
?string $activeDate = null,
?string $paymentAccount = 'future',
): User {
$account = UserAccount::forceCreate([
'first_name' => $firstName,
'last_name' => $lastName,
]);
return User::forceCreate([
'email' => 'trs-'.uniqid('', true).'@example.com',
'password' => bcrypt('secret'),
'lang' => 'de',
'm_level' => 1,
'm_sponsor' => $sponsorId,
'payment_account' => $paymentAccount === 'future' ? now()->addYear() : $paymentAccount,
'active_date' => $activeDate,
'account_id' => $account->id,
]);
}
function trsAddVolume(int $userId, int $points, int $status, int $month = 8, int $year = 2026): void
{
UserSalesVolume::forceCreate([
'user_id' => $userId,
'month' => $month,
'year' => $year,
'points' => $points,
'status' => $status,
]);
}
function trsMakeAbo(int $ownerId, string $isFor, string $startDate, bool $active = true, int $status = 2): UserAbo
{
return UserAbo::create([
'user_id' => $ownerId,
'member_id' => $ownerId,
'shopping_user_id' => 0,
'email' => 'trs-abo-'.uniqid('', true).'@example.com',
'is_for' => $isFor,
'payone_userid' => 0,
'clearingtype' => 'cc',
'amount' => 5000,
'active' => $active,
'status' => $status,
'abo_interval' => 5,
'start_date' => $startDate,
'next_date' => '2026-09-05',
]);
}
function trsTop3(User $viewer): array
{
Cache::flush();
return app(TopResultsService::class)->monthlyTop3($viewer, 8, 2026);
}
it('rankt das persoenliche Volumen inkl. Status-1- und Status-2-Punkten, ohne Betrachter und Fremde', function (): void {
$root = trsMakeUser(null, 'Root', 'Viewer');
$anna = trsMakeUser($root->id, 'Anna', 'Alpha');
$ben = trsMakeUser($root->id, 'Ben', 'Beta');
$fremd = trsMakeUser(null, 'Frank', 'Fremd');
trsAddVolume($anna->id, 100, 1); // Eigenpunkte
trsAddVolume($anna->id, 50, 2); // Kundenpunkte
trsAddVolume($anna->id, 999, 3); // pending zaehlt nicht
trsAddVolume($ben->id, 40, 1);
trsAddVolume($ben->id, 70, 1, 7); // anderer Monat zaehlt nicht
trsAddVolume($root->id, 500, 1); // Betrachter zaehlt nicht mit
trsAddVolume($fremd->id, 800, 1); // nicht im Team
$result = trsTop3($root);
expect($result['top_volume'])->toHaveCount(2)
->and($result['top_volume'][0])->toMatchArray(['user_id' => $anna->id, 'first_name' => 'Anna', 'last_name' => 'Alpha', 'value' => 150.0])
->and($result['top_volume'][0]['profile_image_url'])->toBeNull()
->and($result['top_volume'][1])->toMatchArray(['user_id' => $ben->id, 'value' => 40.0]);
});
it('begrenzt auf Top 3 und sortiert Gleichstaende nach Name', function (): void {
$root = trsMakeUser(null, 'Root', 'Viewer');
$carla = trsMakeUser($root->id, 'Carla', 'Chef');
$zoe = trsMakeUser($root->id, 'Zoe', 'Zett');
$anna = trsMakeUser($root->id, 'Anna', 'Alpha');
$doris = trsMakeUser($root->id, 'Doris', 'Klein');
trsAddVolume($carla->id, 200, 1);
trsAddVolume($zoe->id, 100, 1);
trsAddVolume($anna->id, 100, 1);
trsAddVolume($doris->id, 50, 1); // Platz 4, faellt raus
$result = trsTop3($root);
expect($result['top_volume'])->toHaveCount(3)
->and(array_column($result['top_volume'], 'user_id'))
->toBe([$carla->id, $anna->id, $zoe->id]);
});
it('zaehlt Neupartner je Sponsor nach der Dashboard-Definition', function (): void {
$root = trsMakeUser(null, 'Root', 'Viewer');
$sponsor = trsMakeUser($root->id, 'Sandra', 'Sponsor');
$other = trsMakeUser($root->id, 'Olaf', 'Other');
trsMakeUser($sponsor->id, 'Neu', 'Eins', '2026-08-10');
trsMakeUser($sponsor->id, 'Neu', 'Zwei', '2026-08-20');
trsMakeUser($sponsor->id, 'Alt', 'Juli', '2026-07-10'); // anderer Monat
trsMakeUser($sponsor->id, 'Neu', 'Inaktiv', '2026-08-12', null); // kein aktives Abrechnungskonto
trsMakeUser($other->id, 'Neu', 'Drei', '2026-08-05');
trsMakeUser($root->id, 'Neu', 'BeimViewer', '2026-08-08'); // Sponsor = Betrachter, zaehlt nicht
$result = trsTop3($root);
expect($result['top_recruiters'])->toHaveCount(2)
->and($result['top_recruiters'][0])->toMatchArray(['user_id' => $sponsor->id, 'value' => 2])
->and($result['top_recruiters'][1])->toMatchArray(['user_id' => $other->id, 'value' => 1]);
});
it('zaehlt neue Abos als Kundenabos plus Eigenabo je Berater', function (): void {
$root = trsMakeUser(null, 'Root', 'Viewer');
$anna = trsMakeUser($root->id, 'Anna', 'Alpha');
$ben = trsMakeUser($root->id, 'Ben', 'Beta');
$fremd = trsMakeUser(null, 'Frank', 'Fremd');
trsMakeAbo($anna->id, 'ot', '2026-08-05');
trsMakeAbo($anna->id, 'ot', '2026-08-20');
trsMakeAbo($anna->id, 'me', '2026-08-03');
trsMakeAbo($anna->id, 'ot', '2026-07-05'); // anderer Monat
trsMakeAbo($anna->id, 'me', '2026-08-10', true, 4); // gekuendigt
trsMakeAbo($anna->id, 'ot', '2026-08-11', false); // inaktiv
trsMakeAbo($ben->id, 'me', '2026-08-15');
trsMakeAbo($root->id, 'ot', '2026-08-09'); // Betrachter zaehlt nicht mit
trsMakeAbo($fremd->id, 'ot', '2026-08-09'); // nicht im Team
$result = trsTop3($root);
expect($result['top_new_abos'])->toHaveCount(2)
->and($result['top_new_abos'][0])->toMatchArray(['user_id' => $anna->id, 'value' => 3])
->and($result['top_new_abos'][1])->toMatchArray(['user_id' => $ben->id, 'value' => 1]);
});
it('cacht das Ergebnis fuer 6 Stunden', function (): void {
$root = trsMakeUser(null, 'Root', 'Viewer');
$anna = trsMakeUser($root->id, 'Anna', 'Alpha');
trsAddVolume($anna->id, 100, 1);
$first = app(TopResultsService::class)->monthlyTop3($root, 8, 2026);
trsAddVolume($anna->id, 900, 1);
$second = app(TopResultsService::class)->monthlyTop3($root, 8, 2026);
expect($first['top_volume'][0]['value'])->toBe(100.0)
->and($second)->toBe($first);
});
it('rendert die Top-Ergebnisse-Karte nur mit Eintraegen', function (): void {
URL::resolveMissingNamedRoutesUsing(fn (string $name, $parameters = []) => '/'.$name);
$row = fn (string $first, string $last, $value) => [
'user_id' => 1, 'first_name' => $first, 'last_name' => $last,
'profile_image_url' => null, 'value' => $value,
];
$html = view('dashboard._top_results', [
'monthlyStats' => [
'month' => 8,
'year' => 2026,
'top_results' => [
'top_volume' => [$row('Anna', 'Alpha', 150.0)],
'top_recruiters' => [],
'top_new_abos' => [$row('Ben', 'Beta', 3)],
],
],
])->render();
expect($html)
->toContain(e(__('home.top_results_title')))
->toContain(__('home.top_results_volume'))
->toContain('Anna Alpha')
->toContain('Ben Beta')
->toContain(__('home.top_results_empty')); // leere Recruiter-Spalte
$emptyHtml = view('dashboard._top_results', [
'monthlyStats' => [
'month' => 8,
'year' => 2026,
'top_results' => ['top_volume' => [], 'top_recruiters' => [], 'top_new_abos' => []],
],
])->render();
expect($emptyHtml)->not->toContain(e(__('home.top_results_title')));
});