mivita/dev/subdomain-optimization-gpt-5/INTEGRATION.md

Integration & Reihenfolge

Wichtig: Bestehende Dateien werden hier NICHT verändert. Die folgenden Schritte beschreiben die geplante Integration.

Reihenfolge der Middleware (web-Gruppe)

Empfohlene Reihenfolge in App\Http\Kernel (schematisch):

1. App\Dev\SubdomainOptimizationGpt5\Http\Middleware\DomainBootstrap (NEU, sehr früh)
2. \App\Http\Middleware\EncryptCookies
3. \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse
4. \Illuminate\Session\Middleware\StartSession
5. App\Dev\SubdomainOptimizationGpt5\Http\Middleware\DomainSessionSync (NEU, nach StartSession)
6. \Illuminate\View\Middleware\ShareErrorsFromSession
7. \App\Http\Middleware\VerifyCsrfToken
8. ... weitere App-Middleware

Damit wird garantiert:

• Vor StartSession: Kein Sessionzugriff (DomainBootstrap ist „rein“)
• Nach StartSession: Synchronisierung von user_shop in Session + Cookie (DomainSessionSync)

Container-Bindings

• DomainBootstrap erzeugt den DomainContext selbst (ohne Session) und registriert ihn per app()->instance(DomainContext::class, $ctx) sowie zusätzlich als Request-Attribut domain.context.
• Alte DomainServiceProvider-Binding-Strategie kann damit schrittweise entfernt oder angepasst werden (muss nicht sofort).

Sticky-Shop-Verhalten

• Cookie mvt_shop (konfigurierbar) trägt den user_shop-Slug über Subdomains
• Session hält kompakten Zustand: ctx.user_shop (id, slug, host)
• Optional: Legacy-Keys (user_shop, user_shop_domain) zur Abwärtskompatibilität aktivierbar

Migrationspfad (schrittweise)

1. NEUE Middleware registrieren (Kernel), alte Logik belassen
2. DomainResolver in produktivem Code um Session-Zugriffe entlasten (später)
3. Schrittweise Nutzung von UserShopSessionManager in Controllern/Views (statt direkter Session-Manipulation)
4. Nach Stabilisierung: Legacy-Keys deaktivieren (Konfiguration), Altpfade entfernen

Konfiguration

Siehe config/example.subdomain_optimization.php. Wichtig sind Domain-/Cookie-Parameter sowie die Option für Legacy-Keys.

Testplan (Auszug)

• Wechsel {slug}.mivita.care → in.mivita.care → Zurück-zum-Shop (Slug bleibt erhalten)
• Wechsel {slug}.mivita.care → checkout.mivita.care (Slug bleibt erhalten)
• Zugriff mivita.shop (Main Shop) setzt Fallback-Shop
• Ungültige Subdomain erzeugt KEINE Session (nur Redirect/Fehler, je nach bestehender App-Logik)