# Mandantenfähigkeit – Umbauplan Stand: 26.10.2026 · **Phasen 1–6 und Kern von Phase 7 umgesetzt.** Abschließender Testdeploy des Theme-/Dateiabschlusses ausstehend, siehe STATUS. Neue Wohnungsübersichts-/Suchbausteine und Subscription/Abrechnung gehören zur funktionalen Weiterentwicklung. Anforderungen: [MANDANTEN-ANFORDERUNGEN.md](MANDANTEN-ANFORDERUNGEN.md). 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. Weiterarbeiten auf einem neuen Branch ab aktuellem `develop`; Zusammenführen und Testdeploy ebenfalls über `develop`. `feature/mandanten` ist zusammengeführt. Phasen 1–5 sind der Grundumbau. Die Anwendungsseite von Marke/Bildwelt (Phase 6) und die Wohnungswahl je Baustein (Phase 7) sind fertig, ohne Theme-Dateien zu ändern. Der verbleibende Theme-Teil von Phase 6 und spätere neue Bausteine brauchen die Abstimmung des Vorlagen-Vertrags aus [ZUSAMMENARBEIT.md](ZUSAMMENARBEIT.md) §6. `resources/themes/**` bleibt außerhalb dieser Arbeiten unangetastet. --- ## 1. Entscheidungen vom 23.10.2026 | # | Frage | Entscheidung | |---|---|---| | 1 | Mandant und Website | **Getrennt.** Ein Mandant besitzt seine Websites. Betrieben wird zunächst eine Website je Mandant. Die Domain zeigt auf die Website und darüber auf den Mandanten. | | 2 | Wohnung und Website | **Genau eine Website.** `properties.site_id` bleibt. Die Wohnung gehört zusätzlich direkt dem Mandanten. | | 3 | Globale Einstellungen | **Geteilt**, siehe §5. Infrastruktur und der Schutz des Gesamtsystems bleiben global. Vermieterdaten, Texte, Postfach, Betriebsart und Regeln liegen je Mandant, Regeln innerhalb fester Grenzen. | | 4 | Portal-Postfach | **Eigenes IMAP-Postfach je Mandant.** Zugangsdaten verschlüsselt, leeres Postfach = aus. Die Zuordnung einer Mail zum Portal bleibt die Absenderliste am Kanal. | | 5 | KI-Schlüssel | **Beides, nur als Datengrundlage.** Voreinstellung ist der Schlüssel des Betreibers, Verbrauch je Mandant gezählt. Ein eigener Schlüssel des Mandanten ist möglich und ersetzt dann den des Betreibers. Kein KI-Aufruf in diesem Umbau. | | 6 | Reihenfolge | **Mandant → Marke/Bildwelt → mehrere Wohnungen je Website.** | Dazu die Sicherheitsregel aus A6a und A6b, bestätigt am 23.10.2026: Passwort und 2FA gehören zum **Konto**, die Rolle zur **Mitgliedschaft**. Ein Mandanten-Administrator setzt Passwort und 2FA nur zurück, wenn das Konto ausschließlich seinem Mandanten gehört. Gehört es mehreren Mandanten, darf das nur der Betreiber. Die Mitgliedschaft (Rolle ändern, Zugang zu diesem Mandanten sperren) bleibt beim Mandanten-Administrator. Die einfache/Expertenansicht bleibt eine Einstellung **je Benutzer** (A6c). Eine eigene Ansicht je Mandant gibt es in diesem Umbau nicht. --- ## 2. Geprüfter Ist-Stand Prüfung im Code am 23.10.2026. Filament ist in `v5.10.3` installiert (`filament/filament`). Die Mandantenfunktion ist vorhanden und **nicht eingeschaltet** (`AdminPanelProvider` setzt keinen Mandanten). Was Filament mitbringt (`Panel::tenant()`, `HasTenants`, Middleware `IdentifyTenant`, Trait `BelongsToTenant`): - Der Admin filtert Ressourcen, sobald ein Mandant gesetzt ist, und setzt bei neuen Datensätzen die Zugehörigkeit, wenn das Modell eine `tenant()`-Beziehung vom Typ `BelongsTo` hat. - Ohne `tenantDomain()` hängt Filament eine zusätzliche URL-Stufe `/admin/{mandant}` an. Mit `tenantDomain('{tenant}')` bleibt der Pfad `/admin`, der Mandant kommt aus dem Host. So bleibt Brigittes Adresse. - Der eingebaute Filter gilt **nur im Admin-Panel, und erst nachdem der Mandant erkannt wurde**. Website, signierte Links, Cron, Mails und eigene Abfragen sind nicht gefiltert. `unique()`- und `exists()`-Regeln umgehen den Filter. Filament schreibt das selbst so: die Trennung bleibt unsere Aufgabe (A3). Deshalb entsteht ein eigener Mandantenkontext für die ganze Anwendung. Filament nutzt ihn im Admin mit, ersetzt ihn aber nicht. ### Was §4 schon stimmt - `sites` (Domain, Theme, `is_default`), `pages` und `appearances` mit `site_id`, `properties.site_id`. - Saisons, Extras, Buchungen, Sperrzeiten, Angebote, Fotos, Ausstattung, Bewertungen und Kanäle hängen an der Wohnung. - Die Website wählt die Site über den Host (`ThemeFactory`, Middleware `ResolveTheme`). Die Seed-Site hat `domain = null` und `is_default = true`; jeder unbekannte Host landet heute auf dieser Site. - Themes und Portal-Connectoren sind austauschbare Pakete. - Rollen heute: eine Spalte `users.role` (`admin`, `rentals`, `content`). Richtlinien prüfen nur die Rolle, nicht den Datensatz. Die Benutzerverwaltung ist systemweit und nur für Administratoren. - Die einfache Ansicht ist die Menüliste `AdminMode::SIMPLE_NAVIGATION`. Benutzer, Websites, Texte und Betrieb stehen dort nicht. Brigitte sieht sie in der einfachen Ansicht nicht. ### Was die Prüfung gegenüber §4 korrigiert | Stelle | Befund | |---|---| | Zahlungen | Nur `booking_id`. Die Trennung wäre nur über Buchung → Wohnung → Website gegeben. `Payment::query()` ist offen. | | `channel_sync_logs`, `channel_tasks` | Nur `channel_id`, also Kanal → Wohnung → Website. Dieselben offenen Abfragen. | | `portal_emails` | Nicht herrenlos: `channel_id` ist Pflicht. Global sind das eindeutige `message_id` und das eine IMAP-Postfach aus der `.env`. | | Buchungsnummern | Beim Anlegen `Jahr-` plus globale `id`, eindeutig über alle Zeilen (`Booking`, Hook `created`). Kein eigener Nummernkreis (A13). Bestehende Nummern, z. B. `2026-0002`, bleiben unverändert. | | Gästekartei | `CreateReservation` sucht `Guest::where('email')` **ohne** Grenze. Dieselbe Adresse wäre ab dem zweiten Mandanten ein gemeinsamer Gast (verletzt A2). Die E-Mail ist nicht eindeutig, zwei getrennte Zeilen sind also möglich, sobald die Suche den Mandanten kennt. | | Texte und Einstellungen | `content_blocks.key` und `settings.key` sind systemweit eindeutig. | | `properties.slug` | Systemweit eindeutig. | | Links in Mails | `URL::forceRootUrl(APP_URL)` außerhalb von local/testing pinnt jeden signierten Link (Angebot, Bewertung, Einwilligung, Vorschau) auf **eine** Adresse. | | Mails | Absender und Antwortadresse kommen beim Start aus `Settings` und überschreiben `config` für den ganzen Prozess. Ein Cron-Lauf über mehrere Mandanten würde die Absender vermischen, wenn das so bleibt. Mails sind nicht in der Queue. | | Marke | `public/brand/`, Bausteine nutzen `$theme->property()` (die erste aktive Wohnung der Site). | --- ## 3. Zielbild ```text Betreiber (Lars, außerhalb der Mandanten) │ ▼ Mandant „Stommer“ ── besitzt ── Website fewo-stommer.de / stommer.info │ Theme, Seiten, Erscheinungsbilder │ genau die Wohnungen dieser Website ├── Benutzer (Mitgliedschaft + Rolle) ├── Gäste, Buchungen, Nummernkreis ├── Texte, Vermieterdaten, Bank, Postfach, Betriebsart └── Dienste (an/aus, Schlüssel, Verbrauch) ``` **Erkennung.** Öffentliche Anfrage und Admin lesen den Host, finden die Website, daraus den Mandanten, und setzen den Kontext, bevor eine fachliche Abfrage läuft. `/admin` bekommt keine zusätzliche Pfadstufe. **Unbekannter Host.** Solange es genau einen Mandanten gibt, gilt wie heute die Standard-Website (lokal, und solange die Domain noch leer ist). Ab dem zweiten Mandanten antwortet ein unbekannter Host mit 404. Er zeigt nicht still die Daten von Stommer. **Kontext fehlt.** Im HTTP-Request wirft eine fachliche Abfrage ohne Mandanten eine Ausnahme (geschlossen, nicht offen). Ausnahmen sind nur die Token-Wege: iCal-Feed, Health, Scheduler-Anstoß, Automation. Dort gilt das Token als Ausweis, der Datensatz bestimmt den Mandanten, und erst dann laufen weitere Abfragen. Artisan-Befehle, die alle Mandanten betreffen, setzen den Kontext in der Schleife. Der Betreiber-Bereich umgeht den Filter nur dort, nie im Mandanten-Admin. **Brigitte.** Eine Mitgliedschaft, Rolle Mandanten-Administrator, einfache Ansicht. Menü, Pfad `/admin` und Ablauf Anfrage → Angebot → Annahme bleiben. Der Mandantenwechsel erscheint erst, wenn ein Konto mehr als einen Mandanten hat. Die Beschriftung der Verwaltung für Stommer bleibt „FeWo Stommer · Verwaltung“. Der Name in der Authenticator-App für bestehende Einrichtungen bleibt. --- ## 4. Datenmodell und Übernahme Neue Tabelle `tenants`: Name, Slug (`stommer`), aktiv/gesperrt, Vermieterdaten, Bank, Steuerangabe, Absender, Benachrichtigungsadressen, Betriebsart, Testempfänger, Postfach, Fristen und Grenzen aus §5. Bank, Steuerangabe und Postfach-Passwort über das Laravel-`encrypted`-Cast (`APP_KEY`). Ein zweites Verschlüsselungsverfahren gibt es nicht. Neue Tabelle `tenant_user`: `tenant_id`, `user_id`, `role`, eindeutig je Paar. `users.email` bleibt systemweit eindeutig (ein Konto, eine 2FA). `users.is_operator` (Standard nein). `users.admin_mode` bleibt am Benutzer. Die Spalte `users.role` wird in die Mitgliedschaft kopiert und danach entfernt. `tenant_id` (Pflicht, Index, `BelongsTo`) an jeder fachlichen Tabelle, die eigene Abfragen oder einen Filament-Eintrag hat und die beim Export oder bei der Löschung eines Mandanten direkt gefunden werden muss: `sites`, `properties`, `guests`, `bookings`, `channels`, `portal_emails`, `photos`, `pages`, `appearances`, `notices`, `faqs`, `blocked_periods`, `amenities`, `reviews`, `channel_tasks`, `payments`, `seasons`, `extras`, `special_offers`, `channel_sync_logs`, `content_blocks`. Kinder ohne eigenen Bildschirm (Zahlungen, Sync-Protokoll) bekommen die Spalte trotzdem. Löschen und Exportieren eines Mandanten ist dann eine Liste von `where tenant_id`, nicht ein Join über acht Stufen (A25). Medien bleiben an ihrem Modell hängen (Spatie); sie werden über das Elternmodell gelöscht, damit die Dateien mit verschwinden. `settings` wird nicht mitgezogen. Die wenigen Schlüssel (Betriebsart, Adressen, Absender) werden Spalten des Mandanten. Danach ist die Tabelle leer und entfällt. Es gibt einen Speicher für Betriebsdaten, nicht zwei. Schlüssel, die heute systemweit eindeutig sind und sich je Mandant wiederholen dürfen: | Spalte | Neu | |---|---| | `content_blocks.key` | eindeutig je Mandant | | `properties.slug` | eindeutig je Website | | `bookings.reference` | eindeutig je Mandant | | `portal_emails.message_id` | eindeutig je Mandant | `channels.export_token` bleibt systemweit eindeutig. Der Token ist der Ausweis für den Feed; die Suche danach setzt danach den Mandanten des Kanals. ### Buchungsnummern (A13) Format bleibt `2026-0001`. Der Zähler ist das Maximum der laufenden Nummer dieses Mandanten in diesem Jahr plus eins, mit Sperre beim Anlegen. Bestehende Nummern von Stommer werden nicht umgeschrieben. Der nächste Stommer-Vorgang zählt ab der höchsten vorhandenen Nummer weiter, nicht ab der globalen `id`. ### Gäste (A2) Suche und Neuanlage in `CreateReservation` filtern auf den aktuellen Mandanten. Dieselbe E-Mail bei zwei Mandanten ergibt zwei Gäste. Rate-Limits der Buchungsanfrage, die heute nur die E-Mail kennen, schließen den Mandanten ein. Die systemweite Flutgrenze zählt weiter über alle Mandanten. ### Migration ohne Ausfall (A26) MySQL bestätigt Schemaänderungen sofort, auch mitten in einer Migration. Die Übernahme ist deshalb so geschnitten, dass die **alte** Fassung nach jedem Schritt noch läuft, und die **neue** Fassung erst ausgeliefert wird, wenn die Daten stehen. Der Datenbestand ist klein (eine Wohnung, eine Testbuchung); die Füllung passiert in der Migration, nicht in einem eigenen Job. 1. Tabellen und Spalten anlegen, `tenant_id` noch ohne Pflicht. 2. Mandant „Stommer“ anlegen. Bestehende Website, alle Wohnungen und alle abhängigen Zeilen darauf setzen. Gäste, Texte, Einstellungen, FAQ und Hinweise ebenso, es gibt nur diesen Bestand. 3. Heutige Werte aus `settings` und aus `config/fewo.php` (Vermieter, Bank, Fristen, Postfach, Betriebsart) in den Mandanten schreiben. `.env` bleibt für die globalen Werte. 4. Mitgliedschaften aus `users.role` erzeugen. Niemand wird in der Migration zum Betreiber. 5. Erst jetzt Pflicht, Fremdschlüssel und die neuen Eindeutigkeiten. `users.role` und `settings` entfernen, sobald der ausgelieferte Code sie nicht mehr liest (eigener Schritt am Ende von Phase 2 bzw. 3, nicht zusammen mit dem Anlegen). Slug `stommer`, Name aus dem bisherigen Vermieter. Die Website bleibt Standard-Website mit leerer Domain, bis die echten Hosts eingetragen sind. Vor dem zweiten Mandanten werden die Hosts von Stommer gepflegt (stommer.info, später fewo-stommer.de und `www`). Dafür reicht eine kleine Tabelle `site_domains` (Website, Host, eindeutig). Ein Host gehört zu genau einer Website. Nach dem Deploy einmalig, von Lars, nicht in der Migration: `php artisan users:promote-operator` für das eigene Konto. Bis dahin ist der einzige Mandanten-Administrator über seine Mitgliedschaft handlungsfähig. Brigittes Konto wird nicht befördert; es existiert laut STATUS noch nicht und wird später normal als Mandanten-Administratorin angelegt. --- ## 5. Was global bleibt, was umzieht **Bleibt in `.env` / `config` (Betreiber, nicht im Mandanten-Admin):** | Wert | Grund | |---|---| | Datenbank, `APP_KEY`, SMTP-Host, SMTP-Benutzer, SMTP-Passwort | ein Versandweg für alle; die Absenderadresse ist trotzdem je Mandant | | `FEWO_MAIL_REDIRECT_TO` | harte Umleitung des ganzen Servers (Testbetrieb auf stommer.info) | | Backup-Aufbewahrung | ein Backup der ganzen Datenbank (A25) | | Scheduler-Token, Health-Token, Automation-Webhook und -Geheimnis | Betrieb des Gesamtsystems | | `spam.total_per_hour` | Flutgrenze über alle Websites | | Obergrenzen für Löschfristen und für die Bot-Schutz-Werte | ein Mandant kann sie verschärfen, nicht abschalten | **Zieht an den Mandanten:** Name, Anschrift, Telefon, E-Mail, Bank, Steuerangabe, Impressum und Datenschutz (weiter über die Texte), Mietbedingungen, Storno, Mail- und Vertragstexte, FAQ, Hinweise, Absender, Benachrichtigungen, Postfach, Betriebsart Test/scharf, Anzahlungsfrist, Bewertungsfrist, Löschfristen, Bot-Schutz außer der Flutgrenze, Fristen der Portal-Überwachung. Anzahlungssatz, Endreinigung und Mindestaufenthalt liegen schon an der Wohnung und bleiben dort. `config/content.php` bleibt der **Feldkatalog** (dieselben Felder für jeden Mandanten, Standardtexte im Code). Die gepflegten Werte liegen in `content_blocks` je Mandant. Neue Felder kommen per Deploy für alle. Der Code liest Vermieter, Bank, Fristen und Adressen über den aktuellen Mandanten. `config('fewo.owner.*')` und `Settings::get()` werden an diesen Stellen abgelöst. Die globalen Schlüssel bleiben über `config('fewo.*')` erreichbar. ### Dienste (A15–A17, ohne Funktion dahinter) Tabelle `tenant_services`: Mandant, Schlüssel (`portal_sync`, `portal_mail`, `ai_offers`, `ai_marketing`, `ai_guest_mail`), an/aus, eigener API-Schlüssel verschlüsselt und leer erlaubt. Tabelle `service_usages`: Mandant, Dienst, Menge, Zeitpunkt. Es wird noch nichts gezählt, weil noch kein Dienst aufruft. Der Betreiber schaltet Dienste je Mandant. Ist ein eigener Schlüssel leer, gilt später der Schlüssel des Betreibers aus der `.env`. Diesen zentralen Schlüssel gibt es in diesem Umbau noch nicht als Aufruf, nur als vorgesehene Stelle. --- ## 6. Rollen, Admin, Betreiber Rollen bleiben ein PHP-Enum, gespeichert als Text in `tenant_user.role`. Dazu ein Rechtekatalog an einer Stelle (`UserRole::permissions()`): Buchungen sehen, Buchungen ändern, Gäste, Preise, Bilder, Texte, Benutzer, Betrieb, … Die Richtlinien fragen das Recht des **aktuellen** Mandanten, nicht mehr „ist Administrator oder steht auf dieser Liste“. Eine spätere Rolle Reinigung oder Steuerberater ist ein neuer Enum-Fall und eine Rechtemenge, ohne neue Tabellen und ohne den Filter neu zu bauen (A6d). | Rolle | Bedeutung | Rechte, unverändert zur heutigen Aufgabe | |---|---|---| | Mandanten-Administrator | bisher `admin`, nur dieser Mandant | alles im Mandanten, einschließlich Benutzer | | Vermietung | bisher `rentals` | Buchungen, Gäste, Preise, Angebote, Bewertungen | | 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 | 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. **Benutzerverwaltung (A6a).** Der Mandanten-Administrator sieht nur Mitglieder seines Mandanten. Neue E-Mail legt ein Konto an (Passwort, 2FA beim ersten Login wie heute). Bestehende E-Mail hängt das Konto an diesen Mandanten, ohne die andere Mitgliedschaft zu zeigen oder zu ändern. Rolle ändern und Mitgliedschaft entziehen betrifft nur diese Zeile. Passwort und 2FA nach der Regel in §1. Er kann die Betreiber-Markierung nicht setzen und keine Rolle außerhalb der drei Mandantenrollen vergeben. Die einfache Ansicht zeigt die Benutzerverwaltung weiterhin nicht. Brigitte arbeitet dort nicht anders als heute. --- ## 7. Domain, Cron, Mails **Öffentliche Website.** `ResolveTheme` setzt neben Theme und Erscheinungsbild den Mandanten. Buchungsformular, Seiten und FAQ laufen in diesem Kontext. **Signierte Links.** Angebot, Annahme, Bewertung und Einwilligung werden mit dem Ursprung der Website erzeugt (Schema und Host der Site), nicht mit einem für alle pinnten `APP_URL`. Die bestehende Festlegung der Root-URL bleibt der Schutz davor, dass auf dem jetzigen Host Pfade wie `/current/public` in Links geraten; sie wird nicht zur Mandantenerkennung und nicht auf fremde Domains ausgedehnt. Ein Link von Mandant A ist auf dem Host von Mandant B ungültig (die Signatur umfasst die ganze URL) und die Buchung wäre dort zusätzlich außerhalb des Filters. **Cron** (`routes/console.php`). Backup bleibt ein globaler Lauf. Alle anderen Aufgaben laufen je aktivem Mandanten in dessen Kontext: Fristen, Erinnerungen, Bewertungen, Anonymisierung, Kanalabgleich, Portal-Mail, Aufgaben-Erinnerung. Grenzen und Postfach kommen aus dem Mandanten. Ein Lauf setzt Absender und Antwortadresse für diesen Versand und setzt sie danach zurück; nichts davon bleibt als Prozess-`config` für den nächsten Mandanten hängen. Die Mail-Klassen bekommen Absender, Antwortadresse und Umleitung als Werte beim Erzeugen, nicht beim späteren Lesen aus der Konfiguration. **Postfach.** `MailboxReader` bekommt die Zugangsdaten des Mandanten. Leer = dieser Mandant wird übersprungen. Verarbeitete `message_id` gelten je Mandant. **Betriebsart.** Test/scharf ist je Mandant. `FEWO_MAIL_REDIRECT_TO` gewinnt weiterhin für den ganzen Server. Auf stommer.info bleiben damit alle Mails bei der Testadresse, auch nach dem Umbau. **iCal.** Der Export-Token sucht den Kanal ohne Mandantenfilter, setzt dann dessen Mandanten, und der Feed enthält nur dessen Belegung. --- ## 8. Phasen Die abgeschlossenen Anwendungsphasen wurden ursprünglich nach `main` zusammengeführt. Für weitere Arbeiten gilt jetzt der PipelineManager-Ablauf: eigener Branch ab `develop`, grüne Tests (`php artisan test --compact --testsuite=Feature` auf die betroffenen Dateien, am Ende der Phase die Feature-Suite), Zusammenführen nach `develop` und automatischer Testdeploy. Produktion folgt über Merge-Commit `develop` → `main`, sobald ausdrücklich freigegeben; derzeit gesperrt. `php artisan test` ohne `--testsuite=Feature` bricht ab, weil `tests/Unit` nicht existiert. `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 Ziel: Alles, was heute existiert, gehört Stommer. Ein zweiter Mandant sieht davon nichts. Verhalten mit nur diesem Mandanten ist dasselbe. - Tabellen, Trait, Kontext, Middleware für die Website, Übernahme wie §4. - Fabriken legen den Mandanten an und hängen Daten daran. - Buchungsnummern je Mandant, Gästesuche je Mandant. - `users.role` wird noch mitgeführt, damit Phase 1 ohne die neue Rechteprüfung auskommt. Tests: Übernahme setzt jede bestehende Zeile auf Stommer. Zwei Mandanten, gleiche Gast-E-Mail, zwei Gäste, getrennte Buchungen. Nummernkreis `2026-0001` je Mandant, Stommer zählt an seiner höchsten Nummer weiter. Abfrage ohne Kontext im HTTP-Test schlägt fehl. ### Phase 2 – Rollen, Admin, Benutzer Ziel: Brigitte arbeitet im selben `/admin`. Ein zweiter Mandant hat eigene Benutzer und kommt an Stommer nicht heran. - Mandant über die Domain (eigener Kontext, Pfad bleibt `/admin`), Panel `/betreiber`, Rechtekatalog, Richtlinien, Benutzerverwaltung nach §6. Umgesetzt. - `users.role` bleibt, solange der Code sie noch als Übergang liest. Entfernen, wenn kein Leser mehr übrig ist. - Befehl `users:promote-operator`. Umgesetzt. Tests: Mitglied von A öffnet eine Buchung von B per Adresse und bekommt 404. Mandanten-Administrator vergibt keine Betreiber-Markierung und sieht keine fremden Benutzer. Konto mit zwei Mitgliedschaften: Passwort-Reset durch den Mandanten-Administrator wird verweigert, durch den Betreiber nicht. Rolle Vermietung kann keine Benutzer anlegen. Einfache Ansicht enthält dieselben Menüpunkte wie vor dem Umbau. Konto mit einem Mandanten sieht keinen Wechsel. ### Phase 3 – Einstellungen, Texte, Dienste-Grundlage · umgesetzt Ziel: Vermieterdaten und Texte sind Daten des Mandanten. Die `.env` von Stommer ist nach der Übernahme nur noch Infrastruktur. - Spalten am Mandanten, `content_blocks` je Mandant, FAQ und Hinweise je Mandant, Seite „Betrieb“ schreibt den aktuellen Mandanten. Umgesetzt. - Katalog in `config/content.php` bleibt. Unverändert. - `tenant_services` und `service_usages`, Schalter nur im Betreiber-Bereich. Umgesetzt und am 24.10. **wirklich angeschlossen**: `App\Tenancy\TenantFeatures` wird in `RolePolicy::allows()`, beim Portal-Import, im iCal-Feed und im Postfach-Schnellweg abgefragt. Nur verdrahtete Dienste sind schaltbar (`TenantServiceKey::isWired()`); die KI-Dienste erscheinen erst, wenn die Anwendung sie abfragt. Eigene API-Schlüssel gehören dann in den Admin des Mandanten, nicht zum Betreiber (A16). `service_usages` steht bereit, es zählt noch nichts. - Tabelle `settings` entfernen. Umgesetzt. Gebaut als Überlagerung: `App\Tenancy\TenantConfig` legt die Werte des aktuellen Mandanten über `config('fewo.*')` und `mail.from`, sobald sich der Kontext ändert. Vorlagen, Mails und der Vertrag lesen weiter dieselben Schlüssel; `resources/themes/**` blieb unangetastet. Die `.env` bleibt die Grundlinie: Rückfall ohne Mandanten und Obergrenze für Löschfristen und Bot-Schutz. Tests (`tests/Feature/TenantSettingsTest.php`, `OperationsModeTest.php`): Zwei Mandanten, unterschiedliches Impressum, unterschiedliche Bank, unterschiedliche Betriebsart. Mandant kann die Löschfrist und den Bot-Schutz nicht über die globale Obergrenze heben. Leerer Dienst-Schlüssel ist erlaubt, eigene Schlüssel und Bankdaten liegen verschlüsselt. ### Phase 4 – Domain, Cron, Mail, Postfach · umgesetzt Ziel: Host, Erinnerungen und Portal-Mails gehören dem richtigen Mandanten. - `site_domains`, 404 für unbekannte Hosts ab dem zweiten Mandanten. Umgesetzt. Mit genau einem Mandanten bleibt die Standard-Website auf jeder Adresse. Am 24.10. ergänzt: mehrere Adressen je Website im Admin, weil „www" ein eigener Host ist und das Feld „Domain" nur einen schrieb. Fremde Hosts werden abgelehnt. - Links mit dem Ursprung der Website. Umgesetzt für Angebot, Annahme, Bewertung und Einwilligung. - Scheduler-Schleife, Postfach je Mandant, Absender je Versand. Umgesetzt am 24.10.: `App\Tenancy\TenantRunner` führt jeden Lauf einmal je aktivem Mandanten aus, mit gesetztem Kontext; ein scheiternder Mandant hält die anderen nicht auf. Die Datenbank-Sicherung bleibt global. Das Postfach liegt als `mailbox_*` am Mandanten (Passwort verschlüsselt, leerer Server = aus), steht im Mandanten-Admin und nur bei freigeschaltetem Dienst. Auch die Cache-Schlüssel der Postfach-Überwachung tragen den Mandanten. Tests: Angebotslink trägt den Host der Website. Erinnerungslauf für A schreibt keine Mail an Gäste von B und nicht mit dem Absender von B. Postfach-Passwort von A ist aus dem Kontext von B nicht lesbar. iCal-Token von A liefert keine Belegung von B. Unbekannter Host bei zwei Mandanten: 404. Mit einem Mandanten: Standard-Website wie heute. ### Phase 5 – Abnahme der Trennung und Kündigung · umgesetzt Ziel: Ein Befehl exportiert und löscht genau einen Mandanten (A25). Die Trennung ist als Suite festgehalten, nicht nur in den einzelnen Phasen. - Befehl des Betreibers: `tenants:export ` und `tenants:delete ` (exportiert erst, fragt nach, löscht dann einschließlich Medien). `App\Tenancy\TenantArchive`. Löschen ist bewusst **keine** Schaltfläche im Panel. - Konten, die nur zu diesem Mandanten gehörten, werden mitgelöscht; wer noch für einen anderen arbeitet, und der Betreiber bleiben. Der Export nennt die Konten mit Rolle, aber ohne Passwort-Hashes und ohne 2FA-Geheimnisse – er wird herausgegeben. - `tests/Feature/TenantSeparationTest.php` füllt jeden Bereich aus A1 für zwei Mandanten, exportiert und löscht einen und prüft den anderen Zeile für Zeile, auch die Hosts (die über die Website hängen und keine eigene `tenant_id` haben). Der Test merkt künftig, wenn eine neue Tabelle ihre `tenant_id` vergisst. Tests: Nach der Löschung von A ist B vollständig da, inklusive Dateien und Buchungsnummern. Export von A enthält keine Zeile von B. ### Phase 6 – Marke und Bildwelt · vollständig umgesetzt (26.10.) A14, A18, A19, A20, A22. Nicht zusammen mit Phase 1–5, und nicht solange der Branch `theme/` die Vorlagen noch nicht nachziehen kann. - Marke (Logo, Favicon, Logo für Mail und PDF) als Medien der Website. `public/brand/` wird zur Quelle, aus der Stommer einmalig übernommen wird, und ist danach nicht mehr der Ablageort. - Bildwelten als Pakete neben den Themes (`resources/image-worlds//`, Manifest und SVGs), analog zu Themes, nicht als Upload. Die Website wählt eine Bildwelt. Eine Wohnung kann sie überschreiben (A20); das ist die Stelle für die Berg-Wohnung, auch wenn Phase 7 die Auswahl in den Bausteinen erst danach scharf schaltet. - Themes sprechen nur Plätze an (Trenner, Abschlussband, Vignette), keine feste Ostsee-Datei (A19). Das ändert den Vorlagen-Vertrag. Vor der ersten geänderten Theme-Datei steht der Eintrag in ZUSAMMENARBEIT.md §6. Das parallel entstehende Theme wird nicht von dieser Sitzung editiert. **Umgesetzt am 24.10. (ohne eine Theme-Datei zu ändern):** Bildwelten als Pakete in `resources/image-worlds//`, Registry, Auswahl an der Website, Überschreibung an der Wohnung; `$theme->motif()`/`hasMotif()`/`imageWorld()` als Platz-API; `image-worlds:check`. Marke als Medien der Website mit `$theme->brand()`, eingebettet im Mietvertrag. Die Ostsee-Grafiken wurden **kopiert**, nicht verschoben. **Abschluss 26.10.:** Beide Themes nutzen Website-Marke und Bildwelt-Plätze; ohne Marke wird keine fremde Identität angezeigt. Alte Grafikdateien bleiben nur als Importquellen erhalten. `sites:import-stommer-brand ` übernimmt die vorhandene Stommer-Marke ohne Überschreiben. Auch HTML-/Textmails sind mandanteneigen. Verträge und Angebote haben getrennte Speicherpfade; Export/Löschung schließen Website-Medien und Vertragsdateien ein. Regressionstests: `TenantBrandRenderingTest`, `TenantFilesTest`. Der Vorlagenvertrag ist in ZUSAMMENARBEIT §6 eingetragen. ### Phase 7 – Mehrere Wohnungen je Website · Kern umgesetzt und ausgeliefert (26.10.) A21. Die Seite bleibt bei einer Wohnung, solange ein Baustein keine nennt. - Im Seiten-Baukasten kann ein Baustein eine Wohnung dieser Website wählen. Ohne Wahl gilt `primaryProperty()` wie heute. - Der Renderer setzt diese Wohnung, bevor der Baustein läuft. Bestehende Vorlagen, die `$theme->property()` rufen, bleiben gültig. Eine neue Übersicht auf der Startseite und eine Suche über mehrere Wohnungen sind neue Bausteine im Katalog; auch das ist ein Eintrag in §6, bevor eine Theme-Datei entsteht. **Abgeschlossener Umfang:** gemeinsames Auswahlfeld `data.property_id` im Seiten-Baukasten, beschränkt auf aktive Wohnungen derselben Website. Ohne Auswahl gilt die Hauptwohnung. `SectionRegistry` prüft die Zuordnung beim Rendern erneut; fremde, inaktive oder gelöschte Wohnungen führen zum Überspringen des Bausteins. `Theme::runForProperty()` setzt den Kontext auch während der verzögerten Ausgabe durch `SectionView` einschließlich Blade/Livewire und stellt ihn im `finally` bei Fehlern und verschachtelten Aufrufen wieder her. Damit folgt auch die Bildwelt der gewählten Wohnung. Keine Theme-Datei, Tabelle, Migration oder Abhängigkeit geändert. **Nachweis:** `tests/Feature/SectionPropertyTest.php` mit 13 Fällen für gemischte Wohnungen, Hauptwohnungs-Fallback, Buchungsformular, verzögerte Ausgabe, Verschachtelung/Fehler und Website-/Mandantengrenzen. Gesamtsuite: **285 Tests, 1289 Assertions grün**, zuletzt erneut im automatischen Pipeline-Lauf [4658](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4658). Ursprüngliche Auslieferung: Commit `abf0e90`, Release `20261026072521`; auch im per PipelineManager ausgelieferten Stand enthalten. Details und technische Übergabe: [STATUS.md](STATUS.md) Abschnitt 7. **Separat und optional:** Neue Übersichts- und Suchbausteine sind nicht Teil dieses abgeschlossenen Kerns. Sie benötigen einen eigenen Auftrag und vor Theme-Änderungen den Eintrag in ZUSAMMENARBEIT.md §6. Die bereits abgeschlossene Wohnungswahl nicht erneut implementieren. --- ## 9. Betrieb und Abgrenzung - Hosting bleibt vorerst Strato. Domain und Zertifikat eines neuen Mandanten richtet der Betreiber von Hand ein und trägt den Host in `site_domains` ein (A23). Der Umbau speichert keine Strato-Pfade, keine fest verdrahtete Weiterleitung und keine zweite Root-URL-Logik für den Release-Ordner. - Umzug auf einen eigenen Server ändert das Datenmodell nicht (A24). - Eine Datenbank, ein Backup. Export und Löschung eines Mandanten können den Rest (Phase 5). - Keine Selbstregistrierung, keine Abrechnung, kein Portal, keine gemeinsame Suche. - AVV, Nutzungsbedingungen und die Nennung der Unterauftragnehmer (A27, A28) bleiben eine rechtliche Aufgabe. Technisch ist nur sichergestellt, dass Impressum und Datenschutz die Texte des Mandanten sind und der Betreiber sie nicht als eigene Vermieterdaten ausliefert. - Parallel laufendes Theme: diese Sitzung ändert `resources/themes/**` nicht. Wünsche der Design-Sitzung weiter über ZUSAMMENARBEIT.md §5. --- ## 10. Freigabe **Phasen 1 bis 5, die Anwendungsseite von Phase 6 und der Kern von Phase 7 sind umgesetzt und ausgeliefert.** Der Grundumbau ist fertig: Daten, Rollen, Einstellungen, Domains, Hintergrundläufe, Export und Kündigung, dazu Bildwelten, Marke je Website und Wohnungswahl je Baustein. Phase 7 braucht keine weitere Implementierung oder gesonderte Freigabe für diesen Kern. Die bisherigen Daten gehören zum Mandanten Stommer, `lars@stommer.com` ist Betreiber. Auslieferungsnachweise und Übergabe: [STATUS.md](STATUS.md) Abschnitt 7. Offen und **nicht** Teil dieses Plans: Subscription und Abrechnung (§9 schließt sie aus; `service_usages` liegt als Grundlage bereit) sowie die Frage, ob Strato für die Domain eines Mandanten ein Zertifikat ausstellt – davon hängt ab, ob das Modell „Mandant bringt seine Domain mit" auf diesem Hosting trägt. Nur der verbleibende Theme-Teil von Phase 6 und optionale neue Bausteine benötigen weitere Abstimmung und vor Theme-Änderungen einen Eintrag in [ZUSAMMENARBEIT.md](ZUSAMMENARBEIT.md) §6. 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.