Offers by their own rules, seasonal photos per section, theme authoring tooling

- Special offers: kinds (rule, fixed dates, gap filler), package price, priority, highlight;
  GapFinder detects calendar gaps (optionally waiving the minimum stay); OfferShowcase decides
  what the website advertises and prices fixed dates/gaps with PriceCalculator; offers section
  shows them side by side, as a list or rotating; hero can show the top offer. Appearances no
  longer carry a featured offer.
- Sections get stable ids; appearances set photos per section ("Bilder je Baustein") and
  sections can be limited to appearances. Photo pickers show thumbnails everywhere.
- Themes: themes:make (scaffold, never overwrites), themes:check (contract, build, markup,
  colours, external resources, WCAG contrast), themes:preview (signed links per page and
  appearance), signed ?theme= preview and preview action in the site form, inherited colour
  tokens in the admin. Base CSS split into theme.css + reusable theme-base.css.
- docs/THEME-ERSTELLUNG.md: binding guide for building additional themes elsewhere.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Lars StommerandClaude Opus 5.5 committed 2026-10-22 18:51:38 +02:00
1 parent bc77b64ea7
commit 7d0bc93abc
50 files changed
+2805 -259

No files matched your search

+222
View File
@@ -0,0 +1,222 @@
# Datenschutz- und Datenfluss-Audit – Ferienwohnung Stommer
Stand: 22.10.2026 · Art: **Read-only-Codeaudit** (Repository-Stand `main` + lokale, noch nicht committete Änderungen) · Verantwortliche: Brigitte Stommer
> **Hinweis zur Verwendung:** Dies ist eine technische Bestandsaufnahme, keine Rechtsberatung. Alle Rechtsgrundlagen sind *Prüfannahmen*. Vor Veröffentlichung der Datenschutzerklärung ist eine juristische Prüfung (ggf. Datenschutzbeauftragte/r bzw. Rechtsberatung) erforderlich. Der Bericht ist vor Weitergabe an Dritte zu prüfen und zu validieren.
**Methodik und Grenzen**
- Untersucht: Quellcode, Konfiguration (`config/*`), Migrationen, Views, Routen, Tests-Namen, Betriebsdokumentation (`docs/*`).
- **Nicht durchgeführt:** Zugriff auf Staging/Produktion, Browser-/Netzwerkanalyse, Test-Buchungen, Einsicht in Server-`.env`, Strato-Verträge/-Einstellungen. Es gibt daher **kein „tatsächlich beobachtetes Browserverhalten“** – alle Aussagen zu Cookies/Requests sind Codebefunde.
- Es wurden keine Zugangsdaten, Tokens oder echten Gästedaten in diesen Bericht übernommen.
**Statuskennzeichnung:** ✅ Implementiert und im Code belegt · 📄 Nur konfiguriert/dokumentiert · 🗓 Geplant · ❓ Unbekannt / zu prüfen
---
## 1. Executive Summary
**Gesamtbild:** Die Anwendung ist datensparsam aufgebaut. Es gibt **keine Analyse-/Marketing-Dienste, keine externen Skripte/CDNs/Schriften, keine eingebettete Karte, kein Kundenkonto**. Nach Code-Lage setzt die Seite nur technisch notwendige Cookies (Session, XSRF). Gästedaten liegen in einer MySQL/MariaDB bei STRATO; E-Mail-Versand läuft über den Strato-SMTP (Produktion geplant).
**Positiv (✅):** selbst gehostete Schriften; Double-Opt-in für Angebots-E-Mails mit signiertem Abmeldelink; automatische Anonymisierung nach Aufbewahrungsfrist (Standard 10 Jahre, Steuerberatung zu bestätigen); Honeypot + IP-Rate-Limit am Buchungsformular; Admin-Rollen mit Policies; Pflicht-2FA für Admins; HMAC-signierte Webhooks; iCal-Feed ohne Gästedaten; Mietvertrag-PDF nicht öffentlich abgelegt.
**Wichtigste Lücken (Details §5):**
1. **Datenschutzerklärung und Impressum sind leer** (`legal.privacy`/`legal.imprint` ohne Default) – Blocker für die Produktivsetzung.
2. **Anonymisierung ist unvollständig:** Vertrags-PDFs, `portal_emails.excerpt`, `bookings.internal_notes`, Bewertungen (Name, privates Feedback), UTM-Daten, Sitzungs-IPs und Logs werden nicht mitgelöscht/anonymisiert.
3. **Kein dokumentiertes Löschkonzept für Nicht-Buchungen:** Abgelaufene/abgelehnte Anfragen bleiben (Guest + Booking) bis zur 10-Jahres-Anonymisierung gespeichert – Frist vermutlich zu lang für Anfragen ohne Vertragsabschluss (juristisch prüfen).
4. **Backups:** Datenbank-Backups sind nur im Konzept („täglich“) erwähnt, im Code/Deployment nicht belegt (❓).
5. **Geheimnisse in URL-Query** (`?token=` für `/health/sync`, `/automation/scheduler`) landen in Server-/Proxy-Logs; Betrieb über n8n auf einem „privaten Server“ ist eine Auftragsverarbeitungs-/Drittlandfrage, falls dort Gästedaten fließen.
6. **Kein Angebot/Annahme-Schritt im System:** Der Prozess kennt nur *Anfrage (Reserved) → vom Vermieter bestätigt (Confirmed)*; die Gast-Annahme ist nicht abgebildet. Das ist für Datenschutzerklärung (Vertragsanbahnung) und AGB relevant.
7. **KI:** Keine KI-Komponente im Code vorhanden (🗓 nur perspektivisch). Vor Einführung sind AVV, Drittlandtransfer, Art. 22 DSGVO und DSFA zu klären.
8. **Fehlende Security-Header** (CSP, HSTS, X-Frame-Options etc.) im Anwendungscode; ggf. nur über Strato/.htaccess (❓).
---
## 2. Systemübersicht und Datenflussdiagramm
### 2.1 Technik (alle ✅ soweit nicht anders vermerkt)
| Bereich | Befund | Quelle |
|---|---|---|
| Framework | Laravel 13 (PHP 8.4), Livewire, Filament 5 (Admin `/admin`), Blade-Theme-System, Tailwind/Vite (lokal gebaut) | `composer.json`, `CLAUDE.md` |
| Hosting | STRATO Shared Webhosting (Hosting Pro), kein Node zur Laufzeit; Atomic Releases, nur aktive Version auf dem Server | `docs/BETRIEB.md` §2, `docs/DEPLOYMENT.md` |
| Datenbank | MariaDB (STRATO) in Staging 📄; lokal SQLite. Enthält Gäste, Buchungen, Zahlungen, Sessions, Cache, Jobs | `docs/BETRIEB.md` §3, `database/migrations/*` |
| Dateispeicher | `storage/app` (privat: Vertrags-PDFs) und `storage/app/public` (Fotos, WebP-Größen); Spatie Media Library | `app/Documents/RentalContract.php`, `config/filesystems.php`, `config/media-library.php` |
| Sessions/Cache/Queue | `database`-Treiber; Queue `sync` (kein Worker) | `config/session.php`, `docs/BETRIEB.md` §5 |
| Mail | Staging: `MAIL_MAILER=log` (E-Mails landen im Logfile!); Produktion: Strato-SMTP 🗓/📄 | `docs/BETRIEB.md` §1/§5, `config/mail.php` |
| Postfach-Abruf | IMAP (Strato) für Portal-Benachrichtigungen, Staging aus, Produktion 🗓 | `app/Channels/Mail/MailboxReader.php`, `config/fewo.php` |
| Logging | Laravel-Log (Datei `storage/logs`, Level `debug` als Default); Slack/Papertrail-Kanäle nur als Framework-Defaults, nicht aktiv konfiguriert (❓ Produktiv-`.env`) | `config/logging.php` |
| Monitoring | Eigener Endpoint `/health/sync` (Token), geplant n8n als externer Wächter 📄 | `ChannelController::health`, `docs/KONZEPT.md` |
| Fehlerberichte | Kein Sentry/Bugsnag o. Ä. (nicht in `composer.json`) | `composer.json` |
| Drittanbieter-Pakete (lokal ausgeführt) | dompdf (PDF), webklex/php-imap, Filament, Spatie Media Library – keine ausgehenden Aufrufe an Dritte außer IMAP/SMTP | `composer.json` |
| Backups | ❓ Nicht belegt (Konzept: „Datenbank-Backups täglich“ 🗓); Strato-eigene Backups unbekannt | `docs/KONZEPT.md` Z. 153 |
### 2.2 Datenflussdiagramm
```mermaid
flowchart LR
G[Gast / Besucher<br/>Browser] -->|HTTPS| W[stommer.info bzw. fewo-stommer.de<br/>Laravel auf STRATO]
W -->|Anfrage-Formular: Name, E-Mail, Adresse, Telefon, Nachricht| DB[(MariaDB bei STRATO<br/>guests, bookings, payments,<br/>reviews, sessions, cache)]
W -->|SMTP| SM[STRATO Mail-Server]
SM -->|Bestätigungen, Erinnerungen, Vertrag| G
SM -->|Benachrichtigung neue Anfrage| V[Vermieterin<br/>fewo@… Postfach]
A[Admin /admin<br/>Rollen + 2FA] --> W
W --- FS[(storage: Vertrags-PDFs,<br/>Fotos, Logs)]
P1[FeWo-direkt u. a. Portale] -->|iCal-Import: Belegung ohne Gästedaten| W
W -->|iCal-Export 'Belegt'<br/>Token-URL, ohne Gästedaten| P1
P1 -->|Buchungs-E-Mail inkl. ggf. Gästedaten| PM[Postfach bei STRATO]
PM -->|IMAP jede Minute| W
N8N[n8n auf privatem Server 📄/🗓] -->|GET health / scheduler mit Token| W
W -->|optional Webhook, HMAC-signiert 📄| N8N
KI[KI-Agent 🗓] -.nicht implementiert.-> W
```
---
## 3. Verarbeitungstätigkeiten
Rechtsgrundlagen sind **Prüfannahmen** (juristisch zu bestätigen).
| # | Verarbeitung | Datenkategorien | Zweck | Quelle → Empfänger | Speicherort | Aufbewahrung / Löschung | Prüfannahme Rechtsgrundlage | Sicherheit | Status |
|---|---|---|---|---|---|---|---|---|---|
| V1 | Buchungsanfrage / Vorreservierung | Vor-/Nachname, E-Mail, Telefon (opt.), Anschrift (opt.), Reisedaten, Personenzahl, Extras, Preisangebot (JSON), freier Nachrichtentext, Herkunft (`referral_source`, `utm_*`) | Vertragsanbahnung, Verfügbarkeit halten | Gast → Vermieterin, STRATO (Hosting, SMTP) | Tabellen `guests`, `bookings` | Keine Löschung nach Ablauf/Ablehnung; nur Nachricht-Nullung + Anonymisierung nach `guest_retention_years` (10 J.) seit letztem Aufenthalt/Anlage, monatlicher Job `guests:anonymize` | Art. 6 (1) b; Herkunft/UTM ggf. Art. 6 (1) f | HTTPS (📄), Honeypot, IP-Rate-Limit 5/h, CSRF (Livewire), Validierung | ✅ `app/Livewire/BookingRequest.php`, `app/Actions/CreateReservation.php`, `app/Actions/AnonymizeGuests.php` |
| V2 | Eingangs-/Bestätigungs-E-Mails | Gästedaten, Preisangebot, Nachricht | Information, Vermieter-Benachrichtigung | Anwendung → Gast, Vermieterin | Strato-SMTP; Staging: Logfile | Mailversand-Kopien: ❓ (Strato-Postfach); Log-Rotation ❓ | Art. 6 (1) b | SMTP-Transportverschlüsselung ❓ | ✅ `app/Mail/*`, `resources/views/mail/*` |
| V3 | Bestätigung / verbindliche Buchung + Mietvertrag (PDF) | Gäste- und Buchungsdaten, Preise, Zahlungstermine | Vertragserfüllung, Abrechnung | Vermieterin → Gast | `storage/app/private/contracts/…pdf` (Disk `local`), Pfad in `bookings.contract_path` | **Nicht** durch Anonymisierung gelöscht (PDF enthält Namen/Anschrift) | Art. 6 (1) b, c (§ 147 AO) | Nicht öffentlich erreichbar; Download nur Admin | ✅ `app/Actions/ConfirmBooking.php`, `app/Documents/RentalContract.php` |
| V4 | Zahlungserfassung & -erinnerungen | Zahlbeträge, Datum, Methode, Notiz, erfassende Person; Bankdaten des Vermieters in Mail | Zahlungsabwicklung (manuell, Überweisung) | Vermieterin → Gast | `payments`; `FEWO_BANK_*` in `.env` | Buchhaltungsaufbewahrung (Steuerberater klären) | Art. 6 (1) b, c | Kein Zahlungsdienstleister, keine Kartendaten (**PCI-DSS nicht berührt**) | ✅ `app/Actions/RecordPayment.php`, `SendBookingReminders.php` |
| V5 | Ankunftsinformation, Bewertungsanfrage | E-Mail, Name, Reisedaten | Gästeservice | Anwendung → Gast | `bookings.*_sent_at` | s. V1 | Art. 6 (1) b bzw. (1) f (Bewertungsmail: juristisch prüfen, § 7 UWG) | Signierter, 90 Tage gültiger Link | ✅ `app/Actions/RequestReviews.php`, `app/Mail/ReviewRequest.php` |
| V6 | Bewertungen | Anzeigename, Bewertungstext, privates Feedback, Einwilligung zur Veröffentlichung, Aufenthaltsdatum | Qualitätssicherung, Veröffentlichung nach Freigabe | Gast → Vermieterin → öffentlich (bei Einwilligung) | `reviews` | **Keine** Löschung/Anonymisierung (nicht in `Guest::anonymize`) | Art. 6 (1) a (Veröffentlichung), (1) f | Moderation (Status Pending) | ✅ `app/Actions/SubmitReview.php`, `app/Livewire/ReviewForm.php` |
| V7 | Newsletter / Angebots-E-Mails | E-Mail, Name, Einwilligungszeitpunkt | Marketing | Gast (Opt-in im Formular) → Vermieterin | `guests.marketing_consent_at` | Widerruf per Abmeldelink; Anonymisierung entfernt Consent | Art. 6 (1) a, § 7 (2) UWG (DOI) | Signierte Links, DOI (14 Tage). **Hinweis:** Versandfunktion von Angebots-Mails selbst im Code nicht gefunden – nur Consent + CSV-Export | ✅ (Consent) / ❓ (Versand) `MarketingConsentController`, `RequestMarketingConsent`, `ListGuests` Export |
| V8 | Gästekartei (CRM) | Stammdaten, Notizen, Tags, Aufenthalte | Kundenpflege | Vermieterin | `guests` (Notizen, Tags) | s. V1; Notizen/Tags bei Anonymisierung gelöscht ✅ | Art. 6 (1) f | Policy: nur Rolle `rentals` (+admin) | ✅ `app/Models/Guest.php`, `app/Filament/Resources/Guests` |
| V9 | CSV-Export Gäste | Alle Stammdaten nicht anonymisierter Gäste | Mailing/Verwaltung | Admin-Download | Browser des Admins | Verantwortung beim Nutzer; kein Export-Log | Art. 6 (1) f | Nur eingeloggte Rolle; kein Audit-Log ❓ | ✅ `app/Filament/Resources/Guests/Pages/ListGuests.php` |
| V10 | Portal-Kalenderabgleich (iCal) | Nur Zeiträume („Belegt“); keine Gästedaten | Doppelbuchungen vermeiden | Portal ↔ Anwendung | `blocked_periods`, `channels`, `channel_sync_logs` | – | Art. 6 (1) b/f (kein Personenbezug im Feed) | Token-URL (`export_token`), Throttle 60/min | ✅ `app/Channels/ICal/*`, `ChannelController::feed` |
| V11 | Portal-Buchungs-E-Mails (Schnellpfad) | Absender, Betreff, **500-Zeichen-Auszug des Mailtextes** (kann Gästedaten enthalten), Referenz, Zeitraum | Sofortige Sperre | Portal → IMAP-Postfach → Anwendung → Vermieterin | `portal_emails`; Postfach | **Keine Löschfrist, keine Anonymisierung** | Art. 6 (1) b/f | IMAP über SSL, Zertifikatsprüfung; Parsing, „nie raten“ | ✅ Code / 🗓 Produktivbetrieb. `ProcessPortalMail`, `MailboxReader` |
| V12 | Admin-Konten | Name, E-Mail, Passwort-Hash, Rolle, 2FA-Secret (verschlüsselt), Sessions | Zugriff Verwaltung | Admin | `users`, `sessions` | bis Löschung durch Admin | Art. 6 (1) f | bcrypt, Pflicht-2FA (Admins), Session `AuthenticateSession` | ✅ `AdminPanelProvider`, `RequireTwoFactorForAdmins` |
| V13 | Server-/Anwendungs-Logs & Sessions | IP-Adresse, User-Agent (Tabelle `sessions`), Zeit, Fehler-Stacktraces (ggf. mit Daten), Rate-Limit-Schlüssel mit IP (Cache) | Betrieb, Sicherheit, Missbrauchsschutz | Besucher → Hosting | `sessions`, `cache`, `storage/logs`, STRATO-Webserver-Logs (❓) | Session-Lifetime 120 min, aber Zeilen werden bis Garbage-Collection vorgehalten; Log-Rotation ❓ | Art. 6 (1) f | – | ✅ `0001_01_01_000000_create_users_table.php`, `config/session.php`; Webserver-Logs ❓ |
| V14 | Analyse / Tracking | – | – | – | – | – | – | – | ✅ **nicht vorhanden** (kein Matomo/GA/Pixel) |
| V15 | Automation/Webhook (n8n) | Aufgabeninhalte (Sperr-Aufgaben: Zeiträume, ggf. Referenz), Health-Status | Portalsperre, Überwachung | Anwendung ↔ privater Server | extern ❓ | ❓ | ❓ | HMAC-SHA256, Token | 📄 `config/fewo.php` (`automation`), `docs/PORTALE.md` |
| V16 | KI-gestützte Buchungsbearbeitung | – | – | – | – | – | – | – | 🗓 **kein Code vorhanden** |
---
## 4. Externe Dienste und Empfänger
| Dienst | Rolle | Daten | Belegt in | Status | Offene Punkte |
|---|---|---|---|---|---|
| **STRATO AG** (Hosting, DB, SMTP/IMAP, Domains) | Auftragsverarbeiter (vermutlich) | Alle Anwendungsdaten, E-Mails, Logs | `docs/BETRIEB.md` | ✅/📄 | AVV-Abschluss prüfen; Serverstandort/Backup-Verhalten ❓; Mail-Kanal TLS ❓ |
| **OpenStreetMap** | Nur *Verlinkung* (kein Einbetten) | Adresse als URL-Parameter nur bei Klick des Besuchers auf `https://www.openstreetmap.org/search?query=…`; **keine Tile-Server-Anfragen** beim Seitenaufruf | `app/Themes/Sections/LocationSection.php`, `resources/themes/ostsee-licht/views/sections/location.blade.php` | ✅ | Bei Klick Übermittlung IP an OSMF (Datenschutzerklärung erwähnen). Falls später eingebettete Karte: Einwilligung/2-Klick |
| **Schriftarten** | Selbst gehostet (`@fontsource`, vom Build gebündelt) | – | `resources/themes/ostsee-licht/theme.css`, `docs/THEMES.md` | ✅ | Im gebauten Output stichprobenartig prüfen (kein `fonts.googleapis`) |
| **Externe Skripte/CDNs/Bilder** | Keine gefunden (`grep` über `resources/`, nur `schema.org`-Kennung und `sitemaps.org`-Namespace als Bezeichner, keine Abrufe) | – | `resources/**` | ✅ | Browser-Verifikation nötig (❓) |
| **FeWo-direkt / Vrbo / weitere Portale** | Eigenständig Verantwortliche für ihre Gästedaten; Empfänger/Absender von iCal | iCal: nur Zeiträume. Portal-Mails: ggf. Gästedaten | `app/Channels/*`, `docs/PORTALE.md` | ✅ iCal / 📄 Portal-Mail | Prüfen, welche Gästedaten die Portal-Mails tatsächlich enthalten |
| **n8n / privater Server (FastAPI, Playwright)** | Unabhängiger Wächter / Browser-Bot | Health-Status; ggf. Sperr-Aufgaben | `docs/KONZEPT.md` Z. 139, `docs/PORTALE.md` Z. 89 | 📄/🗓 | Standort, Betreiber, Logs, AVV ❓ (privat betrieben → Haushaltsausnahme gilt hier nicht automatisch) |
| **Gitea (gitea.stommer.de)** | Code-Repository/CI | Kein Gästedatenfluss (Repo enthält keine `.env`; Fotolisten-CSV) | `CLAUDE.md`, `.gitignore` | ✅ | Prüfen, dass nie Echtdaten/DB-Dumps committet werden |
| **KI-Anbieter** | – | – | – | 🗓 nicht vorhanden | s. §5/§6 |
| **Slack/Papertrail/AWS/Postmark/Resend** | Nur Framework-Platzhalter in Configs, nicht aktiv | – | `config/logging.php`, `config/services.php` | 📄 | Sicherstellen, dass Produktiv-`.env` sie nicht aktiviert |
---
## 5. Gap-Analyse mit Risikopriorität
Priorität: **K** = kritisch (Blocker für Go-Live), **H** = hoch, **M** = mittel, **N** = niedrig.
| ID | Prio | Befund | Beleg | Empfehlung |
|---|---|---|---|---|
| G1 | **K** | Datenschutzerklärung und Impressum haben keinen Inhalt (`default => null`); Link-Pflicht Art. 13 DSGVO / § 5 DDG | `config/content.php` Z. 48–49, `SiteSeeder.php` | Texte erstellen/juristisch prüfen lassen, bevor Produktion indexiert wird; Faktenbasis siehe §8 |
| G2 | **K** | Einwilligungstext im Formular ist ein Einverständnis zur Speicherung „(siehe Datenschutzerklärung)“ – Verlinkung/Art. 13-Information unklar; Rechtsgrundlage Vertragsanbahnung braucht eigentlich keine Einwilligung | `resources/views/livewire/booking-request.blade.php` Z. 204–207 | Text auf Information umstellen, Link auf Datenschutzerklärung und Hinweis auf Pflichtfelder; juristisch prüfen |
| G3 | **H** | Anonymisierung unvollständig: Vertrags-PDFs, `portal_emails.excerpt`, `bookings.internal_notes`, `bookings.utm_*`, Reviews (`display_name`, `private_feedback`), Zahlungsnotizen | `app/Models/Guest.php::anonymize` | Löschkonzept: je Datenkategorie Frist definieren (§ 147 AO: 6/8/10 Jahre – nur steuerlich relevante Unterlagen); PDFs nach Frist löschen; Auszüge/Notizen leeren; Reviews anonymisieren |
| G4 | **H** | Keine Löschung von Anfragen ohne Vertragsabschluss (Reserved/Expired/Declined) vor 10 Jahren | `AnonymizeGuests`, `ExpireReservations` | Eigene, kürzere Frist (z. B. Monate bis wenige Jahre – juristisch festlegen) und Job |
| G5 | **H** | Backups nicht belegt; Wiederherstellbarkeit, Verschlüsselung, Aufbewahrung, Löschung aus Backups ❓ | `docs/KONZEPT.md` | Backup-Verfahren dokumentieren (Strato-Backup oder eigener `mysqldump`), Retention an Löschkonzept koppeln |
| G6 | **H** | Betriebsgeheimnisse als Query-Parameter (`?token=`) → Logs/Proxys | `ChannelController::health/scheduler` | Token per Header (`Authorization`/`X-Token`) statt Query; Webserver-Logs auf Tokens prüfen |
| G7 | **H** | n8n/privater Server mit Zugriff auf Betriebsdaten und evtl. Gästedaten; Rolle (Auftragsverarbeiter/eigenverantwortlich) und Absicherung unklar | `docs/PORTALE.md` Z. 89 | Datenfluss minimieren (keine Gästedaten in Webhooks), Standort/Logs dokumentieren, ggf. AVV/TOMs |
| G8 | **H** | Logfile als Mailkanal in Staging; im Produktivbetrieb `LOG_LEVEL=debug`-Default; Logs können personenbezogene Daten enthalten (Exceptions, Mails) | `config/logging.php`, `docs/BETRIEB.md` | Produktiv: `LOG_LEVEL=warning`/`error`, `LOG_CHANNEL=daily` mit Rotation (`LOG_DAILY_DAYS`), `MAIL_MAILER=smtp`; keine Daten in Exception-Meldungen |
| G9 | **M** | Cookies: nach Code (Standard-Laravel-`web`-Stack) werden `…-session` und `XSRF-TOKEN` bei jedem Seitenaufruf gesetzt (technisch notwendig → i. d. R. kein Banner, aber Information in DSE und TDDDG-Prüfung). **Nicht im Browser verifiziert** | `bootstrap/app.php`, `config/session.php` | Browser-Test (DevTools), Cookie-Tabelle für DSE; Local/Session Storage: im eigenen JS nicht genutzt ✅ |
| G10 | **M** | Session-Tabelle speichert IP + User-Agent aller Besucher (mit Session) | `0001_01_01_000000_create_users_table.php` | Gesetzten Zweck/Löschfrist dokumentieren; ggf. Session nur für Seiten mit Formular starten |
| G11 | **M** | Sicherheits-Header nicht im Code gesetzt (CSP, HSTS, X-Frame-Options, Referrer-Policy, Permissions-Policy) | Grep über `app/`, `bootstrap/`, `public/.htaccess` | Per Middleware oder `.htaccess` ergänzen; HSTS erst nach HTTPS-Prüfung |
| G12 | **M** | Review-Link (signiert, 90 Tage) ohne Throttle; Signatur schützt, aber Brute-Force/Spam auf Formular begrenzen | `routes/web.php` | `throttle` ergänzen |
| G13 | **M** | Zugriff ohne Kundenkonto: Gäste erhalten keine Online-Einsicht – Auskunfts-/Löschwünsche laufen manuell; Löschung eines einzelnen Gastes nur über „Anonymisieren“ (Aktion im Admin, Code `Guest::anonymize`) | `app/Models/Guest.php` | Prozess für Betroffenenrechte (Art. 15–21) dokumentieren, Frist 1 Monat |
| G14 | **M** | Kein Audit-Log für Admin-Zugriffe/Exporte/Statuswechsel (nur Zahlungs-`recorded_by`, Sync-Logs) | – | Minimal-Protokoll für Export, Anonymisierung, Statuswechsel erwägen |
| G15 | **M** | Admin-Rollen: `rentals` darf Gäste exportieren; 2FA nur für `admin` verpflichtend | `GuestPolicy`, `AdminPanelProvider` | 2FA für `rentals` ebenfalls verpflichtend erwägen |
| G16 | **M** | Selbstregistrierung/Passwort-Reset: Reset-Mails und Passwortrichtlinie nicht geprüft | – | Prüfen (❓) |
| G17 | **M** | Dev-Zugangsdaten (`admin@example.com`/`password`) in Doku für lokale Entwicklung; Sicherstellen, dass Seeder nie in Produktion läuft | `docs/BETRIEB.md` §7 | In Produktion nur `ProductionSeeder` (bereits dokumentiert ✅) |
| G18 | **M** | Prozessbeschreibung Angebot/Annahme fehlt: Status kennen weder „Angebot versandt“ noch „vom Gast angenommen“; „Bestätigt“ = Verbindlichkeit durch Vermieterin, Mail „Erst mit unserer Bestätigung ist die Buchung verbindlich“ | `BookingStatus`, `reservation-received.blade.php` | Vertragsmechanik (Annahme durch Gast) rechtlich klären und – falls gewünscht – implementieren; DSE-Text entsprechend |
| G19 | **N** | OSM-Link überträgt Adresse nur bei Klick | `LocationSection.php` | In DSE erwähnen |
| G20 | **N** | UTM-/Herkunftsdaten werden zusammen mit Buchung gespeichert | `BookingRequest.php`, `CreateReservation.php` | Zweck/Rechtsgrundlage in DSE; Löschfrist festlegen |
| G21 | **N** | Fotos: Kein EXIF-Stripping im Code gefunden (GPS-Daten in Fotos möglich) | Grep `exif` negativ | Prüfen, ob WebP-Konvertierung Metadaten entfernt |
| G22 | **N** | Review-Anonymität: `display_name` Freitext; Veröffentlichung nur bei `publish_consent` | `ReviewForm` | Hinweis im Formular auf Pseudonym |
### KI-spezifische Lücken (🗓, vorausschauend)
- **K (vor Einführung):** Anbieter, Modell, Region (EU/EWR vs. Drittland), AVV, Zero-Data-Retention/Opt-out vom Training, Subprozessoren – alle ❓.
- **H:** Art. 22 DSGVO: Preise/Angebote/Ablehnungen nicht vollautomatisch ohne menschliche Freigabe; aktuell hat kein Code KI-Entscheidungsbefugnisse (✅ Entscheidungen manuell in Admin: `ConfirmBooking`, `DeclineBooking`).
- **H:** Datenminimierung: Pseudonymisierung vor Übergabe an KI (keine Namen/Anschriften), Prompt-/Antwort-Logging mit Löschfrist, Audit-Log je KI-Aktion.
- **M:** DSFA-Pflicht prüfen (Datenschutzbeauftragte/r / Rechtsberatung); KI-Transparenz (Art. 13 (2) f.).
---
## 6. Offene Fragen
1. Wer ist Hosting-Vertragspartner (Strato-Vertrag, AVV abgeschlossen?) und wo liegen Server/Backups?
2. Wird für die Produktion ein Cookie-/TDDDG-Konzept benötigt, oder bleibt es bei rein technischen Cookies? (Browserverifikation fehlt)
3. Welche Gästedaten enthalten die FeWo-direkt-/Vrbo-Buchungsmails tatsächlich (Name, E-Mail, Telefon)? Werden diese in `portal_emails.excerpt` gespeichert?
4. Welche Aufbewahrungsfristen gelten für: Anfragen ohne Vertrag, Verträge/Rechnungen, Zahlungsnachweise, Bewertungen, Marketing-Einwilligungen? (Steuerberatung/Rechtsberatung)
5. Wie wird der Versand der Angebots-/Newsletter-Mails technisch erfolgen? (Im Code nur Einwilligung + CSV-Export gefunden – wird extern versendet? Dann Dienstleister/AVV.)
6. Wo läuft n8n (Standort, Betreiber), welche Daten erhält es, wie wird abgesichert?
7. Welcher Anbieter/welches Modell soll für die KI-gestützte Buchungsbearbeitung genutzt werden, mit welchen Daten, in welcher Region, mit welcher menschlichen Freigabe?
8. Werden Server-Zugriffslogs bei Strato geführt, wie lange, und sind IP-Adressen gekürzt?
9. Wie wird ein Backup/Restore getestet, und wie werden Löschungen in Backups umgesetzt?
10. Ist ein Verarbeitungsverzeichnis (Art. 30) vorhanden? Ist die Benennung eines Datenschutzbeauftragten erforderlich?
11. Gibt es weitere Empfänger (Steuerberater, Buchhaltung, Kurverwaltung/Meldeschein, Kurtaxe)?
12. Soll es einen verbindlichen Angebots-/Annahmeprozess im System geben (G18)?
13. Wird in der Produktion ein eigener Cookie-Banner/Einwilligungs-Mechanismus benötigt (derzeit **kein** Mechanismus vorhanden)?
---
## 7. Maßnahmenplan für die Produktivsetzung
**Vor Go-Live (Blocker)**
1. Impressum und Datenschutzerklärung erstellen und rechtlich prüfen lassen; Verlinkung im Footer und im Formular (G1, G2).
2. AVV mit STRATO prüfen/abschließen; Verarbeitungsverzeichnis anlegen.
3. Produktiv-`.env`: `APP_ENV=production`, `APP_DEBUG=false`, `LOG_LEVEL` ≥ warning, `LOG_CHANNEL=daily`, `MAIL_MAILER=smtp` mit TLS, `SESSION_SECURE_COOKIE=true` (G8).
4. Backup-Verfahren einrichten und Restore testen (G5).
5. Löschkonzept festlegen und umsetzen (G3, G4); Datenschutzerklärung entsprechend ausrichten.
6. Browser-Verifikation: Netzwerk-/Cookie-Analyse auf Staging (G9), Ergebnis in DSE übernehmen.
7. Security-Header ergänzen (G11); Tokens aus der Query in Header verlegen (G6).
**Kurzfristig nach Go-Live**
8. 2FA auch für Rolle `rentals` (G15); Audit-Log für Export/Anonymisierung (G14); Throttle Review-Route (G12).
9. Betroffenenrechte-Prozess dokumentieren (G13).
10. n8n-Datenfluss dokumentieren und minimieren (G7).
**Vor KI-Einsatz**
11. DSFA-/Risikoprüfung, Anbieterwahl, AVV, Drittlandfrage, Pseudonymisierung, menschliche Freigabe bei Preis/Angebot/Annahme/Ablehnung, Audit-Log (KI-Abschnitt §5).
---
## 8. Faktenbasis für die neue Datenschutzerklärung
*(Faktenlage aus dem Code – Text und Rechtsgrundlagen juristisch zu formulieren.)*
| Thema | Faktenbasis | Status |
|---|---|---|
| Verantwortliche | Brigitte Stommer (Name/Anschrift/Kontakt aus `config/fewo.php`, `legal.imprint`) | 📄 |
| Hosting | STRATO (Webspace, Datenbank, E-Mail) | 📄 |
| Server-Logfiles | Beim Aufruf fallen technisch IP, Zeit, URL, User-Agent im Hosting an (Strato-Standard, ❓) | ❓ |
| Cookies | Session-Cookie und XSRF-Token (technisch notwendig), Laufzeit bis Ende der Session/120 Minuten; kein Tracking | ✅ Code / ❓ Browser |
| Local/Session Storage | Von der Anwendung nicht verwendet | ✅ |
| Schriftarten | Lokal eingebunden | ✅ |
| Karten | Nur Link zu OpenStreetMap (Klick); keine Einbettung | ✅ |
| Analyse/Marketing-Tracking | Keine | ✅ |
| Buchungsanfrage | Pflichtfelder: Anreise, Abreise, Personen, Vorname, Nachname, E-Mail, Zustimmung; optional: Telefon, Anschrift, Nachricht, Herkunft, Newsletter | ✅ |
| Speicherung | Datenbank bei STRATO; Anonymisierung nach `guest_retention_years` (Standard 10 Jahre) | ✅ / Frist juristisch ❓ |
| E-Mails | Eingangsbestätigung, Buchungsbestätigung mit Vertrag (PDF), Zahlungserinnerung, Ankunftsinfo, Bewertungsanfrage, ggf. Ablehnung | ✅ |
| Newsletter | Opt-in im Formular + Double-Opt-in-Link (14 Tage), Abmeldelink in Mails; Widerruf jederzeit | ✅ |
| Bewertungen | Freiwillig, Veröffentlichung nur bei Einwilligung und Freigabe | ✅ |
| Zahlungen | Überweisung, manuelle Erfassung; kein Zahlungsdienstleister | ✅ |
| Portale | Kalenderabgleich per iCal ohne Gästedaten; Auswertung von Portal-Benachrichtigungs-E-Mails (nur 500 Zeichen Auszug, Zeiträume) | ✅ Code / 🗓 Produktiv |
| Empfänger | STRATO (Hosting/Mail); ggf. Portalbetreiber; ggf. Steuerberater | ❓ |
| Drittlandübermittlung | Keine bekannt (✅ nach Code) – Strato-Subunternehmer ❓ | ❓ |
| KI | Derzeit **keine** KI-Verarbeitung; bei Einführung DSE aktualisieren | 🗓 |
| Betroffenenrechte | Art. 15–21, Beschwerderecht – Texte juristisch zu formulieren | ❓ |
| Automatisierte Entscheidungen | Keine (alle Statuswechsel manuell durch Vermieterin) | ✅ |
---
### Anhang: wichtigste Quelldateien
`app/Livewire/BookingRequest.php`, `app/Actions/{CreateReservation,ConfirmBooking,DeclineBooking,ExpireReservations,RecordPayment,AnonymizeGuests,RequestMarketingConsent,SubmitReview,RequestReviews,SendBookingReminders,ProcessPortalMail}.php`, `app/Models/Guest.php`, `app/Channels/**`, `app/Http/Controllers/{ChannelController,MarketingConsentController}.php`, `routes/web.php`, `routes/console.php`, `config/{fewo,channels,session,logging,mail,filesystems,content}.php`, `database/migrations/*`, `resources/themes/ostsee-licht/**`, `docs/{BETRIEB,DEPLOYMENT,KONZEPT,PORTALE,THEMES}.md`.
+5 -1
View File
@@ -48,7 +48,7 @@ ## 4a. Theme- und Vorlagensystem (Entscheidungen vom 22.10.2026 – umgesetzt, D
- **Themes** (Design) als Code-Pakete mit Manifest, eigenen Vorlagen und eigenem CSS; was ein Theme nicht mitbringt, kommt aus einem vollständigen **Basis-Theme** (Child-Theme-Prinzip). Erstes Theme: **„Ostsee-Licht“** (Entwurf A, orientiert an der bisherigen Webseite). Die Entwürfe B/C können später als weitere Themes folgen.
- **Bausteinsystem (geführt):** Seiten werden aus einem festen Katalog von Abschnitten zusammengestellt (Reihenfolge, Sichtbarkeit); Seiten und Menüs können je Ausrichtung unterschiedlich sein. Keine freie Seitengestaltung.
- **Saisonale Erscheinungsbilder:** wechseln Fotos, Texte, Farben/Akzente, Banner und hervorgehobene Angebote – nicht den Aufbau. Zeitplan jährlich wiederkehrend mit Priorität und Standard; Vorschau-Link vor Aktivierung. Startset: **Sommer** (Strand, Baden), **Winter** (raue See, stimmungsvoller Himmel), **Weihnachten** (gemütlich, besinnlich), **Silvester** (Party, Feuerwerk). Klickbare Vorschau: lokale HTML-Datei (Scratchpad der Sitzung).
- **Saisonale Erscheinungsbilder:** wechseln Fotos (Titelbild und **Bilder je Baustein**), Texte, Farben/Akzente und Banner – nicht den Aufbau. Bausteine können **nur in bestimmten Erscheinungsbildern** erscheinen (z. B. ein Weihnachts-Baustein). Sonderangebote werden seit 22.10.2026 **unabhängig** davon nach eigenen Regeln beworben (5a). Zeitplan jährlich wiederkehrend mit Priorität und Standard; Vorschau-Link vor Aktivierung. Startset: **Sommer** (Strand, Baden), **Winter** (raue See, stimmungsvoller Himmel), **Weihnachten** (gemütlich, besinnlich), **Silvester** (Party, Feuerwerk). Klickbare Vorschau: lokale HTML-Datei (Scratchpad der Sitzung).
- **Mehrfähigkeit offen halten:** „Site“ = Domain + Theme/Erscheinungsbilder + angezeigte Wohnungen; kein Portal, aber andere Vermieter könnten die Funktionen über eine eigene Domain nutzen (Mandantenfähigkeit vorbereiten, nicht ausbauen).
- **Plugins:** Theme- und Baustein-Plugins als Composer-Pakete (Registry wie bei den Portal-Connectoren); Auslieferung per Deployment – kein Upload von Vorlagen im Admin (Sicherheit).
- **Strato:** CSS aller Themes wird beim Deployment gebaut; Seiten-Cache je Erscheinungsbild.
@@ -88,6 +88,10 @@ ## 5a. Sonderangebote & Sonderkonditionen
Rabatte gelten auf den Übernachtungspreis (nicht auf Endreinigung/Extras); die Anzahlung wird auf den rabattierten Mietpreis berechnet. Treffen mehrere Angebote zu, erhält der Gast automatisch die günstigere Variante: das beste Einzelangebot **oder** die Summe aller als „kombinierbar“ markierten Angebote.
**Angebotsarten** (Entscheidung 22.10.2026): **Rabattaktion** (nur Bedingungen, z. B. Last Minute, „ab 3 Nächten −10 %“, 7 = 6, Special Weekend) · **Fester Termin** (genau diese An-/Abreise, z. B. „Ostsee-Woche 07.–14.11.“, oft mit **Pauschalpreis** für alle Nächte) · **Lückenfüller** (freie Lücken bis N Nächte zwischen zwei Belegungen, automatisch erkannt; kann den Mindestaufenthalt der Saison aufheben). Im Admin gibt es Vorlagen für die typischen Fälle.
**Bewerbung unabhängig vom Erscheinungsbild** (`App\Pricing\OfferShowcase`): gezeigt werden aktive, öffentliche Angebote ohne Code im Buchungszeitraum; feste Termine nur solange frei; Lückenfüller mit bis zu drei konkreten Lücken. Feste Termine und Lücken werden mit dem `PriceCalculator` gerechnet – der beworbene Preis ist exakt der spätere Angebotspreis („499 € statt 640 €“, Link mit vorausgefüllten Daten). Reihenfolge: hervorgehoben → Priorität → frühestes Datum. Gelten mehrere gleichzeitig, zeigt der Baustein sie wahlweise **nebeneinander, als Liste oder rollierend**; das wichtigste hervorgehobene Angebot erscheint optional im Titelbereich.
## 6. Workflows
```
+244
View File
@@ -0,0 +1,244 @@
# Neues Theme erstellen – verbindliche Bauanleitung
Stand: 22.10.2026 · gilt für jede Design-Sitzung (z. B. auf dem privaten Rechner mit dem Skill/Plugin `frontend-design`) · Architektur und Datenverträge: [THEMES.md](THEMES.md)
> **Kurz:** Ein neues Design entsteht als **zusätzliches Theme** in einem eigenen Ordner `resources/themes/<key>/`. Das vorhandene Theme **„Ostsee-Licht“ wird nicht verändert**. Das neue Theme erbt alles, was es nicht selbst mitbringt, wird mit `php artisan themes:check <key>` geprüft, per Vorschau-Link angesehen und erst dann im Admin für die Website ausgewählt. Zurück geht es jederzeit durch Auswahl des alten Themes.
---
## 1. Grundregeln (nicht verhandelbar)
1. **Nur im eigenen Ordner arbeiten:** `resources/themes/<key>/**`. Zusätzlich erlaubt: `package.json`/`package-lock.json` für **selbst gehostete Schriften** (`@fontsource/*`). Alles andere bleibt unangetastet, insbesondere `resources/themes/ostsee-licht/**`, `app/**`, `config/**`, `database/**`, `routes/**`, `resources/views/livewire/**`.
2. **Neues Theme immer mit `php artisan themes:make <key>` anlegen.** Der Befehl erzeugt das korrekte Format und überschreibt nie einen vorhandenen Ordner.
3. **Nur Optik:** Blade-Vorlagen, CSS, etwas JavaScript, Farb-Tokens. Keine Datenbankabfragen, keine Geschäftslogik und keine neuen PHP-Klassen in Vorlagen. Daten kommen fertig aufbereitet aus den Bausteinen (Variablen siehe [THEMES.md §4–5](THEMES.md)).
4. **Farben nur über Tokens** (`bg-accent`, `text-muted` …), nie fest (`#123456`, `text-blue-700`, `bg-[#…]`, `style="color:#…"`). Sonst wirken die saisonalen Erscheinungsbilder nicht. Ausnahme ohne Saisonbezug: `text-white`/`bg-black` auf Fotos und Overlays.
5. **Nichts von fremden Servern laden:** keine Google Fonts, CDNs, externen Skripte, eingebetteten Karten oder Videos von Drittanbietern. Grund: DSGVO, und die Seite kommt so ohne Cookie-Banner aus.
6. **Pflicht-Markup erhalten** (§6): Verfügbarkeitssuche, Buchungsformular, Lightbox, rollierende Angebote, Echtheitshinweis der Bewertungen, JSON-LD, `noindex` in der Vorschau.
7. **Fertig ist ein Theme erst, wenn** `php artisan themes:check <key>` ohne Fehler, `npm run build` fehlerfrei und `php artisan test --compact` grün ist und die Checkliste in §10 abgehakt ist.
## 2. Schnellstart
```bash
git pull # aktuellen Stand holen
composer install && npm ci # einmalig auf dem Rechner
cp .env.example .env && php artisan key:generate # einmalig, lokale SQLite-Datenbank …
touch database/database.sqlite # … als leere Datei anlegen (PowerShell: New-Item database/database.sqlite)
php artisan migrate:fresh --seed # Testdaten: Wohnung, Seiten, 5 Erscheinungsbilder
php artisan photos:import <Ordner> --manifest=database/data/wordpress-photos.csv # optional: echte Fotos (siehe BETRIEB.md)
php artisan themes:make ostsee-nacht --name="Ostsee-Nacht" --description="Dunkel, ruhig, großformatige Fotos"
# → resources/themes/ostsee-nacht/ (erbt zunächst alles von Ostsee-Licht)
npm run dev # oder npm run build
php artisan serve # http://localhost:8000 · Admin: /admin (admin@example.com / password, 2FA beim ersten Login einrichten)
php artisan themes:preview ostsee-nacht # Vorschau-Links: jede Seite × jedes Erscheinungsbild
php artisan themes:check ostsee-nacht # Prüfung gegen diese Anleitung
```
**Key wählen:** Kleinbuchstaben, Ziffern und Bindestriche; Ordnername gleich Key, z. B. `ostsee-nacht`, `kuestenmagazin`. Der Key ist dauerhaft, weil die Website ihn speichert. Der Anzeigename (`name`) darf sich ändern.
## 3. Aufbau eines Themes
```
resources/themes/<key>/
├── theme.json Manifest (Pflicht)
├── theme.css Vite-Einstiegspunkt CSS (Pflicht, sobald das Theme eigenes CSS hat – themes:make legt es an)
├── theme.js Vite-Einstiegspunkt JS (Pflicht zusammen mit theme.css)
├── README.md kurze Beschreibung, welche Vorlagen überschrieben sind
└── views/
├── layouts/app.blade.php optional: Grundgerüst (<head>, Banner, Kopf, Inhalt, Fuß, Lightbox)
├── page.blade.php optional: Ausgabe der Bausteine einer Seite
├── partials/ optional: banner, header, footer, image, mobile-booking-bar + eigene Includes
└── sections/<baustein>.blade.php optional: je Baustein eine Vorlage (Liste in §5)
```
**Vererbung:** Jede Vorlage, die im Theme fehlt, kommt vom Eltern-Theme (`parent`) und zuletzt vom Basis-Theme „Ostsee-Licht“. Ein frisch angelegtes Theme sieht daher genauso aus wie Ostsee-Licht. Man überschreibt Schritt für Schritt nur, was anders werden soll. Für ein komplett neues Design werden in der Regel alle Vorlagen überschrieben. Ausgangspunkt ist dann jeweils die gleichnamige Datei aus `resources/themes/ostsee-licht/views/`: in den eigenen Ordner **kopieren** und umgestalten, das Original nicht ändern.
### 3.1 `theme.json`
```json
{
"key": "ostsee-nacht",
"name": "Ostsee-Nacht",
"version": "0.1.0",
"parent": "ostsee-licht",
"description": "Dunkel, ruhig, großformatige Fotos",
"assets": {
"css": "resources/themes/ostsee-nacht/theme.css",
"js": "resources/themes/ostsee-nacht/theme.js"
},
"tokens": {
"ground": { "label": "Hintergrund", "default": "#0F1A22" },
"accent": { "label": "Akzent (Buttons, Hervorhebungen)", "default": "#E8B04A" }
}
}
```
| Feld | Regel |
|---|---|
| `key` | = Ordnername, `^[a-z0-9]+(-[a-z0-9]+)*$` |
| `name`, `description` | erscheinen im Admin bei der Theme-Auswahl |
| `version` | `MAJOR.MINOR.PATCH`; bei jeder Auslieferung erhöhen |
| `parent` | in der Regel `ostsee-licht`; auch ein anderes installiertes Theme ist möglich |
| `assets.css` / `assets.js` | **genau** `resources/themes/<key>/theme.css` bzw. `theme.js`: Nur diese Dateien baut `vite.config.js` automatisch. Hat ein Theme eigene Assets, ersetzen sie die des Eltern-Themes **vollständig** (deshalb importieren beide Dateien das Eltern-Theme, §3.2/3.3). |
| `tokens` | Farbwerte als `#RRGGBB` mit deutschem `label`. `themes:make` übernimmt alle geerbten Tokens; die Defaults sind neu zu setzen. Alle 12 Basis-Tokens müssen in der Kette vorhanden sein. Neue Tokens sind erlaubt (§4). |
### 3.2 `theme.css` (so legt `themes:make` sie an)
```css
@import 'tailwindcss';
@import '../ostsee-licht/theme-base.css'; /* Schriften, Token-Mapping, Basis-Klassen des Eltern-Themes */
/* eigene Schriften – selbst gehostet */
@import '@fontsource/fraunces/400.css';
/* Vorlagen, deren Tailwind-Klassen gebaut werden – alle drei Zeilen sind Pflicht */
@source '../ostsee-licht/views'; /* geerbte Vorlagen */
@source '../../views/livewire'; /* Buchungs- und Bewertungsformular */
@source './views'; /* eigene Vorlagen */
@theme inline {
--font-display: 'Fraunces', Georgia, serif;
--font-sans: 'Inter', ui-sans-serif, system-ui, sans-serif;
/* neues Token: */
--color-glow: var(--glow);
}
@layer components {
.heading-display { /* Basis-Klassen dürfen neu definiert werden */ }
}
```
- **Tailwind v4** (kein `tailwind.config.js`, keine `@apply` auf eigene Klassen).
- `theme-base.css` des Eltern-Themes liefert: Schriften von Ostsee-Licht, das Mapping aller Tokens auf Tailwind-Farben (`--color-<token>: var(--<token>)`), Formular-Grundstile, Fokusrahmen, `prefers-reduced-motion`. Dazu kommen die Klassen, die geerbte Vorlagen und die Formulare nutzen: `.eyebrow`, `.heading-display`, `.btn-primary`, `.btn-accent`, `.prose-theme`, `.reveal`. **Wer `theme-base.css` nicht importiert, muss all das selbst bereitstellen.** `themes:check` prüft Mapping und Quellen.
- **Nicht** `../ostsee-licht/theme.css` importieren, sondern `theme-base.css`. Die Quellen gibt das neue Theme selbst an.
### 3.3 `theme.js`
```js
import '../ostsee-licht/theme.js'; // Lightbox, Verfügbarkeitssuche, rollierende Angebote
// eigene, kleine Verbesserungen – progressive enhancement: ohne JS muss alles funktionieren
```
Kein Framework (React/Vue/Alpine-Komponenten), keine externen Skripte. Livewire/Alpine lädt das Layout bereits für das Buchungsformular.
## 4. Farben und Tokens
- Das Layout gibt die Tokens als CSS-Variablen aus (`:root{--accent:#…}`). Die Reihenfolge ist: Theme-Standard → Website (Admin › System › Websites › Farben) → Erscheinungsbild (Admin › Webseite › Erscheinungsbilder › Farben).
- Basis-Tokens (Bedeutung **nicht** umdeuten, nur neu einfärben):
| Token | Tailwind | Verwendung |
|---|---|---|
| `ground` | `bg-ground` | Seitenhintergrund |
| `surface` | `bg-surface` | Karten, Formulare |
| `ink` | `text-ink` | Haupttext |
| `muted` | `text-muted` | Nebentext |
| `line` | `border-line` | Linien, Rahmen |
| `accent` / `accent-ink` | `bg-accent` / `text-accent-ink` | Buttons, Hervorhebungen / Text darauf |
| `band` / `band-ink` / `band-muted` | `bg-band` … | dunkles Band (z. B. Lage) |
| `banner` / `banner-ink` | `bg-banner` … | Hinweis-Banner oben |
- **Kontraste (WCAG 2.2 AA, ≥ 4,5 : 1)** werden von `themes:check` für die Theme-Standards (Fehler) und für jedes aktive Erscheinungsbild der Datenbank (Warnung) geprüft. Paare: ink/muted/accent auf ground und surface, accent-ink auf accent, band-ink/band-muted auf band, banner-ink auf banner. Bei Warnungen in den Erscheinungsbildern die Saisonfarben im Admin anpassen oder die Theme-Standards so wählen, dass die Saisons passen.
- Saisonale Feinheiten im CSS: `<html data-appearance="weihnachten">`, also etwa `[data-appearance=silvester] .hero-overlay { … }`. Schlüssel: `standard`, `sommer`, `winter`, `weihnachten`, `silvester` (Slug des Namens).
- **Neues Token:** in `theme.json › tokens` (mit `label`, `default`) und in `theme.css › @theme inline` als `--color-<token>: var(--<token>);` mappen. Es erscheint dann automatisch als Farbfeld im Admin.
## 5. Bausteine und Vorlagen
Jede Seite ist eine Liste von Bausteinen, die die Vermieterin im Admin anordnet. Für jeden Baustein rendert das System `theme::sections.<key>` mit fertigen Variablen. **Welche Variablen es gibt, steht verbindlich in [THEMES.md](THEMES.md) §5.** Die Vorlagen von Ostsee-Licht sind die Referenz-Implementierung.
| Datei (`views/…`) | Baustein / Zweck |
|---|---|
| `sections/hero` | Titelbereich mit Verfügbarkeitssuche, optional Top-Angebot |
| `sections/facts` | Eckdaten |
| `sections/text_image` | Text mit bis zu 3 Bildern |
| `sections/gallery` | Bildergalerie mit Lightbox |
| `sections/amenities` | Ausstattung |
| `sections/location` | Lage & Umgebung |
| `sections/prices` | Preise & Saisons |
| `sections/offers` | Sonderangebote (nebeneinander / Liste / rollierend) |
| `sections/booking` | Kalender & Anfrage (Livewire) |
| `sections/reviews` | Gästebewertungen |
| `sections/host` | Gastgeberin |
| `sections/faq` | Häufige Fragen |
| `sections/cta` | Abschluss mit Aufruf |
| `sections/contact` | Kontakt |
| `sections/rich_text` | Fließtext (Impressum, Datenschutz …) |
| `layouts/app`, `page`, `partials/*` | Grundgerüst, Kopf, Fuß, Banner, Bild-Helfer, mobile Buchungsleiste |
Regeln für Vorlagen:
- **Immer vorhanden:** `$theme` und `$sectionId`. `$sectionId` für `id`/`aria-labelledby` verwenden, weil ein Baustein mehrfach auf einer Seite stehen kann.
- **Leere Daten abfangen:** Bausteine ohne Inhalt (keine Angebote, keine Bewertungen, kein Foto) rendern nichts bzw. einen ruhigen Platzhalter. Nie mit Fehlern abbrechen.
- **Bilder** immer über `@include('theme::partials.image', ['photo' => $photo, 'sizes' => '(min-width: 1024px) 50vw, 100vw', 'class' => '…', 'eager' => false])`. Das liefert responsives WebP (640/1280/2048 px) und Alt-Text aus dem Admin. `eager => true` nur für das erste große Bild der Seite.
- **Saisonbilder je Baustein** und **Bausteine nur in bestimmten Erscheinungsbildern** regelt das System. Vorlagen nehmen einfach `$photo`/`$photos`.
- **Texte** kommen aus dem Admin. Feste Texte in Vorlagen nur für Bedienelemente („Preis berechnen“, „Schließen“); auf Deutsch, per „Sie“.
- **Eigene Teil-Vorlagen** nach `views/partials/<name>.blade.php` legen und mit `@include('theme::partials.<name>')` einbinden.
- **Buchungs- und Bewertungsformular** (`resources/views/livewire/*.blade.php`) sind für alle Themes gemeinsam und nicht änderbar. Sie nutzen nur Token-Klassen und `.btn-*`; ein Theme passt sie über Tokens und die Basis-Klassen an.
## 6. Pflicht-Markup (wird von `themes:check` geprüft)
| Vorlage | Muss enthalten | Warum |
|---|---|---|
| `layouts/app` | `@vite($theme->assets())`, `{!! $theme->cssVariables() !!}` in `<style>`, `@livewireStyles`, `@livewireScripts`, `@stack('head')`, `@yield('content')`, `data-appearance="{{ $theme->appearanceKey() }}"` am `<html>`, `<meta name="robots" content="noindex">` wenn `$theme->isPreview \|\| ! app()->isProduction()`, Vorschau-Hinweis, `<dialog id="lightbox">` mit `img`, `[data-caption]`, `[data-close]`, Sprunglink `#inhalt` | Assets, Farben, Buchung, SEO-Schutz, Lightbox, Barrierefreiheit |
| `page` | Ausgabe von `$sections` (`{!! $section->render() !!}`) und JSON-LD aus `$structuredData` per `@push('head')` | Inhalt, Google |
| `partials/header` | `$theme->menu('main')` (Links `->url()`, Text `->label()`), Button zur Buchung | Navigation |
| `partials/footer` | `$theme->menu('footer')` (Impressum, Datenschutz) | Rechtspflicht |
| `sections/hero` | GET-Formular an `route('booking.create')` mit `data-availability-search` und Feldern `name="anreise"`, `name="abreise"` (Y-m-d), `name="personen"` | Suche → Buchungsseite |
| `sections/booking` | `<livewire:booking-request :property="$property" />` | Kalender, Preis, Anfrage |
| `sections/gallery` | Links `<a href="{{ $photo->url('lg') }}" data-lightbox data-alt="{{ $photo->alt_text }}">` | Lightbox |
| `sections/offers` | Umsetzung von `$display`: bei `rotating` die Attribute `data-rotator` (Container), `data-rotator-slide` (je Angebot, außer dem ersten `hidden`), `data-rotator-prev`/`-next`, `data-rotator-dot="<index>"` mit `aria-selected` | rollierende Angebote (theme.js) |
| `sections/reviews` | Hinweis: „Bewertungen über unsere Webseite können nur Gäste mit einer Buchung bei uns abgeben …“ (Wortlaut sinngemäß, muss „nur Gäste“ enthalten) | § 5b UWG |
| `sections/faq` | FAQ-JSON-LD per `@push('head')` | Google |
| `partials/mobile-booking-bar` | auf dem Handy immer erreichbarer Buchungs-Button | Konversion |
## 7. Schriften, Bilder, Icons, Bewegung
- **Schriften:** `npm install @fontsource/<schrift>` (oder `@fontsource-variable/<schrift>`), in `theme.css` importieren, in `@theme inline` als `--font-display` / `--font-sans` setzen. Höchstens zwei Familien und wenige Schnitte (Ladezeit). Lizenz: nur Open-Font-Lizenzen (Fontsource sind OFL).
- **Bilder:** nur Fotos aus dem Admin (Webseite › Fotos). Dekorative Grafiken als Inline-SVG in der Vorlage oder als Datei im Theme-Ordner, eingebunden über `{{ Vite::asset('resources/themes/<key>/img/…') }}`. Damit Vite diese Dateien baut, in `theme.js` einmal `import.meta.glob(['./img/**'], { eager: true, query: '?url' });` ergänzen. Keine Bild-URLs von fremden Servern.
- **Icons:** Inline-SVG; Heroicons sind über Blade verfügbar (`<x-heroicon-o-sparkles class="size-5" />`, kommt mit Filament).
- **Bewegung:** nur mit Zweck; `@media (prefers-reduced-motion: no-preference)` und `@supports (animation-timeline: view())` als Verbesserung. Ohne Animation und ohne JS muss alles vollständig funktionieren. Kein Autoplay-Video mit Ton; Video nur stumm, mit Standbild und nicht bei `prefers-reduced-data`.
## 8. Qualität
Es gelten [THEMES.md](THEMES.md) §8:
- Mobil zuerst (ab 360 px).
- LCP unter 2,5 s.
- WCAG 2.2 AA mit Kontrasten, Tastaturbedienung, sichtbarem Fokus und genau einem `h1` je Seite.
- Reduced Motion wird respektiert.
- SEO-Ausgaben bleiben erhalten.
## 9. Prüfen, ansehen, einbinden
1. **Prüfen:** `php artisan themes:check <key>`. Rote Punkte (✗) sind Fehler und müssen behoben werden, gelbe (!) sind Hinweise.
2. **Ansehen, ohne etwas umzuschalten:** `php artisan themes:preview <key>` gibt für jede Seite signierte Links aus: „heute“ und je Erscheinungsbild (Standard, Sommer, Winter, Weihnachten, Silvester). Im Admin geht das auch unter System › Websites › Theme: Theme wählen, dann **„Vorschau“** (öffnet einen neuen Tab), noch nicht speichern. Vorschauseiten sind `noindex`. Klickt man in der Vorschau auf einen Menülink, verlässt man sie; deshalb für jede Seite den eigenen Link verwenden.
3. **Bauen und testen:** `npm run build` und `php artisan test --compact`. Der Test `test_installed_themes_fulfil_the_theme_contract` lässt die Suite rot werden, wenn ein Theme die Prüfung nicht besteht.
4. **Einreichen:** Commit (nur `resources/themes/<key>/**`, ggf. `package*.json`) und Push nach Gitea.
5. **Ausliefern:** `bash scripts/deploy.sh staging deploy` (Testbetrieb https://stommer.info, siehe [BETRIEB.md](BETRIEB.md)). Die Vorschau-Links funktionieren dort genauso (`php artisan themes:preview <key>` über `bash scripts/deploy.sh staging artisan themes:preview <key>`).
6. **Auswählen:** Admin › System › Websites › Website bearbeiten › **Theme** wählen › Speichern. Die Farbfelder darunter zeigen jetzt die Tokens des neuen Themes.
7. **Zurück:** dort das vorherige Theme wählen. Alle Themes bleiben installiert; es wird nichts überschrieben.
## 10. Checkliste vor Abschluss
- [ ] Theme mit `themes:make` angelegt; `resources/themes/ostsee-licht/**` unverändert (`git status`)
- [ ] `themes:check <key>` ohne Fehler; Warnungen bewertet
- [ ] Alle Seiten (`/`, `/wohnung`, `/kuehlungsborn`, `/buchen`, `/kontakt`, `/impressum`, `/datenschutz`) auf Handy (360 px), Tablet und Desktop geprüft
- [ ] Alle 5 Erscheinungsbilder über `themes:preview` geprüft (Silvester ist dunkel, Kontraste!)
- [ ] Buchungsablauf in der Vorschau durchgespielt: Termin wählen → Preis erscheint → Anfrage absenden
- [ ] Sonderangebote in allen drei Darstellungen (Baustein-Einstellung) angesehen
- [ ] Tastatur: alles erreichbar, Fokus sichtbar; Reduced Motion an → keine Animation
- [ ] Nur selbst gehostete Schriften, keine externen Anfragen (Browser-Netzwerkanalyse)
- [ ] `npm run build` fehlerfrei, `php artisan test --compact` grün
- [ ] `README.md` des Themes: welche Vorlagen überschrieben sind, Schriften, Besonderheiten; `version` erhöht
## 11. Gut zu wissen
- **Tailwind-Klassen werden themeübergreifend gesammelt:** Das Vite-Plugin sammelt beim Build die Klassen aller Themes, deshalb kann die CSS-Datei jedes Themes auch Klassen der anderen enthalten. Das ist harmlos (etwas größer). Eigene Schriften, Tokens und Komponenten-Stile bleiben dagegen im jeweiligen Theme, das ist geprüft.
- **Strato hat ein Datei-Limit:** Bilder im Theme-Ordner sparsam einsetzen; Fotos gehören in den Admin.
- **Ein Theme pro Website:** Weitere Vermieter mit eigener Domain können später ein anderes Theme nutzen (Admin › Websites).
## 12. Auftrag für die Design-Sitzung (zum Kopieren)
> Lies `CLAUDE.md`, `docs/THEME-ERSTELLUNG.md` und `docs/THEMES.md` vollständig. Erstelle mit dem Skill `frontend-design` ein **neues, zusätzliches Theme** für die Ferienwohnung Stommer in Kühlungsborn. Lege es mit `php artisan themes:make <key> --name="…" --description="…"` an und arbeite ausschließlich in `resources/themes/<key>/` (plus `package.json` für `@fontsource`-Schriften). Verändere `resources/themes/ostsee-licht` nicht. Kopiere die Referenzvorlagen aus `resources/themes/ostsee-licht/views` in dein Theme und gestalte sie neu. Halte dabei den Vorlagen-Vertrag (THEMES.md §5) und das Pflicht-Markup (THEME-ERSTELLUNG.md §6) ein. Nur Token-Farben, keine externen Quellen, mobil zuerst, WCAG 2.2 AA. Prüfe laufend mit `php artisan themes:check <key>` und sieh jede Seite in allen Erscheinungsbildern über `php artisan themes:preview <key>` an. Abschluss: Checkliste §10, `npm run build`, `php artisan test --compact`, Commit nur der Theme-Dateien.
>
> Gestalterische Leitideen: siehe THEMES.md §10.
+15 -9
View File
@@ -3,6 +3,8 @@ # Theme-System – Architektur, Vorlagen-Vertrag, Übergabe Design
Stand: 22.10.2026 · Basis-Theme: **„Ostsee-Licht“** (`resources/themes/ostsee-licht`) · Entscheidungen: `docs/KONZEPT.md` §4a
> **Kurz:** Logik, Daten und Admin sind fertig und getestet. Ein Theme ist **nur Optik**: Blade-Vorlagen, CSS, ein wenig JS und Farb-Tokens. Für ein neues Design wird ausschließlich unter `resources/themes/<theme>/` gearbeitet.
>
> **Neues Theme bauen:** verbindliche Schritt-für-Schritt-Anleitung in [THEME-ERSTELLUNG.md](THEME-ERSTELLUNG.md) (`themes:make`, `themes:check`, `themes:preview`).
---
@@ -26,7 +28,7 @@ ## 1. Überblick
| **Theme** | `resources/themes/<key>/` | Manifest `theme.json`, Vorlagen `views/`, `theme.css`, `theme.js` |
| **Seite** | `pages`, Admin › Webseite › Seiten | Adresse, Menü (Haupt/Fuß/keins), SEO, **Bausteine** (Builder) |
| **Baustein** (Section) | `app/Themes/Sections/*`, Katalog in `config/themes.php` | Admin-Formular + Datenaufbereitung; Darstellung: `theme::sections.<key>` |
| **Erscheinungsbild** (Appearance) | `appearances`, Admin › Webseite › Erscheinungsbilder | Jährlicher Zeitraum + Priorität; ersetzt Farben (Tokens), Titelbild, ausgewählte Texte, Banner, hervorgehobenes Angebot – **nicht** den Aufbau |
| **Erscheinungsbild** (Appearance) | `appearances`, Admin › Webseite › Erscheinungsbilder | Jährlicher Zeitraum + Priorität; ersetzt Farben (Tokens), Titelbild, **Bilder je Baustein**, ausgewählte Texte, Banner – **nicht** den Aufbau. Bausteine können auf Erscheinungsbilder beschränkt werden. Sonderangebote sind **unabhängig** davon (`OfferShowcase`) |
Code: `app/Themes/` (Theme, ThemeFactory, ThemeRegistry, ThemeManifest, SectionRegistry, Sections/), `app/Http/Middleware/ResolveTheme.php`, `app/Http/Controllers/PageController.php`, `app/Providers/ThemeServiceProvider.php`.
@@ -35,7 +37,8 @@ ## 2. Aufbau eines Themes
```
resources/themes/ostsee-licht/
├── theme.json Manifest
├── theme.css Tailwind v4 + Schriften + Token-Mapping
├── theme.css Vite-Einstieg: @import 'tailwindcss' + theme-base.css + @source der Vorlagen
├── theme-base.css wiederverwendbar: Schriften, Token-Mapping, Basis-Klassen (Child-Themes importieren diese Datei)
├── theme.js kleine Verbesserungen (Lightbox, Suche)
└── views/
├── layouts/app.blade.php Grundgerüst: <head>, Banner, Kopf, @yield('content'), Fuß, Lightbox
@@ -58,8 +61,8 @@ ### theme.json
}
```
- **Vererbung:** Vorlagen, die ein Theme nicht hat, kommen vom Eltern-Theme, zuletzt vom Basis-Theme (`config('themes.base')`). Ein Child-Theme kann also mit einer einzigen Datei beginnen (z. B. nur `sections/hero.blade.php`). Hat ein Child-Theme keine eigenen `assets`, werden die des Eltern-Themes geladen.
- **Neues Theme anlegen:** Ordner `resources/themes/<key>/` mit `theme.json` (+ optional eigene Assets) → erscheint automatisch in Admin › System › Websites › Theme. `npm run build` baut alle Themes (`vite.config.js` liest die Ordner).
- **Vererbung:** Vorlagen, die ein Theme nicht hat, kommen vom Eltern-Theme, zuletzt vom Basis-Theme (`config('themes.base')`). Ein Child-Theme kann also mit einer einzigen Datei beginnen (z. B. nur `sections/hero.blade.php`). Hat ein Child-Theme keine eigenen `assets`, werden die des Eltern-Themes geladen – das reicht nur ohne eigene Vorlagen; sobald es Vorlagen gibt, braucht das Theme eigene `theme.css`/`theme.js` (sonst fehlen deren Tailwind-Klassen; `themes:check` meldet das).
- **Neues Theme anlegen:** `php artisan themes:make <key>` (überschreibt nie etwas) → erscheint automatisch in Admin › System › Websites › Theme (mit „Vorschau“). `npm run build` baut alle Themes (`vite.config.js` liest die Ordner). Prüfen: `php artisan themes:check`; Vorschau-Links: `php artisan themes:preview <key>` (signiert, `?theme=<key>` und optional `&vorschau=<Erscheinungsbild-ID>`). Details: [THEME-ERSTELLUNG.md](THEME-ERSTELLUNG.md).
- **Plugins:** Ein Theme-Paket legt seinen Ordner unter einen Pfad aus `config('themes.paths')`. Themes werden **nie** über den Admin hochgeladen (Vorlagen sind ausführbarer Code).
## 3. Design-Tokens (Farben)
@@ -83,6 +86,7 @@ ## 4. Was Layout und Vorlagen zur Verfügung haben
| `$theme->appearanceKey()` | z. B. `weihnachten` – steht als `data-appearance` am `<html>`; für saisonale CSS-Details nutzbar: `[data-appearance=silvester] .hero {…}` |
| `$theme->text($key, $fallback)` | Text des Erscheinungsbilds oder Fallback (Schlüssel: `Appearance::OVERRIDABLE`) |
| `$theme->heroPhoto($fallback)` | Titelbild des Erscheinungsbilds oder Fallback |
| `$theme->sectionPhotoIds($sectionId, $slot)` / `sectionPhotoMode($sectionId)` | Saisonbilder eines platzierten Bausteins (in Bausteinen über `seasonalPhoto()`, `seasonalPhotos()`, `withSeasonalPhotos()` der Basisklasse) |
| `$theme->property()` | Hauptwohnung der Site |
| `$theme->menu('main' \| 'footer')` | veröffentlichte Seiten des Menüs (`->url()`, `->label()`) |
| `$theme->tokens()`, `cssVariables()`, `assets()` | für das Layout |
@@ -97,14 +101,14 @@ ## 5. Bausteinkatalog – Vertrag der Vorlagen
| Key | Admin-Name | Variablen |
|---|---|---|
| `hero` | Titelbereich mit Suche | `$eyebrow`, `$title` (Text, `*Wort*` = Hervorhebung), `$text`, `$photo`, `$showSearch`, `$property` – Suche als GET-Formular an `route('booking.create')` mit `anreise`, `abreise` (Y-m-d), `personen` |
| `hero` | Titelbereich mit Suche | `$eyebrow`, `$title` (Text, `*Wort*` = Hervorhebung), `$text`, `$photo`, `$showSearch`, `$property`, `$featuredOffer` (`AdvertisedOffer`\|null: wichtigstes hervorgehobenes Angebot) – Suche als GET-Formular an `route('booking.create')` mit `anreise`, `abreise` (Y-m-d), `personen` |
| `facts` | Eckdaten | `$heading`, `$property`, `$highlights` (Collection<string>), `$fromPrice` (Cent\|null) |
| `text_image` | Text mit Bildern | `$eyebrow`, `$heading`, `$text` (HtmlString\|null), `$photos` (≤3), `$imagePosition` (`left`\|`right`), `$linkLabel`, `$linkUrl` |
| `gallery` | Bildergalerie | `$heading`, `$photos` – Lightbox: `<a href="{{ $photo->url('lg') }}" data-lightbox data-alt="…">` |
| `amenities` | Ausstattung | `$heading`, `$groups` (Bereich ⇒ Collection<Amenity>) |
| `location` | Lage & Umgebung | `$eyebrow`, `$heading`, `$text`, `$address`, `$mapUrl` (OpenStreetMap-Link, keine eingebettete Karte), `$photos` |
| `prices` | Preise & Saisons | `$eyebrow`, `$heading`, `$text`, `$property`, `$seasons` (nächste 12 Monate), `$extras`, `$featuredSeason` (Name des Erscheinungsbilds) |
| `offers` | Sonderangebote | `$heading`, `$offers` (öffentlich, ohne Code), `$featuredId` |
| `offers` | Sonderangebote | `$heading`, `$display` (`grid`\|`list`\|`rotating`), `$offers` (Collection<`App\Pricing\AdvertisedOffer`>: `title`, `description`, `advantage`, `conditions`, `arrival`/`departure`/`nights()` bei festen Terminen und Lücken, `quote` + `regularTotal()` für „statt …“, `bookingUrl()`). Rollierend: `data-rotator`, `data-rotator-slide`, `data-rotator-prev/next/dot` (theme.js) |
| `booking` | Kalender & Anfrage | `$heading`, `$text`, `$property` – bindet `<livewire:booking-request :property="$property" />` ein |
| `reviews` | Gästebewertungen | `$heading`, `$reviews`, `$count`, `$average`, `$categories` – **Pflichthinweis** zur Echtheit (§ 5b UWG) muss sichtbar bleiben |
| `host` | Gastgeber | `$heading`, `$quote`, `$text`, `$photo`, `$name` |
@@ -115,11 +119,13 @@ ## 5. Bausteinkatalog – Vertrag der Vorlagen
Rich-Text-Variablen sind bereits bereinigt (HtmlString) und werden mit `{{ $text }}` ausgegeben.
**Jeder platzierte Baustein** hat `data.id` (feste UUID, `Page::assignSectionIds` beim Speichern; Kopien bekommen eine neue) und `data.appearances` (Erscheinungsbild-IDs; leer = immer sichtbar, sonst nur in diesen – z. B. ein Weihnachts-Baustein). Bausteine mit Bildern melden ihre Bildplätze über `photoSlots()` (`single`, `multiple`, `collection` = automatisch gewählte Bilder, die ein Erscheinungsbild ersetzen oder voranstellen kann); daraus baut das Erscheinungsbild-Formular „Bilder je Baustein“ (`appearances.section_photos[<id>][<slot>]`, bei Sammlungen zusätzlich `mode`). Alle Bildauswahlen nutzen `App\Filament\Forms\Components\PhotoSelect` (Vorschaubild + Beschreibung, nach Kategorie gruppiert).
**Neuer Baustein** (auch als Plugin): Klasse `extends App\Themes\Sections\Section` (`key()`, `label()`, `icon()`, `schema()` = Admin-Felder, `data()` = Variablen) → in `config/themes.php › sections` eintragen → Vorlage `sections/<key>.blade.php` im Basis-Theme anlegen (Test `test_base_theme_is_discovered_and_provides_a_view_for_every_section` erzwingt das). Unbekannte Bausteine werden auf der Seite übersprungen, nie ein Fehler.
## 6. Erscheinungsbilder
- Felder: Name, Zeitraum `TT.MM.`–`TT.MM.` (jährlich, darf über Silvester laufen), Priorität, Standard, aktiv, Titelbild, hervorgehobenes Angebot, Texte (`banner.text`, `banner.link_label`, `banner.link_url`, `hero.eyebrow`, `hero.title`, `hero.text`, `cta.title`, `cta.text`), Farben.
- Felder: Name, Zeitraum `TT.MM.`–`TT.MM.` (jährlich, darf über Silvester laufen), Priorität, Standard, aktiv, Titelbild, **Bilder je Baustein** (alle Bausteine mit Bildern auf allen Seiten; leer = Bild aus der Seite), Texte (`banner.text`, `banner.link_label`, `banner.link_url`, `hero.eyebrow`, `hero.title`, `hero.text`, `cta.title`, `cta.text`), Farben.
- Startset (Seeder): Standard · Sommer 01.06.–31.08. · Winter 01.11.–31.03. · Weihnachten 01.12.–25.12. (Prio 20) · Silvester 26.12.–03.01. (Prio 20).
- **Vorschau:** Admin › Erscheinungsbilder › „Vorschau“ = signierter Link (24 h), `noindex`.
- Ohne Erscheinungsbild-Banner wird der neueste aktive Hinweis (Admin › Hinweis-Banner) gezeigt.
@@ -153,9 +159,9 @@ ## 9. Lokal starten und prüfen
## 10. Übergabe: Auftrag für die Design-Sitzung (privater Rechner, Plugin `frontend-design`)
**Ziel:** Das Basis-Theme „Ostsee-Licht“ gestalterisch auf ein wirklich herausragendes Niveau heben (Recherche & Ideen: Chat vom 22.10.2026, Zusammenfassung unten), oder ein neues Theme als Child bzw. eigenständiges Theme anlegen und im Admin umschalten.
**Ziel:** Ein **neues, zusätzliches Theme** auf wirklich herausragendem Niveau (Recherche & Ideen: Chat vom 22.10.2026, Zusammenfassung unten), angelegt mit `themes:make`, auswählbar im Admin – „Ostsee-Licht“ bleibt unverändert als Basis und Rückfall. **Verbindliche Anleitung und Auftragstext: [THEME-ERSTELLUNG.md](THEME-ERSTELLUNG.md).**
**Arbeitsbereich:** nur `resources/themes/<theme>/**` – dazu bei Bedarf die theme-neutralen Livewire-Formulare `resources/views/livewire/*.blade.php` (nur Klassen, keine Logik).
**Arbeitsbereich:** nur `resources/themes/<neues-theme>/**` (+ `package.json` für `@fontsource`-Schriften). Die Livewire-Formulare `resources/views/livewire/*.blade.php` sind für alle Themes gemeinsam und werden nicht verändert.
**Nicht anfassen:** `app/**` (außer ein neuer Baustein wird bewusst gebraucht – dann §5), Datenbank, Admin, `config/**`.