Berater faellt aus (B2): pausieren nach 2 Tagen, Rueckgabe bei Zahlung, harter Cut am 28. Tag

Entwicklungsplan September, B2 (Protokoll 08.09., Rueckmeldung 14.09., R3):
- Ablauftag + 2 Kalendertage (Nachtlauf): Team, Kunden, Kundenabos und
  Portal-Logins gehen umkehrbar an den naechsten aktiven Sponsor, jede
  Umhaengung in consultant_suspension_transfers protokolliert. Kurzinfo
  an den Sponsor ohne Listen, keine Mail an das Firmenkonto.
- Zahlung bis Tag 27: Berater aktiv, Team und Kundendaten zurueck (nur
  was noch beim Sponsor liegt); Umsaetze der Zwischenzeit bleiben dort.
- Tag 28: was noch am Berater haengt geht endgueltig an den Sponsor,
  Berater wird dessen Kunde (ohne Duplikat) und geloescht; Listen-Mail
  mit Vorname, Nachname, Telefon, E-Mail an jeden haltenden Sponsor.
- Cron, Zahlungseingang und Admin-Ablaufdatum laufen ueber
  ConsultantSuspensionService; user:cleanup --dry-run listet beide Stufen.
- Mail 35 und Dashboard nennen Pausentag und Frist; Fristen in
  config/mivita.php (cleanup_suspend_days, cleanup_delete_days).
- Nebenbefunde: Kernel referenziert UserCleanUp, user:restore aus der
  User-Bereinigung laeuft nur noch einmal.
- Testschema: shopping_users.auth_user_id nullable wie auf Produktion
  (Migration aendert nur, wo die Spalte noch NOT NULL ist).
- Uebersicht fuer die Kundin: dev/_tickets/2026-09-23-mitgliedschaft-
  ablauf-uebersicht.md.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Kevin 2026-09-23 15:44:45 +00:00
parent 6cd00a60ec
commit 0b8f8abeeb
29 changed files with 1528 additions and 193 deletions

View file

@ -0,0 +1,237 @@
# Wenn ein Berater seine Mitgliedschaft nicht verlängert
**Übersicht für mivita · Stand 23.09.2026**
Diese Seite beschreibt, was ab dem nächsten Update passiert, wenn die Jahresgebühr eines Beraters
nicht bezahlt wird: wann was geschieht, wer welche E-Mail bekommt und was mit Team, Kunden, Abos und
Punkten passiert. Grundlage sind die Absprachen aus dem Zoom-Meeting vom 08.09. und eure Rückmeldung
vom 14.09.
---
## Das Wichtigste in Kürze
- **2 Tage nach Ablauf** wird der Berater pausiert. Sein Team und seine Kunden gehen
**vorübergehend** an seinen Sponsor. Ab dann zählen ihre Umsätze beim Sponsor.
- **Bis zum 27. Tag** nach Ablauf kann der Berater zahlen und bekommt Team und Kunden **zurück**. Was
der Sponsor in der Zwischenzeit an Umsatz bekommen hat, bleibt beim Sponsor.
- **Am 28. Tag** ist Schluss: Team und Kunden bleiben **endgültig** beim Sponsor. Der Berater
wird Kunde seines Sponsors und als Berater entfernt. Der Sponsor bekommt eine E-Mail mit allen
Namen und Kontaktdaten.
Gezählt wird in Kalendertagen ab dem Ablauftag, die Uhrzeit spielt keine Rolle. Die 2 und die 28
Tage lassen sich ohne Programmierung ändern.
---
## Was sich gegenüber heute ändert
| | bisher | neu |
| --- | --- | --- |
| Berater pausiert | nach **14 Tagen** | nach **2 Tagen** |
| Team zum Sponsor | nach 14 Tagen | nach 2 Tagen |
| **Kunden** zum Sponsor | erst nach **2 Monaten** | nach **2 Tagen** |
| **Kundenabos** zum Sponsor | **nie** | nach 2 Tagen |
| Kunden-Logins (Kundenportal) zum Sponsor | **nie** | nach 2 Tagen |
| Umsätze der Kunden in der Pause | kamen **bei niemandem** an | zählen beim Sponsor |
| Zahlung in der Pause | nur das Team kam zurück | Team **und** Kunden kommen zurück |
| Endgültiges Entfernen | nach **2 Monaten** | am **28. Tag** |
| E-Mail an den Sponsor | keine | Kurzinfo bei der Pause, Liste beim Entfernen |
Der wichtigste Unterschied: Bisher hingen die Kunden eines pausierten Beraters bis zu zwei Monate
bei ihm fest. Er stand nicht mehr in der Struktur, deshalb kamen ihre Bestellungen bei niemandem
an, weder bei ihm noch beim Sponsor. Kundenabos wurden gar nicht umgehängt. Das ist jetzt behoben.
---
## Der Ablauf an einem Beispiel
Die Mitgliedschaft läuft am **1. Oktober** ab.
| Wann | Was passiert | Wer bekommt eine E-Mail |
| --- | --- | --- |
| ca. 10. September | 1. Erinnerung (21 Tage vorher) | Berater |
| ca. 17. September | 2. Erinnerung (14 Tage vorher) | Berater |
| ca. 29. September | letzte Erinnerung (2 Tage vorher) | Berater, Kopie an mivita |
| **1. Oktober** | Mitgliedschaft abgelaufen. Der Berater steht noch bis zur Pause in der Struktur. | – |
| 2. Oktober, 02:00 Uhr | Hinweis: „Ab dem 03.10. pausieren wir deinen Account … zurück, wenn du bis zum 28.10. verlängerst“ | Berater, Kopie an mivita |
| **3. Oktober, 03:30 Uhr** | **Pause:** Team, Kunden, Kundenabos und Kunden-Logins gehen an den Sponsor. Der Berater ist nicht mehr in der Struktur. | Sponsor (Kurzinfo) |
| 3. bis 28. Oktober | Bestellungen der Kunden und Abo-Lieferungen zählen beim Sponsor. Der Berater kann sich weiter einloggen und seine Mitgliedschaft bezahlen. | – |
| **Zahlung bis 28. Oktober** | Der Berater ist sofort wieder aktiv und bekommt Team und Kunden zurück. | – |
| **29. Oktober, 03:30 Uhr** (ohne Zahlung) | **Endgültig:** Der Berater wird Kunde seines Sponsors und als Berater entfernt. | Sponsor (mit Liste) |
Die nächtlichen Läufe finden um 02:00 Uhr (Erinnerungen) und um 03:30 Uhr (Pause und Entfernen)
statt. Ob die Mitgliedschaft am 1. Oktober morgens oder abends abläuft, ändert an den Terminen
nichts.
---
## Was genau bei der Pause passiert
**Beim Berater**
- Sein Account ist pausiert. Er kann sich einloggen und seine Mitgliedschaft bezahlen.
- Er steht nicht mehr in der Struktur und bekommt für diese Zeit keine Punkte und keine Provision.
- Bereits verdiente Provisionen werden wie gewohnt ausgezahlt.
**Beim Sponsor**
- Er übernimmt die **Teampartner** des Beraters (die Firstline; alles darunter hängt an ihnen und
zieht mit).
- Er übernimmt die **Kunden** des Beraters, deren **Kundenabos** und deren **Logins im
Kundenportal**.
- Alles, was diese Kunden und Teampartner ab jetzt bestellen, zählt bei ihm. Es wird nichts
rückwirkend umgebucht: Bestellungen vor der Pause bleiben beim Berater.
**Wer „der Sponsor“ ist:** der nächste aktive Berater nach oben. Ist der direkte Sponsor selbst
pausiert, geht es eine Ebene weiter. Ist das die Firma, bekommt niemand eine E-Mail.
Jede einzelne Umhängung wird protokolliert. Nur deshalb kann das System später genau diese
Kunden und Teampartner zurückgeben.
---
## Was bei einer Zahlung vor dem Ende der Frist passiert
Sobald die Zahlung eingeht (Karte und PayPal sofort, Überweisung beim Zahlungseingang):
- Der Berater ist wieder aktiv und steht wieder unter seinem Sponsor in der Struktur.
- Er bekommt seine Teampartner, Kunden, Kundenabos und Kunden-Logins zurück.
- **Ausnahme:** Wurde ein Kunde oder Teampartner in der Zwischenzeit von Hand zu jemand anderem
übertragen, bleibt er dort. Zurück kommt nur, was noch beim Sponsor liegt.
- Umsätze, Punkte und Provisionen aus der Pause **bleiben beim Sponsor**.
Dasselbe passiert, wenn im Admin das Ablaufdatum eines Beraters in die Zukunft gesetzt wird. Setzt
man es im Admin in die Vergangenheit, wird der Berater sofort pausiert, ohne die 2 Tage.
---
## Was am 28. Tag ohne Zahlung passiert
- Alles, was noch am Berater hängt, geht **endgültig** an den Sponsor.
- Der Berater wird **Kunde seines Sponsors**. Gibt es beim Sponsor schon einen Kundeneintrag mit
seiner E-Mail-Adresse, wird kein zweiter angelegt.
- Der Berater-Account wird entfernt. Will er später wieder Berater werden, registriert er sich
neu mit Starterpaket.
- Der Sponsor bekommt die E-Mail mit der vollständigen Liste.
Eine Wiederherstellung durch mivita bleibt als Ausnahme möglich. Sie holt aber nur die
Teampartner zurück, nicht die Kunden.
---
## Die E-Mails im Wortlaut
### 1. An den Berater, nach dem Ablauf (nachts danach)
**Betreff:** Deine Mitgliedschaft bei mivita.care
> Deine Mitgliedschaft ist am **01.10.2026** abgelaufen. Ab dem **03.10.2026** pausieren wir Deinen
> Berater-Account: Dein Team und Deine Kunden werden dann vorübergehend Deinem Sponsor zugeordnet,
> ihre Umsätze zählen in dieser Zeit bei ihm.
>
> Verlängerst Du Deine Mitgliedschaft bis zum **28.10.2026**, bekommst Du Dein Team und Deine
> Kunden zurück. Danach wird Deine Mitgliedschaft dauerhaft beendet, und Team und Kunden bleiben
> bei Deinem Sponsor.
>
> Klick auf den Button, um Deine Mitgliedschaft jetzt zu verlängern:
>
> **[ MITGLIEDSCHAFT VERWALTEN ]**
>
> **Hinweis:** Bereits erarbeitete, noch offene Provisionen werden Dir selbstverständlich im
> nächsten Zahlungslauf ausgezahlt. Solltest Du Deinen Account vollständig löschen wollen, dann
> schreibe bitte eine Email an info@mivita.care. Unser Berater-Service wird sich dann umgehend
> darum kümmern.
>
> Wir hoffen, Dich ganz bald wieder als aktives Mitglied der MIVITA Family begrüßen zu dürfen.
Denselben Inhalt sieht der Berater als Hinweis auf seinem Dashboard, solange er nicht gezahlt hat.
### 2. An den Sponsor, bei der Pause (Kurzinfo, ohne Liste)
**Betreff:** Dein Teampartner Anna Beispiel ist pausiert
> Hallo Petra,
>
> dein Teampartner Anna Beispiel hat seine Mitgliedschaft wegen ausstehender Zahlung nicht
> verlängert. Er hat noch bis zum **28.10.2026** (25 Tage) Zeit, sie wieder aufzunehmen, sonst wird
> die Mitgliedschaft dauerhaft entfernt. Bis dahin sind seine Kunden und Teampartner dir
> zugeordnet.
>
> Umsätze seiner Kunden und Teampartner zählen in dieser Zeit bei dir. Zahlt er rechtzeitig,
> bekommt er seine Kunden und Teampartner zurück; die Umsätze der Zwischenzeit bleiben bei dir.
>
> Mit freundlichen Grüßen
> Dein Team von mivita.care
### 3. An den Sponsor, nach 28 Tagen (mit Liste)
**Betreff:** Kunden und Teampartner von Anna Beispiel gehören jetzt zu dir
> Hallo Petra,
>
> die Mitgliedschaft von Anna Beispiel wurde dauerhaft beendet, weil sie nicht verlängert wurde.
> Seine Kunden und Teampartner sind jetzt endgültig dir zugeordnet. Hier ist die Übersicht, damit du
> Kontakt aufnehmen kannst:
>
> **Kunden (3)**
>
> | Vorname | Nachname | Telefon | E-Mail |
> | --- | --- | --- | --- |
> | Anna | Beispiel | 0170 1234567 | anna@beispiel.de |
> | Maria | Muster | 0171 999999 | maria@muster.de |
> | Klaus | Kunde | – | klaus@kunde.de |
>
> **Teampartner (1)**
>
> | Vorname | Nachname | Telefon | E-Mail |
> | --- | --- | --- | --- |
> | Ben | Partner | 0172 555555 | ben@partner.de |
>
> Mit freundlichen Grüßen
> Dein Team von mivita.care
Der ausgeschiedene Berater steht selbst als Erster in der Kundenliste, weil er jetzt Kunde des
Sponsors ist.
Alle E-Mails gehen in der Sprache des Empfängers raus (Deutsch, Englisch, Spanisch, Französisch).
Die Namen oben sind Beispiele.
---
## Beim ersten Lauf nach dem Update
Der erste nächtliche Lauf holt alles nach, was nach den neuen Fristen schon fällig ist. Gemessen am
Datenstand vom 23.09.2026:
| | Anzahl |
| --- | --- |
| Berater, die sofort pausiert werden (Ablauf vor mindestens 2 Tagen) | 6 |
| … dabei umgehängte Kundeneinträge | 64 |
| … dabei umgehängte Teampartner | 2 |
| Berater, die endgültig entfernt werden (Ablauf vor mindestens 28 Tagen) | 20 |
| … dabei umgehängte Kundeneinträge | 150 |
| Betroffene aktive Kundenabos | 0 |
Die Sponsoren dieser Berater bekommen die E-Mails aus diesem Lauf alle auf einmal. Wer mehrere
betroffene Teampartner hat, bekommt mehrere E-Mails.
**Vor dem ersten Lauf** erstellen wir eine Liste aller betroffenen Berater mit Namen und Anzahl der
Kunden und schicken sie euch. So könnt ihr noch jemanden anrufen, bevor es passiert.
---
## Zur Abstimmung
1. **Texte der Erinnerungen vor dem Ablauf.** Die drei Erinnerungen vor dem Ablauf sagen heute:
„Solltest Du allerdings die Frist verstreichen lassen, wird Dein Account **solange** automatisch
pausiert, **bis** Du Deine Mitgliedschaft erneuerst.“ Das klingt, als gäbe es kein Ende. Unser
Vorschlag:
> Solltest Du die Frist verstreichen lassen, pausieren wir Deinen Account 2 Tage nach Ablauf.
> Dein Team und Deine Kunden gehen dann vorübergehend an Deinen Sponsor. Nach 28 Tagen ohne
> Zahlung bleiben sie endgültig dort.
2. **Eigenes Abo eines pausierten Beraters.** Hat ein pausierter Berater ein eigenes Berater-Abo,
läuft es heute zu Beraterpreisen weiter. Aktuell betrifft das niemanden. Sollen wir es bei der
Pause anhalten?
3. **Eine Sammel-E-Mail je Sponsor beim ersten Lauf** statt mehrerer einzelner E-Mails? Nur
sinnvoll, wenn ein Sponsor mehrere Betroffene hat.