mivita/tests/Feature/PartnerPaidAtTest.php
Kevin b7e8bbd951 Statistik: Neupartner zaehlen im Monat der Zahlung, nicht der Registrierung
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>
2026-09-16 14:48:01 +00:00

168 lines
5.9 KiB
PHP

<?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');
});
});