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>
219 lines
7.9 KiB
PHP
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')));
|
|
});
|