Files
fewo-stommer/docs/STATUS.md
T
LarsandClaude Opus 5.5 86f2d0aa07 Architekturplan: kontrolliert modulare Prozessarchitektur, Kanalkonfigurator, Prozess-Tester (Planung)
Bewertung, Fachmodulkatalog mit Verträgen, Prozessmodelle und Erweiterungspunkte
(Loyalty-Nachweis), Kanalkonfigurator, isolierter Prozess-Tester, Änderungsanalyse,
Migrations- und Umsetzungsplan sowie Management-Zusammenfassung. Keine Codeänderung.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 09:59:14 +01:00

409 lines
93 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
## Aktueller Stand (03.11.2026)
**Prozessarchitektur v0.11: integrierter MVP umgesetzt (Pakete U1–U6), automatisiert getestet, noch nicht auf dem Testsystem.**
| Branch | Inhalt | Stand |
|---|---|---|
| `main` | Produktion | unverändert |
| `develop` (Testsystem stommer.info) | v0.10 Pakete 1–9, Korrekturen vom 02.11. | ausgeliefert |
| `feature/aufenthalt` | zusätzlich v0.11-Spezifikation, Planung und MVP U1–U6 | **nicht** gemergt oder ausgeliefert; Auslieferung, Postfach und KI-Schlüssel stimmt der Betreiber vorher ab |
- **Kanalmanager:** „Kanäle“ mit eigener Webseite und Portalen; neue Einstellungen für Klärungsreservierung (15/180 min, 0 = keine), Rückfragemodus, Erinnerungen, Folgefragen, Linkgültigkeit, Anschrift im Formular.
- **Angebots-Gate:** Vor Angebot und Wunschbestätigung braucht es Name, E-Mail, vollständige Anschrift mit Land, Personenzahl und Zeitraum; das lässt sich nicht übergehen. Die Auskunft bleibt ohne Gate.
- **Fakteneingang:** jede Angabe mit Herkunft (`case_facts`); Abweichungen des Gastes werden Prüfaufgaben, Zeitraum und Personenzahl nur Änderungswünsche.
- **Klärungsreservierung** für unvollständige Anfragen; der Angebots-Hold ist unverändert.
- **Datenbeschaffung:** Rückfrage, Folgefrage, Erinnerung, signierter Ergänzungslink; Texte nach tatsächlichem Sperrstatus.
- **Posteingang:** eigenes Postfach im Modus „alle Nachrichten“, Zuordnung nach CH-13, Klärungsansicht.
- **KI-Auswertung:** kleines Modell → Regeln → Prüfmodell; nur geprüfte Angaben gehen über den Fakteneingang. Der Dienst ist je Mandant standardmäßig aus.
- **KI-Zugang:** Bring your own key je Mandant (Anthropic oder OpenRouter, Seite „System › KI-Anbindung“, Verbindungsprüfung), kein zentraler Schlüssel.
- **Tests:** 766 grün.
Dokumente:
- [Umsetzungsergebnis v0.11](Prozessarchitektur/Implementierungsstände/UMSETZUNGSERGEBNIS_V011.md) (Rückverfolgung, Entscheidungen, Einschränkungen, Go-live-Bedingungen);
- [Abnahme auf dem Testsystem](Prozessarchitektur/Abnahme/V011_ABNAHME_TESTSYSTEM.md) (Dienste, Konfiguration, Drehbuch);
- Planung: [Soll-Ist](Prozessarchitektur/Implementierungsstände/V011_SOLL_IST_ANALYSE.md), [Zielarchitektur](Prozessarchitektur/Implementierungsstände/V011_TECHNISCHE_ZIELARCHITEKTUR.md), [Umsetzungsplan](Prozessarchitektur/Implementierungsstände/V011_UMSETZUNGSPLAN.md).
- Nachfolgeplanung (04.11.2026, noch nicht umgesetzt): [Kontrolliert modulare Prozessarchitektur, Kanalkonfigurator und Prozess-Tester](Prozessarchitektur/Architektur/00_MANAGEMENT_ZUSAMMENFASSUNG.md) – Entscheidungen E1–E9 offen.
**Nächste Schritte:**
1. Abstimmung mit dem Betreiber: Auslieferung von `feature/aufenthalt` über `develop` auf das Testsystem (vier neue Migrationen), eigenes IMAP-Postfach, KI-Zugang des Mandanten unter „System › KI-Anbindung“ (Dienst vorher im Betreiberbereich einschalten).
2. Fachliche Abnahme nach dem Drehbuch, danach die Go-live-Bedingungen G1–G8.
3. Weiterhin aus v0.10: echte Mietbedingungen und Bank, Rechtsprüfung, Bedienprobe.
## Verlauf (historisch, neueste zuerst)
**Stand 02.11.2026:**
**Prozessarchitektur v0.10: Pakete 1–9 umgesetzt.**
| Branch | Inhalt | Stand |
|---|---|---|
| `main` | Produktion | unverändert |
| `develop` (Testsystem stommer.info) | Pakete 1–6 und 8 | ausgeliefert, Migration vom Betreiber als erfolgreich gemeldet |
| `feature/aufenthalt` | zusätzlich Pakete 7 und 9 | **nicht** gemergt oder ausgeliefert; Merge und Auslieferung nur nach Freigabe |
- **Paket 7:** Anfrage ohne Haltefrist → unverbindliche Auskunft → „Buchung anfragen“ → erneute Prüfung → automatisch oder von Hand bestätigt bzw. abgesagt.
- **Paket 9:**
- Vorbereitung: Anreisedaten, Aufgaben je Wohnung, gebuchte Leistungen.
- Während des Aufenthalts: Abweichungen und Folgeaufgaben am Vorgang.
- Getrennt „Aufenthalt abgeschlossen“ und „kaufmännisch abgeschlossen“; Nachläufer bleiben sichtbar.
- **Zahlungsstatus:** Nur Geld auf unserem Konto ändert ihn; Altbestand über `cases:recheck-payment-status`.
- **Testbetrieb:** über echtes SMTP nachgewiesen (T23).
- **Tests:** 700 grün.
Zur Bewertung ohne Code: [Prozessarchitektur/GESAMTABNAHME_v0.10.md](Prozessarchitektur/GESAMTABNAHME_v0.10.md), darin was den Produktivbetrieb blockiert und das Drehbuch der Bedienprobe. Weitere Dokumente: [UMSETZUNGSERGEBNIS_P7_P9](Prozessarchitektur/UMSETZUNGSERGEBNIS_P7_P9.md), [END_TO_END_ABNAHME](Prozessarchitektur/END_TO_END_ABNAHME.md) (T01–T25, getrennt nach automatisiert / Browser / Testsystem / Betreiber), [KONFIGURATION_UND_WIRKSAMKEIT](Prozessarchitektur/KONFIGURATION_UND_WIRKSAMKEIT.md).
**Nächste Schritte:**
1. Freigabe zum Merge nach `develop`, dann Abnahme auf dem Testsystem (MariaDB).
2. Echte Mietbedingungen und Bank eintragen, Texte freigeben, Rechtsprüfung der Gastschritte.
3. Bedienprobe mit der Vermieterin.
**Pakete 8, 5 und 6 der Prozessarchitektur v0.10 (01.11.2026, Branch `feature/abwicklung`, nicht ausgeliefert):** **Beträge und Zahlungen** – Zahlungen mit Art (Gast an uns / laut Portal ans Portal / Auszahlung Portal / Erstattung), Portalbeträge als Angaben mit Quelle (`case_amounts`), Übersicht `App\Pricing\CaseMoney` trennt Gastforderung, Portalzahlung, Auszahlung und Kontoeingang; R09 exakt erfassbar. **Ändern und Beenden** – `ChangeBooking` mit Folgenvorschau, „mit dem Gast vereinbart“ (Grundlage, Zeitpunkt) oder „dem Gast vorschlagen“ (signierter Link, Annahme mit Nachweis); ein Stornoweg mit Initiator, Grund, Kosten- und Erstattungsaufgabe; Portalbuchungen erst storniert, wenn im Portal bestätigt. **A6** – Eigene Nutzung, Besuch und Sperre als Vorgang („Neu“, Belegungsplan „+ eintragen“), Kurabgabe als Position (Satz an der Wohnung), Aufenthaltsbestätigung ohne Mietvertrag, keine Mahnung/Bewertung/Marketing; Altsperren per `cases:adopt-blocks` (Vorschau, `--apply`, `--revert`, Export identisch). **System › Wirksame Einstellungen** zeigt je Eingangsweg und Vorgang die angewandten Werte. **685 Tests grün** (inkl. Abnahmekatalog T01–T14). Dokumente: [UMSETZUNGSERGEBNIS_P5_P6_P8](Prozessarchitektur/UMSETZUNGSERGEBNIS_P5_P6_P8.md), [END_TO_END_ABNAHME](Prozessarchitektur/END_TO_END_ABNAHME.md), [KONFIGURATION_UND_WIRKSAMKEIT](Prozessarchitektur/KONFIGURATION_UND_WIRKSAMKEIT.md).
**Ein Eingang für alle Kanäle – Paket 4 der Prozessarchitektur v0.10 (03.11.2026, Branch `feature/eingang`, nicht ausgeliefert):** Portalbuchungen und -anfragen kommen über einen Eingang (`App\Channels\Intake\PortalIntake`, aufgerufen nach jedem Kalenderabgleich und aus `ProcessPortalMail`): sicher erkannte Buchungen (Buchungsmail mit Nummer, Kalenderregel „Reservierung dieses Portals“) werden zum Vorgang ohne Angebot/Annahme, Anfrage-Mails zur A2-Anfrage; Dubletten über Buchungsnummer → gleiches Portal mit gleichen Nächten → Spiegelung, nie nach bloßer Überschneidung; Unsicheres wird unter „Zu erledigen“ geklärt („Klären: Was ist das?“). Stornomail, verschwundener oder geänderter Kalendereintrag eines gebuchten Vorgangs → Aufgabe am Vorgang, keine stille Stornierung. Schalter je Kanal `channels.case_intake` (Aus = Standard, Beobachten, Anlegen, Anlegen + weiter); Eingangsprotokoll (System › Eingangsprotokoll, `channels:intake-report`); Bestandsübernahme `channels:adopt-occupations` (Vorschau, `--apply`, `--revert`). Portalaufgaben mit Nachweisstufe (veranlasst / im Portal gesehen / bestätigt). **662 Tests grün**, Browserprüfung durchgeführt. Ergebnis und Aktivierungsweg: [docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P4.md](Prozessarchitektur/UMSETZUNGSERGEBNIS_P4.md).
**Dokumentenzusammenstellung und Vorlagensteuerung – Paket 3 der Prozessarchitektur v0.10 (02.11.2026, Branch `feature/vorgang`, nicht ausgeliefert):** Vor jedem Dokument dieselbe Zusammenstellung (`App\Documents\DocumentComposer`, Ansicht `filament/document-composition`): Empfänger, Zeitraum, Preis mit Herkunft, Leistungen, Stornoregel, Vorlage mit Herkunft, Anlagen, Hinweise (fehlt / bitte prüfen / Info), E-Mail- und PDF-Vorschau. Dokumentart je Vorgang automatisch (`App\Enums\DocumentKind`): Anfrage → Angebot mit Annahmelink, eigene Buchung → Bestätigung mit Mietvertrag, beim Portal verbindlich (A3/A4) → **Buchungsunterlagen ohne Annahmelink** (`BookingDocumentation`). Unterlagen verbindlicher Vorgänge nur über `SendBookingDocuments` (automatisch nur ohne Prüfpunkte, von Hand mit bestätigten Hinweisen, einmalig per Sperre); Angebote mit `expected_version` gegen Doppelversand; ohne Vorreservierung (Hold 0) kein Angebot ohne ausdrückliche Entscheidung. Vorlagen haben Freigabe und „gibt nur Portalbedingungen wieder“ (entfallen bei Textänderung); die Buchungsunterlagen extern sind eine Arbeitsfassung bis zur Freigabe unter So arbeite ich › Dokumente. **648 Tests grün**, Browserprüfung durchgeführt. Ergebnis, offene Freigaben (FeWo-direkt-Vorlage FW-01, Unterlagentext) und Empfehlung Paket 4: [docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P3.md](Prozessarchitektur/UMSETZUNGSERGEBNIS_P3.md).
**Vorgangskern und geführte Vorgangsbearbeitung – Pakete 1 und 2 der Prozessarchitektur v0.10 (01.11.2026, Branch `feature/vorgang`, nicht ausgeliefert):** Die Buchung ist der einheitliche Vorgang (Eingangsart, Vorgangsart A1–A6, eingefrorenes Abwicklungsprofil, gespeicherter Verlauf `booking_events`); Gast, Personen und Preis dürfen unbekannt sein, keine Platzhalter-Gäste mehr. Einstellungen in Ebenen: System › **So arbeite ich** (Vermieterstandard) → Abweichung der Wohnung (Expertenansicht) → Abweichung je Portal und Buchungstyp → Vorgang (`App\Process\ProcessSettings`). Ein Übernahmeweg für beim Portal feste Buchungen (`TakeOverExternalBooking`, Portalpreis als eine Position) ersetzt „Portal-Buchung erfassen“ und die Logik von „Akte anlegen“. Startseite **„Zu erledigen“**, neue Vorgangsseite (Stand in einem Satz, „Als Nächstes“, Ablauf, Verlauf, Hauptknopf, Automatik/Freigabe, „Beenden“ nur über Storno), „Neu“-Dialog mit drei Einstiegen, Status von Hand nur im Expertenmodus. Migration übernimmt bisheriges Verhalten unverändert (Bericht `php artisan process:settings-report`). **634 Tests grün**, Pint. Ergebnis, Abnahmekriterien und offene Punkte: [docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P1_P2.md](Prozessarchitektur/UMSETZUNGSERGEBNIS_P1_P2.md). Vor dem Deployment: Migration auf dem Testsystem (MariaDB) prüfen, Bedienprobe mit der Vermieterin.
**Buchungsprozess – Übergabe an eine neue Session (30.10.2026, durch v0.10 und `feature/vorgang` weitgehend überholt):** Die Portal-Erweiterungen des Buchungsprozesses (Portal-Direktbuchung erfassen, „Akte anlegen“, Statuswechsel von Hand, Menü) wurden neben dem Angebotsablauf statt auf ihm gebaut und sind für den Betreiber nicht brauchbar. **Vor jeder Arbeit am Buchungsprozess `docs/UEBERGABE-BUCHUNGSPROZESS.md` lesen** (Anforderungen, Stand, Mängelliste, empfohlenes Vorgehen) und das Konzept dort mit dem Betreiber abstimmen, bevor Code entsteht.
**Hauptadresse und Abspielgeschwindigkeit (30.10.2026):** Weitere Adressen einer Website (z. B. www.stommer.info) leiten jetzt dauerhaft (301, nur GET/HEAD) auf die Hauptadresse (`Site.domain`) um (`ResolveTheme::toMainAddress`). Vorher lud die Seite unter www Skripte, Schriften und Videos von der Adresse ohne www – der Browser blockierte sie als fremde Herkunft: kein JavaScript (Titelvideo, Menü-Pfeile), Ersatzschrift. `Site::origin()` nimmt verbindlich das Feld `domain`. Videos haben eine **Abspielgeschwindigkeit** (Webseite › Videos, 0,5×–1×), die überall gilt, wo das Video läuft.
**Design Stufe 2 – Tipp-Karten, Galerie, Sommer/Winter (30.10.2026, Branch `feature/design-stufe2`):** Neuer Baustein **„Ausflugstipps (Karten zum Umdrehen)“** (`tips`: Ziel, Foto, Tipp, Weg, beste Zeit, Unterschrift; Knopf „Tipp lesen“, per Tastatur bedienbar, verdeckte Seite `inert`, bei „Bewegung reduzieren“ Überblenden; Seebad: Ansichtskarten mit Briefmarke). Neuer Baustein **„Sommer/Winter-Vergleich“** (`compare`: zwei Fotos vom selben Standpunkt, Trennlinie ziehen oder tippen, Pfeiltasten über verstecktes Schieberegler-Feld; einmaliger kurzer Schwenk beim Hinscrollen; beide Fotos unabhängig vom Erscheinungsbild). **Galerie:** Das Foto wächst aus dem Vorschaubild und schrumpft beim Schließen zurück, Blättern mit Pfeilen, Pfeiltasten und Wischen, „3 von 20“, Bildunterschrift (`caption`) – Dialog jetzt `partials/lightbox` (von `themes:check` geprüft). Mechanik in theme-base.css/theme.js, beide Themes. Lokal mit Bildschirmfotos (Desktop/Handy, Bewegung reduziert) geprüft. Echte Winterfotos und Tipp-Texte fehlen noch – im Admin einpflegen.
**Titelvideo, Rundgang, freie Termine, Buchungsseite (30.10.2026, Branch `feature/titelvideo-rundgang`):** Neue Verwaltung **Webseite › Videos** (`Video`: Datei bis 100 MB, Standbild, Kapitel mit Raum aus dem Grundriss; Upload-Grenzen von Livewire/Medienbibliothek auf 100 MB angehoben – vorher scheiterten schon Fotos über 10 MB). **Titelbereich:** „Video statt Foto“ (stumme Schleife, lädt nur ohne „Bewegung reduzieren“/Save-Data, Pause-Knopf) und „Nächste freie Termine“ (`App\Availability\NextFreeStays`: bis zu 3 buchbare, nicht überlappende Zeiträume mit Gesamtpreis, 10 Min. zwischengespeichert, Klick füllt die Anfrage vor; Seebad: Fahrkarten). **Neuer Baustein „Rundgang (Video)“** (Anordnung wählbar: volle Breite/Video links/rechts; Kapitel als Fahrplan; lädt erst beim Start); Grundriss-Räume mit Kapitel bieten „Im Rundgang ansehen“. **Buchungsseite:** Preis links unter dem Kalender, Formular rechts (auf großen Bildschirmen mitlaufend) – keine halbleere Seite mehr; Ablauf „Anfrage → Angebot → Annahme“ als Grafik (abschaltbar). **Seebad:** Sonnenaufgang des Trenners einmal beim Hinscrollen statt unmerklicher Dauerbewegung. Aus dem Agenturvideo (41,7 MB, Rechte bei Stommers) geschnitten: Titelschleife „Garten und Meer“ (9 s, 3,5 MB) und Rundgang (58 s, 14,5 MB) – liegen nicht im Repo, Upload über den Admin. Lokal mit Bildschirmfotos (Desktop/Handy) geprüft. Tests: **526 Feature-Tests grün**, Pint, `themes:check` beide Themes.
**Erinnerungen und Zusammenfassungen einstellbar (30.10.2026, Branch `feature/erinnerungen-zusammenfassung`):** Neuer Abschnitt System › Betrieb › **Benachrichtigungen** (Spalten auf `tenants`). „Offene Meldungen erneut senden“: nur einmal (Vorgabe), täglich, alle 2/3 Tage, wöchentlich – gilt für mögliche Doppelbuchungen (solange im Postfach ungelesen und weiter festgestellt; Lesen beendet die Erinnerung, `Inbox::reminderDue`) und offene Portal-Aufgaben (`RemindChannelTasks`). **Tägliche und/oder wöchentliche Zusammenfassung** (`SendDigests`, Scheduler alle 15 Minuten, ab wählbarer Uhrzeit, Wochentag wählbar; am Wochentag nur die Wochenübersicht) mit wählbaren Teilen (`DigestSection`, `DigestReport`): Postfach, offene Anfragen/Angebote mit Frist, Neues seit der letzten Übersicht (Anfragen, Buchungen, Stornierungen, Portalbuchungen), An-/Abreisen (heute+morgen bzw. 7 Tage), überfällige Zahlungen, Portal-Aufgaben/zu prüfende Portal-Mails/Kalender-Klärungsfälle/Abgleichsfehler, Bewertungen zur Freigabe. Leere Übersichten entfallen (abschaltbar), Knopf „Zusammenfassung jetzt senden“. Vorgabe: täglich 7 Uhr an, wöchentlich aus. Tests: **520 Feature-Tests / 2725 Assertions grün**, Pint. Seite nicht im Browser angesehen.
**Doppelbuchungs-Mails nur noch einmal, neues Postfach in der Verwaltung (30.10.2026, Branch `feature/postfach`):** Ursache der Mailflut: `SyncChannel` prüfte bei jedem Abgleich (alle 5 Minuten) alle importierten Belegungen erneut und schickte jede fortbestehende Überschneidung wieder per Mail. Jetzt meldet `ReportChannelConflicts` (Kalenderabgleich und Portal-Mail) jede Überschneidung einmal: Sie landet im neuen **Postfach** (Vermietung › Postfach, `InboxMessage`, Zähler der ungelesenen im Menü, gelesen/ungelesen, „Ansehen“ öffnet den Belegungsplan im betroffenen Monat) und nur neue Meldungen gehen per Mail. Doppelte Meldungen verhindert ein Fingerabdruck je Mandant (`App\Support\Inbox`, eindeutiger Index). Ändern sich Termine, ist es eine neue Meldung. Das Synchronisationsprotokoll zählt offene Konflikte weiter. Nach dem Deployment kommt jede noch bestehende Überschneidung einmal neu (Postfach war leer). Tests: **513 Feature-Tests grün**, Pint.
**Wohnungen, Bilder und Banner neu geordnet (29.10.2026, Branch `feature/wohnungs-kontext`):**
- **Wohnungsumschalter** oben im Verwaltungsmenü (`App\Support\CurrentProperty`, je Mandant in der Sitzung). Listen (Fotos, Ausstattung, Bewertungen, Grundrisse, Sperrzeiten, Kanäle, Portal-Aufgaben/-Mails, Importereignisse), neue Einträge, Belegungsplan und Preise & Angebote folgen ihm; die Buchungsliste startet mit dem Filter auf die Wohnung. Ein geöffneter Eintrag einer anderen Wohnung (z. B. aus einer Mail) schaltet um. Website: Galerie und Ersatz-Titelbild zeigen nur Fotos der Wohnung des Bausteins und Fotos ohne Wohnung.
- **Grundriss & Pläne:** eigene Fotokategorie, die keine Galerie zeigt; vorhandene Grundriss-Bilder wurden umgestellt. Ausgeblendete Planbilder funktionieren im Grundriss weiterhin.
- **Saisonfotos am Foto:** „Zeigen in“ (mehrere Erscheinungsbilder, leer = ganzjährig; auch als Sammelaktion). Saisonfotos erscheinen nur in ihren Erscheinungsbildern und dort zuerst. Galerie und Lage: „automatisch“ oder „eigene Auswahl“; Titelbereich und Abschluss zeigen das erste passende Foto ihrer Liste. Titelbild und „Bilder je Baustein“ am Erscheinungsbild entfallen (Daten in die Bausteine übernommen, Testsystem: Titelbild Foto 5 → Titelbereich der Startseite).
- **Banner & Hinweise:** ein Banner zur Zeit, je Website, optional nur in Erscheinungsbildern, mit Zeitraum und Priorität; kann ein Sonderangebot bewerben (Text/Termin/Link aus dem Angebot, verschwindet mit ihm). „Als Banner zeigen“ bei den Sonderangeboten; die Liste nennt das heute sichtbare Banner. Banner-Texte von Sommer, Weihnachten und Silvester wurden zu saisonalen Bannern.
- Tests: **508 Feature-Tests / 2654 Assertions grün**, Pint. Zwei Migrationen mit Datenübernahme (`give_photos_their_seasons`, `turn_notices_into_banners`), eine für Plan-Fotos. Offen: Promotion Engine (automatische Banner-/Angebotsvorschläge nach Saison, Lücken, Last-Minute) als nächste Stufe.
**Automatische iCal-Kalenderspiegelungen (29.10.2026, bereitgestellt):** Eindeutig per aktiver Regel erkannte zusätzliche allgemeine Belegtmeldungen ohne eigene Buchungsmerkmale werden einer einzigen führenden Portalreservierung eines anderen Kanals mit exakt gleichen Terminen zugeordnet. Keine Terminheuristik bei unbekannten Ereignissen, mehreren Quellbuchungen, widersprüchlichen Überschneidungen oder persönlichen Entscheidungen. Import und Regelanwendung prüfen die gesamte Wohnung; Kalender zeigt eine Belegung mit „Auch bei … gespiegelt“, geklärte Spiegelungen verschwinden aus Klärungsliste und Zähler. Neue Kennzeichnung `representation_automatic` trennt persönliche und automatische Zuordnungen. Nur automatische Verknüpfungen werden bei Änderungen, fehlender Quelle oder neuer Mehrdeutigkeit gelöst; weiterhin gemeldete Nächte bleiben intern belegt und vom Rückexport ausgeschlossen. Persönliche Entscheidungen bleiben erhalten. Konfliktprüfung erfolgt nach der Zuordnung, vermeidet falsche Doppelbuchungsmeldungen und erhält tatsächliche Konflikte. **198 relevante Tests / 1188 Assertions und Pint erfolgreich**, davon 24 neue Tests / 136 Assertions mit beiden Importreihenfolgen, Regelanwendung auf Bestand, Änderungen, fehlender Quelle/Wiederkehr, Buchungsmerkmalen, Mehrdeutigkeit und Mandantentrennung. Additive Migration, kein Bestandsumbau in der Migration. [Regeln und Lebenszyklus](architecture/ical-regelengine.md#führende-repräsentation-und-zuordnung). Mit `add2367` auf stommer.info bereitgestellt; Release `20261029160338-add23678`, Serverrevision und Migration in MariaDB-Batch 21 bestätigt. Private Sicherung 31.720.347 Bytes, Gesundheit/Anmeldung HTTP 200, Belegungsplan unangemeldet zur Anmeldung umgeleitet. Reguläre Importe danach um 17:05:04 MEZ (Destination) und 17:05:08 MEZ (FeWo-direkt) erfolgreich, kein Kanalfehler. Aktuell null automatische Zuordnungen: Der frühere zeitgleiche FeWo-Eintrag #4 ist archiviert; aktiver FeWo-Eintrag #15 endet am 01.01.2027, Destination #14 am 02.01.2027 (beide ab 27.12.2026). Unterschied bereits in gespeicherten Originalfeldern vorhanden (FeWo DTEND 20270101, Destination 20270102T120000), kein Parserfehler; daher bewusster Prüffall. Keine echten Testbelegungen angelegt oder Quelldaten passend gemacht. Keine zusätzliche visuelle Browserabnahme; Bedienung und Kalenderdarstellung mit Livewire geprüft.
**Abbruch beim Anwenden von iCal-Regeln korrigiert (29.10.2026, bereitgestellt):** Destination Solution rein lesend geprüft: Entwurf vorhanden, aktive Regeln leer; nachfolgender Import unterscheidet sich von der Vorschau nur in DTSTAMP, bei gleichen Terminen und gleichem Regelergebnis. Bisher blockierte die Prüfung auf veraltete Originaldaten auch diese reine Zeitstempeländerung; die Validierungsnachricht blieb hinter dem Bestätigungsdialog unsichtbar. Reine DTSTAMP-/LAST-MODIFIED-Änderungen werden jetzt nur bei vollständig gleichem Regelergebnis toleriert, neueste importierte Originale bleiben erhalten. Fachliche Änderungen oder ein durch Zeitstempel geändertes Regelergebnis verlangen weiterhin eine neue Vorschau. Validierungsabbrüche schließen den Dialog, zeigen eine dauerhafte Meldung und behalten die Formulareingaben; gespeicherter Regelstand wird nach dem Transaktionsrückbau neu geladen. Erfolg schließt die Bestätigung und aktualisiert den aktiven Regelstand. **174 relevante Tests / 1052 Assertions und Pint erfolgreich**, darin 41 Regelengine-Tests / 289 Assertions und sieben zusätzliche Fälle mit tatsächlichem Öffnen und Bestätigen des Dialogs, Aktualisierungsrennen, fehlerhafter Extraktion und Formularvalidierung. Keine echten Kanalregeln aktiviert, keine Kalenderdaten zusammengeführt; identische Tage allein bleiben kein Identitätsnachweis. [Befund und Bedienung](architecture/ical-regelengine.md#vorschau-entwurf-und-aktivierung). Mit `a0497fc` über den vorhandenen PipelineManager bereitgestellt; Release `20261029152758-a0497fcc`, Serverrevision, private Sicherung (31.620.399 Bytes) und HTTP 200 für Gesundheit/Anmeldung bestätigt. Neue Regelseite unangemeldet zur Anmeldung umgeleitet. Die ausgelieferte Zeitstempelprüfung zusätzlich rein lesend gegen den echten Destination-Bestand ausgeführt: akzeptiert; Entwurf erkennt Portalreservierung/Führungskandidat. Aktive Regeln weiterhin leer, keine persönliche Anwendung vorweggenommen. Keine neue Migration oder zusätzliche visuelle Browserabnahme. Gitea-Status-API HTTP 401; Auslesen gespeicherter Git-Zugangsdaten dafür durch automatische Freigabeprüfung abgelehnt und nicht ausgeführt. Deployment über vorhandene SSH-Zugänge und aktive Serverrevision bestätigt, kein ungeprüfter API-Erfolgsstatus behauptet.
**iCal-Kompatibilität für fehlenden DTSTAMP (29.10.2026, bereitgestellt):** Ferienundwohnen-Feed liefert elf Ereignisse ohne DTSTAMP, aber mit gültigem ereignisbezogenem UTC-LAST-MODIFIED. Ablehnung mit neuem Test reproduziert; Parser verwendet LAST-MODIFIED nur bei vollständig fehlendem DTSTAMP als Ersatzprüfung. Leere/ungültige vorhandene DTSTAMP, unbrauchbare oder doppelte Zeitstempel und beschädigte Feeds bleiben abgewiesen. Keine künstlichen Originalfelder, keine geänderte UID-/Datums- oder Stornologik. **101 relevante Tests / 530 Assertions und Pint erfolgreich**, darunter zehn zusätzliche ungültige Profile sowie Importwiederholung und Datumsänderung mit fehlendem DTSTAMP. Echte, Git-ignorierte Originaldatei separat ohne Datenbankzugriff lokal erfolgreich gelesen: elf Ereignisse/Belegungen, erste Anreise/Abreise 10.–24.11.2026, letzte 03.–10.10.2027. Vorhandene Verbindung 5 hat den Import derzeit ausgeschaltet; nicht aktiviert und keine echten Belegungen importiert. Mit `2ae48e7` durch [Pipeline 4698](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4698) erfolgreich bereitgestellt; gesamte Feature-Suite, Build, Sicherung und Deployment erfolgreich, Release `20261029150456-2ae48e77`, Serverrevision und Gesundheitscheck HTTP 200 bestätigt. Anschließender echter Abruf auf Strato über ICalConnector und Parser erfolgreich: elf Ereignisse/Belegungen, elf eindeutige UIDs, alle Originale ohne DTSTAMP und mit LAST-MODIFIED. Verbindung 5 weiterhin Import aus, null Bestandszeilen vor/nach dieser rein lesenden Prüfung. Keine Migration und kein manueller Bestandsimport. [Kompatibilitätsgrenze](architecture/ical-kanalkonfiguration.md#6-import-änderungen-und-entfernung).
**iCal-Regelbearbeitung präzisiert (29.10.2026, bereitgestellt):** Dauerhafter Kopfbutton „Entwurf speichern“, eindeutiges „Speichern & anwenden“, sichtbarer Unterschied zwischen gespeichertem und aktivem Regelstand sowie direkte Links der Regelvorschau zu importierten Einträgen und zeitgleichen Kandidaten. Hinweise erklären die notwendige Textextraktion für vollständige Gastnamen und die persönliche Zuordnung weiterer Kalenderdarstellungen. Lesender Befund: Destination-Solution-Regel nur als Entwurf, keine aktive Regel und keine Namensextraktion; dadurch unbekannte Einordnung trotz treffender Vorschau. Ein zeitgleicher FeWo-direkt-Eintrag vorhanden, keine automatische Zusammenführung durchgeführt. Keine tatsächlichen Kalenderdaten oder Kanalkonfigurationen geändert. **136 relevante Tests / 779 Assertions erfolgreich**, darunter wiederholtes Speichern und eine synthetische Primärquelle mit vollständigem Namen, separater Kalenderdarstellung und bestätigter Zuordnung. Mit `54efd3b` durch Pipeline 4692 erfolgreich auf stommer.info bereitgestellt, Release `20261029144115-54efd3b8`; vorherige Bereitstellung 4691 ebenfalls erfolgreich. Gesamte Feature-Suite, Build, Sicherung und Deployment erfolgreich; 46 Regelengine-/Zuordnungsprüfungen mit 266 Assertions nach der abschließenden Dialogpräzisierung ebenfalls lokal erfolgreich. Serverrevision, neue Statusmethode und Gesundheits-/Anmeldeseite bestätigt; keine zusätzliche visuelle Browserabnahme. Deployment ohne neue Migration. DS-Import nach Bereitstellung um 15:40:04 MEZ erfolgreich; gespeicherte Regel weiterhin bewusst Entwurf, keine Aktivierung oder Zusammenführung durch den Agenten. Build vorab bei rund 2,5 GB verfügbarem RAM und unterstützten Docker-Speicherlimits geprüft, vorhandene Pipeline mit 2 CPUs / 2 GB verwendet; n8n während des Builds HTTP 200. [Bedienung und Befund](architecture/ical-regelengine.md#mehrere-kanäle-mit-unterschiedlichen-richtungen).
**Repository-Sichtung und Dokumentationsabgleich (29.10.2026):** 30 bislang offene Dateien fachlich gruppiert: Architektur-/Vermietungskonzept, Betriebsnachweise, lokales iCal-Vergleichswerkzeug sowie Grundriss- und SVG-Entwürfe. Verweise der inzwischen mit `Konzept_` benannten Dateien berichtigt; bekannte Änderungen der Belegungsverwaltung und des Schedulers in den älteren Bestandsübersichten abgegrenzt. Keine offenen Änderungen am PHP-/Frontend-Anwendungscode. Lokales Vergleichsskript mit zwölf synthetischen Fällen ohne Netzwerk-/Anwendungszugriff geprüft; Grafiken auf Lesbarkeit und SVG-Struktur geprüft. Versionierung auf `feature/ical-portalkanaele`, ohne Zusammenführung nach `develop` oder Deployment.
**Pi nach n8n-Test wieder erreichbar, Upgrade nicht angewandt (28.10.2026):** Lars hat den isolierten Testcontainer über Portainer gestoppt; anschließend SSH, n8n (`/healthz` und Bereitschaft HTTP 200) und Portainer (HTTP 200) wieder erreichbar. 58 Container laufen; kein vorhandener Docker-Healthcheck meldet „unhealthy“. Das ist keine vollständige Funktionsprüfung sämtlicher Anwendungen. Produktives n8n und Portainer ohne zusätzlichen Containerneustart, n8n weiter auf ursprünglichem Image / Version 2.7.5. Gestoppten Testcontainer anschließend gezielt entfernt, isoliertes Testvolume und private Sicherung behalten. Hostprüfung: rund 8 GB RAM, Swap fast vollständig belegt, aktuell keine Swap-Aktivität in der vmstat-Stichprobe; Docker meldet ausdrücklich **keine Unterstützung für Memory-/Swap-Limits**. Keine Kernel-OOM-Kill-Meldung im geprüften Zeitraum, daher Ressourcen-/Swapüberlastung als Befundzusammenhang, keine behauptete eindeutige Kernelursache. Fehlende Ressourcenprüfung vor dem parallelen Test war ein Fehler des Agenten. Keine weiteren Tests oder produktives Upgrade gestartet. Automatischer Kalenderimport auf stommer.info um **09:55:04 MEZ** wieder erfolgreich, kein aktueller Kanalfehler. Historische Störungsnotiz folgt unten; [Wiederherstellung und verbleibender Upgradebedarf](BETRIEB.md#n8n-upgradeversuch-und-wiederherstellung-28102026).
**n8n-Upgrade begonnen, Pi-Zugang gestört (28.10.2026):** Installation nachgewiesen: Raspberry Pi `raspberrypi5` / `192.168.2.49`, Debian 12 aarch64, Docker 28.3.1 / Compose 2.38.1, Container `n8n`, Compose `/home/lars/n8n/docker-compose.yml`, installiert 2.7.5. Offiziell stabilen Zielstand 2.45.5 über npm-Tags und GitHub bestätigt und Image geladen. Konsistente SQLite-Sicherung samt Konfiguration, Verschlüsselungsschlüssel und Erweiterungen unter `/home/lars/n8n-backups/upgrade-20261028T080618Z`; 30 Workflows, 3 aktiv, 9 Zugangsdaten, Integrität ok. Isolierte Datenkopie mit deaktivierten Workflows, ohne Netzwerk/Portfreigabe und ohne produktiven `/mindnet`-Mount im Testcontainer `n8n-upgrade-test-20261028t080618z` gestartet; Gesundheits- und Bereitschaftsprüfung HTTP 200. Weitere Prüfungen konnten nicht abgeschlossen werden: Pi reagiert auf Ping, aber SSH, n8n und Portainer hängen. Ressourcenengpass vermutet, noch nicht nachgewiesen; Testcontainer wurde ohne Speicherlimit gestartet. Wiederholte gezielte Stoppversuche scheitern bereits beim SSH-Verbindungsaufbau. **Produktives Compose und Originaldatenvolume wurden nicht auf die neue Version umgestellt.** Lokaler Konsolen-/Containerzugang beim Nutzer angefragt, um zunächst nur den Testcontainer zu stoppen. Upgrade, abschließende Bestandsprüfung und Wiederherstellung des Dienstzugangs offen. Kein erfolgreicher Upgradeabschluss behauptet. [Details und Stoppbefehl](BETRIEB.md#n8n-upgradeversuch-und-wiederherstellung-28102026).
**Entscheidung n8n nur intern (28.10.2026):** Lars benötigt aktuell keinen externen Zugriff. Ziel ist daher die ausschließliche Verwaltung im Heimnetz über den vorhandenen HTTPS-Proxy auf dem NAS, ohne dauerhaften SSH-Tunnel oder öffentliche n8n-Portfreigabe. Für die bestehende Zertifikatsadresse ist eine interne Namensauflösung `privat.stommer.com → 192.168.2.63` vorzusehen. Die zwischenzeitlich eingerichtete öffentliche Firewallfreigabe wurde durch den Agenten noch nicht wieder geschlossen; auch lokale DNS-/Routerregeln wurden nicht verändert. Kostenpflichtige zentrale 2FA-Erzwingung ist von persönlicher Konto-2FA zu unterscheiden. Aktualisierung des veralteten n8n-Patchstands bleibt auch bei interner Nutzung offen.
**n8n extern erreichbar, Absicherung offen (28.10.2026):** Lars hat den NAS-Firewallport freigegeben und bestätigt den externen Zugang; HTTPS-Startseite und Gesundheitsprüfung HTTP 200, drei geprüfte Workflow-/Credential-/API-Endpunkte ohne Anmeldung HTTP 401. Die zuvor vermutete Firewallblockade ist damit nachvollzogen. Lesend installierte Version **2.7.5** bestätigt; diese liegt in betroffenen Bereichen veröffentlichter Hersteller-Sicherheitsmeldungen. Konkrete Workflow-Ausnutzbarkeit nicht geprüft. Persönliche 2FA ist laut Nutzer aus beziehungsweise unklar; Zugriff bisher nur durch Lars benötigt. Empfehlung: Verwaltung vorerst über Tunnel/VPN begrenzen, anschließend gesichertes Update und 2FA; öffentliche Webhooks später getrennt planen. Keine Absicherungsmaßnahme oder Aktualisierung bereits umgesetzt. Der ausgehende Fewo-Scheduler benötigt keine öffentliche n8n-Verwaltung. [Prüfumfang und Quellen](BETRIEB.md#zugang-zur-n8n-oberfläche-27102026). Der folgende Diagnoseabschnitt beschreibt den Zustand vor der Firewallfreigabe.
**n8n-Zugangsdiagnose ergänzt (28.10.2026):** n8n auf dem Pi läuft; fehlenden lokalen SSH-Tunnel wieder gestartet, Startseite `http://localhost:15678/` HTTP 200. Öffentlicher HTTPS-Zugang wird über das Synology-NAS geführt: NAS `192.168.2.63:5678` aus dem Heimnetz mit passendem gültigem Zertifikat für `privat.stommer.com` und n8n HTTP 200 geprüft. Die zuvor vermutete fehlende TLS-Einrichtung betrifft nicht das NAS. Öffentlich weiterhin IPv4-Zeitüberschreitung / IPv6-Verbindung abgewiesen. Lars bestätigt FRITZ!Box-Weiterleitung zum NAS; gezeigte Firewall erlaubt Heimnetz vollständig, externe Port-5678-Freigabe nicht erkennbar. Exakter Weiterleitungszielport, vollständige erste Dienstregel und externe Abnahme bleiben zu prüfen; Firewallursache noch nicht abschließend bestätigt. Keine Server-/Router-/NAS-Konfiguration geändert. Details und Abgrenzung zum früheren Befund in [BETRIEB.md](BETRIEB.md#zugang-zur-n8n-oberfläche-27102026).
**Zweck und Privat-Kanal bei Sperrzeiten ergänzt (27.10.2026, bereitgestellt):** Eigene und ausdrücklich als Sperrzeit eingeordnete importierte Einträge erhalten einen strukturierten Zweck (Eigenbelegung, Wartung / Renovierung, Sonstige Sperre), einen persönlichen Hinweis und die fachliche Kanalwahl Privat. Bei Importen direkt in der Sperrzeitenliste über „Belegungsart / Zweck bearbeiten“ sowie in den Details; eigene Sperren im normalen Formular und im Wohnungsbereich. Darstellung in Liste, Details und Belegungsplan. Importquelle und Ereignisidentität bleiben getrennt erhalten; Rückexport an den Importkanal weiterhin ausgeschlossen. Persönliche Angaben überstehen spätere Importänderungen, vorhandene Einträge werden nicht automatisch neu eingeordnet. Additive Migration `2026_10_27_222110_add_business_purpose_to_blocked_periods`; Rückbau würde die neuen Angaben verwerfen. **155 relevante Tests / 837 Assertions erfolgreich, darunter acht neue Fälle; Pint erfolgreich.** Mit `4389894` durch [Pipeline 4673](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4673) erfolgreich bereitgestellt; gesamte Testsuite, Build, Sicherung und Deployment erfolgreich. Release `20261027212859-43898949`, Serverrevision und MariaDB-Migration in Batch 20 bestätigt. Gesundheitscheck und Anmeldung HTTP 200; Sperrzeiten unangemeldet zur Anmeldung umgeleitet. Keine echten Testbelegungen angelegt und kein manueller Kalenderimport ausgelöst. Keine zusätzliche visuelle Browserabnahme.
Stand: 27.10.2026 · **Zentrale Belegungsverwaltung auf stommer.info bereitgestellt**, Anwendungskommit `4389894`, Release `20261027212859-43898949`, [Pipeline-Lauf 4673 erfolgreich](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4673). Visuelle iCal-Regelengine zuvor mit `7c7955b` bereitgestellt.
> Dieses Dokument ist der Einstieg für jede neue Arbeitssitzung. Bitte bei größeren Änderungen fortschreiben (Abschnitte „Fertig“, „Offen“, „Nächste Schritte“).
**Vollständige Gästeanlage im Zuordnungsdialog (27.10.2026):** „Gast zuordnen → Neuen Gast anlegen“ bietet dieselben Kontakt- und Adressfelder wie die Gästekartei, zusätzlich Notizen und Markierungen. Ein erneuter Aufruf der Gästekartei entfällt für die Ersterfassung. Speicherung und Validierung in `AssignOccupationGuest` um diese Angaben erweitert; Auswahl bestehender Gäste überschreibt deren Stammdaten nicht. Keine Schemaänderung oder automatische Änderung vorhandener Gäste. **44 relevante Tests / 265 Assertions erfolgreich, Pint erfolgreich.** **Mit `78aafd7` durch Pipeline 4672 erfolgreich bereitgestellt**, einschließlich gesamter Feature-Suite, Build, Sicherung und Deployment. Serverrevision und Release `20261027211550-78aafd7c` bestätigt, `/up` und Anmeldung HTTP 200. Keine neue Migration oder Anlage echter Testgäste. Bedienung über Livewire geprüft; keine zusätzliche visuelle Browserabnahme behauptet.
**Zentrale Belegungsverwaltung bereitgestellt (27.10.2026):** Belegungsplan je Wohnung mit Monats-/Mobilansicht, freien Nächten, Wechseln, Kanal, Gast und Status; gemeinsame Liste eigener Anfragen/Buchungen und erkannter Portalreservierungen; plattformübergreifende Gästezuordnung und gemeinsame Aufenthaltshistorie. Sperrzeiten auf ausdrückliche Sperren begrenzt, eigener Klärungsbereich mit Originaldaten und persönlicher Einordnung. **Entscheidung Lars: Gastzuordnung bei Portalreservierungen zunächst offen lassen**, keine automatische Anlage anhand eines Namensfragments. Fehlende Kontaktdaten sind erlaubt, Mailabläufe entsprechend abgesichert; Portalaufenthalte werden bei Anonymisierung und Stammgast-Auswahl berücksichtigt. Importidentitäten, Datumslogik und Herkunftsschutz weiterverwendet, keine automatische Datumszusammenführung oder erfundene Preis-/Vertragsdaten. Additive Zuordnungsfelder und nullable Gast-E-Mail in Migration `2026_10_27_212523_add_guest_assignment_for_portal_occupations` in MariaDB-Batch 19 bestätigt. [Fachliche Bedienung und Grenzen](architecture/ical-kanalkonfiguration.md#zentrale-belegungsverwaltung). **433 Feature-Tests / 2063 Assertions lokal erfolgreich, darunter 24 neue Prüffälle; Pint und Vite-Build erfolgreich.** Bestehende Herkunfts-/Synchronisations- und Buchungsworkflow-Tests grün. Pipeline 4671 mit Tests/Build, Sicherung und Deployment erfolgreich, finale Serverrevision `f19d698` und Release `20261027205911-f19d6982` bestätigt; vorausgehende Bereitstellung 4670 ebenfalls erfolgreich. Vorher-/Nachher-Prüfung: 2 eigene Buchungen, 11 Kalenderereignisse und 2 Gäste; Bestandsfingerprint und Export bytegleich. Bei dieser Abnahme 3 Portalreservierungen, 8 ungeklärte Belegungen und keine ausdrückliche Sperre; damals alle Portal-Gastzuordnungen offen. Automatischer Import auch mit der finalen Version um 22:00:04 Uhr erfolgreich. Sperrgründe im Plan und Link zur zugeordneten Gästekartei ebenfalls bereitgestellt. Öffentliche Gesundheits-/Wohnungsseite HTTP 200, neue Verwaltungswege unangemeldet zur Anmeldung umgeleitet. Tokenfreier lokaler Vorher-/Nachher-Nachweis Git-ignoriert: `storage/app/private/occupancy-management/result.json`. Keine zusätzliche echte Browser-Sichtprüfung behauptet; Bedienabläufe mit Livewire-Interaktionstests geprüft.
**n8n-Oberfläche wieder zugänglich (27.10.2026):** n8n läuft durchgehend; Port 5678 bietet intern HTTP, keinen direkten HTTPS-Zugang. Die zuvor aus der Konfiguration übernommene öffentliche HTTPS-Adresse war als Zugangslink nicht funktionsfähig. Temporären SSH-Tunnel ausschließlich an `127.0.0.1:15678` eingerichtet; http://localhost:15678 und Workflowroute mit HTTP 200 geprüft. **Lars bestätigt die erfolgreiche Anmeldung.** Serverkonfiguration, Zertifikate, n8n-Konten und Secure-Cookie-Einstellung unverändert. Der Tunnel gilt nur auf diesem Arbeitsplatz und solange er läuft; dauerhafter öffentlicher HTTPS-Zugang bleibt ungeklärt. Lokale Workflowlinks unten setzen diesen Tunnel voraus. Wiederherstellung und Diagnose: [BETRIEB.md](BETRIEB.md#zugang-zur-n8n-oberfläche-27102026).
**Externer Scheduler aktiv (27.10.2026):** Lars hat den [n8n-Workflow „FewoPortal Scheduler (stommer.info)“](http://localhost:15678/workflow/23581e4b70324812) veröffentlicht. Veröffentlichte Version und aktiver Zeitplan lesend bestätigt. n8n auf dem Pi ruft den Scheduler auf stommer.info minütlich auf; Kalenderimporte sind alle fünf Minuten fällig. **Zwei aufeinanderfolgende automatische Importe am 27.10. um 20:55:03 und 21:00:03 Uhr MEZ nachgewiesen**, exakt 300 Sekunden Abstand; jeweils 11 Ereignisse, erfolgreich, keine neuen, geänderten oder entfernten Belegungen und keine Konflikte. Prüfung ausschließlich lesend, kein zusätzlicher manueller Abgleich. Letzter Erfolg am Kanal und Fehlerfreiheit bestätigt. Verschlüsselte Header-Auth-Zugangsdaten eingerichtet, tokenfreie [Workflowvorlage](../scripts/n8n-fewo-scheduler.json) im Repository. Der erfolgreiche einmalige Verbindungstest von 20:42:47 Uhr bleibt vom Nachweis automatischer Importe getrennt. Browser und lokaler SSH-Tunnel sind für den automatischen Betrieb nicht erforderlich; Pi und n8n müssen laufen und stommer.info erreichen können. Details in [BETRIEB.md §6](BETRIEB.md#6-erledigt--offen-im-testbetrieb); tokenfreier lokaler Nachweis Git-ignoriert unter `storage/app/private/n8n-scheduler/setup-result.json`.
**Visuelle iCal-Regelengine bereitgestellt (27.10.2026):** Echte Kalenderanalyse mit Originalfeldern, Beispielen, Häufigkeiten und Textpräfixen; Regeleditor mit UND/ODER, Literalvergleichen, Priorität und einfacher Textextraktion; Live-Vorschau, getrennte Entwurfs-/Aktivierungsstufen und Neuauswertung vorhandener Einträge ohne neue IDs oder Termine. Fachliche Führungskandidaten unterstützen die persönliche Zuordnung, ohne automatische Datumszusammenführung. Exportzuordnung nach SUMMARY/DESCRIPTION/LOCATION und ausdrückliche Namensfreigabe je Zielkanal. Originale und Interpretation verschlüsselt gespeichert. **409 Feature-Tests / 1935 Assertions lokal erfolgreich, darunter 32 neue Fälle; Pint und Pipeline 4669 erfolgreich.** Additive Migration `2026_10_27_183425_add_ical_analysis_rules_and_event_metadata` in MariaDB-Batch 18, Serverrevision/Release bestätigt. Reale FeWo-direkt-Analyse: **38 Ereignisse, 9 Portalreservierungen, 29 Sperren**, davon 11 zukünftig (3 Reservierungen, 8 Sperren). Beide Regeln als normale Daten aktiviert; 11 vorhandene Einträge ohne geänderte IDs, UIDs, Termine oder Zuordnungen neu klassifiziert. Ostseeklar-Export HTTP 200 mit 11 Ereignissen, davon 3 mit freigegebenen Namensbestandteilen in SUMMARY/DESCRIPTION; Export-IDs/-Zeiträume identisch. **Nutzerbeobachtung: Ostseeklar zeigt weiterhin nur „Belegt“ und bietet für importierte Einträge keine Detailansicht; die gewünschte Namensanzeige ist bisher nicht erreicht.** Eine Prüfung der Textübernahme über Eintragsdetails entfällt; die Unterstützung durch den Portalimporter ist noch zu klären. Weitere GET-Abrufe mit HTTP 200/live sind protokolliert, lassen sich anhand der Clientkennung aber nicht sicher Ostseeklar zuordnen. Ursache und Verarbeitung der Textfelder im Zielportal bleiben offen; keine persönliche Portalbestätigung gesetzt. Browserwerkzeug nicht startbar, daher keine zusätzliche echte Browser-Sichtprüfung behauptet. [Bedienung, Datenabgleich und Grenzen](architecture/ical-regelengine.md). Praktischer Nachweis ohne Namen/Token lokal Git-ignoriert: `storage/app/private/ical-regelengine/real-practical-result.json`.
**iCal-Bereich fachlich abgegrenzt und bereitgestellt (27.10.2026):** Menü und Wohnungsbereich heißen **„Kalenderabgleich (iCal)“**, Datensätze und Anlage **„iCal-Verbindung“**. Übersicht und Formular erklären den Umfang als Austausch von Belegungszeiträumen; weitere Funktionen eines Portals benötigen eigene Anbindungen. Route `/admin/channels`, Daten, Token und Synchronisationsverhalten bleiben erhalten. **66 relevante Tests / 336 Assertions erfolgreich, Pint erfolgreich.** Pipeline 4667 mit Build/Tests/Sicherung/Deployment erfolgreich; Server-REVISION `8927f2e` und Release bestätigt.
**Erstimport-Anzeige korrigiert und ausgeliefert (27.10.2026):** Ein neuer aktiver Kanal ohne erfolgreichen Import zeigt **„Erster Import ausstehend“**. „Import veraltet“ bleibt früher erfolgreichen, inzwischen nicht mehr aktuellen Importen vorbehalten; ein erster fehlgeschlagener Abruf zeigt weiterhin „Importfehler“. Erster Lauf über **Weitere Aktionen › Jetzt abgleichen**. Nur die Darstellung geändert, keine Import-/Belegungsregeln oder Portalverbindungen. Relevante Verwaltungs-/Abrufprüfungen: **18 Tests / 106 Assertions erfolgreich**, Pint erfolgreich; Pipeline 4666 mit Build/Tests/Sicherung/Deployment erfolgreich, Server-REVISION und Release bestätigt. Lesend geprüft: Der inzwischen vom Nutzer eingerichtete Importkanal 2 hat einen erfolgreichen Lauf vom 27.10. um 17:58; Aktualitätsgrenze 60 Minuten, `is_stale=false`. Kein weiterer Import durch diese Prüfung ausgelöst.
**Exportlink in der Portalkonfiguration bereitgestellt (27.10.2026):** Der vorhandene Link steht oben im Bearbeitungsformular als **„Eigener iCal-Exportlink“**, schreibgeschützt und kopierbar, sowohl in der eigenen Portalverwaltung als auch an der Wohnung. Kein neuer Token und keine Änderung der Kalenderverbindung. Relevante Verwaltungs-/iCal-Tests: **53 Tests / 268 Assertions erfolgreich**, Pint erfolgreich. Mit `0be1cfc` durch Pipeline 4665 erfolgreich ausgeliefert; im aktuellen Stand `e5a083c` enthalten.
**Portalkacheln und Abrufhistorie bereitgestellt (27.10.2026):** Responsive Kacheln ersetzen die breite Portaltabelle; Name/Wohnung, Status, Richtungen, letzter Sync-Lauf und letzter Kalenderabruf bleiben sichtbar. Hauptaktion **Exportlink** zeigt die kopierbare vertrauliche Adresse. Weitere Aktionen sind im Zusatzmenü. Pro Kanal werden die letzten 100 verarbeiteten Feedabrufe mit Empfangszeit, GET/HEAD, Antwortstatus, Exportzustand und unbestätigter Clientkennung gespeichert; keine IP-Adresse und keine Exporttoken im Protokoll, Begrenzung ohne Scheduler. Importerfolg, Feedempfang und persönliche Portalübernahme bleiben getrennt. **376 Feature-Tests / 1801 Assertions lokal grün, Pint erfolgreich; Pipeline 4664 mit Build/Tests/Sicherung/Deploy erfolgreich.** Server-REVISION `511faa6`, Release und MariaDB-Migration `2026_10_27_173923_create_channel_export_requests_table` in Batch 17 bestätigt. Eigene ausdrücklich gekennzeichnete GET-/HEAD-Prüfabrufe (`FewoPortal-Abnahme/1.0`) am 27.10. um 17:52:13 mit Kanal 1, HTTP 200 und Zustand `live` im Serverprotokoll nachgewiesen. Bisheriger Kalender bytegleich, weiterhin kein neuer Kanal und keine Belegungsänderung. Das ist kein Nachweis eines tatsächlichen Portalclients. [Benutzung und Grenzen](architecture/ical-mvp-inbetriebnahme-2026-10-27.md#kachelansicht-und-kalenderabrufe).
**Eigenständige Portalverwaltung bereitgestellt (Folgeauftrag 27.10.2026):** Eigene Seite **Vermietung › Portale & Kalender** (`/admin/channels`), auch in der einfachen Ansicht, für frei benannte Kanäle und individuell gewählte Wohnungen. Automatische dauerhafte Exportlinks, vollständige Konfiguration, manuelle Abgleiche und Überwachung über gemeinsame Formulare/Aktionen mit der Wohnungsansicht. Rollen und Mandantentrennung über `ChannelPolicy`. **Keinen Ostseeklar-Kanal oder anderen neuen Anbieter eingerichtet.** Der vorausgehende iCal-Kern und beide MariaDB-Migrationen wurden durch Pipeline 4662 erfolgreich bereitgestellt (Batch 16). Die eigenständige Oberfläche ist mit **`1f59cbb` durch Pipeline 4663 erfolgreich ausgeliefert**; Server-REVISION, Release und drei Verwaltungsrouten bestätigt. **368 Feature-Tests / 1755 Assertions lokal erfolgreich; Pipeline-Build und Tests erfolgreich; Pint erfolgreich.** `/up` und Anmeldung HTTP 200, Portalverwaltung unangemeldet zur Anmeldung umgeleitet. Bisheriger Exportlink HTTP 200 und bytegleicher Kalender vor/nach Deployment, ungültiger Token 404. Keine Buchung oder Sperre geändert. [Benutzung und Abnahme](architecture/ical-mvp-inbetriebnahme-2026-10-27.md).
**iCal-MVP zur Auslieferung vorbereitet (27.10.2026):** Automatischer eigener dauerhafter Exportlink je frei benanntem Portalkanal in der Verwaltung; manuelle Klärung und Zuordnung mehrfach dargestellter Belegungen; führende Sperre/Buchung steuert Verfügbarkeit und Export, zugeordnete UID-Darstellungen bleiben nachvollziehbar. Archivierung erhält die Identität verschwundener und wiederkehrender Ereignisse. Konfigurierbares Echoverhalten, Exportumfang, Portal-Pflegehinweise und getrennte persönliche Übernahmeprüfung ergänzt. **359 Feature-Tests / 1701 Assertions lokal erfolgreich, Pint erfolgreich.** Der Nutzer hat Deployment und Migration auf der bestehenden Instanz ausdrücklich beauftragt. Keine separate Testinstallation. Vorab auf stommer.info gelesen: ein reiner FeWo-direkt-Exportkanal, keine Sperren und keine belegende Buchung; Link unverändert HTTP 200 ohne Ereignisse. Externe Importadressen fehlen dort noch und sollen auf Wunsch über die Oberfläche statt lokaler JSON-Datei eingetragen werden. [Benutzung, Zuordnung und praktische Abnahme](architecture/ical-mvp-inbetriebnahme-2026-10-27.md). Auslieferungsnachweis folgt nach Abschluss der bestehenden Pipeline.
**Generische iCal-Kanäle lokal umgesetzt (27.10.2026):** Auf `feature/ical-portalkanaele` wurde das vorhandene Connector-System erweitert: getrennte Import-/Exportrichtungen, Einrichtungsstatus und Buchungsmodell, Test-/Regulärmodus, eingefrorener letzter Export bei Pause, kontrollierte Tokenrotation, zusätzliche Herkunft, strikte vollständige Feedprüfung, bestätigte Entfernung fehlender Ereignisse und Prüffälle statt datumsbasierter Mail/iCal-Zusammenführung. Portal-Aufgaben erhalten alte/neue Termine nach Commit und geben nur aktuell freie Nächte frei; überholte Automationsaufgaben werden vor Übergabe verworfen. **Abnahme lokal: 347 Feature-Tests / 1626 Assertions grün, darunter 44 neue iCal-Fälle; Pint erfolgreich.** Neue Migration ausschließlich an synthetischer SQLite-In-Memory-Testdatenbank geprüft, keine Anwendungsdatenbank migriert. [GAP-Analyse, Konfiguration, Grenzen, Testplan und Freigabe](architecture/ical-kanalkonfiguration.md). **Nicht ausgeliefert, keine echte Kalenderverknüpfung, kein Server-/Portalbestand verändert.** Bestehende Kanäle behalten bei späterer Migration ihren bisherigen regulären Exportumfang; neue starten ausgeschaltet im Testmodus. Offen vor Auslieferung: MariaDB-/Zielsystemprüfung, Bestandsklärung und ausdrückliche Freigabe realer Verbindungen. Die von Lars berichtete FeWo-direkt-Probe ist ein konkreter Nutzerbericht, kein allgemeiner Nachweis des Portalverhaltens. Der historische iCal-Prüfbericht bleibt unverändert.
**iCal-Praxistest vorbereitet (27.10.2026):** Auf dem bestehenden Testsystem wurde für Wohnung 1 ein reiner FeWo-direkt-Exportkanal (ID 1) angelegt: keine Importadresse, keine Mailabsender-Zuordnung, keine manuellen Sperraufgaben. HTTPS-Export und Ablehnung eines falschen Tokens geprüft; zwei Abrufe mit zwei vorhandenen Ereignissen bytegleich. Die vertrauliche URL liegt ausschließlich lokal in der Git-ignorierten Datei `storage/app/private/ical-praxistest/export-url.txt`. Vorhandene Export-/Herkunftstests erfolgreich (2 Tests, 13 Assertions). Offline-Vergleich unter `scripts/compare-ical.py` vorbereitet und geprüft. [Ablauf und Nachweise](architecture/ical-praxistest-vorbereitung-2026-10-27.md). **Keine Testsperre angelegt, keine Portalverknüpfung, kein Rückimport, keine Buchung/Sperre geändert.** Der Feed enthält bereits die manuelle Sperre 31.10.–08.11.2026 und die bestätigte Buchung 14.–17.11.2026; ihre Übertragung ist vor einer Verknüpfung zu beachten. Nächster Schritt nur nach ausdrücklicher Freigabe des Nutzers.
**Konzeptphase Vermietung (26.10.2026):** [Arbeitsentwurf](architecture/konzept-vermietung/Konzept_README.md) auf Grundlage der fachlichen Bestandsdokumentation angelegt: unterschiedliche Workflows und Portale, Vorprüfung, individuelle Kommunikation, automatische Kundenbindung/Loyalty, Marketing und Automatisierungsbefugnisse. Enthält eine offene Entscheidungsliste, Arbeitsphasen und durchgängige Szenarien. Neue Regeln und Programmparameter sind Vorschläge, noch keine beschlossenen Geschäftsregeln oder umgesetzten Funktionen. Nächste fachliche Vertiefung: gewünschte Automatisierungstiefe und tatsächlich genutzte Portale klären.
**Fachliche Funktionsdokumentation (26.10.2026):** [docs/architecture/README.md](architecture/README.md) führt durch die vorhandenen Funktionen nach fachlichen Ebenen und Bereichen. [Planung und offene Punkte](architecture/planung-und-offene-punkte.md) trennt geplante Erweiterungen, Optionen und noch nötige Inbetriebnahme. Abgeglichen mit dem lokalen Anwendungsstand; keine Auslieferung durch diese Dokumentationsarbeit. Neu festgehaltene offene Abweichung: Sonderangebote können im aktuellen Preisrechner die absolute Mindestnächtezahl umgehen (Details: [Preise und Angebote](architecture/preise-und-angebote.md)).
**Mandantenabschluss (26.10.):** Beide Themes nutzen Website-Logo/Favicon und die gewählte Bildwelt, auch für Bildplatzhalter. HTML- und Textmails tragen den eigenen Namen; HTML bettet das Dokumentlogo ein. Vertragsdateien liegen getrennt unter `contracts/tenants/<id>/bookings/<id>/`; Export/Löschung berücksichtigen Website-Medien, Bildkonvertierungen und Dokumentversionen. Bestehende flache Vertragsdateien bleiben lesbar; mehrdeutig von mehreren Mandanten referenzierte Altdateien stoppen die Löschung. Marken-Uploads erlauben PNG/WebP bzw. PNG/ICO; SVG wird ausschließlich aus geprüften Repository-Quellen importiert. `sites:import-stommer-brand <site-id>` übernimmt die bisherige Marke nur für Stommer, wiederholbar und ohne vorhandene Uploads zu ersetzen.
**Abnahme:** 303 Feature-Tests / 1409 Assertions lokal grün (18 zusätzliche Fälle), beide Themes mit `themes:check` geprüft, `image-worlds:check` erfolgreich, Vite-Build und Pint erfolgreich. Der bestehende PipelineManager hat Tests/Build, Sicherung und Strato-Deployment erfolgreich ausgeführt (Lauf 4661, Job 9049). Server-`REVISION` und `current` per SSH bestätigt; keine Deploy-Sperre verblieben. Sicherung auf dem Pi: `backups/fewo-stommer/staging/20261026161129-06df80e4.tar.gz` (30.673.316 Bytes). Stommer-Marke an Website 1 importiert (Logo, Favicon, Dokumentlogo). `/up`, `/`, `/wohnung`, `/buchen`, `/admin/login` unter `www.stommer.info` sowie ausgeliefertes Logo und Favicon jeweils HTTP 200; Testseite weiterhin `noindex`. Die leere Unit-Suite aus `phpunit.xml` entfernt; der normale PHPUnit-Aufruf funktioniert damit wieder. Keine neue Migration, Abhängigkeit oder lokale Datenbank.
**Verbindliche Umgebung:** Test unter **https://www.stommer.info** (auch `stommer.info`), Serverpfad **`test.fewo-stommer.de/`**, nur per SSH verwaltet. `dev.fewo-stommer.de/` existiert nicht (SSH-Prüfung und Bestätigung Lars 26.10.). Der Produktionsordner ist höchstens eine leere Vorbereitung; Produktion bleibt gesperrt. Vor deren Aufbau ist eine eigene MariaDB-Datenbank zusätzlich zur Testdatenbank einzurichten, keine Datenbank pro Mandant. Weiterhin bestehender PipelineManager-Ablauf: `develop` → Staging; kein zusätzlicher MariaDB-Testjob und keine neue lokale Umgebung.
## 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:
- Saisonfotos (am Foto: „Zeigen in“), 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) |
| Scheduler | **n8n veröffentlicht und aktiv** – automatische Kalenderimporte 20:55:03 und 21:00:03 Uhr erfolgreich, Fünf-Minuten-Abstand praktisch nachgewiesen (BETRIEB.md §6) |
| Typischer Anreisetag | noch nicht eingetragen (Preise & Angebote › Saisons › Regeln Mindestaufenthalt) |
## 3. Offen
**iCal-Kanalkonfiguration:** Erweiterung, eigenständige Verwaltungsseite und MariaDB-Migrationen auf stommer.info bereitgestellt. Anbieter werden auf Wunsch vom Vermieter selbst angelegt und konfiguriert; inzwischen ist ein erfolgreicher Import des nutzerseitig eingerichteten Kanals 2 vom 27.10. um 17:58 protokolliert. Weitere Portalzuordnungen und echte bidirektionale Sichtabnahme stehen aus. Der aktive n8n-Scheduler ist durch zwei aufeinanderfolgende automatische Kalenderimporte im Fünf-Minuten-Abstand nachgewiesen; der längerfristige Betrieb bleibt zu beobachten. [Benutzung und verbleibende praktische Schritte](architecture/ical-mvp-inbetriebnahme-2026-10-27.md). Keine automatische Bestandsbereinigung.
**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**
- Aktiven n8n-Scheduler auf dem Pi weiter betreiben; regelmäßigen Importerfolg und Fehler in der Kanalübersicht beobachten (BETRIEB.md §6).
- Design-Theme Seebad 0.3 ist auf `main` und 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.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)
Für den praktischen iCal-Betrieb unter **Vermietung › Portale & Kalender** die gewünschten Anbieter selbst anlegen, externe Importadressen eintragen und automatisch erzeugte eigene Exportlinks den richtigen Portalen zuordnen. Reale Bestände persönlich klären und den regulären Betrieb einzeln prüfen; [Ablauf und verbleibende Testfälle](architecture/ical-mvp-inbetriebnahme-2026-10-27.md). Bestehende Exportadresse unverändert; keine erneute Auslieferung für die normale Konfiguration nötig.
1. 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: 26.10.2026 · Phase-7-Kern auf `main` und Strato · Plan: [MANDANTEN-PLAN.md](MANDANTEN-PLAN.md) · Anforderungen: [MANDANTEN-ANFORDERUNGEN.md](MANDANTEN-ANFORDERUNGEN.md)
> **Ausgeliefert:** `20261026072521`, Commit `abf0e90`, aus aktuellem `main` nach `test.fewo-stommer.de/` (https://stommer.info). Sicherung davor: `C:\Dev\fewo-backups\staging\20261026-082223` (Datenbank und Dateien, 29 MB). Aktiven Pfad und `REVISION` per SSH geprüft; `/up`, `/`, `/wohnung`, `/buchen` und `/admin/login` liefern HTTP 200. Dies ist der ursprüngliche Phase-7-Auslieferungsnachweis. Weitere automatische Testdeployments laufen jetzt über PipelineManager nach Push auf `develop`, einschließlich Sicherung vor dem Upload; siehe unten und DEPLOYMENT.md.
**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](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](https://gitea.stommer.de/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 erfolgreich:** Push auf `develop` → Gitea-Lauf [4656](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4656), Commit `e7f79e4`, Release `20261026134851-e7f79e40`. **285 Feature-Tests / 1289 Assertions im Container grün**, Sicherung vor Upload, Aktivierung, automatischer HTTPS-Check und Bereinigung erfolgreich. Per SSH `REVISION`, einzige verbliebene Release-Version und Verknüpfungen auf `shared` geprüft; `/up`, `/`, `/wohnung`, `/buchen`, `/admin/login` jeweils HTTP 200. Sicherung auf dem Pi: `/home/lars/docker/pipeline-manager/backups/fewo-stommer/staging/20261026134851-e7f79e40.tar.gz` (enthält auch den vorher erzeugten Datenbank-Dump).
Werkzeugversion `0.1.1` aus Manager-Commit `34b6b01`: Kandidatenlauf 4652 und Freigabelauf 4653 grün, **18 Manager-Tests lokal und im Image grün**. Frühe Pilotfehler vor dem Serverzugriff wurden behoben: PHP-Testlimit 512 MB, GD mit WebP im Image, schreibgeschützte Benutzerliste des Runners für OpenSSH. Eigener Pipeline-Schlüssel bei Strato autorisiert, privater Teil als Gitea-Secret; alle vier Deployment-Secrets eingerichtet. Cache und Backups liegen unter `/home/lars/docker/pipeline-manager/`, keine veröffentlichten Ports. **Betriebsgrenze:** Der Pi setzt Docker-Speicherlimits mangels Memory-Cgroup-Unterstützung derzeit nicht durch; keine Host-/Kerneländerung vorgenommen. Anleitung, Workflow-Vorlage, Betriebsnachweise und `AGENTS.md` im separaten Manager-Repository. Produktion bleibt gesperrt. 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:** abgeschlossen und ausgeliefert, einschließlich Übernahme der Stommer-Marke. Abnahme und Deploymentnachweis stehen am Dokumentanfang.
- **Subscription und Abrechnung** – nicht Teil des Mandanten-Plans (§9 schließt sie aus). `service_usages` liegt 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.
### Historische Übergabe bis einschließlich Phase 6
Die folgenden Nachweise stammen aus den früheren Sitzungen. Für den aktuellen Phase-7- und Deployment-Stand gelten die Abschnitte oben.
**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_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. Testdeployments laufen aus `develop` über Gitea/PipelineManager mit grünen Feature-Tests und Sicherung; der alte manuelle Weg ist nur Wartungsfallback. 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. |
| 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 `.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.