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, Digital Signage und Immobilien-Investment dient. Die Anwendung basiert auf Laravel 12, Livewire 3 und Flux UI und bietet ein modernes, rollenbasiertes System für verschiedene Geschäftspartner. Seit Q1 2026 wurde die Plattform strategisch um den Bereich Dubai Real Estate Investment als primären Geschäftszweig erweitert – B2in positioniert sich nun als "International Real Estate + Design Ecosystem".

🎯 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.4+
• Frontend: Livewire 3 mit Volt (Single-File Components)
• UI-Framework: Flux UI (Pro-Version v2) mit Tailwind CSS v4
• Authentifizierung: Laravel Fortify mit Sanctum
• Berechtigungen: Spatie Laravel-Permission
• Mehrsprachigkeit: Spatie Laravel-Translatable (für CMS-Inhalte)
• Icons: Heroicons (Blade-Integration)
• Entwicklungsumgebung: Dev Container (Docker) – Befehle direkt ohne Sail-Prefix
• MCP-Integration: Laravel Boost MCP-Server für Entwicklungsunterstützung

---

✅ 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 (Legacy)

Status: ✅ Vollständig implementiert (Legacy-System → siehe auch Abschnitt 14 für Neuarchitektur)

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 (Q1 2026: Repositionierung "Connecting Design and Property")
• About - Über uns (Q1 2026: Neue Timeline "Die Erweiterung 2025/2026")
• Ecosystem - Ökosystem-Darstellung (Q1 2026: Drei-Säulen-Modell)
• Partner - Partner-Informationen (Q1 2026: "Für Immobilienentwickler"-Bereich)
• Portfolio - Produkt-Portfolio
• Magazin - Blog/Magazin mit Detail-Ansichten (Q1 2026: 5 vollständige Artikel de/en)
• Contact - Kontaktformular (Q1 2026: Neue Betreff-Optionen Immobilien/Supply-Chain)
• Service - Service-Seite
• FAQ - Häufig gestellte Fragen (Q1 2026: Immobilien & Supply-Chain Fokus)
• Theme-Demo - Theme-Vorschau
• Immobilien (NEU) - Dubai Immobilien-Übersicht
• Immobilien Detail (NEU) - Projekt-Einzelansicht mit Investment-Case
• Interior (NEU) - Interior Design / Einrichtungs-Showcase
• Netzwerk (NEU) - Partner-Netzwerk mit Cabinet-Integration
• Impressum (NEU) - Rechtliches Impressum
• Datenschutz (NEU) - Datenschutzerklärung
• AGB (NEU) - Allgemeine Geschäftsbedingungen
• Cookie-Policy (NEU) - Cookie-Richtlinie

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
• FounderBar (NEU) - Gründer/CEO-Vorstellung mit Statement
• ImageBreak (NEU) - Wiederverwendbare Bildtrennung (konfigurierbar per Section-Name)
• ImmobilienContactForm (NEU) - Spezialisiertes Kontaktformular für Immobilien

UI-Komponenten:

• Header mit Navigation
• Footer
• Top-Bar
• Kontaktformular
• Theme-Switcher (für Demos)
• AnnouncementBar (NEU) - Ankündigungsleiste
• web-picture (NEU) - Blade-Komponente für responsive Bilder

---

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

Neue CMS-Models (seit Q1 2026):

• CmsContent - Gruppen/Key-basierter Content mit übersetzbaren Werten
• CmsDownload - Mediendatei-Verwaltung
• CmsFaq - FAQ mit übersetzbaren Frage-Antwort-Paaren
• CmsIndustry - Branchen-Taxonomie
• CmsLinkedinPost - Social-Media-Integration
• CmsMedia - Media-Library mit Konvertierungs-Tracking
• CmsNewsItem - News/Artikel
• CmsSearchIndex - Volltextsuche-Index

Neue Services:

• CmsContentService - Content-Abruf und -Verwaltung
• HeroiconOutlineList - Icon-Referenz-Service
• MediaConversionService - Bild/Video-Konvertierungs-Pipeline

---

13. Immobilien-Plattform (Dubai Real Estate)

Status: ✅ Soft-Launch implementiert (seit März 2026)

Vollständige Dubai-Immobilien-Investitionsplattform als neuer Hauptgeschäftszweig:

Seiten:

• Immobilien-Übersicht (/immobilien) - Listing mit Hero, Fakten, Kaufprozess, Trust-Blocks, Mindset-Check
• Projekt-Detail (/immobilien/{slug}) - Einzelansicht mit Galerie, Investment-Case, Trust/Möbel-Vorteile

Datenmodelle:

• CmsProject - Immobilienprojekte mit mehrsprachigen Feldern (Spatie Translatable)
  • Slug, Titel, Standort, Beschreibung, Features (JSON)
  • Preis in AED mit automatischer EUR/USD-Umrechnung
  • Investor-Trust-Block (Escrow, DLD-Kontrolle, Transparenz)
  • Möbel-Vorteil-Block (exklusives B2in-Einrichtungsnetzwerk)
• CmsArticle - Magazin-Artikel mit Mehrsprachigkeit (de/en)
  • Kategorie, Autor, Lesezeit, Veröffentlichungsstatus
  • Content als JSON-Struktur (Sections mit Intro, Text, Listen, Zitaten)

Magazin-Artikel (5 vollständige Artikel):

1. Escrow-System Dubai – Wie Käufer geschützt werden
2. Spotlight: Al Jaddaf – Dubais aufstrebender Kreativdistrikt
3. Turnkey-Investments – Schlüsselfertig vom Plan bis zur Einrichtung
4. Supply-Chain-Management – Deutsche Qualität für internationale Projekte
5. Local-for-Local – Wie B2in lokale Händler mit internationalen Investoren verbindet

PriceHelper:

• Statische Preisformatierung AED → EUR/USD
• Feste Wechselkurse: AED/USD 3.6725, USD/EUR 1.08
• Format: "ab 1.125.000 AED (ca. 284.000 EUR / 306.000 USD)"

Seeders:

• CmsProjectSeeder - Immobilienprojekte aus Lang-Dateien
• CmsArticleSeeder - Magazin-Artikel aus Lang-Dateien (de/en)

---

14. Display-Versions-System (Neuarchitektur)

Status: ✅ Vollständig implementiert (Februar 2026)

Komplett überarbeitetes Display-Management mit Versions-basiertem Content:

Drei-Tabellen-Architektur:

• Display - Physische Display-Geräte (Name, Standort, Aktiv-Status)
• DisplayVersion - Content-Versionen mit Typ-basiertem System
• DisplayVersionItem - Einzelne Content-Items (Video, Footer, Media, Slides) mit JSON-Content

DisplayVersionType Enum:

• video-display - Video-Playlists
• b2in - B2in-Marken-Content
• offers - Angebots-Slides

API-Endpunkte:

• GET /api/display/config - Vollständige Playlist-Konfiguration als JSON
• GET /api/display/check - Lightweight Update-Check (Timestamp + Status)

Legacy-Migration:

• MigrateLegacyDisplays-Kommando konvertiert alte DisplayVideo/DisplayFooterContent-Daten in neues System

---

15. Cabinet Tablet-Management

Status: ✅ Vollständig implementiert (Februar/März 2026)

Verwaltungssystem für Tablet-Displays im Cabinet Showroom Bielefeld:

CabinetTabletSetting (Singleton-Pattern):

• Store-Status-Modi: open, notice, closed, warning
• Tägliche Override-Zeiten (override_open_today, override_close_today) mit Mitternacht-Auto-Reset
• 7-Tage-Öffnungszeiten mit deutschen Labels (Montag–Sonntag)
• Nächster Termin (Datum + Uhrzeit)
• Kontaktdaten (Telefon, E-Mail)
• Status-Berechnung basierend auf Berliner Zeitzone

API-Endpunkte:

• GET /api/cabinet-tablet/status - Vollständige Settings (Öffnungszeiten, Kontakt, Termine, Hinweise)
• GET /api/cabinet-tablet/check - Schnell-Poll für Status-Änderungen

Admin-Oberfläche:

• CabinetInfoTablet - Livewire-Komponente für Öffnungszeiten und Kontaktdaten
• QuickStatus - Livewire-Komponente für schnelle Status-Änderungen (Auto/Geschlossen/Hinweis/Warnung)
• Key-basierte Autorisierung über Query-Parameter

---

16. Homepage & Brand-Repositionierung

Status: ✅ Umgesetzt (Februar/März 2026)

Komplette Neuausrichtung der B2in-Marke:

Strategische Änderungen:

• Neuer Hero: "B2in – Connecting Design and Property" mit dualem Positioning (Immobilien + Einrichtung)
• Founder Bar: Marcel Scheibe als CEO/Founder mit persönlichem Statement auf allen relevanten Seiten
• Ecosystem-Drei-Säulen-Modell:
  1. Internationale Immobilien
  2. Exklusive Einrichtung
  3. Supply-Chain-Management
• Partner-Section: Neuer "Für Immobilienentwickler"-Bereich (Supply-Chain-Fokus)
• FAQ-Update: 5 Fragen mit Immobilien- und Supply-Chain-Fokus
• Brand Worlds Neuordnung: Stileigentum → Style2Own → B2A

Aktualisierte Seiten:

• Home, About (neue Timeline: "Die Erweiterung 2025/2026"), Ecosystem, Partner
• Contact (neue Betreff-Optionen für Immobilien/Supply-Chain)
• Magazin (mit Immobilien-Artikeln)

---

17. Neue Webseiten & Rechtliches

Status: ✅ Implementiert (März 2026)

Neue Seiten:

• /immobilien - Dubai Immobilien-Plattform
• /immobilien/{slug} - Projekt-Detailseite
• /interior - Interior Design / Einrichtungs-Showcase
• /netzwerk - Partner-Netzwerk (mit Cabinet-Integration)
• /impressum - Impressum
• /privacy - Datenschutzerklärung
• /terms - AGB
• /cookie-policy - Cookie-Richtlinie

Neue Livewire-Sections:

• FounderBar - Gründer/CEO-Vorstellung (Marcel Scheibe)
• ImageBreak - Wiederverwendbare Bildtrennungs-Komponente
• ImmobilienContactForm - Spezialisiertes Kontaktformular für Immobilien-Anfragen

---

18. Mehrsprachigkeit & Lokalisierung

Status: ✅ Implementiert (März 2026)

SetLocale-Middleware:

• Neue Middleware in bootstrap/app.php registriert
• Erkennung über session('locale'), setzt App-Locale (de/en)
• Integriert in Web-Middleware-Gruppe

Sprachdateien:

• resources/lang/de/b2in.php - Deutsche Übersetzungen (Immobilien, Magazin, UI)
• resources/lang/en/b2in.php - Englische Übersetzungen
• resources/lang/de/b2in_legal.php / en/b2in_legal.php - Rechtliche Texte
• resources/lang/de/ui.php / en/ui.php - UI-Elemente

---

19. Artisan-Kommandos

Status: ✅ Implementiert

Neue Kommandos:

• ConvertImagesToWebP - Batch-Konvertierung JPG/PNG → WebP
  • Optionen: --path, --quality (Standard 85%), --force, --dry-run
  • Zeigt Kompressions-Statistiken (Dateigrößen-Reduktion %)
• MigrateLegacyDisplays - Einmalige Migration von altem DisplayVideo/DisplayFooterContent ins neue System
• ResetCabinetTabletOverrides - Geplante Aufgabe zum Zurücksetzen täglicher Zeitüberschreibungen um Mitternacht

---

20. Produkt-Kuration

Status: 🔄 Erweitert (Februar 2026)

• Neue Berechtigung curate_products hinzugefügt (Migration 2026_02_27_154145)
• Ermöglicht spezifische Produktkurations-Rechte unabhängig von allgemeinem Produkt-Management

---

🗄️ 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 (Legacy):

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

Display-Versions-System (Neu, Feb 2026):

• display_versions - Content-Versionen (Name, Typ, Settings JSON, Aktiv-Status)
• display_version_items - Content-Items (FK, Item-Typ, Content JSON, Sortierung)
• displays - Physische Display-Geräte (Name, Standort, Aktiv-Status)
• display_display_version - Pivot-Tabelle (Many-to-Many mit Sortierung)

Cabinet Tablet (Neu, Feb/März 2026):

• cabinet_tablet_settings - Showroom-Status, Öffnungszeiten (7 Tage), Kontaktdaten, Overrides

CMS-Inhalte (Neu, März 2026):

• cms_projects - Immobilienprojekte (JSON-Felder für Mehrsprachigkeit, Preis in AED)
• cms_articles - Magazin-Artikel (JSON für Titel/Untertitel/Content, Kategorie, Autor)

Flux CMS Package (Neu, 2026):

• flux_cms_contents - Gruppen/Key-basierter Content
• flux_cms_downloads - Downloads
• flux_cms_linkedin_posts - LinkedIn-Posts
• flux_cms_faqs - FAQ-Einträge
• flux_cms_news_items - News
• flux_cms_industries - Branchen
• flux_cms_media - Media-Library
• flux_cms_search_index - Volltextsuche

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
• dev/27-02-2026/ - Entwicklungsdokumentation Relaunch Februar 2026
• dev/12-03-2026/ - Entwicklungsdokumentation Immobilien-Launch März 2026
• packages/flux-cms/ARCHITECTURE.md - CMS-Package Architektur
• packages/flux-cms/MIGRATION.md - CMS-Migrations-Leitfaden
• packages/flux-cms/SETUP.md - CMS-Setup-Anleitung

---

🔧 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
• SQLite in-memory für Tests (MySQL wird nicht berührt)
• Automatischer Config-Cache-Reset vor jedem Test-Run

Neue Tests (seit Q1 2026):

Display & Tablet Tests:

• DisplayVersionTest - Model-Beziehungen, activeItems()
• DisplayVersionApiTest - API-Config/Check-Endpunkte
• DisplayListTest - Display CRUD-Operationen
• CabinetInfoTabletTest - Info-Tablet-Display-Integration
• CabinetTabletApiTest - API-Endpunkte (Status/Check)
• CabinetQuickStatusTest - Livewire-Komponenten-Interaktion
• ResetCabinetTabletOverridesTest - Mitternacht-Reset-Logik

Immobilien/CMS Tests:

• ImmobilienShowTest - Projekt-Detailseite-Rendering
• CmsLegalSeederTest - Rechtliche Inhalte (Privacy/Terms/Impressum)
• MagazinPageTest - Magazin-Seiten
• ContactFormTest - Kontaktformular

Weitere Tests:

• AboutPageTest - About-Seite
• AnnouncementBarTest - Announcement-Bar
• InteriorPageTest - Interior-Seite
• SoftLaunchDevPagesTest - Dev-Seiten im Soft-Launch
• PartnerSelfServiceProfileTest - Partner Self-Service
• CmsFluxEditorHtmlTransformerTest (Unit) - HTML-Transformation
• CabinetTabletSettingTest (Unit) - Status-Berechnung, Öffnungszeiten

Factories:

• CabinetTabletSettingFactory
• CmsArticleFactory (mehrsprachig)
• CmsProjectFactory (mehrsprachig)
• DisplayFactory
• DisplayVersionFactory (mit Typ)
• DisplayVersionItemFactory

---

🔐 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
• spatie/laravel-translatable (NEU - für CMS-Inhalte)
• blade-ui-kit/blade-heroicons ^2.6
• laravel/mcp ^0.x (NEU - MCP-Server-Integration)

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
• NEU: Immobilien-Plattform (Dubai Real Estate) mit Soft-Launch
• NEU: Display-Versions-System (Neuarchitektur)
• NEU: Cabinet Tablet-Management
• NEU: Homepage & Brand-Repositionierung
• NEU: Mehrsprachigkeit (de/en) mit SetLocale-Middleware
• NEU: Rechtliche Seiten (Impressum, Datenschutz, AGB, Cookie-Policy)
• NEU: Magazin mit 5 vollständigen Artikeln (de/en)
• NEU: Interior- und Netzwerk-Seiten
• NEU: WebP-Konvertierungs-Tool
• NEU: Umfangreiche Test-Suite mit Factories

🔄 In Arbeit:

• Flux-CMS-Package (Architektur steht, neue Models und Services hinzugefügt)
• Erweiterte Produkt-Features + Produkt-Kuration
• Weitere Immobilienprojekte (aktuell: Azizi Creek Views 4)

📋 Bereit für Umsetzung:

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

---

💡 Besonderheiten & Highlights

Technische Exzellenz:

• Modern Stack - Neueste Laravel 12 / Livewire 3 / PHP 8.4+ / Tailwind CSS v4
• Component-Architecture - Wiederverwendbare Livewire-Komponenten
• Type-Safety - PHP 8.4+ Features inkl. Enums
• Performance - Optimierte Queries, Caching, WebP-Bildkonvertierung
• Skalierbarkeit - Modularer Aufbau für Wachstum
• API-First Display-System - JSON-basierte Konfiguration für Signage-Geräte
• Mehrsprachigkeit - DE/EN mit Spatie Translatable und Laravel-Lang-Dateien

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
• Immobilien-Investment - Vollständige Dubai Real Estate-Plattform mit Preisumrechnung
• Content-Management - Magazin-Artikel, Projekte, rechtliche Inhalte
• Showroom-Management - Cabinet Tablet mit Öffnungszeiten und Live-Status

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
• Founder-Vertrauen - CEO-Positioning auf relevanten Seiten
• Trust-Building - Escrow, DLD-Kontrolle, Investoren-Transparenz

---

📞 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: März 2026 Version: 2.0 Framework: Laravel 12 PHP: 8.4+ Lizenz: MIT

---

Diese Dokumentation wird fortlaufend aktualisiert und gibt den aktuellen Stand der Entwicklung wieder. Letzte Aktualisierung: März 2026