mivita/dev/2026-07-22/neuerungen-fuer-berater.md
Kevin d4e9d108ad Statistiken/Abo: Kundenfeedback 2026-07-24 komplett umgesetzt + Steuern: DATEV-Fixes 08+09/2025 (Sammel-Commit Branch-WIP)
Feedback-Umsetzung (dev/2026-07-22/feedback-analyse-2026-07-24.md, alle 10 Punkte):
- VIP-Statistik: eigener Berater ('ich', Linie 0) in Neue-Kundenabos- und beiden Top-10-Listen; Top-10-Umsatz sortiert nach abgerechneten Ist-Punkten + Abo-Anzahl-Spalte; Fußnote nicht-payline-wirksame Punkte (SalesVolumePoints::nonPaylinePoints)
- Führungskräfte-Liste: beide Sichten 'direkt' (an nächster FK abgeschnitten, additiv) und 'gesamt' (komplette Downline), Gesamt-Spalte nach Kundenzählweise
- Team-Abos: je Ebene 'abgerechnet (Monat)' und 'bis zum 25. erwartet'; Payline-Karte mit Teamabo-/Kundenabo-Zählern
- Incentive-Live-Ranking: Qualifizierte zuerst nummeriert (fixt auch isWinner rank<=max_winners)
- Porto: Netto-/Brutto-Kennzeichnung (Berater netto, Endkunden inkl. MwSt., portal_view-Flag; auch CRM-/Shop-Warenkorb + Checkout), Yard::shipping_tax-Fix
- Struktur-Ansicht: Abo-Badges 'A' (eigenes Abo) und '(n)' (Kundenabos) je Teampartner, gebatcht
- Abo-Löschung: Softdelete setzt active=0 (UserAbo deleting-Hook) + Bereinigungs-Migration für gelöschte-aber-aktive Abos
- Doku: technische Analyse + Kundinnen-Feedback-Dokument unter dev/2026-07-22/
- Tests: IncentiveRankingTest, TeamStructureAboBadgesTest, YardShippingTaxTest (neu); BackofficeStatisticsListsTest, TeamAboOverviewTest, PaylineForecastServiceTest, AboAdminDeleteTest, AboOneTimeViewTest erweitert

Außerdem enthalten (Branch-WIP vor dem Feedback): DATEV-Abgleich-Fixes 08+09/2025, USt-ID-Live-Validierung sowie restliche unkommittete Stände (u. a. Abo-Pause-Sprachkeys).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-24 13:56:02 +00:00

116 lines
7.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Was ist neu? – Übersicht der Neuerungen (Juli 2026)
Diese Übersicht erklärt alle Neuerungen, die auf **my.mivita.care** freigeschaltet wurden – mit direkten Links, damit du sofort siehst, wo du klicken musst.
**Kurzüberblick:**
| Neuerung | Wo? | Für wen? |
| --- | --- | --- |
| Abo pausieren | [Mein Abo](https://my.mivita.care/user/abos/me) | Alle Berater mit Abo |
| Neues Abo nach Kündigung möglich | [Mein Abo](https://my.mivita.care/user/abos/me) | Alle Berater |
| Provision „Stand heute" | [Dashboard](https://my.mivita.care/home) | Alle Berater |
| Payline-Prognose (Liefertage) | [Dashboard](https://my.mivita.care/home) | Alle Berater |
| Payline-Abo-Umsatz Soll/Ist | [Team-Abos](https://my.mivita.care/user/abos/team/show) | Alle Berater |
| Statistik: aktuelle Abo-Bestände, Neupartner-Liste, Top-10, Führungskräfte-Zahlen u. v. m. | [Statistik](https://my.mivita.care/user/backoffice/statistics) | VIP-Berater |
---
## 1. Abo pausieren – einen Monat aussetzen
**Wo:** [Mein Abo](https://my.mivita.care/user/abos/me) → Abo öffnen → Button **„Abo bearbeiten"**
Du kannst dein Abo jetzt selbst um **einen Monat pausieren**. Die nächste Lieferung wird dabei automatisch um einen Monat nach hinten geschoben – dein Abo bleibt bestehen und läuft danach ganz normal weiter.
So funktioniert es:
1. Öffne [Mein Abo](https://my.mivita.care/user/abos/me) und klicke auf **„Abo bearbeiten"**.
2. Im Fenster findest du (unter dem Liefertag) den Bereich **Pause** mit dem Button **„Abo pausieren"**.
3. Nach dem Bestätigen siehst du sofort das neue Datum der nächsten Lieferung.
Die Spielregeln:
- Eine Pause ist möglich, sobald dein Abo **6 bezahlte Lieferungen** erhalten hat (Mindestlaufzeit).
- Du kannst **einmal alle 6 Monate** pausieren. Ist die Pause gerade nicht möglich, zeigt dir das Fenster an, **ab wann** du wieder pausieren kannst.
- Kurz vor dem nächsten Liefertermin (wenn die Bestellung bereits in Vorbereitung ist) ist keine Pause mehr möglich – dann greift sie ab der übernächsten Lieferung.
Das Bearbeiten-Fenster wurde dabei auch aufgeräumt: oben der **Liefertag**, darunter die **Pause**, und ganz unten – bewusst dezent – die Kündigung.
## 2. Kündigung blockiert kein neues Abo mehr
Bisher konnte es passieren, dass nach einer Abo-Kündigung **kein neues Abo** angelegt werden konnte, weil das alte, gekündigte Abo das System blockiert hat. Das ist behoben: Ein gekündigtes oder ausgelaufenes Abo steht einem **Neustart** nicht mehr im Weg. Wer sein Abo beendet hat, kann also jederzeit wieder ein neues abschließen.
## 3. Dashboard: Provision „Stand heute" 💶
**Wo:** [Dashboard (Startseite)](https://my.mivita.care/home) → Karte „Monatsstatistik"
Im Umsatz-Bereich der Monatsstatistik gibt es eine neue Kachel: **deine Provision zum heutigen Stand** – in Euro, für jeden Berater sichtbar. Sie enthält alle Bestandteile: Payline-Provision, Shop-Provision und Wachstumsbonus.
Wichtig zu wissen:
- Im **laufenden Monat** trägt die Kachel ein **„Live"**-Zeichen: Der Wert ist eine Momentaufnahme und wird ca. alle **6 Stunden** aktualisiert. Er ist **vorläufig** – verbindlich wird die Provision erst mit dem Monatsabschluss.
- Bei **abgeschlossenen Monaten** siehst du automatisch die endgültig abgerechnete Provision (ohne „Live"-Zeichen).
## 4. Dashboard: Payline-Prognose zu den Liefertagen 📈
**Wo:** [Dashboard (Startseite)](https://my.mivita.care/home) → Karte „Monatsstatistik", unterhalb der Kacheln
Für den laufenden Monat siehst du jetzt eine **Vorschau auf die Abo-Liefertage** (5., 10., 20., 25.): Für jeden noch anstehenden Liefertag wird angezeigt, wie viele Abo-Punkte aus deiner Payline dazukommen und wie hoch dein Punktestand **voraussichtlich insgesamt** danach ist. Bereits vergangene Liefertage sind als „erledigt" markiert.
So erkennst du früh im Monat, wo du am Monatsende ungefähr landen wirst – z. B. ob die nächste Qualifikationsstufe erreichbar ist.
## 5. Team-Abos: Payline-Abo-Umsatz Soll und Ist
**Wo:** [Team-Abos](https://my.mivita.care/user/abos/team/show)
Auf der Team-Abo-Seite gibt es eine neue Karte mit dem **Abo-Umsatz deiner Payline** – also der Ebenen deines Teams, die für deine Provision zählen:
- **Soll:** die Punkte, die die aktiven Abos deiner Payline in diesem Monat planmäßig bringen.
- **Ist:** die Punkte, die davon **bereits bestellt und bezahlt** wurden.
Darunter steht, wie viele Ebenen und Teampartner aktuell zu deiner Payline gehören.
---
## Neuerungen in der Statistik (nur für VIP-Berater)
**Wo:** [Statistik](https://my.mivita.care/user/backoffice/statistics)
### 6. Abo-Bestände immer aktuell
Die Abo-Zahlen (Teamabos, Kundenabos, Führungskräfte-Abos, Top-Kundenabos) zeigen jetzt **immer den aktuellen Bestand** – auch wenn du einen bereits abgeschlossenen Monat auswählst. Vorher wurden bei alten Monaten eingefrorene Zahlen angezeigt; jetzt siehst du den Bestand von heute (erkennbar am Hinweis „aktueller Stand").
### 7. Provisions-Karte in der Übersicht
Neben „Neupartner" und „1000-Punkte-Shops" gibt es oben eine dritte Karte: **deine Provision** für den gewählten Monat, aufgeschlüsselt nach **Payline, Shop und Wachstumsbonus**. Im laufenden Monat als Live-Wert (siehe Punkt 3), bei alten Monaten der abgerechnete Endstand.
### 8. Neupartner-Liste mit Sponsor und Kundenpunkten
Klickst du auf die **Neupartner-Zahl**, öffnet sich jetzt eine Liste der neuen Partner des Monats – inklusive **Sponsor** (wer hat den Partner geworben) und dessen **Kundenpunkten**. Die Liste lässt sich wie gewohnt als **CSV-Datei** herunterladen.
### 9. „Neu"-Zahlen sind jetzt klickbar
Überall, wo eine grüne **„+N"-Markierung** neue Abos oder neue Partner anzeigt (auch auf dem [Dashboard](https://my.mivita.care/home)), kannst du jetzt **direkt draufklicken** und landest in der passenden Detail-Liste – gefiltert auf **nur die neuen** Einträge des Monats.
### 10. 1000-Punkte-Shops: dein eigener Shop zählt mit
Bei der Kennzahl „1000-Punkte-Shops" wird jetzt auch **dein eigener Shop** mitgezählt, wenn er die 1000 Punkte erreicht hat. In der Detail-Liste ist deine eigene Zeile mit **„(ich)"** markiert.
### 11. Top-10-Listen: Kundenabos im eigenen Team
Zwei neue Top-10-Übersichten zeigen, welche Teampartner die meisten **Kundenabos** haben:
- **Top 10 nach Anzahl** der Kundenabos.
- **Top 10 nach Umsatz** – mit **Soll** (was die Abos planmäßig bringen) und **Ist** (was bereits bestellt wurde).
Gezählt wird jeweils der aktuelle Abo-Bestand im eigenen Team.
### 12. Führungskräfte-Übersicht mit echten Teamzahlen
Die Führungskräfte-Tabelle zeigt pro Führungskraft jetzt: **eigene Abos**, **Kundenabos**, **Teamabos**, **Team-Kundenabos** und die **Gesamtsumme**. Dabei zählt jede Führungskraft nur ihr eigenes Team **bis zur nächsten Führungskraft** – nichts wird doppelt gezählt, die Summen gehen sauber auf.
---
## Gut zu wissen
- **„Live"-Werte** (Payline-Punkte, Prognose, Provision im laufenden Monat) werden ca. alle **6 Stunden** neu berechnet – dazwischen kann der Wert also ein paar Stunden alt sein.
- Die [Statistik-Seite](https://my.mivita.care/user/backoffice/statistics) ist weiterhin **VIP-Beratern** vorbehalten; Dashboard, Abo-Pause und Team-Abo-Seite gelten für **alle Berater**.