10-04-2026

This commit is contained in:
Kevin Adametz 2026-04-10 17:18:17 +02:00
parent 4d6b4930b2
commit 4bb89aad8c
836 changed files with 52961 additions and 5950 deletions

View file

@ -2,7 +2,7 @@
## 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.
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
@ -16,13 +16,15 @@ In der Zukunft benötigen wir einen response bounce etc.
## 🎯 Kern-Technologien
- **Framework**: Laravel 12 mit PHP 8.2+
- **Framework**: Laravel 12 mit PHP 8.4+
- **Frontend**: Livewire 3 mit Volt (Single-File Components)
- **UI-Framework**: Flux UI (Pro-Version) mit Tailwind CSS
- **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**: Laravel Sail (Docker)
- **Entwicklungsumgebung**: Dev Container (Docker) Befehle direkt ohne Sail-Prefix
- **MCP-Integration**: Laravel Boost MCP-Server für Entwicklungsunterstützung
---
@ -229,9 +231,9 @@ Rollenbasiertes Dashboard mit individuellen KPIs:
---
### 7. Digital Signage / Display-CMS
### 7. Digital Signage / Display-CMS (Legacy)
**Status**: ✅ Vollständig implementiert
**Status**: ✅ Vollständig implementiert (Legacy-System → siehe auch Abschnitt 14 für Neuarchitektur)
Professionelles CMS-System für Digital Signage im Cabinet Showroom Bielefeld:
@ -309,16 +311,24 @@ Modernes Auth-System basierend auf Laravel Fortify & Sanctum:
Moderne, responsive Website mit zahlreichen Sections:
#### Implementierte Seiten:
- **Home** - Hauptseite mit Hero-Slider
- **About** - Über uns
- **Ecosystem** - Ökosystem-Darstellung
- **Partner** - Partner-Informationen
- **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
- **Contact** - Kontaktformular
- **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
- **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)
@ -345,6 +355,9 @@ Moderne, responsive Website mit zahlreichen Sections:
- 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
@ -352,6 +365,8 @@ Moderne, responsive Website mit zahlreichen Sections:
- Top-Bar
- Kontaktformular
- Theme-Switcher (für Demos)
- **AnnouncementBar** *(NEU)* - Ankündigungsleiste
- **web-picture** *(NEU)* - Blade-Komponente für responsive Bilder
---
@ -397,6 +412,193 @@ Eigenes CMS-Package in `packages/flux-cms/`:
- `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 (MontagSonntag)
- 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
@ -435,9 +637,32 @@ Eigenes CMS-Package in `packages/flux-cms/`:
- `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
#### 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
@ -489,6 +714,11 @@ Umfangreiche Entwicklungs-Dokumentation:
- `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
---
@ -536,8 +766,42 @@ composer dev # Startet Server, Queue, Logs & Vite parallel
- 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
**Hinweis**: Test-Implementierung kann bei Bedarf erweitert werden.
### 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`
---
@ -566,7 +830,9 @@ composer dev # Startet Server, Queue, Logs & Vite parallel
- `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
@ -612,11 +878,21 @@ composer dev # Startet Server, Queue, Logs & Vite parallel
- 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)
- Erweiterte Produkt-Features
- Test-Abdeckung
- 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
@ -629,11 +905,13 @@ composer dev # Startet Server, Queue, Logs & Vite parallel
## 💡 Besonderheiten & Highlights
### Technische Exzellenz:
- **Modern Stack** - Neueste Laravel/Livewire-Versionen
- **Modern Stack** - Neueste Laravel 12 / Livewire 3 / PHP 8.4+ / Tailwind CSS v4
- **Component-Architecture** - Wiederverwendbare Livewire-Komponenten
- **Type-Safety** - PHP 8.2+ Features
- **Performance** - Optimierte Queries, Caching
- **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
@ -641,6 +919,9 @@ composer dev # Startet Server, Queue, Logs & Vite parallel
- **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
@ -648,6 +929,8 @@ composer dev # Startet Server, Queue, Logs & Vite parallel
- **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
---
@ -664,13 +947,14 @@ Das System ist produktionsbereit und kann bei Bedarf mit folgenden Services erwe
---
**Entwicklungsstand**: Dezember 2025
**Version**: 1.0 (Production-Ready)
**Framework**: Laravel 12
**PHP**: 8.2+
**Entwicklungsstand**: März 2026
**Version**: 2.0
**Framework**: Laravel 12
**PHP**: 8.4+
**Lizenz**: MIT
---
*Diese Dokumentation wurde automatisch generiert und gibt den aktuellen Stand der Entwicklung wieder.*
*Diese Dokumentation wird fortlaufend aktualisiert und gibt den aktuellen Stand der Entwicklung wieder.*
*Letzte Aktualisierung: März 2026*