Partner-Einladung & Setup-Wizard

Kurze Notizen zur aktuellen Einladungskette und dem Setup-Wizard, plus offene To-dos.

Ablauf Einladung

Admin lädt Partner über resources/views/livewire/admin/partners/invite.blade.php ein.
Gültigkeit wird im Formular gewählt (1–4 Wochen) und als expires_at in PartnerInvitation gespeichert.
Einladungslink: route('partner.invitation.accept', ['token' => $token]).
Zusätzliche Statusseiten: /partner/invitation/expired/{token} und /partner/invitation/used/{token}.

/partner/invitation/{token} → Volt-Komponente partner.invitation-accept.
/partner/invitation/expired/{token} und /partner/invitation/used/{token} → statische Blade-Views.
/partner/setup → Volt-Komponente partner.setup-wizard, geschützt mit auth-Middleware.

Basisdaten: Partner wird über eingeloggten User geladen (Auth::user()->partner_id); Rolle bestimmt Icon/Label.
Schritte je Partner-Typ:
- Retailer: Stammdaten → Liefergebiete → Fertig.
- Manufacturer: Stammdaten → Marke anlegen → Fertig.
- Estate-Agent (und Default): Profil/Stammdaten → Fertig.
Schritt 1 (alle):
- Felder: Firmenname (pflicht), Logo-Upload (optional, 2 MB, jpg/png/webp), Kurzbeschreibung, Straße/PLZ/Stadt (pflicht), Website (optional, URL).
- Logo wird bei Upload in public/partner-logos gespeichert; Partner wird mit Name/Beschreibung/Logo aktualisiert.
- TODO im Code: Adresse noch separat speichern (Adresse aktuell nicht persistiert).
Schritt 2 Retailer:
- Felder: Lieferradius km, Montageradius km (1–500, pflicht).
- Speichert delivery_radius_km und assembly_radius_km im Partner; danach Abschluss.
Schritt 2 Manufacturer:
- Felder: Markenname (pflicht), Markenlogo (optional, 2 MB), Markenbeschreibung.
- Speichert neue Brand mit Slug aus Namen; Logo in public/brand-logos.
Abschluss:
- Partner wird is_active=true, setup_completed=true, setup_completed_at=now().
- Dashboard-Button; für Nicht-Makler CTA „Erstes Produkt anlegen“ (derzeit ohne Aktion).

Adresse persistieren (separates Modell/JSON), wird aktuell nur validiert.
Website-Feld wird vorausgefüllt? momentan leer trotz vorhandener Partner-Daten.
CTA „Erstes Produkt anlegen“ ohne Link/Action; Zielseite definieren.
Hersteller: Slug-Kollision/Mehrmarken-Handling prüfen (derzeit einfacher Str::slug mit create).
Estate-Agent: Gibt es spezifische Felder? Wizard zeigt nur Schritt 1 → Fertig; klären ob ausreichend.

Öffentliche Landing unter /reg/{role} auf b2in.test, Rollen-Codes:
- c = Kunde, e = Makler, m = Hersteller, r = Händler.
- Gleiches Blade-Template, Inhalte/CTA dynamisch nach Role.
QR-Codes enthalten nur den Link (/reg/{role}), kein Code-Query. Der Code steht z.B. auf der Visitenkarte und wird manuell eingegeben.
Registrierungscode ist zwingend, wird einmalig eingelöst und danach als „verbraucht“ markiert.
Validierter Code schaltet erst das passende Registrierungsformular frei (bestehender Flow wiederverwenden, kein zweites System).
Rollen-spezifische Registrierung:
- Makler (/reg/e): braucht gültige Makler-Nummer (einzigartig, vorab im System hinterlegt).
- Kunde (/reg/c): braucht gültige Kundennummer, die einem Makler zugeordnet ist; jeder Kunde muss einem Makler zugeordnet werden (Provisions-Tracking).
- Händler (/reg/r) und Hersteller (/reg/m): eigener Flow, ebenfalls mit einmaligem Code; Hersteller haben keine Kunden, Händler pflegen Sortiment und können Kundenzugänge verschaffen.

Tabelle registration_codes (oder separate broker_codes + customer_codes):
- code (unique), role (broker|customer|retailer|manufacturer), status (available|used|expired), partner_id (optional, z.B. für Händler/Hersteller), broker_id (für Kundennummern-Block), used_by_user_id (nullable), used_at, expires_at (optional), metadata (json für Notizen/Quelle).
- Für Maklernummern: role=broker, status=available, keine broker_id.
- Für Kundennummern: role=customer, broker_id Pflicht, damit Zuordnung bei Registrierung klar ist.
Einlösung:
- Lookup code + role passend zur Route.
- Wenn status != available → Fehlermeldung.
- Bei Erfolg: markiere used, setze used_at, used_by_user_id (nach erfolgreichem User-Create), ggf. partner_id koppeln.

Format: 8-stellige Nummern mit optional vorangestelltem Buchstaben (Alias). Beispiele: 00100001, M00100001, K01102513.
Buchstabenpräfixe nur Alias (Marketing), intern immer über IDs verknüpfen; Code bleibt als Alias gespeichert.
Nummern sind fortlaufend; Kundennummern werden blockweise einem Makler zugewiesen (z.B. K01102510–K01102560 = 50 Stück).
Ein Code kann nur einmal eingelöst werden und wird danach als „used“ markiert.

Neue Route /reg/{role} (Volt) mit Rollen-Slugs: c Kunde, e Makler, m Hersteller, r Händler.
Gemeinsames Template resources/views/livewire/reg/landing.blade.php, Inhalte dynamisch nach Rolle.
Eingabe und Prüfung des Registrierungscodes; Normalisierung (Leerzeichen/Bindestriche entfernt, uppercase).
Valider Code (Status available, Rolle passend) wird in Session abgelegt (registration_code_id, registration_role) und leitet zu reg/create-account weiter. Verbrauch/Markierung erfolgt beim Account-Create bzw. Wizard-Abschluss.
Neues Modell App\Models\RegistrationCode + Migration registration_codes mit Feldern für Status, Rolle, Broker-/Partner-Referenzen, Used-Infos.

Route /reg/create-account (Volt) nutzt reg.create-account-Komponente.
Felder: Vorname, Nachname, E-Mail, Passwort + Bestätigung, AGB-Checkbox.
Prüft Session-Code; mappt Rollen auf Partner-Typ (broker→Estate-Agent, retailer→Retailer, manufacturer→Manufacturer; Customer aktuell nicht unterstützt).
Erstellt Partner (minimal), User, weist Rolle zu, markiert Code als verwendet, loggt ein, leitet in den Setup-Wizard.

Route/Controller/Volt für /reg/{role}:
- Zeigt Rolle-spezifischen Text und Eingabefeld „Registrierungscode“.
- Nach erfolgreicher Code-Validierung: Formular mit bestehenden Feldern je Rolle anzeigen (Reuse: bestehende Registrierung/Setup-Logik).
Kopplung mit bestehendem Einladungssystem:
- Kein zweites System; nach Code-Check wird derselbe Registrierungspfad genutzt (User/Partner anlegen, Setup-Wizard etc.).
To-do: Admin-Oberfläche bereitstellen, um Maklernummern und Kundennummern-Blöcke zu erzeugen und einem Makler zuzuweisen.