mivita/dev/2026-07-22
Kevin d57687b4e3 Team-Statistik = Team-Struktur (Provisionsbaum, Umschalter) und Laufstand-Fix in user_sales_volumes
K11 aus dem September-Protokoll (Tickets C1 und C2 im Entwicklungsplan), live seit 14.09.2026.

C1 – Statistik rechnet wie die Provision
- Standard-Baum ist der Provisionsbaum (Mitglieder wie TreeCalcBot: Mitgliedsebene,
  Abrechnungskonto, active_date; ausgefilterte Knoten kappen ihren Unterbaum, max. 21 Linien).
  Gesamte Downline bleibt per Umschalter erreichbar, Wahl in der Session.
- Punkte-Definition: Provisionspunkte (TP + Shop), reine Karrierepunkte ausgewiesen statt
  eingerechnet, negative Monatssalden je User wie in der Provision auf 0 gekappt.
- Abgeschlossene Monate nehmen die Mitglieder je Linie aus dem gespeicherten Provisionslauf
  (user_businesses), Snapshots je Baum-Definition (Payload-Version 3, Migration).
- Struktur-Modal: Gesamt aus den Linien-Punkten mit Dezimalen statt der int-Spalte total_pp.
- Messlauf statistics:compare-trees (Downline / Provisionsbaum / Struktur je VIP, Laufstand-Drift).

C2 – Laufstand-Race (Provision zu niedrig bei zeitgleichen Buchungen)
- Neuberechnung liest die Zeilen des Beraters sperrend (FOR UPDATE), Index (user_id, year, month).
- Paid-Pfad der Payone- und Stripe-Webhooks als DB::transaction mit 3 Anlaeufen; Deadlock und
  Lock-Timeout aus der Rechnungserstellung werden nicht mehr geschluckt.
- Sicherheitsnetz sales:repair-running-totals taeglich 02:45 vor dem Provisionslauf;
  abgeschlossene Monate werden nicht angefasst (Entscheid 14.09.: keine Nachzahlung fuer 06/08).

Doku: Entwicklungsplan zum Protokoll, Deploy-Notiz 14.09. (inkl. Migrations-Stolperstein:
Migrationen tragen Werte als Literale, nicht als Konstanten aus dem Anwendungscode).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-14 15:31:32 +00:00
..
audit-statistiken-2026-09-09-bewertung.md Doku: Deploy-Notiz zum Statistik-Paket vom 10.09.2026 2026-09-10 11:43:15 +00:00
audit-statistiken-2026-09-09-nachpruefung.md Doku: Statistik-Audit 09.09., Bewertung und Umsetzungsstand 2026-09-10 11:19:50 +00:00
audit-statistiken-2026-09-09-pruefprotokoll.md Doku: Statistik-Audit 09.09., Bewertung und Umsetzungsstand 2026-09-10 11:19:50 +00:00
audit-statistiken-2026-09-09.md Doku: Statistik-Audit 09.09., Bewertung und Umsetzungsstand 2026-09-10 11:19:50 +00:00
Bildschirmfoto 2026-08-25 um 12.37.56.png Firstlines: Seite und Dashboard-Kachel zaehlen wieder dieselbe Menge 2026-08-25 10:47:50 +00:00
deploy-2026-09-10.md Kundenabo-Seite: Vorschau taggenau, Liste mit den tatsaechlich gebuchten Punkten 2026-09-11 08:19:35 +00:00
deploy-2026-09-14.md Team-Statistik = Team-Struktur (Provisionsbaum, Umschalter) und Laufstand-Fix in user_sales_volumes 2026-09-14 15:31:32 +00:00
entwicklungskonzept.md Statistiken/Abo: Kundenfeedback 2026-07-24 komplett umgesetzt + Steuern: DATEV-Fixes 08+09/2025 (Sammel-Commit Branch-WIP) 2026-07-24 13:56:02 +00:00
entwicklungsplan-2026-08-19.md Statistiken: Kundenfeedback 2026-08-19 komplett (N1-N8) + Review-Fixes + VP-/Incentive-Repair gehärtet 2026-08-21 10:44:44 +00:00
feedback-an-kundin-2026-08-25.md Kundenrueckmeldung 25.08.: Formulierung zur Prognose-Gegenpruefung praezisiert 2026-08-25 10:48:54 +00:00
feedback-an-kundin-statistiken.md Statistiken/Abo: Kundenfeedback 2026-07-24 komplett umgesetzt + Steuern: DATEV-Fixes 08+09/2025 (Sammel-Commit Branch-WIP) 2026-07-24 13:56:02 +00:00
feedback-analyse-2026-07-24.md Statistiken/Abo: Kundenfeedback 2026-07-24 komplett umgesetzt + Steuern: DATEV-Fixes 08+09/2025 (Sammel-Commit Branch-WIP) 2026-07-24 13:56:02 +00:00
monatsabschluss-eingefrorene-statistik.md Doku: Statistik-Audit 09.09., Bewertung und Umsetzungsstand 2026-09-10 11:19:50 +00:00
neuerungen-fuer-berater.md Statistiken/Abo: Kundenfeedback 2026-07-24 komplett umgesetzt + Steuern: DATEV-Fixes 08+09/2025 (Sammel-Commit Branch-WIP) 2026-07-24 13:56:02 +00:00
README.md Team-Statistik = Team-Struktur (Provisionsbaum, Umschalter) und Laufstand-Fix in user_sales_volumes 2026-09-14 15:31:32 +00:00
Statistik-Aenderungen-19-08-2026.pdf Statistiken: Kundenfeedback 2026-08-19 komplett (N1-N8) + Review-Fixes + VP-/Incentive-Repair gehärtet 2026-08-21 10:44:44 +00:00
Statistiken kontrolliert.pdf Statistiken/Abo: Kundenfeedback 2026-07-24 komplett umgesetzt + Steuern: DATEV-Fixes 08+09/2025 (Sammel-Commit Branch-WIP) 2026-07-24 13:56:02 +00:00
todos.md Statistiken/Abo: Kundenfeedback 2026-07-24 komplett umgesetzt + Steuern: DATEV-Fixes 08+09/2025 (Sammel-Commit Branch-WIP) 2026-07-24 13:56:02 +00:00

Statistiken & Backoffice — Wegweiser durch diesen Ordner

Der Ordner ist über mehrere Monate gewachsen. Diese Seite sagt, welches Dokument wofür gilt und welches der aktuelle Stand ist.

Wenn du wissen willst, wo wir stehen

audit-statistiken-2026-09-09-bewertung.md — ganz oben unter „Stand" stehen erledigte und offene Befunde mit Sprungmarken. Das ist der Einstieg.

deploy-2026-09-10.md — was am 10.09. live gegangen ist, was sich dabei in den Daten geändert hat und was das für die historischen Zahlen bedeutet.

deploy-2026-09-14.md — K11: Team-Statistik rechnet wie die Team-Struktur (Provisionsbaum, Provisionspunkte, Umschalter), dazu der Laufstand-Fix in user_sales_volumes. Plan und Tickets: dev/_tickets/entwicklungsplan-protokoll-september-2026.md.

Entscheidungen, die dauerhaft gelten

Dokument Inhalt
monatsabschluss-eingefrorene-statistik.md Warum ein abgerechneter Monat vollständig eingefroren wird — Statistik, Team-Struktur, Detaillisten. Grenzen und Betriebsbefehle.
audit-statistiken-2026-09-09-bewertung.md, Abschnitt 8 Stornoregel: ein Storno mindert nur den Monat der Ursprungsbestellung. Settings-Schalter für den Ausnahmefall.
audit-statistiken-2026-09-09-bewertung.md, Abschnitt 14 Abo-Zustand: Berater wechseln ihn nur über Pause und Kündigung, nie über ein Aktiv-Feld. Jeder Wechsel wird zentral protokolliert.

Prüfungen vom September 2026

Chronologisch, jede Runde prüft die vorige:

  1. audit-statistiken-2026-09-09.md — externes Audit, 23 Befunde (A01–A23)
  2. audit-statistiken-2026-09-09-pruefprotokoll.md — dessen Gegenproben und Testläufe
  3. audit-statistiken-2026-09-09-bewertung.md — unsere Bewertung, Korrekturen an der Gewichtung, und alle Umsetzungs-Nachträge
  4. audit-statistiken-2026-09-09-nachpruefung.md — externe Nachprüfung der Umsetzung (R01–R03); bewertet in Abschnitt 10 der Bewertung

Anforderungen und Kundenrückmeldungen

Dokument Stand
entwicklungsplan-2026-09-07.md aktuellster Sollstand: K1–K9 umgesetzt, K10–K15 offen
feedback-an-kundin-2026-09-07.md Kundenbrief dazu, mit den offenen Fragen
entwicklungsplan-2026-08-19.md August-Pakete N1–N8
feedback-an-kundin-2026-08-25.md Kundenbrief August
entwicklungskonzept.md, todos.md Juli-Grundanforderungen A1/A2, B1–B10
feedback-analyse-2026-07-24.md, feedback-an-kundin-statistiken.md Juli-Korrekturrunde
neuerungen-fuer-berater.md Text für die Berater

Achtung bei Widersprüchen: Es gilt immer die jüngere Entscheidung. Beispiel: Die August-Entscheidung F7 („Abo-Bestände tagesaktuell") wurde am 10.09. abgelöst — abgeschlossene Monate sind seitdem vollständig eingefroren.