Files
fewo-stommer/docs/KONZEPT.md
T
Lars StommerandClaude Opus 5.5 2e9a391b37 Phase 1: Wohnungen, Saisons & Preisberechnung
- Datenmodell Property/Season/Extra (Beträge in Cent), Seeder mit Preisliste 2026
- PriceCalculator: Saison-Splitting, Mindestaufenthalt, Zusatzperson, Endreinigung, Extras, Anzahlung/Restzahlung
- Filament-Verwaltung: Wohnungen, Saisons (Überschneidungsprüfung, Lückenwarnung, Kopie ins Folgejahr, Preisrechner), Zusatzleistungen
- Tests für Preisberechnung und Saisonverwaltung

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 09:19:49 +02:00

131 lines
8.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Ferienwohnung Stommer – Konzept Webseite & Verwaltungssystem
Stand: 22.10.2026
## 1. Ziele
| Heute (WordPress) | Ziel |
|---|---|
| Preise als Tabelle von Hand gepflegt, fehleranfällig (z. B. „Weihnachten 19.12.–26.01.“ überschneidet sich mit Neujahr) | Saisons & Preise im Admin, mit Validierung (keine Lücken/Überschneidungen), Preise werden automatisch berechnet |
| Belegungsplan extern (ferienundwohnen.de) | Eigener Belegungskalender, synchronisiert mit allen Portalen |
| Anfrage nur per E-Mail, keine Auto-Antwort | Strukturierte Anfrage mit sofortigem, verbindlich kalkuliertem Angebot |
| Mietvertrag per Hand | Mietvertrag als PDF auf Knopfdruck bzw. automatisch bei Bestätigung |
| Zahlungen manuell verfolgt | Anzahlung/Restzahlung mit Fälligkeiten und automatischen Erinnerungen |
## 2. Rahmenbedingungen
- **Hosting:** Strato Webhosting (PHP 8.x, MySQL). Kein Node.js im Betrieb – Frontend-Assets werden lokal gebaut und mit deployt.
- **Buchungsablauf:** Anfrage → automatisches Angebot → Bestätigung durch Vermieter (1 Klick) → Vertrag + Zahlungsinfos automatisch.
- **Zahlung:** Überweisung (Anzahlung 35 %, Rest 4 Wochen vor Anreise). Online-Zahlung später als Erweiterung möglich.
- **Portale:** wechselnd (FeWo-direkt, Traum-Ferienwohnungen, ferienundwohnen.de, …) → **erweiterbares Connector-System**.
## 3. Technologie
| Bereich | Wahl | Begründung |
|---|---|---|
| Backend | **Laravel 13** (PHP 8.4) | Läuft auf Shared Hosting, ausgereift, Queue/Scheduler/Mail/PDF eingebaut |
| Admin | **Filament 5** | Professionelles Verwaltungs-UI (Tabellen, Formulare, Kalender, Dashboards) ohne Eigenbau |
| Frontend | Blade + Tailwind CSS + Alpine.js/Livewire | Server-gerendert → schnell, SEO-stark, kaum JavaScript |
| Datenbank | MySQL 8 (Strato), lokal SQLite | |
| PDF | dompdf / Browsershot-frei | Läuft ohne Zusatzsoftware auf Shared Hosting |
| Bilder | Responsive Images (AVIF/WebP, `srcset`), lazy loading | Core Web Vitals |
| Hintergrundjobs | Laravel Scheduler per Strato-Cronjob (jede Minute/5 Min.) | iCal-Sync, Erinnerungs-Mails |
Neueste Standards: HTTPS/HSTS, Core Web Vitals „grün“, semantisches HTML, WCAG 2.2 AA, strukturierte Daten (schema.org `VacationRental`/`LodgingBusiness`), Open Graph, sitemap.xml, hreflang (DE/EN vorbereitet), keine externen Fonts/Tracker (DSGVO, kein Cookie-Banner nötig).
## 4. Öffentliche Webseite
- **Start:** großes Bild, Kernfakten (53 m², EG, Terrasse, 1–3 Pers., WLAN, Parkplatz), Verfügbarkeits-/Preis-Widget direkt oben.
- **Die Wohnung:** Räume & Ausstattung strukturiert (Icons), Grundriss, Galerie mit Lightbox.
- **Preise & Belegung:** Live-Kalender (frei/belegt, Mindestaufenthalt je Saison), Preisrechner mit Gesamtpreis inkl. aller Pflichtkosten (Preisangabenverordnung).
- **Kühlungsborn & Umgebung:** Lage, Strand, Hafen, Karte (datenschutzfreundlich, z. B. statisches Kartenbild/OpenStreetMap nach Klick).
- **Anfrage/Buchung:** Zeitraum, Personen, Extras (Bettwäsche, Handtücher), Kontaktdaten → sofortiges Angebot.
- **Bewertungen** (eigene, aus abgeschlossenen Aufenthalten eingesammelt).
- Kontakt, Impressum, Datenschutz, Mietbedingungen.
- Spätere Erweiterung: Gästebereich (Buchung einsehen, Anreiseinfos).
## 5. Verwaltungssystem (Admin)
- **Dashboard:** nächste An-/Abreisen, offene Anfragen, fällige Zahlungen, Auslastung/Umsatz pro Jahr.
- **Kalender:** alle Buchungen + Portal-Blockierungen + manuelle Sperrzeiten (Eigennutzung, Renovierung).
- **Saisons & Preise:** pro Saison Zeitraum, Preis/Nacht, Mindestaufenthalt, optional An-/Abreisetage. Jahr kopieren („Preise 2027 = 2026“) mit einem Klick.
- **Preisbestandteile (konfigurierbar):** Endreinigung/Service (108 €), Zusatzperson ab 3. Person (7,50 €/Nacht), Extras (Bettwäsche 14 €, Handtücher 11 €, Paket 23 €), Kurtaxe (Hinweis, vor Ort), Anzahlungsquote 35 %, Restzahlungsfrist 4 Wochen.
- Darstellung wahlweise wie heute („erste Nacht inkl. Endreinigung“) oder transparent getrennt – die Berechnung ist identisch.
- **Anfragen & Buchungen:** Statusworkflow, Notizen, komplette Kommunikationshistorie.
- **Gäste:** Kartei, Wiederkehrer, DSGVO-Löschfristen.
- **Vorlagen:** E-Mail-Texte und Mietvertrag mit Platzhaltern editierbar.
- **Portale/Connectoren:** siehe Abschnitt 7.
## 6. Workflows
```
Anfrage ──► Auto-Mail: Angebot (Preis, Zeitraum, Bedingungen), Termin wird 48 h „vorgemerkt“
│
├─ Vermieter bestätigt (1 Klick) ──► Mail: Buchungsbestätigung + Mietvertrag (PDF) + Bankdaten/Anzahlung
│ │
│ ├─ Anzahlung nicht eingegangen nach X Tagen ──► Erinnerung
│ ├─ Restzahlung fällig (−4 Wochen) ──► Zahlungsaufforderung, ggf. Erinnerung
│ ├─ −7 Tage ──► Anreiseinformationen (Schlüssel, Parken, WLAN, Hausregeln)
│ └─ +2 Tage nach Abreise ──► Dankeschön + Bitte um Bewertung
│
├─ Vermieter lehnt ab ──► höfliche Absage, ggf. Alternativtermine
└─ keine Reaktion/Ablauf ──► Vormerkung verfällt, Kalender wird frei
```
Status: `Anfrage → Angebot → Bestätigt → Anzahlung erhalten → Bezahlt → Abgeschlossen` (+ `Abgelehnt`, `Storniert`, `Abgelaufen`).
Zahlungseingang wird manuell im Admin abgehakt (später optional: Abgleich über Bank-CSV-Import).
## 7. Connector-/Plugin-System für Portale
Portale wechseln → jedes Portal ist ein eigenständiger **Channel-Connector** hinter einer gemeinsamen Schnittstelle:
```php
interface ChannelConnector
{
public function key(): string; // 'fewo-direkt', 'traum-ferienwohnungen', …
public function capabilities(): array; // ['import_availability', 'export_availability', 'import_bookings', 'push_rates']
public function settingsSchema(): array; // Felder fürs Admin-Formular (z. B. iCal-URL)
public function importBlockedPeriods(Channel $c): Collection;
}
```
- **Stufe 1 (alle Portale):** generischer **iCal-Connector** – Import der Portal-Belegung (alle 15 Min.), Export eines eigenen iCal-Feeds pro Portal. Neues Portal = im Admin anlegen + URL eintragen, kein Code nötig.
- **Stufe 2 (bei Bedarf):** portalspezifische Connectoren (API, z. B. Buchungsdetails, Preise) als eigene Klasse, registriert in `config/channels.php`.
- Jeder Sync wird protokolliert; Konflikte (Doppelbelegung) lösen eine sofortige Warn-Mail aus.
- Hinweis: iCal synchronisiert mit Verzögerung (Portale ziehen teils nur stündlich) – ein kleines Doppelbuchungsrisiko bleibt, wie bei allen Lösungen ohne Channel-Manager-API.
## 8. Rechtliches (Deutschland)
- Impressum, Datenschutzerklärung (DSGVO), Mietbedingungen/AGB – **Texte sollten juristisch geprüft werden**.
- Gesamtpreisangabe inkl. Pflichtkosten (PAngV); Kurtaxe als Hinweis.
- Keine Drittanbieter-Einbindungen ohne Einwilligung → kein Cookie-Banner nötig.
- Mietvertrag-Vorlage: bestehenden Vertrag übernehmen.
## 9. Hosting & Deployment (Strato)
- Domain-Ziel auf das Verzeichnis `public/` zeigen lassen.
- Zu prüfen im Strato-Paket: PHP-Version ≥ 8.3, SSH-Zugang, Cronjobs, MySQL-Datenbank, SMTP-Postfach (fewo@stommer.de).
- Deployment per Skript (rsync/SFTP) mit Build lokal; Datenbank-Backups täglich.
- Migration: Umleitungen (301) der alten WordPress-URLs, Bilder übernehmen.
## 10. Umsetzungsphasen
1. **Fundament:** Laravel + Filament, Datenmodell, Saisons/Preise, Preisberechnung (mit Tests). ✅
2. **Kalender & Anfrage:** Belegung, Anfrageformular, Auto-Angebot per Mail.
3. **Buchungsworkflow:** Bestätigung, Mietvertrag-PDF, Zahlungsfristen & Erinnerungen.
4. **Webseite:** Design, Inhalte, Galerie, SEO, Barrierefreiheit.
5. **Connectoren:** iCal-Import/-Export, Sync-Log, Konfliktwarnung.
6. **Go-Live:** Strato-Deployment, Umleitungen, Inhalte/Rechtstexte, Testbuchungen.
## 11. Offene Punkte / benötigte Inhalte
- [ ] Strato-Tarif prüfen (SSH, Cronjobs, PHP-Version)
- [ ] Bestehender Mietvertrag (Vorlage) und Mietbedingungen
- [ ] Hochauflösende Fotos
- [ ] An-/Abreisezeiten, Stornobedingungen, Haustiere/Rauchen
- [ ] Preise 2027 bestätigen; Korrektur Weihnachten/Neujahr-Zeiträume
- [ ] Bankverbindung für Zahlungsinformationen
- [ ] Sprachen: Deutsch + Englisch?
- [ ] Nachbarwohnung: ebenfalls verwalten (Kombi-Buchung „zwei Familien“)?