Statistiken: Kundenfeedback 2026-08-19 komplett (N1-N8) + Review-Fixes + VP-/Incentive-Repair gehärtet

Statistik-Änderungen 2026-08-19 (dev/2026-07-22/entwicklungsplan-2026-08-19.md, alle 8 Pakete gemäß beantworteten F-Fragen):
- N1 Monatsstatistik: Team-Cluster (Firstlines klickbar -> neue Seite user_team_firstlines, Teampartner gesamt/Payline [nur aktive], Abos Payline mit +N) + Level-Kachel (Quali-Stufe, fehlende Payline-/persönliche Punkte, Karriere-Level); LiveCommissionService-Snapshot v3 reicht Level-/Quali-Daten durch
- N2 Abo-Kacheln auf Home monatsbezogen (aboStockCount-Rückrechnung über cancel/deleted/Status-Historie; VIP-Statistik bleibt tagesaktuell)
- N3 VIP-Statistik 'Recruiter des Monats' (Neupartner-Definition wie KPI, rekursives Ketten-Volumen als Gesamtpunkte inkl. Starterpaket) + Drilldown/CSV-Spalte 'Punkte gesamt'
- N4 Prognose-Block 'Level & Provision laut Prognose (Stand 25.)' mit unverbindlich-Kennzeichnung (ebenengenaue offene Abo-Punkte + TP-Laufstände)
- N5 Checkout-Herkunft: Dropdown raus, Pflicht-Freitext (lokalisierte Fehlermeldung)
- N6 Berater-Profilfoto (user_accounts.profile_image, Einwilligung als Sprachkey-Platzhalter, DSGVO-Löschung) + teaminterne Top-3-Karte (TopResultsService, Scope-Schalter)
- N7 USt-Optionen: 'nicht umsatzsteuerpflichtig' zuerst + '§ 19 UStG'-Textfix
- N8 Jahresgebühr-Nachfassliste je Berater (AnnualFeeDueService, überfällig/1-3 Monate, Sidenav)

Kontroll-Review (8 Perspektiven) angewendet: next-Level-Fallback im Steady-State (resolveNextLevel — sonst 'Höchstes Level erreicht' für Normalfälle), _calculated-Punktebasis bei mehr Paylines, keine Wiederbelebung deaktivierter Abos in der Monatsrückrechnung, Payline-Abo-Kachel monatskonsistent, Top-3-Nachrücker; Performance: BackofficeDashboardService als Singleton mit lineBuckets-Memo (+flushLineBucketsMemo), level_forecast 6h-Cache; Reuse: User-Scopes firstlinesOf/newPartnerIn, SalesVolumePoints::totalPointsByUser, Slim::storeCroppedImage (3 Upload-Kopien vereinigt), activeAbo-Scope statt Inline-Prädikate, Form::open-Konvention, Return-Types

Repair-Härtung (Kundenentscheide): VP-Nachtrepair dedupliziert über shopping_order_id (Live-Pfad schreibt sie jetzt mit), zählende Alt-Zeilen-Erkennung, Vormonats-Scan für Monatswechsel, Firmenaccount-Buchungen (config mivita.company_user_id) werden automatisch auf den Berater umgebucht (in place bzw. per Gegenbuchung bei geschlossenem Monat; Echtfall Anna Schall Order 58797 -> Christina Schuder), Berater-zu-Berater nur Warnung; Incentive-Repair: m_sponsor=NULL löscht nicht mehr, FK-Repair vor Stale-Bereinigung, gebatchte Lookups, zentrales Incentive::qualificationWindow(); .env aus dem Git-Tracking entfernt (Pflege per SFTP)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Kevin 2026-08-21 10:44:44 +00:00
parent 841d87e161
commit 867dc21b57
87 changed files with 4480 additions and 240 deletions

View file

@ -120,14 +120,17 @@ class IncentiveCalculate extends Command
$participant->rebuildFromSourceTables()->save();
} else {
if (! $skipRepair) {
$stats['tracking_partner_removed'] += $repairService->removeStaleSponsorTrackings($participant);
$stats['tracking_partner_added'] += $repairService->syncMissingTrackingPartners($participant);
$stats['tracking_abo_added'] += $repairService->syncMissingTrackingAbos($participant);
// FK-Reparatur MUSS vor der Stale-Bereinigung laufen: Log-Zeilen mit
// incentive_new_partner_id = NULL wuerden das Loeschen sonst als Waisen
// beim alten Sponsor ueberleben (Doppelzaehlung nach Umhaengen).
$r = $repairService->repairForeignKeys($participant);
$stats['repair_partner_fk'] += $r['partner_fk'];
$stats['repair_abo_fk'] += $r['abo_fk'];
$stats['repair_onetime_partner_fk'] += $r['onetime_partner_fk'];
$stats['repair_onetime_abo_fk'] += $r['onetime_abo_fk'];
$stats['tracking_partner_removed'] += $repairService->removeStaleSponsorTrackings($participant);
$stats['tracking_partner_added'] += $repairService->syncMissingTrackingPartners($participant);
$stats['tracking_abo_added'] += $repairService->syncMissingTrackingAbos($participant);
$stats['sv_logs_added'] += $repairService->syncMissingSalesVolumeLogs($participant);
}
$participant->recalculateFromTrackingTables()->save();

View file

@ -0,0 +1,89 @@
<?php
namespace App\Console\Commands;
use App\Services\SponsorBuyingPointsRepairService;
use Illuminate\Console\Command;
/**
* Nacht-Repair: fehlende Vertriebspartner-Punkte (VP, status=5) des Sponsors
* fuer bezahlte Bestellungen des laufenden Monats nachbuchen.
*
* Hintergrund und Faelle: dev/2026-08-12-intensiv-tickets/README.md
*/
class RepairSponsorBuyingPoints extends Command
{
protected $signature = 'sales:repair-sponsor-vp
{--month= : Monat (Standard: aktueller Monat)}
{--year= : Jahr (Standard: aktuelles Jahr)}
{--dry-run : Nur anzeigen, nichts buchen}
{--force : Buchung in einen anderen als den laufenden Monat erlauben}';
protected $description = 'Fehlende Vertriebspartner-Punkte (VP, status=5) des Sponsors für bezahlte Bestellungen des Monats nachbuchen';
public function handle(SponsorBuyingPointsRepairService $service): int
{
$month = (int) ($this->option('month') ?: now()->month);
$year = (int) ($this->option('year') ?: now()->year);
$dryRun = (bool) $this->option('dry-run');
$isCurrentMonth = $month === (int) now()->month && $year === (int) now()->year;
if (! $dryRun && ! $isCurrentMonth && ! $this->option('force')) {
$this->error('Buchungen in einen anderen als den laufenden Monat nur mit --force (keine rückwirkenden Buchungen in abgeschlossene Provisionsmonate).');
return self::FAILURE;
}
$this->info("VP-Repair für {$month}/{$year}".($dryRun ? ' (DRY-RUN)' : ''));
$result = $service->repair($month, $year, $dryRun);
$this->info(" Geprüfte bezahlte Bestellungen mit VP-Produkt: {$result['checked']}");
$this->info(" Bereits gebucht (übersprungen): {$result['skipped_existing']}");
$this->info(($dryRun ? ' Würde nachbuchen: ' : ' Nachgebucht: ').count($result['created']));
if (! empty($result['rebooked'])) {
$this->info(($dryRun ? ' Würde vom Firmenaccount umbuchen: ' : ' Vom Firmenaccount umgebucht: ').count($result['rebooked']));
$this->table(
['Order', 'Berater', 'Neupartner', 'Produkt', 'Punkte'],
array_map(fn (array $row) => [
$row['order_id'],
$row['sponsor'].' (#'.$row['sponsor_id'].')',
$row['buyer'],
$row['product'],
$row['points'],
], $result['rebooked'])
);
}
if (! empty($result['skipped_other_sponsor'])) {
$this->warn(' Achtung — Buchung liegt bei einem ANDEREN Sponsor (Umhängung?), bitte manuell prüfen:');
$this->table(
['Order', 'Neupartner', 'aktueller Sponsor', 'gebucht bei'],
array_map(fn (array $row) => [
$row['order_id'],
$row['buyer'],
'#'.$row['current_sponsor_id'],
'#'.$row['booked_sponsor_id'],
], $result['skipped_other_sponsor'])
);
}
if (! empty($result['created'])) {
$this->table(
['Order', 'Sponsor', 'Neupartner', 'Produkt', 'Punkte'],
array_map(fn (array $row) => [
$row['order_id'],
$row['sponsor'].' (#'.$row['sponsor_id'].')',
$row['buyer'],
$row['product'],
$row['points'],
], $result['created'])
);
}
$this->info('Fertig.');
return self::SUCCESS;
}
}