gitmedia/mivita
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Statistik: Neupartner zaehlen im Monat der Zahlung, nicht der Registrierung

Browse source 
Wer Ende August registriert und am 1. September bezahlt hat, tauchte in keiner
Neupartner-Zaehlung auf: Der August-Snapshot wurde um 04:45 eingefroren, da
fehlte noch das Abrechnungskonto; im September lag active_date im falschen
Monat. Betroffen sind 2026 acht Partner, auch im Recruiting ihrer Sponsoren.

Kundenentscheidung 16.09.2026: der Zeitpunkt der Zahlung ist massgeblich.

Neue Spalte users.partner_paid_at, gesetzt bei der ersten Kontozahlung
(Payment::paymentStatusPaidAction) und bei manueller Freischaltung durch den
Admin — nur, solange sie leer ist; Verlaengerung und Wiederherstellung aendern
sie nicht. Bestehende Partner werden per Migration aus der ersten bezahlten
Registrierungsbestellung rueckgefuellt (Zeitstempel der Punktebuchung, ersatzweise
Bestelldatum, ohne Bestellung das Aktivierungsdatum). Bewusst nicht
payment_account minus ein Jahr: das ergaebe bei Verlaengerern den Jahrestag der
Erstzahlung.

User::scopeNewPartnerIn() und isNewPartnerIn() lesen jetzt partner_paid_at —
damit Kachel, Recruiter-Ranking, Top 3 und Neupartner-Liste gleichermassen.
Die Liste und der CSV-Export zeigen "Bezahlt am" neben "Registriert am".

Unveraendert: die Teamstruktur haengt weiter an active_date (auch im
Provisionsbaum). Wer ist neu dazugekommen und wer gehoert zur Linie sind zwei
verschiedene Fragen.

Die eingefrorenen Monate Januar bis August enthalten sieben dieser Partner
nicht; ob sie per --force neu gebaut werden, ist eine Entscheidung — siehe
dev/2026-07-22/neupartner-zahlungsmonat.md.

Mit drin: die handgebaute SQLite-Tabelle in BackofficeDashboardServiceTest
kannte status_reason aus d6efe56 noch nicht.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Kevin 2026-09-16 14:48:01 +00:00
parent cf0311afc1
commit b7e8bbd951
21 changed files with 547 additions and 20 deletions
Download patch file Download diff file Expand all files Collapse all files

1
tests/Feature/BackofficeSnapshotFreezeTest.php
View file

@ -27,6 +27,7 @@ function freezeUser(?int $sponsor = null): User
'm_level' => 1,
'm_sponsor' => $sponsor,
'active_date' => '2026-01-01',
'partner_paid_at' => '2026-01-01',
'payment_account' => '2027-01-01',
]);
}

39
tests/Feature/BackofficeStatisticsDrilldownTest.php
View file

@ -35,6 +35,8 @@ function boMakeUser(?int $sponsorId = null, ?string $activeDate = null, ?string
// Ohne active_date steht ein Berater nicht im Provisionsbaum (K11) — wie
// im TreeCalcBot. Der Standard liegt vor allen Testmonaten.
'active_date' => $activeDate ?? '2026-01-15',
// Regelfall: am Tag der Registrierung bezahlt (User::scopeNewPartnerIn()).
'partner_paid_at' => $activeDate ?? '2026-01-15',
'payment_account' => $paymentAccount ?? now()->addYear(),
]);
}
@ -371,3 +373,40 @@ it('rendert die Uebersicht mit dem Neu-Badge samt Baum-Parameter (Regression: Cl
->toContain('only_new=1')
->toContain('tree=commission');
});
it('zaehlt einen Neupartner im Monat der Zahlung, nicht im Monat der Registrierung', function (): void {
// Kundenentscheidung 16.09.2026: Ende August registriert, am 1. September
// bezahlt -> September-Neupartner. Mit active_date fiel er komplett durch.
$root = boMakeUser();
$latePayer = boMakeUser($root->id, '2026-08-28');
$latePayer->forceFill(['partner_paid_at' => '2026-09-01 06:49:35'])->save();
$service = app(BackofficeDashboardService::class);
$teamIds = $service->teamUserIds($root->id);
expect($service->newPartnersCount($teamIds, 8, 2026))->toBe(0)
->and($service->newPartnersCount($teamIds, 9, 2026))->toBe(1)
->and($latePayer->fresh()->isNewPartnerIn(8, 2026))->toBeFalse()
->and($latePayer->fresh()->isNewPartnerIn(9, 2026))->toBeTrue();
// Und im Neupartner-Drilldown steht er mit dem Zahlungsdatum.
$rows = collect($service->overview($root, 9, 2026)['recruiter_ranking'] ?? []);
$details = app(BackofficeDrilldownService::class)->details($root, 0, 'new_partners', 9, 2026);
$row = collect($details['rows'])->firstWhere('user_id', $latePayer->id);
expect($row)->not->toBeNull()
->and($row['paid_at_sort'])->toBe('2026-09-01')
->and($row['active_date_sort'])->toBe('2026-08-28');
});
it('zaehlt einen registrierten, aber nie bezahlten Partner in keinem Monat', function (): void {
$root = boMakeUser();
$unpaid = boMakeUser($root->id, '2026-08-19');
$unpaid->forceFill(['partner_paid_at' => null, 'payment_account' => null])->save();
$service = app(BackofficeDashboardService::class);
$teamIds = $service->teamUserIds($root->id);
expect($service->newPartnersCount($teamIds, 8, 2026))->toBe(0)
->and($service->newPartnersCount($teamIds, 9, 2026))->toBe(0);
});

1
tests/Feature/BackofficeStatisticsListsTest.php
View file

@ -42,6 +42,7 @@ function bslMakeUser(?int $sponsorId = null, ?int $levelId = null, ?string $acti
'm_level' => $levelId ?? 1,
'm_sponsor' => $sponsorId,
'active_date' => $activeDate ?? '2026-01-15',
'partner_paid_at' => $activeDate ?? '2026-01-15',
'payment_account' => now()->addYear(),
]);
}

7
tests/Feature/HomeMonthlyStatsTest.php
View file

@ -31,6 +31,7 @@ function hmsMakeUser(?int $sponsorId = null, ?string $paymentAccount = 'future')
'm_level' => 1,
'm_sponsor' => $sponsorId,
'active_date' => '2026-01-10',
'partner_paid_at' => '2026-01-10',
'payment_account' => $paymentAccount === 'future' ? now()->addYear() : $paymentAccount,
]);
}
@ -66,13 +67,13 @@ it('zaehlt Neupartner weiterhin ueber alle Firstlines, nicht nur ueber die Kache
$root = hmsMakeUser();
// Im laufenden Monat aktiv geworden, Konto gueltig -> Neupartner
hmsMakeUser($root->id)->forceFill(['active_date' => '2026-08-05'])->save();
hmsMakeUser($root->id)->forceFill(['active_date' => '2026-08-05', 'partner_paid_at' => '2026-08-05'])->save();
// Im laufenden Monat aktiv geworden, Konto abgelaufen -> kein Neupartner,
// aber weiterhin Berater in der Firstlines-Kachel
hmsMakeUser($root->id, now()->subDay()->toDateString())
->forceFill(['active_date' => '2026-08-06'])->save();
->forceFill(['active_date' => '2026-08-06', 'partner_paid_at' => '2026-08-06'])->save();
// Ohne Abrechnungskonto: weder Neupartner noch Berater
hmsMakeUser($root->id, null)->forceFill(['active_date' => '2026-08-07'])->save();
hmsMakeUser($root->id, null)->forceFill(['active_date' => '2026-08-07', 'partner_paid_at' => '2026-08-07'])->save();
$stats = hmsMonthlyStats($root);

168
tests/Feature/PartnerPaidAtTest.php Normal file
View file

@ -0,0 +1,168 @@
<?php
use App\Models\Product;
use App\Models\ShoppingOrder;
use App\Models\ShoppingOrderItem;
use App\Models\UserSalesVolume;
use App\Services\Payment;
use App\Services\UserUtil;
use App\User;
use Carbon\Carbon;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;
uses(TestCase::class, RefreshDatabase::class);
beforeEach(function () {
Carbon::setTestNow(Carbon::parse('2026-09-01 06:49:35'));
if (! Schema::connection('sqlite')->hasColumn('products', 'slug')) {
Schema::connection('sqlite')->table('products', function ($table) {
$table->string('slug')->nullable();
});
}
});
afterEach(fn () => Carbon::setTestNow());
function ppaMakeUser(array $overrides = []): User
{
return User::forceCreate(array_merge([
'email' => 'ppa-'.uniqid('', true).'@example.com',
'password' => bcrypt('secret'),
'lang' => 'de',
'm_level' => 1,
'active_date' => '2026-08-28 16:13:11',
'payment_account' => null,
'partner_paid_at' => null,
], $overrides));
}
function ppaRegistrationOrder(User $user, bool $paid = true): ShoppingOrder
{
return ShoppingOrder::forceCreate([
'shopping_user_id' => 0,
'auth_user_id' => $user->id,
'country_id' => 0,
'user_shop_id' => 0,
'payment_for' => 1,
'paid' => $paid,
'created_at' => '2026-08-28 16:14:00',
'updated_at' => '2026-09-01 08:54:00',
]);
}
/**
* Wer Ende August registriert und am 1. September bezahlt, ist ein
* September-Neupartner. Massgeblich ist `partner_paid_at`, gesetzt beim ersten
* Zahlungseingang und danach nie wieder.
*/
describe('partner_paid_at: erste Kontozahlung', function () {
it('setzt den Wert nur beim ersten Mal', function () {
$user = ppaMakeUser();
expect(UserUtil::markPartnerPaid($user))->toBeTrue()
->and($user->partner_paid_at->toDateTimeString())->toBe('2026-09-01 06:49:35');
Carbon::setTestNow(Carbon::parse('2027-09-01 10:00:00'));
// Verlaengerung ein Jahr spaeter: der Wert bleibt stehen.
expect(UserUtil::markPartnerPaid($user))->toBeFalse()
->and($user->partner_paid_at->toDateTimeString())->toBe('2026-09-01 06:49:35');
});
it('wird von der Kontozahlung gesetzt und macht den Partner zum Neupartner des Zahlungsmonats', function () {
$user = ppaMakeUser();
$product = Product::forceCreate([
'name' => 'Starterpaket',
'title' => 'Starterpaket',
'price' => 89.0,
'tax' => 19.0,
'active' => true,
'pos' => 1,
'weight' => 0,
'points' => 0,
'slug' => 'starter-'.uniqid(),
'action' => [0], // payment_for_account
]);
$order = ppaRegistrationOrder($user, false);
ShoppingOrderItem::forceCreate([
'shopping_order_id' => $order->id,
'product_id' => $product->id,
'qty' => 1,
'price' => 89.0,
]);
Payment::paymentStatusPaidAction($order->fresh(), true);
$user->refresh();
expect($user->partner_paid_at?->toDateString())->toBe('2026-09-01')
->and($user->payment_account)->not->toBeNull()
->and($user->isNewPartnerIn(8, 2026))->toBeFalse()
->and($user->isNewPartnerIn(9, 2026))->toBeTrue();
});
});
describe('partner_paid_at: Rueckfuellung fuer bestehende Partner', function () {
it('nimmt die Punktebuchung der ersten bezahlten Registrierungsbestellung', function () {
$user = ppaMakeUser(['payment_account' => '2027-09-01 06:49:35']);
$order = ppaRegistrationOrder($user);
UserSalesVolume::forceCreate([
'user_id' => $user->id,
'shopping_order_id' => $order->id,
'month' => 9,
'year' => 2026,
'points' => 200,
'status' => 1,
'created_at' => '2026-09-01 06:49:35',
]);
expect(UserUtil::backfillPartnerPaidAt())->toBe(1)
->and($user->fresh()->partner_paid_at->toDateTimeString())->toBe('2026-09-01 06:49:35');
});
it('faellt ohne Buchung auf das Aenderungsdatum der Bestellung zurueck', function () {
$user = ppaMakeUser(['payment_account' => '2027-09-01 06:49:35']);
ppaRegistrationOrder($user);
UserUtil::backfillPartnerPaidAt();
expect($user->fresh()->partner_paid_at->toDateTimeString())->toBe('2026-09-01 08:54:00');
});
it('nimmt ohne Registrierungsbestellung das Aktivierungsdatum (Admin-Freischaltung)', function () {
$user = ppaMakeUser(['payment_account' => '2027-08-28 00:00:00']);
UserUtil::backfillPartnerPaidAt();
expect($user->fresh()->partner_paid_at->toDateTimeString())->toBe('2026-08-28 16:13:11');
});
it('laesst bereits gesetzte Werte und unbezahlte Partner unangetastet', function () {
$set = ppaMakeUser(['payment_account' => '2027-01-01', 'partner_paid_at' => '2025-03-03 12:00:00']);
$unpaid = ppaMakeUser();
expect(UserUtil::backfillPartnerPaidAt())->toBe(0)
->and($set->fresh()->partner_paid_at->toDateTimeString())->toBe('2025-03-03 12:00:00')
->and($unpaid->fresh()->partner_paid_at)->toBeNull();
});
it('ignoriert unbezahlte Registrierungsbestellungen', function () {
// Abgelaufener Zahlungslink, danach ein zweiter erfolgreicher: nur die
// bezahlte Bestellung zaehlt.
$user = ppaMakeUser(['payment_account' => '2027-09-01 06:49:35']);
ppaRegistrationOrder($user, false);
$paid = ppaRegistrationOrder($user);
UserSalesVolume::forceCreate([
'user_id' => $user->id, 'shopping_order_id' => $paid->id, 'month' => 9, 'year' => 2026,
'points' => 200, 'status' => 1, 'created_at' => '2026-09-01 06:49:35',
]);
UserUtil::backfillPartnerPaidAt();
expect($user->fresh()->partner_paid_at->toDateString())->toBe('2026-09-01');
});
});

1
tests/Feature/PaylineForecastServiceTest.php
View file

@ -44,6 +44,7 @@ function pflMakeUser(?int $sponsorId = null, ?string $activeDate = '2026-01-10')
'm_sponsor' => $sponsorId,
'payment_account' => now()->addYear(),
'active_date' => $activeDate,
'partner_paid_at' => $activeDate,
]);
}

1
tests/Feature/StatisticsConsistencyTest.php
View file

@ -27,6 +27,7 @@ function scUser(?int $sponsor = null): User
'm_level' => 1,
'm_sponsor' => $sponsor,
'active_date' => '2026-01-01',
'partner_paid_at' => '2026-01-01',
'payment_account' => '2027-01-01',
]);
}

5
tests/Feature/TeamFirstlinesPageTest.php
View file

@ -28,6 +28,7 @@ function tflMakeUser(?int $sponsorId = null, array $accountData = []): User
'm_sponsor' => $sponsorId,
'account_id' => $account->id,
'active_date' => '2026-01-15',
'partner_paid_at' => '2026-01-15',
'payment_account' => now()->addYear(),
]);
}
@ -65,6 +66,10 @@ it('listet die Firstlines mit Monats-Gesamtpunkten sortiert und laesst Tiefere a
expect($rows)->toHaveCount(4)
->and($view->getData()['activeCount'])->toBe(3) // Kachel-Zahl: nur aktive Berater
// Dritte Zahl im Kopf: die Zeilenmarkierung beantwortet eine andere Frage
// (abgelaufene Jahresgebuehr) als "Berater" — ohne sie liesse sich die
// Kopfzahl nicht mit den unmarkierten Zeilen abgleichen.
->and($view->getData()['expiredCount'])->toBe(2)
->and($rows[0]['user_id'])->toBe($ben->id) // 400 Punkte zuerst
->and($rows[0]['total_points'])->toBe(400.0)
->and($rows[1]['user_id'])->toBe($anna->id)

19
tests/Feature/TopResultsServiceTest.php
View file

@ -42,6 +42,7 @@ function trsMakeUser(
'm_sponsor' => $sponsorId,
'payment_account' => $paymentAccount === 'future' ? now()->addYear() : $paymentAccount,
'active_date' => $activeDate,
'partner_paid_at' => $activeDate,
'account_id' => $account->id,
]);
}
@ -322,3 +323,21 @@ it('haelt "Top 3 neue Abos" fuer abgeschlossene Monate stabil, auch wenn Abos sp
->and($result['top_new_abos'][0]['first_name'])->toBe('Anna')
->and($result['top_new_abos'][0]['value'])->toBe(2);
});
it('rechnet dem Recruiter den Neupartner im Monat der Zahlung an', function (): void {
// Registriert am 28.08., bezahlt am 01.09. -> September-Recruit, nicht August.
Carbon::setTestNow(Carbon::parse('2026-09-15'));
$root = trsMakeUser(null, 'Root', 'Viewer');
$sponsor = trsMakeUser($root->id, 'Sandra', 'Sponsor');
trsMakeUser($sponsor->id, 'Spaet', 'Zahler', '2026-08-28')
->forceFill(['partner_paid_at' => '2026-09-01 06:49:35'])->save();
Cache::flush();
$august = app(TopResultsService::class)->monthlyTop3($root, 8, 2026);
Cache::flush();
$september = app(TopResultsService::class)->monthlyTop3($root, 9, 2026);
expect(collect($august['top_recruiters'])->firstWhere('user_id', $sponsor->id))->toBeNull()
->and(collect($september['top_recruiters'])->firstWhere('user_id', $sponsor->id))->toMatchArray(['value' => 1]);
});

6
tests/Unit/Services/BackofficeDashboardServiceTest.php
View file

@ -53,6 +53,7 @@ beforeEach(function () {
$table->unsignedInteger('m_sponsor')->nullable();
$table->boolean('active')->default(false);
$table->timestamp('active_date')->nullable();
$table->timestamp('partner_paid_at')->nullable();
$table->unsignedTinyInteger('admin')->default(0);
$table->unsignedTinyInteger('wizard')->default(0);
$table->unsignedTinyInteger('blocked')->default(0);
@ -69,6 +70,7 @@ beforeEach(function () {
$table->char('is_for', 2)->nullable();
$table->boolean('active')->default(true);
$table->unsignedTinyInteger('status')->default(2);
$table->string('status_reason')->nullable();
$table->date('start_date')->nullable();
$table->date('next_date')->nullable();
$table->timestamps();
@ -216,6 +218,7 @@ it('aggregiert Linien, Abos und Punkte fuer die Backoffice-Statistik', function
'm_sponsor' => $root->id,
'm_level' => 1,
'active_date' => '2026-05-03 00:00:00',
'partner_paid_at' => '2026-05-03 00:00:00',
'payment_account' => '2030-01-01 00:00:00',
]);
@ -226,6 +229,7 @@ it('aggregiert Linien, Abos und Punkte fuer die Backoffice-Statistik', function
'm_sponsor' => $lineOne->id,
'm_level' => 1,
'active_date' => '2026-04-03 00:00:00',
'partner_paid_at' => '2026-04-03 00:00:00',
'payment_account' => '2030-01-01 00:00:00',
]);
@ -236,6 +240,7 @@ it('aggregiert Linien, Abos und Punkte fuer die Backoffice-Statistik', function
'm_sponsor' => $root->id,
'm_level' => 1,
'active_date' => '2026-01-03 00:00:00',
'partner_paid_at' => '2026-01-03 00:00:00',
'payment_account' => '2020-01-01 00:00:00',
]);
@ -249,6 +254,7 @@ it('aggregiert Linien, Abos und Punkte fuer die Backoffice-Statistik', function
'm_sponsor' => $sponsor->id,
'm_level' => 1,
'active_date' => '2026-04-03 00:00:00',
'partner_paid_at' => '2026-04-03 00:00:00',
'payment_account' => '2030-01-01 00:00:00',
]);
}