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:
parent
cf0311afc1
commit
b7e8bbd951
21 changed files with 547 additions and 20 deletions
20
app/User.php
20
app/User.php
|
|
@ -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()
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue