From fdcb68d5783fb31e7125dd140296e4390966c3c8 Mon Sep 17 00:00:00 2001 From: Lars Stommer Date: Thu, 22 Oct 2026 22:50:35 +0200 Subject: [PATCH] Documentation: project README, status, rules for parallel sessions (theme branch), updated operations/concept/theme guide Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 5 +- CLAUDE.md | 5 +- README.md | 75 +++++++++++------------------ docs/BETRIEB.md | 14 ++++-- docs/KONZEPT.md | 10 ++-- docs/STATUS.md | 100 +++++++++++++++++++++++++++++++++++++++ docs/THEME-ERSTELLUNG.md | 19 +++++++- docs/ZUSAMMENARBEIT.md | 71 +++++++++++++++++++++++++++ 8 files changed, 239 insertions(+), 60 deletions(-) create mode 100644 docs/STATUS.md create mode 100644 docs/ZUSAMMENARBEIT.md diff --git a/AGENTS.md b/AGENTS.md index c9da897..434a921 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,6 +1,6 @@ # Ferienwohnung Stommer -Website + booking management for a holiday apartment in Kühlungsborn. Concept and roadmap: `docs/KONZEPT.md`. +Website + booking management for a holiday apartment in Kühlungsborn. Concept and roadmap: `docs/KONZEPT.md`. **Current state and next steps: `docs/STATUS.md` – start there and update it after larger changes.** Parallel sessions (e.g. theme design on another machine): follow `docs/ZUSAMMENARBEIT.md` (branches, file ownership, deploy only from an up-to-date `main`). - Hosting target: Strato shared webhosting (PHP + MySQL, no Node at runtime) – build assets locally. - UI and all user-facing texts are German; code, identifiers and PHPDoc are English. @@ -10,11 +10,14 @@ # Ferienwohnung Stommer - Portals must be integrated through a pluggable channel-connector system (see concept §7), never hard-coded. - Bookings/blocks use nights: `arrival <= night < departure`; same-day changeover is allowed. Reservations with an elapsed hold never occupy the calendar (scope `Booking::occupying()`), cron only updates status. - Business operations live in `app/Actions` (CreateReservation, ConfirmBooking, …); Filament pages and Livewire components call them instead of changing bookings directly. +- Booking path 1 (KONZEPT §6a): request (`Reserved`, hold) → `SendOffer` (`OfferSent`, versioned, contract draft, signed link `offers.show`) → guest `AcceptOffer` (acceptance record, then `ConfirmBooking`) or `RejectOffer`; `ExpireReservations` handles both holding statuses (`BookingStatus::holding()`). Manual price changes are `QuoteLineType::Adjustment` lines. +- Minimum stay: season `min_nights`, relaxed in `PriceCalculator::minimumStayRelaxed` (offer `waives_min_stay`, gap filled completely, departure on the property's `changeover_weekday`, never below `min_stay_absolute`). - Special offers are evaluated automatically by `PriceCalculator`; discounts are `QuoteLineType::Discount` lines with negative amounts. Kinds (`OfferKind`): rule, fixed dates, gap filler (`App\Availability\GapFinder`). Which offers the website advertises is decided by `App\Pricing\OfferShowcase` (not by appearances); it prices fixed dates/gaps with `PriceCalculator`. - Portal sync lives in `app/Channels` (connector interface + registry in `config/channels.php`, iCal connector/parser/feed). Our system leads; `SyncChannel` imports portal occupations as `BlockedPeriod` rows with `channel_id`; each channel's export feed excludes its own blocks. Observers on Booking/BlockedPeriod create `ChannelTask`s for portals with `requires_manual_blocking`. Portal booking e-mails are a fast path (`app/Channels/Mail`, `ProcessPortalMail`): they create blocks with source `email`, which `SyncChannel` later confirms/replaces and never removes as stale. Portal analysis: `docs/PORTALE.md`. - Website = theme system (`docs/THEMES.md`): themes live in `resources/themes/` (theme.json, theme.css, theme.js, views); views resolve via the `theme::` namespace (theme → parent → base `ostsee-licht`). Pages are lists of sections (`app/Themes/Sections`, catalogue in `config/themes.php`); seasonal `Appearance`s override tokens/texts/hero photo/photos per section (stable `data.id` per placed section) and sections can be limited to appearances. Theme views use only token colour classes (`bg-accent`, `text-muted`, …). New designs are **additional** themes: `php artisan themes:make `, `themes:check`, `themes:preview` – never edit `ostsee-licht` for a new design; authoring rules in `docs/THEME-ERSTELLUNG.md`. Resolve `Theme` lazily (`app(Theme::class)`), never in constructors – middleware `ResolveTheme` replaces it per request. - Operations (environments, Strato access, server .env, admin accounts, 2FA, known pitfalls): `docs/BETRIEB.md` – read it before touching a server. Admin accounts: `php artisan users:create`; 2FA (Filament app authentication) is mandatory for every account. Admin modes (`App\Enums\AdminMode`: simple/expert per user, user menu switch) only shape the menu via the `FollowsAdminMode` trait on every resource/page (simple menu = `AdminMode::SIMPLE_NAVIGATION`); permissions stay with roles/policies. New admin resources must use `FollowsAdminMode`. - Deployment: `scripts/deploy.sh setup|deploy [ref]|rollback|releases|artisan` (atomic releases on Strato, docs/DEPLOYMENT.md; the server keeps only the active release because of Strato's file quota – history = Git tags `deploy//`); CI `.gitea/workflows/deploy.yml`. Production has no dev packages (no factories/Faker) – production seeding via `ProductionSeeder`. +- Strato specifics: `public/index.php` strips the internal `/releases//public` prefix from `REQUEST_URI` (signed URLs); `URL::forceRootUrl(APP_URL)` outside local/testing; test environments redirect all mail via `FEWO_MAIL_REDIRECT_TO`. - Vite fonts plugin is removed on purpose (corporate proxy breaks remote font downloads, and fonts must be self-hosted for GDPR). - PHP/Composer on this machine: winget package dir `%LOCALAPPDATA%\Microsoft\WinGet\Packages\PHP.PHP.8.4_*` (Composer as `composer\composer.phar` there). - Git remote: Gitea `https://gitea.stommer.de/Lars/fewo-stommer.git`, branch `main`. diff --git a/CLAUDE.md b/CLAUDE.md index c9da897..434a921 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,6 +1,6 @@ # Ferienwohnung Stommer -Website + booking management for a holiday apartment in Kühlungsborn. Concept and roadmap: `docs/KONZEPT.md`. +Website + booking management for a holiday apartment in Kühlungsborn. Concept and roadmap: `docs/KONZEPT.md`. **Current state and next steps: `docs/STATUS.md` – start there and update it after larger changes.** Parallel sessions (e.g. theme design on another machine): follow `docs/ZUSAMMENARBEIT.md` (branches, file ownership, deploy only from an up-to-date `main`). - Hosting target: Strato shared webhosting (PHP + MySQL, no Node at runtime) – build assets locally. - UI and all user-facing texts are German; code, identifiers and PHPDoc are English. @@ -10,11 +10,14 @@ # Ferienwohnung Stommer - Portals must be integrated through a pluggable channel-connector system (see concept §7), never hard-coded. - Bookings/blocks use nights: `arrival <= night < departure`; same-day changeover is allowed. Reservations with an elapsed hold never occupy the calendar (scope `Booking::occupying()`), cron only updates status. - Business operations live in `app/Actions` (CreateReservation, ConfirmBooking, …); Filament pages and Livewire components call them instead of changing bookings directly. +- Booking path 1 (KONZEPT §6a): request (`Reserved`, hold) → `SendOffer` (`OfferSent`, versioned, contract draft, signed link `offers.show`) → guest `AcceptOffer` (acceptance record, then `ConfirmBooking`) or `RejectOffer`; `ExpireReservations` handles both holding statuses (`BookingStatus::holding()`). Manual price changes are `QuoteLineType::Adjustment` lines. +- Minimum stay: season `min_nights`, relaxed in `PriceCalculator::minimumStayRelaxed` (offer `waives_min_stay`, gap filled completely, departure on the property's `changeover_weekday`, never below `min_stay_absolute`). - Special offers are evaluated automatically by `PriceCalculator`; discounts are `QuoteLineType::Discount` lines with negative amounts. Kinds (`OfferKind`): rule, fixed dates, gap filler (`App\Availability\GapFinder`). Which offers the website advertises is decided by `App\Pricing\OfferShowcase` (not by appearances); it prices fixed dates/gaps with `PriceCalculator`. - Portal sync lives in `app/Channels` (connector interface + registry in `config/channels.php`, iCal connector/parser/feed). Our system leads; `SyncChannel` imports portal occupations as `BlockedPeriod` rows with `channel_id`; each channel's export feed excludes its own blocks. Observers on Booking/BlockedPeriod create `ChannelTask`s for portals with `requires_manual_blocking`. Portal booking e-mails are a fast path (`app/Channels/Mail`, `ProcessPortalMail`): they create blocks with source `email`, which `SyncChannel` later confirms/replaces and never removes as stale. Portal analysis: `docs/PORTALE.md`. - Website = theme system (`docs/THEMES.md`): themes live in `resources/themes/` (theme.json, theme.css, theme.js, views); views resolve via the `theme::` namespace (theme → parent → base `ostsee-licht`). Pages are lists of sections (`app/Themes/Sections`, catalogue in `config/themes.php`); seasonal `Appearance`s override tokens/texts/hero photo/photos per section (stable `data.id` per placed section) and sections can be limited to appearances. Theme views use only token colour classes (`bg-accent`, `text-muted`, …). New designs are **additional** themes: `php artisan themes:make `, `themes:check`, `themes:preview` – never edit `ostsee-licht` for a new design; authoring rules in `docs/THEME-ERSTELLUNG.md`. Resolve `Theme` lazily (`app(Theme::class)`), never in constructors – middleware `ResolveTheme` replaces it per request. - Operations (environments, Strato access, server .env, admin accounts, 2FA, known pitfalls): `docs/BETRIEB.md` – read it before touching a server. Admin accounts: `php artisan users:create`; 2FA (Filament app authentication) is mandatory for every account. Admin modes (`App\Enums\AdminMode`: simple/expert per user, user menu switch) only shape the menu via the `FollowsAdminMode` trait on every resource/page (simple menu = `AdminMode::SIMPLE_NAVIGATION`); permissions stay with roles/policies. New admin resources must use `FollowsAdminMode`. - Deployment: `scripts/deploy.sh setup|deploy [ref]|rollback|releases|artisan` (atomic releases on Strato, docs/DEPLOYMENT.md; the server keeps only the active release because of Strato's file quota – history = Git tags `deploy//`); CI `.gitea/workflows/deploy.yml`. Production has no dev packages (no factories/Faker) – production seeding via `ProductionSeeder`. +- Strato specifics: `public/index.php` strips the internal `/releases//public` prefix from `REQUEST_URI` (signed URLs); `URL::forceRootUrl(APP_URL)` outside local/testing; test environments redirect all mail via `FEWO_MAIL_REDIRECT_TO`. - Vite fonts plugin is removed on purpose (corporate proxy breaks remote font downloads, and fonts must be self-hosted for GDPR). - PHP/Composer on this machine: winget package dir `%LOCALAPPDATA%\Microsoft\WinGet\Packages\PHP.PHP.8.4_*` (Composer as `composer\composer.phar` there). - Git remote: Gitea `https://gitea.stommer.de/Lars/fewo-stommer.git`, branch `main`. diff --git a/README.md b/README.md index 5ad1377..f3c165c 100644 --- a/README.md +++ b/README.md @@ -1,58 +1,37 @@ -

Laravel Logo

+# Ferienwohnung Stommer – Webseite und Vermietungsverwaltung -

-Build Status -Total Downloads -Latest Stable Version -License -

+Webseite mit Buchungsanfrage und eine Verwaltung (Admin) für die Ferienwohnung Stommer, Strandstraße 15, 18225 Kühlungsborn. Ersetzt die bisherige WordPress-Seite www.fewo-stommer.de. Laravel 13, Filament 5, Livewire 4, Tailwind 4; Hosting bei Strato (Shared Webhosting, Hosting Pro). -## About Laravel +**Testbetrieb:** https://stommer.info · Verwaltung: https://stommer.info/admin (Konto + Zwei-Faktor-Anmeldung, siehe docs/BETRIEB.md §7) -Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as: +## Wo steht was? -- [Simple, fast routing engine](https://laravel.com/docs/routing). -- [Powerful dependency injection container](https://laravel.com/docs/container). -- Multiple back-ends for [session](https://laravel.com/docs/session) and [cache](https://laravel.com/docs/cache) storage. -- Expressive, intuitive [database ORM](https://laravel.com/docs/eloquent). -- Database agnostic [schema migrations](https://laravel.com/docs/migrations). -- [Robust background job processing](https://laravel.com/docs/queues). -- [Real-time event broadcasting](https://laravel.com/docs/broadcasting). +| Dokument | Inhalt | +|---|---| +| [docs/STATUS.md](docs/STATUS.md) | **Aktueller Stand**: was fertig ist, was offen ist, nächste Schritte – hier anfangen | +| [docs/ZUSAMMENARBEIT.md](docs/ZUSAMMENARBEIT.md) | Regeln für parallele Arbeit (z. B. Theme-Entwicklung auf einem anderen Rechner) – Branches, Dateibereiche, Ausliefern | +| [docs/KONZEPT.md](docs/KONZEPT.md) | Fachliches Konzept und alle Entscheidungen (Buchungswege §6a, Festlegungen §6b) | +| [docs/BETRIEB.md](docs/BETRIEB.md) | Server, Zugänge, Konfiguration, Konten/2FA, Backups, Löschfristen, bekannte Eigenheiten | +| [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md) | Auslieferung auf Strato (Skript, Versionen, Gitea Actions) | +| [docs/THEMES.md](docs/THEMES.md) | Theme-System: Architektur, Bausteine und ihre Daten (Vorlagen-Vertrag) | +| [docs/THEME-ERSTELLUNG.md](docs/THEME-ERSTELLUNG.md) | **Verbindliche Anleitung für ein neues Theme** (Design-Sitzung) | +| [docs/PORTALE.md](docs/PORTALE.md) | Buchungsportale, Kalenderabgleich, Portal-E-Mails | +| [styles/README.md](styles/README.md) | Markenelemente (Logo, Favicon, Symbole, Wellenband) | +| docs/DATENSCHUTZ-*, GAP-DELTA, GO-LIVE-CHECKLISTE, LOESCHKONZEPT, BUCHUNGSPROZESS, DATENMODELL-KONZEPT | Analyse eines Datenschutz-Agenten (Annahmen markiert; maßgeblich ist KONZEPT.md) | +| [CLAUDE.md](CLAUDE.md) / [AGENTS.md](AGENTS.md) | Technische Leitplanken für KI-Assistenten (identisch) | -Laravel is accessible, powerful, and provides tools required for large, robust applications. - -## Learning Laravel - -Laravel has the most extensive and thorough [documentation](https://laravel.com/docs) and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework. - -In addition, [Laracasts](https://laracasts.com) contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library. - -You can also watch bite-sized lessons with real-world projects on [Laravel Learn](https://laravel.com/learn), where you will be guided through building a Laravel application from scratch while learning PHP fundamentals. - -## Agentic Development - -Laravel's predictable structure and conventions make it ideal for AI coding agents like Claude Code, Cursor, and GitHub Copilot. Install [Laravel Boost](https://laravel.com/docs/ai) to supercharge your AI workflow: +## Lokal starten ```bash -composer require laravel/boost --dev - -php artisan boost:install +composer install && npm ci +cp .env.example .env && php artisan key:generate +touch database/database.sqlite # PowerShell: New-Item database/database.sqlite +php artisan migrate:fresh --seed # Testdaten: Wohnung, Preise 2026, Seiten, Erscheinungsbilder +npm run build # oder npm run dev +php artisan serve # http://localhost:8000 · /admin: admin@example.com / password (2FA beim ersten Login) +php artisan test --compact # alle Tests müssen grün sein ``` -Boost provides your agent 15+ tools and skills that help agents build Laravel applications while following best practices. +## Ausliefern -## Contributing - -Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions). - -## Code of Conduct - -In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct). - -## Security Vulnerabilities - -If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [taylor@laravel.com](mailto:taylor@laravel.com). All security vulnerabilities will be promptly addressed. - -## License - -The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT). +`bash scripts/deploy.sh staging deploy` – baut den **letzten Commit** und spielt ihn auf stommer.info (Details und Regeln: docs/DEPLOYMENT.md, docs/ZUSAMMENARBEIT.md). diff --git a/docs/BETRIEB.md b/docs/BETRIEB.md index 6390bd0..8d84dc1 100644 --- a/docs/BETRIEB.md +++ b/docs/BETRIEB.md @@ -72,15 +72,20 @@ ## 5. Konfiguration auf dem Server (`shared/.env`) | `FEWO_BANK_*` | leer | für Verträge/Angebote noch einzutragen | | `FEWO_HEALTH_TOKEN`, `FEWO_SCHEDULER_TOKEN`, `FEWO_AUTOMATION_SECRET` | gesetzt | für n8n (Überwachung, Scheduler-Ersatz, Webhooks) | +## 5a. E-Mail im Testbetrieb + +Standard: `MAIL_MAILER=log` (nichts wird versendet). Zum Testen der echten Mails: in `shared/.env` `MAIL_MAILER=smtp` und `MAIL_PASSWORD=` (nur selbst eintragen), dann `bash scripts/deploy.sh staging artisan optimize`. Weil `FEWO_MAIL_REDIRECT_TO=lars@stommer.com` gesetzt ist, gehen **alle** Mails – auch die an Gäste und an die Vermieterin – nur an diese Adresse. In der Produktion `FEWO_MAIL_REDIRECT_TO` leer lassen. + ## 6. Erledigt / offen im Testbetrieb -Erledigt (22.10.2026): Ordnerstruktur, `shared/.env`, Migrationen, Grunddaten (`ProductionSeeder`: Wohnung, Saisons 2026, Inhalte, Seiten, Erscheinungsbilder), HTTPS unter stommer.info, Gesundheitscheck mit automatischem Rollback. +Erledigt (22.10.2026): Ordnerstruktur, `shared/.env`, Migrationen, Grunddaten (`ProductionSeeder`: Wohnung, Saisons 2026, Inhalte, Seiten, Erscheinungsbilder), HTTPS unter stommer.info, Gesundheitscheck mit automatischem Rollback, Admin-Konto `lars@stommer.com` mit 2FA, 39 Fotos importiert und von Metadaten bereinigt, Ende-zu-Ende-Durchlauf Anfrage → Angebot → Annahme (Testbuchung 2026-0002, darf gelöscht werden). Offen: -- **Admin-Benutzer anlegen** (§7) und 2FA einrichten. +- **Konto für Brigitte** anlegen: System › Benutzer, Rolle Administrator, Ansicht Einfach (§7). +- **E-Mail im Testbetrieb** einschalten (§5a). - **Cronjob** (Kundenlogin › Cronjobs), jede Minute: `/opt/RZphp84/bin/php-cli /mnt/web508/e3/26/51539426/htdocs/test.fewo-stommer.de/current/artisan schedule:run` - Falls Strato nicht minütlich erlaubt: n8n ruft jede Minute `https://stommer.info/automation/scheduler?token=` auf. + Falls Strato nicht minütlich erlaubt: n8n ruft jede Minute `https://stommer.info/automation/scheduler` mit Header `Authorization: Bearer ` auf. - Bankdaten, Vertrags- und AGB-Texte, Rechtstexte prüfen. ### Fotos aus dem alten WordPress übernehmen @@ -144,6 +149,9 @@ ## 8. Bekannte Eigenheiten und Lösungen | Ersteinrichtung mit Factories schlägt fehl | Produktion ohne Dev-Pakete | `ProductionSeeder` | | Kein SSL für Subdomain | Paket erlaubt SSL nur für Hauptdomains | Testbetrieb auf `stommer.info` | | `Disk quota exceeded` beim Hochladen / Hinweis „zu viele Dateien“ | Webspace-Kontingent voll (geteilt mit allen anderen Seiten/Backups im Paket); jede Version belegt ~136 MB | Es ist die **Anzahl der Dateien** (Inode-Limit), nicht der Platz. Der Server behält nur die aktive Version (Geschichte als Git-Tags in Gitea), `vendor` wird beim Build ausgedünnt (~15.000 statt ~19.500 Dateien je Version); Reste abgebrochener Läufe räumt das nächste Deployment selbst weg. **Ordner außerhalb des Deploy-Ordners entscheidet nur Lars** (teils produktiv). | +| Signierte Links (Angebot, Bewertung, Newsletter, Vorschau) mit 403 | Strato meldet nach der `.htaccess`-Weiterleitung den internen Pfad `/releases//public/…` in `REQUEST_URI` | `public/index.php` entfernt dieses Präfix vor dem Start von Laravel | +| Keine E-Mails im Testbetrieb, auch nicht im Protokoll | `MAIL_MAILER=log` schreibt auf Stufe *debug*, `LOG_LEVEL=info` verwirft das | Zum Testen SMTP einschalten; `FEWO_MAIL_REDIRECT_TO` leitet dann **alle** Mails an eine Adresse (gesetzt: lars@stommer.com) | +| Foto-Metadaten (GPS) blieben erhalten | Spatie Image nutzt Imagick, wenn installiert (Strato), und Imagick behält EXIF | `StripImageMetadata` erzwingt GD | | Windows: Symlinks, `php` nicht im PATH | Git Bash | Deploy nur gegen Strato testen; `export PATH=":$PATH"` | ## 9. Nützliche Befehle diff --git a/docs/KONZEPT.md b/docs/KONZEPT.md index aa49a65..f5c5ba5 100644 --- a/docs/KONZEPT.md +++ b/docs/KONZEPT.md @@ -178,11 +178,11 @@ ## 9. Hosting & Deployment (Strato) ## 10. Umsetzungsphasen 1. **Fundament:** Laravel + Filament, Datenmodell, Saisons/Preise, Preisberechnung (mit Tests). ✅ -2. **Kalender & Anfrage:** Belegung, Anfrageformular, Auto-Angebot per Mail, Vorreservierung mit Haltezeit, Sonderangebote, Sperrzeiten, Buchungsverwaltung. ✅ -3. **Buchungsworkflow:** Bestätigung, Mietvertrag-PDF, Zahlungsfristen & Erinnerungen, Anreiseinfos. ✅ (Mietbedingungen/Storno noch als Muster) -4. **Webseite:** Theme-System, Bausteine, Erscheinungsbilder, Seiten, SEO ✅ · Basis-Theme „Ostsee-Licht“ funktionsfähig; gestalterische Überarbeitung offen (Übergabe: docs/THEMES.md §10). -5. **Connectoren:** iCal-Import/-Export, Sync-Log, Konfliktwarnung. -6. **Go-Live:** Strato-Deployment, Umleitungen, Inhalte/Rechtstexte, Testbuchungen. +2. **Kalender & Anfrage:** Belegung, Anfrageformular, Vorreservierung mit Haltezeit, Sonderangebote (Rabattaktion, fester Termin, Lückenfüller), Mindestaufenthalt mit Ausnahmen, Sperrzeiten, Buchungsverwaltung. ✅ +3. **Buchungsworkflow:** Buchungsweg 1 Anfrage → Angebot → Annahme durch den Gast (§6a), Mietvertrag-PDF, Zahlungsfristen & Erinnerungen, Anreiseinfos. ✅ (Mietbedingungen/Storno/Angebotstexte noch als Muster) +4. **Webseite:** Theme-System, Bausteine, Erscheinungsbilder (Bilder je Baustein, saisonale Bausteine), Seiten, SEO, Markengrafiken ✅ · neues Design-Theme in eigener Session (docs/ZUSAMMENARBEIT.md, docs/THEME-ERSTELLUNG.md). +5. **Connectoren:** iCal-Import/-Export, Sync-Log, Konfliktwarnung, Portal-E-Mails. ✅ (echte Portal-Mails zur Feinabstimmung des Parsers fehlen) +6. **Go-Live:** Strato-Deployment und Testbetrieb ✅ · offen: Cronjob, Produktion, Umleitungen, Rechtstexte, echte Testbuchungen (Stand: docs/STATUS.md). ## 11. Offene Punkte / benötigte Inhalte diff --git a/docs/STATUS.md b/docs/STATUS.md new file mode 100644 index 0000000..1055614 --- /dev/null +++ b/docs/STATUS.md @@ -0,0 +1,100 @@ +# Projektstand + +Stand: 22.10.2026, Abend · letzter ausgelieferter Stand: Git-Tag `deploy/staging/20261022203959` auf https://stommer.info · 187 Tests grün + +> Dieses Dokument ist der Einstieg für jede neue Arbeitssitzung. Bitte bei größeren Änderungen fortschreiben (Abschnitte „Fertig“, „Offen“, „Nächste Schritte“). + +## 1. Fertig (umgesetzt, getestet, auf stommer.info) + +**Vermietung** +- **Preise:** Saisons mit Preis/Nacht und Mindestnächten; Preisrechner; Extras (Bettwäsche, Handtücher); Endreinigung, Zusatzperson, Anzahlungsquote, Restzahlungsfrist je Wohnung. In Folgejahr kopieren, optional mit Saisonbeginn auf einem Wochentag. *(Code: `app/Pricing`, `CopySeasonsToNextYear`)* +- **Mindestaufenthalt mit Ausnahmen:** Kalenderlücke vollständig gefüllt; Abreise am typischen Anreisetag; Sonderangebot hebt auf; absolute Untergrenze. *(`PriceCalculator::minimumStayRelaxed`, Einstellungen „Regeln Mindestaufenthalt“)* +- **Sonderangebote:** Rabattaktion, fester Termin (auch Pauschalpreis) und Lückenfüller (erkennt Lücken selbst). Dazu Aktionscodes, Priorität und „Hervorheben“. Die Webseite bewirbt Angebote nach eigenen Regeln (`OfferShowcase`), nebeneinander, als Liste oder rollierend. *(KONZEPT §5a)* +- **Buchungsweg 1 – Anfrage → Angebot → Annahme** (KONZEPT §6a): + 1. Der Gast fragt unverbindlich an; der Zeitraum ist für die Haltezeit vorgemerkt. + 2. Die Vermieterin öffnet „Angebot senden“ und passt bei Bedarf Termin, Personen, Rabattcode, Preis, Gültigkeit, Nachricht und Gastdaten an. + 3. Der Gast erhält eine E-Mail mit Vertragsentwurf (PDF) und einem signierten Link. + 4. Auf der Angebotsseite nimmt er an (Annahmenachweis ohne IP) oder lehnt ab. + 5. Nach der Annahme: Bestätigung und Mietvertrag, Zahlungsfristen laufen. + + Die Angebotsfrist verfällt automatisch. „Direkt bestätigen“ gibt es für telefonisch vereinbarte Buchungen. *(`SendOffer`, `AcceptOffer`, `RejectOffer`, `OfferController`, `resources/views/offer.blade.php`)* +- **Zahlungen:** manuell erfassen, Erinnerungen an Anzahlung und Rest, Anreiseinformationen, Bewertungsanfrage nach Abreise. +- **Gästekartei:** Notizen, Tags, CSV-Export, Werbe-Einwilligung mit Bestätigung per E-Mail (Double-Opt-in). Eine neue Anfrage überschreibt keine Stammdaten. +- **Portale:** iCal-Import und -Export, Überwachung, Portal-E-Mails als schneller Weg, Aufgaben für manuelle Sperren. *(PORTALE.md)* +- **Bewertungen:** Einladung per E-Mail, Freigabe im Admin, Anzeige mit Pflichthinweis zur Echtheit. + +**Verwaltung (Admin)** +- **Rollen:** Administrator, Vermietung, Inhalte. +- **Ansichten:** Die **einfache Ansicht** zeigt Anfragen & Buchungen, Sperrzeiten, **Preise & Angebote**, Gäste, Portal-Aufgaben, Bewertungen und Bilder. Die **Expertenansicht** zeigt alles. Umschalten im Benutzermenü. +- **Sicherheit:** 2FA ist für **alle** Konten Pflicht; Administratoren können die 2FA eines anderen Kontos zurücksetzen und Passwörter neu vergeben. + +**Webseite** +- **Theme-System:** Basis-Theme „Ostsee-Licht“, 15 Bausteine, Seiten-Baukasten. +- **Erscheinungsbilder** für Standard, Sommer, Winter, Weihnachten und Silvester: + - Bilder je Baustein, Bausteine nur in bestimmten Erscheinungsbildern, + - Vorschau-Links, Bildauswahl mit Vorschaubild. +- **Markengrafiken** im Theme: Logo, Favicon, Symbole, Wellenband, Illustration. *(`public/brand`, `partials/brand`)* +- **Theme-Werkzeuge:** `themes:make`, `themes:check`, `themes:preview`; Anleitung in THEME-ERSTELLUNG.md. +- **Fotos:** 39 Fotos aus dem alten WordPress importiert, GPS- und Kameradaten entfernt. + +**Betrieb und Datenschutz** +- **Deployment:** atomare Versionen auf Strato, Gesundheitscheck mit automatischem Zurückschalten; Versionsgeschichte als Git-Tags. Nur die aktive Version liegt auf dem Server (Strato-Dateilimit). +- **Datenbank-Backup:** täglich; `scripts/backup-pull.sh` holt es samt Dateien aufs NAS. +- **Datenschutz:** + - Anonymisierung und Löschfristen (Vorschläge) laufen täglich. + - Sicherheits-Header sind gesetzt; Automations-Tokens werden per Header übergeben. + - Keine externen Quellen (Schriften selbst gehostet). +- **Testbetrieb:** `noindex`; Mails gehen nur an `FEWO_MAIL_REDIRECT_TO`, sobald SMTP eingeschaltet ist. + +## 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 | +| E-Mail | `MAIL_MAILER=log` (geht nirgendwohin). Einschalten: `MAIL_MAILER=smtp` + `MAIL_PASSWORD` in `shared/.env` (selbst eintragen), Umleitung an `lars@stommer.com` ist gesetzt | +| 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). +- Neues Design-Theme: läuft in einer eigenen Session auf dem privaten Rechner (ZUSAMMENARBEIT.md, THEME-ERSTELLUNG.md). +- Logo in E-Mails und im Vertrags-PDF (`public/brand/logo-600.png` liegt bereit). +- Content-Security-Policy: braucht wegen Livewire/Filament Nonces und einen sorgfältigen Test. +- Produktion `www.fewo-stommer.de` vorbereiten: + - eigener Deploy-Ordner, Datenbank und `.env`, + - Umleitungen von der alten WordPress-Seite, + - echte Testbuchungen (GO-LIVE-CHECKLISTE.md). +- Später: + - Buchungsweg 2 (verbindliche Direktbuchung), erst bei verlässlicher Synchronisation mit FeWo-direkt, + - Portalbuchungen als vollwertige Buchungen (DATENMODELL-KONZEPT.md), + - Stornoformular für Gäste, KI-Angebotsentwürfe, Marketing und Social Media. +- SSH-Schlüssel des Firmen-Laptops vom Server entfernen, sobald der private PC eingerichtet ist (BETRIEB.md §4). + +## 4. Nächste Schritte (Vorschlag) + +1. Cronjob einrichten; SMTP im Testbetrieb einschalten; Konto für Brigitte anlegen. +2. Brigitte probt Anfrage → Angebot → Annahme mit einem eigenen Test (Angebotslink über die Aktion „Angebotslink“). +3. Design-Theme auf dem privaten Rechner (eigene Session, siehe ZUSAMMENARBEIT.md). +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`, `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) | diff --git a/docs/THEME-ERSTELLUNG.md b/docs/THEME-ERSTELLUNG.md index b559fef..e2e5e52 100644 --- a/docs/THEME-ERSTELLUNG.md +++ b/docs/THEME-ERSTELLUNG.md @@ -2,6 +2,8 @@ # 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) +> **Vor dem Start:** [ZUSAMMENARBEIT.md](ZUSAMMENARBEIT.md) lesen – die Design-Session arbeitet auf dem Branch `theme/` und nur im eigenen Theme-Ordner; Wünsche an die Anwendung gehen in ZUSAMMENARBEIT.md §5, Änderungen am Vorlagen-Vertrag stehen in §6. + > **Kurz:** Ein neues Design entsteht als **zusätzliches Theme** in einem eigenen Ordner `resources/themes//`. 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 ` 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. --- @@ -19,7 +21,7 @@ ## 1. Grundregeln (nicht verhandelbar) ## 2. Schnellstart ```bash -git pull # aktuellen Stand holen +git checkout main && git pull && git checkout -b theme/ # eigener Branch (ZUSAMMENARBEIT.md §2) 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) @@ -199,6 +201,18 @@ ## 7. Schriften, Bilder, Icons, Bewegung - **Icons:** Inline-SVG; Heroicons sind über Blade verfügbar (``, 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`. +## 7a. Markengrafiken + +Logo, Favicon, Symbole und Wellenband liegen als saubere SVGs in `public/brand/` (Beschreibung und Farben: `styles/README.md`). In Vorlagen inline einbinden – dann färben sie sich über CSS-Variablen: + +```blade +@include('theme::partials.brand', ['name' => 'mark', 'class' => 'h-11 w-auto']) {{-- Bildmarke --}} +@include('theme::partials.brand', ['name' => 'wave-divider', 'class' => 'w-full h-auto']) {{-- Trenner --}} +@include('theme::partials.brand', ['name' => 'icon-location', 'class' => 'size-10', 'label' => 'Lage']) +``` + +Verfügbar: `mark`, `logo`, `wave-divider`, `icon-apartment`, `icon-sea`, `icon-terrace`, `icon-location`. Farben: `--brand-navy` (Standard = Textfarbe `--ink`, damit dunkle Erscheinungsbilder funktionieren), `--brand-teal`, `--brand-wave`, `--brand-sun` – im eigenen `theme.css` oder lokal (`class="[--brand-navy:var(--band-ink)]"`) überschreibbar. Favicon/App-Symbol bindet das Layout ein (`asset('brand/favicon.svg')`). Grafiken nicht verändern (Marke); eigene dekorative Grafiken gehören in den Theme-Ordner. + ## 8. Qualität Es gelten [THEMES.md](THEMES.md) §8: @@ -213,7 +227,7 @@ ## 9. Prüfen, ansehen, einbinden 1. **Prüfen:** `php artisan themes:check `. Rote Punkte (✗) sind Fehler und müssen behoben werden, gelbe (!) sind Hinweise. 2. **Ansehen, ohne etwas umzuschalten:** `php artisan themes:preview ` 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//**`, ggf. `package*.json`) und Push nach Gitea. +4. **Einreichen:** Commit (nur `resources/themes//**`, ggf. `package*.json`) auf `theme/`, Push nach Gitea, Merge-Request nach `main` (ZUSAMMENARBEIT.md §2). Ausgeliefert wird nur aus `main`. 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 ` über `bash scripts/deploy.sh staging artisan themes:preview `). 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. @@ -223,6 +237,7 @@ ## 10. Checkliste vor Abschluss - [ ] Theme mit `themes:make` angelegt; `resources/themes/ostsee-licht/**` unverändert (`git status`) - [ ] `themes:check ` ohne Fehler; Warnungen bewertet - [ ] Alle Seiten (`/`, `/wohnung`, `/kuehlungsborn`, `/buchen`, `/kontakt`, `/impressum`, `/datenschutz`) auf Handy (360 px), Tablet und Desktop geprüft +- [ ] Seiten außerhalb der Bausteine im neuen Layout geprüft: **Angebotsseite** des Gastes (Admin › Buchung › „Angebot senden“, dann „Angebotslink“) und **Bewertungsseite** - [ ] 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 diff --git a/docs/ZUSAMMENARBEIT.md b/docs/ZUSAMMENARBEIT.md new file mode 100644 index 0000000..91c9878 --- /dev/null +++ b/docs/ZUSAMMENARBEIT.md @@ -0,0 +1,71 @@ +# Zusammenarbeit – parallele Sessions ohne Konflikte + +Stand: 22.10.2026 · gilt für alle Arbeitssitzungen (Mensch oder KI), die gleichzeitig am Projekt arbeiten + +## 1. Wer arbeitet woran + +| Session | Rechner | Aufgabe | Branch | Darf ändern | +|---|---|---|---|---| +| **A – Anwendung** | Firmen-Laptop (oder jeder andere) | Funktionen, Verwaltung, Abläufe, Betrieb, Deployment | `main` (größere Vorhaben: `feature/`) | alles **außer** `resources/themes//**` | +| **B – Design** | privater PC, Plugin `frontend-design` | ein **neues, zusätzliches Theme** | `theme/` (z. B. `theme/ostsee-nacht`) | nur `resources/themes//**`, `package.json`/`package-lock.json` (nur `@fontsource`-Schriften), `docs/STATUS.md` (eigener Abschnitt) | + +Session B ändert **nicht**: `app/**`, `config/**`, `database/**`, `routes/**`, `resources/views/**` (auch nicht die Livewire-Formulare), `resources/themes/ostsee-licht/**`, `public/brand/**`, andere Dokumente. Braucht das Theme etwas aus diesen Bereichen (neue Daten in einem Baustein, ein neuer Baustein, eine Schrift-Lizenzfrage …), trägt Session B den Wunsch in §5 ein. Session A setzt ihn um. + +## 2. Ablauf Session B (Design) + +```bash +git clone https://gitea.stommer.de/Lars/fewo-stommer.git && cd fewo-stommer # einmalig +git checkout main && git pull +git checkout -b theme/ # einmalig +php artisan themes:make --name="…" --description="…" +# … arbeiten (docs/THEME-ERSTELLUNG.md) … +git add resources/themes/ package.json package-lock.json && git commit -m "Theme : …" +git push -u origin theme/ +``` + +**Täglich vor der Arbeit** den Stand der Anwendung übernehmen, damit Vorlagen-Vertrag und Tests aktuell sind: + +```bash +git fetch origin && git merge origin/main # Konflikte kann es nur in package-lock.json geben, siehe §4 +php artisan migrate && npm ci && php artisan test --compact +``` + +**Zusammenführen:** Sobald `php artisan themes:check ` ohne Fehler und `php artisan test --compact` grün ist, Merge-Request in Gitea von `theme/` nach `main` – oder lokal `git checkout main && git pull && git merge --no-ff theme/ && git push`. Ein unfertiges Theme darf zusammengeführt werden. Es ist installiert, aber nicht aktiv, solange es niemand unter Admin › Websites auswählt. Zusammenführen hilft sogar, weil dann die Vorschau auf stommer.info möglich ist. + +## 3. Ausliefern (Deployment) + +- **Nur aus `main`, nur nach `git pull`, nur mit grünen Tests.** Das Skript baut den letzten Commit des **lokalen** Stands. Wer aus einem Feature- oder Theme-Branch ausliefert, nimmt alle Änderungen der anderen Session vom Server. +- Theme-Vorschau auf stommer.info: erst nach dem Zusammenführen in `main`, dann `bash scripts/deploy.sh staging deploy` und `bash scripts/deploy.sh staging artisan themes:preview ` (gibt die Vorschau-Links aus). +- Das neue Theme aktivieren (Admin › System › Websites › Theme) entscheidet Lars, nach Sichtung der Vorschau. +- `shared/.env` auf dem Server ändert nur Lars (Passwörter); Sessions ändern dort höchstens nicht geheime Werte und dokumentieren das in BETRIEB.md. +- Jede Session braucht ihren **eigenen SSH-Schlüssel** für Strato (BETRIEB.md §4); keine Schlüssel kopieren. + +## 4. Konflikte vermeiden + +| Datei/Bereich | Regel | +|---|---| +| `package.json`, `package-lock.json` | Während der Theme-Phase installiert nur Session B neue npm-Pakete (Schriften). Bei Konflikt: Version von `main` übernehmen, dann eigene Pakete neu installieren: `git checkout --theirs package-lock.json && npm install @fontsource/` | +| Vorlagen-Vertrag (`app/Themes/**`, Bausteine, Basis-Theme `ostsee-licht`, THEMES.md §4/§5, THEME-ERSTELLUNG.md §6) | Ändert nur Session A – und trägt jede Änderung in §6 ein, damit Session B sie nachzieht | +| `docs/STATUS.md` | Beide dürfen schreiben – Session B nur in einem eigenen Abschnitt „Design-Theme“ | +| `public/build` | Wird nicht committet (Build-Ergebnis); nie von Hand ändern | +| Datenbank-Migrationen | Nur Session A | + +## 5. Wünsche der Design-Session an die Anwendung + +*(Session B trägt hier ein, was sie braucht; Session A erledigt es und vermerkt „erledigt in “.)* + +| Datum | Wunsch | Status | +|---|---|---| +| | | | + +## 6. Änderungsprotokoll Vorlagen-Vertrag + +*(Session A trägt hier jede Änderung ein, die Theme-Vorlagen betrifft.)* + +| Datum | Änderung | Betrifft | +|---|---|---| +| 22.10.2026 | `theme-base.css` (Schriften, Token-Mapping, Basis-Klassen) von `theme.css` getrennt – Child-Themes importieren `theme-base.css` | theme.css | +| 22.10.2026 | Markengrafiken: `@include('theme::partials.brand', ['name' => 'mark', 'class' => '…'])` (mark, logo, wave-divider, icon-apartment/-sea/-terrace/-location); Farben über `--brand-navy/-teal/-wave/-sun` (navy = Textfarbe) | header, footer, facts, location, image | +| 22.10.2026 | `hero`: `$featuredOffer` (wichtigstes hervorgehobenes Angebot oder null) | sections/hero | +| 22.10.2026 | `offers`: `$display` (grid/list/rotating), `$offers` = `AdvertisedOffer` (Termin, Preis, `bookingUrl()`); rollierend über `data-rotator*` | sections/offers | +| 22.10.2026 | Seiten außerhalb der Bausteine, die das Theme-Layout nutzen: Angebotsseite `resources/views/offer.blade.php`, Bewertung `resources/views/review.blade.php` – beim Theme-Test mitprüfen | layouts/app |