mivita/tests/Feature/BackofficeSnapshotFreezeTest.php
Kevin 92344f7080 Statistik: abgeschlossene Monate werden vollstaendig eingefroren
Am ersten des Folgemonats wird der Monat abgerechnet, die Provision berechnet
und Gutschriften werden ausgestellt. Deswegen fliessen auch Stornos nicht mehr
rueckwirkend ein. Genau dieser Stand muss eingefroren werden — und zwar
einschliesslich Teamstruktur und Detaillisten, nicht nur der Kennzahlen.

Bisher hat `overlayCurrentAboStock()` beim Lesen eines gespeicherten Monats die
gesamte Kundenabo-Topliste live neu gerechnet, also auch abgerechnete
Monatswerte. Und die Detaillisten hinter den Kacheln lasen Monatsbuchungen und
Teamzuordnung grundsaetzlich neu — nach einem Sponsorwechsel oder einer
Loeschung konnte derselbe historische Klick andere Ergebnisse liefern als die
Kachel darueber.

Das Overlay entfaellt; der Snapshot wird unveraendert zurueckgegeben. Die
Detaillisten lesen die eingefrorene Mitgliedermenge aus dem Snapshot
(`user_ids` lag dort bereits, wurde nur nie benutzt) und die eingefrorenen
Abo-Ids aus dem neuen Feld `abo_ids`. Payload-Version 2.

Grenze, die bleibt: Ein Rebuild vergangener Monate friert die Struktur des
AUSFUEHRUNGSTAGS ein, nicht die des damaligen Monatsendes — frueheres
Sponsoring wird nirgends historisiert. Der `--force`-Lauf ist deshalb nur
richtig, wenn man bewusst einen einheitlichen Stand herstellt. Das ist hier der
Fall (Schemawechsel des Payloads), fuer den laufenden Betrieb genuegt der
naechtliche Lauf ohne `--force`.

Loest die August-Entscheidung F7 ("Abo-Bestaende tagesaktuell") ab. Zwei Tests
hielten die alte Regel fest und beschreiben jetzt die neue.

Mit drin, weil dieselben Dateien betroffen sind:
- Negative Monatssalden verschwanden aus dem Drilldown (`HAVING > 0`), obwohl
  ihre Betraege in der Uebersicht steckten. Nur die 1000-Punkte-Liste behaelt
  ihren Schwellenfilter (A03).
- Zusatzpunkte einer stornierten Bestellung werden anteilig verrechnet statt
  voll abgezogen (A06).
- Unformatierte Sortierwerte fuer die Detailliste (A14, siehe Folgecommit).

Audit-Befunde A03, A04, A06, A12.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-10 11:19:06 +00:00

162 lines
5.4 KiB
PHP

<?php
use App\Models\UserAbo;
use App\Models\UserSalesVolume;
use App\Services\Backoffice\BackofficeDashboardService;
use App\Services\Backoffice\BackofficeDrilldownService;
use App\User;
use Carbon\Carbon;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;
uses(TestCase::class, RefreshDatabase::class);
beforeEach(function () {
// September laeuft, August ist abgeschlossen.
Carbon::setTestNow('2026-09-15 10:00:00');
});
afterEach(fn () => Carbon::setTestNow());
function freezeUser(?int $sponsor = null): User
{
return User::forceCreate([
'email' => 'freeze-'.uniqid('', true).'@example.test',
'password' => bcrypt('secret'),
'lang' => 'de',
'm_level' => 1,
'm_sponsor' => $sponsor,
'active_date' => '2026-01-01',
'payment_account' => '2027-01-01',
]);
}
function freezeVolume(User $user, float $points, int $month = 8): UserSalesVolume
{
return UserSalesVolume::forceCreate([
'user_id' => $user->id,
'month' => $month,
'year' => 2026,
'date' => '2026-0'.$month.'-05',
'points' => $points,
'total_net' => $points,
'status' => 1,
'status_points' => 1,
'status_turnover' => 1,
]);
}
function freezeAbo(User $member, string $isFor = 'ot', string $startDate = '2026-08-05'): UserAbo
{
return UserAbo::create([
'user_id' => $member->id,
'member_id' => $member->id,
'shopping_user_id' => 0,
'email' => 'a-'.uniqid('', true).'@example.test',
'is_for' => $isFor,
'payone_userid' => 0,
'clearingtype' => 'cc',
'amount' => 5000,
'active' => true,
'status' => 2,
'abo_interval' => 5,
'start_date' => $startDate,
'next_date' => '2026-10-05',
]);
}
it('haelt Punkte eines abgeschlossenen Monats nach einer spaeteren Korrektur fest', function () {
$root = freezeUser();
$anna = freezeUser($root->id);
$volume = freezeVolume($anna, 100);
app(BackofficeDashboardService::class)->storeSnapshot($root, 8, 2026);
$volume->update(['points' => 500]);
$overview = app(BackofficeDashboardService::class)->overview($root, 8, 2026);
expect($overview['_meta']['source'])->toBe('snapshot')
->and((float) $overview['totals']['total_points'])->toBe(100.0);
});
it('haelt auch die Abo-Bestaende und Ranglisten fest', function () {
$root = freezeUser();
$anna = freezeUser($root->id);
$abo = freezeAbo($anna);
app(BackofficeDashboardService::class)->storeSnapshot($root, 8, 2026);
// Kuendigung im September darf den August nicht mehr veraendern.
$abo->update(['active' => false, 'status' => 4, 'cancel_date' => '2026-09-10']);
$overview = app(BackofficeDashboardService::class)->overview($root, 8, 2026);
expect((int) $overview['totals']['team_customer_abos'])->toBe(1);
});
it('laesst einen spaeter dazugekommenen Teampartner aus dem abgeschlossenen Monat heraus', function () {
$root = freezeUser();
$anna = freezeUser($root->id);
freezeVolume($anna, 100);
app(BackofficeDashboardService::class)->storeSnapshot($root, 8, 2026);
// Neuer Teampartner im September, mit einer Buchung, die im August liegt
// (z. B. nachtraeglich zugeordnet) — der abgeschlossene Monat bleibt unberuehrt.
$spaeter = freezeUser($root->id);
freezeVolume($spaeter, 999);
app(BackofficeDashboardService::class)->flushLineBucketsMemo($root->id);
$overview = app(BackofficeDashboardService::class)->overview($root, 8, 2026);
$details = app(BackofficeDrilldownService::class)->details($root, 0, 'total_points', 8, 2026);
expect((float) $overview['totals']['total_points'])->toBe(100.0)
->and($details['summary']['total_points'])->toBe(100.0)
->and($details['rows'])->toHaveCount(1)
->and($details['rows'][0]['user_id'])->toBe($anna->id);
});
it('zeigt in der Abo-Detailliste genau die eingefrorenen Abos', function () {
$root = freezeUser();
$anna = freezeUser($root->id);
$abo = freezeAbo($anna);
app(BackofficeDashboardService::class)->storeSnapshot($root, 8, 2026);
$abo->update(['active' => false, 'status' => 4, 'cancel_date' => '2026-09-10']);
$abo->delete();
$details = app(BackofficeDrilldownService::class)->details($root, 0, 'team_customer_abos', 8, 2026);
expect($details['summary']['abo_count'])->toBe(1);
});
it('haelt Kachel und verlinkte Liste der neuen Abos zusammen', function () {
$root = freezeUser();
$anna = freezeUser($root->id);
$abo = freezeAbo($anna, 'ot', '2026-08-20'); // neu im August
app(BackofficeDashboardService::class)->storeSnapshot($root, 8, 2026);
$abo->update(['active' => false, 'status' => 4, 'cancel_date' => '2026-09-08']);
$overview = app(BackofficeDashboardService::class)->overview($root, 8, 2026);
$details = app(BackofficeDrilldownService::class)->details($root, 0, 'team_customer_abos', 8, 2026, true);
expect((int) $overview['totals']['team_customer_abos_new'])->toBe(1)
->and($details['summary']['abo_count'])->toBe(1);
});
it('rechnet den laufenden Monat weiterhin live', function () {
$root = freezeUser();
$anna = freezeUser($root->id);
$volume = freezeVolume($anna, 100, 9);
$volume->update(['points' => 500]);
$overview = app(BackofficeDashboardService::class)->overview($root, 9, 2026);
expect($overview['_meta']['source'])->toBe('live')
->and((float) $overview['totals']['total_points'])->toBe(500.0);
});