b2in/dev/entwicklung.md

B2IN - Projekt-Entwicklungsstand

Projektübersicht

Das B2IN-Projekt ist eine umfassende Multi-Domain-Laravel-Anwendung, die als zentrale Plattform für Partner-Management, Produkt-Verwaltung und Digital Signage dient. Die Anwendung basiert auf Laravel 12, Livewire 3 und Flux UI und bietet ein modernes, rollenbasiertes System für verschiedene Geschäftspartner.

🎯 Wichtige ToDos

• System Mails: Kommen teilweise nicht an (google etc) Probleme mit united domains ... In der Zukunft benötigen wir einen response bounce etc. " host gmail-smtp-in.l.google.com[64.233.184.27] said: 550-5.7.26 Your email has been blocked because the sender is unauthenticated. "

---

🎯 Kern-Technologien

• Framework: Laravel 12 mit PHP 8.2+
• Frontend: Livewire 3 mit Volt (Single-File Components)
• UI-Framework: Flux UI (Pro-Version) mit Tailwind CSS
• Authentifizierung: Laravel Fortify mit Sanctum
• Berechtigungen: Spatie Laravel-Permission
• Icons: Heroicons (Blade-Integration)
• Entwicklungsumgebung: Laravel Sail (Docker)

---

✅ Entwickelte Module & Funktionen

1. Multi-Domain-System

Status: ✅ Vollständig implementiert

Das System unterstützt mehrere Domains mit individuellen Themes und Konfigurationen:

• Admin-Portal (portal.b2in.test) - Verwaltungsbereich für alle Partner-Typen
• Haupt-Website (b2in.test) - Unternehmenswebsite
• Landing-Pages - Individuelle Landing-Pages mit eigenem Branding
• Domain-spezifische Assets - Separate CSS/JS-Builds pro Domain
• Theme-Switching - Dynamisches Theme-System basierend auf Domain oder GET-Parameter
• Entwicklungsmodus - Domain-Simulation für lokale Entwicklung ohne Hosts-Änderung

Technische Details:

• Domain-Erkennung über ThemeServiceProvider
• Separate Vite-Konfigurationen für Admin und Web
• Dynamische Favicon-Generierung
• Theme-basiertes Routing

---

2. Benutzer- & Rollen-Management

Status: ✅ Vollständig implementiert

Umfassendes Rollen- und Berechtigungssystem mit folgenden Rollen:

Definierte Rollen:

• Super Admin - Vollzugriff auf alle Funktionen
• Admin - Verwaltung von Partnern und System
• Retailer (Händler) - Produktverwaltung, Kundenbetreuung, Liefergebiete
• Manufacturer (Hersteller) - Marken- und Produktverwaltung
• Broker (Makler) - Lead-Generierung, Provisionen, Kundenanbindung
• Customer (Endkunde) - Produktbestellung, Dashboard-Zugriff

Berechtigungen:

• Hub-Management (Anzeigen, Erstellen, Bearbeiten, Löschen)
• Partner-Management (Anzeigen, Erstellen, Bearbeiten, Löschen, Provisionen)
• Produkt-Management (Anzeigen, Erstellen, Bearbeiten, Löschen, Miet-Optionen)
• Bestellungs-Management (Anzeigen, Verwalten)
• User-Management (Anzeigen, Verwalten, Rollen zuweisen)
• Dashboard-Zugriff
• Bestellungen aufgeben

Spezielle Features:

• Impersonation - Admins können sich als andere Benutzer einloggen
• Soft-Delete - Benutzer werden anonymisiert statt gelöscht (bei Abhängigkeiten)
• Rollenbasierte Navigation - Dynamische Sidebar basierend auf Berechtigungen
• Display-Namen - Separate Anzeigenamen für Benutzer

---

3. Partner-Management-System

Status: ✅ Vollständig implementiert

Komplettes System zur Verwaltung von Geschäftspartnern:

Partner-Typen:

• Retailer - Händler mit Liefer- und Montageradius
• Manufacturer - Hersteller mit Markenverwaltung
• Broker - Makler mit Provisionsmodell
• Customer - Endkunden

Funktionen:

• Partner-Einladungssystem:

  • E-Mail-Einladungen mit Token-basiertem Zugang
  • Konfigurierbare Gültigkeit (1-4 Wochen)
  • Status-Tracking (Offen, Verwendet, Abgelaufen)
  • Rollenbasierte Einladungen
  • Spezielle Status-Seiten für abgelaufene/verwendete Einladungen

• Partner-Setup-Wizard:

  • Mehrstufiger Onboarding-Prozess
  • Rollenspezifische Schritte und Felder
  • Logo-Upload (Partner & Marke)
  • Adressverwaltung (Straße, PLZ, Stadt, Land)
  • Retailer: Liefer- und Montageradius (1-500 km)
  • Manufacturer: Markenerstellung mit Logo
  • Setup-Status-Tracking (setup_completed, setup_completed_at)
  • Middleware-Schutz für unvollständige Setups

• **Partner-Hierarchie **:

  • Parent-Child-Beziehungen (Broker → Kunden)
  • Hub-Zuordnung für regionale Partner 🔄 Grundarchitektur vorhanden
  • Provisionsmodelle (Festbetrag oder Prozentsatz) 🔄 Grundarchitektur vorhanden

• Registrierungs-Codes:

  • QR-Code-basierte Registrierung
  • Rollenspezifische Landing-Pages (/reg/{role})
  • Code-Tracking (Verwendet von, Verwendungsdatum)
  • Code-Namen für bessere Organisation
  • Zuordnung zu übergeordnetem Partner

---

4. Hub-Management

Status: 🔄 Grundarchitektur vorhanden

Regionale Hub-Verwaltung:

Funktionen:

• Hub-Erstellung und -Verwaltung
• Standortverwaltung (HubLocations)
• Partner-Zuordnung zu Hubs
• Hub-spezifische Dashboard-Ansichten
• Indexseite mit Hub-Übersicht
• Erstellen/Bearbeiten von Hubs

Datenstruktur:

• Hub-Stammdaten
• Mehrere Standorte pro Hub
• Partner-Beziehungen

---

5. Produkt-Management-System

Status: 🔄 Grundarchitektur vorhanden

Umfassendes Produktverwaltungssystem:

Features:

• Produktliste (/products):

  • Suchfunktion (Name, Artikelnummer)
  • Filter nach Status (Aktiv, Entwurf, Inaktiv)
  • Filter nach Kategorie
  • Aktive Filter-Anzeige
  • Responsive Tabellen-Ansicht

• Produkt-Erstellung (/products/create):

  • Umfangreiches Formular für Produktdaten
  • Mehrstufige Eingabe
  • Bild-Upload
  • Varianten-Verwaltung

Datenmodelle:

• Products - Hauptprodukte
• ProductVariants - Produktvarianten mit Attributen
• Attributes - Produkt-Attribute (z.B. Farbe, Größe)
• AttributeValues - Attribut-Werte
• Categories - Produktkategorien (mehrfach zuweisbar)
• Tags - Produkt-Tags
• Brands - Marken (Partner-zuweisbar)
• Collections - Produkt-Kollektionen
• TaxRates - Steuersätze
• ShippingClasses - Versandklassen
• ProductLogistics - Logistik-Informationen

Beziehungen:

• Produkte → Kategorien (N:N)
• Produkte → Tags (N:N)
• Produkte → Verwandte Produkte (N:N)
• Produkte → Marken
• Varianten → Attribute & Werte

---

6. Dashboard-System

Status: 🔄 Grundarchitektur vorhanden

Rollenbasiertes Dashboard mit individuellen KPIs:

Admin-Dashboard:

• Aktive & geplante Hubs
• Partner-Wachstum (Gesamt, Dieser Monat)
• Plattform-Umsatz (Platzhalter)
• System-Status
• Ausstehende Einladungen
• Gesamt-Kunden

Retailer-Dashboard:

• Offene Bestellungen
• Monatlicher Umsatz
• Produkt-Aufrufe
• Lagerbestands-Warnungen
• Meine Kunden

Manufacturer-Dashboard:

• Marken-Reichweite
• Aktive Produkte
• Entwurfs-Produkte
• Gesamt-Aufrufe

Broker-Dashboard:

• Gesamt-Provision
• Ausstehende Auszahlung
• Generierte Leads
• Empfehlungs-Link
• Broker-Kunden

Customer-Dashboard:

• Marken-spezifisches Branding
• Top-Angebote
• Broker-Information
• Individuelles Design basierend auf zugewiesenem Broker

---

7. Digital Signage / Display-CMS

Status: ✅ Vollständig implementiert

Professionelles CMS-System für Digital Signage im Cabinet Showroom Bielefeld:

Video-Verwaltung:

• Verwaltung von Video-Playlists
• Reihenfolge-Verwaltung
• Video-Position einstellen (0-100% für optimalen Ausschnitt)
• Videos aktivieren/deaktivieren
• Titel für bessere Organisation

Footer-Content mit Tracking:

• Überschrift und Unterzeile
• Optionale Ziel-URL
• Automatische Short-Link-Generierung (6-stellige Codes)
• QR-Code-Generierung für Short-Links
• Echtzeit-Klick-Tracking
• Klick-Statistiken im CMS
• Reihenfolge-Verwaltung (30-Sekunden-Rotation)
• Short-Code neu generieren
• Klick-Zähler zurücksetzen
• Flexibles Layout (mit/ohne URL)

Short-Link-System:

• Automatische Code-Generierung (z.B. c59kjb)
• Short-URLs: https://cabinet.b2in.eu/go.php?z=CODE
• Tracking in Datenbank + Log-Datei
• Weiterleitung zur Original-URL
• Statistik-Dashboard

Technische Details:

• API-basierte Konfiguration (/api/display/config)
• Standalone Display-Seite (/_cabinet/)
• Auto-Reload alle 5 Minuten
• Subdomain-Support (Live: cabinet.b2in.eu)
• Test- und Live-Umgebung
• Einheitlicher Pfad für beide Umgebungen

---

8. Authentifizierungs-System

Status: ✅ Vollständig implementiert

Modernes Auth-System basierend auf Laravel Fortify & Sanctum:

Features:

• Login/Logout
• Registrierung
• E-Mail-Verifizierung
• Passwort-Reset
• Passwort-Bestätigung (für sensible Aktionen)
• Two-Factor-Authentication (2FA)
• API-Token-Authentifizierung (Sanctum)
• "Remember Me" Funktionalität

Views:

• Login-Seite (Standard & Vereinfacht)
• Registrierungs-Seite
• Passwort-vergessen
• Passwort-zurücksetzen
• E-Mail-Verifizierung

Einstellungen:

• Profil-Verwaltung
• Passwort-Änderung
• Erscheinungsbild (Theme-Einstellungen)
• Benutzer löschen/anonymisieren

---

9. Website-Frontend

Status: ✅ Grundstruktur und Inhalte implementiert

Moderne, responsive Website mit zahlreichen Sections:

Implementierte Seiten:

• Home - Hauptseite mit Hero-Slider
• About - Über uns
• Ecosystem - Ökosystem-Darstellung
• Partner - Partner-Informationen
• Portfolio - Produkt-Portfolio
• Magazin - Blog/Magazin mit Detail-Ansichten
• Contact - Kontaktformular
• Service - Service-Seite
• FAQ - Häufig gestellte Fragen
• Theme-Demo - Theme-Vorschau

Wiederverwendbare Sections:

• Hero (Standard, mit Bild, Slider, Tiles)
• About-Hero
• Benefits-Section
• Brand-Worlds
• Broker-Section
• Card-Section
• Commitment-Section
• Content-Section
• CTA-Section
• Dark-Stats-Section
• Digital-Core
• Ecosystem (Core, Hero, Stats)
• End-Customer-Section
• FAQ
• Final-Commitment
• Leadership-Team
• Magazin (List, Detail)
• Our-Story
• Our-Values
• Partner (Benefits, CTA, Hero, Process)
• Portfolio
• Spotlights-Section
• Supplier-Section
• Vision-Section

UI-Komponenten:

• Header mit Navigation
• Footer
• Top-Bar
• Kontaktformular
• Theme-Switcher (für Demos)

---

10. E-Mail-System

Status: 🔄 Grundarchitektur vorhanden

E-Mail-Templates:

• Partner-Einladung (PartnerInvitationMail)
• Weitere System-E-Mails über Laravel-Fortify

---

11. Media-Verwaltung

Status: 🔄 Grundarchitektur vorhanden

• Media-Tabelle für Datei-Uploads
• Unterstützung für verschiedene Medientypen
• Partner-Logos
• Marken-Logos
• Produkt-Bilder (vorbereitet)

---

12. Flux CMS Package (In Entwicklung)

Status: 🔄 Grundarchitektur vorhanden

Eigenes CMS-Package in packages/flux-cms/:

Geplante Features:

• Component-First-Architecture
• Code-as-Schema (Felder in PHP definiert)
• Multi-Domain-Support
• Vollständige Mehrsprachigkeit
• Content-Versionierung
• Media-Management
• Performance-Optimierung

Package-Struktur:

• core/ - Kern-Funktionalität, Models, Services
• components/ - Livewire Backend & Frontend Components
• starter-components/ - Vorgefertigte Starter-Components

---

🗄️ Datenbank-Struktur

Implementierte Tabellen:

Benutzer & Authentifizierung:

• users - Benutzer-Accounts
• roles - Rollen (Super Admin, Admin, Retailer, etc.)
• permissions - Berechtigungen
• role_has_permissions - Rollen-Berechtigungen-Zuordnung
• model_has_roles - User-Rollen-Zuordnung
• personal_access_tokens - API-Tokens (Sanctum)

Partner & Geschäftsbeziehungen:

• partners - Partner-Stammdaten
• partner_invitations - Einladungen mit Token & Status
• registration_codes - QR-Code-basierte Registrierung
• hubs - Regionale Hubs
• hub_locations - Hub-Standorte

Produkte & Katalog:

• products - Produkte
• product_variants - Produkt-Varianten
• product_variant_attributes - Varianten-Attribute
• product_logistics - Logistik-Informationen
• brands - Marken
• categories - Kategorien
• category_product - Produkt-Kategorie-Zuordnung
• collections - Kollektionen
• attributes - Attribute (Farbe, Größe, etc.)
• attribute_values - Attribut-Werte
• tags - Tags
• product_tag - Produkt-Tag-Zuordnung
• related_products - Verwandte Produkte
• tax_rates - Steuersätze
• shipping_classes - Versandklassen

Display/CMS:

• display_videos - Video-Playlist für Digital Signage
• display_footer_contents - Footer-Inhalte mit Short-Links & Tracking

System:

• media - Media-Verwaltung
• cache - Cache-Tabellen
• jobs - Queue-Jobs
• failed_jobs - Fehlgeschlagene Jobs

---

🎨 UI/UX Features

Design-System:

• Flux UI Pro - Professionelle Komponenten-Bibliothek
• Tailwind CSS - Utility-First CSS Framework
• Heroicons - Konsistente Icon-Bibliothek
• Dark Mode - Vollständige Dark-Mode-Unterstützung
• Responsive Design - Mobile-First-Ansatz

Theme-System:

• Domain-basiertes Theme-Switching
• Individuelle Farbschemata pro Domain
• Dynamische Asset-Verwaltung
• Theme-Demo-Seite für Vorschau

Komponenten:

• Flux Cards, Buttons, Inputs, Selects
• Data Tables mit Pagination
• Modals & Dialogs
• Toast-Notifications
• Form-Validierung
• Loading States

---

📝 Dokumentation

Umfangreiche Entwicklungs-Dokumentation:

• README.md - Projekt-Übersicht & Installation
• CLAUDE.md - AI-Kontext-Dokumentation
• dev/COMPONENT-STRUCTURE.md - Komponenten-Architektur
• dev/DOMAINS-CONFIG.md - Domain-Konfiguration
• dev/FORTIFY-SANCTUM-SETUP.md - Auth-Setup
• dev/HERO-ICONS-USAGE.md - Icon-Verwendung
• dev/LOCAL-DEVELOPMENT.md - Lokale Entwicklung
• dev/PARTNER-SETUP-WIZARD.md - Partner-Onboarding
• dev/DISPLAY_CMS_README.md - Display-CMS-Dokumentation
• dev/DISPLAY_SETUP_LIVE.md - Display Live-Setup
• dev/ENV_VARIABLES_DISPLAY.md - Display-Umgebungsvariablen
• dev/THEME-SWITCHING.md - Theme-System
• dev/THEME-DEMO-COMPONENTS.md - Theme-Demo

---

🔧 Entwicklungstools

Integrierte Tools:

• Laravel Sail - Docker-Entwicklungsumgebung
• Laravel Pail - Real-time Log-Viewer
• Laravel Debugbar - Debug-Informationen
• Laravel Pint - Code-Formatter
• Pest PHP - Testing Framework
• Laravel Dusk - Browser-Testing
• NPM Concurrently - Parallel-Prozess-Management

Development-Scripts:

composer dev  # Startet Server, Queue, Logs & Vite parallel

---

🚀 Deployment-Bereitschaft

Produktions-Features:

• ✅ Umgebungsspezifische Konfigurationen
• ✅ Asset-Kompilierung (Vite)
• ✅ Cache-System
• ✅ Queue-System
• ✅ Log-Management
• ✅ Error-Handling
• ✅ HTTPS-Ready

Optimierungen:

• Autoloader-Optimierung
• Route-Caching
• Config-Caching
• View-Caching

---

📊 Test-Abdeckung

Testing-Setup:

• Pest PHP Framework installiert
• TestCase-Struktur vorhanden
• Browser-Testing mit Laravel Dusk
• Feature & Unit Tests vorbereitet

Hinweis: Test-Implementierung kann bei Bedarf erweitert werden.

---

🔐 Sicherheit

Implementierte Sicherheitsfeatures:

• ✅ CSRF-Protection (Laravel Standard)
• ✅ SQL-Injection-Prevention (Eloquent ORM)
• ✅ XSS-Protection (Blade Escaping)
• ✅ Password-Hashing (Bcrypt)
• ✅ E-Mail-Verifizierung
• ✅ Two-Factor-Authentication
• ✅ Rate-Limiting (vorbereitet)
• ✅ Soft-Delete für DSGVO-Compliance
• ✅ Benutzer-Anonymisierung

---

📦 Abhängigkeiten & Packages

Haupt-Abhängigkeiten:

• laravel/framework ^12.0
• laravel/fortify ^1.27
• laravel/sanctum ^4.1
• livewire/flux ^2.1.1
• livewire/flux-pro ^2.6
• livewire/volt ^1.7.0
• spatie/laravel-permission ^6.17
• blade-ui-kit/blade-heroicons ^2.6

Dev-Abhängigkeiten:

• laravel/sail ^1.41
• laravel/dusk ^8.2
• pestphp/pest ^3.8
• barryvdh/laravel-debugbar ^3.16
• reliese/laravel ^1.4 (Model-Generator)

---

📈 Nächste Schritte & Empfehlungen

Kurzfristig (bereit für Implementierung):

1. Bestellsystem - Order-Management für Kunden
2. Produktbilder - Media-Upload für Produkte
3. E-Mail-Templates - Erweiterte E-Mail-Kommunikation
4. Benachrichtigungen - In-App-Notifications

Mittelfristig:

1. Provisionsabrechnung - Automatisierte Provisionsberechnung
2. Reporting & Analytics - Dashboard-Erweiterungen
3. API-Erweiterung - REST-API für Externe
4. Suchfunktion - Globale Suche über alle Inhalte

Langfristig:

1. Mobile-App - Native Apps (via Sanctum-API)
2. Mehrsprachigkeit - Internationalisierung
3. Erweiterte CMS-Features - Flux-CMS-Package fertigstellen
4. Payment-Integration - Zahlungsabwicklung

---

🎯 Projektstatus Zusammenfassung

✅ Vollständig implementiert:

• Multi-Domain-System mit Theme-Switching
• Komplettes Benutzer- & Rollen-Management
• Partner-Management mit Onboarding
• Hub-Verwaltung
• Produkt-Management (Grundfunktionen)
• Rollenbasierte Dashboards
• Digital Signage CMS mit Tracking
• Authentifizierung & Sicherheit
• Website-Frontend (Grundstruktur)
• Dokumentation

🔄 In Arbeit:

• Flux-CMS-Package (Architektur steht)
• Erweiterte Produkt-Features
• Test-Abdeckung

📋 Bereit für Umsetzung:

• Bestellsystem
• Provisionsabrechnung
• Erweiterte Reporting-Funktionen
• Payment-Integration

---

💡 Besonderheiten & Highlights

Technische Exzellenz:

• Modern Stack - Neueste Laravel/Livewire-Versionen
• Component-Architecture - Wiederverwendbare Livewire-Komponenten
• Type-Safety - PHP 8.2+ Features
• Performance - Optimierte Queries, Caching
• Skalierbarkeit - Modularer Aufbau für Wachstum

Business-Features:

• Multi-Tenant-Ready - Verschiedene Partner-Typen
• Hierarchische Strukturen - Broker-Kunden-Beziehungen
• Flexibles Provisionsmodell - Prozentsatz oder Festbetrag
• Umfangreiches Tracking - Display-Klicks, User-Aktivitäten
• White-Label-Fähigkeit - Domain-spezifisches Branding

User-Experience:

• Intuitives Onboarding - Setup-Wizard für neue Partner
• Rollenbasierte Ansichten - Jede Rolle sieht nur relevante Inhalte
• Real-time Updates - Livewire für nahtlose Interaktion
• Responsive Design - Funktioniert auf allen Geräten
• Dark Mode - Moderne UI-Präferenzen

---

📞 Support & Wartung

Das System ist produktionsbereit und kann bei Bedarf mit folgenden Services erweitert werden:

• Code-Reviews & Optimierungen
• Feature-Erweiterungen
• Bug-Fixes & Updates
• Performance-Tuning
• Sicherheits-Audits
• Schulungen für Administratoren

---

Entwicklungsstand: Dezember 2025
Version: 1.0 (Production-Ready)
Framework: Laravel 12
PHP: 8.2+
Lizenz: MIT

---

Diese Dokumentation wurde automatisch generiert und gibt den aktuellen Stand der Entwicklung wieder.