Files
fewo-stommer/docs/MANDANTEN-PLAN.md
T
Lars StommerandClaude Opus 5 c459f7f83c
Deploy / test (push) Failing after 3s
Deploy / deploy (push) Skipped
Doku: Bildwelten und Marke in STATUS, Plan und Vertragsprotokoll; Platzhalter-Hash korrigiert
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-26 07:38:45 +01:00

30 KiB
Raw Blame History

Mandantenfähigkeit – Umbauplan

Stand: 24.10.2026 · Phasen 1 bis 5 sind umgesetzt – der Grundumbau ist fertig. Phase 6 und 7 warten auf eine eigene Freigabe · Anforderungen: MANDANTEN-ANFORDERUNGEN.md · Design: DESIGN-KONZEPT.md §7 · Übergabe: 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.

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 §6 übernehmen kann. resources/themes/** bleibt bis dahin 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

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://<host>/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

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

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 <slug> und tenants:delete <slug> (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 · Anwendungsseite umgesetzt (24.10.), Theme-Teil offen

A14, A18, A19, A20, A22. Nicht zusammen mit Phase 1–5, und nicht solange der Branch theme/<key> 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/<key>/, 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/<key>/, 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.

Offen und ein Vertragsfall (ZUSAMMENARBEIT.md §6): ostsee-licht von partials/brand auf Plätze umstellen, das Favicon in beiden Themes zuerst bei $theme->brand('favicon') erfragen, und Seebads motifs/-Ordner gegen die Bildwelt tauschen. public/brand/ entfällt erst danach.

Phase 7 – Mehrere Wohnungen je Website (zuletzt)

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.

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 sind umgesetzt. Der Grundumbau ist damit fertig: Daten, Rollen, Einstellungen, Domains, Hintergrundläufe, Export und Kündigung. Die bisherigen Daten gehören zum Mandanten Stommer, lars@stommer.com ist Betreiber. Ausgelieferter Stand und Übergabe: 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. Phase 6 und 7 warten auf eine eigene Freigabe und einen Eintrag in 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.