From ab1dffc72fda8114aca9400e9ef65f9f26160f7b Mon Sep 17 00:00:00 2001 From: Lars Date: Fri, 23 Oct 2026 12:26:29 +0200 Subject: [PATCH] Record the tenancy handoff so the next session can start at phase 3. STATUS section 7 names the deployed release, the pieces that are built, and what must stay untouched. Co-authored-by: Cursor --- docs/MANDANTEN-PLAN.md | 10 +++---- docs/STATUS.md | 62 ++++++++++++++++++++++++++++++++++++++++-- 2 files changed, 64 insertions(+), 8 deletions(-) diff --git a/docs/MANDANTEN-PLAN.md b/docs/MANDANTEN-PLAN.md index abeeb4d..989e864 100644 --- a/docs/MANDANTEN-PLAN.md +++ b/docs/MANDANTEN-PLAN.md @@ -1,10 +1,10 @@ # Mandantenfähigkeit – Umbauplan -Stand: 23.10.2026 · freigegeben, Phase 1 und 2 im Code auf `feature/mandanten`, Datenbank noch nicht migriert · Anforderungen: [MANDANTEN-ANFORDERUNGEN.md](MANDANTEN-ANFORDERUNGEN.md) · Design: [DESIGN-KONZEPT.md](DESIGN-KONZEPT.md) §7 +Stand: 23.10.2026, nachmittag · Phase 1, 2 und der Website-Teil von Phase 4 sind auf `main` und auf stommer.info (Release `20261023100346`) · Anforderungen: [MANDANTEN-ANFORDERUNGEN.md](MANDANTEN-ANFORDERUNGEN.md) · Design: [DESIGN-KONZEPT.md](DESIGN-KONZEPT.md) §7 · Übergabe: [STATUS.md](STATUS.md) Abschnitt 7 Kein Portal, kein Marktplatz. Das Produkt bleibt die eigene Website eines Vermieters mit Vermietung. Wenige Mandanten, eine gemeinsame Datenbank, Laravel und Filament bleiben die Basis. Ein Python-Dienst ist nicht Teil dieses Umbaus. -Die Umsetzung läuft auf dem Branch `feature/mandanten`. Phasen 1–5 sind der Grundumbau. Marke/Bildwelt (Phase 6) und mehrere Wohnungen je Website (Phase 7) folgen in der festgelegten Reihenfolge und starten erst, wenn die Theme-Sitzung die Vertragsänderung aus [ZUSAMMENARBEIT.md](ZUSAMMENARBEIT.md) §6 übernehmen kann. `resources/themes/**` bleibt bis dahin unangetastet. +Weiterarbeiten auf einem neuen Branch ab `main`. `feature/mandanten` ist zusammengeführt. Phasen 1–5 sind der Grundumbau. Marke/Bildwelt (Phase 6) und mehrere Wohnungen je Website (Phase 7) folgen in der festgelegten Reihenfolge und starten erst, wenn die Theme-Sitzung die Vertragsänderung aus [ZUSAMMENARBEIT.md](ZUSAMMENARBEIT.md) §6 übernehmen kann. `resources/themes/**` bleibt bis dahin unangetastet. --- @@ -177,7 +177,7 @@ ## 6. Rollen, Admin, Betreiber | Inhalte | bisher `content` | Bilder, Texte, FAQ, Hinweise, Bewertungen | | Betreiber | `users.is_operator`, **keine** Mitgliedsrolle | Mandanten anlegen und sperren, ersten Mandanten-Administrator anlegen, Dienste, Domains, Systemzustand, Wechsel in einen Mandanten | -Der Admin nutzt Filaments Mandantenfunktion mit `tenantDomain('{tenant}')` und `resolveTenantUsing`: der Host ist der Schlüssel, die Website mit diesem Host liefert den Mandanten. `User` erfüllt `HasTenants`. `canAccessTenant` ist wahr bei einer Mitgliedschaft oder beim Betreiber. +Filaments `Panel::tenant()` / `tenantDomain()` ist **nicht** eingeschaltet. Der Pfad bleibt `/admin`, ohne zusätzliche Stufe. Der Mandant kommt aus `App\Tenancy\TenantContext` (Singleton), gesetzt von `ResolveTheme`. Ein eingeschaltetes `tenantDomain` würde `BookingResource::getUrl()` und die bestehenden Admin-Tests ändern. Details und die übrigen Bausteine: STATUS.md Abschnitt 7. Der Betreiber-Bereich ist ein zweites Panel ohne Mandantenfilter, Pfad `/betreiber`, nur für `is_operator`. Dort entstehen Mandanten und der erste Administrator. „In den Mandanten wechseln“ öffnet `https:///admin` und schreibt einen Eintrag (Benutzer, Mandant, Zeitpunkt). Im Mandanten-Admin gilt derselbe Filter wie für jeden anderen; der Betreiber sieht dort nur diesen Mandanten. Hat er dort keine Mitgliedschaft, gelten für den Support die Rechte des Mandanten-Administrators, und der Zugriff bleibt protokolliert. @@ -205,7 +205,7 @@ ## 7. Domain, Cron, Mails ## 8. Phasen -Jede Phase liegt auf `feature/mandanten`, hat grüne Tests (`php artisan test --compact` auf die betroffenen Dateien, am Ende der Phase die ganze Suite) und ist für sich nach `main` zusammenführbar. Ausgeliefert wird nur aus `main`. `resources/themes/**` wird nicht geändert. Nach dem Zusammenführen schreibt die Sitzung `docs/STATUS.md`. Eine Änderung am Vorlagen-Vertrag gibt es in Phase 1–5 nicht; §6 von ZUSAMMENARBEIT bleibt deshalb in diesen Phasen leer. +Abgeschlossene Phasen liegen auf `main`. Die nächste Phase bekommt einen eigenen Branch ab `main`, grüne Tests (`php artisan test --compact --testsuite=Feature` auf die betroffenen Dateien, am Ende der Phase die Feature-Suite) und ist für sich nach `main` zusammenführbar. `php artisan test` ohne `--testsuite=Feature` bricht ab, weil `tests/Unit` nicht existiert. Ausgeliefert wird nur aus `main`. `resources/themes/**` wird nicht geändert. Nach dem Zusammenführen schreibt die Sitzung `docs/STATUS.md`. Eine Änderung am Vorlagen-Vertrag gibt es in Phase 1–5 nicht; §6 von ZUSAMMENARBEIT bleibt deshalb in diesen Phasen leer. ### Phase 1 – Mandant und Daten @@ -288,6 +288,6 @@ ## 9. Betrieb und Abgrenzung ## 10. Freigabe -Phase 1 und 2 sowie der Website-Teil von Phase 4 sind auf stommer.info (Release `20261023100346`). Die bisherigen Daten gehören zum Mandanten Stommer, `lars@stommer.com` ist Betreiber. Phase 3 bis 5 folgen und bringen weitere Migrationen. Phase 6 und 7 warten auf eine eigene Freigabe. +Phase 1 und 2 sowie der Website-Teil von Phase 4 sind auf stommer.info (Release `20261023100346`). Die bisherigen Daten gehören zum Mandanten Stommer, `lars@stommer.com` ist Betreiber. Die nächste Codesitzung ist Phase 3; Übergabe mit den gebauten Bausteinen: [STATUS.md](STATUS.md) Abschnitt 7. Phase 3 bis 5 bringen weitere Migrationen. Phase 6 und 7 warten auf eine eigene Freigabe. Die Sicherheitsregel in §1 gilt: Passwort und 2FA gehören zum Konto, die Rolle zur Mitgliedschaft. Der Betreiber darf zusätzlich Mandanten-Administrator der eigenen Wohnung sein. diff --git a/docs/STATUS.md b/docs/STATUS.md index 78c5da6..39b9eb7 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -52,7 +52,7 @@ ## 2. Stand auf stommer.info (Testbetrieb) | | | |---|---| -| Konten | `lars@stommer.com` (Administrator); Konto für Brigitte noch anzulegen (Administrator, **einfache Ansicht**) | +| Konten | `lars@stommer.com` ist Betreiber und Mandanten-Administrator von Stommer (Passwort und 2FA unverändert). Anmeldung im Browser nach dem Umzug hier nicht geprüft, nur die Weiterleitung auf die Login-Seite. Konto für Brigitte noch anzulegen (Mandanten-Administrator, **einfache Ansicht**) | | Daten | Wohnung, Preise 2026, 39 Fotos, Seiten, 5 Erscheinungsbilder; **Testbuchung 2026-0002** („E2E Testgast“, angenommenes Angebot) – darf gelöscht werden | | E-Mail | Betriebsart **Testbetrieb** (System › Betrieb), Testadresse `lars@stommer.com` – alle Mails gingen nur dorthin. Versandweg aber noch `log` (nichts wird zugestellt): `MAIL_MAILER=smtp` + `MAIL_PASSWORD` (Postfach **info@fewo-stommer.de** = Absender) in `shared/.env` selbst eintragen, dann `artisan mail:test` (BETRIEB.md §5a) | | Cronjob | **noch nicht eingerichtet** – ohne ihn laufen Fristabläufe, Erinnerungen, Kalenderabgleich, Backups nicht automatisch (BETRIEB.md §6) | @@ -70,7 +70,7 @@ ## 3. Offen **Technik** - Cronjob auf Strato einrichten (BETRIEB.md §6). - Design-Theme Seebad 0.3 ist auf `main` und auf stommer.info aktiv (Abschnitt 6). -- Mandantenfähigkeit: Phase 1, 2 und der Website-Teil von Phase 4 sind auf stommer.info (Release `20261023100346`, Seebad 0.3). Die bisherigen Daten gehören zum Mandanten Stommer. Cron, Postfach und Absender je Mandant fehlen noch; mit genau einem Mandanten bleibt der bisherige Betrieb. Vor einem zweiten Mandanten den Host `stommer.info` an der Website eintragen. Plan: `docs/MANDANTEN-PLAN.md`. +- Mandantenfähigkeit: Phase 1, 2 und der Website-Teil von Phase 4 sind auf stommer.info. **Nächste Codesitzung: Phase 3.** Stand, Bausteine und Fallen stehen in Abschnitt 7. Plan: `docs/MANDANTEN-PLAN.md`. - Logo in E-Mails und im Vertrags-PDF (`public/brand/logo-600.png` liegt bereit). - Content-Security-Policy: braucht wegen Livewire/Filament Nonces und einen sorgfältigen Test. - Produktion `www.fewo-stommer.de` vorbereiten: @@ -129,5 +129,61 @@ ## 6. Design-Theme „Seebad“ (Abschnitt der Design-Session) | Video (selbst gehostet) | Video + Standbild je Baustein | stumm, Poster, nicht bei „Datensparen“ | Speicherplatz Strato | | Wetter / Wassertemperatur | externe Quelle (Lizenz klären, z. B. DWD Open Data), serverseitig abgerufen und zwischengespeichert | kleine Anzeige | Lizenzfrage | -Bauort: Jeder Baustein ist **Anwendung + Theme**: Klasse in `app/Themes/Sections` (Admin-Formular, Datenaufbereitung) + ggf. Modell/Migration/Filament-Ressource (`FollowsAdminMode`) + Eintrag in `config/themes.php` + Pflicht-Vorlage im Basis-Theme `ostsee-licht` (Test erzwingt das) + eigene Vorlage in `seebad`. Interaktion nur als kleine Verbesserung in `theme.js` (ohne Framework) bzw. Livewire, wenn der Server rechnen muss. Gebaut auf eigenem Branch `feature/bausteine` **nach Phase 1 des Mandanten-Umbaus**, damit neue Tabellen gleich mandantenfähig angelegt werden (vorher: nur Konzept und Admin-Entwürfe). Reihenfolge-Vorschlag: Gut zu wissen → Tipps der Gastgeberin → Grundriss → Kalender → Erzählstrecke/Video → Wetter. +Bauort: Jeder Baustein ist **Anwendung + Theme**: Klasse in `app/Themes/Sections` (Admin-Formular, Datenaufbereitung) + ggf. Modell/Migration/Filament-Ressource (`FollowsAdminMode`) + Eintrag in `config/themes.php` + Pflicht-Vorlage im Basis-Theme `ostsee-licht` (Test erzwingt das) + eigene Vorlage in `seebad`. Interaktion nur als kleine Verbesserung in `theme.js` (ohne Framework) bzw. Livewire, wenn der Server rechnen muss. Gebaut auf eigenem Branch `feature/bausteine`. Phase 1 des Mandanten-Umbaus ist auf `main`; neue Tabellen bekommen `tenant_id` von Anfang an. Vor der ersten geänderten Theme-Datei steht der Eintrag in ZUSAMMENARBEIT.md §6. Reihenfolge-Vorschlag: Gut zu wissen → Tipps der Gastgeberin → Grundriss → Kalender → Erzählstrecke/Video → Wetter. + +## 7. Mandanten – Übergabe an die nächste Sitzung + +Stand: 23.10.2026, 12:20 · Branch `main` · Plan: [MANDANTEN-PLAN.md](MANDANTEN-PLAN.md) · Anforderungen: [MANDANTEN-ANFORDERUNGEN.md](MANDANTEN-ANFORDERUNGEN.md) + +**Hier weitermachen: Phase 3** (Einstellungen, Texte, Dienste-Grundlage). Danach der Rest von Phase 4 (Scheduler, Postfach, Absender, iCal-Token), dann Phase 5 (Export und Löschung eines Mandanten). Phase 6 und 7 erst nach eigener Freigabe und einem Eintrag in ZUSAMMENARBEIT.md §6. Neuen Branch von `main` abzweigen. `feature/mandanten` ist bereits zusammengeführt. + +### Ausgeliefert + +| | | +|---|---| +| Server | nur **stommer.info** (Staging). `www.fewo-stommer.de` ist unberührt und bleibt WordPress. | +| Release | `20261023100346`, Git-Tag `deploy/staging/20261023100346`, Commit `cec49da` | +| Code danach | Commits auf `main` nach `cec49da` sind Dokumentation. Sie sind nicht erneut ausgeliefert. Ein Deploy nur wegen dieser Texte ist unnötig: das Skript nimmt `docs/` nicht mit. | +| Migration | drei Migrationen vom 23.10. sind auf der MariaDB von stommer.info durch. Vorhandene Zeilen gehören zum Mandanten **Stommer** (`slug` `stommer`). Ein zweites Migrieren legt keinen zweiten Stommer an, solange keine Zeile ohne Mandant übrig ist. | +| Sicherung davor | `C:\Dev\fewo-backups\staging\20261023-120038` (Datenbank-Dump und Dateien). Ein Rollback der Version nimmt die Migration **nicht** zurück. | +| Konto | `php artisan users:promote-operator lars@stommer.com` ist auf dem Server gelaufen. Passwort und 2FA sind gleich geblieben. | +| Prüfung | `https://stommer.info/`, `/wohnung` und `/buchen` antworten 200 und zeigen weiter Seebad und Stommer. `/admin` und `/betreiber` leiten auf die Anmeldung um (302). Ein Login mit 2FA wurde in dieser Sitzung nicht ausgeführt. | + +Die lokale Datei `database/database.sqlite` (`.env`: `DB_CONNECTION=sqlite`, `APP_URL=http://localhost:8000`) ist **nicht** migriert. `php artisan serve` auf diesem Rechner trifft das alte Schema und läuft mit dem neuen Code nicht. Testinstanz ist stommer.info. Die lokale Datei nur migrieren, wenn jemand bewusst lokal arbeiten will (`php artisan migrate`, danach `users:promote-operator` für das lokale Konto). Die `.env` nicht auf die Datenbank von stommer.info zeigen lassen. + +Nicht committet und nicht Teil des Umbaus: `styles/satz3/svg/haus.svg`, `styles/satz3/svg/haus-klein.svg`. + +### Nicht anfassen, solange es nicht der Auftrag ist + +- `resources/themes/**`. Seebad 0.3 ist auf stommer.info aktiv. Eine neue Theme-Datei erst nach Eintrag in ZUSAMMENARBEIT.md §6. +- Keinen zweiten Mandanten anlegen, bevor an der Website von Stommer der Host `stommer.info` steht (Webseite › Website, Feld Domain). Die Domain ist leer. Mit genau einem Mandanten liefert jeder Host die Standard-Website. Ab dem zweiten Mandanten antwortet ein unbekannter Host mit 404, `is_default` rettet ihn nicht. `www` ist ein eigener Host. +- `users.role` nicht löschen. Die Mitgliedschaft in `tenant_user` gilt; die Spalte bleibt der Übergang, wenn es genau einen Mandanten gibt und noch kein Kontext gesetzt ist. +- Tabelle `settings` nicht nebenbei leeren. Das ist Phase 3. +- Filaments `Panel::tenant()` und `tenantDomain()` nicht einschalten. +- Produktion nicht ausliefern. Deploy nur aus aktuellem `main` mit grünen Feature-Tests (`scripts/deploy.sh staging deploy`). Dabei läuft `migrate` mit. Die Datenbank nicht allein migrieren, während noch alter Code aktiv ist. + +### So ist es gebaut + +| Baustein | Verhalten | +|---|---| +| `App\Tenancy\TenantContext` | Singleton in `AppServiceProvider::register`. Ohne Singleton sieht der globale Scope den Mandanten nicht. Gesetzter Kontext filtert. Leerer Kontext bei einer Abfrage, die einen Mandanten verlangt, wirft `TenantContextMissing`. Konsole, Boot und Tests ohne Kontext bleiben ungefiltert. | +| `BelongsToTenant` | Globaler Scope `tenant`. Beim Anlegen gilt: Mandant der Elternzeile (`property_id`, `booking_id`, `channel_id`, `site_id`, `guest_id`), sonst gesetzte `tenant_id`, sonst der Kontext, sonst in Tests ein Mandant „Testmandant“. `User`, `Setting` und `Tenant` gehören nicht dazu. | +| `ResolveTheme` | Liegt in der Web-Gruppe **und** in beiden Filament-Panels, dort nach `StartSession`. Panel-Routen erben die Web-Gruppe nicht. Inaktiver Mandant: 404, außer Pfad `betreiber` oder angemeldeter Betreiber. | +| Host | `ThemeFactory::siteForRequest`. Zuerst `site_domains.host`, dann `sites.domain`, beides klein geschrieben. Ein Mandant: Standard-Website auf jeder Adresse. Zwei Mandanten: nur der eingetragene Host, sonst 404. Die Konsole (`site()`) antwortet nicht mit 404. | +| `sites.domain` | Bleibt das Admin-Feld. `Site::saved` schreibt den Host nach `site_domains` und entfernt den vorherigen Host dieser Website. Leere Domain: keine Host-Zeile. | +| Gäste-Links | `Site::withOrigin` setzt `URL::forceRootUrl` **und** `URL::forceScheme` (das Schema würde sonst das der laufenden Anfrage). Genutzt für Angebot, Annahme, Ablehnung, Bewertung, Werbe-Einwilligung. Ohne Host gilt `APP_URL`. `URL::forceRootUrl(APP_URL)` außerhalb von local/testing bleibt der Schutz vor dem Strato-Pfad `/releases/…/public` und wird nicht zur Mandantenerkennung. | +| Nummern und Gäste | Buchungsnummer je Mandant und Jahr, eindeutig `(tenant_id, reference)`, weitergezählt ab der höchsten `YYYY-####`. Dieselbe E-Mail bei zwei Mandanten ergibt zwei Gäste. E-Mail ist nicht eindeutig. Index `(tenant_id, email)`. | +| Rollen | `tenant_user.role`. `User::currentRole()`: Betreiber im gesetzten Kontext ist Mandanten-Administrator; sonst die Mitgliedschaft; sonst, bei genau einem Mandanten, `users.role`. `is_operator` ist nicht massenzuweisbar, nur `users:promote-operator`. In `canAccessPanel` als `(bool)` lesen, sonst kommt `null` zurück und der Panel-Zugriff wirft einen TypeError. Passwort und 2FA setzt ein Mandanten-Administrator nur zurück, wenn das Konto ausschließlich seinem Mandanten gehört. | +| Betreiber | Panel `operator`, Pfad `/betreiber`, entdeckt nur `App\Filament\Operator`. Mandant anlegen und bearbeiten. Löschen ist in der Policy falsch (Phase 5). „Im Admin öffnen“ schreibt `tenant_access_logs` und geht auf `https:///admin`. Der Menüpunkt „Anderer Mandant“ erscheint nur, wenn es eine weitere Mitgliedschaft mit Domain gibt. `routes/web.php` lässt `betreiber` nicht als Seiten-Slug durch. | +| Weitere Stellen | `Property::site()` ist `BelongsTo`. `Booking::website()` und `Guest::website()` laden die Website ohne Mandanten-Scope. `BookingObserver` lädt die Wohnung ohne Scope `tenant`, sonst fehlt sie bei einem fremden Kontext. Rate-Limits je IP und E-Mail enthalten die Mandanten-Id; `booking-request-all` bleibt global. Cache-Schlüssel der Texte: `content-blocks.{tenantId}`. | +| Noch global | Tabelle `settings` (Vermieter, Bank, Betriebsart, Fristen, Adressen). Postfach, Absender und der Scheduler kennen keinen Mandanten. Der Cronjob auf Strato ist weiterhin nicht eingerichtet, der Versandweg ist `log`. Das ist mit einem Mandanten der bisherige Betrieb. | + +Tests dazu: `tests/Feature/TenantIsolationTest.php`, `TenantAccessTest.php`, `WebsiteTenancyTest.php`. Zuletzt 217 Feature-Tests grün. PHP auf diesem Rechner: `%LOCALAPPDATA%\Microsoft\WinGet\Packages\PHP.PHP.NTS.8.4_*\php.exe`, nicht im PATH der Git-Bash. Für `scripts/deploy.sh` von hier `COMPOSER_BIN` auf `php …/composer/composer.phar` setzen, sonst findet die Bash kein `composer`. + +### Offen, aber nicht in derselben Sitzung nötig gewesen + +- Phase 3, Rest von Phase 4, Phase 5. Jede davon bringt eigene Migrationen. Auslieferung und Migration wieder in einem Schritt, nach Sicherung. +- Lars meldet sich einmal unter https://stommer.info/admin an und öffnet eine Buchung. Danach https://stommer.info/betreiber. +- Host `stommer.info` an der Website eintragen, bevor ein zweiter Mandant entsteht. Später ebenso `www` und `fewo-stommer.de`, wenn die Produktion umzieht. +- Brigitte, Cronjob, SMTP, Rechtstexte: Abschnitt 4, unverändert und unabhängig vom Mandanten-Code.