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>
162 lines
5.4 KiB
PHP
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);
|
|
});
|