Doku: CLAUDE.md erweitert & Salescenter-/Arbeitsnotizen

CLAUDE.md um Multi-Tenant-Routing, Payment/PAYONE, Konventionen & Dev-Test-
Commands ergaenzt. Neue Arbeitsnotizen unter docs/salescenter/ sowie
docs/Kurzfristige Anpassungen.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs/Kurzfristige Anpassungen.md

@@ -0,0 +1,22 @@
+Abo einfrieren des Abos erst zwei Tage vor der Ausführung.
+DHL Konto von mivita einbinden, Erhöhung der Zugriffe über die Versendung
+
+
+ABO
+Ein Abo hat eine bestimmte Regel und einen eigenen Bestand an Produkten. 
+Zusätzlich soll es möglich sein, kurz bevor das Abo ausgeführt wird, soll es möglich sein aus dem regulären Stand der Produkte also da, wo der Berater oder auch später der Kunde seine Produkte bestellt, weitere Produkte seinem Abo hinzuzufügen.
+
+Dazu folgenden Ablauf ich würde jedem Berater oder Kunden, der ein Abo hat drei Tage dann vorher eine E-Mail zuschicken, dass dein Abo jetzt entsprechend vorbereitet wird. In diesem Zeitraum hat er Zeit aus der regulären Bestellung weitere Produkte zu seiner Abo Bestellung hinzuzufügen. Das bedeutet er geht quasi in das eigentliche bestellen fügt seinen Warenkorb dann nicht einer neuen Bestellungen hinzu, sondern hat die Option zu meinem Abo hinzufügen. In diesem Augenblick spart er sich am Ende Versandkosten und bekommt eine gesammelte Bestellung. Ich würde es so machen, dass dann die Bestellung regulär in die Bestellungen läuft aber mit dem Hinweis wird zusammen mit dem Abo versendet.
+
+Für die Berater und die Kunden fallen dabei die Versandkosten bei dem Berater zusätzlich das Kompensation Produkt (das ist noch zu klären). Gut wäre hier auch eine Option in den Einstellungen.
+
+Es gibt ja einen Lock, d.h. X Tage bevor das Abo ausgeführt wird, ist es nicht mehr änderbar.
+Dieser Lock muss händisch änderbar sein, irgendwo in den Einstellungen. Wir haben uns darauf geeinigt, dass das zwei oder drei Tage vorher ausreicht. Ich glaube, derzeit sind es fünf oder zehn Tage.
+
+
+Mitgliedschaft
+
+Die Mitgliedschaft wird immer zehn Tage vorher verlängert. Das kann grundsätzlich raus denn jeweils früher möglich unterschiedliche Pakete für die Mitgliedschaft zu buchen. Das ist jetzt nicht mehr möglich. Von daher verlängert sich am Ende die Mitgliedschaft in dem Augenblick, wo die Mitgliedschaft Gebühr bezahlt wird. Dafür gibt es so genannte Reminder im System. Diese müssen inhaltlich angepasst werden. Die Reminder sollen grundsätzlich bleiben und auf die Zahlung der Mitgliedschaft hinwirken.. in den E-Mails gibt es Links, die anscheinend nicht mehr richtig funktionieren. Richtig gut wäre es, wenn wir hier einen Magiclink bauen können, der direkt zur Zahlung geht.
+
+Weiterhin ist es natürlich möglich, auch direkt im Sales Center die entsprechende Verlängerung abzuschließen. Hier gibt es das Produkt Business Paket oder ähnlich. Dieses Produkt hat aber die Beschreibung. Beim ersten Abschluss eines Beratervertrag ist die Verlängerung benötigt ein eigenes Paket, wo die Beschreibung entsprechend angepasst wird.
+

docs/salescenter/ABO - Bestellungen.md

@@ -0,0 +1,35 @@
+ ein Briefing für die Erweiterungen des Abo Moduls.
+Das Abo Modul soll erweitert werden und zwar soll die User die Möglichkeit bekommen kurz vor der nächsten Ausführung, 3-4 Tage dieser Wert wird in den Einstellungen gespeichert /admin/settings -> Abo, zu der Abo Bestellung weitere Produkte hinzuzufügen. Und zwar sind das Produkte nicht aus dem Abosortiment, sondern aus dem Bestellsortiment. Dieses wird grundsätzlich getrennt. Hintergrund ist, dass man so Versandkosten sparen kann und sagt in 3-4 Tagen läuft mein Abo automatisch und ich möchte jetzt noch weitere Produkte aus dem "normalen" bestellprodukten mitnehmen.
+
+Hier gibt es grundsätzlich zwei Anlaufstellen (Domains .test = testserver, .care = liveserver)
+1. das Sales Center my.mivita.care user/order/my/delivery/me Hier kann ich als Berater meine Bestellungen aufgeben. 
+2. in.mivita.care Hier ist der Endkunden Login, wo ich mein Abo bearbeiten kann. 
+
+Es geht nicht darum, die Produkte des Abonnements zu erhöhen. Diese Funktion gibt es bereits, sondern es geht darum einmalig dem Abo Produkte aus dem normalen Bestellsortiment hinzuzufügen.
+
+
+So würde ich mir den Prozess Flow vorstellen?
+Die User bekommen eine E-Mail, dass ihr Abo in 3-4 Tagen je nach Einstellungen versendet wird und berechnet wird (ausgeführt wird) hier noch mal ein Hinweis, dass auch bitte geprüft wird, das entsprechende Deckungen der Zahlungsweise bestehen.
+Weiterhin gibt es den Hinweis. Füge jetzt noch weitere Produkte einmalig deinen Abo hinzu und spare so Versandkosten. Und einen doppelten Versandweg. Hier würde ich vielleicht noch mal auf Nachhaltigkeit eingehen. Das muss man noch mal prüfen.
+
+Es muss immer unterschieden werden, ob es ein Endkunde ist oder ein Berater ist.
+
+Daraus leiten sich auch dann die Links ab einmal zu my.mivita.care und in.mivita.care
+
+Auf dem Link würde ich jeweils zu dem aktiven Abo leiten Berater zum Beispiel https://my.mivita.care/user/abos/detail/me/3 innerhalb des Zeitraumes Direkt als Card Über den Produkten des eigentlichen Abos mit dem Hinweis jetzt noch einmalig Produkte aus dem normalen Bestellsortiment deinem Abo Versand hinzufügen.
+Klickt mal auf den Button öffnet sich ein modales Fenster, ähnlich wie bei Produkte dem Abo hinzufügen, nur dass hier die entsprechenden Produkte aus user/order/my/delivery/me gezeigt werden. Wichtig auch mit der Angabe von Steuer und den berechneten Endpreis für den Berater.
+
+Bei dem Endkunden ist es dann ähnlich, nur auf den Endkunden zugeschnitten
+
+Hier kann dann jeweils über, Plus Button Produkte hinzugefügt werden. Auf der Übersichtsseite erscheint dann ein zweiter Warenkorb beziehungsweise die Produkte in der Übersicht, welche hinzugefügt worden sind und es gibt einen neu berechneten Endpreis. Wichtig ist auch, dass die Portokosten natürlich entsprechend des Gesamtgewichts berechnet werden.
+
+Da wir an dieser Stelle eine zusammenfassende end Berechnung benötigen wir eine Splittung, d.h. oben wird dann die Summe der neuen hinzugefügten einmaligen Produkte berechnet. Als Zwischensumme
+
+Unten wird, wie gehabt, die Summe der Abo Produkte berechnet, Hier auch als Zwischensumme
+
+Die Endsumme, Lieferkosten Steuern, etc. Gesamtsumme kommen in einer Extra Card unter die beiden produktlisten. Gut wäre es auch, wenn wir ein Seitenelement schaffen, was noch einmal die Summe des Warenkorbsmit den Details auflistet, um beim scrollen fix an der Seite ist sonst verliert man den Überblick
+
+Wichtig ist der Hinweis, dass nach der Ausführung des Abos die Produkte hier auch wieder entfernt werden und nur die reinen Abo Produkte bleiben. 
+
+Zur Rechnung. Es muss dann eine Gesamtrechnung erstellt werden die so ist wie gehabt nur dass dann zusätzlich die einmalig angelegten Artikel dazukommen. Diese müssen auch entsprechend gekennzeichnet sein und sollten unterhalb der Abo Produkte kommen und klar abgegrenzt werden genauso im Lieferschein damit klar erkennbar ist um welche Produkte es sich handelt.
+

docs/salescenter/Todos Backoffice.md

@@ -0,0 +1,157 @@
+
+
+
+#### 1. Überarbeitetes Dashboard & KPI-Übersicht
+
+Das Dashboard soll eine interaktive Struktur erhalten (Linien 1 bis x). Folgende Kennzahlen müssen präzise abgebildet werden:
+
+- **Anzahl der eigenen Kundenabos:** Direkte Sichtbarkeit der persönlichen Kundenentwicklung.
+    
+- **Kundenabos im Team (Terminologie-Korrektur):** Die Bezeichnung wird von „Team Kunden“ auf **„Teamkundenabos“** oder **„Kundenabos im Team“** geändert. Grund: Team-Kunden haben nicht zwingend ein aktives Abonnement; die Kennzahl muss jedoch rein die Abos widerspiegeln.
+    
+- **Umsatz & Volumen:** Darstellung des Umsatzes pro Linie (Abos, Einzelbestellungen etc.) inklusive Summenbildung.
+    
+
+#### 2. Interaktivität & „Deep Dive“ (Klickbarkeit)
+
+Es ist entscheidend, dass Zahlen keine abstrakten Werte bleiben. Hinter jeder Kennzahl müssen die entsprechenden Personen sichtbar sein:
+
+- **Klick-Funktion für Statistiken:** Wenn z. B. „55 Teamabos“ angezeigt werden, muss diese Zahl anklickbar sein, um die Liste der dahinterstehenden Personen zu öffnen.
+    
+- **Neupartner & Teamabos:** Eine direkte Klickmöglichkeit für Teamabos und Neupartner wird implementiert, damit Führungskräfte sofort sehen, wer diese Menschen sind und sie gezielt unterstützen können.
+    
+- **Detailansicht pro Person:** Beim Klick auf eine Linie öffnen sich detaillierte Infos (Generation, Punkte pro Abo, Ausführungsdaten der Kundenabos).
+    
+
+#### 3. Spezial-Kennzahl: „1000 Punkte Shop“
+
+Um Top-Performer hervorzuheben, wird eine neue Metrik eingeführt:
+
+- **Definition:** Erfassung aller Teampartner, die einen Kundenumsatz von mindestens 1000 Punkten erzielen.
+    
+- **Funktion:** Beim Klick auf diese Kennzahl erscheint eine Namensliste, die nach Volumen absteigend sortiert ist und die jeweiligen Volumenpunkte explizit anzeigt.
+    
+
+#### 4. System-Anpassungen & Formulare
+
+- **Bestell-Formular:** Integration einer Pflichtabfrage: _„Von wem hast du von Mivita erfahren?“_, um die Zuweisung und das Marketing besser tracken zu können.
+    
+- **Stornoprozess:** Prüfung der Logik für Stornorechnungen. Es muss sichergestellt werden, dass bei einer Stornierung die entsprechenden Punkte systemseitig korrekt zurückgeführt (abgezogen) werden.
+    
+
+#### 5. Rechtliches & Sichtbarkeit (Incentives)
+
+- **Transparenz in Ranglisten:** Für Incentives (z. B. Montenegro) sollen alle Namen der Teilnehmer (nicht nur die Top 30) mit Foto und Land angezeigt werden.
+    
+- **Opt-in Button:** Kevin implementiert einen Button, mit dem Partner aktiv zustimmen können, dass ihr Name in den Ranglisten für alle sichtbar ist.
+    
+- **Rechtliche Prüfung:** Ein Network-Anwalt wird durch Dani/Alois hinzugezogen, um die Anzeige von Namen in internen Ehrungen ohne explizite Einzelzustimmung abzuklären.
+    
+
+#### 6. Multimedia-Bereich
+
+- **Event-Archiv:** Ein neuer Reiter (analog zum News-Archiv) wird erstellt. Hier lädt Susi regelmäßig Fotos von Veranstaltungen und Calls hoch, um das Momentum im Team zu fördern.
+### Briefing: Optimierung & Ausbau des Mivita Backoffice (Fokus: Dashboard-Logik & Interaktivität)
+
+Ziel dieses Umbaus ist es, das aktuelle "Daten-Chaos" durch eine übersichtliche, interaktive und klickbare dreistufige Tabellenstruktur zu ersetzen. Führungskräfte müssen von der Vogelperspektive bis auf den einzelnen Kunden durchklicken können.
+
+#### Stufe 1: Das Haupt-Dashboard (Die Gesamtübersicht)
+
+Die Startseite der Statistiken zeigt eine kompakte Zusammenfassung der gesamten Struktur (alle tatsächlich vorhandenen Linien sowie eine Summenzeile am Ende).
+
+- **Spaltenaufbau:** * Linie (1. Linie, 2. Linie etc.)
+    
+    - Anzahl der Berater
+        
+    - Umsatz (Gesamtumsatz aus Abos, Einzelbestellungen etc.)
+        
+    - Anzahl der Teamabos
+        
+    - Anzahl der Kundenabos
+        
+- **Klick-Logik:** Egal, wo man in dieser Übersicht hinklickt (auf eine ganze Linie oder auf eine konkrete Zahl wie z.B. "3 Teamabos"), es öffnet sich immer eine tiefergehende Detailseite.
+
+- **Aktueller MVP-Stand:** Die Kennzahlen sind als klickbare Badges umgesetzt. Die Summenzeile ist ebenfalls klickbar und öffnet über alle vorhandenen Linien. Bei Teamabos und Teamkundenabos wird zusätzlich angezeigt, wie viele Abos im gewählten Monat neu dazugekommen sind.
+    
+
+#### Stufe 2: Die Linien-Detailansicht (Generationen-Ebene)
+
+Klickt man in der Hauptübersicht beispielsweise auf **"1. Linie"**, öffnet sich eine neue Seite, die alle direkten Partner (Firstlines) dieser Linie namentlich auflistet (z. B. Anna, Lena, Lisa).
+
+- **Spaltenaufbau pro Partner:**
+    
+    - Name der Firstline (z. B. Anna)
+        
+    - Eigenes Abo (Anzeige in Punkten)
+        
+    - Kundenabos (Anzahl der Abos & Gesamtpunktewert dieser Abos)
+        
+    - Teampartnerabos (Anzahl der Abos & Gesamtpunktewert in der Organisation)
+        
+    - Kundenabos im Team (Anzahl der Abos & Gesamtumsatz dieser Abos)
+        
+    - **Gesamt:** Diese Spalte ist besonders wichtig. Sie addiert alle Abos (Eigenes Abo + Kundenabos + Teamabos + Kundenabos des Teams) und zeigt die Gesamt-Aboanzahl sowie die Gesamt-Umsatzpunkte pro Person an.
+        
+- **Klick-Logik:** Auch hier ist jede Kennzahl (z.B. "Kundenabos" bei Anna) wieder anklickbar.
+    
+
+#### Stufe 3: Die Tiefen-Detailansicht (Listen-Ebene)
+
+Wenn man noch mehr Infos zu einer spezifischen Kennzahl haben möchte (entweder durch Klick auf eine Zahl im Haupt-Dashboard oder durch Klick auf eine Metrik bei einem bestimmten Partner in Stufe 2), öffnet sich das tiefste Level.
+
+- **Beispiel 1 (Klick auf Annas "Kundenabos"):** Es öffnet sich das Fenster "Anna - Kundenabos". Man sieht oben eine Zusammenfassung (z.B. "Insgesamt: 4 Kundenabos / 200 Abokundenpunkte"). Darunter werden alle 4 Kunden einzeln und übersichtlich aufgelistet.
+    
+- **Beispiel 2 (Klick auf "3 Teamabos" im Haupt-Dashboard):** Es öffnet sich das Fenster "Teamabos Generation 1". Auch hier gibt es eine Zusammenfassung und darunter die Liste der 3 Personen (z.B. Sabine, Carola, Anna).
+    
+- **Angezeigte Daten pro Eintrag in der Liste:**
+    
+    - Name des Kunden/Partners
+        
+    - Punktewert (z. B. 50 Punkte)
+        
+    - Nächste Ausführung (Datum, z. B. 10.4.2026)
+        
+    - Abo Lieferungen (Anzahl, z. B. 1)
+
+    - Status des Abos, z. B. aktiv, angehalten, storniert oder inaktiv
+
+    - Besteht-seit-Datum; neue Abos im gewählten Monat werden optisch hervorgehoben
+
+- **Aktueller MVP-Stand:** Detailtabellen haben eine Suche, klickbare Spaltensortierung, eine Summenzeile und einen CSV-Export. Der gewählte Monat/Jahr bleibt beim Wechsel zwischen Übersicht und Detailansicht erhalten.
+
+- **Performance/Snapshots:** Abgeschlossene Monate können als Backoffice-Statistik-Snapshot gespeichert werden. Dadurch bleiben vergangene Monatswerte stabil und müssen bei großen Teams nicht jedes Mal live neu berechnet werden.
+
+- **1000-Punkte-Shop:** Die Detailansicht zeigt keine zusätzliche Qualifikations-Einteilung mehr, sondern den aktuellen Karriere-Level des Beraters. Die Punkte bleiben nach Eigenpunkten, Kundenabo-Punkten, Einzelbestellungs-Punkten und sonstigen Kundenpunkten getrennt sichtbar.
+
+- **Karriere-Level:** Detailansichten zeigen den aktuellen Karriere-Level des jeweiligen Beraters, damit die Namenlisten fachlich besser einordbar sind.
+
+- **Datenschutz-Hinweis:** Detailansichten weisen sichtbar darauf hin, dass personenbezogene Daten rechtlich noch final geklärt werden und aktuell nur für berechtigte VIP-Auswertungen vorgesehen sind.
+
+- **Übersichts-Export:** Die Linienübersicht kann als CSV exportiert werden. Enthalten sind alle Linien, die Summenzeile, neue Abo-Zählungen und die getrennten Punktewerte.
+
+- **Tests:** CSV-Inhalte für Übersicht und Details, der Zeitraum-Erhalt zwischen Übersicht, Detailansicht und Export, neue Abo-Markierungen und Abo-Statusgründe aus Zahlungsfehlern sind gezielt abgesichert.
+
+- **Performance-Hinweis:** Die Übersicht zeigt, ob die Daten live oder aus einem Snapshot geladen wurden, inklusive Laufzeit der Berechnung.
+
+- **Checkout-Herkunft:** Kundenbestellungen im Shop fragen eine vordefinierte Herkunft plus optionalen Freitext ab. Die Werte werden an der Bestellung gespeichert und im Bestelldetail angezeigt.
+        
+
+---
+
+#### Weitere wichtige Backoffice-Anpassungen (abseits der Listen-Logik)
+
+- **Neue Spezial-Kennzahl „1000 Punkte Shop“:**
+    
+    - Eine zusätzliche, anklickbare Kennzahl in der Übersicht.
+        
+    - Zeigt die Anzahl der Teampartner an, die mindestens 1000 Punkte Kundenumsatz generiert haben.
+        
+    - Beim Klick darauf erscheint eine Liste mit den Namen dieser Partner, absteigend sortiert nach Volumen, wobei die genauen Volumenpunkte angezeigt werden.
+        
+- **Erfassung der Herkunft (Formular):**
+    
+    - Im Bestellformular wird die verpflichtende Abfrage eingefügt: _„Von wem hast du von Mivita erfahren?“_ (Wichtig für Zuordnung und Tracking).
+        
+- **Stornoprozess:**
+    
+    - Die IT muss prüfen, ob Stornorechnungen systemseitig korrekt verarbeitet werden, sodass bei einem Storno die entsprechenden Punkte automatisch und fehlerfrei zurückgeführt (abgezogen) werden.

docs/salescenter/Zahlungabieter.md

@@ -0,0 +1,21 @@
+PayPal:
+in Zukunft wird PayPal direkt integriert, nicht mehr über PAYONE.
+ D.h. sowohl beim Checkout als auch in der Abwicklung in der Fehlbehandlung in der Speicherung etc. muss an allen Ecken PayPal sauber integriert werden, wenn es um die PayPal Zahlung geht. Die weiteren Zahlungen bleiben vorerst bei PAYONE.
+
+Gerade bei den Abos Subscription ist das ein wichtiger Faktor, da es hier immer wieder technisch Schwierigkeiten mit PAYONE über PayPal gegeben hat.
+
+D.h. wir müssen hier sauber trennen bei der Integration von PayPal.
+
+Zusätzlich gibt es noch Subscription, die über PAYONE mit PayPal angeschnitten werden. Diese bleiben erst bestehen. Sobald PayPal sauber funktioniert und etwas Laufzeit hinter sich hat, werden wir die Benutzer auffordern ihres Subscription einmalig anzupassen d.h. die alte Subscription wird gelöst und es wird dann eine neue angelegt mit dem neuen direkten PayPal Account.
+
+Abos / Subscription:
+Änderungen und Anpassungen bei den Subscription.
+
+Bei den Abos ist es derzeit so, dass mit Abschluss des Abos direkt die erste Zahlung und die Initialisierung der Subscription stattfindet. Wir brauchen jetzt bei den Abos eine Möglichkeit dieses Subscription wieder zu lösen und eine neue anzulegen. 
+
+Das betrifft einmal den Wechsel der Zahlungsmethode von Kreditkarte auf PayPal umgekehrt wichtig. Das machen wir nur noch über den direkten PayPal Account nicht mehr PayPal über PAYONE nur Kreditkarte bleibt bei PAYONE bei den Subscription.
+
+Weiterhin betrifft das auch die Aktualisierung der bestehenden Zahlungsmethode, d.h. Hinterlegung von neuen Kreditkartendaten beziehungsweise die Aktualisierung. Diese Möglichkeit muss über PAYONE abgewickelt werden.
+Die Aktualisierung der Zahlungsmethode Kreditkarte soll als erstes implementiert werden!
+
+Weiterhin, wenn ein Abbuchung fehlschlägt aufgrund von einem Fehler oder einer nicht gedeckten Zahlungsweise soll der User die Möglichkeit haben die Zahlung im System nachträglich zu leisten d.h. hier kann er über einen Zahlunglink entsprechend mit einer gewählten Zahlungsmethode wie beim Checkout dann die Zahlung abschließen und das Abo wird dann entsprechend auf bezahlt mit allen weiteren nötigen Hintergrundprozessen ausgeführt.