- 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>
131 lines
8.3 KiB
Markdown
131 lines
8.3 KiB
Markdown
# 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“)?
|