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>
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

View file

@ -153,6 +153,7 @@ use Laravel\Passport\Token;
* @method static \Illuminate\Database\Eloquent\Builder|User wherePreSponsor($value)
*
* @property \Illuminate\Support\Carbon|null $pre_deleted_at
* @property \Illuminate\Support\Carbon|null $partner_paid_at
*
* @method static \Illuminate\Database\Eloquent\Builder<static>|User wherePreDeletedAt($value)
*
@ -185,7 +186,7 @@ class User extends Authenticatable
'settings' => 'array',
'payment_methods' => 'array',
'pre_deleted_at' => 'datetime',
'partner_paid_at' => 'datetime',
];
/**
@ -248,7 +249,16 @@ class User extends Authenticatable
/**
* Neupartner-Definition der Statistik (eine Regel für KPI, Recruiter-Ranking
* und Top-3-Karte): Mitgliedsebene gesetzt, Abrechnungskonto zum Stichtag
* gültig ({@see newPartnerReferenceDate()}), im Monat aktiv geworden.
* gültig ({@see newPartnerReferenceDate()}), **im Monat bezahlt**.
*
* Massgeblich ist `partner_paid_at`, nicht `active_date` (Kundenentscheidung
* 16.09.2026): Wer Ende August registriert und am 1. September bezahlt,
* ist ein September-Neupartner. Mit `active_date` fiel dieser Fall durch —
* im August noch ohne Abrechnungskonto, im September mit dem falschen
* Aktivierungsmonat — und fehlte damit in jeder Zählung, auch im Recruiting.
*
* Die Teamstruktur (wer gehört zum Monatsende zur Linie) hängt weiterhin an
* `active_date`; das ist eine andere Frage als „wer ist neu dazugekommen".
*
* @param Builder $query
* @return Builder
@ -261,7 +271,7 @@ class User extends Authenticatable
return $query->whereNotNull('m_level')
->whereNotNull('payment_account')
->where('payment_account', '>', self::newPartnerReferenceDate($month, $year))
->whereBetween('active_date', [$startDate, $endDate]);
->whereBetween('partner_paid_at', [$startDate, $endDate]);
}
/**
@ -271,7 +281,7 @@ class User extends Authenticatable
*/
public function isNewPartnerIn(int $month, int $year): bool
{
if ($this->m_level === null || $this->active_date === null || $this->payment_account === null) {
if ($this->m_level === null || $this->partner_paid_at === null || $this->payment_account === null) {
return false;
}
@ -281,7 +291,7 @@ class User extends Authenticatable
$startDate = Carbon::create($year, $month, 1)->startOfMonth();
return Carbon::parse($this->active_date)->betweenIncluded($startDate, $startDate->copy()->endOfMonth());
return Carbon::parse($this->partner_paid_at)->betweenIncluded($startDate, $startDate->copy()->endOfMonth());
}
public function user_pre_sponsor()