Seebad 0.3 stays in this release. With a single landlord every host still reaches the default website. Co-authored-by: Cursor <cursoragent@cursor.com>
13 KiB
Projektstand
Stand: 23.10.2026 · ausgelieferter Stand: siehe neuester Git-Tag deploy/staging/* · 217 Feature-Tests grün auf feature/mandanten
Dieses Dokument ist der Einstieg für jede neue Arbeitssitzung. Bitte bei größeren Änderungen fortschreiben (Abschnitte „Fertig“, „Offen“, „Nächste Schritte“).
1. Fertig (umgesetzt, getestet, auf stommer.info)
Vermietung
-
Preise: Saisons mit Preis/Nacht und Mindestnächten; Preisrechner; Extras (Bettwäsche, Handtücher); Endreinigung, Zusatzperson, Anzahlungsquote, Restzahlungsfrist je Wohnung. In Folgejahr kopieren, optional mit Saisonbeginn auf einem Wochentag. (Code:
app/Pricing,CopySeasonsToNextYear) -
Mindestaufenthalt mit Ausnahmen: Kalenderlücke vollständig gefüllt; Abreise am typischen Anreisetag; Sonderangebot hebt auf; absolute Untergrenze. (
PriceCalculator::minimumStayRelaxed, Einstellungen „Regeln Mindestaufenthalt“) -
Sonderangebote: Rabattaktion, fester Termin (auch Pauschalpreis) und Lückenfüller (erkennt Lücken selbst). Dazu Aktionscodes, Priorität und „Hervorheben“. Die Webseite bewirbt Angebote nach eigenen Regeln (
OfferShowcase), nebeneinander, als Liste oder rollierend. (KONZEPT §5a) -
Buchungsweg 1 – Anfrage → Angebot → Annahme (KONZEPT §6a):
- Der Gast fragt unverbindlich an; der Zeitraum ist für die Haltezeit vorgemerkt.
- Die Vermieterin öffnet „Angebot senden“ und passt bei Bedarf Termin, Personen, Rabattcode, Preis, Gültigkeit, Nachricht und Gastdaten an.
- Der Gast erhält eine E-Mail mit Vertragsentwurf (PDF) und einem signierten Link.
- Auf der Angebotsseite nimmt er an (Annahmenachweis ohne IP) oder lehnt ab.
- Nach der Annahme: Bestätigung und Mietvertrag, Zahlungsfristen laufen.
Die Angebotsfrist verfällt automatisch. „Direkt bestätigen“ gibt es für telefonisch vereinbarte Buchungen. (
SendOffer,AcceptOffer,RejectOffer,OfferController,resources/views/offer.blade.php) -
Zahlungen: manuell erfassen, Erinnerungen an Anzahlung und Rest, Anreiseinformationen, Bewertungsanfrage nach Abreise.
-
Gästekartei: Notizen, Tags, CSV-Export, Werbe-Einwilligung mit Bestätigung per E-Mail (Double-Opt-in). Eine neue Anfrage überschreibt keine Stammdaten.
-
Portale: iCal-Import und -Export, Überwachung, Portal-E-Mails als schneller Weg, Aufgaben für manuelle Sperren. (PORTALE.md)
-
Bewertungen: Einladung per E-Mail, Freigabe im Admin, Anzeige mit Pflichthinweis zur Echtheit.
Verwaltung (Admin)
- Rollen: Mandanten-Administrator, Vermietung, Inhalte. Auf
feature/mandantengilt die Rolle je Mandant; der ausgelieferte Stand hat noch die eine Rolle je Konto. - Ansichten: Die einfache Ansicht zeigt Anfragen & Buchungen, Sperrzeiten, Preise & Angebote, Gäste, Portal-Aufgaben, Bewertungen und Bilder. Die Expertenansicht zeigt alles. Umschalten im Benutzermenü.
- Sicherheit: 2FA ist für alle Konten Pflicht; Administratoren können die 2FA eines anderen Kontos zurücksetzen und Passwörter neu vergeben.
Webseite
- Theme-System: Basis-Theme „Ostsee-Licht“, 15 Bausteine, Seiten-Baukasten.
- Erscheinungsbilder für Standard, Sommer, Winter, Weihnachten und Silvester:
- Bilder je Baustein, Bausteine nur in bestimmten Erscheinungsbildern,
- Vorschau-Links, Bildauswahl mit Vorschaubild.
- Markengrafiken im Theme: Logo, Favicon, Symbole, Wellenband, Illustration. (
public/brand,partials/brand) - Theme-Werkzeuge:
themes:make,themes:check,themes:preview; Anleitung in THEME-ERSTELLUNG.md. - Fotos: 39 Fotos aus dem alten WordPress importiert, GPS- und Kameradaten entfernt.
Betrieb und Datenschutz
- Deployment: atomare Versionen auf Strato, Gesundheitscheck mit automatischem Zurückschalten; Versionsgeschichte als Git-Tags. Nur die aktive Version liegt auf dem Server (Strato-Dateilimit).
- Datenbank-Backup: täglich;
scripts/backup-pull.shholt es samt Dateien aufs NAS. - Datenschutz:
- Anonymisierung und Löschfristen (Vorschläge) laufen täglich.
- Sicherheits-Header sind gesetzt; Automations-Tokens werden per Header übergeben.
- Keine externen Quellen (Schriften selbst gehostet).
- Betriebsart (System › Betrieb): Testbetrieb (Standard) schickt alle Mails nur an eine Testadresse, „scharf geschaltet“ an die echten Empfänger; Hinweisbanner in der Verwaltung.
mail:testprüft den Versand; alle 17 Mail-Typen werden in Tests vollständig aufgebaut. - Bot-Schutz der Buchungsanfrage: Köderfeld, Zeitsperre, Begrenzungen je IP/E-Mail/gesamt, höchstens 2 gleichzeitige Vormerkungen je E-Mail, keine Links (ohne externen Captcha-Dienst).
- Testbetrieb:
noindex.
2. Stand auf stommer.info (Testbetrieb)
| Konten | lars@stommer.com (Administrator); Konto für Brigitte noch anzulegen (Administrator, einfache Ansicht) |
| Daten | Wohnung, Preise 2026, 39 Fotos, Seiten, 5 Erscheinungsbilder; Testbuchung 2026-0002 („E2E Testgast“, angenommenes Angebot) – darf gelöscht werden |
Betriebsart Testbetrieb (System › Betrieb), Testadresse lars@stommer.com – alle Mails gingen nur dorthin. Versandweg aber noch log (nichts wird zugestellt): MAIL_MAILER=smtp + MAIL_PASSWORD (Postfach info@fewo-stommer.de = Absender) in shared/.env selbst eintragen, dann artisan mail:test (BETRIEB.md §5a) |
|
| Cronjob | noch nicht eingerichtet – ohne ihn laufen Fristabläufe, Erinnerungen, Kalenderabgleich, Backups nicht automatisch (BETRIEB.md §6) |
| Typischer Anreisetag | noch nicht eingetragen (Preise & Angebote › Saisons › Regeln Mindestaufenthalt) |
3. Offen
Entscheidungen und Inhalte (Betreiber)
- Impressum und Datenschutzerklärung werden separat erstellt; dann unter Webseite › Texte › Rechtliches eintragen.
- Mietbedingungen, Storno-Regeln, AGB; Texte zu Angebot und Annahme, einschließlich der Beschriftung des Annahme-Buttons, fachkundig freigeben lassen (Webseite › Texte).
- Löschfristen nach allgemeiner Rechtsauffassung bestätigen (BETRIEB.md §7a); Auftragsverarbeitung mit Strato im Kundenbereich prüfen.
- Bankverbindung (
FEWO_BANK_*), Preise 2027, Meldeschein: Ob der Ferienservice Balu ihn übernimmt, ist noch zu klären; die Kurabgabe erledigt Balu vor Ort. - Sprachen: nur Deutsch oder auch Englisch?
Technik
- Cronjob auf Strato einrichten (BETRIEB.md §6).
- Design-Theme Seebad 0.3 ist auf
mainund auf stommer.info aktiv (Abschnitt 6). - Mandantenfähigkeit: Phase 1, 2 und der Website-Teil von Phase 4 liegen auf
feature/mandanten, zusammen mit Seebad 0.3 (Mandant, Mitgliedschaften,/betreiber, Host je Website, Gäste-Links). Cron, Postfach und Absender je Mandant fehlen noch; mit genau einem Mandanten bleibt der bisherige Betrieb. Die Datenbank auf stommer.info ist noch nicht migriert. Plan:docs/MANDANTEN-PLAN.md. - Logo in E-Mails und im Vertrags-PDF (
public/brand/logo-600.pngliegt bereit). - Content-Security-Policy: braucht wegen Livewire/Filament Nonces und einen sorgfältigen Test.
- Produktion
www.fewo-stommer.devorbereiten:- eigener Deploy-Ordner, Datenbank und
.env, - Umleitungen von der alten WordPress-Seite,
- echte Testbuchungen (GO-LIVE-CHECKLISTE.md).
- eigener Deploy-Ordner, Datenbank und
- Später:
- Buchungsweg 2 (verbindliche Direktbuchung), erst bei verlässlicher Synchronisation mit FeWo-direkt,
- Portalbuchungen als vollwertige Buchungen (DATENMODELL-KONZEPT.md),
- Stornoformular für Gäste, KI-Angebotsentwürfe, Marketing und Social Media.
- SSH-Schlüssel des Firmen-Laptops vom Server entfernen, sobald der private PC eingerichtet ist (BETRIEB.md §4).
4. Nächste Schritte (Vorschlag)
- Cronjob einrichten; SMTP einschalten und mit
mail:testprüfen (Mails landen wegen Testbetrieb nur bei Lars); Konto für Brigitte anlegen. 1a. Vor dem Go-Live: System › Betrieb auf „scharf geschaltet“ stellen – erst dann erhalten Gäste die Mails. Beim Go-Live außerdem unter System › Betrieb › Adressen Kontakt-/Antwortadresse und Benachrichtigungen von fewo@stommer.de auf info@fewo-stommer.de umstellen (Entscheidung 23.10.2026; Absender ist bereits info@fewo-stommer.de). - Brigitte probt Anfrage → Angebot → Annahme mit einem eigenen Test (Angebotslink über die Aktion „Angebotslink“).
- Testinstanz stommer.info auf den Mandanten heben: aus
mainausliefern (Migration läuft dabei), danachusers:promote-operatorfürlars@stommer.com. Vor einem zweiten Mandanten den Hoststommer.infoan der Website eintragen. - Rechtstexte und Bedingungen einpflegen, Produktion einrichten, Umzug von WordPress.
5. Schnellreferenz Code
| Bereich | Ort |
|---|---|
| Geschäftsabläufe | app/Actions/* (CreateReservation, SendOffer, AcceptOffer, RejectOffer, ConfirmBooking, DeclineBooking, ExpireReservations, RecordPayment, SyncChannel, ProcessPortalMail, AnonymizeGuests …) |
| Preise/Angebote | app/Pricing/* (PriceCalculator, OfferShowcase, AdvertisedOffer), app/Availability/* (AvailabilityChecker, GapFinder) |
| Verwaltung | app/Filament/** (Ansichten: App\Enums\AdminMode, Trait FollowsAdminMode) |
| Webseite | app/Themes/**, resources/themes/ostsee-licht/**, config/themes.php |
| Befehle | users:create, users:promote-operator, photos:import, photos:strip-metadata, backup:database, themes:make/check/preview, channels:sync, bookings:expire-holds |
| Zeitpläne | routes/console.php (jede Minute Postfach, alle 5 Min. Fristen/Abgleich, täglich Erinnerungen, Bewertungen, Anonymisierung 03:00, Backup 02:30) |
| Einstellungen | config/fewo.php (Frist, Löschfristen, Backup, Mail-Umleitung), config/content.php (bearbeitbare Texte) |
6. Design-Theme „Seebad“ (Abschnitt der Design-Session)
Stand: 23.10.2026 · Theme 0.3.0 auf stommer.info aktiv · Konzept: DESIGN-KONZEPT.md (Richtung A) · Theme-Doku: resources/themes/seebad/README.md
Fertig: alle 15 Bausteine, Kopf/Fuß/Banner/mobile Buchungsleiste, Logo aus styles/satz4 (SVG-Master + WebP), Favicon (Eckbau mit Rundbogengaube), Bäderstil-Details des Hauses (Rundbogen mit Fasche und Schlussstein, Rundbogengaube, Kopfbänder als Eckkonsolen, Balkongeländer), Farben aus dem Logo, Schriften selbst gehostet. Gearbeitet wird im eigenen Worktree auf theme/seebad, ausgeliefert nur über main.
Offen (Design):
- Ziffer 0 mit Schrägstrich (Schrift Atkinson Hyperlegible) in Preisen und Daten – Entscheidung Lars: lassen oder Preise/Daten in anderer Schrift.
- Seite „Kühlungsborn“ wirkt leer, bis es den Baustein „Tipps der Gastgeberin“ gibt (Vignetten liegen bereit:
motifs/vignette-*.svg). - Bewertungen und Sonderangebote nur lokal mit Testdaten geprüft – auf stommer.info gibt es noch keine (Admin: Angebot anlegen bzw. Bewertung freigeben, dann ansehen).
- Mail-Logo und Vertrags-PDF nutzen noch
public/brand/logo-600.png→ beim Mandanten-Umbau (Marke je Website, MANDANTEN-ANFORDERUNGEN A14/A22) aufstyles/satz4/svg/logo-voll.svgumstellen. - Hauptmenü mit Bildtafeln (Entwurf im Canvas) – rein im Theme machbar, noch nicht gebaut.
- SVG-Master des Logos für Druck/Markenanmeldung von einem Grafiker glätten lassen (leichte Fleckigkeit in Wellen und Sonne).
Neue Bausteine („Widgets“) – wo sie gebaut werden:
| Baustein | Daten / Admin | Darstellung | Abhängig von |
|---|---|---|---|
| Interaktiver Grundriss | je Wohnung: Grundriss (SVG/Bild) + Räume (Name, Text, Fotos, Fläche als Polygon in %); Editor im Admin | Inline-SVG, Räume antippen → Foto/Text; ohne JS als Liste | Mandanten-Umbau Phase 1 (Daten je Wohnung/Mandant) |
| 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 nach Phase 1 des Mandanten-Umbaus, damit neue Tabellen gleich mandantenfähig angelegt werden (vorher: nur Konzept und Admin-Entwürfe). Reihenfolge-Vorschlag: Gut zu wissen → Tipps der Gastgeberin → Grundriss → Kalender → Erzählstrecke/Video → Wetter.