37 KiB
Projektstand
Stand: 26.10.2026 · ausgelieferter Stand: deploy/staging/20261026072521 (abf0e90) · 285 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):
- Der Gast fragt unverbindlich an; der Zeitraum ist für die Haltezeit vorgemerkt.
- Die Vermieterin öffnet „Angebot senden“ und passt bei Bedarf Termin, Personen, Rabattcode, Preis, Gültigkeit, Nachricht und Gastdaten an.
- Der Gast erhält eine E-Mail mit Vertragsentwurf (PDF) und einem signierten Link.
- Auf der Angebotsseite nimmt er an (Annahmenachweis ohne IP) oder lehnt ab.
- 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.comist 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.shholt 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:testprü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 |
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
mainund auf stommer.info aktiv (Abschnitt 6). - Mandantenfähigkeit: Phasen 1 bis 5, die Anwendungsseite von Phase 6 und der Kern von Phase 7 sind ausgeliefert. Bausteine können eine aktive Wohnung ihrer Website wählen; leer = Hauptwohnung. 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.pngliegt bereit). - Content-Security-Policy: braucht wegen Livewire/Filament Nonces und einen sorgfältigen Test.
- Produktion
www.fewo-stommer.devorbereiten:- eigener Deploy-Ordner, Datenbank und
.env, - Umleitungen von der alten WordPress-Seite,
- echte Testbuchungen (GO-LIVE-CHECKLISTE.md).
- eigener Deploy-Ordner, Datenbank und
- 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)
- Cronjob einrichten; SMTP einschalten und mit
mail:testprü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). - Brigitte probt Anfrage → Angebot → Annahme mit einem eigenen Test (Angebotslink über die Aktion „Angebotslink“).
- Vor einem zweiten Mandanten den Host
stommer.infounter Webseite › Website eintragen. Sonst antwortet diese Adresse ab dann nicht mehr. - 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 (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) aufstyles/satz4/svg/logo-voll.svgumstellen. - 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: 26.10.2026 · Phase-7-Kern auf main und Strato · Plan: MANDANTEN-PLAN.md · Anforderungen: MANDANTEN-ANFORDERUNGEN.md
Ausgeliefert:
20261026072521, Commitabf0e90, aus aktuellemmainnachtest.fewo-stommer.de/(https://stommer.info). Sicherung davor:C:\Dev\fewo-backups\staging\20261026-082223(Datenbank und Dateien, 29 MB). Aktiven Pfad undREVISIONper SSH geprüft;/up,/,/wohnung,/buchenund/admin/loginliefern HTTP 200. Vor jedem weiteren Deploy sichern:bash scripts/backup-pull.sh staging /c/Dev/fewo-backups/staging, dannbash scripts/deploy.sh staging deploy(nur aus aktuellemmain).
Der Grundumbau (Phasen 1–5) ist fertig. Von Phase 6 ist die Anwendungsseite gebaut (Bildwelten, Marke je Website) – ohne eine einzige Theme-Datei zu ändern; der Rest ist ein Vertragsfall und steht als Aufgabe für die Theme-Sitzung in ZUSAMMENARBEIT.md §6: Favicon und die fest verdrahteten Grafiken in ostsee-licht auf $theme->brand() bzw. Plätze umstellen. Der Kern von Phase 7 ist ebenfalls umgesetzt und ausgeliefert. Nicht im Plan und offen: Subscription/Abrechnung und die Zertifikatsfrage bei Strato.
Phase 7: Kern umgesetzt und ausgeliefert
Ziel (A21): Ein Baustein kann eine Wohnung dieser Website wählen; ohne Wahl gilt wie heute die Hauptwohnung. Voraussetzung für die Bergwohnung unter fewo-stommer.de.
Ohne Theme-Änderung umgesetzt. Alle Bausteine haben im Seiten-Baukasten das gemeinsame Feld „Wohnung“ (data.property_id). Die Auswahl und ihre Validierung erlauben nur aktive Wohnungen der Website der bearbeiteten Seite. Leer bleibt die Hauptwohnung. Ein Eintrag in ZUSAMMENARBEIT.md §6 wird erst fällig, wenn neue Bausteine dazukommen (Übersicht aller Wohnungen, Suche über mehrere) – diese gehören nicht zum Kern und brauchen eine Pflicht-Vorlage im Basis-Theme.
Die Umsetzung:
app/Themes/Theme.php |
runForProperty(?Property, callable) setzt die Wohnung für einen Callback und stellt im finally beide bisherigen Cache-Werte wieder her, auch bei Verschachtelung oder Fehlern. |
app/Themes/SectionRegistry.php, PageForm |
Gemeinsames Auswahlfeld für jeden Baustein. Der Renderer prüft Website-Zugehörigkeit und Aktivität erneut; fremde, inaktive oder gelöschte Zuordnungen werden übersprungen, ohne auf eine andere Wohnung umzulenken. |
app/Themes/SectionView.php |
Die Ausgabe bleibt verzögert (render() wie bisher). Auch während Blade, Partials und Livewire laufen, ist die gewählte Wohnung aktiv; das gilt ebenso für die Bildwelt über den Theme-Kontext. Danach gilt wieder der vorherige Zustand. |
Tests: tests/Feature/SectionPropertyTest.php prüft in 13 Fällen gemischte Wohnungen auf einer Seite, Hauptwohnungs-Fallback, das Buchungsformular, verzögerte Ausgabe, verschachtelte Kontexte und Fehler sowie Speichern und Ablehnen im Admin über Website- und Mandantengrenzen. Gesamte Feature-Suite: 285 Tests, 1289 Assertions grün; Pint ausgeführt. Keine neue Tabelle, Migration oder Abhängigkeit. Deployment erfolgreich, keine Migration offen.
Gemeinsamer PipelineManager (26.10., Pilotanbindung auf feature/pipeline-manager-integration): Eigenes Repository Lars/PipelineManager, lokal C:\dev\pipelinemanager. Werkzeug-Image mit PHP/Composer/Node/Python/Git/SSH und gemeinsame Tests, Paketprüfung, Sicherung, Upload, Umschaltung und Rückfall. Nach dem Vorbild von Tsumugu baut der vorhandene Runner Raspi5-Paperless das Image im Docker; Anwendungen starten daraus ihre Aufträge. Image und Download-Caches werden wiederverwendet. FeWo liefert nur pipeline.toml mit Laravel-Befehlen und Zielen. Push develop → test.fewo-stommer.de/, Merge nach main → prod.fewo-stommer.de/; Produktion bleibt ausdrücklich gesperrt. Das leere Produktionsverzeichnis ist bereits angelegt, ohne .env oder Datenbank-Anbindung. Keine PHP-/Node-Installation mehr auf dem Host vorgesehen.
Der frühere lokale Paket-/Registry-Ansatz bleibt unveröffentlicht auf feature/artifact-pipeline und ist nicht Bestandteil der Pilotanbindung. Anwendung und Theme-Dateien unverändert. Pilot jetzt auf develop; eigener Pipeline-Schlüssel bei Strato autorisiert und privat ausschließlich außerhalb von Git bzw. als Gitea-Secret hinterlegt. Alle vier Deployment-Secrets sind eingerichtet. Die ersten Gitea-Läufe stoppten vor dem Upload: 4650 wegen PHP-Speicherlimit, 4651 wegen fehlender WebP-Unterstützung. Korrektur: FeWo-Tests mit 512 MB, neues Manager-Image 0.1.1 statt Änderung der freigegebenen Version 0.1.0. 18 Manager-Tests lokal grün. Verzeichnisse für Cache und Backups unter /home/lars/docker/pipeline-manager/, keine veröffentlichten Ports. Anleitung, Workflow-Vorlage und Agentenanweisungen im separaten Manager-Repository. Der tatsächliche Strato-Release steht oben; erfolgreicher Pilotnachweis wird nach Abschluss ergänzt. Tsumugu wurde ausschließlich gelesen.
Nicht vergessen: Jede neue Tabelle bekommt tenant_id von Anfang an und gehört in TenantArchive::DELETE_ORDER, sonst überlebt sie die Kündigung ihres Mandanten. tests/Feature/TenantSeparationTest.php merkt das – aber nur, wenn der Testaufbau dort die neue Tabelle auch füllt.
Ebenfalls offen
- Theme-Teil von Phase 6: Favicon und
partials/brandin beiden Themes auf$theme->brand()bzw. Plätze umstellen, Seebadsmotifs/-Ordner gegen die Bildwelt tauschen. Steht als Aufgabe in ZUSAMMENARBEIT.md §6 und gehört der Theme-Sitzung. - Subscription und Abrechnung – nicht Teil des Mandanten-Plans (§9 schließt sie aus).
service_usagesliegt als Grundlage bereit und zählt nichts. - Zertifikatsfrage bei Strato: Ob eine Domain eines Mandanten aufgeschaltet werden kann und ein Zertifikat bekommt. Eine Subdomain bekommt keines. Davon hängt ab, ob „Mandant bringt seine Domain mit“ auf diesem Hosting trägt – das ist keine Code-Frage.
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 | 20261026065920 (Phasen 1–5 plus Anwendungsseite von Phase 6). Frühere Tags desselben Tages: 20261024151841 und 20261024152057 zeigen auf denselben Commit – ein Deploy wurde wiederholt, weil die erste Ausgabe durch einen Absturz verloren ging. |
| Code danach | Commits auf main nach 361acfa 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\20261026-075730; davor …\20261024-171534, …\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. |
| Prüfung (26.10., nach Phase 6) | /, /wohnung, /buchen auf beiden Hosts 200 und weiter Inhalte von Stommer; /admin und /betreiber 302. image-worlds:check meldet die Bildwelt ostsee mit 11 Plätzen. Spalten image_world sind leer, also greift die Vorgabe der Installation: $theme->imageWorld() liefert ostsee, $theme->motif(‚divider‘) ein SVG von 1897 Zeichen mit aria-hidden. $theme->brand(‘logo‘) ist null – es wurde noch kein Logo hochgeladen, der Vertrag bleibt dadurch wie bisher. |
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_defaultrettet einen unbekannten Host nicht. users.rolenicht löschen. Die Mitgliedschaft intenant_usergilt; die Spalte bleibt der Übergang, wenn es genau einen Mandanten gibt und noch kein Kontext gesetzt ist.config/fewo.phpbleibt die Grundlinie und die Obergrenze. Werte des Mandanten gehören in die Spalten vontenants, nicht in neue.env-Schlüssel.- Filaments
Panel::tenant()undtenantDomain()nicht einschalten. - Produktion nicht ausliefern. Deploy nur aus aktuellem
mainmit grünen Feature-Tests (scripts/deploy.sh staging deploy). Dabei läuftmigratemit. 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. |
| Bildwelten (24.10.) | Pakete in resources/image-worlds/<key>/ (world.json + svg/), analog zu Themes. Website wählt, Wohnung darf überschreiben (A20). Vorlagen fragen über $theme->motif($slot, $class, $label) nach einem Platz, nie nach einer Datei (A19). Ein leerer Platz ist kein Fehler – es gibt dann keine Dekoration; php artisan image-worlds:check meldet Plätze ohne Datei. Die Ids im SVG werden je Aufruf eindeutig gemacht, sonst teilen sich zwei Kopien einer Grafik ihren Verlauf. Die Ostsee-Grafiken sind nach image-worlds/ostsee kopiert; resources/themes/seebad/motifs/ ist unberührt, bis die Theme-Sitzung umstellt. |
| Marke (24.10.) | Logo, Favicon und Logo für E-Mail/Vertrag als Medien der Website (A14/A22), gepflegt unter Webseite › Website › Marke. $theme->brand(...) für Vorlagen. Der Mietvertrag bettet die Datei ein statt eine URL zu holen. Ohne Logo bleibt alles wie bisher. Noch nicht umgestellt: Favicon und partials/brand in den Themes – §6. |
| 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
.envvon stommer.info hat keineFEWO_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.phpund 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_usagessteht als Grundlage bereit, es zählt nichts. - Vor jeder weiteren Adresse: Jede Schreibweise ist ein eigener Host. Kommt
fewo-stommer.dedazu, gehörenfewo-stommer.deundwww.fewo-stommer.dein 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.infoan der Website eintragen, bevor ein zweiter Mandant entsteht. Später ebensowwwundfewo-stommer.de, wenn die Produktion umzieht. - Brigitte, Cronjob, SMTP, Rechtstexte: Abschnitt 4, unverändert und unabhängig vom Mandanten-Code.