Files
fewo-stommer/docs/STATUS.md
T
Lars StommerandClaude Opus 5 f686996122
Deploy / test (push) Failing after 3s
Deploy / deploy (push) Skipped
Doku: ausgelieferter Stand 20261024152057 und die Prüfungen am Server
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-24 17:39:06 +02:00

222 lines
30 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Projektstand
Stand: 24.10.2026 · ausgelieferter Stand: `deploy/staging/20261024152057` · 262 Feature-Tests grün
> Dieses Dokument ist der Einstieg für jede neue Arbeitssitzung. Bitte bei größeren Änderungen fortschreiben (Abschnitte „Fertig“, „Offen“, „Nächste Schritte“).
## 1. Fertig (umgesetzt, getestet, auf stommer.info)
**Vermietung**
- **Preise:** Saisons mit Preis/Nacht und Mindestnächten; Preisrechner; Extras (Bettwäsche, Handtücher); Endreinigung, Zusatzperson, Anzahlungsquote, Restzahlungsfrist je Wohnung. In Folgejahr kopieren, optional mit Saisonbeginn auf einem Wochentag. *(Code: `app/Pricing`, `CopySeasonsToNextYear`)*
- **Mindestaufenthalt mit Ausnahmen:** Kalenderlücke vollständig gefüllt; Abreise am typischen Anreisetag; Sonderangebot hebt auf; absolute Untergrenze. *(`PriceCalculator::minimumStayRelaxed`, Einstellungen „Regeln Mindestaufenthalt“)*
- **Sonderangebote:** Rabattaktion, fester Termin (auch Pauschalpreis) und Lückenfüller (erkennt Lücken selbst). Dazu Aktionscodes, Priorität und „Hervorheben“. Die Webseite bewirbt Angebote nach eigenen Regeln (`OfferShowcase`), nebeneinander, als Liste oder rollierend. *(KONZEPT §5a)*
- **Buchungsweg 1 – Anfrage → Angebot → Annahme** (KONZEPT §6a):
1. Der Gast fragt unverbindlich an; der Zeitraum ist für die Haltezeit vorgemerkt.
2. Die Vermieterin öffnet „Angebot senden“ und passt bei Bedarf Termin, Personen, Rabattcode, Preis, Gültigkeit, Nachricht und Gastdaten an.
3. Der Gast erhält eine E-Mail mit Vertragsentwurf (PDF) und einem signierten Link.
4. Auf der Angebotsseite nimmt er an (Annahmenachweis ohne IP) oder lehnt ab.
5. Nach der Annahme: Bestätigung und Mietvertrag, Zahlungsfristen laufen.
Die Angebotsfrist verfällt automatisch. „Direkt bestätigen“ gibt es für telefonisch vereinbarte Buchungen. *(`SendOffer`, `AcceptOffer`, `RejectOffer`, `OfferController`, `resources/views/offer.blade.php`)*
- **Zahlungen:** manuell erfassen, Erinnerungen an Anzahlung und Rest, Anreiseinformationen, Bewertungsanfrage nach Abreise.
- **Gästekartei:** Notizen, Tags, CSV-Export, Werbe-Einwilligung mit Bestätigung per E-Mail (Double-Opt-in). Eine neue Anfrage überschreibt keine Stammdaten.
- **Portale:** iCal-Import und -Export, Überwachung, Portal-E-Mails als schneller Weg, Aufgaben für manuelle Sperren. *(PORTALE.md)*
- **Bewertungen:** Einladung per E-Mail, Freigabe im Admin, Anzeige mit Pflichthinweis zur Echtheit.
**Verwaltung (Admin)**
- **Rollen:** Mandanten-Administrator, Vermietung, Inhalte. Auf stommer.info gilt die Rolle je Mandant. `lars@stommer.com` ist Betreiber und bleibt Mandanten-Administrator.
- **Ansichten:** Die **einfache Ansicht** zeigt Anfragen & Buchungen, Sperrzeiten, **Preise & Angebote**, Gäste, Portal-Aufgaben, Bewertungen und Bilder. Die **Expertenansicht** zeigt alles. Umschalten im Benutzermenü.
- **Sicherheit:** 2FA ist für **alle** Konten Pflicht; Administratoren können die 2FA eines anderen Kontos zurücksetzen und Passwörter neu vergeben.
**Webseite**
- **Theme-System:** Basis-Theme „Ostsee-Licht“, 15 Bausteine, Seiten-Baukasten.
- **Erscheinungsbilder** für Standard, Sommer, Winter, Weihnachten und Silvester:
- Bilder je Baustein, Bausteine nur in bestimmten Erscheinungsbildern,
- Vorschau-Links, Bildauswahl mit Vorschaubild.
- **Markengrafiken** im Theme: Logo, Favicon, Symbole, Wellenband, Illustration. *(`public/brand`, `partials/brand`)*
- **Theme-Werkzeuge:** `themes:make`, `themes:check`, `themes:preview`; Anleitung in THEME-ERSTELLUNG.md.
- **Fotos:** 39 Fotos aus dem alten WordPress importiert, GPS- und Kameradaten entfernt.
**Betrieb und Datenschutz**
- **Deployment:** atomare Versionen auf Strato, Gesundheitscheck mit automatischem Zurückschalten; Versionsgeschichte als Git-Tags. Nur die aktive Version liegt auf dem Server (Strato-Dateilimit).
- **Datenbank-Backup:** täglich; `scripts/backup-pull.sh` holt es samt Dateien aufs NAS.
- **Datenschutz:**
- Anonymisierung und Löschfristen (Vorschläge) laufen täglich.
- Sicherheits-Header sind gesetzt; Automations-Tokens werden per Header übergeben.
- Keine externen Quellen (Schriften selbst gehostet).
- **Betriebsart** (System › Betrieb): Testbetrieb (Standard) schickt alle Mails nur an eine Testadresse, „scharf geschaltet“ an die echten Empfänger; Hinweisbanner in der Verwaltung. `mail:test` prüft den Versand; alle 17 Mail-Typen werden in Tests vollständig aufgebaut.
- **Bot-Schutz der Buchungsanfrage:** Köderfeld, Zeitsperre, Begrenzungen je IP/E-Mail/gesamt, höchstens 2 gleichzeitige Vormerkungen je E-Mail, keine Links (ohne externen Captcha-Dienst).
- **Testbetrieb:** `noindex`.
## 2. Stand auf stommer.info (Testbetrieb)
| | |
|---|---|
| Konten | `lars@stommer.com` ist Betreiber und Mandanten-Administrator von Stommer (Passwort und 2FA unverändert). Admin unter https://stommer.info/admin am 23.10.2026 geprüft und funktionsfähig. 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) |
| Typischer Anreisetag | noch nicht eingetragen (Preise & Angebote › Saisons › Regeln Mindestaufenthalt) |
## 3. Offen
**Entscheidungen und Inhalte (Betreiber)**
- Impressum und Datenschutzerklärung werden separat erstellt; dann unter Webseite › Texte › Rechtliches eintragen.
- Mietbedingungen, Storno-Regeln, AGB; Texte zu Angebot und Annahme, einschließlich der Beschriftung des Annahme-Buttons, fachkundig freigeben lassen (Webseite › Texte).
- Löschfristen nach allgemeiner Rechtsauffassung bestätigen (BETRIEB.md §7a); Auftragsverarbeitung mit Strato im Kundenbereich prüfen.
- Bankverbindung (`FEWO_BANK_*`), Preise 2027, Meldeschein: Ob der Ferienservice Balu ihn übernimmt, ist noch zu klären; die Kurabgabe erledigt Balu vor Ort.
- Sprachen: nur Deutsch oder auch Englisch?
**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: **Phasen 1 bis 5 sind umgesetzt** – der Grundumbau ist fertig. 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:
- eigener Deploy-Ordner, Datenbank und `.env`,
- Umleitungen von der alten WordPress-Seite,
- echte Testbuchungen (GO-LIVE-CHECKLISTE.md).
- Später:
- Buchungsweg 2 (verbindliche Direktbuchung), erst bei verlässlicher Synchronisation mit FeWo-direkt,
- Portalbuchungen als vollwertige Buchungen (DATENMODELL-KONZEPT.md),
- Stornoformular für Gäste, KI-Angebotsentwürfe, Marketing und Social Media.
- SSH-Schlüssel des Firmen-Laptops vom Server entfernen, sobald der private PC eingerichtet ist (BETRIEB.md §4).
## 4. Nächste Schritte (Vorschlag)
1. Cronjob einrichten; SMTP einschalten und mit `mail:test` prüfen (Mails landen wegen Testbetrieb nur bei Lars); Konto für Brigitte anlegen.
1a. Vor dem Go-Live: System › Betrieb auf „scharf geschaltet“ stellen – erst dann erhalten Gäste die Mails. Beim Go-Live außerdem unter System › Betrieb › Adressen Kontakt-/Antwortadresse und Benachrichtigungen von fewo@stommer.de auf **info@fewo-stommer.de** umstellen (Entscheidung 23.10.2026; Absender ist bereits info@fewo-stommer.de).
2. Brigitte probt Anfrage → Angebot → Annahme mit einem eigenen Test (Angebotslink über die Aktion „Angebotslink“).
3. Vor einem zweiten Mandanten den Host `stommer.info` unter Webseite › Website eintragen. Sonst antwortet diese Adresse ab dann nicht mehr.
4. Rechtstexte und Bedingungen einpflegen, Produktion einrichten, Umzug von WordPress.
## 5. Schnellreferenz Code
| Bereich | Ort |
|---|---|
| Geschäftsabläufe | `app/Actions/*` (CreateReservation, SendOffer, AcceptOffer, RejectOffer, ConfirmBooking, DeclineBooking, ExpireReservations, RecordPayment, SyncChannel, ProcessPortalMail, AnonymizeGuests …) |
| Preise/Angebote | `app/Pricing/*` (PriceCalculator, OfferShowcase, AdvertisedOffer), `app/Availability/*` (AvailabilityChecker, GapFinder) |
| Verwaltung | `app/Filament/**` (Ansichten: `App\Enums\AdminMode`, Trait `FollowsAdminMode`) |
| Webseite | `app/Themes/**`, `resources/themes/ostsee-licht/**`, `config/themes.php` |
| Befehle | `users:create`, `users:promote-operator`, `photos:import`, `photos:strip-metadata`, `backup:database`, `themes:make/check/preview`, `channels:sync`, `bookings:expire-holds` |
| Zeitpläne | `routes/console.php` (jede Minute Postfach, alle 5 Min. Fristen/Abgleich, täglich Erinnerungen, Bewertungen, Anonymisierung 03:00, Backup 02:30) |
| Einstellungen | `config/fewo.php` (Frist, Löschfristen, Backup, Mail-Umleitung), `config/content.php` (bearbeitbare Texte) |
## 6. Design-Theme „Seebad“ (Abschnitt der Design-Session)
Stand: 23.10.2026 · Theme 0.3.0 auf stommer.info **aktiv** · Konzept: [DESIGN-KONZEPT.md](DESIGN-KONZEPT.md) (Richtung A) · Theme-Doku: `resources/themes/seebad/README.md`
**Fertig:** alle 15 Bausteine, Kopf/Fuß/Banner/mobile Buchungsleiste, Logo aus `styles/satz4` (SVG-Master + WebP), Favicon (Eckbau mit Rundbogengaube), Bäderstil-Details des Hauses (Rundbogen mit Fasche und Schlussstein, Rundbogengaube, Kopfbänder als Eckkonsolen, Balkongeländer), Farben aus dem Logo, Schriften selbst gehostet. Gearbeitet wird im eigenen Worktree auf `theme/seebad`, ausgeliefert nur über `main`.
**Behoben 23.10.2026:** Im Admin hochgeladene Fotos landeten im privaten Speicher und waren auf der Website unsichtbar (403) – jetzt immer öffentlich, vorhandene per Migration verschoben (BETRIEB.md §8).
**Offen (Design):**
- Ziffer 0 mit Schrägstrich (Schrift Atkinson Hyperlegible) in Preisen und Daten – Entscheidung Lars: lassen oder Preise/Daten in anderer Schrift.
- Seite „Kühlungsborn“ wirkt leer, bis es den Baustein „Tipps der Gastgeberin“ gibt (Vignetten liegen bereit: `motifs/vignette-*.svg`).
- Bewertungen und Sonderangebote nur lokal mit Testdaten geprüft – auf stommer.info gibt es noch keine (Admin: Angebot anlegen bzw. Bewertung freigeben, dann ansehen).
- Mail-Logo und Vertrags-PDF nutzen noch `public/brand/logo-600.png` → beim Mandanten-Umbau (Marke je Website, MANDANTEN-ANFORDERUNGEN A14/A22) auf `styles/satz4/svg/logo-voll.svg` umstellen.
- Hauptmenü mit Bildtafeln (Entwurf im Canvas) – rein im Theme machbar, noch nicht gebaut.
- SVG-Master des Logos für Druck/Markenanmeldung von einem Grafiker glätten lassen (leichte Fleckigkeit in Wellen und Sonne).
**Neue Bausteine („Widgets“) – wo sie gebaut werden:**
| Baustein | Daten / Admin | Darstellung | Abhängig von |
|---|---|---|---|
| Interaktiver Grundriss – **gebaut** (23.10.2026, Branch `feature/bausteine`) | Tabelle `floor_plans` (`tenant_id`, eine je Wohnung, Bild = Foto aus Webseite › Fotos, Räume als JSON: Name, Text, Hinweis, Fotos, Ausstattung, sichtbar, Ecken in %); Admin › Webseite › Grundriss mit Eckpunkt-Editor (Ecken setzen, ziehen, mit Pfeiltasten feinjustieren, auf Kanten einfügen, per Doppelklick/Entf löschen) (`resources/views/filament/forms/floor-plan-area.blade.php`, nur Expertenansicht) | Baustein `floor_plan`; Seebad: Flächen und Raum-Tasten wählen einen Raum, Kartusche mit Foto/Ausstattung/Hinweis; ohne JS Liste. Rendering: `styles/grundriss/` | **Mandanten Phase 5:** `floor_plans` beim Export/Löschen eines Mandanten mitnehmen |
| Tipps der Gastgeberin | eigene Liste je Website (Ort, Kategorie, Weg/Gehzeit, Text, Foto, Karten-Link, Saison) | Liste mit Vignette je Kategorie | Bildwelt (Vignetten je Kategorie) |
| Gut zu wissen | strukturierte Felder an der Wohnung (Zugang, Dusche, Haustiere, An-/Abreise, Parken) – auch für Angebot/Mail/JSON-LD | Kartusche | – (klein) |
| Belegungs-/Preiskalender (nur ansehen) | vorhandene Daten (`AvailabilityChecker`, `PriceCalculator`) | Monatsansicht, Livewire oder statisch gerendert | – |
| Ein Tag an der Ostsee (Erzählstrecke) | Kapitel (Tageszeit, Text, Foto) | Scroll-Abschnitte, Bewegung nur ohne „reduce motion“ | Theme-Optionen |
| 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`. 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, abends · Branch `main` · Plan: [MANDANTEN-PLAN.md](MANDANTEN-PLAN.md) · Anforderungen: [MANDANTEN-ANFORDERUNGEN.md](MANDANTEN-ANFORDERUNGEN.md)
**Der Grundumbau (Phasen 1–5) ist fertig.** Offen bleiben Phase 6 (Marke und Bildwelt) und Phase 7 (mehrere Wohnungen je Website) – beide erst nach eigener Freigabe und einem Eintrag in ZUSAMMENARBEIT.md §6, weil sie den Vorlagen-Vertrag ändern. Nicht im Plan und offen: Subscription/Abrechnung und die Zertifikatsfrage bei Strato.
**Phase 3 ist ausgeliefert** (23.10.2026 abends). Die Migrationen sind auf der MariaDB von stommer.info durch, `settings` ist weg, die Werte stehen am Mandanten Stommer.
**Dienste-Steuerung und Host-Verwaltung sind ausgeliefert** (24.10.2026, Release `20261024072737`). Seitdem läuft stommer.info mit **zwei** Mandanten:
| | |
|---|---|
| Mandant 1 | `stommer` – die bestehenden Daten, Website „Ferienwohnung Stommer" |
| Mandant 2 | `testmandant` („Testmandant (Probe)") – **ohne Website und damit unter keiner Adresse erreichbar**. Das ist jetzt ein richtiger Zustand, kein Fehler: Einsprungsadressen vergibt der Betreiber, und dieser Mandant hat noch keine. Soll er erreichbar werden, braucht er eine Domain, die bei Strato auf dieses Verzeichnis zeigt. Betriebsart Test, Mails fallen auf `FEWO_NOTIFICATION_EMAIL` zurück. |
| Hosts | An der Website von Stommer stehen jetzt `stommer.info` (Hauptadresse) **und** `www.stommer.info`. Das war die Voraussetzung: ab dem zweiten Mandanten bekommt jede nicht eingetragene Adresse 404. |
| Geprüft nach dem Anlegen | `/`, `/wohnung`, `/buchen` auf beiden Hosts 200 und weiterhin Inhalte von Stommer; `/admin` und `/betreiber` 302. |
### Ausgeliefert
| | |
|---|---|
| Server | nur **stommer.info** (Staging). `www.fewo-stommer.de` ist unberührt und bleibt WordPress. |
| Release | `20261024152057`, Git-Tag `deploy/staging/20261024152057`, Commit `2c5b5fc` (**Phasen 1–5 vollständig**). Der Tag `20261024151841` zeigt auf denselben Commit – ein Deploy wurde wiederholt, weil die erste Ausgabe durch einen Absturz verloren ging. |
| Code danach | Commits auf `main` nach `2c5b5fc` sind Dokumentation. Sie sind nicht erneut ausgeliefert. Ein Deploy nur wegen dieser Texte ist unnötig: das Skript nimmt `docs/` nicht mit. |
| Migration | fünf Migrationen vom 23.10. sind auf der MariaDB von stommer.info durch. Vorhandene Zeilen gehören zum Mandanten **Stommer** (`slug` `stommer`); die Betriebsdaten stehen an dessen Spalten, `settings` ist weg. Ein zweites Migrieren legt keinen zweiten Stommer an, solange keine Zeile ohne Mandant übrig ist. |
| Sicherung davor | `C:\Dev\fewo-backups\staging\20261024-171534`; davor `…\20261024-102031`, `…\20261024-092543` und `…\20261023-215553` (die letzte mit noch vorhandener `settings`-Tabelle). Erstellt mit `scripts/backup-pull.sh staging`. 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 samt Vermieterdaten aus den Mandanten-Spalten. `/admin` und `/betreiber` leiten ohne Anmeldung auf die Login-Seite um (302). Betriebsart Testbetrieb, Umleitung an `lars@stommer.com`. **Noch nicht angemeldet geprüft:** die Seite System › Betrieb mit den neuen Abschnitten. |
| Prüfung (24.10., nach Phase 4/5) | `/`, `/wohnung`, `/buchen` auf beiden Hosts 200; `/admin` und `/betreiber` 302. `bookings:expire-holds` läuft nachweislich **je Mandant** („Stommer: 0 …“, „Testmandant (Probe): 0 …“). `tenants:export testmandant` einmal auf dem Server ausgeführt; Exporte landen über den Symlink in `shared/storage/app/private/exports` (überleben jeden Deploy) und sind aus dem Web mit 403 gesperrt. **Nicht geprüft:** `tenants:delete` auf echten Daten – es löscht Dateien. |
Die lokale Datei `database/database.sqlite` (`.env`: `DB_CONNECTION=sqlite`, `APP_URL=http://localhost:8000`) ist **nicht** vollständig migriert (die zwei Migrationen von Phase 3 stehen dort auf „Pending“). `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.
- Die Hosts stehen jetzt (`stommer.info`, `www.stommer.info`), und es gibt zwei Mandanten. Jede weitere Adresse muss **vor** ihrer Benutzung in Webseite › Website eingetragen werden, sonst 404. `is_default` rettet einen unbekannten Host nicht.
- `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.
- `config/fewo.php` bleibt die Grundlinie und die Obergrenze. Werte des Mandanten gehören in die Spalten von `tenants`, nicht in neue `.env`-Schlüssel.
- 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://<domain>/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}`. |
| `TenantConfig` (Phase 3) | Legt die Werte des Mandanten über `config('fewo.*')` und `mail.from`, sobald der Kontext gesetzt, gewechselt oder vergessen wird. Dadurch lesen Vorlagen, Mails und der Vertrag weiter dieselben Schlüssel, und `resources/themes/**` musste nicht angefasst werden. Die `.env` ist die Grundlinie. Ändert jemand von außen einen dieser Schlüssel (Test, Befehl), wird dieser Wert zur neuen Grundlinie statt beim nächsten Durchlauf überschrieben zu werden. |
| Grenzen (Phase 3) | Löschfristen und Bot-Schutz sind nach oben durch die `.env` gedeckelt (`AT_MOST`), die Mindestzeit im Formular nach unten (`AT_LEAST`); das Formular zeigt die Grenze an. Anzahlungsfrist, Bewertungsfrist und Portal-Fristen sind frei. Die Flutgrenze `spam.total_per_hour` bleibt global. |
| Betrieb (Phase 3) | Die Seite System › Betrieb schreibt jetzt den Mandanten des Kontextes (`Settings::tenant()`), nicht mehr die Tabelle `settings`. Sie enthält zusätzlich Vermieterdaten, Bank, Steuerangabe und die Fristen. Bank, Steuerangabe und Dienst-Schlüssel liegen über das `encrypted`-Cast verschlüsselt (`APP_KEY`). |
| Dienste (Phase 3) | `tenant_services` (Mandant, Schlüssel aus `App\Enums\TenantServiceKey`, an/aus, eigener API-Schlüssel) wird nur im Betreiber-Bereich am Mandanten-Formular geschaltet. `service_usages` steht bereit; es zählt noch nichts, weil kein Dienst aufruft. |
| `settings` | Entfernt. Modell `App\Models\Setting` gelöscht, `Settings::get/save` gibt es nicht mehr. |
| Läufe je Mandant (24.10.) | `App\Tenancy\TenantRunner` führt jeden Hintergrundlauf einmal je aktivem Mandanten aus, mit gesetztem Kontext (`routes/console.php` und die Befehle `bookings:expire-holds`, `channels:sync`, `channels:fetch-mail`). Ohne ihn sah der Scheduler bei zwei Mandanten **keinen** – Abfragen filterten nicht und der Absender fiel auf die `.env` zurück. Ein scheiternder Mandant hält die anderen nicht auf (Log-Eintrag). Die Datenbank-Sicherung bleibt global. |
| Postfach (24.10.) | Gehört dem Mandanten (`mailbox_*`, Passwort verschlüsselt, leerer Server = aus). Im Mandanten-Admin, sichtbar nur bei freigeschaltetem Dienst `portal_mail`. Die Cache-Schlüssel der Überwachung tragen den Mandanten. |
| Kündigung (24.10.) | `php artisan tenants:export <slug>` schreibt Zeilen und Dateien in ein Zip; `tenants:delete <slug>` exportiert erst, fragt nach und löscht dann einschließlich Medien. **Löschen ist bewusst keine Schaltfläche im Panel.** Konten, die nur zu diesem Mandanten gehörten, gehen mit; wer noch woanders arbeitet, und der Betreiber bleiben. Der Export nennt Konten mit Rolle, ohne Passwort-Hashes und ohne 2FA-Geheimnisse. Exporte liegen in `storage/app/private/exports` (nicht im Web, nicht in Git). |
| Dienste (24.10.) | `App\Tenancy\TenantFeatures` ist die einzige Stelle, die beantwortet, ob ein Mandant einen Dienst hat. Abgefragt in `RolePolicy::allows()` (damit in **jeder** Richtlinie des Admins), in `Channel::importsOccupations()`, im öffentlichen iCal-Feed und im Postfach-Schnellweg. Keine Rolle wiegt einen gesperrten Dienst auf. `TenantServiceKey::isWired()` trennt Gebautes von Geplantem: nur verdrahtete Dienste sind schaltbar, die drei KI-Dienste stehen als Hinweis. Eigene API-Schlüssel gehören später in den Admin des Mandanten, nicht zum Betreiber. |
| Einsprungsadressen (24.10.) | Gehören dem **Betreiber**: Mandanten-Formular › Einsprungsadressen, je Website eine Liste von Adressen. Die erste ist die Hauptadresse und steht in Gästelinks. Beim Anlegen entstehen Website, Host-Einträge und eine leere Startseite – ohne Startseite antwortet die Website 404. Im Mandanten-Admin sind die Adressen nur sichtbar. Eine fremde Adresse wird abgelehnt. Die Domain beim Hoster auf das Verzeichnis zu legen bleibt ein Schritt von Hand, auch bei Domains, die dem Mandanten gehören. |
| Links (24.10.) | `URL::forceRootUrl(APP_URL)` zwang **alle** Links auf einen festen Host – mit einem Mandanten unsichtbar, mit zwei Domains hätte jeder interne Link der zweiten Website auf die erste gezeigt. `ResolveTheme` setzt den Ursprung jetzt auf die **Hauptadresse der aufgelösten Website**. Wer über eine Nebenadresse kommt (`www`), bekommt trotzdem Links auf die Hauptadresse – ein kanonischer Host. |
| Gesperrter Mandant (24.10.) | Statt 404 eine schlichte Hinweisseite mit Status **503**, Text je Mandant einstellbar (sonst Standardtext). 503 hält die Seiten im Suchindex, weil eine Sperre vorübergehend ist. Gilt auch für `/admin` des Mandanten; der Betreiber kommt weiter hinein. |
| Systemweite Einstellungen (24.10.) | Betreiber › Einstellungen, gespeichert in `system_settings`: Löschfristen, Bot-Schutz, Flutgrenze, Sicherungen, Portal-Fristen, Versandweg, SMTP, harte Mail-Umleitung, Tokens. **Leer = der Wert der `.env` gilt wieder**, und zwar sofort. Geheimnisse liegen verschlüsselt. Datenbank-Zugang und `APP_KEY` sind nicht dabei und können es nicht sein: sie werden gebraucht, um die Datenbank zu öffnen und das Gespeicherte zu entschlüsseln. Betreiber › System bleibt die Übersicht (Mandanten, geltende Werte, Zugriffsprotokoll). |
| Noch global | Postfach, Absender des Scheduler-Laufs und der Scheduler selbst kennen keinen Mandanten (Rest von Phase 4). Der Cronjob auf Strato ist weiterhin nicht eingerichtet, der Versandweg ist `log`. Das ist mit einem Mandanten der bisherige Betrieb. Ein Mandant ohne eigene Adressen fällt für die Testumleitung auf `FEWO_NOTIFICATION_EMAIL` zurück, damit nichts versehentlich an echte Gäste geht. |
Tests dazu: `TenantIsolationTest`, `TenantAccessTest`, `WebsiteTenancyTest`, `TenantSettingsTest`, `OperationsModeTest`, `TenantServiceGateTest`, `TenantProvisioningTest`, `SystemSettingsTest`, `TenantScheduleTest` und `TenantSeparationTest` (alle in `tests/Feature`). Zuletzt 262 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
- Rest von Phase 4 und Phase 5. Jede davon bringt eigene Migrationen. Auslieferung und Migration wieder in einem Schritt, nach Sicherung.
- **Bankverbindung eintragen:** Die `.env` von stommer.info hat keine `FEWO_BANK_*`-Werte, deshalb sind Kontoinhaber, IBAN, BIC und Bank am Mandanten leer (wie vorher auch). Sie gehören jetzt in System › Betrieb › Bankverbindung und Steuer; `mail/partials/bank.blade.php` und der Vertrag zeigen den Block erst, wenn eine IBAN da ist.
- **Testmandant wieder loswerden,** wenn er nicht mehr gebraucht wird. Löschen ist erst Phase 5; bis dahin im Betreiber-Bereich den Zugang ausschalten.
- **Noch nicht am lebenden Server geprüft:** die Hinweisseite eines gesperrten Mandanten und das Anlegen einer Website über den Betreiber-Admin. Beides deckt die Testsuite ab, aber es fehlt eine Domain, unter der sich ein zweiter Mandant wirklich zeigen ließe.
- **Subscription** (was ein Mandant bucht, Abrechnung) ist noch nirgends abgebildet. `service_usages` steht als Grundlage bereit, es zählt nichts.
- **Vor jeder weiteren Adresse:** Jede Schreibweise ist ein eigener Host. Kommt `fewo-stommer.de` dazu, gehören `fewo-stommer.de` **und** `www.fewo-stommer.de` in das Feld „Weitere Adressen", sonst antwortet eine davon mit 404.
- Betreiber-Bereich https://stommer.info/betreiber einmal öffnen. Der Admin ist geprüft.
- 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.