Compare commits
15
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
cf11c8a474 | ||
|
|
64248c09fa | ||
|
|
987c67d4d3 | ||
|
|
3a728c3255 | ||
|
|
9005c12164 | ||
|
|
2d458d9116 | ||
|
|
65fe8f5c6c | ||
|
|
0dc0470c60 | ||
|
|
382c1724a3 | ||
|
|
4587912e5b | ||
|
|
d0eb79bb9b | ||
|
|
9f3501e045 | ||
|
|
7d7c5db1fd | ||
|
|
a1fc4f7fef | ||
|
|
545008baab |
No files matched your search
@@ -0,0 +1,236 @@
|
||||
# MVP-COMPLIANCE-ACCEPTANCE – Abnahmebericht
|
||||
|
||||
> **Stand 30.10.2026 (Abstimmung mit dem Betreiber):** Umgesetzt und zu liefern ist nur der rechtlich/sicherheitsrelevante Kern: Datenschutzlink im Buchungsformular, HTTPS-Erzwingung, deutsche Fehlerseiten, Ausnahme in `ResolveTheme` für signierte Links/Feeds. Zurückgestellt (nicht im Code, Patch nur im Scratchpad; erst nach Absprache mit Visual- und Buchungsagent): Rotator-Autoplay-Änderung, Token-Header-Härtung, WordPress-Weiterleitungen, Fokus-/Fehlerhinweis-Logik und noscript-Hinweis im Formular. Aussagen dazu weiter unten sind entsprechend als **zurückgestellt** zu lesen.
|
||||
|
||||
|
||||
Stand: 30.10.2026 · Grundlage: `MVP-TECHNICAL-GATE.md` · Dokumentiert sind nur tatsächlich ausgeführte Arbeiten.
|
||||
|
||||
**Wichtig vorab:**
|
||||
- Alle Codeänderungen liegen **nur lokal** im Arbeitsverzeichnis (Branch `feature/buchung-e2e`, nicht committet, nicht deployt). Dort arbeitet parallel eine zweite Sitzung am Buchungsprozess; deren Dateien wurden nicht angefasst.
|
||||
- Auf `stommer.info` wurde **nichts verändert**: keine Deployments, kein Formular-Absenden, keine Datenbank-, Feed-, Token- oder Konfigurationsänderung. Es gab nur lesende Abrufe und einen Browserlauf, der Seiten öffnet, Kalendertage markiert (Livewire-Berechnung, nichts gespeichert) und nie absendet.
|
||||
- Ergebnisse mit **PASS** sind ausgeführt. Was nur aus dem Code folgt oder nicht ausführbar war, steht als **UNKNOWN** bzw. **BLOCKED**.
|
||||
|
||||
## Zusammenfassung / Empfehlung
|
||||
|
||||
**Technisches Votum: NO-GO für die Umschaltung jetzt, GO-fähig nach den unten genannten Schritten.** Die Codeblocker sind behoben und getestet. Offen sind Dinge, die nur auf dem Server bzw. mit Betreiberfreigabe gehen: Deployment der Änderungen, MariaDB-Restore, Produktions-`.env`, Mailtest über das echte Formular, Ausnahme der Alias-Host-Weiterleitung für signierte Links und Feeds (siehe Risiko R1).
|
||||
|
||||
| ID | Thema | Ergebnis |
|
||||
|---|---|---|
|
||||
| B1 | HTTPS erzwingen | Code PASS (Test), Server UNKNOWN bis Deployment |
|
||||
| B2 | Datenschutzlink im Formular | PASS (Test + Browser lokal) |
|
||||
| B3 | Produktivkonfiguration / Mailtest | UNKNOWN / BLOCKED |
|
||||
| B4 | Backup + Restore | Restore SQLite PASS, MariaDB UNKNOWN |
|
||||
| P1-a | Formularfehler | PASS (Test + Browser lokal) |
|
||||
| P1-b | Rotator | PASS (Code + Test der Struktur), keine Auto-Rotation mehr |
|
||||
| P1-c | `<noscript>`-Hinweis | PASS (Test) |
|
||||
| P1-d | Deutsche Fehlerseiten | PASS (Test + Browser lokal) |
|
||||
| P1-e | Query-Token / interner Pfad | Teilweise: Token-Schalter PASS, Pfad durch B1-Lösung adressiert |
|
||||
| P1-f | Browser-Cookie-Check | PASS (echter Chromium auf stommer.info) |
|
||||
| P1-g | Domainwechsel-Vorbereitung | Code PASS, Umschaltung nicht durchgeführt |
|
||||
|
||||
---
|
||||
|
||||
## Neue Environment-Zuordnung (laut Ergänzung)
|
||||
|
||||
| Umgebung | Rolle künftig | Schutz |
|
||||
|---|---|---|
|
||||
| `stommer.info` (Ordner `test.fewo-stommer.de/`) | **wird Produktion** (In-place-Promotion), enthält operative Daten, Kalenderimporte, n8n-Scheduler | Nur lesender Zugriff in diesem Auftrag |
|
||||
| `prod.fewo-stommer.de/` (leer angelegt) | **soll Testsystem werden** | Noch nicht eingerichtet, siehe „Testsystem-Isolation“ |
|
||||
| `www.fewo-stommer.de` (WordPress) | wird abgelöst | Bis zur Freigabe unverändert |
|
||||
|
||||
### Zu schützende Bestände auf stommer.info (aus Code/Doku, nicht am Server gezählt)
|
||||
- Datenbank `dbs16257975` (Buchungen, Gäste, Angebote, CMS-Seiten, Sites/Domains, Benutzer, Kanäle, Feed-Tokens `channels.export_token`).
|
||||
- Persistente Dateien in `shared/storage/app` (Fotos/Medien öffentlich, Verträge/Backups privat) und `shared/.env`.
|
||||
- Integrationen: n8n-Scheduler-Workflow (Header-Auth, jede Minute), Kalenderimport aus Portal-Feeds (5 Min.), ausgehende iCal-Feeds `/kalender/<token>.ics` für Portale, optional `/automation/portal-mail` (HMAC).
|
||||
- SMTP-Versand mit Testmodus (`App\Support\Settings`) – Testmodus leitet alle Mails an Testadresse.
|
||||
|
||||
## Nachweis der Testsystem-Isolation – Status: **UNKNOWN**
|
||||
|
||||
Nicht umgesetzt, weil Zugriff auf `prod.fewo-stommer.de` und Strato-Panel zum Anlegen einer zweiten Datenbank Betreiberaktion/Freigabe benötigt. Geplante Isolation (alle Punkte sind Konfiguration, kein Code):
|
||||
|
||||
1. **Eigene Datenbank** (zweite Strato-MariaDB), eigener `APP_KEY`, eigene Sessions/Caches (DB-Treiber in eigener DB).
|
||||
2. `APP_ENV=staging` → automatisch `noindex` (bereits implementiert) und `FEWO_MAIL_REDIRECT_TO=<Testadresse>` als **harte** Mailumleitung.
|
||||
3. Keine Kanäle mit Schreibwirkung: Beim Befüllen mit synthetischen Daten **keine** Kanäle anlegen bzw. alle Kanäle auf „Import aus/Export pausiert“ lassen. Eigene Feed-Tokens entstehen automatisch neu.
|
||||
4. `FEWO_AUTOMATION_WEBHOOK_URL`, `FEWO_AUTOMATION_SECRET`, `FEWO_HEALTH_TOKEN`, `FEWO_SCHEDULER_TOKEN` leer oder neu und **nicht** im produktiven n8n eingetragen. `FEWO_MAILBOX_HOST` leer (kein Postfach-Abruf).
|
||||
5. Eigene Medien unter `prod.fewo-stommer.de/shared`, kein Link auf den Speicher von stommer.info.
|
||||
6. Daten: synthetisch per Seeder. Kopie produktiver Daten nur nach gesonderter Freigabe und Pseudonymisierung.
|
||||
7. Hinweis: `pipeline.toml` führt die Produktion derzeit gesperrt. Das Ziel `main → prod.fewo-stommer.de` wird dann praktisch zum Testziel. Umbenennung des Ziels (z. B. in `test`) ist eine Entscheidung am gemeinsam genutzten PipelineManager und wird hier **nicht** vorgenommen.
|
||||
|
||||
---
|
||||
|
||||
## Finding-Details
|
||||
|
||||
### B1 – HTTPS erzwingen
|
||||
- **Ursprünglicher Befund:** `http://stommer.info/` lieferte `200`, keine Weiterleitung.
|
||||
- **Maßnahme:** Neue Middleware `ForceHttps` (GET/HEAD → `301`, andere Methoden → `308`) als erste globale Middleware. Bewusst in der Anwendung statt `.htaccess`: Die `.htaccess` im Deploy-Ordner wird bei jedem Umschalten vom **gemeinsamen PipelineManager** (`manager/remote.sh`) bzw. `scripts/deploy.sh` neu geschrieben, eine Regel dort würde überschrieben bzw. erforderte Eingriff in geteilte Infrastruktur. Außerdem sieht die Anwendung bereits den bereinigten Pfad, daher kein interner `/releases/<id>/public`-Pfad im Ziel. Schalter `FEWO_FORCE_HTTPS` (Standard: an, außer `local`/`testing`).
|
||||
- **Dateien:** `app/Http/Middleware/ForceHttps.php`, `bootstrap/app.php`, `config/fewo.php`, `.env.production.example` nicht nötig (Standard an), `docs/BETRIEB.md`.
|
||||
- **Tests:** `GoLiveComplianceTest::test_plain_http_is_redirected_to_https_without_internal_paths` – **PASS** (301 mit Pfad+Query, 308 für POST, HTTPS unberührt).
|
||||
- **Nicht ausgeführt:** echter `curl -I http://stommer.info/` nach Deployment → **UNKNOWN**. Offen: Redirect-Loop-Test hinter Strato (Erkennung von HTTPS über `isSecure()` funktioniert laut vorhandenem HSTS-Header bereits auf dem Server – dieselbe Erkennung).
|
||||
- **Risiko:** Statische Dateien (`/build/...`, Bilder) werden vom Webserver direkt ausgeliefert und umgehen die Anwendung (kein Sicherheitsproblem, aber keine Umleitung). Strato-Option „SSL erzwingen“ zusätzlich aktivieren.
|
||||
- **Betreiberaktion:** Deployment freigeben; optional Strato „SSL erzwingen“ aktivieren; Zertifikat für `fewo-stommer.de` **und** `www.fewo-stommer.de` im Paket zuordnen.
|
||||
|
||||
### B2 – Datenschutzlink im Formular
|
||||
- **Maßnahme:** „Datenschutzerklärung“ im Einwilligungssatz ist jetzt Link auf die bestehende CMS-Route (`route('page', 'datenschutz')`), `target="_blank" rel="noopener"`, mit für Screenreader sichtbarem Zusatz „(öffnet in neuem Tab)“. Neuer Tab ⇒ Eingaben gehen nicht verloren. Redaktioneller Text unverändert.
|
||||
- **Datei:** `resources/views/livewire/booking-request.blade.php`.
|
||||
- **Tests:** Feature-Test (Link im gerenderten HTML) – **PASS**. Browser lokal: Link im Formular vorhanden (1), per Tab erreichbar – **PASS**.
|
||||
- **Gesonderter Befund (Betreiberentscheidung, nicht geändert):** Die Pflicht-Checkbox „Ich bin einverstanden …“ formuliert technisch eine Einwilligung und erzwingt sie per `accepted`-Regel. Zur Bearbeitung einer Anfrage genügt rechtlich möglicherweise eine **Datenschutzinformation** (Art. 13 DSGVO, Rechtsgrundlage Vertragsanbahnung). Die Einordnung und ein ggf. geänderter Text liegen beim Betreiber; technisch wäre die Umstellung klein (Checkbox → Hinweis).
|
||||
|
||||
### B3 – Produktivkonfiguration
|
||||
- **Ursprünglicher Befund:** Produktion nicht eingerichtet; Mailzustellung nicht nachgewiesen.
|
||||
- **Korrigierter Stand laut Auftrag:** SMTP funktioniert bereits, Testmodus vorhanden. Keine neue Mailfunktion gebaut.
|
||||
- **Maßnahme:** `.env.production.example` um `FEWO_ALLOW_QUERY_TOKEN` ergänzt. Die Soll-Konfiguration für die **In-place-Promotion** von stommer.info ist unten im Promotion-Plan als Differenz zur bestehenden `.env` aufgelistet. Es wurde **keine** `.env` gelesen oder verändert (Geheimnisse).
|
||||
- **Nicht ausgeführt (BLOCKED):** Testanfrage über das Formular auf stommer.info. Sie würde eine echte Reservierung im realen Kalender anlegen und ist laut Ergänzung untersagt. Stattdessen laufen die vorhandenen Feature-Tests mit `Mail::fake()` (Bestätigungs- und Benachrichtigungsmails werden erzeugt: siehe Suite). **Mail-Trennung beachten:** Transport (funktioniert) vs. Auslöser im Workflow – bei „Anfrage → Angebot“ versendet der Betreiber das Angebot manuell; das ist Gegenstand des separaten Buchungsauftrags.
|
||||
- **Empfohlener Abnahmetest nach Freigabe:** Im **Testmodus** (alle Mails an Testadresse) eine Anfrage über das Formular mit Testdaten für ein weit entferntes Datum stellen, Mails prüfen, Reservierung anschließend im Admin stornieren/löschen. Alternativ im isolierten Testsystem.
|
||||
|
||||
### B4 – Backup und Restore
|
||||
- **Maßnahme/Test (lokal, ausgeführt):** `backup:database` gegen eine frisch migrierte und gesäte SQLite-Datenbank (42 Tabellen, 98 Zeilen), Dump per PDO in eine leere Datei zurückgespielt. Ergebnis: Tabellenliste identisch, **alle Zeilenzahlen gleich**, `migrate:status` auf der Wiederherstellung: 66 „Ran“, 0 „Pending“. – **PASS (SQLite)**.
|
||||
- **Nicht ausgeführt:** Restore des **MariaDB**-Dumps aus stommer.info in eine zweite leere Datenbank. Das braucht eine zweite Strato-Datenbank (Betreiberaktion). Der MariaDB-Dumpcode (`SHOW CREATE TABLE`, Batch-Inserts, Fremdschlüssel-Schalter) ist damit **nicht durch Ausführung belegt** → **UNKNOWN**.
|
||||
- **Backup-Bestand:** Täglich 02:30 per Scheduler, 14 Dateien unter `shared/storage/app/private/backups` (privat, nicht webzugänglich). Externe Kopie: `scripts/backup-pull.sh` (manuell) und Sicherung vor jedem Pipeline-Deploy auf dem Pi. **Ein Zeitplan für `backup-pull.sh` ist nicht nachgewiesen.**
|
||||
- **Lücke:** `backup:database` sichert **nur die Datenbank**. Medien (`storage/app/public`) und Verträge (`storage/app/private`) werden nur über `backup-pull.sh` bzw. die Pipeline-Sicherung erfasst.
|
||||
- **Betreiberaktionen:** zweite Datenbank anlegen und MariaDB-Restore ausführen (Anleitung in `docs/BETRIEB.md` §7a); Zeitplan für `backup-pull.sh` festlegen.
|
||||
|
||||
### P1-a – Formularfehler
|
||||
- **Maßnahme:** Fehlermeldungen mit `role="alert"`, alle Felder inkl. Datenschutz-Checkbox und Datumsfelder mit `aria-invalid` + `aria-describedby`, Zusammenfassung „Bitte prüfen Sie Ihre Angaben: n Eingaben …“ als `role="alert"`; nach fehlgeschlagenem Absenden springt der Fokus in das erste fehlerhafte Feld (Livewire-Event `form-invalid`).
|
||||
- **Dateien:** `resources/views/livewire/booking-request.blade.php`, `app/Livewire/BookingRequest.php`.
|
||||
- **Tests:** Feature-Test – **PASS**. Browser (Chromium, lokal): nach leerem Absenden Fokus auf „Vorname“, 5 Alerts, 4 `aria-invalid` – **PASS**. Auf stommer.info (alter Stand) zuvor 0/0, also behoben durch die Änderung, **sobald deployt**.
|
||||
|
||||
### P1-b – Rotator
|
||||
- **Maßnahme:** Einfachere Lösung gewählt: Automatischer Wechsel entfernt; Wechsel nur durch Pfeile/Punkte. Damit kein Pausenschalter nötig (WCAG 2.2.2). Reduced-Motion-Logik entfällt für den Rotator, weil keine Bewegung mehr automatisch erfolgt.
|
||||
- **Datei:** `resources/themes/ostsee-licht/theme.js` (auch vom Theme `seebad` geerbt).
|
||||
- **Test:** Code-Änderung; ein Browsertest war nicht möglich, weil in den Testdaten (lokal und stommer.info) **kein Rotator-Abschnitt** ausgespielt wird (`rotator_present = 0`) → **UNKNOWN (Verhalten), Code-Review PASS**.
|
||||
|
||||
### P1-c – Betrieb ohne JavaScript
|
||||
- `<noscript>`-Hinweis mit E-Mail/Telefon aus `config('fewo.owner.*')` im Formular. Feature-Test **PASS**. Ohne-JS-Browserlauf nicht ausgeführt.
|
||||
|
||||
### P1-d – Fehlerseiten
|
||||
- **Maßnahme:** `resources/views/errors/{403,404,419,429,500,503}.blade.php` plus gemeinsame `message.blade.php`; eigenständig (ohne Vite/Theme/Datenbank), deutsch, `lang="de"`, `noindex`, Link zur Startseite, Kontaktdaten aus Konfiguration.
|
||||
- **Tests:** Feature-Test (alle sechs rendern, 404 deutsch) **PASS**; Browser lokal: Titel „Seite nicht gefunden“ **PASS**. Live-Stand (alt): englisches „Not Found“.
|
||||
- **Hinweis:** Fehlerseiten gelten auch für das Admin-Panel bei 403/404/419.
|
||||
|
||||
### P1-e – Sicherheitsbefunde (Finding 10)
|
||||
- **Tokens in URLs:** Aufrufer ermittelt: n8n-Scheduler-Workflow nutzt laut `scripts/n8n-fewo-scheduler.json` bereits **Header-Auth**. Ob ein produktiver Gesundheits-Workflow noch `?token=` nutzt, ist **UNKNOWN** (n8n liegt auf dem Pi, nicht eingesehen). Maßnahme: Schalter `FEWO_ALLOW_QUERY_TOKEN` (Standard **an**, um bestehende Automationen nicht zu unterbrechen); jede `?token=`-Nutzung wird ohne Tokenwert als Warnung geloggt. Header-Token gehen immer. Test **PASS** (an/aus/Header). Docs `DEPLOYMENT.md`/`PORTALE.md` nennen noch `?token=` in Beispielen (nicht geändert).
|
||||
- **Interner Release-Pfad:** Der Redirect `/storage/app/private/backups/` → `/releases/<id>/public/…` entsteht in der `.htaccess`-Slash-Regel (`public/.htaccess`, Apache-Ebene) und im Strato-Rewrite. Er liefert `403`, legt aber die Release-ID offen. Eine sichere Korrektur an `public/.htaccess` (Slash-Regel nur für Verzeichnisse innerhalb von `public`) wurde **nicht** ausgeführt, weil sie ohne Serverprobe das Routing der gesamten Seite stören kann → **IMPROVE, offen**. Privater Zugriffsschutz bleibt wirksam (403/404 geprüft).
|
||||
|
||||
### P1-f – Cookie- und Browserprüfung (echter Chromium/Playwright)
|
||||
Gegen `https://stommer.info` (Seiten `/`, `/wohnung`, `/kuehlungsborn`, `/kontakt`, `/impressum`, `/datenschutz`, `/buchen`; auf `/buchen` Kalendertage gewählt und Formularfeld bedient, **nicht abgesendet**). 126 Requests insgesamt.
|
||||
|
||||
| Prüfpunkt | Ergebnis |
|
||||
|---|---|
|
||||
| Cookies | genau zwei: `XSRF-TOKEN` (Secure, Lax, 120 Min.), `ferienwohnung-stommer-session` (Secure, HttpOnly, Lax, 120 Min.) |
|
||||
| Local Storage / Session Storage | leer |
|
||||
| Requests an Fremddomains | **0** (Schriften, Skripte, Bilder alle von stommer.info) |
|
||||
| Konsolenfehler | keine |
|
||||
| Karten, Tracking, Drittanbieter-Skripte | keine; OpenStreetMap nur als Link |
|
||||
| Tab-Reihenfolge | Sprunglink zuerst; Footer-Link „Datenschutz“ per Tab erreichbar |
|
||||
|
||||
**Befund: ausschließlich unbedingt notwendige Technologien. Kein Cookie-Banner.** Rechtliche Einordnung beim Betreiber.
|
||||
|
||||
### P1-g – Domainwechsel-Vorbereitung
|
||||
- **WordPress-URLs erfasst** (aus `wp-sitemap-posts-page-1.xml` der öffentlichen Seite): `/datenschutzerklaerung/`, `/herzlich-willkommen-im-ostseebad-kuehlungsborn/`, `/ferienwohnung/`, `/about/`, `/contact/`, `/home/`, `/impressum/`, `/intressante-links/`, `/`, `/kuehlungsborn/` sowie sieben Demo-Blogartikel (`/2020/10/18/…`).
|
||||
- **Maßnahme:** 301-Weiterleitungen in `config('fewo.legacy_redirects')` (Zuordnung unten) und Route für datierte Blogartikel → Startseite. Eine eigene veröffentlichte Seite mit gleichem Slug hat Vorrang. Pfade mit Schrägstrich am Ende werden bereits von `public/.htaccess` auf die Form ohne Schrägstrich geleitet.
|
||||
|
||||
| Alt | Neu |
|
||||
|---|---|
|
||||
| `/datenschutzerklaerung` | `/datenschutz` |
|
||||
| `/ferienwohnung` | `/wohnung` |
|
||||
| `/herzlich-willkommen-im-ostseebad-kuehlungsborn` | `/kuehlungsborn` |
|
||||
| `/intressante-links` | `/kuehlungsborn` |
|
||||
| `/about`, `/contact` | `/kontakt` |
|
||||
| `/home` | `/` |
|
||||
| `/impressum`, `/kuehlungsborn`, `/` | unverändert |
|
||||
| `/2020/…/…` (Blog) | `/` |
|
||||
|
||||
Die Zuordnung ist ein Vorschlag; über `/ferienwohnung` → `/wohnung` und die Sammelziele entscheidet der Betreiber. Nicht erfasst: WordPress-Medien unter `/wp-content/uploads/…`, Feeds, Kategorie-/Autorenseiten.
|
||||
- **Test:** `GoLiveComplianceTest::test_former_wordpress_addresses_redirect_permanently` – **PASS**.
|
||||
- **Hauptdomain:** Der Code erwartet **eine** Hauptadresse je Website (`sites.domain`), weitere Adressen leitet die parallel entwickelte Änderung in `ResolveTheme` per 301 dorthin. Empfohlene Hauptdomain: **`https://www.fewo-stommer.de`**, `fewo-stommer.de` (ohne www) als Alias.
|
||||
- **Canonical/Sitemap:** nutzen `url()->current()` bzw. die Hauptadresse der Website – nach Umstellung von `sites.domain` automatisch korrekt (lokal geprüft: Canonical nutzt die erzwungene Wurzel-URL). Echter Abruf nach Umschaltung **UNKNOWN**.
|
||||
- **Noindex:** Auf stommer.info solange `APP_ENV` ≠ `production`. **Achtung:** Beim In-place-Promotion `APP_ENV=production` setzen, sonst bleibt `noindex` auf der Produktivseite; umgekehrt Testsystem **nicht** auf `production`.
|
||||
|
||||
---
|
||||
|
||||
## Mobile Darstellung / Zoom
|
||||
- Chromium, 320 px Breite, Live-Seite stommer.info: Layout-Viewport wird auf 380 px aufgeweitet (Seite erscheint leicht verkleinert), obwohl kein ungeclippter Inhalt breiter als 320 px ist; ein horizontales Scrollen ist nicht möglich (`overflow-x: hidden`). Lokal mit dem **aktuellen** Code (Theme `seebad`): 320 px, kein Überlauf; mit Theme `ostsee-licht`: 329 px. Das Live-Verhalten stammt vermutlich von einem älteren Stand → **nach dem nächsten Deployment erneut prüfen** (UNKNOWN). 200-%-Zoom und echte Geräte nicht geprüft.
|
||||
|
||||
## Tastatur / Screenreader
|
||||
- Per Playwright geprüft: Sprunglink, Menüfolge, Footer-Links, Fokus auf erstes Fehlerfeld. **Nicht** geprüft: vollständige Kalender-Tastaturbedienung, NVDA/VoiceOver (UNKNOWN).
|
||||
|
||||
---
|
||||
|
||||
## Risiken für signierte Links und Kalenderfeeds (Domainwechsel)
|
||||
|
||||
**R1 – behoben am 30.10.2026 (Code, getestet), vor der Umschaltung am Server nachzuprüfen.** Ausnahme `staysOnRequestedAddress` in `ResolveTheme` für `angebot/*`, `bewertung/*`, `angebote/*`, `kalender/*`, `automation/*`, `health/*`; Test `GoLiveComplianceTest::test_signed_links_and_feeds_are_not_redirected_from_a_further_address`. Ursprüngliche Beschreibung:
|
||||
- Laravels `signed`-Prüfung bindet die Signatur an **Schema + Host des Aufrufs** (geprüft in `UrlGenerator::hasCorrectSignature`). Bereits versendete Angebots-, Bewertungs- und Newsletter-Links zeigen auf `https://stommer.info/…`. Solange `stommer.info` die Anwendung **ohne Umleitung** ausliefert, bleiben sie gültig (der Host des Aufrufs bleibt gleich).
|
||||
- Die parallel entwickelte Änderung in `ResolveTheme` (`toMainAddress`) leitet **jeden** Aufruf über eine Nebenadresse per 301 auf die Hauptadresse um. Nach der Umstellung würde `https://stommer.info/angebot/123?signature=…` auf `https://www.fewo-stommer.de/angebot/123?signature=…` geleitet – dort ist die Signatur **ungültig (403)**. Alte Angebotslinks wären tot.
|
||||
- **Erforderliche Gegenmaßnahme (Entscheidung nötig, nicht von mir umgesetzt, weil die Datei in einer parallelen Arbeit steckt):** Die Alias-Weiterleitung muss `angebot/*`, `bewertung/*`, `angebote/*`, `kalender/*` und `automation/*` ausnehmen (diese Pfade weiter unter `stommer.info` ausliefern), **oder** `stommer.info` bleibt dauerhaft als zweite Adresse ohne Weiterleitung für diese Pfade erreichbar. Ablaufdatum der Angebotslinks prüfen: danach kann die Ausnahme entfallen.
|
||||
- Neue Links entstehen nach der Umstellung automatisch mit der neuen Hauptadresse (`sites.domain`/`APP_URL`).
|
||||
|
||||
**R2 – Kalenderfeeds.** Portale rufen `https://stommer.info/kalender/<token>.ics` ab. Die Tokens sind im Pfad und unabhängig vom Host; mit der Ausnahme aus R1 laufen die Feeds weiter. Ohne Ausnahme folgen viele iCal-Clients einer 301, manche nicht → Portal-Kalender würden still veralten. Vorgehen: Feed-URLs bei den Portalen **nicht sofort**, sondern geplant auf die neue Domain umstellen; vorher `/health/sync` und Importzeit (`last_success_at`) im Blick behalten. Ob ein Portal die Kalender-URL manuell umgestellt bekommen muss, ist je Portal **UNKNOWN**; sicher ist die Ausnahme-Variante (alte URL funktioniert weiter).
|
||||
|
||||
**R3 – Sessions/Cookies.** Cookie-Domain wird nicht gesetzt (host-only). Nach dem Wechsel gelten neue Sitzungen; Administratoren müssen sich auf der neuen Domain neu anmelden (2FA bleibt). Offene Reservierungsformulare gehen beim Wechsel verloren.
|
||||
|
||||
**R4 – Automationen.** n8n ruft `https://stommer.info/automation/scheduler` auf. Mit der Ausnahme in R1 weiter gültig; sonst muss die Workflow-URL umgestellt werden (Aufruf kontrolliert, Header-Auth bleibt). Auch `FEWO_AUTOMATION_WEBHOOK_URL` zeigt in die Gegenrichtung (App → n8n) und ist vom Wechsel unberührt.
|
||||
|
||||
**R5 – Konfigurationscache.** `APP_URL` und `sites.domain` ändern; danach `php artisan optimize` (Konfigurations- und Routen-Cache), sonst gilt die alte URL (`docs/BETRIEB.md` §5).
|
||||
|
||||
---
|
||||
|
||||
## In-place-Promotion von stommer.info → www.fewo-stommer.de (Plan, nicht ausgeführt)
|
||||
|
||||
**Vorbedingungen (alle vor der Umschaltung):**
|
||||
1. Betreiberfreigabe; Zeitfenster mit geringem Buchungsgeschehen.
|
||||
2. Entscheidung zu R1 (Ausnahmepfade) umgesetzt, getestet, im Testsystem geprüft.
|
||||
3. Änderungen dieses Auftrags **und** des Buchungsauftrags zusammen getestet; Deployment per Pipeline (develop → Test-Deploy). Vollständige Suite grün.
|
||||
4. MariaDB-Restore-Test erfolgreich (B4), externe Kopie frisch (`backup-pull.sh staging <ziel>`), enthält DB, Fotos, Verträge.
|
||||
5. Kopie von `shared/.env` an geschütztem Ort (Vaultwarden), nicht im Chat.
|
||||
6. Zertifikate für `fewo-stommer.de` und `www.fewo-stommer.de` in Strato verfügbar.
|
||||
7. Liste der Portal-Kalender mit Feed-URLs und Zuständigkeiten (wer stellt um) vorliegend.
|
||||
|
||||
**Ablauf (Schritt für Schritt, jeweils freigeben):**
|
||||
1. Deployment des geprüften Stands auf die bestehende Installation (nur Code; **keine** neuen Migrationen ohne Freigabe – die parallelen Buchungsmigrationen sind **additiv**, aber gesondert zu beurteilen). Danach Smoke-Test auf stommer.info (Startseite, `/buchen`, Admin-Login, `/health/sync` mit Header).
|
||||
2. `shared/.env` anpassen: `APP_ENV=production`, `APP_DEBUG=false`, `APP_URL=https://www.fewo-stommer.de`, `SESSION_SECURE_COOKIE=true`, `LOG_LEVEL=warning`, SMTP unverändert, Testmodus erst nach Freigabe auf „live“.
|
||||
3. In Strato: `www.fewo-stommer.de` und `fewo-stommer.de` dem Deploy-Ordner `test.fewo-stommer.de/` zuordnen (zusätzlich zu `stommer.info`). Altes WordPress-Ziel dabei bewusst ablösen (vorher WordPress-Sicherung durch Betreiber).
|
||||
4. Im Admin die Hauptadresse der Website auf `www.fewo-stommer.de` setzen (Datenänderung an `sites.domain` – freigabepflichtig), `stommer.info` bleibt als weitere Adresse.
|
||||
5. `bash scripts/deploy.sh <env> artisan optimize` (bzw. Pipeline), danach prüfen: Startseite, `curl -I http://www.fewo-stommer.de/` → 301 HTTPS, Canonical, `/sitemap.xml`, `robots.txt` (Produktion: indexierbar), Altadressen-Weiterleitungen, ein alter signierter Angebotslink unter `stommer.info`, ein Feed unter `stommer.info/kalender/…`.
|
||||
6. n8n-Scheduler: Lauf in den nächsten 5 Minuten prüfen (`channels:sync`, `last_success_at`).
|
||||
7. Search Console für die neue Domain einrichten (Betreiber).
|
||||
8. Portal-Kalender-URLs nach Vereinbarung stufenweise umstellen; `stommer.info` als Alias dauerhaft belassen, bis alle Angebotslinks abgelaufen und alle Portale umgestellt sind.
|
||||
|
||||
## Rollback
|
||||
- **Domain:** Zuordnung von `www.fewo-stommer.de` in Strato wieder auf das alte WordPress-Ziel zurücksetzen. Die neue Anwendung bleibt unter `stommer.info` erreichbar; Daten wurden nicht umgezogen, es gibt also **keine Datenrückspielung**.
|
||||
- **Anwendung:** `bash scripts/deploy.sh <env> rollback` bzw. Pipeline-Rückfall (Git-Tag `deploy/<env>/<ts>`); `sites.domain` zurück auf `stommer.info`; `APP_URL` zurück, `optimize`.
|
||||
- **Abhängigkeiten außer der Domain:** (a) nach Wechsel versendete Links zeigen auf die neue Domain und sind nach Rollback tot, daher Mails im Zeitfenster minimieren; (b) bereits umgestellte Portal-Feeds müssen zurückgestellt werden; (c) Suchmaschinen können kurzzeitig neue Adressen kennen. Eine reine Domain-Rückstellung genügt nur, solange kein Portal umgestellt und keine Mail mit neuer Domain versendet wurde.
|
||||
|
||||
---
|
||||
|
||||
## Ausgeführte Tests
|
||||
|
||||
| Test | Ergebnis |
|
||||
|---|---|
|
||||
| `GoLiveComplianceTest` (6 Tests, 38 Assertions): HTTPS-Redirect, Datenschutzlink + `noscript`, Formularfehler/ARIA, Fehlerseiten, WordPress-Weiterleitungen, Query-Token | **PASS** |
|
||||
| Bestehende Tests `BookingRequestPageTest`, `SchedulerEndpointTest` nach Änderung | **PASS** |
|
||||
| Browser-Cookie-/Netzwerkprüfung stommer.info (Playwright/Chromium) | **PASS** |
|
||||
| Browser lokal: Fehlerfokus, ARIA, Datenschutzlink, deutsche 404 | **PASS** |
|
||||
| Restore-Test SQLite (lokal) | **PASS** |
|
||||
| Vollständige Feature-Suite (561 Tests, 556 bestanden) | **FAIL (nicht durch diese Änderungen)**, Details unten |
|
||||
| `vendor/bin/pint --dirty` | **PASS** |
|
||||
| HTTP→HTTPS am echten Server, Mailtest, MariaDB-Restore, Handtest NVDA/Zoom/Geräte, Rotator im Browser | **UNKNOWN / BLOCKED** |
|
||||
|
||||
## Ergebnis der vollständigen Feature-Suite (30.10.2026)
|
||||
561 Tests, 556 bestanden, 3 Fehlschläge, 2 Fehler. Gleichzeitig arbeitet eine zweite Sitzung im selben Arbeitsverzeichnis, daher ist die Suite nicht sauber isolierbar.
|
||||
- `TenantFilesTest` und `WebsiteContentTest` (3 Tests): in einer Wiederholung einzeln **PASS** (13/13). Ursache vermutlich ein zeitgleicher Testlauf der anderen Sitzung auf demselben temporären Testspeicher.
|
||||
- `SeasonManagementTest::test_admin_pages_render`: Klasse `OfferMode` fehlt in `PropertyForm.php` – unfertige Änderung der Buchungsarbeit, **nicht von diesem Auftrag**.
|
||||
- `WebsiteTenancyTest::test_a_website_answers_on_every_address_entered_for_it`: erwartet 200, erhält 301 – direkte Folge der neuen Alias-Host-Weiterleitung in `ResolveTheme` (ebenfalls die parallele Arbeit; Test dort ebenfalls in Bearbeitung). Betrifft das Risiko R1.
|
||||
- Die in diesem Auftrag geänderten Bereiche (Buchungsformular, Planungsseiten, Scheduler-Endpunkt, Weiterleitungen) sind grün. **Eine fehlerfreie Gesamtsuite steht noch aus (Nachtrag: am 30.10.2026 später 561/561 bestanden, mit den Änderungen aller drei Agenten)** und ist nach Abschluss der parallelen Arbeit erneut auszuführen.
|
||||
|
||||
## Noch erforderliche Betreiberaktionen
|
||||
1. Freigabe für Deployment der Änderungen auf die bestehende Installation.
|
||||
2. Entscheidung zur Alias-Weiterleitung (R1) und Hauptdomain `www.fewo-stommer.de`.
|
||||
3. Zweite Strato-Datenbank für Restore-Test und Testsystem anlegen.
|
||||
4. Einwilligung vs. Datenschutzinformation am Formular juristisch klären.
|
||||
5. Bestätigung der Weiterleitungszuordnung (WordPress-Seiten).
|
||||
6. Zeitplan für `backup-pull.sh`; WordPress-Sicherung vor der Ablösung.
|
||||
7. Zuständigkeiten für Portal-Kalender-URLs.
|
||||
8. Strato „SSL erzwingen“ aktivieren (optional, zusätzlich).
|
||||
|
||||
## Abschließende Empfehlung
|
||||
**NO-GO für eine sofortige Umschaltung; GO-fähig**, sobald (1) die Änderungen deployt und auf stommer.info nachgeprüft sind, (2) R1 gelöst ist, (3) der MariaDB-Restore bestanden ist und (4) die Produktions-`.env` laut Plan gesetzt ist. Es sind keine weiteren Architekturänderungen nötig.
|
||||
@@ -0,0 +1,215 @@
|
||||
# MVP-TECHNICAL-GATE – Phase 1 (Read-only-Prüfung) und Umsetzungsstand
|
||||
|
||||
> **Umsetzungsstand 30.10.2026 (Details und Nachweise: [MVP-COMPLIANCE-ACCEPTANCE.md](MVP-COMPLIANCE-ACCEPTANCE.md)).** Die Codeänderungen liegen lokal, nichts ist deployt, auf stommer.info wurde nichts verändert. Die Installation auf stommer.info gilt künftig als Produktion (In-place-Promotion).
|
||||
>
|
||||
> | # | Stufe | Stand |
|
||||
> |---|---|---|
|
||||
> | 1 | BLOCKER HTTPS | Code umgesetzt (`ForceHttps`) und getestet; Wirkung am Server nach Deployment prüfen |
|
||||
> | 2 | BLOCKER Datenschutzlink | umgesetzt, getestet (Test + Browser lokal) |
|
||||
> | 3 | BLOCKER Produktivkonfiguration/Mail | Plan erstellt; Mailtest am echten Formular wegen Produktivdaten **nicht ausgeführt** |
|
||||
> | 4 | BLOCKER Restore | SQLite-Restore bestanden; **MariaDB-Restore offen** (zweite Datenbank nötig) |
|
||||
> | 5 | IMPROVE WordPress-Weiterleitungen | umgesetzt (301-Tabelle), Zuordnung vom Betreiber zu bestätigen |
|
||||
> | 6 | IMPROVE Fehlerseiten | umgesetzt, getestet |
|
||||
> | 7 | IMPROVE Formularfehler | umgesetzt, getestet (Fokus, ARIA) |
|
||||
> | 8 | IMPROVE Rotator | Auto-Wechsel entfernt |
|
||||
> | 9 | IMPROVE ohne JavaScript | `<noscript>`-Hinweis umgesetzt |
|
||||
> | 10 | IMPROVE Token/Release-Pfad | Token-Schalter umgesetzt; Release-Pfad in `.htaccess` offen |
|
||||
>
|
||||
> **Neu entdeckt:** (a) Alias-Host-Weiterleitung der parallelen Arbeit würde nach dem Domainwechsel alte signierte Angebotslinks und ggf. Feeds ungültig machen (R1). (b) Auf stommer.info (aktueller Stand) wird das Layout bei 320 px auf 380 px aufgeweitet (lokal mit aktuellem Code nicht reproduzierbar). (c) Browser-Cookiecheck bestätigt: nur zwei notwendige Cookies, kein Storage, keine Drittanfragen.
|
||||
> **Empfehlung weiterhin NO-GO bis Deployment, MariaDB-Restore, R1 und Produktions-`.env`.**
|
||||
>
|
||||
> *Der folgende Text ist der unveränderte Phase-1-Bericht.*
|
||||
|
||||
Stand: 30.10.2026 · Geprüft: Quellcode (Branch `feature/erinnerungen-zusammenfassung`) und der Testauftritt **https://stommer.info** (Staging, per HTTP-Abruf).
|
||||
Status: **Phase 1 abgeschlossen. Es wurden keine Code-, CMS-, Datenbank- oder Serveränderungen vorgenommen.** Phase 2 beginnt erst nach ausdrücklicher Freigabe des Betreibers.
|
||||
|
||||
**Grenzen der Prüfung (ehrlich vorab):**
|
||||
- Der Testauftritt wurde mit HTTP-Abrufen und Quellcode-Analyse geprüft, **nicht** in einem interaktiven Browser mit DevTools. Cookies, Header und eingebundene Ressourcen sind aus den Antworten belegt. Echte Browser-Laufzeitprüfungen (Local/Session Storage, Tastatur-Durchlauf, Screenreader, Zoom) stehen deshalb als UNKNOWN oder IMPROVE da.
|
||||
- Produktion (`prod.fewo-stommer.de`) ist laut `docs/BETRIEB.md` **noch nicht eingerichtet** (keine `.env`, keine Datenbank). Produktionswerte sind Soll-Werte aus `.env.production.example`, nicht verifiziert.
|
||||
- Rechtstexte und CMS-Inhalte wurden **nicht inhaltlich** geprüft. Nur Erreichbarkeit und sichere Ausgabe.
|
||||
|
||||
## Gesamtbild
|
||||
|
||||
| Bereich | Ergebnis |
|
||||
|---|---|
|
||||
| Cookies / externe Dienste | Nur unbedingt notwendige Cookies, keine Drittanbieter → **kein Banner empfohlen** (Details A) |
|
||||
| Barrierefreiheit | Gute Grundlage, einige kleine Verbesserungen, ein Formular-Link fehlt (B) |
|
||||
| Security | Solide (2FA, Rate-Limits, Tokens, Sperren). Offen: HTTP→HTTPS, Restore-Nachweis, Produktivkonfiguration (C) |
|
||||
| Domainwechsel | Noindex/Canonical technisch richtig; Weiterleitungen und Mailversand noch nicht verifiziert (E) |
|
||||
|
||||
**Vorläufige Empfehlung: NO-GO**, bis die 4 BLOCKER (1–4) behoben und abgenommen sind. Kein BLOCKER erfordert einen Architekturumbau. Zwei sind Konfiguration oder Nachweis ohne Codeänderung.
|
||||
|
||||
---
|
||||
|
||||
## Priorisierte Maßnahmen (max. 10)
|
||||
|
||||
| # | Stufe | Maßnahme | Art |
|
||||
|---|---|---|---|
|
||||
| 1 | BLOCKER | HTTP wird nicht auf HTTPS umgeleitet | Server-Konfiguration |
|
||||
| 2 | BLOCKER | Datenschutzhinweis am Anfrageformular ist kein Link | Code (1 Zeile) |
|
||||
| 3 | BLOCKER | Produktivumgebung nicht eingerichtet und Mailversand nie echt getestet | Konfiguration + Abnahmetest |
|
||||
| 4 | BLOCKER | Backup-Restore nie nachgewiesen | Nachweis, kein Code |
|
||||
| 5 | IMPROVE | Weiterleitung der alten WordPress-URLs beim Domainwechsel | Konfiguration |
|
||||
| 6 | IMPROVE | Fehlerseiten sind englische Laravel-Standardseiten | Code (klein) |
|
||||
| 7 | IMPROVE | Fehlermeldungen im Anfrageformular nicht barrierefrei verknüpft | Code (klein) |
|
||||
| 8 | IMPROVE | Auto-Rotator ohne Pausenschalter (WCAG 2.2.2) | Code (klein) |
|
||||
| 9 | IMPROVE | Formular ohne JavaScript nicht nutzbar, kein Hinweis | Code (klein) |
|
||||
| 10 | IMPROVE | Token auch per URL-Parameter akzeptiert; interner Release-Pfad in Redirect sichtbar | Code (klein) |
|
||||
|
||||
---
|
||||
|
||||
## BLOCKER (Detail)
|
||||
|
||||
### 1. BLOCKER – Keine Weiterleitung von HTTP auf HTTPS
|
||||
- **Problem:** `http://stommer.info/` antwortet mit `200 OK` statt mit einer Weiterleitung. Gäste, die per HTTP einsteigen, erreichen das Formular unverschlüsselt. Session- und XSRF-Cookies sind `secure`, werden über HTTP also nicht angenommen. Das Formular liefe dort in Fehler (419), und Anfragedaten könnten unverschlüsselt übertragen werden. HSTS wird nur über HTTPS ausgeliefert und hilft beim Erstbesuch nicht.
|
||||
- **Komponente:** Server-/Domain-Konfiguration bei Strato, bzw. die vom Deploy-Skript geschriebene `.htaccess` im Deploy-Ordner (`scripts/deploy.sh`, `docs/BETRIEB.md` §2). `public/.htaccess` enthält keine Umleitung.
|
||||
- **Minimale Korrektur:** Bei Strato „HTTPS erzwingen“ für die Domain aktivieren, oder in der Deploy-`.htaccess` `RewriteCond %{HTTPS} !=on` → `RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]` (Strato-Besonderheit: ggf. `%{HTTP:X-Forwarded-Proto}` prüfen).
|
||||
- **Abnahme:** `curl -sI http://<domain>/` und `curl -sI http://<domain>/buchen` liefern `301` mit `Location: https://…`. Gilt für `fewo-stommer.de` **und** `www.fewo-stommer.de`.
|
||||
|
||||
### 2. BLOCKER – Datenschutzhinweis am Anfrageformular ist nicht verlinkt
|
||||
- **Problem:** Im Einwilligungstext steht „(siehe Datenschutzerklärung)“ als reiner Text. Der Link erreicht die Seite nur über den Footer. Die Informationspflicht (Art. 13 DSGVO) verlangt, dass der Hinweis bei der Erhebung leicht auffindbar ist. Das ist technisch ohne Link nicht gegeben, und für Screenreader ist der Footer weit entfernt.
|
||||
- **Komponente:** `resources/views/livewire/booking-request.blade.php` (Checkbox `privacyAccepted`).
|
||||
- **Minimale Korrektur:** „Datenschutzerklärung“ als `<a href="{{ route('page', 'datenschutz') }}" target="_blank" rel="noopener">` setzen (Hinweis „öffnet in neuem Tab“ für Screenreader). Der Text der Einwilligung selbst bleibt unverändert. Das ist reine UI-Technik, keine inhaltliche Änderung.
|
||||
- **Abnahme:** Feature-Test: gerenderte `/buchen`-Seite enthält einen Link auf `/datenschutz` innerhalb des Formulars. Manuell: Tab-Reihenfolge erreicht den Link, Seite lädt, Rückkehr zum Formular behält Eingaben.
|
||||
|
||||
### 3. BLOCKER – Produktivumgebung nicht eingerichtet; Mailzustellung nie echt getestet
|
||||
- **Problem:** Laut `docs/BETRIEB.md` fehlen für Produktion `.env`, Datenbank und Domainzuordnung. Auf Staging gilt `MAIL_MAILER=log`, es wurde also nie eine echte E-Mail zugestellt. Ohne funktionierende Mails (Eingangsbestätigung an Gäste, Benachrichtigung an die Betreiber) ist das Anfrageformular nicht betriebsfähig. Produktions-Härtung (Debug, Logging, Cookies) ist nur als Vorlage belegt.
|
||||
- **Komponente:** `shared/.env` auf dem Server (Vorlage `.env.production.example`), `App\Support\Settings` (Testmodus/Live), `pipeline.toml` (Produktion gesperrt).
|
||||
- **Minimale Korrektur (nur Konfiguration, kein Code):** Produktions-`.env` mit `APP_ENV=production`, `APP_DEBUG=false`, `APP_URL=https://www.fewo-stommer.de`, `LOG_CHANNEL=daily`, `LOG_LEVEL=warning`, `SESSION_SECURE_COOKIE=true`, `MAIL_MAILER=smtp`, eigene Datenbank, lange zufällige `FEWO_HEALTH_TOKEN`, `FEWO_SCHEDULER_TOKEN`, `FEWO_AUTOMATION_SECRET`. Admin-Konten mit `users:create`, 2FA einrichten. Mail zunächst im Testmodus (Empfänger = Betreiber), erst danach „Live“.
|
||||
- **Abnahme:**
|
||||
1. `php artisan config:show app.debug` → `false`, `app.env` → `production`.
|
||||
2. Test-Anfrage über das Formular → Gäste-Bestätigung **und** Betreiber-Benachrichtigung kommen real an (Testadresse), SPF/DKIM-Header unauffällig (nicht als Spam).
|
||||
3. Ein erzeugter Fehler (z. B. `/nichtda`) zeigt keinen Stacktrace.
|
||||
4. `<meta name="robots" content="noindex">` ist auf Produktion **nicht** mehr vorhanden, `robots.txt` enthält die Produktions-Sitemap.
|
||||
5. Scheduler läuft (n8n oder Cron): `channels:sync` und `backup:database` erscheinen im Log.
|
||||
|
||||
### 4. BLOCKER – Backup-Restore nicht nachgewiesen
|
||||
- **Problem:** `backup:database` läuft täglich und behält 14 Dateien. Ein Wiederherstellungstest ist in `docs/BETRIEB.md` und `docs/LOESCHKONZEPT.md` nirgends belegt („❓ nicht belegt“). Die Sicherung liegt auf demselben Webspace; die Kopie außerhalb (`scripts/backup-pull.sh`, Pipeline-Sicherung auf dem Pi) ist manuell bzw. an Deployments gekoppelt. Der Dump überspringt bewusst `sessions`, `cache`, `jobs`.
|
||||
- **Komponente:** `app/Console/Commands/BackupDatabase.php`, `scripts/backup-pull.sh`, `docs/BETRIEB.md` §7a.
|
||||
- **Minimale Korrektur:** Kein Code. Einmaliger Restore-Test: aktuellen Dump auf eine **leere Test-Datenbank** einspielen (nicht in Produktion), Ergebnis mit Datum in `docs/BETRIEB.md` festhalten. Außerdem festlegen, wie oft `backup-pull.sh` läuft (mind. wöchentlich) und wo die Kopie liegt.
|
||||
- **Abnahme:** Nach dem Einspielen `php artisan migrate:status` ohne Fehler, Zeilenzahlen von `bookings`, `guests`, `pages` stimmen mit dem Original überein, Admin-Login mit der wiederhergestellten Datenbank funktioniert. Wichtig: Dump enthält Gästedaten, daher nur verschlüsselt/zugriffsgeschützt ablegen.
|
||||
|
||||
---
|
||||
|
||||
## A. Cookies und externe Dienste
|
||||
|
||||
**Methode:** Antwort-Header und gerenderte HTML-/CSS-Dateien der Startseite, `/buchen`, `/impressum`, `/datenschutz`, `/admin/login`; Suche im Quellcode nach `localStorage`, `sessionStorage`, `document.cookie`, Analytics, Karten-Einbettungen, `iframe`.
|
||||
**Nicht erfolgt:** Beobachtung im Browser-Netzwerk-Tab.
|
||||
|
||||
| Technologie | Zweck | Anbieter | Speicherdauer | Technisch erforderlich? | Einwilligung? |
|
||||
|---|---|---|---|---|---|
|
||||
| `ferienwohnung-stommer-session` (Cookie, HttpOnly, Secure, SameSite=Lax) | Sitzung des Buchungsformulars (Livewire), Spam-Zeitsperre | Eigene Domain | 120 Min. (`Max-Age=7200`) | Ja, Formularbetrieb | Nein, wenn nur dafür genutzt (Einordnung durch Betreiber) |
|
||||
| `XSRF-TOKEN` (Cookie, Secure, SameSite=Lax) | CSRF-Schutz des Formulars | Eigene Domain | 120 Min. | Ja | Nein |
|
||||
| Livewire-Skript, Theme-JS/CSS | Funktion der Seite | Eigene Domain (`/build`, `/livewire-…`) | – | Ja | Nein |
|
||||
| Schriften (Atkinson Hyperlegible, Cormorant Garamond) | Darstellung | **Selbst gehostet** (`/build/assets/*.woff2`) | – | – | Nein, keine Verbindung zu Drittanbietern |
|
||||
| Bilder (`/storage/…`) | Inhalt | Eigene Domain | – | – | Nein |
|
||||
| OpenStreetMap | Nur ein **Link** („Karte öffnen“), keine Einbettung | OSM Foundation | – | – | Nein, Verbindung erst nach Klick des Gastes |
|
||||
| Local/Session Storage | Im Quellcode der Webseite **nicht verwendet** (keine Treffer). Nur Filament-Admin nutzt Browser-Speicher intern. | – | – | – | Nein |
|
||||
| Tracking, Analytics, Werbung, Social-Widgets, Maps-iframes, Captcha | **Keine gefunden** (Bot-Schutz läuft ohne externen Dienst) | – | – | – | – |
|
||||
|
||||
- **PASS – Keine Drittanbieter-Verbindungen** im ausgelieferten HTML/CSS von Start- und Buchungsseite. Das einzige fremde Ziel ist der OSM-Link.
|
||||
- **PASS – Kein STRATO-spezifischer Skript-/Cookie-Zusatz** im HTML (keine Fremdskripte, keine Zusatz-Cookies). Der Server sendet nur die zwei Laravel-Cookies.
|
||||
- **Empfehlung: Kein Cookie-Banner.** Es werden ausschließlich notwendige Technologien eingesetzt. Hinweis für den Betreiber: Die Cookies werden schon beim ersten Seitenaufruf gesetzt (auch ohne Formular), weil Laravel die Sitzung global startet. Die rechtliche Einordnung („unbedingt erforderlich“) und die Erwähnung in der Datenschutzerklärung liegen beim Betreiber. Technisch ließe sich das später auf `/buchen` beschränken (kein MVP-Thema).
|
||||
- **UNKNOWN:** Browser-Gegenprobe (DevTools › Application/Network) auf Staging; zusätzlich das Cookie-Verhalten, sobald Produktions-Domain und Strato-Einstellungen live sind. 5-Minuten-Check vor Go-live.
|
||||
|
||||
---
|
||||
|
||||
## B. Technische Barrierefreiheit (WCAG 2.2 als Qualitätsmaßstab)
|
||||
|
||||
**Rechtliche Einordnung (Betreiber):** Ob die Kleinstunternehmensausnahme nach § 3 Abs. 3 BFSG greift, entscheidet der Betreiber. Unabhängig davon ist die Grundlage technisch gut. Hier nur technische Empfehlungen, keine gesetzliche Anforderung bestätigt.
|
||||
|
||||
**PASS (aus Quellcode und HTML belegt):**
|
||||
- Sprunglink „Zum Inhalt springen“, `lang="de"`, Landmarks (`header`, `nav` mit `aria-label`, `main#inhalt`, `footer`).
|
||||
- Sichtbarer Fokus global: `:focus-visible { outline: 2px solid var(--accent) }` (`theme-base.css`).
|
||||
- Viewport ohne Zoomsperre (`width=device-width, initial-scale=1`), keine `maximum-scale`/`user-scalable`.
|
||||
- Alle Formularfelder haben sichtbare `<label>`, Pflichtfelder `required`, `autocomplete`-Attribute (WCAG 1.3.5).
|
||||
- Kalender: echte Tabelle mit `<th scope="col">`, jeder Tag ein `<button>` mit vollständigem Datum und „(Nacht belegt)“ im `aria-label`, `aria-pressed`. Belegt ist nicht nur Farbe (durchgestrichen + Text).
|
||||
- Vergangene Tage `disabled`; Preisbereich `aria-live="polite"`; Erfolgsmeldung `role="status"`.
|
||||
- Lightbox als natives `<dialog>` (Escape, Fokusrückgabe nativ); Buttons mit `aria-label`.
|
||||
- `prefers-reduced-motion` wird berücksichtigt (CSS und Rotator).
|
||||
- Dekorative Grafiken (Wellen-Trenner) `aria-hidden`. Mobile Menü ohne JavaScript über `<details>`.
|
||||
- Standard-Token-Kontraste rechnerisch ausreichend (z. B. Text `#4E5C66` auf `#F6F2EA` ≈ 6:1, Akzent `#2C5F7C` auf Weiß ≈ 7:1).
|
||||
|
||||
**IMPROVE (nicht Go-live-kritisch, kleine Änderungen):**
|
||||
- **#7 Formularfehler:** Fehlermeldungen der Textfelder sind per `aria-describedby` verknüpft, aber nicht als `role="alert"`; Fehler der Einwilligungs-Checkbox (`privacyAccepted`) haben weder `aria-invalid` noch Verknüpfung; kein Sprung zum ersten Fehler (das Formular nutzt `novalidate`). Folge: Screenreader-Nutzer bemerken ein abgelehntes Absenden nicht (WCAG 3.3.1, 4.1.3). Korrektur: `role="alert"` bzw. Fokus auf erstes Fehlerfeld, Checkbox mit `aria-describedby`.
|
||||
- **#8 Auto-Rotator** (Sonderangebote, wechselt alle 7 s): pausiert bei Hover/Fokus, hat aber keinen sichtbaren Pausenschalter (WCAG 2.2.2, > 5 s). Korrektur: Pause-Button oder Auto-Wechsel nur ohne Interaktion deaktivieren. Alternativ komplett ohne Auto-Wechsel.
|
||||
- **Mehrere `<h1>`** auf den Rechtstexten: Die Seite rendert die Überschrift des Abschnitts als `<h1>` und die im CMS-Text enthaltene Überschrift ebenfalls. Das ist eine Inhaltsfrage (CMS-Text), kein Fehler der Vorlage. Hinweis an Betreiber: Überschriften im Text als H2/H3 anlegen.
|
||||
- **UNKNOWN:** Tastatur-Durchlauf von Menü, Kalender (Pfeiltasten nicht implementiert, Tab durch alle Tage = ca. 60 Stopps), Zoom 200 %/Reflow 320 px, Screenreader-Test (NVDA/VoiceOver), Kontraste der **Saison-Erscheinungsbilder** (z. B. `herbst` überschreibt Farb-Token), `Kalender-Target-Size` (WCAG 2.5.8). Empfohlen: 30-Minuten-Handtest mit Tastatur und NVDA vor Go-live.
|
||||
|
||||
---
|
||||
|
||||
## C. Security und Datenschutztechnik
|
||||
|
||||
| Prüfpunkt | Stufe | Befund |
|
||||
|---|---|---|
|
||||
| HTTPS / HSTS | **BLOCKER** (#1) | HTTPS aktiv, HSTS `max-age=31536000` gesetzt, aber keine HTTP→HTTPS-Weiterleitung |
|
||||
| Sicherheits-Header | PASS | `X-Content-Type-Options`, `X-Frame-Options: SAMEORIGIN`, `Referrer-Policy`, `Permissions-Policy` (`SecurityHeaders`). Kein CSP (bewusst, Livewire/Filament inline; `IMPROVE`, nicht MVP) |
|
||||
| Debug-Modus (Produktion) | **UNKNOWN** (#3) | Vorlage `APP_DEBUG=false`. Staging liefert auf `/nichtda` nur die Standard-404, keine Debug-Seite. Produktion nicht verifizierbar |
|
||||
| Logging | PASS (Vorlage) | `LOG_CHANNEL=daily`, `LOG_LEVEL=warning`, 14 Tage. Nicht live verifiziert |
|
||||
| Session / Cookies | PASS | `HttpOnly`, `Secure`, `SameSite=Lax`, DB-Sessions, 120 Min. |
|
||||
| CSRF | PASS | Laravel `PreventRequestForgery` aktiv. Ausnahmen nur für `/automation/portal-mail` und `/automation/aufgaben/…`, beide mit HMAC-Signatur (`hash_equals`, leeres Secret → 403) |
|
||||
| Admin-Zugang | PASS | `/admin/login` erreichbar (erwartet); 2FA (TOTP) mit Wiederherstellungscodes für jedes Konto verpflichtend; Konten nur über `users:create`; Rollen/Policies |
|
||||
| Vertrauliche Dateien | PASS | `/.env` → 403, `/composer.json` → 404, `/releases/` → 403, `/storage/app/private/…` nicht erreichbar, nur `storage/app/public` ist verlinkt. Backups und Verträge liegen privat |
|
||||
| Technische Tokens | PASS | Health (`/health/sync`), Scheduler und Portal-Mail: ohne Token 404/403; Vergleich mit `hash_equals`; leere Konfig = gesperrt; Rate-Limit 10–60/min. Hinweis: `?token=` wird übergangsweise noch akzeptiert → IMPROVE #10. iCal-Feeds nur mit zufälligem `export_token`, Token-Rotation vorhanden |
|
||||
| Eingabevalidierung / Spam | PASS | Serverseitige Regeln, Honeypot, Zeitsperre 4 s, 5/Std je IP, 3/Tag je E-Mail, 30/Std gesamt, max. 2 offene Anfragen je E-Mail, Link-Limit; signierte URLs (`signed`) + Throttle für Angebot, Bewertung, Newsletter |
|
||||
| Ausgabe von CMS-Inhalten | PASS | Texte werden mit `{{ }}` escaped; Rich-Text läuft über Filament `RichContentRenderer` (bereinigt). Die wenigen `{!! !!}`-Stellen geben Theme-eigene Motive, `json_encode` mit `JSON_HEX_TAG` oder escaped Titel aus |
|
||||
| Datenlöschung bei erfolglosen Anfragen | PASS (technisch) | `guests:anonymize` täglich 03:00: nie bestätigte Anfragen nach 6 Monaten (`FEWO_RETENTION_INQUIRY_MONTHS`) anonymisiert, Portal-Mailauszüge 90 Tage, UTM 24 Monate. Frist **rechtlich** bestätigen lässt der Betreiber (`docs/LOESCHKONZEPT.md`). Offene Lücken laut Löschkonzept (Bewertungen, Vertragsdokumente, `internal_notes`) sind nicht Teil des MVP-Pfads → IMPROVE |
|
||||
| Backup | **BLOCKER** (#4) | Erstellung vorhanden, Restore nicht nachgewiesen |
|
||||
| Gästedaten in Versandwegen | PASS | Testmodus-Schalter leitet alle Mails an Testadresse; `FEWO_MAIL_REDIRECT_TO` als harte Sperre |
|
||||
| Produktivkonfiguration | **BLOCKER** (#3) | Nicht eingerichtet |
|
||||
|
||||
---
|
||||
|
||||
## D. CMS und technische Informationspflichten
|
||||
|
||||
| Prüfpunkt | Stufe | Befund |
|
||||
|---|---|---|
|
||||
| Impressum und Datenschutz erreichbar | PASS | `/impressum` und `/datenschutz` liefern `200`, mit `<h1>` und Titel (Inhalt nicht bewertet) |
|
||||
| Links auf jeder öffentlichen Seite | PASS | Footer-Navigation `aria-label="Rechtliches"` ist Teil des gemeinsamen Layouts; gerendert aus dem Menü „footer“. Hinweis: Wird das Menü im CMS geleert, verschwinden die Links. Betreiber-Hinweis, kein Code-Befund |
|
||||
| Mobil | PASS (Code) / UNKNOWN (Gerät) | Footer-Links sind nicht ausgeblendet; die mobile feste Buchungsleiste (`z-30`) verdeckt keine Footer-Links dank 5-rem-Abstandhalter. Echtgerätetest offen |
|
||||
| Datenschutzhinweis am Formular | **BLOCKER** (#2) | Nur Text, kein Link |
|
||||
| Ohne JavaScript | IMPROVE (#9) | Seiten, Navigation, Legal-Links, Kontaktdaten (`mailto:`/`tel:`) funktionieren ohne JS. Das **Anfrageformular und der Kalender sind vollständig Livewire** und ohne JS nicht nutzbar, es gibt keinen `<noscript>`-Hinweis. Praktikable Korrektur: `<noscript>` mit Telefon/E-Mail der Betreiber. Eine Neuimplementierung als klassisches Formular ist für den MVP nicht angemessen |
|
||||
| Sichere Ausgabe | PASS | siehe C |
|
||||
|
||||
---
|
||||
|
||||
## E. Funktionsfähigkeit und Domainwechsel
|
||||
|
||||
| Prüfpunkt | Stufe | Befund |
|
||||
|---|---|---|
|
||||
| Anfrageformular (Logik) | PASS (Code/Tests) | Validierung, Preisberechnung, Bot-Schutz, Hold-Mechanik vorhanden; Pipeline führt die Feature-Suite vor jedem Deploy aus (laut `docs/STATUS.md` grün) |
|
||||
| E-Mail-Zustellung | **BLOCKER** (#3) | Staging `MAIL_MAILER=log`, nie real zugestellt |
|
||||
| Kalender / iCal-Sync | PASS (Staging) | Automatischer Import alle 5 Min. per n8n laut `docs/STATUS.md` nachgewiesen (zuletzt 28./29.10.2026); Feed-Token-Schutz geprüft; Portal-Verbindung 5 ist bewusst auf „Import aus“. **UNKNOWN:** Live-Schaltung der Kanäle auf Produktion; Fremd-Feeds ohne `DTSTAMP` sind abgedeckt |
|
||||
| Fehlerseiten | IMPROVE (#6) | 404 ist die englische Laravel-Standardseite (`lang="en"`, „Not Found“). Es gibt keine `resources/views/errors/`. Gäste sehen auf einer deutschen Seite englischen Text ohne Navigation. Korrektur: `404`, `419`, `429`, `500`, `503` als schlichte deutsche Seiten mit Link zur Startseite |
|
||||
| Canonical | PASS | `<link rel="canonical">` auf die aktuelle URL, mit `URL::forceRootUrl(APP_URL)` also immer auf der Hauptdomain |
|
||||
| Indexierung des Testauftritts | PASS | `<meta name="robots" content="noindex">` auf Staging (alles außer `APP_ENV=production`); `robots.txt` sperrt Admin, Livewire, Automation, Angebote |
|
||||
| Doppelte Hosts auf Staging | IMPROVE | `www.stommer.info` und `stommer.info` liefern beide `200`. Auf Produktion eine Variante festlegen und die andere mit `301` umleiten (sonst zwei erreichbare Hosts). Canonical verhindert Dubletten nur teilweise |
|
||||
| Weiterleitungen alter URLs (#5) | IMPROVE | `www.fewo-stommer.de` ist heute noch WordPress (`200`). Beim Umschalten fallen alte WordPress-URLs auf `404`. Vor dem Wechsel Liste der bekannten alten Adressen sammeln und per `.htaccess` `301` auf die neuen Seiten umleiten |
|
||||
| Interner Pfad in Redirect (#10) | IMPROVE | Ein Pfad mit Slash am Ende (`/storage/app/private/backups/`) wird per `301` auf `/releases/<id>/public/…` umgeleitet und endet in `403`. Es werden nur Release-ID und Ordnerstruktur offengelegt, kein Inhalt. Beheben, wenn sich in `public/.htaccess` ohnehin etwas ändert |
|
||||
| Sitemap | PASS | `/sitemap.xml` `200`, enthält nur veröffentlichte Seiten |
|
||||
| Produktionskonfiguration | **BLOCKER** (#3) | siehe oben |
|
||||
|
||||
---
|
||||
|
||||
## Trennung: gesetzlich relevant vs. technische Empfehlung
|
||||
|
||||
**Gesetzlich relevante Anforderungen (Betreiber/Recht bewertet, technische Umsetzung hier):**
|
||||
- Verschlüsselte Übertragung personenbezogener Daten (Art. 32 DSGVO) → BLOCKER #1
|
||||
- Datenschutzinformation bei der Datenerhebung erreichbar (Art. 13 DSGVO) → BLOCKER #2
|
||||
- Impressum/Datenschutz leicht erreichbar (DDG § 5) → PASS (technisch)
|
||||
- Notwendigkeit einer Einwilligung für Cookies (§ 25 TDDDG) → nach Befund keine Einwilligung nötig, Einordnung beim Betreiber
|
||||
- Wiederherstellbarkeit / Verfügbarkeit (Art. 32 DSGVO) → BLOCKER #4
|
||||
- Barrierefreiheit (BFSG): Anwendbarkeit/Kleinstunternehmensausnahme entscheidet der Betreiber
|
||||
|
||||
**Technische Empfehlungen (keine gesetzliche Pflicht festgestellt):** BLOCKER #3 (Betriebsfähigkeit), alle IMPROVE-Punkte, CSP, Weiterleitungen, Fehlerseiten.
|
||||
|
||||
---
|
||||
|
||||
## Vorgeschlagener Umfang für Phase 2 (nach Freigabe)
|
||||
|
||||
1. **Code (klein):** Datenschutz-Link am Formular (#2). Optional zugleich #6 (deutsche Fehlerseiten), #7 (Formularfehler barrierefrei) und #9 (`<noscript>`), wenn gewünscht.
|
||||
2. **Konfiguration (durch Betreiber/Technik, Freigabe nötig):** HTTPS-Weiterleitung (#1), Produktions-`.env`, SMTP, Datenbank, Domainzuordnung (#3).
|
||||
3. **Nachweis:** Restore-Test in Wegwerf-Datenbank (#4), Test-Anfrage inkl. Mailempfang, 5-Minuten-Browser-Cookiecheck, Handtest Tastatur/NVDA.
|
||||
4. **Phase 3:** Feature-Tests für Datenschutz-Link und Fehlerseiten, vollständige Suite, `vendor/bin/pint --dirty`, danach GO/NO-GO.
|
||||
|
||||
**Keine Änderungen, Migrationen, CMS-Anpassungen oder Deployments erfolgen ohne ausdrückliche Freigabe.**
|
||||
@@ -4,8 +4,11 @@
|
||||
|
||||
use App\Availability\AvailabilityChecker;
|
||||
use App\Availability\CalendarClearance;
|
||||
use App\Documents\DocumentComposer;
|
||||
use App\Documents\DocumentFinding;
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\OfferMode;
|
||||
use App\Enums\DocumentKind;
|
||||
use App\Enums\ProcessingMode;
|
||||
use App\Exceptions\ReservationException;
|
||||
use App\Models\Booking;
|
||||
use App\Pricing\QuoteException;
|
||||
@@ -18,7 +21,8 @@
|
||||
*
|
||||
* Rules: pre-reservation active (the dates are really blocked), guest e-mail known, dates still free, contract
|
||||
* texts released by the landlord (not the sample text; skipped while mails only go to the test recipient),
|
||||
* and the calendar clearance of {@see CalendarClearance} (fresh imports, instant-booking portals fetched our feed).
|
||||
* the calendar clearance of {@see CalendarClearance} (fresh imports, instant-booking portals fetched our feed) and an
|
||||
* offer composition without anything to confirm ({@see DocumentComposer}: template released, contract data complete).
|
||||
*/
|
||||
class AutoOffer
|
||||
{
|
||||
@@ -30,7 +34,7 @@ public function __construct(
|
||||
|
||||
public function applies(Booking $booking): bool
|
||||
{
|
||||
return $booking->property->offer_mode === OfferMode::Automatic;
|
||||
return $booking->processingMode() === ProcessingMode::Automatic;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -41,8 +45,8 @@ public function blockers(Booking $booking): array
|
||||
$property = $booking->property;
|
||||
$reasons = [];
|
||||
|
||||
if (! $property->pre_reservation_enabled) {
|
||||
$reasons[] = 'Die Vorreservierung ist für diese Wohnung ausgeschaltet; ohne Sperre im Kalender wird kein Angebot automatisch erteilt.';
|
||||
if (! $booking->process()->preReservation()) {
|
||||
$reasons[] = 'Anfragen reservieren den Zeitraum nicht (Einstellung „Vorreservierung“); ohne Sperre im Kalender wird kein Angebot automatisch erteilt.';
|
||||
}
|
||||
if ($booking->status !== BookingStatus::Reserved || ! $booking->isHoldActive()) {
|
||||
$reasons[] = 'Die Anfrage ist nicht mehr vorgemerkt (Frist abgelaufen oder bereits bearbeitet).';
|
||||
@@ -57,6 +61,9 @@ public function blockers(Booking $booking): array
|
||||
$reasons[] = 'Mietbedingungen, Stornobedingungen oder Bankverbindung sind noch nicht vom Betreiber freigegeben (leer oder Mustertext).';
|
||||
}
|
||||
|
||||
// Status, e-mail, dates and the missing reservation are checked above; the composition adds what concerns the document.
|
||||
$reasons = [...$reasons, ...app(DocumentComposer::class)->compose($booking, DocumentKind::Offer)->toConfirm(except: [DocumentFinding::HOLD_ZERO])];
|
||||
|
||||
return [...$reasons, ...$this->clearance->reasons($property, $booking->created_at)];
|
||||
}
|
||||
|
||||
@@ -69,7 +76,7 @@ public function handle(Booking $booking): array
|
||||
{
|
||||
$booking->loadMissing(['property', 'guest']);
|
||||
|
||||
if ($booking->property->pre_reservation_enabled) {
|
||||
if ($booking->process()->preReservation()) {
|
||||
$this->clearance->refresh($booking->property);
|
||||
}
|
||||
|
||||
@@ -79,7 +86,7 @@ public function handle(Booking $booking): array
|
||||
}
|
||||
|
||||
try {
|
||||
$this->sendOffer->handle($booking->fresh());
|
||||
$this->sendOffer->handle($booking->fresh(), ['expected_version' => 0]);
|
||||
} catch (QuoteException|ReservationException $exception) {
|
||||
// A mail failure keeps the saved offer (SendOffer reports it in the inbox); the landlord can resend the link.
|
||||
return [$exception->getMessage()];
|
||||
|
||||
@@ -30,13 +30,13 @@ class CancelBooking
|
||||
*
|
||||
* @throws ReservationException
|
||||
*/
|
||||
public function handle(Booking $booking, bool $notifyGuest = true, bool $costsTask = true, string $by = 'Verwaltung'): bool
|
||||
public function handle(Booking $booking, bool $notifyGuest = true, bool $costsTask = true, string $by = 'Verwaltung', string $initiatedBy = 'landlord'): bool
|
||||
{
|
||||
if ($notifyGuest && blank($booking->guest?->email)) {
|
||||
throw new ReservationException('Der Gast hat keine E-Mail-Adresse – bitte ohne Mail an den Gast stornieren oder die Adresse ergänzen.');
|
||||
}
|
||||
|
||||
DB::transaction(function () use ($booking, $costsTask, $by): void {
|
||||
DB::transaction(function () use ($booking, $costsTask, $by, $initiatedBy): void {
|
||||
$booking->lockForTransition();
|
||||
|
||||
if (! in_array($booking->status, BookingStatus::occupying(), true)) {
|
||||
@@ -44,7 +44,16 @@ public function handle(Booking $booking, bool $notifyGuest = true, bool $costsTa
|
||||
}
|
||||
|
||||
$booking->update(['status' => BookingStatus::Cancelled, 'cancelled_at' => now()]);
|
||||
app(RecordCancellation::class)->handle($booking, 'landlord');
|
||||
app(RecordCancellation::class)->handle($booking, $initiatedBy);
|
||||
|
||||
if ($booking->caseType()->isExternallyBinding()) {
|
||||
// The contract was made on the portal: the cancellation has to happen (or be checked) there as well.
|
||||
BookingTask::query()->firstOrCreate(['booking_id' => $booking->id, 'kind' => BookingTaskKind::PortalCancellation], [
|
||||
'status' => BookingTaskStatus::Open,
|
||||
'due_on' => today(),
|
||||
'note' => 'Stornierung auch im Portal „'.($booking->processChannel()?->name ?? 'Portal').'“ veranlassen bzw. prüfen, ob sie dort wirksam ist.',
|
||||
]);
|
||||
}
|
||||
|
||||
BookingTask::query()->where('booking_id', $booking->id)->where('kind', BookingTaskKind::CancellationRequest)->where('status', BookingTaskStatus::Open)
|
||||
->update(['status' => BookingTaskStatus::Done, 'completed_by' => $by, 'completed_at' => now()]);
|
||||
|
||||
@@ -6,11 +6,14 @@
|
||||
use App\Documents\OfferTerms;
|
||||
use App\Documents\RentalContract;
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\DocumentKind;
|
||||
use App\Enums\InboxMessageKind;
|
||||
use App\Exceptions\ReservationException;
|
||||
use App\Filament\Resources\Bookings\BookingResource;
|
||||
use App\Mail\BookingConfirmed;
|
||||
use App\Mail\BookingDocumentation;
|
||||
use App\Models\Booking;
|
||||
use App\Process\CaseLog;
|
||||
use App\Support\Inbox;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Log;
|
||||
@@ -84,25 +87,35 @@ public function bind(Booking $booking): void
|
||||
*
|
||||
* @return bool whether the guest has the confirmation (true when no mail was requested)
|
||||
*/
|
||||
public function deliver(Booking $booking, bool $notifyGuest = true): bool
|
||||
public function deliver(Booking $booking, bool $notifyGuest = true, ?DocumentKind $kind = null): bool
|
||||
{
|
||||
$booking->loadMissing(['guest', 'property']);
|
||||
$kind ??= DocumentKind::forCase($booking) ?? DocumentKind::Confirmation;
|
||||
|
||||
try {
|
||||
$this->contract->generate($booking);
|
||||
$created = $booking->contract_path === null;
|
||||
$this->contract->generate($booking, kind: $kind);
|
||||
if ($created) {
|
||||
CaseLog::record($booking, 'document', $kind->getLabel().' erstellt'.(isset($booking->offer_terms['template']['name']) ? ' (Vorlage '.$booking->offer_terms['template']['name'].', Version '.$booking->offer_terms['template']['version'].')' : ' (Texte der Webseite)'), data: [
|
||||
'kind' => $kind->value,
|
||||
'template' => $booking->offer_terms['template'] ?? null,
|
||||
'annexes' => array_map(fn (array $annex): string => $annex['name'].' (Version '.$annex['version'].')', (array) ($booking->offer_terms['annexes'] ?? [])),
|
||||
'pdf_sha256' => $booking->contract_pdf_sha256,
|
||||
]);
|
||||
}
|
||||
|
||||
if (! $notifyGuest) {
|
||||
return true;
|
||||
}
|
||||
|
||||
Mail::to($booking->guest->email, $booking->guest->full_name)->send(new BookingConfirmed($booking));
|
||||
$booking->forceFill(['confirmation_sent_at' => now(), 'confirmation_failed_at' => null])->saveQuietly();
|
||||
Mail::to($booking->guest->email, $booking->guest->full_name)->send($kind === DocumentKind::ExternalRecord ? new BookingDocumentation($booking) : new BookingConfirmed($booking));
|
||||
$booking->forceFill(['confirmation_sent_at' => now(), 'confirmation_failed_at' => null])->save();
|
||||
|
||||
return true;
|
||||
} catch (Throwable $exception) {
|
||||
// Only class and booking id are logged: mail errors can contain the recipient's address.
|
||||
Log::warning('Buchungsbestätigung nicht zugestellt', ['booking' => $booking->id, 'exception' => $exception::class]);
|
||||
$booking->forceFill(['confirmation_failed_at' => now()])->saveQuietly();
|
||||
$booking->forceFill(['confirmation_failed_at' => now()])->save();
|
||||
$this->inbox->post(
|
||||
InboxMessageKind::ConfirmationFailed,
|
||||
'booking-'.$booking->id,
|
||||
|
||||
@@ -4,15 +4,18 @@
|
||||
|
||||
use App\Availability\AvailabilityChecker;
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Exceptions\ReservationException;
|
||||
use App\Mail\NewReservation;
|
||||
use App\Mail\ReservationReceived;
|
||||
use App\Models\Booking;
|
||||
use App\Models\Channel;
|
||||
use App\Models\Guest;
|
||||
use App\Models\Property;
|
||||
use App\Pricing\PriceCalculator;
|
||||
use App\Pricing\QuoteException;
|
||||
use App\Pricing\StayRequest;
|
||||
use App\Process\ProcessSettings;
|
||||
use App\Support\Settings;
|
||||
use App\Tenancy\TenantContext;
|
||||
use App\Tenancy\TenantContextMissing;
|
||||
@@ -23,7 +26,7 @@
|
||||
use Throwable;
|
||||
|
||||
/**
|
||||
* Turns a guest request into a reservation that holds the dates for the property's hold time,
|
||||
* Turns a guest request into a case (intake "request") that holds the dates for the hold time of the process settings,
|
||||
* and sends the quote to the guest and a notification to the landlord.
|
||||
*/
|
||||
class CreateReservation
|
||||
@@ -40,7 +43,7 @@ public function __construct(
|
||||
* @throws QuoteException
|
||||
* @throws ReservationException
|
||||
*/
|
||||
public function handle(Property $property, StayRequest $stay, array $guestData, ?string $message = null, string $source = 'website', bool $sendMails = true, array $attribution = []): Booking
|
||||
public function handle(Property $property, StayRequest $stay, array $guestData, ?string $message = null, string $source = 'website', bool $sendMails = true, array $attribution = [], ?Channel $originChannel = null): Booking
|
||||
{
|
||||
$tenant = $property->tenant;
|
||||
|
||||
@@ -50,7 +53,7 @@ public function handle(Property $property, StayRequest $stay, array $guestData,
|
||||
|
||||
return app(TenantContext::class)->run(
|
||||
$tenant,
|
||||
fn (): Booking => $this->create($property, $stay, $guestData, $message, $source, $sendMails, $attribution),
|
||||
fn (): Booking => $this->create($property, $stay, $guestData, $message, $source, $sendMails, $attribution, $originChannel),
|
||||
);
|
||||
}
|
||||
|
||||
@@ -58,9 +61,13 @@ public function handle(Property $property, StayRequest $stay, array $guestData,
|
||||
* @param array{first_name: string, last_name: string, email: string, phone?: ?string, street?: ?string, postal_code?: ?string, city?: ?string, country?: ?string} $guestData
|
||||
* @param array{referral_source?: ?string, utm_source?: ?string, utm_medium?: ?string, utm_campaign?: ?string} $attribution
|
||||
*/
|
||||
private function create(Property $property, StayRequest $stay, array $guestData, ?string $message, string $source, bool $sendMails, array $attribution): Booking
|
||||
private function create(Property $property, StayRequest $stay, array $guestData, ?string $message, string $source, bool $sendMails, array $attribution, ?Channel $originChannel): Booking
|
||||
{
|
||||
$booking = DB::transaction(function () use ($property, $stay, $guestData, $message, $source, $attribution): Booking {
|
||||
if ($originChannel !== null && $originChannel->property_id !== $property->id) {
|
||||
throw new ReservationException('Der Kanal gehört nicht zu dieser Wohnung.');
|
||||
}
|
||||
|
||||
$booking = DB::transaction(function () use ($property, $stay, $guestData, $message, $source, $attribution, $originChannel): Booking {
|
||||
Property::whereKey($property->getKey())->lockForUpdate()->first();
|
||||
|
||||
if (! $this->availability->isAvailable($property, $stay->arrival, $stay->departure)) {
|
||||
@@ -70,11 +77,14 @@ private function create(Property $property, StayRequest $stay, array $guestData,
|
||||
$quote = $this->calculator->calculate($property, $stay);
|
||||
|
||||
[$guest, $differences] = $this->guestFor($guestData);
|
||||
$profile = app(ProcessSettings::class)->resolve($property, $originChannel, IntakeKind::Inquiry);
|
||||
|
||||
return $property->bookings()->create([
|
||||
'guest_id' => $guest->id,
|
||||
'status' => BookingStatus::Reserved,
|
||||
'source' => $source,
|
||||
'intake' => IntakeKind::Inquiry,
|
||||
'origin_channel_id' => $originChannel?->id,
|
||||
...Arr::only(array_filter($attribution), ['referral_source', 'utm_source', 'utm_medium', 'utm_campaign']),
|
||||
'arrival' => $stay->arrival->toDateString(),
|
||||
'departure' => $stay->departure->toDateString(),
|
||||
@@ -85,7 +95,7 @@ private function create(Property $property, StayRequest $stay, array $guestData,
|
||||
'total' => $quote->total(),
|
||||
'deposit' => $quote->deposit(),
|
||||
'balance_due_on' => $quote->balanceDueOn->toDateString(),
|
||||
'hold_expires_at' => $property->pre_reservation_enabled ? now()->addHours($property->hold_hours) : null,
|
||||
'hold_expires_at' => $profile->preReservation() ? now()->addHours($profile->holdHours()) : null,
|
||||
'message' => $message,
|
||||
'internal_notes' => $differences !== [] ? "Abweichende Angaben in dieser Anfrage (Gästekartei nicht geändert):\n".implode("\n", $differences) : null,
|
||||
]);
|
||||
@@ -165,7 +175,7 @@ private function sendMails(Booking $booking): void
|
||||
}
|
||||
|
||||
try {
|
||||
if (! $offerSent) {
|
||||
if (! $offerSent && filled($booking->guest?->email)) {
|
||||
Mail::to($booking->guest->email, $booking->guest->full_name)->send(new ReservationReceived($booking));
|
||||
}
|
||||
Mail::to(Settings::notificationRecipients())->send(new NewReservation($booking, $offerSent, $blockers));
|
||||
|
||||
@@ -2,90 +2,39 @@
|
||||
|
||||
namespace App\Actions;
|
||||
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\OccupationKind;
|
||||
use App\Exceptions\ReservationException;
|
||||
use App\Models\BlockedPeriod;
|
||||
use App\Models\Booking;
|
||||
use App\Models\Guest;
|
||||
use App\Models\Property;
|
||||
use App\Pricing\PortalPrice;
|
||||
use App\Pricing\StayRequest;
|
||||
use App\Tenancy\TenantContext;
|
||||
use Carbon\CarbonImmutable;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
|
||||
/**
|
||||
* Opens the booking file for a reservation that arrived through a portal calendar. The calendar only says "these
|
||||
* nights are taken"; the file gives the reservation its workflow (contact data, contract, payments, arrival,
|
||||
* cancellation) like every other booking. The imported calendar entry stays as the portal's mirror of the booking
|
||||
* (it keeps its calendar source and UID, but the booking now leads the calendar), the dates stay occupied throughout.
|
||||
*
|
||||
* Unknown facts stay unknown: the guest is a placeholder without contact data, the price is our own calculation (or
|
||||
* empty) until the portal price is entered.
|
||||
* Takes over a reservation found in a portal calendar as a case ({@see TakeOverExternalBooking}). The calendar only
|
||||
* says "these nights are taken"; the case gives the reservation its handling. The calendar entry stays as the portal's
|
||||
* mirror of the case. A first name from the calendar is no guest identity – it is kept as a note, not as a guest.
|
||||
*/
|
||||
class OpenPortalFile
|
||||
{
|
||||
public function __construct(private PortalPrice $price) {}
|
||||
public function __construct(private TakeOverExternalBooking $takeOver) {}
|
||||
|
||||
/**
|
||||
* @throws ReservationException
|
||||
*/
|
||||
public function handle(BlockedPeriod $block): Booking
|
||||
{
|
||||
return DB::transaction(function () use ($block): Booking {
|
||||
Property::query()->whereKey($block->property_id)->lockForUpdate()->firstOrFail();
|
||||
$block = BlockedPeriod::query()->whereKey($block->id)->lockForUpdate()->firstOrFail();
|
||||
if ($block->channel === null) {
|
||||
throw new ReservationException('Übernehmen lassen sich nur Reservierungen aus einem Portalkalender.');
|
||||
}
|
||||
|
||||
if (! in_array($block->source, ['channel', 'email'], true) || $block->channel_id === null) {
|
||||
throw new ReservationException('Eine Akte gibt es nur für Reservierungen aus einem Portalkalender.');
|
||||
}
|
||||
if ($block->occupationKind() === OccupationKind::Block) {
|
||||
throw new ReservationException('Eine Sperrzeit ist keine Reservierung. Bitte zuerst „Einordnen“ und als Portalreservierung kennzeichnen.');
|
||||
}
|
||||
if ($block->is_representation && $block->linked_booking_id !== null) {
|
||||
return Booking::query()->findOrFail($block->linked_booking_id);
|
||||
}
|
||||
if ($block->is_representation) {
|
||||
throw new ReservationException('Dieser Eintrag ist die Spiegelung einer anderen Belegung. Die Akte gehört an die führende Belegung.');
|
||||
}
|
||||
$fields = (array) ($block->ical_interpretation['fields'] ?? []);
|
||||
$name = trim((string) ($fields['guest_first_name'] ?? ''));
|
||||
|
||||
$property = $block->property;
|
||||
$channel = $block->channel;
|
||||
$fields = (array) ($block->ical_interpretation['fields'] ?? []);
|
||||
$guest = $block->guest ?? Guest::query()->create([
|
||||
'first_name' => filled($fields['guest_first_name'] ?? null) ? (string) $fields['guest_first_name'] : 'Gast',
|
||||
'last_name' => '('.$channel->name.')',
|
||||
'email' => '',
|
||||
'tenant_id' => app(TenantContext::class)->id(),
|
||||
]);
|
||||
|
||||
$stay = new StayRequest(CarbonImmutable::parse($block->starts_on), CarbonImmutable::parse($block->ends_on), min(2, $property->max_guests));
|
||||
$booking = $property->bookings()->create([
|
||||
'guest_id' => $guest->id,
|
||||
'status' => BookingStatus::Reserved,
|
||||
'source' => 'portal',
|
||||
'origin_channel_id' => $block->origin_channel_id ?? $channel->id,
|
||||
'portal_reference' => $fields['booking_reference'] ?? null,
|
||||
'arrival' => $stay->arrival->toDateString(),
|
||||
'departure' => $stay->departure->toDateString(),
|
||||
'guests' => $stay->guests,
|
||||
'hold_expires_at' => null,
|
||||
'internal_notes' => 'Akte aus dem Portalkalender „'.$channel->name.'“ angelegt. Personenzahl und Preis sind nicht bekannt – bitte den Portalpreis erfassen.',
|
||||
...$this->price->unknownColumns($property, $stay),
|
||||
]);
|
||||
|
||||
$block->forceFill([
|
||||
'is_representation' => true, 'representation_automatic' => false, 'canonical_block_id' => null,
|
||||
'linked_booking_id' => $booking->id, 'export_approved' => false, 'needs_review' => false, 'reviewed_at' => now(),
|
||||
'occupation_kind' => OccupationKind::Reservation, 'guest_id' => $guest->id,
|
||||
'review_note' => 'Akte angelegt; die Buchung führt diese Belegung.',
|
||||
])->save();
|
||||
|
||||
app(ConfirmBooking::class)->bind($booking);
|
||||
app(ReconcileChannelRepresentations::class)->handle($property);
|
||||
|
||||
return $booking->refresh();
|
||||
});
|
||||
return $this->takeOver->handle(
|
||||
$block->property,
|
||||
$block->channel,
|
||||
CarbonImmutable::parse($block->starts_on),
|
||||
CarbonImmutable::parse($block->ends_on),
|
||||
['notes' => 'Aus dem Portalkalender „'.$block->channel->name.'“ übernommen.'.($name !== '' ? ' Name laut Kalender: '.$name.'.' : '')],
|
||||
$block,
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -3,10 +3,13 @@
|
||||
namespace App\Actions;
|
||||
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Enums\ProcessingMode;
|
||||
use App\Exceptions\ReservationException;
|
||||
use App\Models\Booking;
|
||||
use App\Support\BookingProgress;
|
||||
use App\Models\Guest;
|
||||
use Illuminate\Support\Arr;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
|
||||
/**
|
||||
* The guest's contact data arrived (portal message, e-mail, phone) and is entered on the booking. The landlord chooses
|
||||
@@ -19,7 +22,7 @@ class ProvideGuestContact
|
||||
|
||||
public const MANUAL = 'manual';
|
||||
|
||||
public function __construct(private ConfirmBooking $confirm, private SendOffer $offer) {}
|
||||
public function __construct(private ConfirmBooking $confirm, private AutoOffer $autoOffer, private SendBookingDocuments $documents) {}
|
||||
|
||||
/**
|
||||
* @param array<string, ?string> $contact first_name, last_name, email, phone, street, postal_code, city, country
|
||||
@@ -38,9 +41,17 @@ public function handle(Booking $booking, array $contact, string $process = self:
|
||||
throw new ReservationException('Für den automatischen Ablauf wird die E-Mail-Adresse des Gastes benötigt.');
|
||||
}
|
||||
|
||||
$booking->guest->update(array_filter($contact, fn ($value) => $value !== null));
|
||||
if ($booking->guest === null) {
|
||||
if (blank($contact['first_name'] ?? null) || blank($contact['last_name'] ?? null)) {
|
||||
throw new ReservationException('Bitte Vor- und Nachnamen des Gastes angeben.');
|
||||
}
|
||||
$guest = Guest::query()->create([...array_filter($contact, fn ($value) => $value !== null), 'email' => $contact['email'] ?? '']);
|
||||
$booking->update(['guest_id' => $guest->id]);
|
||||
} else {
|
||||
$booking->guest->update(array_filter($contact, fn ($value) => $value !== null));
|
||||
}
|
||||
if ($guestConfirmed) {
|
||||
$booking->forceFill(['guest_confirmed_at' => $booking->guest_confirmed_at ?? now()])->saveQuietly();
|
||||
$booking->forceFill(['guest_confirmed_at' => $booking->guest_confirmed_at ?? now()])->save();
|
||||
}
|
||||
$booking->refresh()->load('guest');
|
||||
|
||||
@@ -48,19 +59,31 @@ public function handle(Booking $booking, array $contact, string $process = self:
|
||||
return 'Kontaktdaten gespeichert';
|
||||
}
|
||||
|
||||
$booking->update(['processing_mode' => ProcessingMode::Automatic]);
|
||||
|
||||
if (in_array($booking->status, BookingStatus::occupying(), true)) {
|
||||
$this->confirm->deliver($booking);
|
||||
$reasons = $this->documents->automatically($booking);
|
||||
if ($reasons !== []) {
|
||||
throw new ReservationException('Kontaktdaten gespeichert. Die Unterlagen werden noch nicht automatisch versendet: '.implode(' ', $reasons));
|
||||
}
|
||||
|
||||
return 'Kontaktdaten gespeichert, Vertrag gesendet';
|
||||
return 'Kontaktdaten gespeichert, Unterlagen gesendet';
|
||||
}
|
||||
|
||||
if (BookingProgress::kind($booking) === BookingProgress::PORTAL_BOOKING) {
|
||||
$this->confirm->handle($booking);
|
||||
if ($booking->intake === IntakeKind::Booking) {
|
||||
DB::transaction(fn () => $this->confirm->bind($booking));
|
||||
$reasons = $this->documents->automatically($booking->fresh());
|
||||
if ($reasons !== []) {
|
||||
throw new ReservationException('Kontaktdaten gespeichert und Buchung bestätigt. Die Unterlagen werden noch nicht automatisch versendet: '.implode(' ', $reasons));
|
||||
}
|
||||
|
||||
return 'Kontaktdaten gespeichert, Buchung bestätigt und Vertrag gesendet';
|
||||
return 'Kontaktdaten gespeichert, Buchung bestätigt und Unterlagen gesendet';
|
||||
}
|
||||
|
||||
$this->offer->handle($booking);
|
||||
$reasons = $this->autoOffer->handle($booking);
|
||||
if ($reasons !== []) {
|
||||
throw new ReservationException('Kontaktdaten gespeichert. Das Angebot wird noch nicht automatisch gesendet: '.implode(' ', $reasons));
|
||||
}
|
||||
|
||||
return 'Kontaktdaten gespeichert, Angebot gesendet';
|
||||
}
|
||||
|
||||
@@ -1,77 +0,0 @@
|
||||
<?php
|
||||
|
||||
namespace App\Actions;
|
||||
|
||||
use App\Exceptions\ReservationException;
|
||||
use App\Models\Booking;
|
||||
use App\Models\Channel;
|
||||
use App\Models\Property;
|
||||
use App\Pricing\PortalPrice;
|
||||
use App\Pricing\QuoteException;
|
||||
use App\Pricing\StayRequest;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
|
||||
/**
|
||||
* Records a booking that a portal already made binding (e.g. a direct booking on FeWo-direkt) – usually without
|
||||
* the guest's contact data. The booking keeps the portal as its origin channel and may carry the portal's price and
|
||||
* reference. The landlord decides how the contract process continues:
|
||||
*
|
||||
* - {@see self::CONFIRM}: the booking becomes binding right away (the dates are occupied), the contract follows
|
||||
* once the contact data is known ({@see ProvideGuestContact}) – no contract is generated before that;
|
||||
* - {@see self::CONTRACT}: binding and contract mail at once (needs the guest's e-mail address);
|
||||
* - {@see self::RECORD}: only recorded as a request, everything else is done by hand.
|
||||
*/
|
||||
class RecordPortalBooking
|
||||
{
|
||||
public const CONFIRM = 'confirm';
|
||||
|
||||
public const CONTRACT = 'contract';
|
||||
|
||||
public const RECORD = 'record';
|
||||
|
||||
public function __construct(
|
||||
private CreateReservation $create,
|
||||
private ConfirmBooking $confirm,
|
||||
private PortalPrice $price,
|
||||
) {}
|
||||
|
||||
/**
|
||||
* @param array<string, ?string> $guestData first_name and last_name are required, everything else optional
|
||||
*
|
||||
* @throws QuoteException
|
||||
* @throws ReservationException
|
||||
*/
|
||||
public function handle(Property $property, Channel $channel, StayRequest $stay, array $guestData, string $process = self::CONFIRM, ?string $portalReference = null, ?int $portalTotal = null, ?string $notes = null, bool $guestConfirmed = false): Booking
|
||||
{
|
||||
if ($channel->property_id !== $property->id) {
|
||||
throw new ReservationException('Der Kanal gehört nicht zu dieser Wohnung.');
|
||||
}
|
||||
|
||||
if ($process === self::CONTRACT && blank($guestData['email'] ?? null)) {
|
||||
throw new ReservationException('Für den sofortigen Vertragsversand wird die E-Mail-Adresse des Gastes benötigt.');
|
||||
}
|
||||
|
||||
$booking = $this->create->handle($property, $stay, $guestData, source: 'portal', sendMails: false);
|
||||
|
||||
$changes = ['origin_channel_id' => $channel->id, 'portal_reference' => filled($portalReference) ? trim($portalReference) : null, 'internal_notes' => filled($notes) ? trim($notes) : $booking->internal_notes];
|
||||
if ($guestConfirmed) {
|
||||
$changes['guest_confirmed_at'] = now();
|
||||
}
|
||||
if ($portalTotal !== null) {
|
||||
$changes += $this->price->columns($property, $stay, $portalTotal);
|
||||
}
|
||||
$booking->update($changes);
|
||||
|
||||
if ($process === self::RECORD) {
|
||||
return $booking->refresh();
|
||||
}
|
||||
|
||||
if ($process === self::CONTRACT) {
|
||||
$this->confirm->handle($booking, notifyGuest: true);
|
||||
} else {
|
||||
DB::transaction(fn () => $this->confirm->bind($booking));
|
||||
}
|
||||
|
||||
return $booking->refresh();
|
||||
}
|
||||
}
|
||||
@@ -3,6 +3,7 @@
|
||||
namespace App\Actions;
|
||||
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\Responsibility;
|
||||
use App\Mail\ReviewRequest;
|
||||
use App\Models\Booking;
|
||||
use Illuminate\Support\Facades\Mail;
|
||||
@@ -25,7 +26,8 @@ public function handle(): int
|
||||
->whereDoesntHave('review')
|
||||
->whereHas('guest', fn ($query) => $query->whereNull('anonymized_at')->whereNotNull('email')->where('email', '!=', ''))
|
||||
->with('guest')
|
||||
->get();
|
||||
->get()
|
||||
->filter(fn (Booking $booking): bool => $booking->process()->guestMessages() === Responsibility::Landlord);
|
||||
|
||||
foreach ($bookings as $booking) {
|
||||
Mail::to($booking->guest->email, $booking->guest->full_name)->send(new ReviewRequest($booking));
|
||||
|
||||
@@ -0,0 +1,113 @@
|
||||
<?php
|
||||
|
||||
namespace App\Actions;
|
||||
|
||||
use App\Documents\DocumentComposer;
|
||||
use App\Documents\DocumentComposition;
|
||||
use App\Enums\DocumentKind;
|
||||
use App\Exceptions\ReservationException;
|
||||
use App\Models\Booking;
|
||||
use App\Process\CaseLog;
|
||||
use Illuminate\Support\Facades\Cache;
|
||||
|
||||
/**
|
||||
* Sends the documents of a binding case – the confirmation with the rental contract, or the booking documentation of a
|
||||
* booking already binding on a portal – from its composition ({@see DocumentComposer}). Automatically only when nothing
|
||||
* is missing and nothing has to be confirmed; by hand after the landlord confirmed every point. The documents go out
|
||||
* once: a lock and a fresh look at the case keep repeated runs, double clicks and parallel jobs from sending twice.
|
||||
* Until the first document exists the terms are taken from the composition (template and annexes as chosen); after
|
||||
* that they stay as they were sent.
|
||||
*/
|
||||
class SendBookingDocuments
|
||||
{
|
||||
public function __construct(private DocumentComposer $composer, private ConfirmBooking $confirm) {}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $changes
|
||||
*/
|
||||
public function compose(Booking $booking, array $changes = []): DocumentComposition
|
||||
{
|
||||
return $this->composer->compose($booking, self::kindFor($booking), $changes);
|
||||
}
|
||||
|
||||
/**
|
||||
* The automatic run: sends when the composition allows it.
|
||||
*
|
||||
* @return list<string> why nothing was sent (empty: sent or nothing to send)
|
||||
*/
|
||||
public function automatically(Booking $booking): array
|
||||
{
|
||||
if ($booking->confirmation_sent_at !== null) {
|
||||
return [];
|
||||
}
|
||||
|
||||
$composition = $this->compose($booking);
|
||||
if (! $composition->canSendAutomatically()) {
|
||||
return [...$composition->blockers(), ...array_map(fn (string $point): string => 'Bitte prüfen: '.$point, $composition->toConfirm())];
|
||||
}
|
||||
|
||||
return $this->send($booking, $composition, acknowledged: false, automatic: true) ? [] : ['Die Unterlagen konnten nicht versendet werden (siehe Postfach).'];
|
||||
}
|
||||
|
||||
/**
|
||||
* Sending by hand after the landlord saw the composition.
|
||||
*
|
||||
* @param array<string, mixed> $changes contract_template_id, annex_ids
|
||||
* @return bool whether the guest has the documents
|
||||
*
|
||||
* @throws ReservationException
|
||||
*/
|
||||
public function handle(Booking $booking, array $changes = [], bool $acknowledged = false): bool
|
||||
{
|
||||
if (! $booking->isBinding()) {
|
||||
throw ReservationException::invalidTransition($booking->status->getLabel(), 'mit Unterlagen bestätigt');
|
||||
}
|
||||
|
||||
$composition = $this->compose($booking, $changes);
|
||||
if ($composition->blockers() !== []) {
|
||||
throw new ReservationException(implode(' ', $composition->blockers()));
|
||||
}
|
||||
if (! $composition->canSendByHand($acknowledged)) {
|
||||
throw new ReservationException('Bitte die Hinweise prüfen und ausdrücklich bestätigen: '.implode(' ', $composition->toConfirm()));
|
||||
}
|
||||
|
||||
return $this->send($booking, $composition, $acknowledged, automatic: false);
|
||||
}
|
||||
|
||||
/**
|
||||
* The document kind of a binding case (a case whose documents the portal sends has none from us).
|
||||
*/
|
||||
public static function kindFor(Booking $booking): DocumentKind
|
||||
{
|
||||
$kind = DocumentKind::forCase($booking);
|
||||
|
||||
return in_array($kind, [DocumentKind::Confirmation, DocumentKind::ExternalRecord], true) ? $kind : DocumentKind::Confirmation;
|
||||
}
|
||||
|
||||
private function send(Booking $booking, DocumentComposition $composition, bool $acknowledged, bool $automatic): bool
|
||||
{
|
||||
$lock = Cache::lock('booking-documents-'.$booking->id, 120);
|
||||
if (! $lock->get()) {
|
||||
throw new ReservationException('Die Unterlagen werden gerade versendet. Bitte kurz warten und die Seite neu laden.');
|
||||
}
|
||||
|
||||
try {
|
||||
$booking->refresh();
|
||||
if ($booking->confirmation_sent_at !== null) {
|
||||
return true;
|
||||
}
|
||||
|
||||
if (! $composition->termsFrozen && $booking->contract_path === null && $composition->terms !== null) {
|
||||
$booking->update(['offer_terms' => $composition->terms]);
|
||||
}
|
||||
|
||||
if ($acknowledged && $composition->toConfirm() !== []) {
|
||||
CaseLog::record($booking, 'document', 'Hinweise vor dem Versand bestätigt', data: ['confirmed' => $composition->toConfirm()]);
|
||||
}
|
||||
|
||||
return CaseLog::context(fn (): bool => $this->confirm->deliver($booking, kind: $composition->kind), actor: $automatic ? CaseLog::SYSTEM.' (automatisch)' : null);
|
||||
} finally {
|
||||
$lock->release();
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -5,6 +5,7 @@
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\BookingTaskKind;
|
||||
use App\Enums\BookingTaskStatus;
|
||||
use App\Enums\Responsibility;
|
||||
use App\Mail\ArrivalInformation;
|
||||
use App\Models\Booking;
|
||||
use App\Models\BookingTask;
|
||||
@@ -60,7 +61,8 @@ public function handle(): array
|
||||
->whereNull('arrival_info_sent_at')
|
||||
->whereDate('arrival', '>=', $today)
|
||||
->whereDate('arrival', '<=', $today->copy()->addDays(self::ARRIVAL_INFO_MAX_DAYS_BEFORE)))
|
||||
->filter(fn (Booking $booking): bool => $booking->arrival->lessThanOrEqualTo($today->copy()->addDays($booking->property->arrival_info_days_before)));
|
||||
->filter(fn (Booking $booking): bool => $booking->process()->guestMessages() === Responsibility::Landlord
|
||||
&& $booking->arrival->lessThanOrEqualTo($today->copy()->addDays($booking->process()->arrivalInfoDaysBefore())));
|
||||
foreach ($arrivals as $booking) {
|
||||
Mail::to($booking->guest->email, $booking->guest->full_name)->send(new ArrivalInformation($booking));
|
||||
$booking->update(['arrival_info_sent_at' => now()]);
|
||||
|
||||
@@ -3,9 +3,11 @@
|
||||
namespace App\Actions;
|
||||
|
||||
use App\Availability\AvailabilityChecker;
|
||||
use App\Documents\DocumentComposer;
|
||||
use App\Documents\OfferTerms;
|
||||
use App\Documents\RentalContract;
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\DocumentKind;
|
||||
use App\Enums\InboxMessageKind;
|
||||
use App\Enums\QuoteLineType;
|
||||
use App\Exceptions\ReservationException;
|
||||
@@ -17,6 +19,7 @@
|
||||
use App\Pricing\QuoteException;
|
||||
use App\Pricing\QuoteLine;
|
||||
use App\Pricing\StayRequest;
|
||||
use App\Process\CaseLog;
|
||||
use App\Support\Inbox;
|
||||
use Carbon\CarbonImmutable;
|
||||
use Illuminate\Support\Arr;
|
||||
@@ -42,7 +45,12 @@ public function __construct(
|
||||
) {}
|
||||
|
||||
/**
|
||||
* @param array{arrival?: string, departure?: string, guests?: int, promo_code?: ?string, price_adjustment?: ?int, price_adjustment_label?: ?string, valid_until?: ?string, offer_message?: ?string, contract_template_id?: int|string|null, annex_ids?: ?list<int|string>, guest?: array<string, ?string>} $changes
|
||||
* The offer is checked through its composition ({@see DocumentComposer}) like every other document: points the
|
||||
* landlord has to confirm (e.g. an unreleased template, missing contract data, a request that by the settings
|
||||
* reserves nothing) stop it unless `acknowledged` is set. `expected_version` makes a repeated call harmless: when
|
||||
* another offer was sent in the meantime, nothing is sent again.
|
||||
*
|
||||
* @param array{arrival?: string, departure?: string, guests?: int, promo_code?: ?string, price_adjustment?: ?int, price_adjustment_label?: ?string, valid_until?: ?string, offer_message?: ?string, contract_template_id?: int|string|null, annex_ids?: ?list<int|string>, guest?: array<string, ?string>, acknowledged?: bool, expected_version?: ?int} $changes
|
||||
*
|
||||
* @throws QuoteException
|
||||
* @throws ReservationException
|
||||
@@ -57,6 +65,11 @@ public function handle(Booking $booking, array $changes = [], bool $sendMail = t
|
||||
throw ReservationException::invalidTransition($booking->status->getLabel(), 'als Angebot versendet');
|
||||
}
|
||||
|
||||
$toConfirm = app(DocumentComposer::class)->compose($booking, DocumentKind::Offer, $changes)->toConfirm();
|
||||
if ($toConfirm !== [] && ! ($changes['acknowledged'] ?? false)) {
|
||||
throw new ReservationException('Bitte die Hinweise prüfen und ausdrücklich bestätigen: '.implode(' ', $toConfirm));
|
||||
}
|
||||
|
||||
DB::transaction(function () use ($booking, $changes): void {
|
||||
$booking->lockForTransition();
|
||||
|
||||
@@ -64,6 +77,10 @@ public function handle(Booking $booking, array $changes = [], bool $sendMail = t
|
||||
throw ReservationException::invalidTransition($booking->status->getLabel(), 'als Angebot versendet');
|
||||
}
|
||||
|
||||
if (isset($changes['expected_version']) && $booking->offer_version !== (int) $changes['expected_version']) {
|
||||
throw new ReservationException('Inzwischen wurde schon ein Angebot gesendet (Version '.$booking->offer_version.'). Es wurde nichts erneut gesendet.');
|
||||
}
|
||||
|
||||
$arrival = CarbonImmutable::parse($changes['arrival'] ?? $booking->arrival);
|
||||
$departure = CarbonImmutable::parse($changes['departure'] ?? $booking->departure);
|
||||
|
||||
@@ -75,7 +92,7 @@ public function handle(Booking $booking, array $changes = [], bool $sendMail = t
|
||||
$stay = new StayRequest($arrival, $departure, (int) ($changes['guests'] ?? $booking->guests), $booking->extras ?? [], $promoCode);
|
||||
$adjustment = (int) ($changes['price_adjustment'] ?? 0);
|
||||
$adjustmentLabel = trim((string) ($changes['price_adjustment_label'] ?? '')) ?: ($adjustment < 0 ? 'Nachlass' : 'Zuschlag');
|
||||
$quote = $this->quoteWithAdjustment($booking, $stay, $adjustment, $adjustmentLabel);
|
||||
$quote = $this->quoteFor($booking, $stay, $adjustment, $adjustmentLabel);
|
||||
|
||||
if (filled($changes['guest'] ?? null)) {
|
||||
$booking->guest->update(Arr::only(array_map(fn ($value) => filled($value) ? trim((string) $value) : null, $changes['guest']), ['first_name', 'last_name', 'phone', 'street', 'postal_code', 'city', 'country']));
|
||||
@@ -93,7 +110,7 @@ public function handle(Booking $booking, array $changes = [], bool $sendMail = t
|
||||
'total' => $quote->total(),
|
||||
'deposit' => $quote->deposit(),
|
||||
'balance_due_on' => $quote->balanceDueOn->toDateString(),
|
||||
'hold_expires_at' => filled($changes['valid_until'] ?? null) ? CarbonImmutable::parse($changes['valid_until']) : now()->addHours($booking->property->hold_hours),
|
||||
'hold_expires_at' => filled($changes['valid_until'] ?? null) ? CarbonImmutable::parse($changes['valid_until']) : now()->addHours($booking->process()->holdHours()),
|
||||
'offer_version' => $booking->offer_version + 1,
|
||||
'offer_sent_at' => now(),
|
||||
'offer_message' => $changes['offer_message'] ?? null,
|
||||
@@ -105,6 +122,14 @@ public function handle(Booking $booking, array $changes = [], bool $sendMail = t
|
||||
|
||||
$booking->refresh();
|
||||
$this->contract->generate($booking, draft: true);
|
||||
CaseLog::record($booking, 'document', 'Angebot Version '.$booking->offer_version.' erstellt'.(isset($booking->offer_terms['template']['name']) ? ' (Vorlage '.$booking->offer_terms['template']['name'].', Version '.$booking->offer_terms['template']['version'].')' : ' (Texte der Webseite)'), data: array_filter([
|
||||
'kind' => DocumentKind::Offer->value,
|
||||
'template' => $booking->offer_terms['template'] ?? null,
|
||||
'annexes' => array_map(fn (array $annex): string => $annex['name'].' (Version '.$annex['version'].')', (array) ($booking->offer_terms['annexes'] ?? [])),
|
||||
'pdf_sha256' => $booking->offer_pdf_sha256,
|
||||
'offer_hash' => $booking->offer_hash,
|
||||
'confirmed' => $toConfirm,
|
||||
]));
|
||||
|
||||
if ($sendMail) {
|
||||
$this->deliver($booking);
|
||||
@@ -155,7 +180,7 @@ public function offerUrl(Booking $booking): string
|
||||
*
|
||||
* @throws QuoteException
|
||||
*/
|
||||
private function quoteWithAdjustment(Booking $booking, StayRequest $stay, int $adjustment, string $label): PriceQuote
|
||||
public function quoteFor(Booking $booking, StayRequest $stay, int $adjustment, string $label): PriceQuote
|
||||
{
|
||||
$quote = $this->calculator->calculate($booking->property, $stay);
|
||||
if ($adjustment === 0) {
|
||||
|
||||
@@ -9,6 +9,7 @@
|
||||
use App\Exceptions\ReservationException;
|
||||
use App\Models\Booking;
|
||||
use App\Models\BookingTask;
|
||||
use App\Process\CaseLog;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
|
||||
/**
|
||||
@@ -33,6 +34,10 @@ public function handle(Booking $booking, BookingStatus $status, string $reason,
|
||||
throw new ReservationException('Auf diesen Status kann nicht von Hand gewechselt werden. Stornieren und Ablehnen haben eigene Aktionen.');
|
||||
}
|
||||
|
||||
if ($status === BookingStatus::Reserved && in_array($booking->status, BookingStatus::occupying(), true)) {
|
||||
throw new ReservationException('Eine verbindliche Buchung kann nicht wieder zur Anfrage gemacht werden. Soll sie enden, bitte „Beenden“ wählen – dann wird sie ordentlich storniert.');
|
||||
}
|
||||
|
||||
if (blank(trim($reason))) {
|
||||
throw new ReservationException('Bitte einen Grund für die Statusänderung angeben.');
|
||||
}
|
||||
@@ -44,6 +49,9 @@ public function handle(Booking $booking, BookingStatus $status, string $reason,
|
||||
if ($from === $status) {
|
||||
throw new ReservationException('Die Buchung hat diesen Status bereits.');
|
||||
}
|
||||
if ($status === BookingStatus::Reserved && in_array($from, BookingStatus::occupying(), true)) {
|
||||
throw new ReservationException('Eine verbindliche Buchung kann nicht wieder zur Anfrage gemacht werden.');
|
||||
}
|
||||
|
||||
$becomesBinding = in_array($status, BookingStatus::occupying(), true) && ! in_array($from, BookingStatus::occupying(), true);
|
||||
if ($becomesBinding && ! $this->availability->isAvailable($booking->property, $booking->arrival, $booking->departure, ignore: $booking)) {
|
||||
@@ -59,7 +67,7 @@ public function handle(Booking $booking, BookingStatus $status, string $reason,
|
||||
}
|
||||
|
||||
$line = now()->format('d.m.Y H:i').' '.$by.': Status von „'.$from->getLabel().'“ auf „'.$status->getLabel().'“ gesetzt – '.trim($reason);
|
||||
$booking->update($changes + ['internal_notes' => trim(($booking->internal_notes ? $booking->internal_notes."\n" : '').$line)]);
|
||||
CaseLog::context(fn () => $booking->update($changes + ['internal_notes' => trim(($booking->internal_notes ? $booking->internal_notes."\n" : '').$line)]), actor: $by, reason: 'Von Hand gesetzt: '.trim($reason));
|
||||
|
||||
// A booking taken back into the process no longer needs the cancellation follow-up.
|
||||
if ($becomesBinding) {
|
||||
|
||||
@@ -0,0 +1,146 @@
|
||||
<?php
|
||||
|
||||
namespace App\Actions;
|
||||
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Enums\OccupationKind;
|
||||
use App\Exceptions\ReservationException;
|
||||
use App\Models\BlockedPeriod;
|
||||
use App\Models\Booking;
|
||||
use App\Models\Channel;
|
||||
use App\Models\Guest;
|
||||
use App\Models\Property;
|
||||
use App\Pricing\PortalPrice;
|
||||
use App\Process\CaseAutomation;
|
||||
use Carbon\CarbonImmutable;
|
||||
use Illuminate\Support\Arr;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
|
||||
/**
|
||||
* Takes over a booking that a portal already made binding (case types A3–A5): one case with the portal as origin
|
||||
* channel (owner), its reference and the facts the portal delivered – nothing more. There is no offer and no second
|
||||
* acceptance; the agreed portal price is taken over as it is; guest, number of guests and price may be unknown and
|
||||
* stay unknown until somebody enters them. The case is binding at once and occupies the dates.
|
||||
*
|
||||
* Used for the manual entry ("Buchung von einem Portal") and for a reservation found in a portal calendar – then the
|
||||
* calendar entry stays as the portal's mirror of the case.
|
||||
*/
|
||||
class TakeOverExternalBooking
|
||||
{
|
||||
public function __construct(private ConfirmBooking $confirm, private PortalPrice $price) {}
|
||||
|
||||
/**
|
||||
* @param array{guest?: ?array<string, ?string>, guests?: ?int, portal_reference?: ?string, portal_total?: ?int, notes?: ?string, guest_confirmed?: bool} $facts
|
||||
*
|
||||
* @throws ReservationException
|
||||
*/
|
||||
public function handle(Property $property, Channel $channel, CarbonImmutable $arrival, CarbonImmutable $departure, array $facts = [], ?BlockedPeriod $evidence = null): Booking
|
||||
{
|
||||
if ($channel->property_id !== $property->id) {
|
||||
throw new ReservationException('Der Kanal gehört nicht zu dieser Wohnung.');
|
||||
}
|
||||
if ($departure->lessThanOrEqualTo($arrival)) {
|
||||
throw new ReservationException('Die Abreise muss nach der Anreise liegen.');
|
||||
}
|
||||
|
||||
$booking = DB::transaction(function () use ($property, $channel, $arrival, $departure, $facts, $evidence): Booking {
|
||||
Property::query()->whereKey($property->id)->lockForUpdate()->firstOrFail();
|
||||
|
||||
if ($evidence !== null) {
|
||||
$evidence = BlockedPeriod::query()->whereKey($evidence->id)->lockForUpdate()->firstOrFail();
|
||||
$existing = $this->checkEvidence($evidence);
|
||||
if ($existing !== null) {
|
||||
return $existing;
|
||||
}
|
||||
}
|
||||
|
||||
$guests = isset($facts['guests']) && (int) $facts['guests'] > 0 ? (int) $facts['guests'] : null;
|
||||
$guest = $evidence?->guest ?? $this->guestFrom((array) ($facts['guest'] ?? []));
|
||||
$portalTotal = isset($facts['portal_total']) && $facts['portal_total'] !== '' ? (int) $facts['portal_total'] : null;
|
||||
$reference = filled($facts['portal_reference'] ?? null) ? trim((string) $facts['portal_reference']) : ($evidence?->ical_interpretation['fields']['booking_reference'] ?? null);
|
||||
|
||||
$booking = $property->bookings()->create([
|
||||
'guest_id' => $guest?->id,
|
||||
'status' => BookingStatus::Reserved,
|
||||
'source' => 'portal',
|
||||
'intake' => IntakeKind::Booking,
|
||||
'origin_channel_id' => $evidence?->origin_channel_id ?? $channel->id,
|
||||
'portal_reference' => $reference,
|
||||
'arrival' => $arrival->toDateString(),
|
||||
'departure' => $departure->toDateString(),
|
||||
'guests' => $guests,
|
||||
'hold_expires_at' => null,
|
||||
'guest_confirmed_at' => ($facts['guest_confirmed'] ?? false) ? now() : null,
|
||||
'internal_notes' => filled($facts['notes'] ?? null) ? trim((string) $facts['notes']) : null,
|
||||
...$this->price->columns($property, $arrival, $departure, $guests, $portalTotal, $channel->name),
|
||||
]);
|
||||
|
||||
if ($evidence !== null) {
|
||||
$evidence->forceFill([
|
||||
'is_representation' => true, 'representation_automatic' => false, 'canonical_block_id' => null,
|
||||
'linked_booking_id' => $booking->id, 'export_approved' => false, 'needs_review' => false, 'reviewed_at' => now(),
|
||||
'occupation_kind' => OccupationKind::Reservation, 'guest_id' => $guest?->id,
|
||||
'review_note' => 'Als Vorgang übernommen; der Vorgang führt diese Belegung.',
|
||||
])->save();
|
||||
}
|
||||
|
||||
$this->confirm->bind($booking);
|
||||
|
||||
if ($evidence !== null) {
|
||||
app(ReconcileChannelRepresentations::class)->handle($property);
|
||||
}
|
||||
|
||||
return $booking->refresh();
|
||||
});
|
||||
|
||||
app(CaseAutomation::class)->advance($booking);
|
||||
|
||||
return $booking->refresh();
|
||||
}
|
||||
|
||||
/**
|
||||
* A portal calendar entry can become a case once: returns the case it already belongs to, or throws when the entry
|
||||
* is no reservation of a portal.
|
||||
*
|
||||
* @throws ReservationException
|
||||
*/
|
||||
private function checkEvidence(BlockedPeriod $evidence): ?Booking
|
||||
{
|
||||
if (! in_array($evidence->source, ['channel', 'email'], true) || $evidence->channel_id === null) {
|
||||
throw new ReservationException('Übernehmen lassen sich nur Reservierungen aus einem Portalkalender.');
|
||||
}
|
||||
if ($evidence->occupationKind() === OccupationKind::Block) {
|
||||
throw new ReservationException('Eine Sperrzeit ist keine Buchung. Bitte zuerst „Einordnen“ und als Portalreservierung kennzeichnen.');
|
||||
}
|
||||
if ($evidence->is_representation && $evidence->linked_booking_id !== null) {
|
||||
return Booking::query()->findOrFail($evidence->linked_booking_id);
|
||||
}
|
||||
if ($evidence->is_representation) {
|
||||
throw new ReservationException('Dieser Eintrag ist die Spiegelung einer anderen Belegung. Der Vorgang gehört an die führende Belegung.');
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* The guest the portal named – only with a real name. A known e-mail address finds the existing guest without
|
||||
* overwriting his data; nothing is invented.
|
||||
*
|
||||
* @param array<string, ?string> $data
|
||||
*/
|
||||
private function guestFrom(array $data): ?Guest
|
||||
{
|
||||
$data = array_map(fn ($value) => filled($value) ? trim((string) $value) : null, Arr::only($data, ['first_name', 'last_name', 'email', 'phone', 'street', 'postal_code', 'city', 'country']));
|
||||
if (blank($data['first_name'] ?? null) || blank($data['last_name'] ?? null)) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$email = filled($data['email'] ?? null) ? mb_strtolower($data['email']) : null;
|
||||
if ($email !== null && ($known = Guest::query()->where('email', $email)->whereNull('anonymized_at')->first()) !== null) {
|
||||
return $known;
|
||||
}
|
||||
|
||||
return Guest::query()->create([...array_filter($data, fn ($value) => $value !== null), 'email' => $email ?? '']);
|
||||
}
|
||||
}
|
||||
@@ -21,7 +21,7 @@ public function conflictsFor(BlockedPeriod $block): array
|
||||
$period = $block->starts_on->format('d.m.Y').' – '.$block->ends_on->format('d.m.Y');
|
||||
|
||||
$bookings = $property->bookings()->occupying()->overlapping($block->starts_on, $block->ends_on)->with('guest')->get()
|
||||
->map(fn (Booking $booking): string => "{$channelName} meldet {$period}, überschneidet sich mit Buchung {$booking->reference} ({$booking->guest->full_name}, {$booking->arrival->format('d.m.Y')} – {$booking->departure->format('d.m.Y')})");
|
||||
->map(fn (Booking $booking): string => "{$channelName} meldet {$period}, überschneidet sich mit Buchung {$booking->reference} ({$booking->guestName()}, {$booking->arrival->format('d.m.Y')} – {$booking->departure->format('d.m.Y')})");
|
||||
|
||||
$blocks = $property->blockedPeriods()
|
||||
->occupying()
|
||||
|
||||
@@ -0,0 +1,59 @@
|
||||
<?php
|
||||
|
||||
namespace App\Console\Commands;
|
||||
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Enums\ProcessSetting;
|
||||
use App\Models\Channel;
|
||||
use App\Models\Property;
|
||||
use App\Models\Tenant;
|
||||
use App\Tenancy\TenantRunner;
|
||||
use Illuminate\Console\Attributes\Description;
|
||||
use Illuminate\Console\Attributes\Signature;
|
||||
use Illuminate\Console\Command;
|
||||
|
||||
#[Signature('process:settings-report')]
|
||||
#[Description('Show every landlord’s process defaults and all deviations of properties and channels (read only)')]
|
||||
class ProcessSettingsReport extends Command
|
||||
{
|
||||
public function handle(TenantRunner $runner): int
|
||||
{
|
||||
$runner->each(function (Tenant $tenant): void {
|
||||
$this->line('');
|
||||
$this->info($tenant->name);
|
||||
|
||||
$defaults = (array) ($tenant->process_defaults ?? []);
|
||||
foreach (ProcessSetting::cases() as $setting) {
|
||||
if (! $setting->isLandlordSetting()) {
|
||||
continue;
|
||||
}
|
||||
$value = $setting->normalize($defaults[$setting->value] ?? null);
|
||||
$this->line(' Standard · '.$setting->question().' '.$setting->describe($value ?? $setting->default()).($value === null ? ' (Grundeinstellung)' : ''));
|
||||
}
|
||||
|
||||
$rows = [];
|
||||
foreach (Property::query()->orderBy('name')->get() as $property) {
|
||||
foreach ((array) ($property->process_overrides ?? []) as $key => $value) {
|
||||
$setting = ProcessSetting::tryFrom((string) $key);
|
||||
if ($setting?->normalize($value) !== null) {
|
||||
$rows[] = ['Wohnung '.$property->name, $setting->question(), $setting->describe($setting->normalize($value))];
|
||||
}
|
||||
}
|
||||
}
|
||||
foreach (Channel::query()->with('property')->orderBy('name')->get() as $channel) {
|
||||
foreach ((array) ($channel->process_overrides ?? []) as $intake => $values) {
|
||||
foreach ((array) $values as $key => $value) {
|
||||
$setting = ProcessSetting::tryFrom((string) $key);
|
||||
if ($setting?->normalize($value) !== null) {
|
||||
$rows[] = ['Portal '.$channel->name.' ('.$channel->property?->name.', '.(IntakeKind::tryFrom((string) $intake)?->getLabel() ?? $intake).')', $setting->question(), $setting->describe($setting->normalize($value))];
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
$rows === [] ? $this->line(' Keine Abweichungen.') : $this->table(['Wo', 'Einstellung', 'Wert'], $rows);
|
||||
});
|
||||
|
||||
return self::SUCCESS;
|
||||
}
|
||||
}
|
||||
@@ -4,7 +4,6 @@
|
||||
|
||||
use App\Actions\AutoOffer;
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\OfferMode;
|
||||
use App\Models\Booking;
|
||||
use App\Models\Tenant;
|
||||
use App\Tenancy\TenantRunner;
|
||||
@@ -27,9 +26,9 @@ public function handle(AutoOffer $autoOffer, TenantRunner $runner): int
|
||||
->where('status', BookingStatus::Reserved)
|
||||
->where('offer_version', 0)
|
||||
->where('hold_expires_at', '>', now())
|
||||
->whereHas('property', fn ($query) => $query->where('offer_mode', OfferMode::Automatic)->where('pre_reservation_enabled', true))
|
||||
->with(['property', 'guest'])
|
||||
->get();
|
||||
->with(['property', 'guest', 'importChannel', 'originChannel'])
|
||||
->get()
|
||||
->filter(fn (Booking $booking): bool => $autoOffer->applies($booking) && $booking->process()->preReservation());
|
||||
|
||||
$sent = 0;
|
||||
foreach ($pending as $booking) {
|
||||
|
||||
@@ -106,10 +106,10 @@ private static function values(Booking $booking, array $propertyData): array
|
||||
'anreise_datum' => $booking->arrival->format('d.m.Y'),
|
||||
'abreise_datum' => $booking->departure->format('d.m.Y'),
|
||||
'naechte' => (string) $booking->nights(),
|
||||
'personen' => (string) $booking->guests,
|
||||
'gesamtpreis' => Money::format($booking->total),
|
||||
'anzahlung' => Money::format($booking->deposit),
|
||||
'restzahlung' => Money::format($booking->total - $booking->deposit),
|
||||
'personen' => $booking->guests !== null ? (string) $booking->guests : null,
|
||||
'gesamtpreis' => $booking->total !== null ? Money::format($booking->total) : null,
|
||||
'anzahlung' => $booking->deposit !== null ? Money::format($booking->deposit) : null,
|
||||
'restzahlung' => $booking->total !== null && $booking->deposit !== null ? Money::format($booking->total - $booking->deposit) : null,
|
||||
'restzahlung_faellig' => $booking->balance_due_on?->format('d.m.Y'),
|
||||
'buchungsnummer' => $booking->reference,
|
||||
'datum' => ($booking->confirmed_at ?? $booking->offer_sent_at ?? now())->format('d.m.Y'),
|
||||
|
||||
@@ -0,0 +1,404 @@
|
||||
<?php
|
||||
|
||||
namespace App\Documents;
|
||||
|
||||
use App\Actions\SendOffer;
|
||||
use App\Availability\AvailabilityChecker;
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\DocumentKind;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Enums\ProcessSetting;
|
||||
use App\Enums\Responsibility;
|
||||
use App\Models\Booking;
|
||||
use App\Models\CancellationPolicy;
|
||||
use App\Models\ContractTemplate;
|
||||
use App\Models\Extra;
|
||||
use App\Pricing\QuoteException;
|
||||
use App\Pricing\StayRequest;
|
||||
use App\Process\CaseActivities;
|
||||
use App\Process\ProcessProfile;
|
||||
use App\Process\ProcessSettings;
|
||||
use App\Support\Money;
|
||||
use Carbon\CarbonImmutable;
|
||||
use Illuminate\Support\Arr;
|
||||
use Throwable;
|
||||
|
||||
/**
|
||||
* Prepares the document a case needs (UMSETZUNGSPLAN_v0.10 §4.5, package 3): applies the landlord's adjustments to a copy
|
||||
* of the case, takes template and annexes from the process settings, captures the terms the document would freeze and
|
||||
* lists – in plain words – what is missing, what has to be confirmed and what is only worth knowing. Nothing is saved.
|
||||
*
|
||||
* Only objective criteria lead to findings (missing or contradictory data, unreleased texts, terms not shown to be
|
||||
* agreed); nationality or origin of a guest never do.
|
||||
*/
|
||||
class DocumentComposer
|
||||
{
|
||||
/** Placeholders that state payments to the landlord. */
|
||||
private const PAYMENT_PLACEHOLDERS = ['anzahlung', 'restzahlung', 'restzahlung_faellig'];
|
||||
|
||||
public function __construct(
|
||||
private SendOffer $offer,
|
||||
private AvailabilityChecker $availability,
|
||||
private ProcessSettings $settings,
|
||||
) {}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $changes adjustments of the landlord (offer: dates, guests, promo code, price adjustment
|
||||
* in cents, validity, message, guest data; all kinds: contract_template_id, annex_ids)
|
||||
*/
|
||||
public function compose(Booking $booking, ?DocumentKind $kind = null, array $changes = []): DocumentComposition
|
||||
{
|
||||
$booking->loadMissing(['guest', 'property', 'originChannel', 'importChannel']);
|
||||
$kind ??= DocumentKind::forCase($booking) ?? DocumentKind::Internal;
|
||||
$findings = [];
|
||||
|
||||
$draft = clone $booking;
|
||||
$draft->setRelation('guest', $booking->guest !== null ? (clone $booking->guest)->fill(self::guestChanges($changes)) : null);
|
||||
|
||||
if ($kind === DocumentKind::Offer) {
|
||||
$findings = [...$findings, ...$this->prepareOffer($booking, $draft, $changes)];
|
||||
}
|
||||
|
||||
$frozen = $kind !== DocumentKind::Offer && ($booking->contract_path !== null || ($booking->offer_version > 0 && is_array($booking->offer_terms)));
|
||||
$explicitTemplate = ! $frozen && filled($changes['contract_template_id'] ?? null);
|
||||
$template = match (true) {
|
||||
$frozen => isset($booking->offer_terms['template']['id']) ? ContractTemplate::query()->find($booking->offer_terms['template']['id']) : null,
|
||||
default => OfferTerms::templateFor($booking, $explicitTemplate ? $changes['contract_template_id'] : null),
|
||||
};
|
||||
$terms = match (true) {
|
||||
! $kind->isForGuests() => null,
|
||||
$frozen => $booking->offer_terms,
|
||||
default => OfferTerms::capture($template, $draft, array_key_exists('annex_ids', $changes) && is_array($changes['annex_ids']) ? array_map('intval', $changes['annex_ids']) : null),
|
||||
};
|
||||
$draft->offer_terms = $terms;
|
||||
|
||||
$findings = [...$findings, ...$this->commonFindings($booking, $draft, $kind, $template, $frozen)];
|
||||
if ($kind === DocumentKind::ExternalRecord) {
|
||||
$findings = [...$findings, ...$this->externalFindings($booking, $template, $terms, $frozen)];
|
||||
}
|
||||
if ($kind === DocumentKind::Confirmation) {
|
||||
$findings = [...$findings, ...$this->confirmationFindings($booking)];
|
||||
}
|
||||
|
||||
return new DocumentComposition(
|
||||
kind: $kind,
|
||||
draft: $draft,
|
||||
intakeLabel: explode(' · ', CaseActivities::situation($booking))[0],
|
||||
priceLines: array_values(array_map(fn (array $line): array => ['label' => (string) $line['label'], 'amount' => (int) $line['amount']], (array) ($draft->quote['lines'] ?? []))),
|
||||
priceSource: $this->priceSource($booking, $draft, $kind),
|
||||
services: $this->services($draft),
|
||||
cancellation: $this->cancellation($terms, $kind),
|
||||
template: $template,
|
||||
templateSource: $this->templateSource($booking, $frozen, $explicitTemplate),
|
||||
annexes: array_values(array_map(fn (array $annex): array => ['id' => (int) $annex['id'], 'label' => $annex['name'].' (Version '.$annex['version'].')'], (array) ($terms['annexes'] ?? []))),
|
||||
terms: $terms,
|
||||
termsFrozen: $frozen,
|
||||
findings: $findings,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Applies the offer adjustments to the copy and calculates its price exactly as {@see SendOffer} will.
|
||||
*
|
||||
* @param array<string, mixed> $changes
|
||||
* @return list<DocumentFinding>
|
||||
*/
|
||||
private function prepareOffer(Booking $booking, Booking $draft, array $changes): array
|
||||
{
|
||||
$findings = [];
|
||||
|
||||
if (! in_array($booking->status, [BookingStatus::Reserved, BookingStatus::OfferSent, BookingStatus::Expired], true)) {
|
||||
$findings[] = DocumentFinding::blocker('Für diesen Vorgang ist kein Angebot mehr möglich ('.$booking->status->getLabel().').');
|
||||
}
|
||||
|
||||
try {
|
||||
$arrival = CarbonImmutable::parse($changes['arrival'] ?? $booking->arrival);
|
||||
$departure = CarbonImmutable::parse($changes['departure'] ?? $booking->departure);
|
||||
$guests = (int) ($changes['guests'] ?? $booking->guests);
|
||||
$promo = array_key_exists('promo_code', $changes) ? (filled($changes['promo_code']) ? trim((string) $changes['promo_code']) : null) : $booking->promo_code;
|
||||
$adjustment = (int) ($changes['price_adjustment'] ?? 0);
|
||||
$label = trim((string) ($changes['price_adjustment_label'] ?? '')) ?: ($adjustment < 0 ? 'Nachlass' : 'Zuschlag');
|
||||
$quote = $this->offer->quoteFor($booking, new StayRequest($arrival, $departure, max(1, $guests), $booking->extras ?? [], $promo), $adjustment, $label);
|
||||
|
||||
$draft->forceFill([
|
||||
'arrival' => $arrival->toDateString(),
|
||||
'departure' => $departure->toDateString(),
|
||||
'guests' => $quote->guests,
|
||||
'promo_code' => $quote->promoCodeApplied ? $promo : null,
|
||||
'quote' => $quote->toArray(),
|
||||
'total' => $quote->total(),
|
||||
'deposit' => $quote->deposit(),
|
||||
'balance_due_on' => $quote->balanceDueOn->toDateString(),
|
||||
]);
|
||||
|
||||
if (! $this->availability->isAvailable($booking->property, $arrival, $departure, ignore: $booking)) {
|
||||
$findings[] = DocumentFinding::blocker('Der Zeitraum ist nicht mehr frei.');
|
||||
}
|
||||
} catch (QuoteException $exception) {
|
||||
$findings[] = DocumentFinding::blocker('Preis: '.$exception->getMessage());
|
||||
} catch (Throwable) {
|
||||
$findings[] = DocumentFinding::blocker('Bitte Anreise, Abreise und Personen angeben.');
|
||||
}
|
||||
|
||||
$draft->forceFill([
|
||||
'hold_expires_at' => filled($changes['valid_until'] ?? null) ? CarbonImmutable::parse($changes['valid_until']) : now()->addHours($booking->process()->holdHours()),
|
||||
'offer_version' => $booking->offer_version + 1,
|
||||
'offer_sent_at' => now(),
|
||||
'offer_message' => $changes['offer_message'] ?? $booking->offer_message,
|
||||
]);
|
||||
|
||||
if (! $booking->process()->preReservation()) {
|
||||
$findings[] = DocumentFinding::confirm('Nach Ihrer Einstellung reservieren Anfragen den Zeitraum nicht. Ein Angebot mit Annahmelink reserviert ihn trotzdem bis '.$draft->hold_expires_at->format('d.m.Y, H:i').' Uhr, und der Gast kann bis dahin verbindlich annehmen. Eine Auskunft ohne Reservierung gibt es erst in einem späteren Ausbauschritt.', DocumentFinding::HOLD_ZERO);
|
||||
}
|
||||
if ($booking->offer_version > 0) {
|
||||
$findings[] = DocumentFinding::info('Ersetzt Angebot Version '.$booking->offer_version.'; dessen Link wird ungültig.');
|
||||
}
|
||||
|
||||
return $findings;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return list<DocumentFinding>
|
||||
*/
|
||||
private function commonFindings(Booking $booking, Booking $draft, DocumentKind $kind, ?ContractTemplate $template, bool $frozen): array
|
||||
{
|
||||
if (! $kind->isForGuests()) {
|
||||
return [DocumentFinding::info('Für diesen Vorgang geht kein Dokument an Gäste.')];
|
||||
}
|
||||
|
||||
$findings = [];
|
||||
if (! $kind->isAvailable()) {
|
||||
$findings[] = DocumentFinding::blocker('„'.$kind->getLabel().'“ kann erst mit einem späteren Ausbauschritt versendet werden; die Arbeitsfassung ist vorbereitet.');
|
||||
}
|
||||
if ($draft->guest === null) {
|
||||
$findings[] = DocumentFinding::blocker('Name und Kontaktdaten des Gastes fehlen.');
|
||||
} elseif (blank($draft->guest->email)) {
|
||||
$findings[] = DocumentFinding::blocker('Die E-Mail-Adresse des Gastes fehlt.');
|
||||
}
|
||||
if ($kind !== DocumentKind::Offer && $booking->total === null) {
|
||||
$findings[] = DocumentFinding::blocker($booking->intake === IntakeKind::Booking ? 'Der Gesamtpreis (laut Portal) fehlt.' : 'Der Preis fehlt.');
|
||||
}
|
||||
if ($booking->confirmation_sent_at !== null && $kind !== DocumentKind::Offer) {
|
||||
$findings[] = DocumentFinding::info('Bereits gesendet am '.$booking->confirmation_sent_at->format('d.m.Y, H:i').' Uhr. Erneutes Senden schickt dieselben Unterlagen.');
|
||||
}
|
||||
|
||||
if ($frozen) {
|
||||
return $findings;
|
||||
}
|
||||
|
||||
if ($kind->isAvailable() && ! DocumentReleases::isReleased($kind)) {
|
||||
$findings[] = DocumentFinding::confirm('Die Texte für „'.$kind->getLabel().'“ sind eine Arbeitsfassung und noch nicht freigegeben (So arbeite ich › Dokumente).');
|
||||
}
|
||||
if ($template !== null && ! $template->isReleased()) {
|
||||
$findings[] = DocumentFinding::confirm('Die Vorlage „'.$template->label().'“ ist noch nicht für Gäste freigegeben (Vorlagen › Freigabe).');
|
||||
}
|
||||
$missing = $this->missingPlaceholders($draft);
|
||||
if ($missing !== []) {
|
||||
$findings[] = DocumentFinding::confirm('Im Vertragstext fehlen Angaben, sie erscheinen als [name?]: '.implode(', ', $missing).'.');
|
||||
}
|
||||
|
||||
return $findings;
|
||||
}
|
||||
|
||||
/**
|
||||
* Bookings already binding on a portal: no acceptance link, the portal price counts, and the template must not add
|
||||
* obligations the guest did not accept there (E-004).
|
||||
*
|
||||
* @param array<string, mixed>|null $terms
|
||||
* @return list<DocumentFinding>
|
||||
*/
|
||||
private function externalFindings(Booking $booking, ?ContractTemplate $template, ?array $terms, bool $frozen): array
|
||||
{
|
||||
$channel = $booking->processChannel()?->name ?? 'dem Portal';
|
||||
$findings = [DocumentFinding::info('Kein Annahmelink: Die Buchung ist bei '.$channel.' bereits verbindlich zustande gekommen.')];
|
||||
|
||||
if ($frozen) {
|
||||
return $findings;
|
||||
}
|
||||
|
||||
if ($template === null) {
|
||||
$findings[] = DocumentFinding::confirm('Für Buchungen über '.$channel.' ist keine eigene Vorlage hinterlegt. Die Unterlagen enthielten Ihre Mietbedingungen der Webseite – ihnen hat der Gast bei '.$channel.' nicht zugestimmt.');
|
||||
} elseif (! $template->confirmsPortalTerms()) {
|
||||
$findings[] = DocumentFinding::confirm('Die Vorlage „'.$template->label().'“ ist nicht als Wiedergabe der Bedingungen von '.$channel.' bestätigt. Zusätzliche Pflichten gelten nur, wenn der Gast ihnen dort zugestimmt hat.');
|
||||
$fees = $this->fees($terms);
|
||||
if ($fees !== []) {
|
||||
$findings[] = DocumentFinding::confirm('Gebühren in der Vorlage, die bei '.$channel.' nicht nachweislich vereinbart sind: '.implode('; ', $fees).'.');
|
||||
}
|
||||
}
|
||||
|
||||
if ($booking->process()->payments() === Responsibility::Portal && $this->mentionsPaymentsToUs($terms)) {
|
||||
$findings[] = DocumentFinding::confirm('Die Vorlage nennt Zahlungen an Sie (Anzahlung/Restzahlung), laut Einstellung zahlt der Gast über '.$channel.'.');
|
||||
}
|
||||
|
||||
return $findings;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return list<DocumentFinding>
|
||||
*/
|
||||
private function confirmationFindings(Booking $booking): array
|
||||
{
|
||||
return $booking->accepted_at !== null
|
||||
? [DocumentFinding::info('Bedingungen wie im angenommenen Angebot vom '.$booking->accepted_at->format('d.m.Y').' (unverändert).')]
|
||||
: [];
|
||||
}
|
||||
|
||||
private function priceSource(Booking $booking, Booking $draft, DocumentKind $kind): string
|
||||
{
|
||||
return match (true) {
|
||||
$draft->total === null => 'noch nicht bekannt',
|
||||
($draft->quote['source'] ?? null) === 'portal' => 'laut '.($booking->processChannel()?->name ?? 'Portal').' übernommen, nicht neu berechnet',
|
||||
$kind === DocumentKind::Offer => 'aus Ihren Preisen berechnet',
|
||||
$booking->accepted_at !== null => 'wie im angenommenen Angebot',
|
||||
default => 'aus Ihren Preisen berechnet',
|
||||
};
|
||||
}
|
||||
|
||||
private function templateSource(Booking $booking, bool $frozen, bool $explicit): string
|
||||
{
|
||||
if ($frozen) {
|
||||
return $booking->offer_version > 0 ? 'im angenommenen Angebot festgehalten' : 'mit den Unterlagen festgehalten';
|
||||
}
|
||||
if ($explicit) {
|
||||
return 'für diesen Vorgang gewählt';
|
||||
}
|
||||
|
||||
$source = $this->settings->forBooking($booking)->source(ProcessSetting::ContractTemplate);
|
||||
|
||||
return match ($source) {
|
||||
ProcessProfile::CHANNEL => 'eingestellt für '.$booking->processChannel()?->name.' ('.($booking->intake?->getLabel() ?? '').')',
|
||||
ProcessProfile::PROPERTY => 'eingestellt für die Wohnung '.$booking->property->name,
|
||||
ProcessProfile::TENANT => 'Ihre Standardeinstellung',
|
||||
default => 'keine Vorlage eingestellt',
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* @return list<string>
|
||||
*/
|
||||
private function services(Booking $draft): array
|
||||
{
|
||||
$extras = array_filter((array) ($draft->extras ?? []), fn ($quantity): bool => (int) $quantity > 0);
|
||||
if ($extras === []) {
|
||||
return [];
|
||||
}
|
||||
|
||||
return Extra::query()->whereIn('id', array_keys($extras))->orderBy('name')->get()
|
||||
->map(fn (Extra $extra): string => $extra->name.((int) $extras[$extra->id] > 1 ? ' × '.$extras[$extra->id] : ''))
|
||||
->values()->all();
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed>|null $terms
|
||||
* @return list<string>
|
||||
*/
|
||||
private function cancellation(?array $terms, DocumentKind $kind): array
|
||||
{
|
||||
$lines = [];
|
||||
if ($kind === DocumentKind::ExternalRecord) {
|
||||
$lines[] = 'Maßgeblich ist die bei der Buchung über das Portal vereinbarte Regel.';
|
||||
}
|
||||
|
||||
$policy = $terms['cancellation_policy'] ?? null;
|
||||
if (is_array($policy) && ! empty($policy['tiers'])) {
|
||||
return [...$lines, ...CancellationPolicy::describe($policy)];
|
||||
}
|
||||
if (filled($terms['texts']['stay.cancellation'] ?? null)) {
|
||||
return [...$lines, 'Laut Text „Rücktritt / Stornierung“ der Vorlage bzw. Webseite (keine Staffel hinterlegt).'];
|
||||
}
|
||||
|
||||
return $terms === null ? $lines : [...$lines, 'Keine Stornoregel hinterlegt.'];
|
||||
}
|
||||
|
||||
/**
|
||||
* Placeholders of the contract text that have no value for this case.
|
||||
*
|
||||
* @return list<string>
|
||||
*/
|
||||
private function missingPlaceholders(Booking $draft): array
|
||||
{
|
||||
$terms = (array) ($draft->offer_terms ?? []);
|
||||
$data = (array) ($terms['property_data'] ?? []);
|
||||
$texts = array_filter([
|
||||
$terms['document']['body'] ?? null,
|
||||
$terms['document']['annex_body'] ?? null,
|
||||
...array_map(fn (array $annex): ?string => $annex['body'] ?? null, (array) ($terms['annexes'] ?? [])),
|
||||
]);
|
||||
|
||||
return array_values(array_unique(array_merge(...array_map(fn (string $html): array => ContractPlaceholders::missing($html, $draft, $data), $texts ?: ['']))));
|
||||
}
|
||||
|
||||
/**
|
||||
* Fees a template states: the replacement fee of its cancellation rule and amounts written in its texts.
|
||||
*
|
||||
* @param array<string, mixed>|null $terms
|
||||
* @return list<string>
|
||||
*/
|
||||
private function fees(?array $terms): array
|
||||
{
|
||||
$fees = [];
|
||||
$policy = $terms['cancellation_policy'] ?? null;
|
||||
if (is_array($policy) && ($policy['replacement_fee'] ?? null) !== null) {
|
||||
$fees[] = 'Ersatzmieter-Gebühr '.Money::format((int) $policy['replacement_fee']);
|
||||
}
|
||||
if (is_array($policy) && ! empty($policy['tiers'])) {
|
||||
$fees[] = 'Stornokosten nach Staffel ('.$policy['name'].')';
|
||||
}
|
||||
|
||||
$text = strip_tags(implode(' ', $this->templateTexts($terms)));
|
||||
preg_match_all('/\d{1,3}(?:\.\d{3})*(?:,\d{1,2})?\s?(?:€|EUR\b|Euro\b)/u', html_entity_decode($text), $amounts);
|
||||
foreach (array_unique($amounts[0]) as $amount) {
|
||||
$fees[] = trim($amount).' (im Text)';
|
||||
}
|
||||
|
||||
return $fees;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed>|null $terms
|
||||
*/
|
||||
private function mentionsPaymentsToUs(?array $terms): bool
|
||||
{
|
||||
$text = implode(' ', $this->templateTexts($terms));
|
||||
foreach (self::PAYMENT_PLACEHOLDERS as $placeholder) {
|
||||
if (preg_match('/\{\{\s*'.$placeholder.'\s*\}\}/i', $text) === 1) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* The texts a template contributes (not the website texts it falls back to).
|
||||
*
|
||||
* @param array<string, mixed>|null $terms
|
||||
* @return list<string>
|
||||
*/
|
||||
private function templateTexts(?array $terms): array
|
||||
{
|
||||
if ($terms === null || ! isset($terms['template'])) {
|
||||
return [];
|
||||
}
|
||||
|
||||
$template = ContractTemplate::query()->find($terms['template']['id']);
|
||||
|
||||
return array_values(array_filter([
|
||||
$terms['document']['body'] ?? null,
|
||||
$terms['document']['annex_body'] ?? null,
|
||||
...array_values($template?->overrides() ?? []),
|
||||
...array_map(fn (array $annex): ?string => $annex['body'] ?? null, (array) ($terms['annexes'] ?? [])),
|
||||
]));
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $changes
|
||||
* @return array<string, ?string>
|
||||
*/
|
||||
private static function guestChanges(array $changes): array
|
||||
{
|
||||
$guest = (array) ($changes['guest'] ?? []);
|
||||
|
||||
return array_map(fn ($value): ?string => filled($value) ? trim((string) $value) : null, array_filter(Arr::only($guest, ['first_name', 'last_name', 'phone', 'street', 'postal_code', 'city', 'country']), 'filled'));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,129 @@
|
||||
<?php
|
||||
|
||||
namespace App\Documents;
|
||||
|
||||
use App\Enums\DocumentKind;
|
||||
use App\Models\Booking;
|
||||
use App\Models\ContractTemplate;
|
||||
|
||||
/**
|
||||
* Everything a document of a case consists of before it is sent (UMSETZUNGSPLAN_v0.10 §4.5): recipient, stay, how the
|
||||
* case came in, price with its origin, services, cancellation rule, template and annexes, and what has to be checked.
|
||||
* The same composition is shown to the landlord, decides whether the automatic run may send, and is what is sent.
|
||||
*/
|
||||
final class DocumentComposition
|
||||
{
|
||||
/**
|
||||
* @param Booking $draft the case as the document will show it (never saved)
|
||||
* @param list<array{label: string, amount: int}> $priceLines
|
||||
* @param list<string> $services
|
||||
* @param list<string> $cancellation
|
||||
* @param list<array{id: int, label: string}> $annexes
|
||||
* @param array<string, mixed>|null $terms the terms the document freezes (null: the website texts apply live)
|
||||
* @param list<DocumentFinding> $findings
|
||||
*/
|
||||
public function __construct(
|
||||
public readonly DocumentKind $kind,
|
||||
public readonly Booking $draft,
|
||||
public readonly string $intakeLabel,
|
||||
public readonly array $priceLines,
|
||||
public readonly string $priceSource,
|
||||
public readonly array $services,
|
||||
public readonly array $cancellation,
|
||||
public readonly ?ContractTemplate $template,
|
||||
public readonly string $templateSource,
|
||||
public readonly array $annexes,
|
||||
public readonly ?array $terms,
|
||||
public readonly bool $termsFrozen,
|
||||
public readonly array $findings,
|
||||
) {}
|
||||
|
||||
public function recipientName(): ?string
|
||||
{
|
||||
return $this->draft->guest?->full_name;
|
||||
}
|
||||
|
||||
public function recipientEmail(): ?string
|
||||
{
|
||||
return filled($this->draft->guest?->email) ? $this->draft->guest->email : null;
|
||||
}
|
||||
|
||||
/**
|
||||
* @return list<string>
|
||||
*/
|
||||
public function blockers(): array
|
||||
{
|
||||
return $this->messages(DocumentFinding::BLOCKER);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param list<string> $except codes of findings left out
|
||||
* @return list<string>
|
||||
*/
|
||||
public function toConfirm(array $except = []): array
|
||||
{
|
||||
return $this->messages(DocumentFinding::CONFIRM, $except);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return list<string>
|
||||
*/
|
||||
public function information(): array
|
||||
{
|
||||
return $this->messages(DocumentFinding::INFO);
|
||||
}
|
||||
|
||||
/**
|
||||
* The automatic run sends only a document without blockers and without anything the landlord has to confirm.
|
||||
*/
|
||||
public function canSendAutomatically(): bool
|
||||
{
|
||||
return $this->blockers() === [] && $this->toConfirm() === [];
|
||||
}
|
||||
|
||||
/**
|
||||
* By hand: no blockers, and every point to confirm was confirmed.
|
||||
*/
|
||||
public function canSendByHand(bool $acknowledged): bool
|
||||
{
|
||||
return $this->blockers() === [] && ($this->toConfirm() === [] || $acknowledged);
|
||||
}
|
||||
|
||||
/**
|
||||
* The template as the landlord reads it.
|
||||
*/
|
||||
public function templateLabel(): string
|
||||
{
|
||||
if ($this->terms !== null && isset($this->terms['template']['name'])) {
|
||||
return $this->terms['template']['name'].' (Version '.$this->terms['template']['version'].')';
|
||||
}
|
||||
|
||||
return $this->template?->label() ?? 'Texte der Webseite';
|
||||
}
|
||||
|
||||
/**
|
||||
* What is stored about the document in the case history.
|
||||
*
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
public function record(): array
|
||||
{
|
||||
return [
|
||||
'kind' => $this->kind->value,
|
||||
'template' => $this->terms['template'] ?? null,
|
||||
'annexes' => array_map(fn (array $annex): string => $annex['label'], $this->annexes),
|
||||
'recipient' => $this->recipientEmail(),
|
||||
'total' => $this->draft->total,
|
||||
'price_source' => $this->priceSource,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* @param list<string> $except
|
||||
* @return list<string>
|
||||
*/
|
||||
private function messages(string $severity, array $except = []): array
|
||||
{
|
||||
return array_values(array_map(fn (DocumentFinding $finding): string => $finding->message, array_filter($this->findings, fn (DocumentFinding $finding): bool => $finding->severity === $severity && ! in_array($finding->code, $except, true))));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,41 @@
|
||||
<?php
|
||||
|
||||
namespace App\Documents;
|
||||
|
||||
/**
|
||||
* One finding of a document composition. A blocker stops the document (data missing or contradictory); a point to
|
||||
* confirm stops the automatic run and needs the landlord's explicit confirmation before sending by hand; information
|
||||
* only explains.
|
||||
*/
|
||||
final class DocumentFinding
|
||||
{
|
||||
public const BLOCKER = 'blocker';
|
||||
|
||||
public const CONFIRM = 'confirm';
|
||||
|
||||
public const INFO = 'info';
|
||||
|
||||
/** Code of the finding "the settings reserve nothing for requests" (Hold = 0, package 7). */
|
||||
public const HOLD_ZERO = 'hold_zero';
|
||||
|
||||
public function __construct(
|
||||
public readonly string $severity,
|
||||
public readonly string $message,
|
||||
public readonly ?string $code = null,
|
||||
) {}
|
||||
|
||||
public static function blocker(string $message): self
|
||||
{
|
||||
return new self(self::BLOCKER, $message);
|
||||
}
|
||||
|
||||
public static function confirm(string $message, ?string $code = null): self
|
||||
{
|
||||
return new self(self::CONFIRM, $message, $code);
|
||||
}
|
||||
|
||||
public static function info(string $message): self
|
||||
{
|
||||
return new self(self::INFO, $message);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,54 @@
|
||||
<?php
|
||||
|
||||
namespace App\Documents;
|
||||
|
||||
use App\Enums\DocumentKind;
|
||||
use App\Models\Tenant;
|
||||
use App\Support\Settings;
|
||||
|
||||
/**
|
||||
* Which document kinds the landlord has released for guests (tenants.document_releases). A kind that is not released is
|
||||
* a working draft: it is never sent automatically, and by hand only after an explicit confirmation in the case.
|
||||
*/
|
||||
class DocumentReleases
|
||||
{
|
||||
public static function isReleased(DocumentKind $kind, ?Tenant $tenant = null): bool
|
||||
{
|
||||
$entry = self::entries($tenant)[$kind->value] ?? null;
|
||||
|
||||
return is_array($entry) ? (bool) ($entry['released'] ?? false) : $kind->releasedByDefault();
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array{released: bool, by: ?string, at: ?string}|null the landlord's decision, null when none was made
|
||||
*/
|
||||
public static function decision(DocumentKind $kind, ?Tenant $tenant = null): ?array
|
||||
{
|
||||
$entry = self::entries($tenant)[$kind->value] ?? null;
|
||||
|
||||
return is_array($entry) ? ['released' => (bool) ($entry['released'] ?? false), 'by' => $entry['by'] ?? null, 'at' => $entry['at'] ?? null] : null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Stores the decision for one kind; an unchanged decision keeps its date and author.
|
||||
*/
|
||||
public static function set(DocumentKind $kind, bool $released, string $actor, ?Tenant $tenant = null): void
|
||||
{
|
||||
$tenant ??= Settings::tenant();
|
||||
if ($tenant === null || self::isReleased($kind, $tenant) === $released && self::decision($kind, $tenant) !== null) {
|
||||
return;
|
||||
}
|
||||
|
||||
$entries = self::entries($tenant);
|
||||
$entries[$kind->value] = ['released' => $released, 'by' => $actor, 'at' => now()->toIso8601String()];
|
||||
$tenant->update(['document_releases' => $entries]);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
private static function entries(?Tenant $tenant): array
|
||||
{
|
||||
return (array) (($tenant ?? Settings::tenant())?->document_releases ?? []);
|
||||
}
|
||||
}
|
||||
@@ -2,10 +2,10 @@
|
||||
|
||||
namespace App\Documents;
|
||||
|
||||
use App\Enums\ChannelBookingModel;
|
||||
use App\Models\Booking;
|
||||
use App\Models\ContractAnnex;
|
||||
use App\Models\ContractTemplate;
|
||||
use App\Process\ProcessSettings;
|
||||
use App\Support\Content;
|
||||
use Filament\Forms\Components\RichEditor\RichContentRenderer;
|
||||
use Illuminate\Support\HtmlString;
|
||||
@@ -56,16 +56,12 @@ public static function capture(?ContractTemplate $template = null, ?Booking $boo
|
||||
}
|
||||
|
||||
/**
|
||||
* The contract template for a booking: chosen explicitly, else the portal's (for bookings that are binding at the
|
||||
* portal its reservation template, otherwise its offer template), else the property's.
|
||||
* The contract template for a case: chosen explicitly, else the one of its process settings – the channel's
|
||||
* template for the case's intake kind (request or binding booking), else the property's, else the landlord's.
|
||||
*/
|
||||
public static function templateFor(Booking $booking, int|string|null $explicitId = null): ?ContractTemplate
|
||||
{
|
||||
$channel = $booking->importChannel ?? $booking->originChannel;
|
||||
$portalId = $channel === null ? null : ($channel->booking_model === ChannelBookingModel::PortalBooking
|
||||
? ($channel->contract_template_reservation_id ?? $channel->contract_template_id)
|
||||
: $channel->contract_template_id);
|
||||
$id = filled($explicitId) ? (int) $explicitId : ($portalId ?? $booking->property->contract_template_id);
|
||||
$id = filled($explicitId) ? (int) $explicitId : app(ProcessSettings::class)->forBooking($booking)->contractTemplateId();
|
||||
|
||||
return $id ? ContractTemplate::query()->find($id) : null;
|
||||
}
|
||||
|
||||
@@ -2,50 +2,73 @@
|
||||
|
||||
namespace App\Documents;
|
||||
|
||||
use App\Enums\DocumentKind;
|
||||
use App\Models\Booking;
|
||||
use App\Models\Site;
|
||||
use Barryvdh\DomPDF\Facade\Pdf;
|
||||
use Illuminate\Support\Facades\Storage;
|
||||
|
||||
/**
|
||||
* The rental contract as PDF. As a draft it is part of the offer (offer_path, one file per offer version);
|
||||
* the final contract is generated at confirmation (contract_path). Both are stored, so later changes of
|
||||
* texts or prices do not alter a document the guest already received.
|
||||
* The PDF of a case's document. As a draft it is part of the offer (offer_path, one file per offer version); the
|
||||
* document of record – rental contract, booking documentation of a portal booking or stay confirmation, depending on
|
||||
* the case – is generated once when it is sent (contract_path). Both are stored, so later changes of texts or prices do
|
||||
* not alter a document the guest already received.
|
||||
*/
|
||||
class RentalContract
|
||||
{
|
||||
private const DISK = 'local';
|
||||
|
||||
public function generate(Booking $booking, bool $draft = false): string
|
||||
public function generate(Booking $booking, bool $draft = false, ?DocumentKind $kind = null): string
|
||||
{
|
||||
$booking->loadMissing(['guest', 'property']);
|
||||
$kind = $draft ? DocumentKind::Offer : ($kind ?? DocumentKind::forCase($booking) ?? DocumentKind::Confirmation);
|
||||
$filename = $draft
|
||||
? "contracts/Angebot-{$booking->reference}-v{$booking->offer_version}.pdf"
|
||||
: "contracts/Mietvertrag-{$booking->reference}.pdf";
|
||||
$path = "contracts/tenants/{$booking->tenant_id}/bookings/{$booking->id}/".basename($filename);
|
||||
? "Angebot-{$booking->reference}-v{$booking->offer_version}.pdf"
|
||||
: "{$kind->fileName()}-{$booking->reference}.pdf";
|
||||
$path = "contracts/tenants/{$booking->tenant_id}/bookings/{$booking->id}/{$filename}";
|
||||
|
||||
// The logo is embedded as a file: the PDF is rendered on the server and must not depend on
|
||||
// fetching anything over the network. Each website has its own (A14).
|
||||
$logo = $booking->website()?->brandPath(Site::BRAND_DOCUMENT_LOGO);
|
||||
|
||||
// The final contract is a document of record: once stored it is never rewritten (confirmation resends reuse it).
|
||||
// The document of record is never rewritten once stored (confirmation resends reuse it).
|
||||
if (! $draft && $booking->contract_path !== null && Storage::disk(self::DISK)->exists($booking->contract_path)) {
|
||||
return $booking->contract_path;
|
||||
}
|
||||
|
||||
$document = OfferTerms::document($booking);
|
||||
$pdf = Pdf::loadView($document !== null ? 'pdf.contract-document' : 'pdf.contract', [
|
||||
'booking' => $booking,
|
||||
'draft' => $draft,
|
||||
'logo' => $logo,
|
||||
'document' => $document,
|
||||
])->setPaper('a4')->output();
|
||||
$pdf = $this->render($booking, $kind, $draft);
|
||||
Storage::disk(self::DISK)->put($path, $pdf);
|
||||
$booking->update([$draft ? 'offer_path' : 'contract_path' => $path, $draft ? 'offer_pdf_sha256' : 'contract_pdf_sha256' => hash('sha256', $pdf)]);
|
||||
|
||||
return $path;
|
||||
}
|
||||
|
||||
/**
|
||||
* The PDF bytes of a document, without storing anything (also used for previews of a composition).
|
||||
*/
|
||||
public function render(Booking $booking, DocumentKind $kind, bool $draft = false): string
|
||||
{
|
||||
[$view, $data] = $this->view($booking, $kind, $draft);
|
||||
|
||||
return Pdf::loadView($view, $data)->setPaper('a4')->output();
|
||||
}
|
||||
|
||||
/**
|
||||
* The view and its data that make up the document.
|
||||
*
|
||||
* @return array{0: string, 1: array<string, mixed>}
|
||||
*/
|
||||
public function view(Booking $booking, DocumentKind $kind, bool $draft = false): array
|
||||
{
|
||||
// The logo is embedded as a file: the PDF is rendered on the server and must not depend on
|
||||
// fetching anything over the network. Each website has its own (A14).
|
||||
$logo = $booking->website()?->brandPath(Site::BRAND_DOCUMENT_LOGO);
|
||||
$document = $kind === DocumentKind::StayConfirmation ? null : OfferTerms::document($booking);
|
||||
$view = match (true) {
|
||||
$kind === DocumentKind::StayConfirmation => 'pdf.stay-confirmation',
|
||||
$document !== null => 'pdf.contract-document',
|
||||
default => 'pdf.contract',
|
||||
};
|
||||
|
||||
return [$view, ['booking' => $booking, 'draft' => $draft, 'logo' => $logo, 'document' => $document, 'kind' => $kind]];
|
||||
}
|
||||
|
||||
public function absolutePath(Booking $booking, bool $draft = false): ?string
|
||||
{
|
||||
$path = $draft ? $booking->offer_path : $booking->contract_path;
|
||||
|
||||
@@ -0,0 +1,65 @@
|
||||
<?php
|
||||
|
||||
namespace App\Enums;
|
||||
|
||||
use Filament\Support\Contracts\HasColor;
|
||||
use Filament\Support\Contracts\HasLabel;
|
||||
|
||||
/**
|
||||
* Where an activity of a case stands (docs/Prozessarchitektur/Querschnitt/Gates_und_Nachweise.md: done by us, done
|
||||
* externally, not applicable, open, contradictory) – plus "waiting" for somebody else and "later" for what is not due.
|
||||
*/
|
||||
enum ActivityState: string implements HasColor, HasLabel
|
||||
{
|
||||
case Done = 'done';
|
||||
case External = 'external';
|
||||
case Open = 'open';
|
||||
case Problem = 'problem';
|
||||
case Waiting = 'waiting';
|
||||
case Later = 'later';
|
||||
case NotApplicable = 'not_applicable';
|
||||
|
||||
public function getLabel(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::Done => 'erledigt',
|
||||
self::External => 'übernimmt das Portal',
|
||||
self::Open => 'zu tun',
|
||||
self::Problem => 'Problem',
|
||||
self::Waiting => 'wartet',
|
||||
self::Later => 'später',
|
||||
self::NotApplicable => 'entfällt',
|
||||
};
|
||||
}
|
||||
|
||||
public function getColor(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::Done, self::External => 'success',
|
||||
self::Open => 'warning',
|
||||
self::Problem => 'danger',
|
||||
self::Waiting => 'info',
|
||||
self::Later, self::NotApplicable => 'gray',
|
||||
};
|
||||
}
|
||||
|
||||
public function icon(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::Done, self::External => '✓',
|
||||
self::Open => '●',
|
||||
self::Problem => '!',
|
||||
self::Waiting => '…',
|
||||
self::Later => '○',
|
||||
self::NotApplicable => '–',
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether the landlord has to act.
|
||||
*/
|
||||
public function needsAction(): bool
|
||||
{
|
||||
return $this === self::Open || $this === self::Problem;
|
||||
}
|
||||
}
|
||||
@@ -2,14 +2,12 @@
|
||||
|
||||
namespace App\Enums;
|
||||
|
||||
use App\Filament\Pages\Dashboard;
|
||||
use App\Filament\Pages\OccupancyCalendar;
|
||||
use App\Filament\Pages\PricesAndOffers;
|
||||
use App\Filament\Resources\BlockedPeriods\BlockedPeriodResource;
|
||||
use App\Filament\Resources\Bookings\BookingResource;
|
||||
use App\Filament\Resources\BookingTasks\BookingTaskResource;
|
||||
use App\Filament\Resources\ChannelTasks\ChannelTaskResource;
|
||||
use App\Filament\Resources\Guests\GuestResource;
|
||||
use App\Filament\Resources\InboxMessages\InboxMessageResource;
|
||||
use Filament\Support\Contracts\HasDescription;
|
||||
use Filament\Support\Contracts\HasLabel;
|
||||
|
||||
@@ -22,16 +20,15 @@ enum AdminMode: string implements HasDescription, HasLabel
|
||||
case Expert = 'expert';
|
||||
|
||||
/**
|
||||
* Menu entries of the simple mode: the few things needed every day: calendar, bookings with their file, tasks, mailbox, guests and prices.
|
||||
* Menu entries of the simple mode: the start page with everything to do, calendar, cases, guests, blocked periods
|
||||
* and prices. Tasks, portal tasks and the mailbox are part of the start page's work list.
|
||||
*
|
||||
* @var list<class-string>
|
||||
*/
|
||||
public const SIMPLE_NAVIGATION = [
|
||||
Dashboard::class,
|
||||
OccupancyCalendar::class,
|
||||
BookingResource::class,
|
||||
BookingTaskResource::class,
|
||||
ChannelTaskResource::class,
|
||||
InboxMessageResource::class,
|
||||
GuestResource::class,
|
||||
BlockedPeriodResource::class,
|
||||
PricesAndOffers::class,
|
||||
@@ -48,7 +45,7 @@ public function getLabel(): string
|
||||
public function getDescription(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::Simple => 'Das Tägliche: Postfach, Anfragen, Buchungen und Verträge, Sperrzeiten, Preise & Angebote, Gäste, Kalenderabgleich (iCal), Portal-Aufgaben, Bewertungen, Fotos',
|
||||
self::Simple => 'Das Tägliche: Start mit allem, was zu tun ist, Kalender, Vorgänge, Gäste, Sperrzeiten, Preise',
|
||||
self::Expert => 'Alle Einstellungen: Preise, Angebote, Kalenderabgleich (iCal), Webseite, System',
|
||||
};
|
||||
}
|
||||
|
||||
@@ -16,6 +16,7 @@ enum BookingTaskKind: string implements HasLabel
|
||||
case BalanceReminder = 'balance_reminder';
|
||||
case CancellationRequest = 'cancellation_request';
|
||||
case CancellationFee = 'cancellation_fee';
|
||||
case PortalCancellation = 'portal_cancellation';
|
||||
|
||||
public function getLabel(): string
|
||||
{
|
||||
@@ -25,12 +26,13 @@ public function getLabel(): string
|
||||
self::BalanceReminder => 'Restzahlung überfällig – anmahnen',
|
||||
self::CancellationRequest => 'Stornierungswunsch des Gastes',
|
||||
self::CancellationFee => 'Stornokosten prüfen und abrechnen',
|
||||
self::PortalCancellation => 'Stornierung im Portal veranlassen bzw. prüfen',
|
||||
};
|
||||
}
|
||||
|
||||
public function isPayment(): bool
|
||||
{
|
||||
return ! in_array($this, [self::CancellationRequest, self::CancellationFee], true);
|
||||
return ! in_array($this, [self::CancellationRequest, self::CancellationFee, self::PortalCancellation], true);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -44,7 +46,7 @@ public function reminder(): ?array
|
||||
self::DepositReminder => [PaymentReminder::DEPOSIT_OVERDUE, 'deposit_reminded_at'],
|
||||
self::BalanceRequest => [PaymentReminder::BALANCE_REQUEST, 'balance_requested_at'],
|
||||
self::BalanceReminder => [PaymentReminder::BALANCE_OVERDUE, 'balance_reminded_at'],
|
||||
self::CancellationRequest, self::CancellationFee => null,
|
||||
self::CancellationRequest, self::CancellationFee, self::PortalCancellation => null,
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,60 @@
|
||||
<?php
|
||||
|
||||
namespace App\Enums;
|
||||
|
||||
use Filament\Support\Contracts\HasDescription;
|
||||
use Filament\Support\Contracts\HasLabel;
|
||||
|
||||
/**
|
||||
* The business constellation of a case (docs/Prozessarchitektur/01_Buchungsarchetypen.md). It follows from the way
|
||||
* the case came in and who handles what – not from the channel's name alone.
|
||||
*/
|
||||
enum CaseType: string implements HasDescription, HasLabel
|
||||
{
|
||||
/** Own website or own direct way (phone, e-mail): request, own offer, acceptance. */
|
||||
case A1 = 'a1';
|
||||
|
||||
/** Non-binding request passed on by an intermediary; own offer like A1. */
|
||||
case A2 = 'a2';
|
||||
|
||||
/** Binding external booking, everything else is handled by the landlord. */
|
||||
case A3 = 'a3';
|
||||
|
||||
/** Binding external booking with split handling (e.g. the portal collects the payments). */
|
||||
case A4 = 'a4';
|
||||
|
||||
/** Binding external booking the portal handles almost completely. */
|
||||
case A5 = 'a5';
|
||||
|
||||
/** Own use, private stay, maintenance or another block. */
|
||||
case A6 = 'a6';
|
||||
|
||||
public function getLabel(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::A1 => 'Eigene Anfrage',
|
||||
self::A2 => 'Anfrage über ein Portal',
|
||||
self::A3 => 'Portalbuchung, Abwicklung bei uns',
|
||||
self::A4 => 'Portalbuchung, Zahlung über das Portal',
|
||||
self::A5 => 'Portalbuchung, Abwicklung durch das Portal',
|
||||
self::A6 => 'Eigene Nutzung / Sperre',
|
||||
};
|
||||
}
|
||||
|
||||
public function getDescription(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::A1 => 'Anfrage → Angebot → Annahme durch den Gast',
|
||||
self::A2 => 'Anfrage aus einem Portal, Angebot und Vertrag von uns',
|
||||
self::A3 => 'Beim Portal schon verbindlich; Unterlagen, Zahlung und Gastkontakt übernehmen wir',
|
||||
self::A4 => 'Beim Portal schon verbindlich; Unterlagen von uns, das Geld zieht das Portal ein',
|
||||
self::A5 => 'Beim Portal schon verbindlich; das Portal erledigt Vertrag und Zahlung',
|
||||
self::A6 => 'Eigenbelegung, private Überlassung, Wartung oder sonstige Sperre',
|
||||
};
|
||||
}
|
||||
|
||||
public function isExternallyBinding(): bool
|
||||
{
|
||||
return in_array($this, [self::A3, self::A4, self::A5], true);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,121 @@
|
||||
<?php
|
||||
|
||||
namespace App\Enums;
|
||||
|
||||
use App\Models\Booking;
|
||||
use Filament\Support\Contracts\HasLabel;
|
||||
|
||||
/**
|
||||
* The kinds of documents a case can produce (UMSETZUNGSPLAN_v0.10 §5.4). Which one a case needs follows from its case
|
||||
* type, never from a choice of the landlord: a request gets a binding offer, a booking we made ourselves gets the
|
||||
* confirmation with the rental contract, a booking that is already binding on a portal gets the booking documentation
|
||||
* without an acceptance link (E-004). Information "unter Vorbehalt" (package 7) and the stay confirmation of A6
|
||||
* (package 6) are prepared as working drafts but cannot be sent yet.
|
||||
*/
|
||||
enum DocumentKind: string implements HasLabel
|
||||
{
|
||||
case Offer = 'offer';
|
||||
case Information = 'information';
|
||||
case Confirmation = 'confirmation';
|
||||
case ExternalRecord = 'external_record';
|
||||
case StayConfirmation = 'stay_confirmation';
|
||||
case Internal = 'internal';
|
||||
|
||||
public function getLabel(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::Offer => 'Angebot mit Annahmelink',
|
||||
self::Information => 'Auskunft unter Vorbehalt',
|
||||
self::Confirmation => 'Buchungsbestätigung mit Mietvertrag',
|
||||
self::ExternalRecord => 'Buchungsunterlagen (beim Portal gebucht)',
|
||||
self::StayConfirmation => 'Aufenthaltsbestätigung (privat)',
|
||||
self::Internal => 'Nur intern, kein Dokument an Gäste',
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* What the landlord reads about this kind on the settings page.
|
||||
*/
|
||||
public function description(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::Offer => 'Für Anfragen: Preis, Vertragsentwurf und ein Link, mit dem der Gast verbindlich annimmt.',
|
||||
self::Information => 'Für Anfragen ohne Reservierung: Preis und Verfügbarkeit ohne Zusage; der Gast kann die Buchung anfragen. Folgt mit Paket 7.',
|
||||
self::Confirmation => 'Nach der Annahme eines Angebots oder einer direkt vereinbarten Buchung: Bestätigung mit dem Mietvertrag.',
|
||||
self::ExternalRecord => 'Für Buchungen, die beim Portal bereits verbindlich sind: Buchungsdaten und – falls hinterlegt – Ihre Vorlage, ohne erneute Annahme durch den Gast.',
|
||||
self::StayConfirmation => 'Für private Überlassungen (Familie, Freunde): Bestätigung des Aufenthalts ohne Mietvertrag. Folgt mit Paket 6.',
|
||||
self::Internal => 'Eigennutzung und Wartung: kein Dokument an Gäste.',
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* The document a case needs at its current stage, or null when nobody needs one from us (e.g. the portal sends it).
|
||||
*/
|
||||
public static function forCase(Booking $booking): ?self
|
||||
{
|
||||
$profile = $booking->process();
|
||||
|
||||
return match (true) {
|
||||
$booking->intake === IntakeKind::Internal => $booking->guest_id !== null ? self::StayConfirmation : self::Internal,
|
||||
$booking->caseType()->isExternallyBinding() => $profile->documents() === Responsibility::Portal ? null : self::ExternalRecord,
|
||||
$booking->isBinding() => $profile->documents() === Responsibility::Portal ? null : self::Confirmation,
|
||||
default => self::Offer,
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether the guest makes the contract by accepting this document (only the offer carries an acceptance link).
|
||||
*/
|
||||
public function hasAcceptanceLink(): bool
|
||||
{
|
||||
return $this === self::Offer;
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether a rental contract is part of this document.
|
||||
*/
|
||||
public function containsContract(): bool
|
||||
{
|
||||
return in_array($this, [self::Offer, self::Confirmation, self::ExternalRecord], true);
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether this kind can be sent with the current packages (the others exist as working drafts only).
|
||||
*/
|
||||
public function isAvailable(): bool
|
||||
{
|
||||
return in_array($this, [self::Offer, self::Confirmation, self::ExternalRecord], true);
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether the texts of this kind count as released while the landlord has not decided otherwise: the offer and the
|
||||
* confirmation are the documents in use since the start; every new kind starts as a working draft.
|
||||
*/
|
||||
public function releasedByDefault(): bool
|
||||
{
|
||||
return in_array($this, [self::Offer, self::Confirmation], true);
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether this kind goes to guests at all.
|
||||
*/
|
||||
public function isForGuests(): bool
|
||||
{
|
||||
return $this !== self::Internal;
|
||||
}
|
||||
|
||||
/**
|
||||
* File name prefix of the stored PDF.
|
||||
*/
|
||||
public function fileName(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::Offer => 'Angebot',
|
||||
self::Information => 'Auskunft',
|
||||
self::Confirmation => 'Mietvertrag',
|
||||
self::ExternalRecord => 'Buchungsunterlagen',
|
||||
self::StayConfirmation => 'Aufenthaltsbestaetigung',
|
||||
self::Internal => 'Intern',
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,30 @@
|
||||
<?php
|
||||
|
||||
namespace App\Enums;
|
||||
|
||||
use Filament\Support\Contracts\HasLabel;
|
||||
|
||||
/**
|
||||
* How a case arrived – the "Eingangsart". Settings of a channel may differ per intake kind, because one portal can
|
||||
* deliver both mere requests and bookings that are already binding.
|
||||
*/
|
||||
enum IntakeKind: string implements HasLabel
|
||||
{
|
||||
/** A request that is not binding yet (own website, phone, a portal passing on a request). */
|
||||
case Inquiry = 'inquiry';
|
||||
|
||||
/** A booking that is already binding when it reaches us (made on a portal). */
|
||||
case Booking = 'booking';
|
||||
|
||||
/** An internal occasion: own use, private stay, maintenance, block. */
|
||||
case Internal = 'internal';
|
||||
|
||||
public function getLabel(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::Inquiry => 'Anfrage',
|
||||
self::Booking => 'Verbindliche Buchung',
|
||||
self::Internal => 'Eigene Nutzung / Sperre',
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,107 @@
|
||||
<?php
|
||||
|
||||
namespace App\Enums;
|
||||
|
||||
/**
|
||||
* The settings that shape how a case is handled. Each one has a built-in default; the landlord sets his own default,
|
||||
* a property (expert area) and a channel per intake kind may deviate. A value that is not set inherits – a deliberately
|
||||
* set 0, "no" or "manual" is a value of its own.
|
||||
*/
|
||||
enum ProcessSetting: string
|
||||
{
|
||||
case Processing = 'processing';
|
||||
case PreReservation = 'pre_reservation';
|
||||
case HoldHours = 'hold_hours';
|
||||
case Documents = 'documents';
|
||||
case Payments = 'payments';
|
||||
case GuestMessages = 'guest_messages';
|
||||
case ArrivalInfoDaysBefore = 'arrival_info_days_before';
|
||||
case ContractTemplate = 'contract_template_id';
|
||||
|
||||
/**
|
||||
* Built-in default (the behaviour before any landlord setting existed).
|
||||
*/
|
||||
public function default(): string|int|bool|null
|
||||
{
|
||||
return match ($this) {
|
||||
self::Processing => ProcessingMode::Manual->value,
|
||||
self::PreReservation => true,
|
||||
self::HoldHours => 48,
|
||||
self::Documents, self::Payments, self::GuestMessages => Responsibility::Landlord->value,
|
||||
self::ArrivalInfoDaysBefore => 3,
|
||||
self::ContractTemplate => null,
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* The question shown to the landlord, in plain words.
|
||||
*/
|
||||
public function question(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::Processing => 'Wie sollen neue Vorgänge bearbeitet werden?',
|
||||
self::PreReservation => 'Soll eine Anfrage den Zeitraum im Kalender reservieren?',
|
||||
self::HoldHours => 'Wie lange gilt ein Angebot (und bleibt der Zeitraum reserviert)?',
|
||||
self::Documents => 'Wer schickt dem Gast Vertrag bzw. Buchungsunterlagen?',
|
||||
self::Payments => 'Wer kümmert sich um die Zahlungen des Gastes?',
|
||||
self::GuestMessages => 'Wer schickt dem Gast Anreise-Informationen und die Bitte um eine Bewertung?',
|
||||
self::ArrivalInfoDaysBefore => 'Wann gehen die Anreise-Informationen an den Gast?',
|
||||
self::ContractTemplate => 'Welche Vertragsvorlage wird verwendet?',
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Intake kinds for which a channel may deviate (empty: landlord and property level only).
|
||||
*
|
||||
* @return list<IntakeKind>
|
||||
*/
|
||||
public function channelIntakes(): array
|
||||
{
|
||||
return match ($this) {
|
||||
self::Processing, self::Payments, self::GuestMessages, self::ContractTemplate => [IntakeKind::Inquiry, IntakeKind::Booking],
|
||||
self::PreReservation, self::HoldHours => [IntakeKind::Inquiry],
|
||||
self::Documents => [IntakeKind::Booking],
|
||||
self::ArrivalInfoDaysBefore => [],
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether the landlord sets this on his general settings page (the template is chosen per property or channel).
|
||||
*/
|
||||
public function isLandlordSetting(): bool
|
||||
{
|
||||
return $this !== self::ContractTemplate;
|
||||
}
|
||||
|
||||
/**
|
||||
* Normalises a stored or submitted value; null means "not set".
|
||||
*/
|
||||
public function normalize(mixed $value): string|int|bool|null
|
||||
{
|
||||
if ($value === null || $value === '') {
|
||||
return null;
|
||||
}
|
||||
|
||||
return match ($this) {
|
||||
self::Processing => ($value instanceof ProcessingMode ? $value : ProcessingMode::tryFrom((string) $value))?->value,
|
||||
self::Documents, self::Payments, self::GuestMessages => ($value instanceof Responsibility ? $value : Responsibility::tryFrom((string) $value))?->value,
|
||||
self::PreReservation => filter_var($value, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE),
|
||||
self::HoldHours, self::ArrivalInfoDaysBefore, self::ContractTemplate => is_numeric($value) ? (int) $value : null,
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* The value in plain words, for showing where a value comes from.
|
||||
*/
|
||||
public function describe(string|int|bool|null $value): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::Processing => ProcessingMode::tryFrom((string) $value)?->getLabel() ?? '–',
|
||||
self::Documents, self::Payments, self::GuestMessages => Responsibility::tryFrom((string) $value)?->getLabel() ?? '–',
|
||||
self::PreReservation => $value ? 'ja' : 'nein',
|
||||
self::HoldHours => $value.' Stunden',
|
||||
self::ArrivalInfoDaysBefore => $value.' Tage vor Anreise',
|
||||
self::ContractTemplate => $value === null ? 'Texte der Webseite' : 'Vorlage Nr. '.$value,
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,28 @@
|
||||
<?php
|
||||
|
||||
namespace App\Enums;
|
||||
|
||||
use Filament\Support\Contracts\HasLabel;
|
||||
|
||||
/**
|
||||
* Whether the system carries a case on by itself as far as the data allows, or prepares each step and waits for
|
||||
* the landlord's release.
|
||||
*/
|
||||
enum ProcessingMode: string implements HasLabel
|
||||
{
|
||||
case Automatic = 'automatic';
|
||||
case Manual = 'manual';
|
||||
|
||||
public function getLabel(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::Automatic => 'Automatisch weiterbearbeiten',
|
||||
self::Manual => 'Jeden Schritt selbst freigeben',
|
||||
};
|
||||
}
|
||||
|
||||
public static function fromOfferMode(OfferMode $mode): self
|
||||
{
|
||||
return $mode === OfferMode::Automatic ? self::Automatic : self::Manual;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,22 @@
|
||||
<?php
|
||||
|
||||
namespace App\Enums;
|
||||
|
||||
use Filament\Support\Contracts\HasLabel;
|
||||
|
||||
/**
|
||||
* Who takes care of a part of the handling: the landlord (with this system) or the portal.
|
||||
*/
|
||||
enum Responsibility: string implements HasLabel
|
||||
{
|
||||
case Landlord = 'landlord';
|
||||
case Portal = 'portal';
|
||||
|
||||
public function getLabel(): string
|
||||
{
|
||||
return match ($this) {
|
||||
self::Landlord => 'Wir',
|
||||
self::Portal => 'Das Portal',
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,110 @@
|
||||
<?php
|
||||
|
||||
namespace App\Filament\Forms;
|
||||
|
||||
use App\Documents\DocumentComposer;
|
||||
use App\Documents\DocumentComposition;
|
||||
use App\Documents\RentalContract;
|
||||
use App\Enums\AdminMode;
|
||||
use App\Enums\DocumentKind;
|
||||
use App\Mail\BookingConfirmed;
|
||||
use App\Mail\BookingDocumentation;
|
||||
use App\Mail\OfferMade;
|
||||
use App\Models\Booking;
|
||||
use App\Models\User;
|
||||
use Closure;
|
||||
use Filament\Forms\Components\Checkbox;
|
||||
use Filament\Schemas\Components\Utilities\Get;
|
||||
use Filament\Schemas\Components\View;
|
||||
use Throwable;
|
||||
|
||||
/**
|
||||
* The composition of a document inside an action modal: the same picture for offer, confirmation and booking
|
||||
* documentation, recalculated whenever the landlord adjusts something, plus the explicit confirmation that is
|
||||
* required when there is something to check.
|
||||
*/
|
||||
class DocumentCompositionFields
|
||||
{
|
||||
/** @var array<string, DocumentComposition> */
|
||||
private static array $compositions = [];
|
||||
|
||||
/**
|
||||
* @param Closure(Get): array<string, mixed> $changes the adjustments currently in the form
|
||||
* @return list<View|Checkbox>
|
||||
*/
|
||||
public static function make(Booking $booking, DocumentKind $kind, Closure $changes, ?Closure $visible = null): array
|
||||
{
|
||||
$compose = fn (Get $get): DocumentComposition => self::compose($booking, $kind, $changes($get));
|
||||
|
||||
return [
|
||||
View::make('filament.document-composition')
|
||||
->viewData(fn (Get $get): array => self::viewData($compose($get), $changes($get))),
|
||||
Checkbox::make('acknowledged')
|
||||
->label('Ich habe die Hinweise geprüft und möchte das Dokument so senden.')
|
||||
->visible(fn (Get $get): bool => ($visible === null || $visible($get)) && $compose($get)->toConfirm() !== [])
|
||||
->accepted(),
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* One composition per form state and request (the view and the confirmation box both need it).
|
||||
*
|
||||
* @param array<string, mixed> $changes
|
||||
*/
|
||||
public static function compose(Booking $booking, DocumentKind $kind, array $changes): DocumentComposition
|
||||
{
|
||||
$key = $booking->id.':'.$kind->value.':'.md5(serialize($changes)).':'.$booking->updated_at?->getTimestamp();
|
||||
|
||||
return self::$compositions[$key] ??= app(DocumentComposer::class)->compose($booking, $kind, $changes);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $changes
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
private static function viewData(DocumentComposition $composition, array $changes): array
|
||||
{
|
||||
$user = auth()->user();
|
||||
|
||||
return [
|
||||
'composition' => $composition,
|
||||
'expert' => $user instanceof User && $user->adminMode() === AdminMode::Expert,
|
||||
'mailPreview' => self::mailPreview($composition),
|
||||
'documentPreview' => self::documentPreview($composition),
|
||||
'pdfUrl' => route('filament.admin.document-preview', ['booking' => $composition->draft->getRouteKey(), 'kind' => $composition->kind->value, 'changes' => base64_encode(json_encode($changes) ?: '[]')]),
|
||||
];
|
||||
}
|
||||
|
||||
private static function mailPreview(DocumentComposition $composition): string
|
||||
{
|
||||
$draft = $composition->draft;
|
||||
if ($draft->guest === null) {
|
||||
return '<p style="font-family:sans-serif">Keine Vorschau: Der Gast ist noch nicht bekannt.</p>';
|
||||
}
|
||||
|
||||
try {
|
||||
return match ($composition->kind) {
|
||||
DocumentKind::Offer => (new OfferMade($draft, '#'))->render(),
|
||||
DocumentKind::ExternalRecord => (new BookingDocumentation($draft))->render(),
|
||||
default => (new BookingConfirmed($draft))->render(),
|
||||
};
|
||||
} catch (Throwable $exception) {
|
||||
report($exception);
|
||||
|
||||
return '<p style="font-family:sans-serif">Die Vorschau der E-Mail ist gerade nicht möglich.</p>';
|
||||
}
|
||||
}
|
||||
|
||||
private static function documentPreview(DocumentComposition $composition): string
|
||||
{
|
||||
try {
|
||||
[$view, $data] = app(RentalContract::class)->view($composition->draft, $composition->kind, draft: $composition->kind === DocumentKind::Offer);
|
||||
|
||||
return view($view, $data)->render();
|
||||
} catch (Throwable $exception) {
|
||||
report($exception);
|
||||
|
||||
return '<p style="font-family:sans-serif">Die Vorschau des Dokuments ist gerade nicht möglich.</p>';
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,77 @@
|
||||
<?php
|
||||
|
||||
namespace App\Filament\Forms;
|
||||
|
||||
use App\Enums\ProcessingMode;
|
||||
use App\Enums\ProcessSetting;
|
||||
use App\Enums\Responsibility;
|
||||
use App\Models\ContractTemplate;
|
||||
use Filament\Forms\Components\Field;
|
||||
use Filament\Forms\Components\Select;
|
||||
use Filament\Forms\Components\TextInput;
|
||||
|
||||
/**
|
||||
* Form fields of the process settings, asked as plain questions. On a deviation level (property, channel) an empty
|
||||
* field means "as the level above" and the placeholder says which value that is; on the landlord level an empty field
|
||||
* means the built-in default.
|
||||
*/
|
||||
class ProcessSettingFields
|
||||
{
|
||||
/**
|
||||
* @param list<ProcessSetting> $settings
|
||||
* @param callable(ProcessSetting): string $inherited plain-words value used when the field stays empty
|
||||
* @return list<Field>
|
||||
*/
|
||||
public static function make(string $prefix, array $settings, callable $inherited): array
|
||||
{
|
||||
return array_map(fn (ProcessSetting $setting): Field => self::field($prefix.$setting->value, $setting, $inherited($setting)), $settings);
|
||||
}
|
||||
|
||||
public static function field(string $name, ProcessSetting $setting, string $inheritedLabel): Field
|
||||
{
|
||||
$placeholder = 'wie Standard: '.$inheritedLabel;
|
||||
|
||||
return (match ($setting) {
|
||||
ProcessSetting::Processing => Select::make($name)->options(ProcessingMode::class)->placeholder($placeholder)
|
||||
->helperText('Automatisch: Das System sendet Angebote bzw. Unterlagen selbst, sobald alle Angaben da sind. Sonst bereitet es alles vor und Sie geben frei.'),
|
||||
ProcessSetting::PreReservation => Select::make($name)->options(['1' => 'Ja – der Zeitraum ist bis zum Ablauf des Angebots reserviert', '0' => 'Nein – eine Anfrage reserviert nichts'])->placeholder($placeholder),
|
||||
ProcessSetting::HoldHours => TextInput::make($name)->integer()->minValue(1)->maxValue(720)->suffix('Stunden')->placeholder($placeholder),
|
||||
ProcessSetting::Documents, ProcessSetting::Payments, ProcessSetting::GuestMessages => Select::make($name)->options(Responsibility::class)->placeholder($placeholder),
|
||||
ProcessSetting::ArrivalInfoDaysBefore => TextInput::make($name)->integer()->minValue(1)->maxValue(14)->suffix('Tage vor Anreise')->placeholder($placeholder),
|
||||
ProcessSetting::ContractTemplate => Select::make($name)
|
||||
->options(fn (): array => ContractTemplate::query()->orderBy('name')->orderBy('version')->get()->mapWithKeys(fn (ContractTemplate $template): array => [$template->id => $template->label()])->all())
|
||||
->placeholder($placeholder),
|
||||
})->label($setting->question());
|
||||
}
|
||||
|
||||
/**
|
||||
* Normalised values of submitted fields; empty fields are dropped (not set = inherit).
|
||||
*
|
||||
* @param array<string, mixed> $data
|
||||
* @param list<ProcessSetting> $settings
|
||||
* @return array<string, string|int|bool>
|
||||
*/
|
||||
public static function values(array $data, array $settings): array
|
||||
{
|
||||
$values = [];
|
||||
foreach ($settings as $setting) {
|
||||
$value = $setting->normalize($data[$setting->value] ?? null);
|
||||
if ($value !== null) {
|
||||
$values[$setting->value] = $value;
|
||||
}
|
||||
}
|
||||
|
||||
return $values;
|
||||
}
|
||||
|
||||
/**
|
||||
* Stored values as form state (booleans as the select keys).
|
||||
*
|
||||
* @param array<string, mixed> $values
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
public static function state(array $values): array
|
||||
{
|
||||
return array_map(fn (mixed $value): mixed => is_bool($value) ? ($value ? '1' : '0') : $value, $values);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,22 @@
|
||||
<?php
|
||||
|
||||
namespace App\Filament\Pages;
|
||||
|
||||
use App\Filament\Concerns\FollowsAdminMode;
|
||||
use BackedEnum;
|
||||
use Filament\Pages\Dashboard as BaseDashboard;
|
||||
use Filament\Support\Icons\Heroicon;
|
||||
|
||||
/**
|
||||
* The start page: first "Zu erledigen", then the coming stays and key figures.
|
||||
*/
|
||||
class Dashboard extends BaseDashboard
|
||||
{
|
||||
use FollowsAdminMode;
|
||||
|
||||
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedHome;
|
||||
|
||||
protected static ?string $navigationLabel = 'Start';
|
||||
|
||||
protected static ?string $title = 'Start';
|
||||
}
|
||||
@@ -0,0 +1,178 @@
|
||||
<?php
|
||||
|
||||
namespace App\Filament\Pages;
|
||||
|
||||
use App\Documents\DocumentReleases;
|
||||
use App\Enums\DocumentKind;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Enums\ProcessSetting;
|
||||
use App\Enums\UserRole;
|
||||
use App\Filament\Concerns\FollowsAdminMode;
|
||||
use App\Filament\Forms\ProcessSettingFields;
|
||||
use App\Models\Channel;
|
||||
use App\Models\Property;
|
||||
use App\Models\Tenant;
|
||||
use App\Support\Settings;
|
||||
use BackedEnum;
|
||||
use Carbon\CarbonImmutable;
|
||||
use Filament\Actions\Action;
|
||||
use Filament\Forms\Components\Toggle;
|
||||
use Filament\Notifications\Notification;
|
||||
use Filament\Pages\Page;
|
||||
use Filament\Schemas\Components\Actions;
|
||||
use Filament\Schemas\Components\EmbeddedSchema;
|
||||
use Filament\Schemas\Components\Form;
|
||||
use Filament\Schemas\Components\Section;
|
||||
use Filament\Schemas\Components\Text;
|
||||
use Filament\Schemas\Schema;
|
||||
use Filament\Support\Icons\Heroicon;
|
||||
use Illuminate\Support\HtmlString;
|
||||
use UnitEnum;
|
||||
|
||||
/**
|
||||
* "So arbeite ich": the landlord's own defaults for handling cases. A portal (Kanäle › Portal) and – in the expert
|
||||
* area – a property may deviate; everything not set there follows these defaults.
|
||||
*/
|
||||
class HandlingSettings extends Page
|
||||
{
|
||||
use FollowsAdminMode;
|
||||
|
||||
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedAdjustmentsVertical;
|
||||
|
||||
protected static string|UnitEnum|null $navigationGroup = 'System';
|
||||
|
||||
protected static ?string $navigationLabel = 'So arbeite ich';
|
||||
|
||||
protected static ?string $title = 'So arbeite ich';
|
||||
|
||||
protected static ?string $slug = 'abwicklung';
|
||||
|
||||
protected static ?int $navigationSort = 2;
|
||||
|
||||
/** @var array<string, mixed> */
|
||||
public array $data = [];
|
||||
|
||||
public static function canAccess(): bool
|
||||
{
|
||||
return (bool) auth()->user()?->hasRole(UserRole::Admin);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return list<ProcessSetting>
|
||||
*/
|
||||
public static function settings(): array
|
||||
{
|
||||
return array_values(array_filter(ProcessSetting::cases(), fn (ProcessSetting $setting): bool => $setting->isLandlordSetting()));
|
||||
}
|
||||
|
||||
public function mount(): void
|
||||
{
|
||||
$this->form->fill([
|
||||
...ProcessSettingFields::state((array) ($this->tenant()->process_defaults ?? [])),
|
||||
'document_releases' => collect(self::releasableKinds())->mapWithKeys(fn (DocumentKind $kind): array => [$kind->value => DocumentReleases::isReleased($kind, $this->tenant())])->all(),
|
||||
]);
|
||||
}
|
||||
|
||||
public function form(Schema $schema): Schema
|
||||
{
|
||||
return $schema
|
||||
->statePath('data')
|
||||
->components([
|
||||
Section::make('Ihre Standardeinstellungen')
|
||||
->description('Gilt für alle Wohnungen und Portale, solange dort nichts anderes eingestellt ist. Neue Einstellungen gelten für neue Vorgänge; laufende Vorgänge behalten ihre Regeln.')
|
||||
->columns(2)
|
||||
->schema(ProcessSettingFields::make('', self::settings(), fn (ProcessSetting $setting): string => 'Grundeinstellung ('.$setting->describe($setting->default()).')')),
|
||||
Section::make('Dokumente')
|
||||
->description('Welche Dokumente an Gäste gehen dürfen. Eine Arbeitsfassung wird nie automatisch versendet, von Hand nur nach ausdrücklicher Bestätigung im Vorgang. Vorlagen selbst geben Sie unter Vorlagen frei.')
|
||||
->schema([
|
||||
...array_map(fn (DocumentKind $kind): Toggle => Toggle::make('document_releases.'.$kind->value)
|
||||
->label($kind->getLabel().' – freigegeben')
|
||||
->helperText(fn (): string => $kind->description().self::decisionNote($kind)), self::releasableKinds()),
|
||||
Text::make(fn (): HtmlString => new HtmlString('<ul style="list-style:disc;padding-left:1.25rem">'.collect(DocumentKind::cases())
|
||||
->reject(fn (DocumentKind $kind): bool => in_array($kind, self::releasableKinds(), true) || ! $kind->isForGuests())
|
||||
->map(fn (DocumentKind $kind): string => '<li><strong>'.e($kind->getLabel()).'</strong>: '.e($kind->description()).' '.e($kind->isAvailable() ? '(in Verwendung; Texte unter Webseite › Texte bzw. Vorlagen)' : '(Arbeitsfassung vorbereitet, noch nicht nutzbar)').'</li>')
|
||||
->implode('').'</ul>')),
|
||||
]),
|
||||
Section::make('Abweichungen')
|
||||
->description('Wo Portale oder Wohnungen anders arbeiten. Ändern unter Portale bzw. Wohnungen (Expertenansicht).')
|
||||
->collapsed()
|
||||
->schema([Text::make(fn (): HtmlString => $this->deviations())]),
|
||||
]);
|
||||
}
|
||||
|
||||
public function content(Schema $schema): Schema
|
||||
{
|
||||
return $schema->components([
|
||||
Form::make([EmbeddedSchema::make('form')])
|
||||
->id('form')
|
||||
->livewireSubmitHandler('save')
|
||||
->footer([Actions::make([Action::make('save')->label('Speichern')->submit('save')])]),
|
||||
]);
|
||||
}
|
||||
|
||||
public function save(): void
|
||||
{
|
||||
$state = $this->form->getState();
|
||||
$this->tenant()->update(['process_defaults' => ProcessSettingFields::values($state, self::settings())]);
|
||||
foreach (self::releasableKinds() as $kind) {
|
||||
DocumentReleases::set($kind, (bool) ($state['document_releases'][$kind->value] ?? false), (string) auth()->user()?->name, $this->tenant());
|
||||
}
|
||||
|
||||
Notification::make()->title('Gespeichert')->body('Gilt für neue Vorgänge.')->success()->send();
|
||||
}
|
||||
|
||||
/**
|
||||
* Document kinds whose texts the landlord releases here: the new kinds that can already be sent. Offer and
|
||||
* confirmation are in use since the start; the others are drafts of later packages.
|
||||
*
|
||||
* @return list<DocumentKind>
|
||||
*/
|
||||
public static function releasableKinds(): array
|
||||
{
|
||||
return array_values(array_filter(DocumentKind::cases(), fn (DocumentKind $kind): bool => $kind->isAvailable() && ! $kind->releasedByDefault()));
|
||||
}
|
||||
|
||||
private static function decisionNote(DocumentKind $kind): string
|
||||
{
|
||||
$decision = DocumentReleases::decision($kind);
|
||||
|
||||
return $decision === null || $decision['at'] === null ? ' Bisher: Arbeitsfassung.' : ' Zuletzt geändert am '.CarbonImmutable::parse($decision['at'])->format('d.m.Y').' von '.$decision['by'].'.';
|
||||
}
|
||||
|
||||
/**
|
||||
* Every deviation of a property or a channel, in plain words.
|
||||
*/
|
||||
private function deviations(): HtmlString
|
||||
{
|
||||
$lines = [];
|
||||
foreach (Property::query()->orderBy('name')->get() as $property) {
|
||||
foreach ((array) ($property->process_overrides ?? []) as $key => $value) {
|
||||
$setting = ProcessSetting::tryFrom((string) $key);
|
||||
if ($setting !== null && $setting->normalize($value) !== null) {
|
||||
$lines[] = e($property->name).': '.e($setting->question()).' → <strong>'.e($setting->describe($setting->normalize($value))).'</strong>';
|
||||
}
|
||||
}
|
||||
}
|
||||
foreach (Channel::query()->with('property')->orderBy('name')->get() as $channel) {
|
||||
foreach ((array) ($channel->process_overrides ?? []) as $intake => $values) {
|
||||
foreach ((array) $values as $key => $value) {
|
||||
$setting = ProcessSetting::tryFrom((string) $key);
|
||||
if ($setting !== null && $setting->normalize($value) !== null) {
|
||||
$lines[] = e($channel->name.' ('.$channel->property?->name.', '.(IntakeKind::tryFrom((string) $intake)?->getLabel() ?? $intake).')').': '.e($setting->question()).' → <strong>'.e($setting->describe($setting->normalize($value))).'</strong>';
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return new HtmlString($lines === [] ? 'Keine – überall gelten Ihre Standardeinstellungen.' : '<ul class="list-disc ps-5 space-y-1"><li>'.implode('</li><li>', $lines).'</li></ul>');
|
||||
}
|
||||
|
||||
private function tenant(): Tenant
|
||||
{
|
||||
$tenant = Settings::tenant();
|
||||
|
||||
abort_if($tenant === null, 404);
|
||||
|
||||
return $tenant;
|
||||
}
|
||||
}
|
||||
@@ -32,9 +32,9 @@ class BookingResource extends Resource
|
||||
|
||||
protected static string|UnitEnum|null $navigationGroup = 'Verwaltung';
|
||||
|
||||
protected static ?string $modelLabel = 'Buchung';
|
||||
protected static ?string $modelLabel = 'Vorgang';
|
||||
|
||||
protected static ?string $pluralModelLabel = 'Anfragen & Buchungen';
|
||||
protected static ?string $pluralModelLabel = 'Vorgänge';
|
||||
|
||||
protected static ?string $recordTitleAttribute = 'reference';
|
||||
|
||||
|
||||
@@ -4,9 +4,13 @@
|
||||
|
||||
use App\Actions\ConfirmBooking;
|
||||
use App\Actions\CreateReservation;
|
||||
use App\Actions\RecordPortalBooking;
|
||||
use App\Actions\SendBookingDocuments;
|
||||
use App\Actions\TakeOverExternalBooking;
|
||||
use App\Exceptions\ReservationException;
|
||||
use App\Filament\Resources\BlockedPeriods\BlockedPeriodResource;
|
||||
use App\Filament\Resources\Bookings\BookingResource;
|
||||
use App\Filament\Resources\Bookings\Schemas\BookingForm;
|
||||
use App\Models\Booking;
|
||||
use App\Models\Channel;
|
||||
use App\Models\Property;
|
||||
use App\Pricing\QuoteException;
|
||||
@@ -16,62 +20,79 @@
|
||||
use Filament\Resources\Pages\CreateRecord;
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
use Illuminate\Support\Arr;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
|
||||
/**
|
||||
* Entry of a new case that did not come through the website: a request (A1/A2) goes the same way as a website request,
|
||||
* a booking already binding on a portal (A3–A5) is taken over as it is.
|
||||
*/
|
||||
class CreateBooking extends CreateRecord
|
||||
{
|
||||
protected static string $resource = BookingResource::class;
|
||||
|
||||
protected static ?string $title = 'Buchung erfassen';
|
||||
protected static ?string $title = 'Neu eintragen';
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $data
|
||||
*/
|
||||
protected function handleRecordCreation(array $data): Model
|
||||
{
|
||||
try {
|
||||
$property = Property::findOrFail($data['property_id']);
|
||||
$stay = new StayRequest(
|
||||
CarbonImmutable::parse($data['arrival']),
|
||||
CarbonImmutable::parse($data['departure']),
|
||||
(int) $data['guests'],
|
||||
promoCode: $data['promo_code'] ?: null,
|
||||
);
|
||||
$guest = Arr::only($data, ['first_name', 'last_name', 'email', 'phone', 'street', 'postal_code', 'city']);
|
||||
|
||||
if (filled($data['channel_id'] ?? null)) {
|
||||
$booking = app(RecordPortalBooking::class)->handle(
|
||||
$property,
|
||||
Channel::query()->findOrFail($data['channel_id']),
|
||||
$stay,
|
||||
$guest,
|
||||
$data['portal_process'] ?? RecordPortalBooking::CONFIRM,
|
||||
$data['portal_reference'] ?? null,
|
||||
filled($data['portal_total'] ?? null) ? (int) $data['portal_total'] : null,
|
||||
$data['internal_notes'] ?: null,
|
||||
(bool) ($data['guest_confirmed'] ?? false),
|
||||
);
|
||||
|
||||
return $booking;
|
||||
}
|
||||
|
||||
$booking = app(CreateReservation::class)->handle($property, $stay, $guest, source: 'manual', sendMails: $data['send_mails']);
|
||||
|
||||
if ($data['confirm_immediately']) {
|
||||
app(ConfirmBooking::class)->handle($booking, notifyGuest: $data['send_mails']);
|
||||
}
|
||||
} catch (QuoteException|ReservationException $exception) {
|
||||
Notification::make()->title('Buchung nicht möglich')->body($exception->getMessage())->danger()->send();
|
||||
|
||||
if (($data['kind'] ?? null) === BookingForm::OWN_USE) {
|
||||
$this->redirect(BlockedPeriodResource::getUrl());
|
||||
$this->halt();
|
||||
}
|
||||
|
||||
$booking->update(['internal_notes' => $data['internal_notes'] ?: null]);
|
||||
try {
|
||||
$property = Property::query()->findOrFail($data['property_id']);
|
||||
$channel = filled($data['channel_id'] ?? null) ? Channel::query()->findOrFail($data['channel_id']) : null;
|
||||
$arrival = CarbonImmutable::parse($data['arrival']);
|
||||
$departure = CarbonImmutable::parse($data['departure']);
|
||||
$guest = Arr::only($data, ['first_name', 'last_name', 'email', 'phone', 'street', 'postal_code', 'city']);
|
||||
|
||||
if ($data['kind'] === BookingForm::EXTERNAL) {
|
||||
return app(TakeOverExternalBooking::class)->handle($property, $channel, $arrival, $departure, [
|
||||
'guest' => $guest,
|
||||
'guests' => filled($data['guests'] ?? null) ? (int) $data['guests'] : null,
|
||||
'portal_reference' => $data['portal_reference'] ?? null,
|
||||
'portal_total' => filled($data['portal_total'] ?? null) ? (int) $data['portal_total'] : null,
|
||||
'notes' => $data['internal_notes'] ?? null,
|
||||
'guest_confirmed' => (bool) ($data['guest_confirmed'] ?? false),
|
||||
]);
|
||||
}
|
||||
|
||||
$stay = new StayRequest($arrival, $departure, (int) $data['guests'], promoCode: filled($data['promo_code'] ?? null) ? $data['promo_code'] : null);
|
||||
$sendMails = (bool) ($data['send_mails'] ?? false);
|
||||
$booking = app(CreateReservation::class)->handle($property, $stay, $guest, source: 'manual', sendMails: $sendMails && ! ($data['confirm_immediately'] ?? false), originChannel: $channel);
|
||||
|
||||
if ($data['confirm_immediately'] ?? false) {
|
||||
DB::transaction(fn () => app(ConfirmBooking::class)->bind($booking));
|
||||
if ($sendMails && filled($booking->guest?->email)) {
|
||||
// The documents go out only when their composition needs no check; otherwise they wait on the case page.
|
||||
$waiting = app(SendBookingDocuments::class)->automatically($booking->fresh());
|
||||
if ($waiting !== []) {
|
||||
Notification::make()->title('Gebucht – Unterlagen noch nicht gesendet')->body(implode(' ', $waiting))->warning()->send();
|
||||
}
|
||||
} else {
|
||||
app(ConfirmBooking::class)->deliver($booking->fresh(), notifyGuest: false);
|
||||
}
|
||||
}
|
||||
} catch (QuoteException|ReservationException $exception) {
|
||||
Notification::make()->title('Nicht möglich')->body($exception->getMessage())->danger()->send();
|
||||
$this->halt();
|
||||
}
|
||||
|
||||
if (filled($data['internal_notes'] ?? null)) {
|
||||
$booking->update(['internal_notes' => trim(($booking->internal_notes ? $booking->internal_notes."\n\n" : '').$data['internal_notes'])]);
|
||||
}
|
||||
|
||||
return $booking;
|
||||
}
|
||||
|
||||
protected function getRedirectUrl(): string
|
||||
{
|
||||
return BookingResource::getUrl('view', ['record' => $this->getRecord()]);
|
||||
/** @var Booking $record */
|
||||
$record = $this->getRecord();
|
||||
|
||||
return BookingResource::getUrl('view', ['record' => $record]);
|
||||
}
|
||||
}
|
||||
@@ -6,28 +6,38 @@
|
||||
use App\Actions\ConfirmBooking;
|
||||
use App\Actions\DeclineBooking;
|
||||
use App\Actions\ProvideGuestContact;
|
||||
use App\Actions\SendBookingDocuments;
|
||||
use App\Actions\SendOffer;
|
||||
use App\Actions\SetBookingStatus;
|
||||
use App\Documents\OfferTerms;
|
||||
use App\Documents\RentalContract;
|
||||
use App\Enums\AdminMode;
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\DocumentKind;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Enums\ProcessingMode;
|
||||
use App\Enums\Responsibility;
|
||||
use App\Exceptions\ReservationException;
|
||||
use App\Filament\Actions\AssignGuestAction;
|
||||
use App\Filament\Forms\Components\EuroInput;
|
||||
use App\Filament\Forms\DocumentCompositionFields;
|
||||
use App\Filament\Resources\Bookings\BookingResource;
|
||||
use App\Models\Booking;
|
||||
use App\Models\ContractAnnex;
|
||||
use App\Models\ContractTemplate;
|
||||
use App\Models\Extra;
|
||||
use App\Pricing\PriceCalculator;
|
||||
use App\Models\User;
|
||||
use App\Pricing\PortalPrice;
|
||||
use App\Pricing\QuoteException;
|
||||
use App\Pricing\StayRequest;
|
||||
use App\Support\BookingProgress;
|
||||
use App\Process\CaseActivities;
|
||||
use App\Process\CaseAutomation;
|
||||
use App\Process\CaseLog;
|
||||
use App\Support\Money;
|
||||
use Carbon\CarbonImmutable;
|
||||
use Filament\Actions\Action;
|
||||
use Filament\Actions\ActionGroup;
|
||||
use Filament\Forms\Components\DatePicker;
|
||||
use Filament\Forms\Components\DateTimePicker;
|
||||
use Filament\Forms\Components\Hidden;
|
||||
use Filament\Forms\Components\Radio;
|
||||
use Filament\Forms\Components\Repeater;
|
||||
use Filament\Forms\Components\Select;
|
||||
@@ -36,336 +46,553 @@
|
||||
use Filament\Forms\Components\Toggle;
|
||||
use Filament\Notifications\Notification;
|
||||
use Filament\Resources\Pages\ViewRecord;
|
||||
use Filament\Schemas\Components\Group;
|
||||
use Filament\Schemas\Components\Section;
|
||||
use Filament\Schemas\Components\Text;
|
||||
use Filament\Schemas\Components\Utilities\Get;
|
||||
use Filament\Schemas\Components\Utilities\Set;
|
||||
use Filament\Support\Icons\Heroicon;
|
||||
use Throwable;
|
||||
use Illuminate\Contracts\Support\Htmlable;
|
||||
use Illuminate\Support\Arr;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
|
||||
/**
|
||||
* The case page. At the top only what matters now: the next step as one large button, "Beenden" and the switch between
|
||||
* automatic and manual handling. Everything else that is possible right now sits under "Weitere Möglichkeiten";
|
||||
* technical functions only in the expert view. Ending a case always takes the proper way – a binding booking is
|
||||
* cancelled with its consequences, it cannot be "set back" by a status change.
|
||||
*
|
||||
* @property Booking $record
|
||||
*/
|
||||
class ViewBooking extends ViewRecord
|
||||
{
|
||||
protected static string $resource = BookingResource::class;
|
||||
|
||||
/** Actions for the expert view only. */
|
||||
private const EXPERT = ['offerLink', 'contractText', 'setStatus'];
|
||||
|
||||
public function getTitle(): string
|
||||
{
|
||||
return "{$this->record->reference} · {$this->record->guest->full_name}";
|
||||
return "{$this->record->reference} · {$this->record->guestName()}";
|
||||
}
|
||||
|
||||
public function getSubheading(): string|Htmlable|null
|
||||
{
|
||||
return CaseActivities::situation($this->record);
|
||||
}
|
||||
|
||||
protected function getHeaderActions(): array
|
||||
{
|
||||
return [
|
||||
$actions = collect([
|
||||
$this->sendOfferAction(),
|
||||
$this->provideContactAction(),
|
||||
$this->requestContactAction(),
|
||||
AssignGuestAction::make(),
|
||||
Action::make('sendOffer')
|
||||
->label(fn (): string => $this->record->status === BookingStatus::OfferSent ? 'Angebot ändern & neu senden' : 'Angebot senden')
|
||||
->icon(Heroicon::OutlinedPaperAirplane)
|
||||
->color('success')
|
||||
->visible(fn (): bool => in_array($this->record->status, [BookingStatus::Reserved, BookingStatus::OfferSent, BookingStatus::Expired], true))
|
||||
->modalHeading('Angebot an den Gast senden')
|
||||
->modalDescription('Der Gast erhält das Angebot mit Vertragsentwurf per E-Mail und kann es über einen Link annehmen oder ablehnen. Erst mit seiner Annahme ist die Buchung verbindlich.')
|
||||
->modalSubmitActionLabel('Angebot senden')
|
||||
->modalWidth('3xl')
|
||||
->fillForm(fn (): array => [
|
||||
'arrival' => $this->record->arrival->toDateString(),
|
||||
'departure' => $this->record->departure->toDateString(),
|
||||
'guests' => $this->record->guests,
|
||||
'promo_code' => $this->record->promo_code,
|
||||
'price_adjustment' => $this->record->price_adjustment !== null ? number_format($this->record->price_adjustment / 100, 2, '.', '') : null,
|
||||
'price_adjustment_label' => $this->record->price_adjustment_label,
|
||||
'valid_until' => now()->addHours($this->record->property->hold_hours)->format('Y-m-d H:i'),
|
||||
'offer_message' => $this->record->offer_message,
|
||||
'guest' => $this->record->guest->only(['first_name', 'last_name', 'street', 'postal_code', 'city', 'phone']),
|
||||
])
|
||||
->schema([
|
||||
$this->confirmAction(),
|
||||
$this->sendDocumentsAction(),
|
||||
$this->resendConfirmationAction(),
|
||||
$this->portalPriceAction(),
|
||||
$this->extendHoldAction(),
|
||||
$this->servicesAction(),
|
||||
$this->offerPdfAction(),
|
||||
$this->contractAction(),
|
||||
$this->offerLinkAction(),
|
||||
$this->contractTextAction(),
|
||||
$this->notesAction(),
|
||||
$this->archiveAction(),
|
||||
$this->setStatusAction(),
|
||||
])->keyBy(fn (Action $action): string => $action->getName());
|
||||
|
||||
$next = CaseActivities::next($this->record)?->action;
|
||||
$primary = $next !== null && $actions->has($next) ? $actions->pull($next)->color('primary')->size('lg')->icon(Heroicon::OutlinedArrowRightCircle) : null;
|
||||
$expert = $actions->only(self::EXPERT)->values()->all();
|
||||
$more = $actions->except(self::EXPERT)->values()->all();
|
||||
|
||||
return array_values(array_filter([
|
||||
$primary,
|
||||
$this->automationAction(),
|
||||
$this->endAction(),
|
||||
ActionGroup::make($more)->label('Weitere Möglichkeiten')->icon(Heroicon::OutlinedEllipsisHorizontal)->button()->color('gray'),
|
||||
$this->isExpert() ? ActionGroup::make($expert)->label('Experte')->icon(Heroicon::OutlinedWrenchScrewdriver)->button()->color('gray') : null,
|
||||
]));
|
||||
}
|
||||
|
||||
private function isExpert(): bool
|
||||
{
|
||||
$user = auth()->user();
|
||||
|
||||
return $user instanceof User && $user->adminMode() === AdminMode::Expert;
|
||||
}
|
||||
|
||||
private function sendOfferAction(): Action
|
||||
{
|
||||
return Action::make('sendOffer')
|
||||
->label(fn (): string => $this->record->status === BookingStatus::OfferSent ? 'Angebot ändern & neu senden' : 'Angebot prüfen und senden')
|
||||
->icon(Heroicon::OutlinedPaperAirplane)
|
||||
->visible(fn (): bool => in_array($this->record->status, [BookingStatus::Reserved, BookingStatus::OfferSent, BookingStatus::Expired], true) && $this->record->intake !== IntakeKind::Booking)
|
||||
->modalHeading('Angebot an den Gast')
|
||||
->modalDescription('Alles ist vorbereitet: Preis, Vertragsvorlage, Anlagen und Gültigkeit kommen aus Ihren Einstellungen. Prüfen Sie die Zusammenstellung; „Anpassen“ nur bei Bedarf. Mit „Senden“ erhält der Gast das Angebot mit einem Link zum Annehmen.')
|
||||
->modalSubmitActionLabel('Senden')
|
||||
->modalWidth('4xl')
|
||||
->fillForm(fn (): array => [
|
||||
'expected_version' => $this->record->offer_version,
|
||||
'arrival' => $this->record->arrival->toDateString(),
|
||||
'departure' => $this->record->departure->toDateString(),
|
||||
'guests' => $this->record->guests,
|
||||
'promo_code' => $this->record->promo_code,
|
||||
'price_adjustment' => $this->record->price_adjustment !== null ? number_format($this->record->price_adjustment / 100, 2, '.', '') : null,
|
||||
'price_adjustment_label' => $this->record->price_adjustment_label,
|
||||
'valid_until' => now()->addHours($this->record->process()->holdHours())->format('Y-m-d H:i'),
|
||||
'offer_message' => $this->record->offer_message,
|
||||
'annex_ids' => OfferTerms::templateFor($this->record)?->annexesFor($this->record)->pluck('id')->all() ?? [],
|
||||
'guest' => $this->record->guest?->only(['first_name', 'last_name', 'street', 'postal_code', 'city', 'phone']) ?? [],
|
||||
])
|
||||
->schema([
|
||||
Hidden::make('expected_version'),
|
||||
...DocumentCompositionFields::make($this->record, DocumentKind::Offer, fn (Get $get): array => $this->offerChanges(self::formState($get, ['expected_version', 'arrival', 'departure', 'guests', 'promo_code', 'price_adjustment', 'price_adjustment_label', 'valid_until', 'offer_message', 'contract_template_id', 'annex_ids', 'guest']))),
|
||||
Textarea::make('offer_message')->label('Persönliche Nachricht an den Gast (optional)')->rows(3)->live(onBlur: true),
|
||||
Section::make('Anpassen')->description('Zeitraum, Preis, Vorlage, Gültigkeit, Angaben zum Gast – die Zusammenstellung oben rechnet sofort neu.')->collapsed()->schema([
|
||||
Section::make('Termin')->columns(3)->schema([
|
||||
DatePicker::make('arrival')->label('Anreise')->required()->live(onBlur: true),
|
||||
DatePicker::make('departure')->label('Abreise')->after('arrival')->required()->live(onBlur: true),
|
||||
TextInput::make('guests')->label('Personen')->integer()->minValue(1)->maxValue(fn (): int => $this->record->property->max_guests)->required()->live(onBlur: true),
|
||||
]),
|
||||
Section::make('Preis')->columns(3)->schema([
|
||||
TextInput::make('promo_code')->label('Rabattcode')->helperText('Sonderkondition aus den Angeboten')->maxLength(50)->live(onBlur: true),
|
||||
TextInput::make('price_adjustment')
|
||||
->label('Preisanpassung')
|
||||
->helperText('Minus = Nachlass, z. B. -50')
|
||||
->numeric()
|
||||
->step(0.01)
|
||||
->suffix('€')
|
||||
->live(onBlur: true),
|
||||
TextInput::make('price_adjustment_label')->label('Bezeichnung')->placeholder('Nachlass / Zuschlag')->maxLength(80),
|
||||
Text::make(fn (Get $get): string => $this->offerPricePreview($get))->columnSpanFull(),
|
||||
TextInput::make('promo_code')->label('Rabattcode')->maxLength(50)->live(onBlur: true),
|
||||
TextInput::make('price_adjustment')->label('Preisanpassung')->helperText('Minus = Nachlass, z. B. -50')->numeric()->step(0.01)->suffix('€')->live(onBlur: true),
|
||||
TextInput::make('price_adjustment_label')->label('Bezeichnung')->placeholder('Nachlass / Zuschlag')->maxLength(80)->live(onBlur: true),
|
||||
]),
|
||||
Section::make('Vertragsvorlage und Anlagen')->schema([
|
||||
Select::make('annex_ids')
|
||||
->label('Anlagen')
|
||||
->multiple()
|
||||
->options(fn (): array => ContractAnnex::query()->orderBy('name')->orderBy('version')->get()->mapWithKeys(fn (ContractAnnex $annex): array => [$annex->id => $annex->label()])->all())
|
||||
->default(fn (): array => OfferTerms::templateFor($this->record)?->annexesFor($this->record)->pluck('id')->all() ?? [])
|
||||
->helperText('Vorausgewählt: Anlagen der Vorlage, deren Bedingung zu dieser Buchung passt (z. B. gebuchtes Wäschepaket). Sie können Anlagen hinzufügen oder entfernen.'),
|
||||
Select::make('contract_template_id')
|
||||
->label('Vorlage für dieses Angebot')
|
||||
->options(fn (): array => ContractTemplate::query()->orderBy('name')->orderBy('version')->get()->mapWithKeys(fn (ContractTemplate $template): array => [$template->id => $template->label()])->all())
|
||||
->placeholder('Standard (Portal / Wohnung / Webseite)')
|
||||
->helperText('Die Texte werden beim Versand fest im Angebot abgelegt.'),
|
||||
...$this->templateFields(),
|
||||
DateTimePicker::make('valid_until')
|
||||
->label('Angebot gültig bis')
|
||||
->helperText(fn (): string => 'Eingestellt: '.$this->record->process()->holdHours().' Stunden. Bis dahin bleibt der Zeitraum reserviert.')
|
||||
->seconds(false)
|
||||
->after('now')
|
||||
->required()
|
||||
->live(onBlur: true),
|
||||
Section::make('Gast – so erscheint er im Vertrag')->columns(2)->schema([
|
||||
TextInput::make('guest.first_name')->label('Vorname')->required()->maxLength(100)->live(onBlur: true),
|
||||
TextInput::make('guest.last_name')->label('Nachname')->required()->maxLength(100)->live(onBlur: true),
|
||||
TextInput::make('guest.street')->label('Straße und Hausnummer')->maxLength(150)->live(onBlur: true),
|
||||
TextInput::make('guest.postal_code')->label('PLZ')->maxLength(20)->live(onBlur: true),
|
||||
TextInput::make('guest.city')->label('Ort')->maxLength(100)->live(onBlur: true),
|
||||
TextInput::make('guest.phone')->label('Telefon')->maxLength(50)->live(onBlur: true),
|
||||
]),
|
||||
Section::make('Gültigkeit & Nachricht')->columns(2)->schema([
|
||||
DateTimePicker::make('valid_until')
|
||||
->label('Angebot gültig bis')
|
||||
->helperText(fn (): string => 'Standard: '.$this->record->property->hold_hours.' Stunden (Einstellung der Wohnung). Bis dahin bleibt der Zeitraum reserviert.')
|
||||
->seconds(false)
|
||||
->after('now')
|
||||
->required(),
|
||||
Textarea::make('offer_message')->label('Persönliche Nachricht an den Gast (optional)')->rows(3),
|
||||
]),
|
||||
Section::make('Gast – so erscheint er im Mietvertrag')->columns(2)->collapsed()->schema([
|
||||
TextInput::make('guest.first_name')->label('Vorname')->required()->maxLength(100),
|
||||
TextInput::make('guest.last_name')->label('Nachname')->required()->maxLength(100),
|
||||
TextInput::make('guest.street')->label('Straße und Hausnummer')->maxLength(150),
|
||||
TextInput::make('guest.postal_code')->label('PLZ')->maxLength(20),
|
||||
TextInput::make('guest.city')->label('Ort')->maxLength(100),
|
||||
TextInput::make('guest.phone')->label('Telefon')->maxLength(50),
|
||||
]),
|
||||
])
|
||||
->action(fn (array $data, SendOffer $send) => $this->runWorkflow(
|
||||
fn () => $send->handle($this->record, $this->offerChanges($data)),
|
||||
'Angebot gesendet',
|
||||
)),
|
||||
Action::make('provideContact')
|
||||
->label('Kontaktdaten eintragen')
|
||||
->icon(Heroicon::OutlinedUserPlus)
|
||||
->color(fn (): string => blank($this->record->guest?->email) ? 'warning' : 'gray')
|
||||
->visible(fn (): bool => ! in_array($this->record->status, [BookingStatus::Cancelled, BookingStatus::Declined, BookingStatus::Expired], true))
|
||||
->modalHeading('Kontaktdaten des Gastes')
|
||||
->modalDescription('Kontaktdaten aus Portalnachricht, E-Mail oder Telefonat. Danach kann der Vertragsprozess automatisch weiterlaufen oder von Hand fortgeführt werden.')
|
||||
->modalWidth('3xl')
|
||||
->fillForm(fn (): array => ['guest' => $this->record->guest->only(['first_name', 'last_name', 'email', 'phone', 'street', 'postal_code', 'city']), 'process' => ProvideGuestContact::MANUAL, 'guest_confirmed' => $this->record->guest_confirmed_at !== null])
|
||||
->schema([
|
||||
Section::make('Gast')->columns(2)->schema([
|
||||
TextInput::make('guest.first_name')->label('Vorname')->required()->maxLength(100),
|
||||
TextInput::make('guest.last_name')->label('Nachname')->required()->maxLength(100),
|
||||
TextInput::make('guest.email')->label('E-Mail')->email()->maxLength(255),
|
||||
TextInput::make('guest.phone')->label('Telefon')->tel()->maxLength(50),
|
||||
TextInput::make('guest.street')->label('Straße und Hausnummer')->maxLength(150),
|
||||
TextInput::make('guest.postal_code')->label('PLZ')->maxLength(20),
|
||||
TextInput::make('guest.city')->label('Ort')->maxLength(100),
|
||||
]),
|
||||
Section::make('Wie geht es weiter?')->schema([
|
||||
Radio::make('process')->hiddenLabel()->options([
|
||||
ProvideGuestContact::MANUAL => 'Nur speichern – den Vertragsprozess führe ich von Hand weiter',
|
||||
ProvideGuestContact::AUTOMATIC => 'Automatisch weiter: Portal-Buchung → Bestätigung und Vertrag per E-Mail, Anfrage → Angebot per E-Mail',
|
||||
])->required(),
|
||||
Toggle::make('guest_confirmed')->label('Der Gast hat die Buchung per E-Mail bestätigt'),
|
||||
]),
|
||||
])
|
||||
->action(function (array $data, ProvideGuestContact $provide): void {
|
||||
try {
|
||||
$message = $provide->handle($this->record, $data['guest'], $data['process'], (bool) $data['guest_confirmed']);
|
||||
} catch (ReservationException|QuoteException $exception) {
|
||||
Notification::make()->title('Nicht möglich')->body($exception->getMessage())->danger()->send();
|
||||
]),
|
||||
])
|
||||
->action(fn (array $data, SendOffer $send) => $this->runWorkflow(fn () => $send->handle($this->record, $this->offerChanges($data)), 'Angebot gesendet'));
|
||||
}
|
||||
|
||||
/**
|
||||
* The documents of a binding case (confirmation with contract, or booking documentation of a portal booking), sent
|
||||
* after the landlord saw their composition.
|
||||
*/
|
||||
private function sendDocumentsAction(): Action
|
||||
{
|
||||
return Action::make('sendDocuments')
|
||||
->label(fn (): string => SendBookingDocuments::kindFor($this->record) === DocumentKind::ExternalRecord ? 'Buchungsunterlagen prüfen und senden' : 'Bestätigung prüfen und senden')
|
||||
->icon(Heroicon::OutlinedPaperAirplane)
|
||||
->visible(fn (): bool => $this->record->isBinding() && $this->record->confirmation_sent_at === null && $this->record->confirmation_failed_at === null && $this->record->process()->documents() === Responsibility::Landlord)
|
||||
->modalHeading(fn (): string => SendBookingDocuments::kindFor($this->record)->getLabel())
|
||||
->modalDescription('So gehen die Unterlagen an den Gast. „Anpassen“ nur bei Bedarf.')
|
||||
->modalSubmitActionLabel('Senden')
|
||||
->modalWidth('4xl')
|
||||
->fillForm(fn (): array => ['annex_ids' => $this->record->contract_path === null && $this->record->offer_version === 0 ? (OfferTerms::templateFor($this->record)?->annexesFor($this->record)->pluck('id')->all() ?? []) : null])
|
||||
->schema(fn (): array => [
|
||||
...DocumentCompositionFields::make($this->record, SendBookingDocuments::kindFor($this->record), fn (Get $get): array => $this->documentChanges(self::formState($get, ['contract_template_id', 'annex_ids']))),
|
||||
Section::make('Anpassen')->description('Vorlage und Anlagen für diesen Vorgang.')->collapsed()->visible($this->record->contract_path === null && $this->record->offer_version === 0)->schema($this->templateFields()),
|
||||
])
|
||||
->action(function (array $data, SendBookingDocuments $documents): void {
|
||||
$this->runWorkflow(function () use ($data, $documents): void {
|
||||
if (! $documents->handle($this->record, $this->documentChanges($data), (bool) ($data['acknowledged'] ?? false))) {
|
||||
throw new ReservationException('Der Versand ist fehlgeschlagen (Details im Postfach). Sie können ihn über „Unterlagen erneut senden“ wiederholen.');
|
||||
}
|
||||
}, 'Unterlagen gesendet');
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Choice of template and annexes for one case; changing the template proposes its annexes.
|
||||
*
|
||||
* @return list<Section>
|
||||
*/
|
||||
private function templateFields(): array
|
||||
{
|
||||
return [
|
||||
Section::make('Vorlage und Anlagen')->schema([
|
||||
Select::make('contract_template_id')
|
||||
->label('Andere Vorlage für diesen Vorgang')
|
||||
->options(fn (): array => ContractTemplate::query()->orderBy('name')->orderBy('version')->get()->mapWithKeys(fn (ContractTemplate $template): array => [$template->id => $template->label().($template->isReleased() ? '' : ' – nicht freigegeben')])->all())
|
||||
->placeholder('wie eingestellt')
|
||||
->live()
|
||||
->afterStateUpdated(fn (Set $set, $state) => $set('annex_ids', OfferTerms::templateFor($this->record, $state)?->annexesFor($this->record)->pluck('id')->all() ?? [])),
|
||||
Select::make('annex_ids')
|
||||
->label('Anlagen')
|
||||
->multiple()
|
||||
->live()
|
||||
->options(fn (): array => ContractAnnex::query()->orderBy('name')->orderBy('version')->get()->mapWithKeys(fn (ContractAnnex $annex): array => [$annex->id => $annex->label()])->all()),
|
||||
]),
|
||||
];
|
||||
}
|
||||
|
||||
private function provideContactAction(): Action
|
||||
{
|
||||
return Action::make('provideContact')
|
||||
->label(fn (): string => $this->record->guest === null ? 'Gast eintragen' : 'Kontaktdaten eintragen')
|
||||
->icon(Heroicon::OutlinedUserPlus)
|
||||
->visible(fn (): bool => ! in_array($this->record->status, [BookingStatus::Cancelled, BookingStatus::Declined, BookingStatus::Expired], true))
|
||||
->modalHeading('Kontaktdaten des Gastes')
|
||||
->modalDescription('Aus Portalnachricht, E-Mail oder Telefonat. Nur eintragen, was bekannt ist.')
|
||||
->modalWidth('3xl')
|
||||
->fillForm(fn (): array => [
|
||||
'guest' => $this->record->guest?->only(['first_name', 'last_name', 'email', 'phone', 'street', 'postal_code', 'city']) ?? [],
|
||||
'process' => $this->record->processingMode() === ProcessingMode::Automatic ? ProvideGuestContact::AUTOMATIC : ProvideGuestContact::MANUAL,
|
||||
'guest_confirmed' => $this->record->guest_confirmed_at !== null,
|
||||
])
|
||||
->schema([
|
||||
Section::make('Gast')->columns(2)->schema([
|
||||
TextInput::make('guest.first_name')->label('Vorname')->required()->maxLength(100),
|
||||
TextInput::make('guest.last_name')->label('Nachname')->required()->maxLength(100),
|
||||
TextInput::make('guest.email')->label('E-Mail')->email()->maxLength(255),
|
||||
TextInput::make('guest.phone')->label('Telefon')->tel()->maxLength(50),
|
||||
TextInput::make('guest.street')->label('Straße und Hausnummer')->maxLength(150),
|
||||
TextInput::make('guest.postal_code')->label('PLZ')->maxLength(20),
|
||||
TextInput::make('guest.city')->label('Ort')->maxLength(100),
|
||||
]),
|
||||
Section::make('Wie geht es danach weiter?')->schema([
|
||||
Radio::make('process')->hiddenLabel()->options([
|
||||
ProvideGuestContact::AUTOMATIC => 'Automatisch weitermachen – das System sendet als Nächstes Angebot bzw. Unterlagen',
|
||||
ProvideGuestContact::MANUAL => 'Nur speichern – den nächsten Schritt gebe ich selbst frei',
|
||||
])->required(),
|
||||
Toggle::make('guest_confirmed')->label('Der Gast hat die Buchung per E-Mail bestätigt'),
|
||||
]),
|
||||
])
|
||||
->action(function (array $data, ProvideGuestContact $provide): void {
|
||||
try {
|
||||
$message = $provide->handle($this->record, $data['guest'], $data['process'], (bool) $data['guest_confirmed']);
|
||||
} catch (ReservationException|QuoteException $exception) {
|
||||
$this->record->refresh();
|
||||
Notification::make()->title('Nicht möglich')->body($exception->getMessage())->danger()->send();
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
$this->record->refresh();
|
||||
Notification::make()->title($message)->success()->send();
|
||||
});
|
||||
}
|
||||
|
||||
private function requestContactAction(): Action
|
||||
{
|
||||
return Action::make('requestContact')
|
||||
->label('Gast um Kontaktdaten bitten')
|
||||
->icon(Heroicon::OutlinedChatBubbleLeftEllipsis)
|
||||
->visible(fn (): bool => blank($this->record->guest?->email) && ! in_array($this->record->status, [BookingStatus::Cancelled, BookingStatus::Declined, BookingStatus::Expired], true))
|
||||
->modalHeading('Gast um Kontaktdaten bitten')
|
||||
->modalDescription('Den Text im Nachrichtenfenster des Portals einfügen (Sie senden ihn selbst). „Als angefragt vermerken“ hält fest, dass die Daten erfragt sind.')
|
||||
->modalSubmitActionLabel('Als angefragt vermerken')
|
||||
->fillForm(fn (): array => ['text' => $this->contactRequestText()])
|
||||
->schema([Textarea::make('text')->label('Nachricht an den Gast')->rows(10)->extraInputAttributes(['readonly' => true, 'onclick' => 'this.select()'])])
|
||||
->action(function (): void {
|
||||
$this->record->forceFill(['contact_requested_at' => now()])->save();
|
||||
Notification::make()->title('Als angefragt vermerkt')->success()->send();
|
||||
});
|
||||
}
|
||||
|
||||
private function confirmAction(): Action
|
||||
{
|
||||
$kind = fn (): DocumentKind => $this->record->intake === IntakeKind::Booking ? DocumentKind::ExternalRecord : DocumentKind::Confirmation;
|
||||
|
||||
return Action::make('confirm')
|
||||
->label('Direkt verbindlich bestätigen')
|
||||
->icon(Heroicon::OutlinedCheckCircle)
|
||||
->visible(fn (): bool => in_array($this->record->status, [BookingStatus::Reserved, BookingStatus::OfferSent, BookingStatus::Expired], true))
|
||||
->modalHeading('Buchung direkt bestätigen')
|
||||
->modalDescription('Ohne Angebot und Annahme durch den Gast – nur wenn die Buchung schon anders verbindlich vereinbart wurde (z. B. am Telefon). Der Zeitraum wird fest belegt.')
|
||||
->modalSubmitActionLabel('Bestätigen')
|
||||
->modalWidth('4xl')
|
||||
->fillForm(fn (): array => ['notify' => filled($this->record->guest?->email)])
|
||||
->schema(fn (): array => [
|
||||
Toggle::make('notify')->label('Unterlagen an den Gast senden')->live(),
|
||||
Group::make(DocumentCompositionFields::make($this->record, $kind(), fn (Get $get): array => [], fn (Get $get): bool => (bool) $get('notify')))
|
||||
->visible(fn (Get $get): bool => (bool) $get('notify')),
|
||||
])
|
||||
->action(function (array $data, ConfirmBooking $confirm, SendBookingDocuments $documents) use ($kind): void {
|
||||
$notify = (bool) ($data['notify'] ?? false);
|
||||
$acknowledged = (bool) ($data['acknowledged'] ?? false);
|
||||
|
||||
if ($notify) {
|
||||
$composition = DocumentCompositionFields::compose($this->record, $kind(), []);
|
||||
if (! $composition->canSendByHand($acknowledged)) {
|
||||
Notification::make()->title('Nicht möglich')->body(implode(' ', [...$composition->blockers(), ...$composition->toConfirm()]))->danger()->send();
|
||||
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
$this->record->refresh();
|
||||
Notification::make()->title($message)->success()->send();
|
||||
}),
|
||||
Action::make('requestContact')
|
||||
->label('Gast um Kontaktdaten bitten')
|
||||
->icon(Heroicon::OutlinedChatBubbleLeftEllipsis)
|
||||
->color('gray')
|
||||
->visible(fn (): bool => blank($this->record->guest?->email) && ! in_array($this->record->status, [BookingStatus::Cancelled, BookingStatus::Declined, BookingStatus::Expired], true))
|
||||
->modalHeading('Gast um Kontaktdaten bitten')
|
||||
->modalDescription('Der Text lässt sich im Nachrichtenfenster des Portals einfügen (Sie senden ihn selbst). Mit „Als angefragt vermerken“ merkt sich die Buchungsakte, dass die Kontaktdaten erfragt wurden.')
|
||||
->modalSubmitActionLabel('Als angefragt vermerken')
|
||||
->fillForm(fn (): array => ['text' => $this->contactRequestText()])
|
||||
->schema([
|
||||
Textarea::make('text')->label('Nachricht an den Gast')->rows(10)->extraInputAttributes(['readonly' => true, 'onclick' => 'this.select()']),
|
||||
])
|
||||
->action(function (): void {
|
||||
$this->record->forceFill(['contact_requested_at' => now()])->saveQuietly();
|
||||
Notification::make()->title('Als angefragt vermerkt')->success()->send();
|
||||
}),
|
||||
Action::make('offerLink')
|
||||
->label('Angebotslink')
|
||||
->icon(Heroicon::OutlinedLink)
|
||||
->color('gray')
|
||||
->visible(fn (): bool => $this->record->status === BookingStatus::OfferSent && $this->record->hold_expires_at?->isFuture())
|
||||
->modalHeading('Link zum Angebot')
|
||||
->modalDescription('Derselbe Link wie in der Angebots-E-Mail – z. B. zum Weitergeben per Messenger. Gültig bis zum Ende der Angebotsfrist.')
|
||||
->schema([
|
||||
TextInput::make('url')->label('Link')->default(fn (SendOffer $send): string => $send->offerUrl($this->record))->readOnly()->copyable(),
|
||||
])
|
||||
->modalSubmitAction(false)
|
||||
->modalCancelActionLabel('Schließen'),
|
||||
Action::make('offerPdf')
|
||||
->label('Angebot (PDF)')
|
||||
->icon(Heroicon::OutlinedDocumentText)
|
||||
->color('gray')
|
||||
->visible(fn (): bool => $this->record->status === BookingStatus::OfferSent && $this->record->offer_path !== null)
|
||||
->action(fn (RentalContract $contract) => response()->download($contract->absolutePath($this->record, draft: true) ?? abort(404), "Angebot-{$this->record->reference}.pdf")),
|
||||
Action::make('confirm')
|
||||
->label('Direkt bestätigen')
|
||||
->icon(Heroicon::OutlinedCheckCircle)
|
||||
->color('gray')
|
||||
->visible(fn (): bool => in_array($this->record->status, [BookingStatus::Reserved, BookingStatus::OfferSent, BookingStatus::Expired], true))
|
||||
->requiresConfirmation()
|
||||
->modalHeading('Buchung direkt bestätigen')
|
||||
->modalDescription('Ohne Angebot und Annahme durch den Gast – nur wenn die Buchung bereits anders verbindlich vereinbart wurde (z. B. telefonisch). Die Buchung wird verbindlich und der Zeitraum dauerhaft belegt.')
|
||||
->schema([
|
||||
Toggle::make('notify')->label('Buchungsbestätigung an den Gast senden')->default(true),
|
||||
])
|
||||
->action(fn (array $data, ConfirmBooking $confirm) => $this->runWorkflow(
|
||||
fn () => $confirm->handle($this->record, $data['notify']),
|
||||
'Buchung bestätigt',
|
||||
)),
|
||||
Action::make('decline')
|
||||
->label('Ablehnen')
|
||||
->icon(Heroicon::OutlinedXCircle)
|
||||
->color('danger')
|
||||
->visible(fn (): bool => in_array($this->record->status, [BookingStatus::Reserved, BookingStatus::OfferSent, BookingStatus::Expired], true))
|
||||
->requiresConfirmation()
|
||||
->modalHeading('Anfrage ablehnen')
|
||||
->schema([
|
||||
Toggle::make('notify')->label('Absage an den Gast senden')->default(true),
|
||||
])
|
||||
->action(fn (array $data, DeclineBooking $decline) => $this->runWorkflow(
|
||||
fn () => $decline->handle($this->record, $data['notify']),
|
||||
'Anfrage abgelehnt',
|
||||
)),
|
||||
Action::make('extendHold')
|
||||
->label('Vormerkung verlängern')
|
||||
->icon(Heroicon::OutlinedClock)
|
||||
->color('gray')
|
||||
->visible(fn (): bool => in_array($this->record->status, BookingStatus::holding(), true))
|
||||
->schema([
|
||||
TextInput::make('hours')->label('Um')->integer()->minValue(1)->default(24)->suffix('Stunden')->required(),
|
||||
])
|
||||
->action(function (array $data): void {
|
||||
$from = $this->record->hold_expires_at?->isFuture() ? $this->record->hold_expires_at : now()->toImmutable();
|
||||
$this->record->update(['hold_expires_at' => $from->addHours((int) $data['hours'])]);
|
||||
$this->runWorkflow(function () use ($confirm, $documents, $notify, $acknowledged): void {
|
||||
DB::transaction(fn () => $confirm->bind($this->record));
|
||||
$notify ? $documents->handle($this->record->fresh(), [], $acknowledged) : $confirm->deliver($this->record->fresh(), notifyGuest: false);
|
||||
}, 'Buchung bestätigt');
|
||||
});
|
||||
}
|
||||
|
||||
Notification::make()->title('Vorgemerkt bis '.$this->record->hold_expires_at->format('d.m.Y, H:i'))->success()->send();
|
||||
}),
|
||||
Action::make('resendConfirmation')
|
||||
->label(fn (): string => $this->record->confirmation_failed_at !== null ? 'Bestätigung erneut senden (Versand fehlgeschlagen)' : 'Bestätigung erneut senden')
|
||||
->icon(Heroicon::OutlinedEnvelope)
|
||||
->color(fn (): string => $this->record->confirmation_failed_at !== null ? 'danger' : 'gray')
|
||||
->visible(fn (): bool => in_array($this->record->status, BookingStatus::occupying(), true))
|
||||
->requiresConfirmation()
|
||||
->modalDescription('Die Buchungsbestätigung mit dem Mietvertrag wird noch einmal an den Gast gesendet.')
|
||||
->action(function (ConfirmBooking $confirm): void {
|
||||
$sent = $confirm->resend($this->record->fresh());
|
||||
$notification = Notification::make()->title($sent ? 'Bestätigung gesendet' : 'Versand fehlgeschlagen');
|
||||
($sent ? $notification->success() : $notification->danger()->body('Details im Postfach.'))->send();
|
||||
}),
|
||||
Action::make('services')
|
||||
->label('Zusatzleistungen erfassen')
|
||||
->icon(Heroicon::OutlinedPlusCircle)
|
||||
->color('gray')
|
||||
->visible(fn (): bool => ! in_array($this->record->status, [BookingStatus::Cancelled, BookingStatus::Declined, BookingStatus::Expired, BookingStatus::Completed], true))
|
||||
->modalDescription('Gebuchte Zusatzleistungen (kostenpflichtig oder kostenlos), z. B. aus einer Portalbuchung oder per E-Mail erfragt. Sie bestimmen, welche Vertragsanlagen angehängt werden. Der Preis der Buchung wird dadurch nicht verändert.')
|
||||
->fillForm(fn (): array => ['items' => collect((array) $this->record->extras)->map(fn ($quantity, $id): array => ['extra_id' => (int) $id, 'quantity' => (int) $quantity])->values()->all()])
|
||||
->schema([
|
||||
Repeater::make('items')
|
||||
->label('Leistungen')
|
||||
->schema([
|
||||
Select::make('extra_id')->label('Leistung')->options(fn (): array => Extra::query()->orderBy('name')->get()->mapWithKeys(fn (Extra $extra): array => [$extra->id => $extra->name.($extra->price > 0 ? ' ('.Money::format($extra->price).')' : ' (kostenlos)')])->all())->required(),
|
||||
TextInput::make('quantity')->label('Menge')->integer()->minValue(1)->default(1)->required(),
|
||||
])
|
||||
->columns(2)
|
||||
->addActionLabel('Leistung hinzufügen'),
|
||||
])
|
||||
->action(function (array $data): void {
|
||||
$extras = [];
|
||||
foreach ((array) ($data['items'] ?? []) as $item) {
|
||||
$extras[(int) $item['extra_id']] = ((int) ($extras[(int) $item['extra_id']] ?? 0)) + max(1, (int) $item['quantity']);
|
||||
}
|
||||
$this->record->update(['extras' => $extras]);
|
||||
Notification::make()->title('Zusatzleistungen gespeichert')->success()->send();
|
||||
}),
|
||||
Action::make('contractText')
|
||||
->label('Vertragstext ansehen')
|
||||
->icon(Heroicon::OutlinedDocumentMagnifyingGlass)
|
||||
->color('gray')
|
||||
->visible(fn (): bool => $this->record->offer_terms !== null)
|
||||
->modalHeading(fn (): string => 'Vertrag '.$this->record->reference)
|
||||
->modalContent(fn () => view('filament.booking-contract', ['booking' => $this->record]))
|
||||
->modalSubmitAction(false)
|
||||
->modalCancelActionLabel('Schließen')
|
||||
->modalWidth('4xl'),
|
||||
Action::make('contract')
|
||||
->label('Mietvertrag')
|
||||
->icon(Heroicon::OutlinedDocumentText)
|
||||
->color('gray')
|
||||
->visible(fn (): bool => $this->record->contract_path !== null)
|
||||
->action(fn (RentalContract $contract) => response()->download($contract->absolutePath($this->record) ?? abort(404), "Mietvertrag-{$this->record->reference}.pdf")),
|
||||
ActionGroup::make([
|
||||
Action::make('notes')
|
||||
->label('Interne Notiz bearbeiten')
|
||||
->icon(Heroicon::OutlinedPencilSquare)
|
||||
->fillForm(fn (): array => ['internal_notes' => $this->record->internal_notes])
|
||||
private function resendConfirmationAction(): Action
|
||||
{
|
||||
return Action::make('resendConfirmation')
|
||||
->label(fn (): string => match (true) {
|
||||
$this->record->confirmation_failed_at !== null && $this->record->confirmation_sent_at === null => 'Unterlagen erneut senden (Versand fehlgeschlagen)',
|
||||
$this->record->confirmation_sent_at === null => 'Unterlagen an den Gast senden',
|
||||
default => 'Bestätigung erneut senden',
|
||||
})
|
||||
->icon(Heroicon::OutlinedEnvelope)
|
||||
->visible(fn (): bool => $this->record->isBinding() && filled($this->record->guest?->email) && ($this->record->confirmation_sent_at !== null || $this->record->confirmation_failed_at !== null))
|
||||
->requiresConfirmation()
|
||||
->modalDescription(fn (): string => 'Der Gast erhält dieselben Unterlagen noch einmal (Vorlage: '.(isset($this->record->offer_terms['template']['name']) ? $this->record->offer_terms['template']['name'].', Version '.$this->record->offer_terms['template']['version'] : 'Texte der Webseite').').')
|
||||
->action(function (ConfirmBooking $confirm): void {
|
||||
if ($this->record->contract_path === null) {
|
||||
Notification::make()->title('Bitte zuerst prüfen')->body('Die Unterlagen wurden noch nie erstellt – bitte über „Unterlagen prüfen und senden“.')->warning()->send();
|
||||
|
||||
return;
|
||||
}
|
||||
$sent = $confirm->resend($this->record->fresh());
|
||||
$this->record->refresh();
|
||||
$notification = Notification::make()->title($sent ? 'Unterlagen gesendet' : 'Versand fehlgeschlagen');
|
||||
($sent ? $notification->success() : $notification->danger()->body('Details im Postfach.'))->send();
|
||||
});
|
||||
}
|
||||
|
||||
private function portalPriceAction(): Action
|
||||
{
|
||||
return Action::make('portalPrice')
|
||||
->label('Gesamtpreis laut Portal eintragen')
|
||||
->icon(Heroicon::OutlinedCurrencyEuro)
|
||||
->visible(fn (): bool => $this->record->intake === IntakeKind::Booking && ! in_array($this->record->status, [BookingStatus::Cancelled, BookingStatus::Declined], true))
|
||||
->modalDescription('Der Betrag, den der Gast beim Portal gebucht hat (Gesamtpreis). Er wird so übernommen und nicht in eigene Positionen zerlegt.')
|
||||
->fillForm(fn (): array => ['portal_total' => $this->record->total, 'guests' => $this->record->guests])
|
||||
->schema([
|
||||
EuroInput::make('portal_total')->label('Gesamtpreis laut Portal')->required(),
|
||||
TextInput::make('guests')->label('Personen (falls bekannt)')->integer()->minValue(1),
|
||||
])
|
||||
->action(function (array $data, PortalPrice $price): void {
|
||||
$guests = filled($data['guests'] ?? null) ? (int) $data['guests'] : $this->record->guests;
|
||||
$this->record->update(['guests' => $guests, ...$price->columns($this->record->property, $this->record->arrival, $this->record->departure, $guests, (int) $data['portal_total'], $this->record->processChannel()?->name)]);
|
||||
CaseLog::record($this->record, 'price', 'Gesamtpreis laut Portal eingetragen: '.Money::format((int) $data['portal_total']));
|
||||
$blockers = app(CaseAutomation::class)->advance($this->record->fresh());
|
||||
$this->record->refresh();
|
||||
Notification::make()->title('Preis gespeichert')->body($blockers === [] ? null : implode(' ', $blockers))->success()->send();
|
||||
});
|
||||
}
|
||||
|
||||
private function extendHoldAction(): Action
|
||||
{
|
||||
return Action::make('extendHold')
|
||||
->label('Reservierung verlängern')
|
||||
->icon(Heroicon::OutlinedClock)
|
||||
->visible(fn (): bool => in_array($this->record->status, BookingStatus::holding(), true))
|
||||
->schema([TextInput::make('hours')->label('Um')->integer()->minValue(1)->default(24)->suffix('Stunden')->required()])
|
||||
->action(function (array $data): void {
|
||||
$from = $this->record->hold_expires_at?->isFuture() ? $this->record->hold_expires_at : now()->toImmutable();
|
||||
$this->record->update(['hold_expires_at' => $from->addHours((int) $data['hours'])]);
|
||||
Notification::make()->title('Reserviert bis '.$this->record->hold_expires_at->format('d.m.Y, H:i'))->success()->send();
|
||||
});
|
||||
}
|
||||
|
||||
private function servicesAction(): Action
|
||||
{
|
||||
return Action::make('services')
|
||||
->label('Zusatzleistungen erfassen')
|
||||
->icon(Heroicon::OutlinedPlusCircle)
|
||||
->visible(fn (): bool => ! in_array($this->record->status, [BookingStatus::Cancelled, BookingStatus::Declined, BookingStatus::Expired, BookingStatus::Completed], true))
|
||||
->modalDescription('Gebuchte Zusatzleistungen (z. B. aus einer Portalbuchung). Sie bestimmen, welche Vertragsanlagen angehängt werden. Der Preis ändert sich dadurch nicht.')
|
||||
->fillForm(fn (): array => ['items' => collect((array) $this->record->extras)->map(fn ($quantity, $id): array => ['extra_id' => (int) $id, 'quantity' => (int) $quantity])->values()->all()])
|
||||
->schema([
|
||||
Repeater::make('items')
|
||||
->label('Leistungen')
|
||||
->schema([
|
||||
Textarea::make('internal_notes')->label('Interne Notizen')->rows(6),
|
||||
Select::make('extra_id')->label('Leistung')->options(fn (): array => Extra::query()->orderBy('name')->get()->mapWithKeys(fn (Extra $extra): array => [$extra->id => $extra->name.($extra->price > 0 ? ' ('.Money::format($extra->price).')' : ' (kostenlos)')])->all())->required(),
|
||||
TextInput::make('quantity')->label('Menge')->integer()->minValue(1)->default(1)->required(),
|
||||
])
|
||||
->action(fn (array $data) => $this->record->update($data)),
|
||||
Action::make('setStatus')
|
||||
->label('Status von Hand ändern')
|
||||
->icon(Heroicon::OutlinedAdjustmentsHorizontal)
|
||||
->visible(fn (): bool => BookingProgress::kind($this->record) !== BookingProgress::OWN && $this->record->status !== BookingStatus::Declined)
|
||||
->modalHeading('Status von Hand ändern')
|
||||
->modalDescription('Für Buchungen, die das System nicht selbst weiterführt. Es werden keine E-Mails versendet. Wird die Buchung wieder verbindlich, prüft das System den Kalender. Stornieren und Ablehnen haben eigene Aktionen.')
|
||||
->schema([
|
||||
Select::make('status')->label('Neuer Status')->options(collect(SetBookingStatus::TARGETS)->mapWithKeys(fn (BookingStatus $status): array => [$status->value => $status->getLabel()])->all())->required(),
|
||||
Textarea::make('reason')->label('Grund / Anlass')->helperText('Wird in den internen Notizen festgehalten.')->required()->rows(2),
|
||||
])
|
||||
->action(function (array $data, SetBookingStatus $setStatus): void {
|
||||
try {
|
||||
$setStatus->handle($this->record, BookingStatus::from($data['status']), $data['reason'], auth()->user()->name);
|
||||
} catch (ReservationException $exception) {
|
||||
Notification::make()->title('Nicht möglich')->body($exception->getMessage())->danger()->send();
|
||||
->columns(2)
|
||||
->addActionLabel('Leistung hinzufügen'),
|
||||
])
|
||||
->action(function (array $data): void {
|
||||
$extras = [];
|
||||
foreach ((array) ($data['items'] ?? []) as $item) {
|
||||
$extras[(int) $item['extra_id']] = ((int) ($extras[(int) $item['extra_id']] ?? 0)) + max(1, (int) $item['quantity']);
|
||||
}
|
||||
$this->record->update(['extras' => $extras]);
|
||||
CaseLog::record($this->record, 'services', 'Zusatzleistungen erfasst');
|
||||
Notification::make()->title('Zusatzleistungen gespeichert')->success()->send();
|
||||
});
|
||||
}
|
||||
|
||||
return;
|
||||
}
|
||||
private function offerPdfAction(): Action
|
||||
{
|
||||
return Action::make('offerPdf')
|
||||
->label('Angebot (PDF)')
|
||||
->icon(Heroicon::OutlinedDocumentText)
|
||||
->visible(fn (): bool => $this->record->status === BookingStatus::OfferSent && $this->record->offer_path !== null)
|
||||
->action(fn (RentalContract $contract) => response()->download($contract->absolutePath($this->record, draft: true) ?? abort(404), "Angebot-{$this->record->reference}.pdf"));
|
||||
}
|
||||
|
||||
$this->record->refresh();
|
||||
Notification::make()->title('Status geändert')->success()->send();
|
||||
}),
|
||||
Action::make('archive')
|
||||
->label(fn (): string => $this->record->archived_at ? 'Aus dem Archiv holen' : 'Archivieren')
|
||||
->icon(Heroicon::OutlinedArchiveBox)
|
||||
->visible(fn (): bool => $this->record->archived_at !== null || $this->record->canBeArchived())
|
||||
->modalDescription(fn (): string => $this->record->archived_at ? 'Die Buchung erscheint wieder in der Liste.' : 'Die Buchung verschwindet aus der Standardliste. Verlauf, E-Mails, Zahlungen und Dokumente bleiben vollständig erhalten.')
|
||||
->requiresConfirmation()
|
||||
->action(function (): void {
|
||||
$this->record->update(['archived_at' => $this->record->archived_at ? null : now()]);
|
||||
Notification::make()->title($this->record->archived_at ? 'Archiviert' : 'Wieder aktiv')->success()->send();
|
||||
}),
|
||||
Action::make('cancel')
|
||||
->label('Stornieren')
|
||||
->icon(Heroicon::OutlinedNoSymbol)
|
||||
->color('danger')
|
||||
->visible(fn (): bool => in_array($this->record->status, BookingStatus::occupying(), true))
|
||||
->modalHeading('Buchung stornieren')
|
||||
->modalDescription('Der Zeitraum wird wieder freigegeben. Gast und Vermieter erhalten eine Stornierungs-E-Mail; die Stornokosten bleiben als Aufgabe offen.')
|
||||
->schema([
|
||||
Toggle::make('notify_guest')->label('Gast per E-Mail informieren')->default(true),
|
||||
Toggle::make('costs_task')->label('Aufgabe „Stornokosten prüfen“ anlegen')->default(true),
|
||||
])
|
||||
->action(function (array $data, CancelBooking $cancel): void {
|
||||
try {
|
||||
$informed = $cancel->handle($this->record, (bool) $data['notify_guest'], (bool) $data['costs_task'], auth()->user()->name);
|
||||
} catch (ReservationException $exception) {
|
||||
Notification::make()->title('Nicht möglich')->body($exception->getMessage())->danger()->send();
|
||||
private function contractAction(): Action
|
||||
{
|
||||
return Action::make('contract')
|
||||
->label('Mietvertrag (PDF)')
|
||||
->icon(Heroicon::OutlinedDocumentText)
|
||||
->visible(fn (): bool => $this->record->contract_path !== null)
|
||||
->action(fn (RentalContract $contract) => response()->download($contract->absolutePath($this->record) ?? abort(404), "Mietvertrag-{$this->record->reference}.pdf"));
|
||||
}
|
||||
|
||||
return;
|
||||
}
|
||||
private function offerLinkAction(): Action
|
||||
{
|
||||
return Action::make('offerLink')
|
||||
->label('Angebotslink')
|
||||
->icon(Heroicon::OutlinedLink)
|
||||
->visible(fn (): bool => $this->record->status === BookingStatus::OfferSent && $this->record->hold_expires_at?->isFuture())
|
||||
->modalHeading('Link zum Angebot')
|
||||
->modalDescription('Derselbe Link wie in der Angebots-E-Mail. Gültig bis zum Ende der Angebotsfrist.')
|
||||
->schema([TextInput::make('url')->label('Link')->default(fn (SendOffer $send): string => $send->offerUrl($this->record))->readOnly()->copyable()])
|
||||
->modalSubmitAction(false)
|
||||
->modalCancelActionLabel('Schließen');
|
||||
}
|
||||
|
||||
$notification = Notification::make()->title('Buchung storniert');
|
||||
($informed ? $notification->success() : $notification->warning()->body('Die Mail an den Gast konnte nicht gesendet werden – bitte den Gast selbst informieren.'))->send();
|
||||
}),
|
||||
]),
|
||||
];
|
||||
private function contractTextAction(): Action
|
||||
{
|
||||
return Action::make('contractText')
|
||||
->label('Vertragstext ansehen')
|
||||
->icon(Heroicon::OutlinedDocumentMagnifyingGlass)
|
||||
->visible(fn (): bool => $this->record->offer_terms !== null)
|
||||
->modalHeading(fn (): string => 'Vertrag '.$this->record->reference)
|
||||
->modalContent(fn () => view('filament.booking-contract', ['booking' => $this->record]))
|
||||
->modalSubmitAction(false)
|
||||
->modalCancelActionLabel('Schließen')
|
||||
->modalWidth('4xl');
|
||||
}
|
||||
|
||||
private function notesAction(): Action
|
||||
{
|
||||
return Action::make('notes')
|
||||
->label('Interne Notiz bearbeiten')
|
||||
->icon(Heroicon::OutlinedPencilSquare)
|
||||
->fillForm(fn (): array => ['internal_notes' => $this->record->internal_notes])
|
||||
->schema([Textarea::make('internal_notes')->label('Interne Notizen')->rows(6)])
|
||||
->action(fn (array $data) => $this->record->update($data));
|
||||
}
|
||||
|
||||
private function archiveAction(): Action
|
||||
{
|
||||
return Action::make('archive')
|
||||
->label(fn (): string => $this->record->archived_at ? 'Aus dem Archiv holen' : 'Archivieren')
|
||||
->icon(Heroicon::OutlinedArchiveBox)
|
||||
->visible(fn (): bool => $this->record->archived_at !== null || $this->record->canBeArchived())
|
||||
->modalDescription(fn (): string => $this->record->archived_at ? 'Der Vorgang erscheint wieder in der Liste.' : 'Der Vorgang verschwindet aus der Standardliste. Verlauf, E-Mails, Zahlungen und Dokumente bleiben erhalten.')
|
||||
->requiresConfirmation()
|
||||
->action(function (): void {
|
||||
$this->record->update(['archived_at' => $this->record->archived_at ? null : now()]);
|
||||
Notification::make()->title($this->record->archived_at ? 'Archiviert' : 'Wieder aktiv')->success()->send();
|
||||
});
|
||||
}
|
||||
|
||||
private function setStatusAction(): Action
|
||||
{
|
||||
return Action::make('setStatus')
|
||||
->label('Status von Hand ändern')
|
||||
->icon(Heroicon::OutlinedAdjustmentsHorizontal)
|
||||
->visible(fn (): bool => $this->record->source !== 'website' && $this->record->status !== BookingStatus::Declined)
|
||||
->modalHeading('Status von Hand ändern (Experte)')
|
||||
->modalDescription('Nur für Korrekturen. Es werden keine E-Mails versendet; der Grund steht im Verlauf. Eine verbindliche Buchung kann so nicht beendet oder zur Anfrage gemacht werden – dafür gibt es „Beenden“.')
|
||||
->schema([
|
||||
Select::make('status')->label('Neuer Status')->options(collect(SetBookingStatus::TARGETS)->mapWithKeys(fn (BookingStatus $status): array => [$status->value => $status->getLabel()])->all())->required(),
|
||||
Textarea::make('reason')->label('Grund')->required()->rows(2),
|
||||
])
|
||||
->action(function (array $data, SetBookingStatus $setStatus): void {
|
||||
try {
|
||||
$setStatus->handle($this->record, BookingStatus::from($data['status']), $data['reason'], auth()->user()->name);
|
||||
} catch (ReservationException $exception) {
|
||||
Notification::make()->title('Nicht möglich')->body($exception->getMessage())->danger()->send();
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
$this->record->refresh();
|
||||
Notification::make()->title('Status geändert')->success()->send();
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Automatic or manual handling of this case.
|
||||
*/
|
||||
private function automationAction(): ?Action
|
||||
{
|
||||
if (in_array($this->record->status, [BookingStatus::Cancelled, BookingStatus::Declined, BookingStatus::Expired, BookingStatus::Completed], true)) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$automatic = $this->record->processingMode() === ProcessingMode::Automatic;
|
||||
|
||||
return Action::make('automation')
|
||||
->label($automatic ? 'Läuft automatisch' : 'Sie geben frei')
|
||||
->icon($automatic ? Heroicon::OutlinedBolt : Heroicon::OutlinedHandRaised)
|
||||
->color('gray')
|
||||
->tooltip($automatic ? 'Das System macht selbst weiter, sobald alle Angaben da sind.' : 'Das System bereitet alles vor; Sie geben jeden Schritt frei.')
|
||||
->modalHeading('Wie soll dieser Vorgang weiterlaufen?')
|
||||
->modalDescription('Gilt nur für diesen Vorgang. Ihre allgemeine Einstellung finden Sie unter „So arbeite ich“.')
|
||||
->fillForm(fn (): array => ['mode' => $this->record->processingMode()->value])
|
||||
->schema([Radio::make('mode')->hiddenLabel()->options(ProcessingMode::class)->required()])
|
||||
->action(function (array $data): void {
|
||||
$this->record->update(['processing_mode' => $data['mode'] instanceof ProcessingMode ? $data['mode'] : ProcessingMode::from($data['mode'])]);
|
||||
$blockers = app(CaseAutomation::class)->advance($this->record->fresh());
|
||||
$this->record->refresh();
|
||||
Notification::make()->title($this->record->processingMode()->getLabel())->body($blockers === [] ? null : 'Wartet auf: '.implode(' ', $blockers))->success()->send();
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Ending a case: a request ends without booking; a binding booking is cancelled with its consequences (and on the
|
||||
* portal as well when the contract was made there). There is no way around it by changing the status.
|
||||
*/
|
||||
private function endAction(): ?Action
|
||||
{
|
||||
if (in_array($this->record->status, [BookingStatus::Cancelled, BookingStatus::Declined, BookingStatus::Expired, BookingStatus::Completed], true)) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$binding = $this->record->isBinding();
|
||||
$hasEmail = filled($this->record->guest?->email);
|
||||
|
||||
return Action::make('end')
|
||||
->label($binding ? 'Stornieren …' : 'Beenden …')
|
||||
->icon(Heroicon::OutlinedStopCircle)
|
||||
->color('danger')
|
||||
->outlined()
|
||||
->modalHeading($binding ? 'Gebuchten Vorgang stornieren' : 'Vorgang ohne Buchung beenden')
|
||||
->modalDescription($binding
|
||||
? 'Die Buchung ist verbindlich. Sie wird storniert, der Zeitraum frei. Stornokosten nach der vereinbarten Regel bleiben als Aufgabe offen.'.($this->record->caseType()->isExternallyBinding() ? ' Gebucht wurde beim Portal – dafür entsteht zusätzlich die Aufgabe, die Stornierung dort zu veranlassen bzw. zu prüfen.' : '')
|
||||
: 'Es ist noch keine verbindliche Buchung zustande gekommen. Der reservierte Zeitraum wird wieder frei.')
|
||||
->modalSubmitActionLabel($binding ? 'Stornieren' : 'Beenden')
|
||||
->schema(array_values(array_filter([
|
||||
$binding ? Radio::make('initiated_by')->label('Wer storniert?')->options(['guest' => 'Der Gast', 'landlord' => 'Wir (Vermieter)'])->required() : null,
|
||||
Textarea::make('reason')->label('Grund')->required()->rows(2),
|
||||
Toggle::make('notify')->label('Den Gast per E-Mail informieren')->default($hasEmail)->disabled(! $hasEmail),
|
||||
$binding ? Toggle::make('costs_task')->label('Aufgabe „Stornokosten prüfen“ anlegen')->default(true) : null,
|
||||
])))
|
||||
->action(function (array $data, CancelBooking $cancel, DeclineBooking $decline) use ($binding, $hasEmail): void {
|
||||
$notify = $hasEmail && (bool) ($data['notify'] ?? false);
|
||||
try {
|
||||
$informed = CaseLog::context(fn () => $binding
|
||||
? $cancel->handle($this->record, $notify, (bool) ($data['costs_task'] ?? true), auth()->user()->name, $data['initiated_by'])
|
||||
: $decline->handle($this->record, $notify), reason: trim((string) $data['reason']));
|
||||
} catch (ReservationException $exception) {
|
||||
Notification::make()->title('Nicht möglich')->body($exception->getMessage())->danger()->send();
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
$this->record->refresh();
|
||||
$notification = Notification::make()->title($binding ? 'Buchung storniert' : 'Vorgang beendet');
|
||||
($informed === false ? $notification->warning()->body('Die Mail an den Gast konnte nicht gesendet werden – bitte selbst informieren.') : $notification->success())->send();
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -375,8 +602,9 @@ private function contactRequestText(): string
|
||||
{
|
||||
$booking = $this->record;
|
||||
$landlord = config('fewo.owner.name') ?: config('app.name');
|
||||
$greeting = $booking->guest ? "Guten Tag {$booking->guest->first_name} {$booking->guest->last_name}," : 'Guten Tag,';
|
||||
|
||||
return "Guten Tag {$booking->guest->first_name} {$booking->guest->last_name},\n\n"
|
||||
return "{$greeting}\n\n"
|
||||
."vielen Dank für Ihre Buchung der {$booking->property->name} vom {$booking->arrival->format('d.m.Y')} bis {$booking->departure->format('d.m.Y')}. "
|
||||
."Für den Mietvertrag benötigen wir noch Ihre Kontaktdaten: vollständige Anschrift (Straße, PLZ, Ort), eine E-Mail-Adresse und eine Telefonnummer.\n\n"
|
||||
."Sobald wir die Angaben haben, senden wir Ihnen den Vertrag mit allen Informationen zu.\n\n"
|
||||
@@ -393,28 +621,31 @@ private function offerChanges(array $data): array
|
||||
{
|
||||
return [
|
||||
...$data,
|
||||
'acknowledged' => (bool) ($data['acknowledged'] ?? false),
|
||||
'price_adjustment' => filled($data['price_adjustment'] ?? null) ? (int) round((float) $data['price_adjustment'] * 100) : null,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* Live price shown in the offer modal, calculated exactly like the offer itself.
|
||||
* The current values of some fields of a modal form.
|
||||
*
|
||||
* @param list<string> $fields
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
private function offerPricePreview(Get $get): string
|
||||
private static function formState(Get $get, array $fields): array
|
||||
{
|
||||
try {
|
||||
$stay = new StayRequest(CarbonImmutable::parse($get('arrival')), CarbonImmutable::parse($get('departure')), (int) $get('guests'), $this->record->extras ?? [], filled($get('promo_code')) ? (string) $get('promo_code') : null);
|
||||
$quote = app(PriceCalculator::class)->calculate($this->record->property, $stay);
|
||||
} catch (QuoteException $exception) {
|
||||
return 'Preis: '.$exception->getMessage();
|
||||
} catch (Throwable) {
|
||||
return 'Preis: bitte Termin und Personen angeben.';
|
||||
}
|
||||
return collect($fields)->mapWithKeys(fn (string $field): array => [$field => $get($field)])->all();
|
||||
}
|
||||
|
||||
$adjustment = filled($get('price_adjustment')) ? max((int) round((float) $get('price_adjustment') * 100), -$quote->rent()) : 0;
|
||||
$promo = filled($get('promo_code')) ? ($quote->promoCodeApplied ? ' · Rabattcode angewendet' : ' · Rabattcode gilt hier nicht') : '';
|
||||
|
||||
return 'Gesamtpreis im Angebot: '.Money::format($quote->total() + $adjustment).' (bisher '.Money::format($this->record->total).')'.$promo;
|
||||
/**
|
||||
* Form data of the documents modal as composition changes.
|
||||
*
|
||||
* @param array<string, mixed> $data
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
private function documentChanges(array $data): array
|
||||
{
|
||||
return array_filter(Arr::only($data, ['contract_template_id', 'annex_ids']), fn ($value): bool => $value !== null);
|
||||
}
|
||||
|
||||
private function runWorkflow(callable $workflow, string $successTitle): void
|
||||
@@ -427,6 +658,7 @@ private function runWorkflow(callable $workflow, string $successTitle): void
|
||||
return;
|
||||
}
|
||||
|
||||
$this->record->refresh();
|
||||
Notification::make()->title($successTitle)->success()->send();
|
||||
}
|
||||
}
|
||||
@@ -2,8 +2,8 @@
|
||||
|
||||
namespace App\Filament\Resources\Bookings\Schemas;
|
||||
|
||||
use App\Actions\RecordPortalBooking;
|
||||
use App\Filament\Forms\Components\EuroInput;
|
||||
use App\Filament\Resources\BlockedPeriods\BlockedPeriodResource;
|
||||
use App\Models\Channel;
|
||||
use App\Models\Property;
|
||||
use App\Support\CurrentProperty;
|
||||
@@ -14,21 +14,49 @@
|
||||
use Filament\Forms\Components\TextInput;
|
||||
use Filament\Forms\Components\Toggle;
|
||||
use Filament\Schemas\Components\Section;
|
||||
use Filament\Schemas\Components\Text;
|
||||
use Filament\Schemas\Components\Utilities\Get;
|
||||
use Filament\Schemas\Schema;
|
||||
use Illuminate\Support\HtmlString;
|
||||
|
||||
/**
|
||||
* Manual entry of a booking received by phone or e-mail, or made binding by a portal (e.g. FeWo-direkt, usually
|
||||
* without the guest's contact data). The price is calculated automatically; a portal price can be entered.
|
||||
* "Neu": one entry for everything that arrives outside the website. The first question is what it is – a request,
|
||||
* a booking already binding on a portal, or own use / a block – and only the fields that matter for that answer follow.
|
||||
* Nothing has to be invented: unknown guest data, number of guests or portal price stay empty.
|
||||
*/
|
||||
class BookingForm
|
||||
{
|
||||
public const INQUIRY = 'inquiry';
|
||||
|
||||
public const EXTERNAL = 'external';
|
||||
|
||||
public const OWN_USE = 'own_use';
|
||||
|
||||
public static function configure(Schema $schema): Schema
|
||||
{
|
||||
$is = fn (string $kind): \Closure => fn (Get $get): bool => $get('kind') === $kind;
|
||||
$isCase = fn (Get $get): bool => in_array($get('kind'), [self::INQUIRY, self::EXTERNAL], true);
|
||||
|
||||
return $schema
|
||||
->components([
|
||||
Section::make('Aufenthalt')
|
||||
Section::make('Was möchten Sie eintragen?')
|
||||
->schema([
|
||||
Radio::make('kind')
|
||||
->hiddenLabel()
|
||||
->options([
|
||||
self::INQUIRY => 'Eine Anfrage – per Telefon, E-Mail oder Nachricht über ein Portal',
|
||||
self::EXTERNAL => 'Eine Buchung, die bei einem Portal schon fest gebucht ist',
|
||||
self::OWN_USE => 'Eigene Nutzung oder eine Sperre (z. B. Wartung)',
|
||||
])
|
||||
->default(self::INQUIRY)
|
||||
->required()
|
||||
->live(),
|
||||
Text::make(new HtmlString('Eigene Nutzung und Sperren tragen Sie bis auf Weiteres unter <a class="underline" href="'.e(BlockedPeriodResource::getUrl()).'">Sperrzeiten</a> ein.'))
|
||||
->visible($is(self::OWN_USE)),
|
||||
]),
|
||||
Section::make('Zeitraum')
|
||||
->columns(2)
|
||||
->visible($isCase)
|
||||
->schema([
|
||||
Select::make('property_id')
|
||||
->label('Wohnung')
|
||||
@@ -40,58 +68,55 @@ public static function configure(Schema $schema): Schema
|
||||
->label('Personen')
|
||||
->integer()
|
||||
->minValue(1)
|
||||
->default(2)
|
||||
->required(),
|
||||
DatePicker::make('arrival')
|
||||
->label('Anreise')
|
||||
->required(),
|
||||
DatePicker::make('departure')
|
||||
->label('Abreise')
|
||||
->after('arrival')
|
||||
->required(),
|
||||
TextInput::make('promo_code')
|
||||
->label('Aktionscode'),
|
||||
->helperText(fn (Get $get): ?string => $get('kind') === self::EXTERNAL ? 'Leer lassen, wenn nicht bekannt.' : null)
|
||||
->required($is(self::INQUIRY)),
|
||||
DatePicker::make('arrival')->label('Anreise')->required(),
|
||||
DatePicker::make('departure')->label('Abreise')->after('arrival')->required(),
|
||||
]),
|
||||
Section::make('Buchungsweg')
|
||||
->description('Telefon oder E-Mail: nichts auswählen. Hat ein Portal die Buchung bereits verbindlich gemacht (z. B. FeWo-direkt), das Portal wählen – dann genügen Name und Zeitraum, die Kontaktdaten können später nachgetragen werden.')
|
||||
Section::make('Portal')
|
||||
->columns(2)
|
||||
->visible($isCase)
|
||||
->schema([
|
||||
Select::make('channel_id')
|
||||
->label('Über Portal')
|
||||
->placeholder('Direkt / telefonisch / per E-Mail')
|
||||
->label(fn (Get $get): string => $get('kind') === self::EXTERNAL ? 'Gebucht über' : 'Über ein Portal (optional)')
|
||||
->placeholder('Direkt – kein Portal')
|
||||
->options(fn (Get $get): array => Channel::query()->where('property_id', $get('property_id'))->orderBy('name')->pluck('name', 'id')->all())
|
||||
->live(),
|
||||
TextInput::make('portal_reference')->label('Referenz im Portal (Buchungsnummer)')->maxLength(100)->visible(fn (Get $get): bool => filled($get('channel_id'))),
|
||||
EuroInput::make('portal_total')->label('Preis laut Portal (Gesamtpreis, optional)')->helperText('Weicht er von unserer Berechnung ab, wird die Differenz als Zeile „Abweichung Portalpreis“ geführt.')->visible(fn (Get $get): bool => filled($get('channel_id'))),
|
||||
->required($is(self::EXTERNAL)),
|
||||
TextInput::make('portal_reference')->label('Buchungsnummer im Portal')->maxLength(100)->visible($is(self::EXTERNAL)),
|
||||
EuroInput::make('portal_total')
|
||||
->label('Gesamtpreis laut Portal')
|
||||
->helperText('Der Betrag, den der Gast beim Portal gebucht hat. Leer lassen, wenn noch nicht bekannt – er wird nicht geschätzt.')
|
||||
->visible($is(self::EXTERNAL)),
|
||||
]),
|
||||
Section::make('Gast')
|
||||
->description(fn (Get $get): ?string => filled($get('channel_id')) ? 'Bei Portalbuchungen ohne Kontaktdaten genügt der Name – E-Mail und Adresse können später ergänzt werden.' : null)
|
||||
->description('Nur eintragen, was bekannt ist. Fehlendes wird später ergänzt; das System erinnert daran.')
|
||||
->columns(2)
|
||||
->visible($isCase)
|
||||
->schema([
|
||||
TextInput::make('first_name')->label('Vorname')->required()->maxLength(255),
|
||||
TextInput::make('last_name')->label('Nachname')->required()->maxLength(255),
|
||||
TextInput::make('email')->label('E-Mail')->email()->required(fn (Get $get): bool => blank($get('channel_id')))->maxLength(255),
|
||||
TextInput::make('first_name')->label('Vorname')->required($is(self::INQUIRY))->maxLength(255),
|
||||
TextInput::make('last_name')->label('Nachname')->required($is(self::INQUIRY))->maxLength(255),
|
||||
TextInput::make('email')->label('E-Mail')->email()->maxLength(255),
|
||||
TextInput::make('phone')->label('Telefon')->tel()->maxLength(50),
|
||||
TextInput::make('street')->label('Straße')->maxLength(255),
|
||||
TextInput::make('postal_code')->label('PLZ')->maxLength(20),
|
||||
TextInput::make('city')->label('Ort')->maxLength(255),
|
||||
Toggle::make('guest_confirmed')->label('Der Gast hat die Buchung bereits per E-Mail bestätigt')->visible($is(self::EXTERNAL)),
|
||||
]),
|
||||
Section::make('Abschluss')
|
||||
Section::make('Wie geht es weiter?')
|
||||
->visible($is(self::INQUIRY))
|
||||
->schema([
|
||||
Textarea::make('internal_notes')->label('Interne Notiz'),
|
||||
Toggle::make('confirm_immediately')->label('Sofort verbindlich bestätigen')->default(true)->visible(fn (Get $get): bool => blank($get('channel_id'))),
|
||||
Toggle::make('send_mails')->label('E-Mails an den Gast senden')->default(false)->visible(fn (Get $get): bool => blank($get('channel_id'))),
|
||||
Radio::make('portal_process')
|
||||
->label('Wie geht der Vertragsprozess weiter?')
|
||||
->options([
|
||||
RecordPortalBooking::CONFIRM => 'Buchung bestätigen (Zeitraum belegen), Vertrag später – sobald die Kontaktdaten da sind',
|
||||
RecordPortalBooking::CONTRACT => 'Buchung bestätigen und Vertrag jetzt per E-Mail senden (E-Mail-Adresse nötig)',
|
||||
RecordPortalBooking::RECORD => 'Nur als Anfrage erfassen – alles Weitere von Hand',
|
||||
])
|
||||
->default(RecordPortalBooking::CONFIRM)
|
||||
->required(fn (Get $get): bool => filled($get('channel_id')))
|
||||
->visible(fn (Get $get): bool => filled($get('channel_id'))),
|
||||
Toggle::make('guest_confirmed')->label('Der Gast hat die Buchung bereits per E-Mail bestätigt')->visible(fn (Get $get): bool => filled($get('channel_id'))),
|
||||
Toggle::make('confirm_immediately')
|
||||
->label('Die Buchung ist mit dem Gast schon fest vereinbart – gleich verbindlich eintragen')
|
||||
->helperText('Aus: Das System bereitet das Angebot vor; je nach Einstellung geht es automatisch hinaus oder wartet auf Ihre Freigabe.')
|
||||
->default(false),
|
||||
Toggle::make('send_mails')->label('Dem Gast E-Mails senden (Eingangsbestätigung bzw. Buchungsbestätigung)')->default(true),
|
||||
TextInput::make('promo_code')->label('Aktionscode')->maxLength(50),
|
||||
]),
|
||||
Section::make('Notiz')
|
||||
->visible($isCase)
|
||||
->collapsed()
|
||||
->schema([
|
||||
Textarea::make('internal_notes')->hiddenLabel()->placeholder('Interne Notiz (nur für Sie sichtbar)'),
|
||||
]),
|
||||
]);
|
||||
}
|
||||
|
||||
@@ -3,8 +3,17 @@
|
||||
namespace App\Filament\Resources\Bookings\Schemas;
|
||||
|
||||
use App\Documents\OfferTerms;
|
||||
use App\Enums\ActivityState;
|
||||
use App\Enums\AdminMode;
|
||||
use App\Enums\DocumentKind;
|
||||
use App\Enums\ProcessingMode;
|
||||
use App\Enums\ProcessSetting;
|
||||
use App\Enums\Responsibility;
|
||||
use App\Models\Booking;
|
||||
use App\Support\BookingProgress;
|
||||
use App\Models\User;
|
||||
use App\Process\CaseActivities;
|
||||
use App\Process\CaseAutomation;
|
||||
use App\Process\ProcessProfile;
|
||||
use App\Support\Money;
|
||||
use Carbon\CarbonImmutable;
|
||||
use Filament\Infolists\Components\RepeatableEntry;
|
||||
@@ -15,189 +24,211 @@
|
||||
use Filament\Schemas\Schema;
|
||||
use Illuminate\Support\HtmlString;
|
||||
|
||||
/**
|
||||
* The case page: first where it stands and what is next, then the activities and the history, then the facts (guest,
|
||||
* stay, price and payments, documents). Technical details are shown in the expert view only.
|
||||
*/
|
||||
class BookingInfolist
|
||||
{
|
||||
/**
|
||||
* The process as a checklist: every milestone with its state and the activities that belong to it. Open
|
||||
* activities name the action on this page that does them.
|
||||
*/
|
||||
private static function timeline(Booking $booking): HtmlString
|
||||
{
|
||||
$badge = [
|
||||
'done' => ['✓', '#16a34a', 'erledigt'],
|
||||
'current' => ['●', '#d97706', 'jetzt'],
|
||||
'todo' => ['○', '#9ca3af', 'später'],
|
||||
'skipped' => ['–', '#9ca3af', 'entfällt'],
|
||||
];
|
||||
|
||||
$rows = collect(BookingProgress::steps($booking))->map(function (array $step) use ($badge): string {
|
||||
[$icon, $color, $word] = $badge[$step['state']];
|
||||
$activities = collect($step['activities'])->map(fn (array $activity): string => '<li style="margin:.15rem 0;'.($activity['done'] ? 'color:#15803d' : '').'">'.($activity['done'] ? '✓ ' : '○ ').e($activity['label']).($activity['action'] && $step['state'] !== 'skipped' ? ' <span style="color:#b45309">→ Aktion „'.e($activity['action']).'“</span>' : '').'</li>')->implode('');
|
||||
|
||||
return '<div style="display:flex;gap:.75rem;padding:.55rem 0;border-bottom:1px solid rgba(128,128,128,.25)">'
|
||||
.'<div style="width:1.6rem;text-align:center;font-weight:700;color:'.$color.'" title="'.$word.'">'.$icon.'</div>'
|
||||
.'<div style="flex:1"><div style="'.($step['state'] === 'current' ? 'font-weight:700' : '').($step['state'] === 'skipped' ? ';color:#9ca3af' : '').'">'.e($step['label']).($step['detail'] ? ' <span style="font-weight:400;color:#6b7280">· '.e($step['detail']).'</span>' : '').'</div>'
|
||||
.($activities !== '' ? '<ul style="list-style:none;padding:0;margin:.2rem 0 0;font-size:.85rem">'.$activities.'</ul>' : '').'</div></div>';
|
||||
})->implode('');
|
||||
|
||||
return new HtmlString('<div>'.$rows.'</div>');
|
||||
}
|
||||
|
||||
/**
|
||||
* What has happened so far, oldest first.
|
||||
*/
|
||||
private static function chronicle(Booking $booking): HtmlString
|
||||
{
|
||||
$rows = collect(BookingProgress::history($booking))->map(fn (array $event): string => '<li style="margin:.2rem 0"><span style="color:#6b7280">'.$event['at']->format('d.m.Y H:i').'</span> · '.e($event['label']).'</li>')->implode('');
|
||||
|
||||
return new HtmlString('<ul style="list-style:none;padding:0;margin:0;font-size:.9rem">'.$rows.'</ul>');
|
||||
}
|
||||
|
||||
/**
|
||||
* The standard process that applies to this booking: which template (with cancellation rule and annexes) comes from
|
||||
* the portal and booking type, and whether payments become tasks.
|
||||
*/
|
||||
private static function setup(Booking $booking): string
|
||||
{
|
||||
$channel = $booking->importChannel ?? $booking->originChannel;
|
||||
$template = OfferTerms::templateFor($booking);
|
||||
$policy = $template?->cancellationPolicy;
|
||||
$annexes = $template?->annexesFor($booking)->map(fn ($annex) => $annex->name)->implode(', ');
|
||||
|
||||
return collect([
|
||||
$channel ? 'Portal: '.$channel->name : 'Eigene Buchung (Webseite / manuell)',
|
||||
'Vertragsvorlage: '.($template ? $template->label() : 'Texte der Webseite'),
|
||||
'Stornoregel: '.($policy ? $policy->name : 'keine hinterlegt'),
|
||||
'Anlagen: '.($annexes ?: 'keine'),
|
||||
'Zahlungsaufgaben: '.($booking->wantsPaymentTasks() ? 'ja' : 'nein (läuft über das Portal)'),
|
||||
])->implode(' · ');
|
||||
}
|
||||
|
||||
public static function configure(Schema $schema): Schema
|
||||
{
|
||||
return $schema
|
||||
->columns(3)
|
||||
->components([
|
||||
Section::make('Vorgang')
|
||||
Section::make('Als Nächstes')
|
||||
->columnSpanFull()
|
||||
->schema([
|
||||
TextEntry::make('process')->label('Art des Vorgangs')->state(fn (Booking $record): string => BookingProgress::kindLabel($record)),
|
||||
TextEntry::make('next')
|
||||
->label(fn (Booking $record): string => 'Nächster Schritt: '.BookingProgress::next($record)['title'])
|
||||
->state(fn (Booking $record): string => BookingProgress::next($record)['text'])
|
||||
->color(fn (Booking $record): string => BookingProgress::next($record)['color'])
|
||||
->weight('bold'),
|
||||
TextEntry::make('setup')
|
||||
->label('Standardprozess (aus Portal und Buchungstyp)')
|
||||
->state(fn (Booking $record): string => self::setup($record))
|
||||
->columnSpanFull(),
|
||||
TextEntry::make('steps')
|
||||
->label('Ablauf: Meilensteine und Aktivitäten')
|
||||
->state(fn (Booking $record): HtmlString => self::timeline($record))
|
||||
->html()
|
||||
->columnSpanFull(),
|
||||
TextEntry::make('chronicle')
|
||||
->label('Bisheriger Verlauf')
|
||||
->state(fn (Booking $record): HtmlString => self::chronicle($record))
|
||||
->html()
|
||||
->columnSpanFull(),
|
||||
->hiddenLabel()
|
||||
->state(fn (Booking $record): HtmlString => self::nextStep($record))
|
||||
->html(),
|
||||
]),
|
||||
Grid::make(1)
|
||||
->columnSpan(2)
|
||||
->schema([
|
||||
Section::make('Vertrag')
|
||||
->columns(2)
|
||||
->schema([
|
||||
TextEntry::make('contract_template')->label('Vorlage')->state(fn (Booking $record): string => isset($record->offer_terms['template']) ? $record->offer_terms['template']['name'].' (Version '.$record->offer_terms['template']['version'].')' : ($record->offer_terms ? 'Texte der Webseite (Stand '.CarbonImmutable::parse($record->offer_terms['captured_at'])->format('d.m.Y').')' : 'Noch kein Angebot / Vertrag')),
|
||||
TextEntry::make('contract_state')->label('Dokumente')->state(fn (Booking $record): string => collect([
|
||||
$record->offer_path ? 'Angebot (PDF) Version '.$record->offer_version : null,
|
||||
$record->contract_path ? 'Mietvertrag (PDF, unveränderlich, Prüfsumme '.substr((string) $record->contract_pdf_sha256, 0, 10).')' : null,
|
||||
])->filter()->implode(' · ') ?: 'Noch kein Dokument – der Vertrag entsteht mit dem Angebot bzw. der Bestätigung'),
|
||||
TextEntry::make('contract_mail')->label('Zustellung')->state(fn (Booking $record): string => $record->confirmation_sent_at ? 'Bestätigung mit Vertrag gesendet am '.$record->confirmation_sent_at->format('d.m.Y, H:i') : ($record->confirmation_failed_at ? 'Versand fehlgeschlagen' : 'Noch nicht gesendet'))->columnSpanFull(),
|
||||
]),
|
||||
Section::make('Aufenthalt')
|
||||
->columns(3)
|
||||
->schema([
|
||||
TextEntry::make('property.name')->label('Wohnung'),
|
||||
TextEntry::make('arrival')->label('Anreise')->date('l, d.m.Y'),
|
||||
TextEntry::make('departure')->label('Abreise')->date('l, d.m.Y'),
|
||||
TextEntry::make('nights')->label('Nächte')->state(fn (Booking $record): int => $record->nights()),
|
||||
TextEntry::make('guests')->label('Personen'),
|
||||
TextEntry::make('promo_code')->label('Aktionscode')->placeholder('–'),
|
||||
]),
|
||||
Section::make('Preis')
|
||||
Section::make('Ablauf')
|
||||
->description('Was erledigt ist, was wartet und was noch kommt.')
|
||||
->schema([TextEntry::make('activities')->hiddenLabel()->state(fn (Booking $record): HtmlString => self::activities($record))->html()]),
|
||||
Section::make('Preis und Zahlungen')
|
||||
->schema([
|
||||
TextEntry::make('price_unknown')
|
||||
->hiddenLabel()
|
||||
->state('Der Gesamtpreis ist noch nicht bekannt.')
|
||||
->color('warning')
|
||||
->visible(fn (Booking $record): bool => $record->total === null),
|
||||
RepeatableEntry::make('quote.lines')
|
||||
->hiddenLabel()
|
||||
->table([
|
||||
TableColumn::make('Leistung'),
|
||||
TableColumn::make('Betrag')->alignEnd(),
|
||||
])
|
||||
->visible(fn (Booking $record): bool => filled($record->quote['lines'] ?? null))
|
||||
->table([TableColumn::make('Leistung'), TableColumn::make('Betrag')->alignEnd()])
|
||||
->schema([
|
||||
TextEntry::make('label'),
|
||||
TextEntry::make('amount')->formatStateUsing(fn (int $state): string => Money::format($state))->alignEnd(),
|
||||
]),
|
||||
Grid::make(4)->schema([
|
||||
Grid::make(4)->visible(fn (Booking $record): bool => $record->total !== null)->schema([
|
||||
TextEntry::make('total')->label('Gesamtpreis')->money('EUR', divideBy: 100, locale: 'de')->weight('bold'),
|
||||
TextEntry::make('deposit')->label('Anzahlung')->money('EUR', divideBy: 100, locale: 'de'),
|
||||
TextEntry::make('balance')->label('Restzahlung')->state(fn (Booking $record): string => Money::format($record->total - $record->deposit)),
|
||||
TextEntry::make('balance_due_on')->label('Rest fällig am')->date('d.m.Y'),
|
||||
TextEntry::make('paid')->label('Bezahlt')->state(fn (Booking $record): string => Money::format($record->paidAmount())),
|
||||
TextEntry::make('open')->label('Offen')->state(fn (Booking $record): string => Money::format($record->openAmount()))->color(fn (Booking $record): string => $record->openAmount() > 0 ? 'danger' : 'success'),
|
||||
TextEntry::make('deposit_due_on')->label('Anzahlung fällig am')->date('d.m.Y')->placeholder('–'),
|
||||
TextEntry::make('open')->label('Offen')
|
||||
->state(fn (Booking $record): string => $record->process()->payments() === Responsibility::Portal ? 'über das Portal' : Money::format($record->openAmount()))
|
||||
->color(fn (Booking $record): string => $record->process()->payments() === Responsibility::Landlord && $record->openAmount() > 0 ? 'danger' : 'success'),
|
||||
TextEntry::make('balance_due_on')->label('Rest fällig am')->date('d.m.Y')->placeholder('–'),
|
||||
]),
|
||||
]),
|
||||
Section::make('Verlauf')
|
||||
->collapsible()
|
||||
->schema([TextEntry::make('history')->hiddenLabel()->state(fn (Booking $record): HtmlString => self::history($record))->html()]),
|
||||
Section::make('Nachricht des Gastes')
|
||||
->visible(fn (Booking $record): bool => filled($record->message))
|
||||
->schema([
|
||||
TextEntry::make('message')->hiddenLabel(),
|
||||
]),
|
||||
->schema([TextEntry::make('message')->hiddenLabel()]),
|
||||
]),
|
||||
Grid::make(1)
|
||||
->columnSpan(1)
|
||||
->schema([
|
||||
Section::make('Status')
|
||||
->schema([
|
||||
TextEntry::make('status')->label('Status')->badge(),
|
||||
TextEntry::make('hold_expires_at')->label('Vorgemerkt bis')->dateTime('d.m.Y, H:i')->visible(fn (Booking $record): bool => $record->hold_expires_at !== null),
|
||||
TextEntry::make('confirmed_at')->label('Bestätigt am')->dateTime('d.m.Y, H:i')->visible(fn (Booking $record): bool => $record->confirmed_at !== null),
|
||||
TextEntry::make('created_at')->label('Eingegangen')->dateTime('d.m.Y, H:i'),
|
||||
TextEntry::make('processing')
|
||||
->label('Bearbeitung / Vorreservierung')
|
||||
->state(fn (Booking $record): string => $record->property->offer_mode->value === 'automatic' ? 'Automatisch' : 'Manuell')
|
||||
->visible(fn (Booking $record): bool => $record->isDirect()),
|
||||
TextEntry::make('offer')
|
||||
->label('Angebot')
|
||||
->state(fn (Booking $record): string => 'Version '.$record->offer_version.', gesendet '.$record->offer_sent_at?->format('d.m.Y, H:i').' · Prüfsumme '.substr((string) $record->offer_hash, 0, 12).(isset($record->offer_terms['template']) ? ' · Vorlage '.$record->offer_terms['template']['name'].' v'.$record->offer_terms['template']['version'] : ''))
|
||||
->visible(fn (Booking $record): bool => $record->offer_version > 0),
|
||||
TextEntry::make('accepted_at')->label('Angenommen am')->dateTime('d.m.Y, H:i:s')->visible(fn (Booking $record): bool => $record->accepted_at !== null),
|
||||
TextEntry::make('confirmation')
|
||||
->label('Bestätigungs-E-Mail')
|
||||
->state(fn (Booking $record): string => $record->confirmation_sent_at !== null ? 'Gesendet '.$record->confirmation_sent_at->format('d.m.Y, H:i') : 'Nicht zugestellt – bitte „Bestätigung erneut senden“')
|
||||
->color(fn (Booking $record): string => $record->confirmation_sent_at !== null ? 'success' : 'danger')
|
||||
->visible(fn (Booking $record): bool => $record->confirmation_sent_at !== null || $record->confirmation_failed_at !== null),
|
||||
TextEntry::make('source')->label('Buchungskanal / Quelle')->state(fn (Booking $record): string => $record->bookingChannelLabel()),
|
||||
TextEntry::make('referral_source')->label('Aufmerksam geworden durch')->placeholder('–'),
|
||||
TextEntry::make('utm')
|
||||
->label('Kampagne (UTM)')
|
||||
->state(fn (Booking $record): ?string => collect([$record->utm_source, $record->utm_medium, $record->utm_campaign])->filter()->implode(' / ') ?: null)
|
||||
->visible(fn (Booking $record): bool => filled($record->utm_source)),
|
||||
]),
|
||||
Section::make('Gast')
|
||||
->schema([
|
||||
TextEntry::make('guest.full_name')->label('Name'),
|
||||
TextEntry::make('guest.email')->label('E-Mail')->placeholder('Unbekannt')->copyable(),
|
||||
TextEntry::make('guest_name')->label('Name')->state(fn (Booking $record): string => $record->guestName())
|
||||
->color(fn (Booking $record): ?string => $record->guest === null ? 'warning' : null),
|
||||
TextEntry::make('guest.email')->label('E-Mail')->placeholder('noch nicht bekannt')->copyable(),
|
||||
TextEntry::make('guest.phone')->label('Telefon')->placeholder('–'),
|
||||
TextEntry::make('guest_address')
|
||||
->label('Adresse')
|
||||
->state(fn (Booking $record): ?string => collect([$record->guest->street, trim("{$record->guest->postal_code} {$record->guest->city}")])->filter()->implode(', ') ?: null)
|
||||
->state(fn (Booking $record): ?string => $record->guest === null ? null : (collect([$record->guest->street, trim("{$record->guest->postal_code} {$record->guest->city}")])->filter()->implode(', ') ?: null))
|
||||
->placeholder('–'),
|
||||
]),
|
||||
Section::make('Interne Notizen')
|
||||
Section::make('Aufenthalt')
|
||||
->schema([
|
||||
TextEntry::make('internal_notes')->hiddenLabel()->placeholder('Keine Notizen'),
|
||||
TextEntry::make('property.name')->label('Wohnung'),
|
||||
TextEntry::make('period')->label('Zeitraum')->state(fn (Booking $record): string => $record->arrival->translatedFormat('D, d.m.Y').' – '.$record->departure->translatedFormat('D, d.m.Y').' ('.$record->nights().' Nächte)'),
|
||||
TextEntry::make('guests')->label('Personen')->placeholder('noch nicht bekannt'),
|
||||
TextEntry::make('channel')->label('Über')->state(fn (Booking $record): string => $record->bookingChannelLabel().($record->portal_reference ? ' · Nr. '.$record->portal_reference : '')),
|
||||
]),
|
||||
Section::make('Dokumente')
|
||||
->schema([
|
||||
TextEntry::make('documents')->hiddenLabel()->html()->state(fn (Booking $record): HtmlString => self::documents($record)),
|
||||
TextEntry::make('document_kind')->label('Vorgesehen')->state(fn (Booking $record): string => DocumentKind::forCase($record)?->getLabel() ?? 'Unterlagen schickt das Portal'),
|
||||
TextEntry::make('template')->label('Vorlage')->state(fn (Booking $record): string => isset($record->offer_terms['template']) && ($record->contract_path !== null || $record->offer_path !== null)
|
||||
? $record->offer_terms['template']['name'].' (Version '.$record->offer_terms['template']['version'].', festgeschrieben)'
|
||||
: (OfferTerms::templateFor($record)?->label() ?? 'Texte der Webseite').' (vorgesehen)'),
|
||||
]),
|
||||
Section::make('Interne Notizen')
|
||||
->collapsible()
|
||||
->schema([TextEntry::make('internal_notes')->hiddenLabel()->placeholder('Keine Notizen')]),
|
||||
]),
|
||||
Section::make('Technische Angaben')
|
||||
->description('Expertenansicht')
|
||||
->columnSpanFull()
|
||||
->collapsed()
|
||||
->visible(fn (): bool => auth()->user() instanceof User && auth()->user()->adminMode() === AdminMode::Expert)
|
||||
->columns(3)
|
||||
->schema([
|
||||
TextEntry::make('status')->label('Status')->badge(),
|
||||
TextEntry::make('case_type')->label('Vorgangsart')->state(fn (Booking $record): string => strtoupper($record->caseType()->value).' – '.$record->caseType()->getLabel()),
|
||||
TextEntry::make('intake')->label('Eingangsart')->state(fn (Booking $record): string => $record->intake?->getLabel() ?? '–'),
|
||||
TextEntry::make('profile')->label('Abwicklungsprofil (eingefroren)')->state(fn (Booking $record): HtmlString => self::profile($record))->html()->columnSpanFull(),
|
||||
TextEntry::make('hold_expires_at')->label('Reserviert bis')->dateTime('d.m.Y, H:i')->placeholder('–'),
|
||||
TextEntry::make('offer_hash')->label('Angebot (Prüfsumme)')->state(fn (Booking $record): ?string => $record->offer_version > 0 ? 'Version '.$record->offer_version.' · '.substr((string) $record->offer_hash, 0, 16) : null)->placeholder('–'),
|
||||
TextEntry::make('contract_pdf_sha256')->label('Vertrag (Prüfsumme)')->formatStateUsing(fn (?string $state): string => substr((string) $state, 0, 16))->placeholder('–'),
|
||||
TextEntry::make('accepted_at')->label('Angenommen am')->dateTime('d.m.Y, H:i:s')->placeholder('–'),
|
||||
TextEntry::make('source')->label('Quelle'),
|
||||
TextEntry::make('referral_source')->label('Aufmerksam geworden durch')->placeholder('–'),
|
||||
TextEntry::make('utm')->label('Kampagne (UTM)')->state(fn (Booking $record): ?string => collect([$record->utm_source, $record->utm_medium, $record->utm_campaign])->filter()->implode(' / ') ?: null)->placeholder('–'),
|
||||
TextEntry::make('created_at')->label('Eingegangen')->dateTime('d.m.Y, H:i'),
|
||||
]),
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* The next step in large type, with what keeps an automatic case waiting.
|
||||
*/
|
||||
private static function nextStep(Booking $booking): HtmlString
|
||||
{
|
||||
$next = CaseActivities::next($booking);
|
||||
$automatic = $booking->processingMode() === ProcessingMode::Automatic;
|
||||
$waiting = collect(CaseActivities::for($booking))->first(fn ($activity): bool => $activity->state === ActivityState::Waiting);
|
||||
|
||||
$title = match (true) {
|
||||
$next !== null => e($next->label),
|
||||
$waiting !== null => 'Nichts zu tun – es wartet: '.e($waiting->label),
|
||||
default => 'Nichts zu tun.',
|
||||
};
|
||||
$color = $next?->state === ActivityState::Problem ? '#dc2626' : ($next !== null ? '#b45309' : '#15803d');
|
||||
$detail = $next?->detail ?? $waiting?->detail;
|
||||
$mode = $automatic
|
||||
? 'Dieser Vorgang läuft automatisch weiter, sobald alle Angaben da sind.'.(($blockers = self::blockers($booking)) !== [] ? ' Es fehlt: '.e(implode(' ', $blockers)) : '')
|
||||
: 'Sie geben jeden Schritt selbst frei. Der Knopf oben rechts führt zum nächsten Schritt.';
|
||||
|
||||
return new HtmlString('<div style="font-size:1.35rem;font-weight:700;color:'.$color.'">'.$title.'</div>'
|
||||
.($detail ? '<div style="margin-top:.2rem">'.e($detail).'</div>' : '')
|
||||
.'<div style="margin-top:.5rem;color:#6b7280;font-size:.9rem">'.$mode.'</div>');
|
||||
}
|
||||
|
||||
/**
|
||||
* The documents made for the case, as recorded when they were created (kind, template, date).
|
||||
*/
|
||||
private static function documents(Booking $booking): HtmlString
|
||||
{
|
||||
$lines = $booking->events()->where('type', 'document')->whereNotNull('data')->reorder()->orderBy('occurred_at')->orderBy('id')->get()
|
||||
->filter(fn ($event): bool => isset($event->data['kind']))
|
||||
->map(fn ($event): string => e($event->occurred_at->format('d.m.Y').' · '.$event->summary));
|
||||
|
||||
if ($lines->isEmpty()) {
|
||||
$lines = collect([
|
||||
$booking->offer_path ? 'Angebot Version '.$booking->offer_version : null,
|
||||
$booking->contract_path ? 'Mietvertrag' : null,
|
||||
$booking->confirmation_sent_at ? 'Bestätigung gesendet am '.$booking->confirmation_sent_at->format('d.m.Y') : null,
|
||||
])->filter()->map(fn (string $line): string => e($line));
|
||||
}
|
||||
|
||||
return new HtmlString($lines->isEmpty() ? 'Noch keine' : $lines->implode('<br>'));
|
||||
}
|
||||
|
||||
/**
|
||||
* @return list<string>
|
||||
*/
|
||||
private static function blockers(Booking $booking): array
|
||||
{
|
||||
return $booking->isBinding() && $booking->confirmation_sent_at === null && $booking->process()->documents() === Responsibility::Landlord
|
||||
? app(CaseAutomation::class)->documentBlockers($booking)
|
||||
: [];
|
||||
}
|
||||
|
||||
private static function activities(Booking $booking): HtmlString
|
||||
{
|
||||
$colors = ['success' => '#15803d', 'warning' => '#b45309', 'danger' => '#dc2626', 'info' => '#2563eb', 'gray' => '#9ca3af'];
|
||||
|
||||
$rows = collect(CaseActivities::for($booking))
|
||||
->reject(fn ($activity): bool => $activity->state === ActivityState::NotApplicable)
|
||||
->map(function ($activity) use ($colors): string {
|
||||
$color = $colors[$activity->state->getColor()];
|
||||
$strong = $activity->state->needsAction() ? 'font-weight:700' : '';
|
||||
|
||||
return '<li style="display:flex;gap:.75rem;padding:.45rem 0;border-bottom:1px solid rgba(128,128,128,.2)">'
|
||||
.'<span style="width:1.4rem;text-align:center;font-weight:700;color:'.$color.'">'.$activity->state->icon().'</span>'
|
||||
.'<span style="flex:1;'.$strong.'">'.e($activity->label)
|
||||
.($activity->detail ? ' <span style="font-weight:400;color:#6b7280">· '.e($activity->detail).'</span>' : '')
|
||||
.($activity->url && $activity->state->needsAction() ? ' <a href="'.e($activity->url).'" style="color:#2563eb;text-decoration:underline">erledigen</a>' : '')
|
||||
.'</span><span style="color:'.$color.';font-size:.85rem">'.e($activity->state->getLabel()).'</span></li>';
|
||||
})->implode('');
|
||||
|
||||
return new HtmlString('<ul style="list-style:none;margin:0;padding:0">'.$rows.'</ul>');
|
||||
}
|
||||
|
||||
private static function history(Booking $booking): HtmlString
|
||||
{
|
||||
$rows = $booking->events()->get()->map(fn ($event): string => '<li style="margin:.25rem 0"><span style="color:#6b7280">'.$event->occurred_at->format('d.m.Y H:i').'</span> · '.e($event->summary)
|
||||
.($event->actor ? ' <span style="color:#6b7280">('.e($event->actor).')</span>' : '')
|
||||
.($event->reason ? '<div style="color:#6b7280;margin-left:1rem">Grund: '.e($event->reason).'</div>' : '').'</li>')->implode('');
|
||||
|
||||
return new HtmlString($rows === '' ? 'Noch keine Einträge.' : '<ul style="list-style:none;padding:0;margin:0;font-size:.9rem">'.$rows.'</ul>');
|
||||
}
|
||||
|
||||
private static function profile(Booking $booking): HtmlString
|
||||
{
|
||||
$profile = $booking->process();
|
||||
$rows = collect(ProcessSetting::cases())
|
||||
->reject(fn (ProcessSetting $setting): bool => in_array($setting, ProcessProfile::LIVE, true))
|
||||
->map(fn (ProcessSetting $setting): string => '<li>'.e($setting->question()).' <strong>'.e($setting->describe($profile->value($setting))).'</strong> <span style="color:#6b7280">('.e(ProcessProfile::sourceLabel($profile->source($setting))).')</span></li>')
|
||||
->implode('');
|
||||
|
||||
return new HtmlString('<ul style="list-style:disc;padding-left:1.2rem">'.$rows.'</ul><div style="color:#6b7280;font-size:.85rem">Festgelegt '.e(($profile->origin === 'migration' ? 'bei der Übernahme der bisherigen Daten' : 'beim Eingang').($profile->frozenAt ? ' am '.CarbonImmutable::parse($profile->frozenAt)->format('d.m.Y H:i') : '')).($booking->processing_mode ? ' · Bearbeitung für diesen Vorgang: '.e($booking->processing_mode->getLabel()) : '').'</div>');
|
||||
}
|
||||
}
|
||||
@@ -21,7 +21,7 @@ class BookingsTable
|
||||
public static function configure(Table $table, ?int $guestId = null): Table
|
||||
{
|
||||
return $table
|
||||
->description('Eigene Anfragen und Buchungen sowie erkannte Portalreservierungen in einer Liste. „Akte öffnen“ zeigt alles zu einem Vorgang: nächster Schritt, Vertrag, Zahlungen, Aufgaben und E-Mails. Fehlende Gastzuordnungen lassen sich in den Details ergänzen; unbekannte Belegungen haben einen eigenen Klärungsbereich.')
|
||||
->description('Eigene Anfragen und Buchungen sowie erkannte Portalreservierungen in einer Liste. „Öffnen“ zeigt alles zu einem Vorgang: nächster Schritt, Vertrag, Zahlungen, Aufgaben und E-Mails. Fehlende Gastzuordnungen lassen sich in den Details ergänzen; unbekannte Belegungen haben einen eigenen Klärungsbereich.')
|
||||
->records(function (?string $search, ?string $sortColumn, ?string $sortDirection, array $filters, int $page, int|string $recordsPerPage) use ($guestId, $table): LengthAwarePaginator {
|
||||
$propertyId = filled($filters['property']['value'] ?? null) ? (int) $filters['property']['value'] : null;
|
||||
$records = app(OccupancyOverview::class)->records($propertyId, $guestId);
|
||||
@@ -102,6 +102,6 @@ public static function configure(Table $table, ?int $guestId = null): Table
|
||||
Filter::make('without_guest')->label('Gastzuordnung offen'),
|
||||
])
|
||||
->recordUrl(fn (array $record): string => $record['url'])
|
||||
->recordActions([Action::make('view')->label(fn (array $record): string => $record['record_type'] === 'booking' ? 'Akte öffnen' : ($record['kind'] === 'block' ? 'Details' : 'Akte anlegen'))->icon('heroicon-o-folder-open')->button()->color('primary')->url(fn (array $record): string => $record['url'])]);
|
||||
->recordActions([Action::make('view')->label(fn (array $record): string => $record['record_type'] === 'booking' ? 'Öffnen' : ($record['kind'] === 'block' ? 'Details' : 'Als Buchung übernehmen'))->icon('heroicon-o-folder-open')->button()->color('primary')->url(fn (array $record): string => $record['url'])]);
|
||||
}
|
||||
}
|
||||
@@ -7,11 +7,13 @@
|
||||
use App\Enums\ChannelEchoBehavior;
|
||||
use App\Enums\ChannelExportMode;
|
||||
use App\Enums\ChannelStatus;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Enums\ProcessSetting;
|
||||
use App\Filament\Forms\ProcessSettingFields;
|
||||
use App\Models\Channel;
|
||||
use App\Models\ContractAnnex;
|
||||
use App\Models\ContractTemplate;
|
||||
use App\Models\Property;
|
||||
use App\Support\CurrentProperty;
|
||||
use App\Support\Settings;
|
||||
use Filament\Forms\Components\DateTimePicker;
|
||||
use Filament\Forms\Components\Select;
|
||||
use Filament\Forms\Components\Textarea;
|
||||
@@ -51,34 +53,9 @@ public static function configure(Schema $schema, bool $selectProperty = false):
|
||||
->required()
|
||||
->maxLength(100),
|
||||
Select::make('status')->label('Kanalstatus')->options(ChannelStatus::class)->default(ChannelStatus::Setup)->required(),
|
||||
Select::make('booking_model')->label('Buchungsmodell')->options(ChannelBookingModel::class)->default(ChannelBookingModel::Mixed)->required()
|
||||
Select::make('booking_model')->label('Was kommt über dieses Portal?')->options(ChannelBookingModel::class)->default(ChannelBookingModel::Mixed)->required()
|
||||
->helperText('„Portalbuchung“ und „Gemischt“ gelten als Sofortbuchung: automatische Angebote für diese Wohnung warten, bis das Portal unseren Kalender abgerufen hat. „Vermittlung / Anfrage“: keine Sofortbuchung.'),
|
||||
Section::make('Standardprozess für Buchungen über dieses Portal')
|
||||
->description('Hier legen Sie fest, was bei einer Buchung über dieses Portal gilt – getrennt nach Buchungstyp. Die Vertragsvorlage bringt Vertragstext, Stornoregel und Vertragsanlagen mit (Menü Einrichtung › Vertragsvorlagen). Der Ablauf selbst (Kontaktdaten, Vertrag, Zahlung, Anreise) steht in der Akte jeder Buchung.')
|
||||
->columns(2)
|
||||
->columnSpanFull()
|
||||
->schema([
|
||||
Select::make('contract_template_id')
|
||||
->label('Anfrage über dieses Portal: Vertragsvorlage')
|
||||
->options(fn (): array => ContractTemplate::query()->orderBy('name')->orderBy('version')->get()->mapWithKeys(fn (ContractTemplate $template): array => [$template->id => $template->label()])->all())
|
||||
->placeholder('Standard der Wohnung')
|
||||
->live()
|
||||
->helperText(fn (Get $get): string => self::templateSummary($get('contract_template_id'), 'Wir antworten persönlich, Angebot und Vertrag kommen von uns. ')),
|
||||
Select::make('contract_template_reservation_id')
|
||||
->label('Buchung beim Portal verbindlich: Vertragsvorlage')
|
||||
->options(fn (): array => ContractTemplate::query()->orderBy('name')->orderBy('version')->get()->mapWithKeys(fn (ContractTemplate $template): array => [$template->id => $template->label()])->all())
|
||||
->placeholder('wie bei Anfragen')
|
||||
->live()
|
||||
->helperText(fn (Get $get): string => self::templateSummary($get('contract_template_reservation_id') ?? $get('contract_template_id'), 'Das Portal hat die Buchung schon verbindlich gemacht, wir senden den Vertrag. ')),
|
||||
Toggle::make('payment_tasks_inquiry')
|
||||
->label('Anfrage über dieses Portal: Zahlungsaufgaben anlegen')
|
||||
->helperText('Fällige Anzahlungen/Restzahlungen erscheinen als Aufgabe (Mails an Gäste gehen nie automatisch).')
|
||||
->default(true),
|
||||
Toggle::make('payment_tasks_reservation')
|
||||
->label('Buchung beim Portal verbindlich: Zahlungsaufgaben anlegen')
|
||||
->helperText('Aus, wenn das Portal das Geld einzieht und mahnt (z. B. FeWo-direkt Online-Buchung).')
|
||||
->default(false),
|
||||
]),
|
||||
...self::processSections(),
|
||||
Select::make('connector')
|
||||
->label('Kalenderanbindung')
|
||||
->helperText('Diese Verbindung gleicht Belegungszeiträume über iCal ab. Weitere Portalfunktionen benötigen eine eigene Anbindung.')
|
||||
@@ -128,15 +105,35 @@ public static function configure(Schema $schema, bool $selectProperty = false):
|
||||
/**
|
||||
* What a contract template brings along, shown under the template choice.
|
||||
*/
|
||||
private static function templateSummary(mixed $templateId, string $intro): string
|
||||
/**
|
||||
* Deviations of this portal from the landlord's defaults, separately for requests and for bookings that are already
|
||||
* binding when they arrive. Empty fields follow the defaults (System › So arbeite ich).
|
||||
*
|
||||
* @return list<Section>
|
||||
*/
|
||||
private static function processSections(): array
|
||||
{
|
||||
$template = filled($templateId) ? ContractTemplate::query()->with('cancellationPolicy')->find($templateId) : null;
|
||||
if ($template === null) {
|
||||
return $intro.'Ohne Auswahl gilt die Vorlage der Wohnung bzw. die Texte der Webseite.';
|
||||
}
|
||||
$defaults = (array) (Settings::tenant()?->process_defaults ?? []);
|
||||
$inherited = function (ProcessSetting $setting) use ($defaults): string {
|
||||
$value = $setting->normalize($defaults[$setting->value] ?? null) ?? $setting->default();
|
||||
|
||||
$annexes = ContractAnnex::query()->whereIn('id', (array) ($template->annex_ids ?? []))->orderBy('name')->pluck('name')->implode(', ');
|
||||
return $setting === ProcessSetting::ContractTemplate ? 'Vorlage der Wohnung' : $setting->describe($value);
|
||||
};
|
||||
$settingsFor = fn (IntakeKind $intake): array => array_values(array_filter(ProcessSetting::cases(), fn (ProcessSetting $setting): bool => in_array($intake, $setting->channelIntakes(), true)));
|
||||
|
||||
return $intro.'Die Vorlage bringt mit: Stornoregel '.($template->cancellationPolicy?->name ?? '– keine –').' · Anlagen: '.($annexes ?: 'keine').'.';
|
||||
return [
|
||||
Section::make('Anfragen über dieses Portal')
|
||||
->description('Nur ausfüllen, was bei diesem Portal anders ist als in Ihren Standardeinstellungen.')
|
||||
->columns(2)
|
||||
->columnSpanFull()
|
||||
->collapsible()
|
||||
->schema(ProcessSettingFields::make('process_overrides.inquiry.', $settingsFor(IntakeKind::Inquiry), $inherited)),
|
||||
Section::make('Feste Buchungen über dieses Portal')
|
||||
->description('Buchungen, die beim Portal schon verbindlich sind. Die Vertragsvorlage bringt Vertragstext, Stornoregel und Anlagen mit.')
|
||||
->columns(2)
|
||||
->columnSpanFull()
|
||||
->collapsible()
|
||||
->schema(ProcessSettingFields::make('process_overrides.booking.', $settingsFor(IntakeKind::Booking), $inherited)),
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -3,7 +3,9 @@
|
||||
namespace App\Filament\Resources\ContractTemplates\Pages;
|
||||
|
||||
use App\Filament\Resources\ContractTemplates\ContractTemplateResource;
|
||||
use App\Models\ContractTemplate;
|
||||
use Filament\Resources\Pages\CreateRecord;
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
|
||||
class CreateContractTemplate extends CreateRecord
|
||||
{
|
||||
@@ -21,4 +23,16 @@ protected function mutateFormDataBeforeCreate(array $data): array
|
||||
|
||||
return $data;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $data
|
||||
*/
|
||||
protected function handleRecordCreation(array $data): Model
|
||||
{
|
||||
$template = new ContractTemplate(collect($data)->except(['is_released', 'is_portal_terms'])->all());
|
||||
$template->applyStatements((bool) ($data['is_released'] ?? false), (bool) ($data['is_portal_terms'] ?? false), (string) auth()->user()?->name);
|
||||
$template->save();
|
||||
|
||||
return $template;
|
||||
}
|
||||
}
|
||||
@@ -3,8 +3,10 @@
|
||||
namespace App\Filament\Resources\ContractTemplates\Pages;
|
||||
|
||||
use App\Filament\Resources\ContractTemplates\ContractTemplateResource;
|
||||
use App\Models\ContractTemplate;
|
||||
use Filament\Actions\DeleteAction;
|
||||
use Filament\Resources\Pages\EditRecord;
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
|
||||
class EditContractTemplate extends EditRecord
|
||||
{
|
||||
@@ -14,4 +16,26 @@ protected function getHeaderActions(): array
|
||||
{
|
||||
return [DeleteAction::make()];
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $data
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
protected function mutateFormDataBeforeFill(array $data): array
|
||||
{
|
||||
return [...$data, 'is_released' => $data['released_at'] !== null, 'is_portal_terms' => $data['portal_terms_confirmed_at'] !== null];
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $data
|
||||
*/
|
||||
protected function handleRecordUpdate(Model $record, array $data): Model
|
||||
{
|
||||
/** @var ContractTemplate $record */
|
||||
$record->fill(collect($data)->except(['is_released', 'is_portal_terms'])->all());
|
||||
$record->applyStatements((bool) ($data['is_released'] ?? false), (bool) ($data['is_portal_terms'] ?? false), (string) auth()->user()?->name);
|
||||
$record->save();
|
||||
|
||||
return $record;
|
||||
}
|
||||
}
|
||||
@@ -9,6 +9,7 @@
|
||||
use Filament\Forms\Components\Select;
|
||||
use Filament\Forms\Components\Textarea;
|
||||
use Filament\Forms\Components\TextInput;
|
||||
use Filament\Forms\Components\Toggle;
|
||||
use Filament\Schemas\Components\Section;
|
||||
use Filament\Schemas\Components\Text;
|
||||
use Filament\Schemas\Schema;
|
||||
@@ -65,6 +66,17 @@ public static function configure(Schema $schema): Schema
|
||||
Textarea::make('texts.closing')->label('Vertragsschluss')->rows(3)->columnSpanFull(),
|
||||
Textarea::make('texts.contract_note')->label('Hinweis im Angebots-PDF')->rows(3)->columnSpanFull(),
|
||||
]),
|
||||
Section::make('Freigabe')
|
||||
->description('Ihre Erklärung zu genau diesem Text. Ändert sich der Text, gilt sie erst nach erneutem Speichern mit Haken wieder; eine neue Version beginnt ohne Freigabe.')
|
||||
->columnSpanFull()
|
||||
->schema([
|
||||
Toggle::make('is_released')
|
||||
->label('Für den Versand an Gäste freigegeben')
|
||||
->helperText('Ohne Freigabe wird die Vorlage nie automatisch versendet; von Hand nur nach ausdrücklicher Bestätigung im Vorgang.'),
|
||||
Toggle::make('is_portal_terms')
|
||||
->label('Gibt nur wieder, was Gäste bei der Buchung über das Portal akzeptieren')
|
||||
->helperText('Nur für Vorlagen, die bei beim Portal gebuchten Vorgängen verwendet werden. Ohne diesen Haken weist der Vorgang auf Gebühren und Bedingungen der Vorlage hin und verlangt vor dem Versand eine Bestätigung.'),
|
||||
]),
|
||||
Textarea::make('notes')->label('Interne Notiz')->rows(2)->columnSpanFull(),
|
||||
]);
|
||||
}
|
||||
|
||||
@@ -21,6 +21,8 @@ public static function configure(Table $table): Table
|
||||
->columns([
|
||||
TextColumn::make('name')->label('Vorlage')->searchable()->weight('medium'),
|
||||
TextColumn::make('version')->label('Version')->badge(),
|
||||
IconColumn::make('released')->label('Freigegeben')->boolean()->state(fn (ContractTemplate $record): bool => $record->isReleased()),
|
||||
IconColumn::make('portal_terms')->label('Portalbedingungen')->boolean()->state(fn (ContractTemplate $record): bool => $record->confirmsPortalTerms()),
|
||||
IconColumn::make('used')->label('In Angeboten verwendet')->boolean()->state(fn (ContractTemplate $record): bool => $record->isUsed()),
|
||||
TextColumn::make('updated_at')->label('Geändert')->dateTime('d.m.Y, H:i'),
|
||||
])
|
||||
|
||||
@@ -80,7 +80,7 @@ public static function table(Table $table): Table
|
||||
TextColumn::make('channel.name')->label('Importkanal'),
|
||||
TextColumn::make('property.name')->label('Wohnung')->toggleable(),
|
||||
TextColumn::make('needs_review')->label('Prüffall')->formatStateUsing(fn (bool $state): string => $state ? 'Bitte prüfen' : '–')->description(fn (BlockedPeriod $record): ?string => $record->review_note),
|
||||
])->recordActions([Action::make('fileLink')->label('Akte anlegen')->icon(Heroicon::OutlinedFolderPlus)->button()->color('primary')->visible(fn (BlockedPeriod $record): bool => static::canOpenFile($record))->url(fn (BlockedPeriod $record): string => static::getUrl('view', ['record' => $record])), static::showFileAction()->button(), ViewAction::make(), ActionGroup::make(static::occupationActions(withFile: false))->label('Weitere Aktionen')]);
|
||||
])->recordActions([Action::make('fileLink')->label('Als Buchung übernehmen')->icon(Heroicon::OutlinedFolderPlus)->button()->color('primary')->visible(fn (BlockedPeriod $record): bool => static::canOpenFile($record))->url(fn (BlockedPeriod $record): string => static::getUrl('view', ['record' => $record])), static::showFileAction()->button(), ViewAction::make(), ActionGroup::make(static::occupationActions(withFile: false))->label('Weitere Aktionen')]);
|
||||
}
|
||||
|
||||
public static function occupationActions(bool $withFile = true): array
|
||||
@@ -94,16 +94,16 @@ public static function occupationActions(bool $withFile = true): array
|
||||
}
|
||||
|
||||
/**
|
||||
* Opens the booking file (workflow, contract, payments, tasks) for a reservation from a portal calendar.
|
||||
* Takes a reservation from a portal calendar over as a case (no second, manual "file").
|
||||
*/
|
||||
public static function openFileAction(): Action
|
||||
{
|
||||
return Action::make('openFile')->label('Akte anlegen')->icon(Heroicon::OutlinedFolderPlus)->color('primary')
|
||||
return Action::make('openFile')->label('Als Buchung übernehmen')->icon(Heroicon::OutlinedFolderPlus)->color('primary')
|
||||
->visible(fn (BlockedPeriod $record): bool => static::canOpenFile($record))
|
||||
->authorize(fn (BlockedPeriod $record): bool => auth()->user()?->can('update', $record) ?? false)
|
||||
->requiresConfirmation()
|
||||
->modalHeading('Akte für diese Reservierung anlegen')
|
||||
->modalDescription('Aus der Kalenderbelegung wird eine Buchung mit Ablauf: Kontaktdaten, Vertrag, Zahlungen, Anreise, Storno. Der Zeitraum bleibt durchgehend belegt. Gast, Personenzahl und Preis sind noch unbekannt und werden in der Akte ergänzt.')
|
||||
->modalHeading('Reservierung als Buchung übernehmen')
|
||||
->modalDescription('Aus der Kalenderbelegung wird ein Vorgang „Gebucht über das Portal“. Der Zeitraum bleibt durchgehend belegt. Gast, Personenzahl und Preis bleiben leer, bis sie bekannt sind – der Vorgang erinnert daran.')
|
||||
->action(function (BlockedPeriod $record, OpenPortalFile $open) {
|
||||
try {
|
||||
$booking = $open->handle($record);
|
||||
@@ -113,7 +113,7 @@ public static function openFileAction(): Action
|
||||
return null;
|
||||
}
|
||||
|
||||
Notification::make()->title('Akte angelegt')->success()->send();
|
||||
Notification::make()->title('Als Buchung übernommen')->success()->send();
|
||||
|
||||
return redirect(BookingResource::getUrl('view', ['record' => $booking]));
|
||||
});
|
||||
@@ -121,7 +121,7 @@ public static function openFileAction(): Action
|
||||
|
||||
public static function showFileAction(): Action
|
||||
{
|
||||
return Action::make('showFile')->label('Akte öffnen')->icon(Heroicon::OutlinedFolderOpen)->color('primary')
|
||||
return Action::make('showFile')->label('Vorgang öffnen')->icon(Heroicon::OutlinedFolderOpen)->color('primary')
|
||||
->visible(fn (BlockedPeriod $record): bool => $record->linked_booking_id !== null)
|
||||
->url(fn (BlockedPeriod $record): ?string => $record->linked_booking_id ? BookingResource::getUrl('view', ['record' => $record->linked_booking_id]) : null);
|
||||
}
|
||||
|
||||
@@ -2,13 +2,17 @@
|
||||
|
||||
namespace App\Filament\Resources\Properties\Schemas;
|
||||
|
||||
use App\Enums\AdminMode;
|
||||
use App\Enums\CancellationMode;
|
||||
use App\Enums\OfferMode;
|
||||
use App\Enums\ProcessSetting;
|
||||
use App\Filament\Forms\Components\EuroInput;
|
||||
use App\Filament\Forms\ProcessSettingFields;
|
||||
use App\Filament\Pages\HandlingSettings;
|
||||
use App\ImageWorlds\ImageWorldRegistry;
|
||||
use App\Models\ContractTemplate;
|
||||
use App\Models\Site;
|
||||
use Closure;
|
||||
use App\Models\User;
|
||||
use App\Support\Settings;
|
||||
use Filament\Forms\Components\KeyValue;
|
||||
use Filament\Forms\Components\Select;
|
||||
use Filament\Forms\Components\TextInput;
|
||||
@@ -111,14 +115,6 @@ public static function configure(Schema $schema): Schema
|
||||
->minValue(0)
|
||||
->suffix('Tage vor Anreise')
|
||||
->default(28),
|
||||
TextInput::make('hold_hours')
|
||||
->label('Vorreservierung halten')
|
||||
->helperText('So lange bleibt ein angefragter Zeitraum ohne Ihre Bestätigung blockiert.')
|
||||
->required()
|
||||
->integer()
|
||||
->minValue(1)
|
||||
->suffix('Stunden')
|
||||
->default(48),
|
||||
Select::make('cancellation_mode')
|
||||
->label('Stornierungslink in der Buchungsbestätigung')
|
||||
->options(CancellationMode::class)
|
||||
@@ -144,32 +140,17 @@ public static function configure(Schema $schema): Schema
|
||||
->options(fn (): array => ContractTemplate::query()->orderBy('name')->orderBy('version')->get()->mapWithKeys(fn (ContractTemplate $template): array => [$template->id => $template->label()])->all())
|
||||
->placeholder('Texte der Webseite')
|
||||
->helperText('Wird bei neuen Angeboten verwendet, sofern das Portal keine eigene Vorlage hat.'),
|
||||
TextInput::make('arrival_info_days_before')
|
||||
->label('Anreise-E-Mail senden')
|
||||
->helperText('Automatische Mail mit den letzten Hinweisen (Texte unter Texte › Aufenthalt).')
|
||||
->required()
|
||||
->integer()
|
||||
->minValue(1)
|
||||
->maxValue(14)
|
||||
->suffix('Tage vor Anreise')
|
||||
->default(3),
|
||||
Toggle::make('pre_reservation_enabled')
|
||||
->label('Anfrage blockiert den Kalender (Vorreservierung)')
|
||||
->helperText('Aus: eine bloße Anfrage sperrt keinen Zeitraum. Dann ist kein automatisches Angebot möglich.')
|
||||
->default(true)
|
||||
->live(),
|
||||
Select::make('offer_mode')
|
||||
->label('Bearbeitung von Anfragen')
|
||||
->options(OfferMode::class)
|
||||
->default(OfferMode::Manual)
|
||||
->required()
|
||||
->helperText('Automatisch: das Angebot geht sofort an den Gast, wenn die Kalenderprüfung bestanden ist (Kalenderstand aktuell, bei Portalen mit Sofortbuchung unser Feed nachweislich abgerufen). Sonst entscheiden Sie von Hand. Unabhängig vom Testbetrieb der E-Mails.')
|
||||
->rules([fn (Get $get): Closure => function (string $attribute, mixed $value, Closure $fail) use ($get): void {
|
||||
if (($value === OfferMode::Automatic->value || $value === OfferMode::Automatic) && ! $get('pre_reservation_enabled')) {
|
||||
$fail('Automatische Angebote brauchen die Vorreservierung: ohne Sperre im Kalender kann ein verbindlich annehmbares Angebot nicht sicher erteilt werden.');
|
||||
}
|
||||
}]),
|
||||
]),
|
||||
Section::make('Abweichende Abwicklung dieser Wohnung')
|
||||
->description('Nur nötig, wenn diese Wohnung anders bearbeitet wird als in „So arbeite ich“ eingestellt. Leere Felder folgen Ihren Standardeinstellungen.')
|
||||
->visible(fn (): bool => auth()->user() instanceof User && auth()->user()->adminMode() === AdminMode::Expert)
|
||||
->collapsed()
|
||||
->columns(2)
|
||||
->schema(ProcessSettingFields::make('process_overrides.', HandlingSettings::settings(), function (ProcessSetting $setting): string {
|
||||
$defaults = (array) (Settings::tenant()?->process_defaults ?? []);
|
||||
|
||||
return $setting->describe($setting->normalize($defaults[$setting->value] ?? null) ?? $setting->default());
|
||||
})),
|
||||
]);
|
||||
}
|
||||
}
|
||||
@@ -40,7 +40,7 @@ public function table(Table $table): Table
|
||||
TextColumn::make('arrival')->label('Anreise')->date('D, d.m.')
|
||||
->description(fn (Booking $record): ?string => $record->arrival->isToday() ? 'heute' : ($record->arrival->isPast() ? 'läuft' : null)),
|
||||
TextColumn::make('departure')->label('Abreise')->date('D, d.m.'),
|
||||
TextColumn::make('guest.last_name')->label('Gast')->formatStateUsing(fn (Booking $record): string => $record->guest->full_name),
|
||||
TextColumn::make('guest.last_name')->label('Gast')->formatStateUsing(fn (Booking $record): string => $record->guestName()),
|
||||
TextColumn::make('guests')->label('Pers.'),
|
||||
TextColumn::make('status')->label('Status')->badge(),
|
||||
TextColumn::make('open')->label('Offen')
|
||||
|
||||
@@ -0,0 +1,34 @@
|
||||
<?php
|
||||
|
||||
namespace App\Filament\Widgets;
|
||||
|
||||
use App\Enums\UserRole;
|
||||
use App\Process\WorkList;
|
||||
use Filament\Widgets\Widget;
|
||||
|
||||
/**
|
||||
* "Zu erledigen" at the top of the start page: one list of everything the landlord has to do.
|
||||
*/
|
||||
class WorkListWidget extends Widget
|
||||
{
|
||||
protected static ?int $sort = 0;
|
||||
|
||||
protected static bool $isLazy = false;
|
||||
|
||||
protected int|string|array $columnSpan = 'full';
|
||||
|
||||
protected string $view = 'filament.widgets.work-list';
|
||||
|
||||
public static function canView(): bool
|
||||
{
|
||||
return (bool) auth()->user()?->hasRole(UserRole::Admin, UserRole::Rentals);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
protected function getViewData(): array
|
||||
{
|
||||
return ['items' => WorkList::items()];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,33 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers;
|
||||
|
||||
use App\Documents\DocumentComposer;
|
||||
use App\Documents\RentalContract;
|
||||
use App\Enums\DocumentKind;
|
||||
use App\Models\Booking;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Http\Response;
|
||||
|
||||
/**
|
||||
* The PDF of a document composition as it would be sent, for the landlord's preview in the admin area. Nothing is
|
||||
* stored; the case is only read (and only within the current landlord, by the tenant scope of the route binding).
|
||||
*/
|
||||
class DocumentPreviewController extends Controller
|
||||
{
|
||||
public function __invoke(Request $request, Booking $booking, string $kind, DocumentComposer $composer, RentalContract $contract): Response
|
||||
{
|
||||
$documentKind = DocumentKind::tryFrom($kind);
|
||||
abort_if($documentKind === null || ! $documentKind->isForGuests(), 404);
|
||||
|
||||
$changes = json_decode((string) base64_decode((string) $request->query('changes', ''), true), true);
|
||||
$composition = $composer->compose($booking, $documentKind, is_array($changes) ? $changes : []);
|
||||
$pdf = $contract->render($composition->draft, $documentKind, draft: $documentKind === DocumentKind::Offer);
|
||||
|
||||
return response($pdf, 200, [
|
||||
'Content-Type' => 'application/pdf',
|
||||
'Content-Disposition' => 'inline; filename="Vorschau-'.$documentKind->fileName().'-'.$booking->reference.'.pdf"',
|
||||
'Cache-Control' => 'no-store',
|
||||
]);
|
||||
}
|
||||
}
|
||||
@@ -7,6 +7,7 @@
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Exceptions\ReservationException;
|
||||
use App\Models\Booking;
|
||||
use App\Process\CaseLog;
|
||||
use DateTimeInterface;
|
||||
use Illuminate\Contracts\View\View;
|
||||
use Illuminate\Http\RedirectResponse;
|
||||
@@ -50,7 +51,7 @@ public function accept(Request $request, Booking $booking, AcceptOffer $accept):
|
||||
$request->validate(['terms' => ['accepted']], ['terms.accepted' => 'Bitte bestätigen Sie, dass Sie die Bedingungen gelesen haben.']);
|
||||
|
||||
return $this->answer($request, $booking, function (int $version) use ($accept, $booking): string {
|
||||
$concluded = $accept->handle($booking, $version);
|
||||
$concluded = CaseLog::context(fn (): bool => $accept->handle($booking, $version), actor: CaseLog::GUEST);
|
||||
$booking->refresh();
|
||||
|
||||
if (! $concluded) {
|
||||
@@ -66,7 +67,7 @@ public function accept(Request $request, Booking $booking, AcceptOffer $accept):
|
||||
public function reject(Request $request, Booking $booking, RejectOffer $reject): RedirectResponse
|
||||
{
|
||||
return $this->answer($request, $booking, function (int $version) use ($reject, $booking): string {
|
||||
$reject->handle($booking, $version);
|
||||
CaseLog::context(fn () => $reject->handle($booking, $version), actor: CaseLog::GUEST);
|
||||
|
||||
return 'Schade – wir haben Ihre Absage erhalten und den Zeitraum wieder freigegeben. Vielleicht ein anderes Mal!';
|
||||
});
|
||||
|
||||
@@ -8,6 +8,7 @@
|
||||
use App\Enums\CancellationMode;
|
||||
use App\Exceptions\ReservationException;
|
||||
use App\Models\Booking;
|
||||
use App\Process\CaseLog;
|
||||
use App\Support\CancellationCost;
|
||||
use DateTimeInterface;
|
||||
use Illuminate\Contracts\View\View;
|
||||
@@ -37,7 +38,7 @@ public function showRelease(Booking $booking): View
|
||||
public function release(Booking $booking, ReleaseReservation $release): RedirectResponse
|
||||
{
|
||||
try {
|
||||
$release->handle($booking);
|
||||
CaseLog::context(fn () => $release->handle($booking), actor: CaseLog::GUEST);
|
||||
} catch (ReservationException $exception) {
|
||||
return redirect()->to($this->signed('reservations.release', $booking, now()->addDays(2)))->with('self-service.error', $exception->getMessage());
|
||||
}
|
||||
@@ -67,7 +68,7 @@ public function cancel(Request $request, Booking $booking, CancelBookingByGuest
|
||||
$back = fn (int $days): string => $this->signed('bookings.cancel', $booking, now()->addDays($days));
|
||||
|
||||
try {
|
||||
$outcome = $cancel->handle($booking, $data['message'] ?? null);
|
||||
$outcome = CaseLog::context(fn () => $cancel->handle($booking, $data['message'] ?? null), actor: CaseLog::GUEST);
|
||||
} catch (ReservationException $exception) {
|
||||
return redirect()->to($back(2))->with('self-service.error', $exception->getMessage());
|
||||
}
|
||||
|
||||
@@ -0,0 +1,27 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Middleware;
|
||||
|
||||
use Closure;
|
||||
use Illuminate\Http\Request;
|
||||
use Symfony\Component\HttpFoundation\Response;
|
||||
|
||||
/**
|
||||
* Sends plain-HTTP requests to the same address over HTTPS. Done in the application (not in .htaccess) because on
|
||||
* Strato the .htaccess in the deploy folder is rewritten by every deployment; the application also sees the
|
||||
* cleaned request path, so no internal release folder can leak into the target address.
|
||||
*/
|
||||
class ForceHttps
|
||||
{
|
||||
public function handle(Request $request, Closure $next): Response
|
||||
{
|
||||
if (! config('fewo.force_https') || $request->isSecure()) {
|
||||
return $next($request);
|
||||
}
|
||||
|
||||
$target = 'https://'.$request->getHost().$request->getRequestUri();
|
||||
|
||||
// 308 keeps the method for automation callers (POST webhooks); browsers and crawlers get 301.
|
||||
return redirect()->away($target, in_array($request->getMethod(), ['GET', 'HEAD'], true) ? 301 : 308);
|
||||
}
|
||||
}
|
||||
@@ -45,6 +45,13 @@ public function handle(Request $request, Closure $next): Response
|
||||
$context->set($tenant);
|
||||
}
|
||||
|
||||
if ($this->staysOnRequestedAddress($request)) {
|
||||
URL::forceRootUrl($request->getSchemeAndHttpHost());
|
||||
URL::forceScheme($request->getScheme());
|
||||
|
||||
return $next($request);
|
||||
}
|
||||
|
||||
if ($redirect = $this->toMainAddress($request, $theme->site)) {
|
||||
return $redirect;
|
||||
}
|
||||
@@ -54,6 +61,17 @@ public function handle(Request $request, Closure $next): Response
|
||||
return $next($request);
|
||||
}
|
||||
|
||||
/**
|
||||
* Signed links (offers, reviews, newsletter) are bound to the host they were issued for, and portals and
|
||||
* automations call feeds and endpoints under the address they were given. These paths are answered on the
|
||||
* address they came in on – a redirect to the main address would invalidate old signatures and feed URLs
|
||||
* after a change of the main address. Links on such a page keep the requested host (session, CSRF).
|
||||
*/
|
||||
private function staysOnRequestedAddress(Request $request): bool
|
||||
{
|
||||
return $request->is('angebot/*', 'bewertung/*', 'angebote/*', 'kalender/*', 'automation/*', 'health/*');
|
||||
}
|
||||
|
||||
/**
|
||||
* A website answers on one main address. Visitors coming in through a further address (e.g. www.…) are
|
||||
* sent there permanently – otherwise the page would load its scripts, fonts and videos from the main
|
||||
|
||||
@@ -0,0 +1,47 @@
|
||||
<?php
|
||||
|
||||
namespace App\Mail;
|
||||
|
||||
use App\Documents\RentalContract;
|
||||
use App\Models\Booking;
|
||||
use Illuminate\Bus\Queueable;
|
||||
use Illuminate\Mail\Mailable;
|
||||
use Illuminate\Mail\Mailables\Address;
|
||||
use Illuminate\Mail\Mailables\Attachment;
|
||||
use Illuminate\Mail\Mailables\Content;
|
||||
use Illuminate\Mail\Mailables\Envelope;
|
||||
use Illuminate\Queue\SerializesModels;
|
||||
|
||||
/**
|
||||
* The booking documentation for a booking already binding on a portal (A3/A4): the stay as booked there and our
|
||||
* document, without an acceptance link and without a cancellation link of our own (E-004).
|
||||
*/
|
||||
class BookingDocumentation extends Mailable
|
||||
{
|
||||
use Queueable, SerializesModels;
|
||||
|
||||
public function __construct(public Booking $booking) {}
|
||||
|
||||
public function envelope(): Envelope
|
||||
{
|
||||
return new Envelope(
|
||||
subject: 'Ihre Buchungsunterlagen '.($this->booking->portal_reference ?? $this->booking->reference),
|
||||
replyTo: [new Address(config('fewo.owner.email'), config('fewo.owner.name'))],
|
||||
);
|
||||
}
|
||||
|
||||
public function content(): Content
|
||||
{
|
||||
return new Content(markdown: 'mail.booking-documentation');
|
||||
}
|
||||
|
||||
/**
|
||||
* @return list<Attachment>
|
||||
*/
|
||||
public function attachments(): array
|
||||
{
|
||||
$path = app(RentalContract::class)->absolutePath($this->booking);
|
||||
|
||||
return $path ? [Attachment::fromPath($path)->as("Buchungsunterlagen-{$this->booking->reference}.pdf")->withMime('application/pdf')] : [];
|
||||
}
|
||||
}
|
||||
@@ -20,7 +20,7 @@ public function __construct(public Booking $booking, public bool $cancelled) {}
|
||||
|
||||
public function envelope(): Envelope
|
||||
{
|
||||
return new Envelope(subject: ($this->cancelled ? 'Storniert: ' : 'Stornierungswunsch: ').$this->booking->reference.' – '.$this->booking->guest->full_name);
|
||||
return new Envelope(subject: ($this->cancelled ? 'Storniert: ' : 'Stornierungswunsch: ').$this->booking->reference.' – '.$this->booking->guestName());
|
||||
}
|
||||
|
||||
public function content(): Content
|
||||
|
||||
+77
-18
@@ -5,11 +5,17 @@
|
||||
use App\Documents\OfferTerms;
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\BookingTaskKind;
|
||||
use App\Enums\ChannelBookingModel;
|
||||
use App\Enums\CaseType;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Enums\ProcessingMode;
|
||||
use App\Enums\ReferralSource;
|
||||
use App\Enums\Responsibility;
|
||||
use App\Models\Concerns\BelongsToTenant;
|
||||
use App\Models\Concerns\HasChannelProvenance;
|
||||
use App\Observers\BookingObserver;
|
||||
use App\Process\CaseRecorder;
|
||||
use App\Process\ProcessProfile;
|
||||
use App\Process\ProcessSettings;
|
||||
use Carbon\CarbonInterface;
|
||||
use Database\Factories\BookingFactory;
|
||||
use Illuminate\Database\Eloquent\Attributes\Fillable;
|
||||
@@ -24,8 +30,10 @@
|
||||
use Illuminate\Support\HtmlString;
|
||||
|
||||
/**
|
||||
* A reservation or booking. arrival is the first night, departure the day the guest leaves,
|
||||
* so a departure and the next arrival on the same day do not collide.
|
||||
* A case ("Vorgang", docs/Prozessarchitektur): one business occasion from its first arrival to its end – a request,
|
||||
* a booking already binding on a portal, or an internal use. arrival is the first night, departure the day the guest
|
||||
* leaves, so a departure and the next arrival on the same day do not collide. Guest, number of guests and amounts may
|
||||
* be unknown (null) – unknown is never replaced by an invented value.
|
||||
*/
|
||||
#[ObservedBy(BookingObserver::class)]
|
||||
#[Fillable([
|
||||
@@ -33,6 +41,10 @@
|
||||
'guest_id',
|
||||
'status',
|
||||
'source',
|
||||
'intake',
|
||||
'case_type',
|
||||
'profile',
|
||||
'processing_mode',
|
||||
'import_channel_id',
|
||||
'origin_channel_id',
|
||||
'portal_reference',
|
||||
@@ -94,9 +106,12 @@ public function isDirect(): bool
|
||||
|
||||
protected static function booted(): void
|
||||
{
|
||||
static::saving(fn (Booking $booking) => CaseRecorder::freeze($booking));
|
||||
static::created(function (Booking $booking): void {
|
||||
$booking->forceFill(['reference' => $booking->nextReference()])->saveQuietly();
|
||||
CaseRecorder::created($booking);
|
||||
});
|
||||
static::updated(fn (Booking $booking) => CaseRecorder::updated($booking));
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -134,6 +149,10 @@ protected function casts(): array
|
||||
{
|
||||
return [
|
||||
'status' => BookingStatus::class,
|
||||
'intake' => IntakeKind::class,
|
||||
'case_type' => CaseType::class,
|
||||
'profile' => 'array',
|
||||
'processing_mode' => ProcessingMode::class,
|
||||
'referral_source' => ReferralSource::class,
|
||||
'arrival' => 'immutable_date',
|
||||
'departure' => 'immutable_date',
|
||||
@@ -189,6 +208,51 @@ public function importChannel(): BelongsTo
|
||||
return $this->belongsTo(Channel::class, 'import_channel_id');
|
||||
}
|
||||
|
||||
/** @return HasMany<BookingEvent, $this> */
|
||||
public function events(): HasMany
|
||||
{
|
||||
return $this->hasMany(BookingEvent::class)->orderBy('occurred_at')->orderBy('id');
|
||||
}
|
||||
|
||||
/**
|
||||
* The channel whose settings apply: the one the case was imported from, else its origin channel (owner).
|
||||
*/
|
||||
public function processChannel(): ?Channel
|
||||
{
|
||||
return $this->importChannel ?? $this->originChannel;
|
||||
}
|
||||
|
||||
/**
|
||||
* The rules of this case as frozen when it came in (resolved now for a case that has none yet).
|
||||
*/
|
||||
public function process(): ProcessProfile
|
||||
{
|
||||
return filled($this->profile) ? ProcessProfile::fromArray($this->profile) : app(ProcessSettings::class)->forBooking($this);
|
||||
}
|
||||
|
||||
public function caseType(): CaseType
|
||||
{
|
||||
return $this->case_type ?? $this->process()->caseType;
|
||||
}
|
||||
|
||||
/**
|
||||
* Automatic or manual: the decision taken on this case, else the setting frozen with its profile.
|
||||
*/
|
||||
public function processingMode(): ProcessingMode
|
||||
{
|
||||
return $this->processing_mode ?? $this->process()->processing();
|
||||
}
|
||||
|
||||
public function isBinding(): bool
|
||||
{
|
||||
return in_array($this->status, BookingStatus::occupying(), true);
|
||||
}
|
||||
|
||||
public function guestName(): string
|
||||
{
|
||||
return $this->guest?->full_name ?? 'Gast noch nicht bekannt';
|
||||
}
|
||||
|
||||
/** @return HasMany<BlockedPeriod, $this> */
|
||||
public function channelRepresentations(): HasMany
|
||||
{
|
||||
@@ -197,7 +261,7 @@ public function channelRepresentations(): HasMany
|
||||
|
||||
public function bookingChannelLabel(): string
|
||||
{
|
||||
return $this->originChannel?->name ?? $this->importChannel?->name ?? match ($this->source) {
|
||||
return $this->originChannel?->name ?? $this->importChannel?->name ?? match ($this->source ?? 'website') {
|
||||
'website' => 'Eigene Webseite',
|
||||
'manual' => 'Manuell / direkt',
|
||||
'phone' => 'Telefon',
|
||||
@@ -275,14 +339,17 @@ public function paidAmount(): int
|
||||
return (int) ($this->relationLoaded('payments') ? $this->payments->sum('amount') : $this->payments()->sum('amount'));
|
||||
}
|
||||
|
||||
/**
|
||||
* Amount still to be paid in cents; 0 while the price is unknown.
|
||||
*/
|
||||
public function openAmount(): int
|
||||
{
|
||||
return max(0, $this->total - $this->paidAmount());
|
||||
return $this->total === null ? 0 : max(0, $this->total - $this->paidAmount());
|
||||
}
|
||||
|
||||
public function openDeposit(): int
|
||||
{
|
||||
return max(0, $this->deposit - $this->paidAmount());
|
||||
return $this->deposit === null ? 0 : max(0, $this->deposit - $this->paidAmount());
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -290,24 +357,16 @@ public function openDeposit(): int
|
||||
*/
|
||||
public function requiresFullPayment(): bool
|
||||
{
|
||||
return $this->deposit_due_on !== null && $this->balance_due_on->lessThanOrEqualTo($this->deposit_due_on);
|
||||
return $this->deposit_due_on !== null && $this->balance_due_on !== null && $this->balance_due_on->lessThanOrEqualTo($this->deposit_due_on);
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether the landlord chases payments of this booking. Own bookings: always. Portal bookings: as configured
|
||||
* per channel and kind – a reservation whose payment the portal collects (e.g. instant booking) needs no
|
||||
* tasks, a mere inquiry passed on by the portal does.
|
||||
* Whether the landlord chases payments of this case: only when the guest pays us (process profile – a portal that
|
||||
* collects the money needs no tasks) and the price is known.
|
||||
*/
|
||||
public function wantsPaymentTasks(): bool
|
||||
{
|
||||
$channel = $this->importChannel ?? $this->originChannel;
|
||||
if ($channel === null) {
|
||||
return true;
|
||||
}
|
||||
|
||||
return $channel->booking_model === ChannelBookingModel::PortalBooking
|
||||
? $channel->payment_tasks_reservation
|
||||
: $channel->payment_tasks_inquiry;
|
||||
return $this->process()->payments() === Responsibility::Landlord && $this->total !== null && $this->total > 0;
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@@ -0,0 +1,39 @@
|
||||
<?php
|
||||
|
||||
namespace App\Models;
|
||||
|
||||
use App\Models\Concerns\BelongsToTenant;
|
||||
use Illuminate\Database\Eloquent\Attributes\Fillable;
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
||||
|
||||
/**
|
||||
* One entry in the stored history of a case: what happened, who did it, why and when. Entries are only added, never
|
||||
* changed, so the history stays the same whatever happens to the case later.
|
||||
*/
|
||||
#[Fillable(['booking_id', 'type', 'summary', 'actor', 'reason', 'data', 'occurred_at'])]
|
||||
class BookingEvent extends Model
|
||||
{
|
||||
use BelongsToTenant;
|
||||
|
||||
/**
|
||||
* Get the attributes that should be cast.
|
||||
*
|
||||
* @return array<string, string>
|
||||
*/
|
||||
protected function casts(): array
|
||||
{
|
||||
return [
|
||||
'data' => 'array',
|
||||
'occurred_at' => 'immutable_datetime',
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* @return BelongsTo<Booking, $this>
|
||||
*/
|
||||
public function booking(): BelongsTo
|
||||
{
|
||||
return $this->belongsTo(Booking::class);
|
||||
}
|
||||
}
|
||||
@@ -3,6 +3,7 @@
|
||||
namespace App\Models;
|
||||
|
||||
use App\Models\Concerns\BelongsToTenant;
|
||||
use App\Process\CaseLog;
|
||||
use Illuminate\Database\Eloquent\Attributes\Fillable;
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
||||
@@ -17,6 +18,19 @@ class BookingMessage extends Model
|
||||
|
||||
use BelongsToTenant;
|
||||
|
||||
protected static function booted(): void
|
||||
{
|
||||
static::created(function (BookingMessage $message): void {
|
||||
if ($message->booking !== null) {
|
||||
CaseLog::record($message->booking, 'mail', 'E-Mail '.match ($message->audience) {
|
||||
'guest' => 'an den Gast',
|
||||
'landlord' => 'an uns',
|
||||
default => '(Testbetrieb)',
|
||||
}.': '.$message->subject, actor: CaseLog::SYSTEM, at: $message->sent_at);
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the attributes that should be cast.
|
||||
*
|
||||
|
||||
@@ -5,6 +5,7 @@
|
||||
use App\Enums\BookingTaskKind;
|
||||
use App\Enums\BookingTaskStatus;
|
||||
use App\Models\Concerns\BelongsToTenant;
|
||||
use App\Process\CaseLog;
|
||||
use Illuminate\Database\Eloquent\Attributes\Fillable;
|
||||
use Illuminate\Database\Eloquent\Attributes\Scope;
|
||||
use Illuminate\Database\Eloquent\Builder;
|
||||
@@ -20,6 +21,20 @@ class BookingTask extends Model
|
||||
{
|
||||
use BelongsToTenant;
|
||||
|
||||
protected static function booted(): void
|
||||
{
|
||||
static::created(function (BookingTask $task): void {
|
||||
if ($task->booking !== null) {
|
||||
CaseLog::record($task->booking, 'task', 'Aufgabe: '.$task->kind->getLabel());
|
||||
}
|
||||
});
|
||||
static::updated(function (BookingTask $task): void {
|
||||
if ($task->wasChanged('status') && $task->status !== BookingTaskStatus::Open && $task->booking !== null) {
|
||||
CaseLog::record($task->booking, 'task', 'Aufgabe '.($task->status === BookingTaskStatus::Done ? 'erledigt' : 'verworfen').': '.$task->kind->getLabel(), actor: $task->completed_by);
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the attributes that should be cast.
|
||||
*
|
||||
|
||||
@@ -26,7 +26,7 @@
|
||||
* A sales channel (portal) of a property. Our system leads: occupations are imported from the
|
||||
* channel and every channel gets its own export feed without its own occupations.
|
||||
*/
|
||||
#[Fillable(['property_id', 'name', 'connector', 'settings', 'is_active', 'requires_manual_blocking', 'manage_url', 'status', 'booking_model', 'import_enabled', 'export_enabled', 'export_mode', 'external_poll_minutes', 'echo_behavior', 'echo_notes', 'operating_notes', 'portal_verified_at', 'payment_tasks_inquiry', 'payment_tasks_reservation', 'contract_template_id', 'contract_template_reservation_id'])]
|
||||
#[Fillable(['property_id', 'name', 'connector', 'settings', 'is_active', 'requires_manual_blocking', 'manage_url', 'status', 'booking_model', 'import_enabled', 'export_enabled', 'export_mode', 'external_poll_minutes', 'echo_behavior', 'echo_notes', 'operating_notes', 'portal_verified_at', 'payment_tasks_inquiry', 'payment_tasks_reservation', 'contract_template_id', 'contract_template_reservation_id', 'process_overrides'])]
|
||||
#[Hidden(['export_token', 'previous_export_token', 'export_snapshot', 'settings', 'ical_analysis'])]
|
||||
class Channel extends Model
|
||||
{
|
||||
@@ -62,6 +62,7 @@ protected function casts(): array
|
||||
{
|
||||
return [
|
||||
'settings' => 'array',
|
||||
'process_overrides' => 'array',
|
||||
'ical_analysis' => 'encrypted:array',
|
||||
'ical_analyzed_at' => 'immutable_datetime',
|
||||
'ical_rules' => 'array',
|
||||
|
||||
@@ -12,13 +12,23 @@
|
||||
* A version of contract texts for offers (e.g. conditions demanded by a portal). The texts replace the website
|
||||
* texts of the same meaning when an offer is made; the offer then freezes a copy. A version that has been used in
|
||||
* an offer is never edited – a new version is created instead.
|
||||
*
|
||||
* A version goes to guests automatically only when it is released; for bookings already binding on a portal it must in
|
||||
* addition be confirmed as reproducing only what guests accept there (E-004). Both statements belong to the text: they
|
||||
* lapse when the text changes, and a new version starts without them.
|
||||
*/
|
||||
#[Fillable(['name', 'version', 'texts', 'body', 'annex_title', 'annex_body', 'cancellation_policy_id', 'annex_ids', 'notes'])]
|
||||
#[Fillable(['name', 'version', 'texts', 'body', 'annex_title', 'annex_body', 'cancellation_policy_id', 'annex_ids', 'notes', 'released_at', 'released_by', 'portal_terms_confirmed_at', 'portal_terms_confirmed_by'])]
|
||||
class ContractTemplate extends Model
|
||||
{
|
||||
use BelongsToTenant;
|
||||
|
||||
/** Form/storage key => website text key it replaces in an offer. */
|
||||
/** Attributes whose change makes the release and the portal confirmation lapse. */
|
||||
/** Whether the statements were given for the pending save (then a text change does not withdraw them). */
|
||||
private bool $statementsApplied = false;
|
||||
|
||||
private const CONTENT = ['texts', 'body', 'annex_title', 'annex_body', 'cancellation_policy_id', 'annex_ids'];
|
||||
|
||||
public const TEXTS = [
|
||||
'intro' => 'contract.intro',
|
||||
'terms' => 'contract.terms',
|
||||
@@ -35,7 +45,64 @@ class ContractTemplate extends Model
|
||||
*/
|
||||
protected function casts(): array
|
||||
{
|
||||
return ['texts' => 'array', 'version' => 'integer', 'annex_ids' => 'array'];
|
||||
return ['texts' => 'array', 'version' => 'integer', 'annex_ids' => 'array', 'released_at' => 'datetime', 'portal_terms_confirmed_at' => 'datetime'];
|
||||
}
|
||||
|
||||
protected static function booted(): void
|
||||
{
|
||||
static::saved(function (ContractTemplate $template): void {
|
||||
$template->statementsApplied = false;
|
||||
});
|
||||
|
||||
static::saving(function (ContractTemplate $template): void {
|
||||
if ($template->exists && $template->isDirty(self::CONTENT) && ! $template->statementsApplied) {
|
||||
if (! $template->isDirty('released_at')) {
|
||||
$template->released_at = null;
|
||||
$template->released_by = null;
|
||||
}
|
||||
if (! $template->isDirty('portal_terms_confirmed_at')) {
|
||||
$template->portal_terms_confirmed_at = null;
|
||||
$template->portal_terms_confirmed_by = null;
|
||||
}
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Records the landlord's statements on the (possibly just changed) text: a statement is renewed when it is given for
|
||||
* a changed text, kept when nothing changed and withdrawn when it is not given.
|
||||
*/
|
||||
public function applyStatements(bool $released, bool $portalTerms, string $actor): self
|
||||
{
|
||||
$changed = $this->isDirty(self::CONTENT);
|
||||
$this->statementsApplied = true;
|
||||
|
||||
if (! $released) {
|
||||
$this->forceFill(['released_at' => null, 'released_by' => null]);
|
||||
} elseif ($changed || ! $this->isReleased()) {
|
||||
$this->forceFill(['released_at' => now(), 'released_by' => $actor]);
|
||||
}
|
||||
|
||||
if (! $portalTerms) {
|
||||
$this->forceFill(['portal_terms_confirmed_at' => null, 'portal_terms_confirmed_by' => null]);
|
||||
} elseif ($changed || ! $this->confirmsPortalTerms()) {
|
||||
$this->forceFill(['portal_terms_confirmed_at' => now(), 'portal_terms_confirmed_by' => $actor]);
|
||||
}
|
||||
|
||||
return $this;
|
||||
}
|
||||
|
||||
public function isReleased(): bool
|
||||
{
|
||||
return $this->released_at !== null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether the landlord confirmed that this version only reproduces the terms guests accept when booking on a portal.
|
||||
*/
|
||||
public function confirmsPortalTerms(): bool
|
||||
{
|
||||
return $this->portal_terms_confirmed_at !== null;
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@@ -4,6 +4,8 @@
|
||||
|
||||
use App\Enums\PaymentMethod;
|
||||
use App\Models\Concerns\BelongsToTenant;
|
||||
use App\Process\CaseLog;
|
||||
use App\Support\Money;
|
||||
use Database\Factories\PaymentFactory;
|
||||
use Illuminate\Database\Eloquent\Attributes\Fillable;
|
||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
||||
@@ -19,6 +21,15 @@ class Payment extends Model
|
||||
/** @use HasFactory<PaymentFactory> */
|
||||
use BelongsToTenant, HasFactory;
|
||||
|
||||
protected static function booted(): void
|
||||
{
|
||||
static::created(function (Payment $payment): void {
|
||||
if ($payment->booking !== null) {
|
||||
CaseLog::record($payment->booking, 'payment', ($payment->amount < 0 ? 'Erstattung ' : 'Zahlung ').Money::format(abs($payment->amount)).' erfasst', data: ['payment_id' => $payment->id]);
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the attributes that should be cast.
|
||||
*
|
||||
|
||||
@@ -45,6 +45,7 @@
|
||||
'min_stay_until_changeover',
|
||||
'min_stay_absolute',
|
||||
'is_active',
|
||||
'process_overrides',
|
||||
])]
|
||||
class Property extends Model
|
||||
{
|
||||
@@ -82,6 +83,7 @@ protected function casts(): array
|
||||
'cancellation_mode' => CancellationMode::class,
|
||||
'free_cancellation_days' => 'integer',
|
||||
'contract_data' => 'array',
|
||||
'process_overrides' => 'array',
|
||||
'min_stay_fill_gaps' => 'boolean',
|
||||
'min_stay_until_changeover' => 'boolean',
|
||||
'changeover_weekday' => 'integer',
|
||||
|
||||
@@ -28,6 +28,7 @@
|
||||
'channel_stale_after_minutes', 'channel_task_reminder_after_minutes',
|
||||
'reminder_interval_days', 'digest_daily', 'digest_weekly', 'digest_weekday', 'digest_hour', 'digest_sections',
|
||||
'digest_when_empty', 'digest_daily_sent_on', 'digest_weekly_sent_on',
|
||||
'process_defaults', 'document_releases',
|
||||
])]
|
||||
class Tenant extends Model
|
||||
{
|
||||
@@ -74,6 +75,8 @@ protected function casts(): array
|
||||
'digest_weekday' => 'integer',
|
||||
'digest_hour' => 'integer',
|
||||
'digest_sections' => 'array',
|
||||
'process_defaults' => 'array',
|
||||
'document_releases' => 'array',
|
||||
'digest_when_empty' => 'boolean',
|
||||
'digest_daily_sent_on' => 'immutable_date',
|
||||
'digest_weekly_sent_on' => 'immutable_date',
|
||||
|
||||
+21
-48
@@ -7,68 +7,41 @@
|
||||
use Carbon\CarbonImmutable;
|
||||
|
||||
/**
|
||||
* The price a portal charged for a stay as booking columns. Our own calculation is the basis; the difference to the
|
||||
* portal price becomes an adjustment line, so the quote adds up to what the portal charged. When our price list does
|
||||
* not cover the stay (or the stay breaks a rule the portal did not know), the portal price stands alone as one line.
|
||||
* The price of a booking that was made binding on a portal, as booking columns. The total the guest agreed to on the
|
||||
* portal is taken over as one line with its source – it is never split into our own price items, and our own price
|
||||
* list never replaces it (docs/Prozessarchitektur/Querschnitt/Preise_und_Zahlungen.md). An unknown portal price stays
|
||||
* unknown: no quote, no total, no payment plan.
|
||||
*/
|
||||
class PortalPrice
|
||||
{
|
||||
public const LABEL = 'Abweichung Portalpreis';
|
||||
|
||||
public function __construct(private PriceCalculator $calculator) {}
|
||||
public const LABEL = 'Gesamtpreis laut Portal';
|
||||
|
||||
/**
|
||||
* @return array<string, mixed> booking columns (quote, total, deposit, price_adjustment, ...)
|
||||
* @return array{quote: ?array<string, mixed>, total: ?int, deposit: ?int, balance_due_on: ?string, price_adjustment: null, price_adjustment_label: null}
|
||||
*/
|
||||
public function columns(Property $property, StayRequest $stay, int $portalTotal): array
|
||||
public function columns(Property $property, CarbonImmutable $arrival, CarbonImmutable $departure, ?int $guests, ?int $portalTotal, ?string $channelName = null): array
|
||||
{
|
||||
try {
|
||||
$quote = $this->calculator->calculate($property, $stay);
|
||||
} catch (QuoteException) {
|
||||
return $this->columnsOf($this->standalone($property, $stay, $portalTotal), null);
|
||||
if ($portalTotal === null) {
|
||||
return ['quote' => null, 'total' => null, 'deposit' => null, 'balance_due_on' => null, 'price_adjustment' => null, 'price_adjustment_label' => null];
|
||||
}
|
||||
|
||||
$difference = max($portalTotal - $quote->total(), -$quote->rent());
|
||||
if ($difference === 0) {
|
||||
return $this->columnsOf($quote, null);
|
||||
}
|
||||
$label = self::LABEL.($channelName ? ' ('.$channelName.')' : '');
|
||||
$quote = new PriceQuote(
|
||||
$arrival,
|
||||
$departure,
|
||||
(int) $guests,
|
||||
[new QuoteLine(QuoteLineType::Accommodation, $label, 1, $portalTotal, $portalTotal)],
|
||||
$property->deposit_percent,
|
||||
$arrival->subDays($property->balance_due_days_before_arrival),
|
||||
);
|
||||
|
||||
return $this->columnsOf($quote->withLine(new QuoteLine(QuoteLineType::Adjustment, self::LABEL, 1, $difference, $difference)), $difference);
|
||||
}
|
||||
|
||||
/**
|
||||
* Quote for a stay without a known portal price: our calculation, or an empty quote when it is not possible.
|
||||
*
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
public function unknownColumns(Property $property, StayRequest $stay): array
|
||||
{
|
||||
try {
|
||||
return $this->columnsOf($this->calculator->calculate($property, $stay), null);
|
||||
} catch (QuoteException) {
|
||||
return $this->columnsOf($this->standalone($property, $stay, 0), null);
|
||||
}
|
||||
}
|
||||
|
||||
private function standalone(Property $property, StayRequest $stay, int $total): PriceQuote
|
||||
{
|
||||
$lines = $total > 0 ? [new QuoteLine(QuoteLineType::Accommodation, 'Preis laut Portal', 1, $total, $total)] : [];
|
||||
|
||||
return new PriceQuote($stay->arrival, $stay->departure, $stay->guests, $lines, $property->deposit_percent, CarbonImmutable::instance($stay->arrival)->subDays($property->balance_due_days_before_arrival));
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
private function columnsOf(PriceQuote $quote, ?int $adjustment): array
|
||||
{
|
||||
return [
|
||||
'quote' => $quote->toArray(),
|
||||
'quote' => [...$quote->toArray(), 'source' => 'portal'],
|
||||
'total' => $quote->total(),
|
||||
'deposit' => $quote->deposit(),
|
||||
'balance_due_on' => $quote->balanceDueOn->toDateString(),
|
||||
'price_adjustment' => $adjustment,
|
||||
'price_adjustment_label' => $adjustment !== null ? self::LABEL : null,
|
||||
'price_adjustment' => null,
|
||||
'price_adjustment_label' => null,
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,21 @@
|
||||
<?php
|
||||
|
||||
namespace App\Process;
|
||||
|
||||
use App\Enums\ActivityState;
|
||||
|
||||
/**
|
||||
* One activity of a case as the landlord sees it: what it is, where it stands and – when something is to be done – the
|
||||
* action on the case page that does it (or a link elsewhere).
|
||||
*/
|
||||
final class Activity
|
||||
{
|
||||
public function __construct(
|
||||
public readonly string $key,
|
||||
public readonly string $label,
|
||||
public readonly ActivityState $state,
|
||||
public readonly ?string $detail = null,
|
||||
public readonly ?string $action = null,
|
||||
public readonly ?string $url = null,
|
||||
) {}
|
||||
}
|
||||
@@ -0,0 +1,216 @@
|
||||
<?php
|
||||
|
||||
namespace App\Process;
|
||||
|
||||
use App\Actions\SendBookingDocuments;
|
||||
use App\Enums\ActivityState;
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\BookingTaskStatus;
|
||||
use App\Enums\ChannelTaskStatus;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Enums\ProcessingMode;
|
||||
use App\Enums\Responsibility;
|
||||
use App\Filament\Resources\ChannelTasks\ChannelTaskResource;
|
||||
use App\Models\Booking;
|
||||
use App\Models\BookingTask;
|
||||
use App\Models\ChannelTask;
|
||||
use App\Support\Money;
|
||||
use Carbon\CarbonImmutable;
|
||||
|
||||
/**
|
||||
* The activities of a case derived from its process profile and its data (docs/Prozessarchitektur, P01–P05): which
|
||||
* apply, which are done (by us or by the portal), what is waiting for somebody else and what the landlord has to do
|
||||
* next. Nothing here is stored; the gates G1–G5 are these states, not an extra status machine.
|
||||
*/
|
||||
class CaseActivities
|
||||
{
|
||||
/** Activities that are listed on their own in the work list (they are not "the" next step of a case). */
|
||||
private const LISTED_SEPARATELY = ['channel_block'];
|
||||
|
||||
/**
|
||||
* @return list<Activity>
|
||||
*/
|
||||
public static function for(Booking $booking): array
|
||||
{
|
||||
$booking->loadMissing(['guest', 'property', 'payments']);
|
||||
$profile = $booking->process();
|
||||
$closed = in_array($booking->status, [BookingStatus::Cancelled, BookingStatus::Declined, BookingStatus::Expired], true);
|
||||
$binding = $booking->isBinding();
|
||||
$inquiry = $booking->intake !== IntakeKind::Booking;
|
||||
$today = CarbonImmutable::today();
|
||||
$later = fn (ActivityState $state): ActivityState => $closed && ! in_array($state, [ActivityState::Done, ActivityState::External], true) ? ActivityState::NotApplicable : $state;
|
||||
$activities = [];
|
||||
|
||||
$activities[] = new Activity('intake', $inquiry ? 'Anfrage eingegangen' : 'Buchung beim Portal eingegangen', ActivityState::Done, $booking->created_at?->format('d.m.Y').' · '.$booking->bookingChannelLabel());
|
||||
|
||||
$needsContact = $inquiry || $profile->documents() === Responsibility::Landlord || $profile->guestMessages() === Responsibility::Landlord || $profile->payments() === Responsibility::Landlord;
|
||||
if ($needsContact) {
|
||||
$hasEmail = filled($booking->guest?->email);
|
||||
$state = match (true) {
|
||||
$hasEmail => ActivityState::Done,
|
||||
$booking->contact_requested_at !== null => ActivityState::Waiting,
|
||||
default => ActivityState::Open,
|
||||
};
|
||||
$activities[] = new Activity('contact', $booking->guest === null ? 'Name und Kontaktdaten des Gastes eintragen' : 'E-Mail-Adresse des Gastes eintragen', $later($state),
|
||||
$hasEmail ? $booking->guestName() : ($booking->contact_requested_at ? 'beim Gast erfragt am '.$booking->contact_requested_at->format('d.m.Y') : 'fehlt noch'),
|
||||
$hasEmail ? null : 'provideContact');
|
||||
}
|
||||
|
||||
if ($inquiry) {
|
||||
$offerDone = $booking->offer_version > 0 || $binding;
|
||||
$activities[] = new Activity('offer', $booking->processingMode() === ProcessingMode::Automatic ? 'Angebot senden (automatisch)' : 'Angebot prüfen und senden', $later(match (true) {
|
||||
$offerDone => ActivityState::Done,
|
||||
$booking->status === BookingStatus::Reserved && filled($booking->guest?->email) => ActivityState::Open,
|
||||
default => ActivityState::Later,
|
||||
}), $booking->offer_version > 0 ? 'Version '.$booking->offer_version.' vom '.$booking->offer_sent_at?->format('d.m.Y') : ($booking->hold_expires_at ? 'Zeitraum reserviert bis '.$booking->hold_expires_at->format('d.m.Y, H:i').' Uhr' : null), $offerDone ? null : 'sendOffer');
|
||||
|
||||
$activities[] = new Activity('acceptance', 'Gast nimmt das Angebot an', $later(match (true) {
|
||||
$binding => ActivityState::Done,
|
||||
$booking->status === BookingStatus::OfferSent => ActivityState::Waiting,
|
||||
default => ActivityState::Later,
|
||||
}), match (true) {
|
||||
$booking->accepted_at !== null => 'angenommen am '.$booking->accepted_at->format('d.m.Y'),
|
||||
$binding => 'direkt bestätigt',
|
||||
$booking->status === BookingStatus::OfferSent => 'Angebot gültig bis '.$booking->hold_expires_at?->format('d.m.Y, H:i').' Uhr',
|
||||
default => null,
|
||||
});
|
||||
} else {
|
||||
$activities[] = new Activity('binding', 'Beim Portal fest gebucht', $binding || $closed ? ActivityState::External : ActivityState::Open, $booking->portal_reference ? 'Buchungsnummer '.$booking->portal_reference : null, $binding ? null : 'confirm');
|
||||
$activities[] = new Activity('price', 'Gesamtpreis laut Portal eintragen', $later($booking->total === null ? ActivityState::Open : ActivityState::Done), $booking->total === null ? 'noch nicht bekannt' : Money::format($booking->total), $booking->total === null ? 'portalPrice' : null);
|
||||
}
|
||||
|
||||
if ($profile->documents() === Responsibility::Portal) {
|
||||
$activities[] = new Activity('documents', 'Buchungsunterlagen an den Gast', ActivityState::External);
|
||||
} else {
|
||||
$state = match (true) {
|
||||
$booking->confirmation_sent_at !== null => ActivityState::Done,
|
||||
! $binding => ActivityState::Later,
|
||||
$booking->confirmation_failed_at !== null => ActivityState::Problem,
|
||||
default => ActivityState::Open,
|
||||
};
|
||||
$missing = $binding && $state === ActivityState::Open ? app(CaseAutomation::class)->documentBlockers($booking) : [];
|
||||
// What the landlord still has to confirm (unreleased texts, terms not shown to be agreed on the portal).
|
||||
$toConfirm = $binding && $state === ActivityState::Open && $missing === [] ? app(SendBookingDocuments::class)->compose($booking)->toConfirm() : [];
|
||||
$activities[] = new Activity('documents', match (true) {
|
||||
$state !== ActivityState::Open => $inquiry ? 'Buchungsbestätigung mit Vertrag senden' : 'Buchungsunterlagen an den Gast senden',
|
||||
$inquiry => 'Buchungsbestätigung mit Vertrag prüfen und senden',
|
||||
default => 'Buchungsunterlagen prüfen und senden',
|
||||
}, $later($missing !== [] ? ActivityState::Waiting : $state),
|
||||
match (true) {
|
||||
$booking->confirmation_sent_at !== null => 'gesendet am '.$booking->confirmation_sent_at->format('d.m.Y'),
|
||||
$state === ActivityState::Problem => 'Versand fehlgeschlagen',
|
||||
$missing !== [] => 'wartet: '.implode(' ', $missing),
|
||||
$toConfirm !== [] => 'vor dem Versand zu prüfen: '.implode(' ', $toConfirm),
|
||||
default => null,
|
||||
}, match (true) {
|
||||
$state === ActivityState::Problem => 'resendConfirmation',
|
||||
$binding && $missing === [] && $booking->confirmation_sent_at === null => 'sendDocuments',
|
||||
default => null,
|
||||
});
|
||||
}
|
||||
|
||||
foreach (self::channelTasks($booking) as $task) {
|
||||
$activities[] = new Activity('channel_block', ($task->action->value === 'block' ? 'In ' : 'Freigeben in ').$task->channel?->name.($task->action->value === 'block' ? ' sperren' : ''), $task->status === ChannelTaskStatus::Open ? ActivityState::Open : ActivityState::Done, $task->period(), url: ChannelTaskResource::getUrl());
|
||||
}
|
||||
|
||||
if ($profile->payments() === Responsibility::Portal) {
|
||||
$activities[] = new Activity('payment', 'Zahlung des Gastes', ActivityState::External, 'läuft über das Portal');
|
||||
} elseif ($booking->total === null) {
|
||||
$activities[] = new Activity('payment', 'Zahlungen überwachen', $later(ActivityState::Waiting), 'erst möglich, wenn der Preis bekannt ist');
|
||||
} else {
|
||||
$paid = $booking->paidAmount();
|
||||
$activities[] = new Activity('deposit', 'Anzahlung erhalten', $later(match (true) {
|
||||
$binding && $paid >= (int) $booking->deposit => ActivityState::Done,
|
||||
$binding => ActivityState::Waiting,
|
||||
default => ActivityState::Later,
|
||||
}), Money::format((int) $booking->deposit).($booking->deposit_due_on ? ', fällig '.$booking->deposit_due_on->format('d.m.Y') : ''));
|
||||
$activities[] = new Activity('balance', 'Restzahlung erhalten', $later(match (true) {
|
||||
$binding && $paid >= $booking->total => ActivityState::Done,
|
||||
$binding && $paid >= (int) $booking->deposit => ActivityState::Waiting,
|
||||
default => ActivityState::Later,
|
||||
}), Money::format(max(0, $booking->total - (int) $booking->deposit)).($booking->balance_due_on ? ', fällig '.$booking->balance_due_on->format('d.m.Y') : ''));
|
||||
}
|
||||
|
||||
foreach (BookingTask::query()->where('booking_id', $booking->id)->where('status', BookingTaskStatus::Open)->get() as $task) {
|
||||
$activities[] = new Activity('task_'.$task->kind->value, $task->kind->getLabel(), ActivityState::Open, $task->due_on ? 'fällig '.$task->due_on->format('d.m.Y') : null, $task->kind->isPayment() ? null : 'end');
|
||||
}
|
||||
|
||||
$arrived = $binding && $booking->arrival <= $today;
|
||||
$left = $binding && $booking->departure <= $today;
|
||||
$activities[] = $profile->guestMessages() === Responsibility::Portal
|
||||
? new Activity('arrival_info', 'Anreise-Informationen an den Gast', ActivityState::External)
|
||||
: new Activity('arrival_info', 'Anreise-Informationen an den Gast (automatisch)', $later($booking->arrival_info_sent_at !== null ? ActivityState::Done : ActivityState::Later), $booking->arrival_info_sent_at ? 'gesendet am '.$booking->arrival_info_sent_at->format('d.m.Y') : $profile->arrivalInfoDaysBefore().' Tage vor Anreise');
|
||||
$activities[] = new Activity('stay', 'Aufenthalt', $later(match (true) {
|
||||
$left => ActivityState::Done,
|
||||
$arrived => ActivityState::Waiting,
|
||||
default => ActivityState::Later,
|
||||
}), $booking->arrival->format('d.m.Y').' – '.$booking->departure->format('d.m.Y'));
|
||||
if ($profile->guestMessages() === Responsibility::Landlord) {
|
||||
$activities[] = new Activity('review', 'Bitte um eine Bewertung (automatisch)', $later($booking->review_requested_at !== null ? ActivityState::Done : ActivityState::Later));
|
||||
}
|
||||
|
||||
return $activities;
|
||||
}
|
||||
|
||||
/**
|
||||
* What the landlord should do next on this case, or null when nothing is up to him.
|
||||
*/
|
||||
public static function next(Booking $booking): ?Activity
|
||||
{
|
||||
foreach (self::for($booking) as $activity) {
|
||||
if ($activity->state->needsAction() && ! in_array($activity->key, self::LISTED_SEPARATELY, true)) {
|
||||
return $activity;
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* The state of the case in one sentence of plain words.
|
||||
*/
|
||||
public static function situation(Booking $booking): string
|
||||
{
|
||||
$today = CarbonImmutable::today();
|
||||
$channel = $booking->processChannel()?->name;
|
||||
$kind = $booking->intake === IntakeKind::Booking ? 'Gebucht über '.($channel ?? 'ein Portal') : ($channel ? 'Anfrage über '.$channel : ($booking->source === 'website' ? 'Anfrage über die Webseite' : 'Anfrage'));
|
||||
|
||||
$state = match ($booking->status) {
|
||||
BookingStatus::Reserved => $booking->isHoldActive() ? 'Zeitraum reserviert bis '.$booking->hold_expires_at->format('d.m., H:i').' Uhr' : 'Zeitraum nicht reserviert',
|
||||
BookingStatus::OfferSent => $booking->isHoldActive() ? 'Angebot liegt beim Gast bis '.$booking->hold_expires_at->format('d.m., H:i').' Uhr' : 'Angebot abgelaufen',
|
||||
BookingStatus::Confirmed => 'fest gebucht',
|
||||
BookingStatus::DepositPaid => 'fest gebucht, Anzahlung erhalten',
|
||||
BookingStatus::Paid => 'fest gebucht, bezahlt',
|
||||
BookingStatus::Completed => 'abgeschlossen',
|
||||
BookingStatus::Declined => 'ohne Buchung beendet',
|
||||
BookingStatus::Expired => 'Frist abgelaufen, ohne Buchung beendet',
|
||||
BookingStatus::Cancelled => 'storniert',
|
||||
};
|
||||
|
||||
$when = match (true) {
|
||||
! $booking->isBinding() => null,
|
||||
$booking->departure <= $today => 'abgereist am '.$booking->departure->format('d.m.Y'),
|
||||
$booking->arrival <= $today => 'Gast ist vor Ort bis '.$booking->departure->format('d.m.Y'),
|
||||
default => 'Anreise in '.(int) $today->diffInDays($booking->arrival).' Tagen',
|
||||
};
|
||||
|
||||
return implode(' · ', array_filter([$kind, $state, $when]));
|
||||
}
|
||||
|
||||
/**
|
||||
* Portal tasks for the dates of this case (block when it starts occupying, unblock when it ends).
|
||||
*
|
||||
* @return iterable<ChannelTask>
|
||||
*/
|
||||
private static function channelTasks(Booking $booking): iterable
|
||||
{
|
||||
return ChannelTask::query()
|
||||
->with('channel')
|
||||
->whereHas('channel', fn ($query) => $query->where('property_id', $booking->property_id))
|
||||
->whereDate('starts_on', $booking->arrival)
|
||||
->whereDate('ends_on', $booking->departure)
|
||||
->where('status', '!=', ChannelTaskStatus::Dismissed)
|
||||
->orderBy('id')
|
||||
->get();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,75 @@
|
||||
<?php
|
||||
|
||||
namespace App\Process;
|
||||
|
||||
use App\Actions\AutoOffer;
|
||||
use App\Actions\SendBookingDocuments;
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Enums\ProcessingMode;
|
||||
use App\Enums\Responsibility;
|
||||
use App\Models\Booking;
|
||||
use Throwable;
|
||||
|
||||
/**
|
||||
* Carries a case on by itself as far as its data allows – only when the case is handled automatically. What it may do
|
||||
* is what the landlord would do next anyway: send the offer of a request, or send the documents of a binding booking
|
||||
* once their composition is complete and needs no confirmation (template released and, for portal bookings, confirmed
|
||||
* as the portal's terms). Whatever stops it is returned in plain
|
||||
* words; the case then shows it as a task. Never touches a case whose profile was taken over from the old data (the
|
||||
* automation did not exist for those cases before).
|
||||
*/
|
||||
class CaseAutomation
|
||||
{
|
||||
public function __construct(private AutoOffer $autoOffer, private SendBookingDocuments $documents) {}
|
||||
|
||||
/**
|
||||
* @return list<string> what keeps the case from going on automatically (empty: nothing to do or done)
|
||||
*/
|
||||
public function advance(Booking $booking): array
|
||||
{
|
||||
$booking->loadMissing(['guest', 'property']);
|
||||
|
||||
if ($booking->processingMode() !== ProcessingMode::Automatic) {
|
||||
return [];
|
||||
}
|
||||
|
||||
try {
|
||||
return CaseLog::context(fn (): array => $this->step($booking), actor: CaseLog::SYSTEM.' (automatisch)');
|
||||
} catch (Throwable $exception) {
|
||||
report($exception);
|
||||
|
||||
return ['Technischer Fehler beim automatischen Weiterbearbeiten – bitte von Hand fortsetzen.'];
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @return list<string>
|
||||
*/
|
||||
private function step(Booking $booking): array
|
||||
{
|
||||
if ($booking->status === BookingStatus::Reserved && $booking->offer_version === 0 && $booking->intake !== IntakeKind::Booking) {
|
||||
return $this->autoOffer->handle($booking);
|
||||
}
|
||||
|
||||
if ($booking->isBinding() && $booking->confirmation_sent_at === null && $booking->process()->documents() === Responsibility::Landlord && $booking->process()->origin !== 'migration') {
|
||||
return $this->documents->automatically($booking);
|
||||
}
|
||||
|
||||
return [];
|
||||
}
|
||||
|
||||
/**
|
||||
* What is missing before the documents of a binding case can go to the guest.
|
||||
*
|
||||
* @return list<string>
|
||||
*/
|
||||
public function documentBlockers(Booking $booking): array
|
||||
{
|
||||
return array_values(array_filter([
|
||||
$booking->guest === null ? 'Name und Kontaktdaten des Gastes fehlen.' : null,
|
||||
$booking->guest !== null && blank($booking->guest->email) ? 'Die E-Mail-Adresse des Gastes fehlt.' : null,
|
||||
$booking->total === null ? 'Der Gesamtpreis (laut Portal) fehlt.' : null,
|
||||
]));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,71 @@
|
||||
<?php
|
||||
|
||||
namespace App\Process;
|
||||
|
||||
use App\Models\Booking;
|
||||
use App\Models\BookingEvent;
|
||||
use Carbon\CarbonInterface;
|
||||
|
||||
/**
|
||||
* Writes the stored history of a case. Model hooks record the facts (status, documents, payments, mails); actions
|
||||
* that know more (who acted on whose behalf, and why) wrap their work in {@see self::context()}.
|
||||
*/
|
||||
class CaseLog
|
||||
{
|
||||
public const SYSTEM = 'System';
|
||||
|
||||
public const GUEST = 'Gast';
|
||||
|
||||
private static ?string $actor = null;
|
||||
|
||||
private static ?string $reason = null;
|
||||
|
||||
/**
|
||||
* Runs the callback with a named actor and/or reason for every entry written meanwhile.
|
||||
*
|
||||
* @template T
|
||||
*
|
||||
* @param callable(): T $callback
|
||||
* @return T
|
||||
*/
|
||||
public static function context(callable $callback, ?string $actor = null, ?string $reason = null): mixed
|
||||
{
|
||||
[$previousActor, $previousReason] = [self::$actor, self::$reason];
|
||||
self::$actor = $actor ?? $previousActor;
|
||||
self::$reason = $reason ?? $previousReason;
|
||||
|
||||
try {
|
||||
return $callback();
|
||||
} finally {
|
||||
[self::$actor, self::$reason] = [$previousActor, $previousReason];
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $data
|
||||
*/
|
||||
public static function record(Booking $booking, string $type, string $summary, ?string $reason = null, array $data = [], ?string $actor = null, ?CarbonInterface $at = null): BookingEvent
|
||||
{
|
||||
$event = new BookingEvent([
|
||||
'booking_id' => $booking->id,
|
||||
'type' => $type,
|
||||
'summary' => mb_substr($summary, 0, 500),
|
||||
'actor' => $actor ?? self::actor(),
|
||||
'reason' => $reason ?? self::$reason,
|
||||
'data' => $data === [] ? null : $data,
|
||||
'occurred_at' => $at ?? now(),
|
||||
]);
|
||||
$event->tenant_id = $booking->tenant_id;
|
||||
$event->save();
|
||||
|
||||
return $event;
|
||||
}
|
||||
|
||||
/**
|
||||
* Who is acting right now: the named actor, the signed-in user or the system (scheduler, mail import).
|
||||
*/
|
||||
public static function actor(): string
|
||||
{
|
||||
return self::$actor ?? auth()->user()?->name ?? self::SYSTEM;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,114 @@
|
||||
<?php
|
||||
|
||||
namespace App\Process;
|
||||
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Models\Booking;
|
||||
use App\Models\Guest;
|
||||
|
||||
/**
|
||||
* Model hooks of a case: freezes the process profile when the case comes in (and again when what defines it – intake
|
||||
* kind, channel, property – changes) and writes the facts of every change into the stored history.
|
||||
*/
|
||||
class CaseRecorder
|
||||
{
|
||||
/** Attributes that decide which profile applies; changing one re-freezes the profile. */
|
||||
private const DEFINING = ['intake', 'origin_channel_id', 'import_channel_id', 'property_id'];
|
||||
|
||||
public static function freeze(Booking $booking): void
|
||||
{
|
||||
if ($booking->isDirty('profile') && filled($booking->profile)) {
|
||||
return;
|
||||
}
|
||||
|
||||
$changed = $booking->exists && $booking->isDirty(self::DEFINING);
|
||||
if (filled($booking->profile) && ! $changed) {
|
||||
return;
|
||||
}
|
||||
|
||||
$booking->intake ??= ProcessSettings::intakeFor($booking);
|
||||
$profile = app(ProcessSettings::class)->forBooking($booking)->withOrigin($booking->exists ? 'changed' : 'intake');
|
||||
$booking->profile = $profile->toArray();
|
||||
$booking->case_type = $profile->caseType;
|
||||
}
|
||||
|
||||
public static function created(Booking $booking): void
|
||||
{
|
||||
CaseLog::record($booking, 'created', 'Vorgang angelegt: '.$booking->caseType()->getLabel().' ('.$booking->bookingChannelLabel().')', data: [
|
||||
'intake' => $booking->intake?->value,
|
||||
'case_type' => $booking->case_type?->value,
|
||||
]);
|
||||
}
|
||||
|
||||
public static function updated(Booking $booking): void
|
||||
{
|
||||
$changes = $booking->getChanges();
|
||||
$original = fn (string $key): mixed => $booking->getOriginal($key);
|
||||
|
||||
if (array_key_exists('profile', $changes) && $booking->wasChanged(self::DEFINING)) {
|
||||
CaseLog::record($booking, 'profile', 'Abwicklung neu bestimmt: '.$booking->caseType()->getLabel());
|
||||
}
|
||||
|
||||
if (array_key_exists('guest_id', $changes) && $booking->guest_id !== null) {
|
||||
CaseLog::record($booking, 'guest', 'Gast zugeordnet: '.(Guest::query()->find($booking->guest_id)?->full_name ?? '–'));
|
||||
}
|
||||
|
||||
if (array_key_exists('offer_version', $changes) && $booking->offer_version > 0) {
|
||||
CaseLog::record($booking, 'offer', 'Angebot Version '.$booking->offer_version.' gesendet'.($booking->hold_expires_at ? ', gültig bis '.$booking->hold_expires_at->format('d.m.Y, H:i').' Uhr' : ''));
|
||||
} elseif (array_key_exists('hold_expires_at', $changes) && $booking->hold_expires_at !== null && in_array($booking->status, BookingStatus::holding(), true) && ! array_key_exists('status', $changes)) {
|
||||
CaseLog::record($booking, 'hold', 'Reservierung verlängert bis '.$booking->hold_expires_at->format('d.m.Y, H:i').' Uhr');
|
||||
}
|
||||
|
||||
if (array_key_exists('status', $changes) && $original('status') !== $booking->status && ! ($booking->status === BookingStatus::OfferSent && array_key_exists('offer_version', $changes))) {
|
||||
CaseLog::record($booking, 'status', self::statusSummary($booking, $original('status')), data: [
|
||||
'from' => $original('status') instanceof BookingStatus ? $original('status')->value : $original('status'),
|
||||
'to' => $booking->status->value,
|
||||
]);
|
||||
}
|
||||
|
||||
if (array_key_exists('arrival', $changes) || array_key_exists('departure', $changes)) {
|
||||
CaseLog::record($booking, 'dates', 'Zeitraum: '.$booking->arrival->format('d.m.Y').' – '.$booking->departure->format('d.m.Y'));
|
||||
}
|
||||
|
||||
$facts = [
|
||||
'contact_requested_at' => 'Gast um Kontaktdaten gebeten',
|
||||
'guest_confirmed_at' => 'Gast hat die Buchung per E-Mail bestätigt',
|
||||
'confirmation_sent_at' => 'Bestätigung mit Unterlagen an den Gast gesendet',
|
||||
'confirmation_failed_at' => 'Versand der Bestätigung fehlgeschlagen',
|
||||
'arrival_info_sent_at' => 'Anreise-Informationen gesendet',
|
||||
'review_requested_at' => 'Gast um eine Bewertung gebeten',
|
||||
];
|
||||
foreach ($facts as $column => $summary) {
|
||||
if (array_key_exists($column, $changes) && $booking->{$column} !== null) {
|
||||
CaseLog::record($booking, 'fact', $summary);
|
||||
}
|
||||
}
|
||||
|
||||
if (array_key_exists('processing_mode', $changes)) {
|
||||
CaseLog::record($booking, 'mode', 'Bearbeitung dieses Vorgangs: '.($booking->processing_mode?->getLabel() ?? 'wie eingestellt ('.$booking->process()->processing()->getLabel().')'));
|
||||
}
|
||||
|
||||
if (array_key_exists('archived_at', $changes)) {
|
||||
CaseLog::record($booking, 'archive', $booking->archived_at ? 'Archiviert' : 'Aus dem Archiv geholt');
|
||||
}
|
||||
}
|
||||
|
||||
private static function statusSummary(Booking $booking, mixed $from): string
|
||||
{
|
||||
$from = $from instanceof BookingStatus ? $from : BookingStatus::tryFrom((string) $from);
|
||||
|
||||
return match ($booking->status) {
|
||||
BookingStatus::Confirmed => $booking->wasChanged('accepted_at') && $booking->accepted_at !== null
|
||||
? 'Angebot vom Gast angenommen – Buchung verbindlich'
|
||||
: ($booking->caseType()->isExternallyBinding() ? 'Beim Portal verbindlich gebucht – übernommen' : 'Buchung verbindlich bestätigt'),
|
||||
BookingStatus::DepositPaid => 'Anzahlung eingegangen',
|
||||
BookingStatus::Paid => 'Vollständig bezahlt',
|
||||
BookingStatus::Completed => 'Aufenthalt abgeschlossen',
|
||||
BookingStatus::Declined => 'Ohne Buchung beendet (abgelehnt'.($booking->declined_by ? ' durch '.($booking->declined_by === 'guest' ? 'den Gast' : 'uns') : '').')',
|
||||
BookingStatus::Expired => 'Ohne Buchung beendet (Frist abgelaufen)',
|
||||
BookingStatus::Cancelled => 'Storniert',
|
||||
BookingStatus::Reserved => $from === null ? 'Anfrage vorgemerkt' : 'Wieder als Anfrage geführt (vorher: '.$from->getLabel().')',
|
||||
BookingStatus::OfferSent => 'Angebot liegt beim Gast',
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,163 @@
|
||||
<?php
|
||||
|
||||
namespace App\Process;
|
||||
|
||||
use App\Enums\CaseType;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Enums\ProcessingMode;
|
||||
use App\Enums\ProcessSetting;
|
||||
use App\Enums\Responsibility;
|
||||
|
||||
/**
|
||||
* The rules that apply to one case: its intake kind, case type and the effective value of every process setting
|
||||
* together with the level it came from. Frozen on the case when it comes in, so later changes of the settings only
|
||||
* affect new cases.
|
||||
*/
|
||||
final class ProcessProfile
|
||||
{
|
||||
public const SYSTEM = 'system';
|
||||
|
||||
public const TENANT = 'tenant';
|
||||
|
||||
public const PROPERTY = 'property';
|
||||
|
||||
public const CHANNEL = 'channel';
|
||||
|
||||
/** Settings resolved when they are used instead of being frozen (documents capture their own template). */
|
||||
public const LIVE = [ProcessSetting::ContractTemplate];
|
||||
|
||||
/**
|
||||
* @param array<string, string|int|bool|null> $values setting key => effective value
|
||||
* @param array<string, string> $sources setting key => level the value came from
|
||||
*/
|
||||
public function __construct(
|
||||
public readonly IntakeKind $intake,
|
||||
public readonly CaseType $caseType,
|
||||
public readonly array $values,
|
||||
public readonly array $sources,
|
||||
public readonly ?string $frozenAt = null,
|
||||
public readonly string $origin = 'intake',
|
||||
) {}
|
||||
|
||||
/**
|
||||
* The case type of a constellation: internal occasions are A6; requests are A1 (own way) or A2 (intermediary);
|
||||
* binding external bookings are A3–A5 by who handles documents and payments.
|
||||
*/
|
||||
public static function caseTypeFor(IntakeKind $intake, bool $viaChannel, Responsibility $documents, Responsibility $payments): CaseType
|
||||
{
|
||||
return match ($intake) {
|
||||
IntakeKind::Internal => CaseType::A6,
|
||||
IntakeKind::Inquiry => $viaChannel ? CaseType::A2 : CaseType::A1,
|
||||
IntakeKind::Booking => match (true) {
|
||||
$documents === Responsibility::Portal => CaseType::A5,
|
||||
$payments === Responsibility::Portal => CaseType::A4,
|
||||
default => CaseType::A3,
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
public function value(ProcessSetting $setting): string|int|bool|null
|
||||
{
|
||||
return array_key_exists($setting->value, $this->values) ? $this->values[$setting->value] : $setting->default();
|
||||
}
|
||||
|
||||
public function source(ProcessSetting $setting): string
|
||||
{
|
||||
return $this->sources[$setting->value] ?? self::SYSTEM;
|
||||
}
|
||||
|
||||
public function processing(): ProcessingMode
|
||||
{
|
||||
return ProcessingMode::tryFrom((string) $this->value(ProcessSetting::Processing)) ?? ProcessingMode::Manual;
|
||||
}
|
||||
|
||||
public function preReservation(): bool
|
||||
{
|
||||
return (bool) $this->value(ProcessSetting::PreReservation);
|
||||
}
|
||||
|
||||
public function holdHours(): int
|
||||
{
|
||||
return max(1, (int) $this->value(ProcessSetting::HoldHours));
|
||||
}
|
||||
|
||||
public function documents(): Responsibility
|
||||
{
|
||||
return Responsibility::tryFrom((string) $this->value(ProcessSetting::Documents)) ?? Responsibility::Landlord;
|
||||
}
|
||||
|
||||
public function payments(): Responsibility
|
||||
{
|
||||
return Responsibility::tryFrom((string) $this->value(ProcessSetting::Payments)) ?? Responsibility::Landlord;
|
||||
}
|
||||
|
||||
public function guestMessages(): Responsibility
|
||||
{
|
||||
return Responsibility::tryFrom((string) $this->value(ProcessSetting::GuestMessages)) ?? Responsibility::Landlord;
|
||||
}
|
||||
|
||||
public function arrivalInfoDaysBefore(): int
|
||||
{
|
||||
return max(1, (int) $this->value(ProcessSetting::ArrivalInfoDaysBefore));
|
||||
}
|
||||
|
||||
public function contractTemplateId(): ?int
|
||||
{
|
||||
$value = $this->value(ProcessSetting::ContractTemplate);
|
||||
|
||||
return $value === null ? null : (int) $value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Plain words for a level, for the "where does this come from" hint.
|
||||
*/
|
||||
public static function sourceLabel(string $source): string
|
||||
{
|
||||
return match ($source) {
|
||||
self::TENANT => 'Ihre Standardeinstellung',
|
||||
self::PROPERTY => 'Abweichung der Wohnung',
|
||||
self::CHANNEL => 'Abweichung des Portals',
|
||||
'migration' => 'aus dem bisherigen Stand übernommen',
|
||||
default => 'Grundeinstellung',
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* The profile as it is frozen on the case (settings resolved live are left out).
|
||||
*
|
||||
* @return array{intake: string, case_type: string, values: array<string, string|int|bool|null>, sources: array<string, string>, frozen_at: string, origin: string}
|
||||
*/
|
||||
public function toArray(): array
|
||||
{
|
||||
$live = array_flip(array_map(fn (ProcessSetting $setting): string => $setting->value, self::LIVE));
|
||||
|
||||
return [
|
||||
'intake' => $this->intake->value,
|
||||
'case_type' => $this->caseType->value,
|
||||
'values' => array_diff_key($this->values, $live),
|
||||
'sources' => array_diff_key($this->sources, $live),
|
||||
'frozen_at' => $this->frozenAt ?? now()->toIso8601String(),
|
||||
'origin' => $this->origin,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $data
|
||||
*/
|
||||
public static function fromArray(array $data): self
|
||||
{
|
||||
return new self(
|
||||
IntakeKind::tryFrom((string) ($data['intake'] ?? '')) ?? IntakeKind::Inquiry,
|
||||
CaseType::tryFrom((string) ($data['case_type'] ?? '')) ?? CaseType::A1,
|
||||
(array) ($data['values'] ?? []),
|
||||
(array) ($data['sources'] ?? []),
|
||||
isset($data['frozen_at']) ? (string) $data['frozen_at'] : null,
|
||||
(string) ($data['origin'] ?? 'intake'),
|
||||
);
|
||||
}
|
||||
|
||||
public function withOrigin(string $origin): self
|
||||
{
|
||||
return new self($this->intake, $this->caseType, $this->values, $this->sources, $this->frozenAt, $origin);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,102 @@
|
||||
<?php
|
||||
|
||||
namespace App\Process;
|
||||
|
||||
use App\Enums\ChannelBookingModel;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Enums\ProcessSetting;
|
||||
use App\Enums\Responsibility;
|
||||
use App\Models\Booking;
|
||||
use App\Models\Channel;
|
||||
use App\Models\Property;
|
||||
use App\Models\Tenant;
|
||||
|
||||
/**
|
||||
* Resolves the effective process settings: built-in default → landlord default (tenant) → deviation of the property
|
||||
* (expert area) → deviation of the channel for the intake kind. A value that is not set inherits from the level above;
|
||||
* a deliberately set 0, "no" or "manual" is a value of its own.
|
||||
*/
|
||||
class ProcessSettings
|
||||
{
|
||||
public function resolve(Property $property, ?Channel $channel, IntakeKind $intake): ProcessProfile
|
||||
{
|
||||
$propertyLevel = (array) ($property->process_overrides ?? []);
|
||||
if ($property->contract_template_id !== null) {
|
||||
$propertyLevel[ProcessSetting::ContractTemplate->value] = $property->contract_template_id;
|
||||
}
|
||||
|
||||
$levels = [
|
||||
ProcessProfile::TENANT => $this->tenantDefaults($property->tenant_id),
|
||||
ProcessProfile::PROPERTY => $propertyLevel,
|
||||
ProcessProfile::CHANNEL => $intake === IntakeKind::Internal || $channel === null ? [] : (array) (($channel->process_overrides ?? [])[$intake->value] ?? []),
|
||||
];
|
||||
|
||||
$values = [];
|
||||
$sources = [];
|
||||
foreach (ProcessSetting::cases() as $setting) {
|
||||
$values[$setting->value] = $setting->default();
|
||||
$sources[$setting->value] = ProcessProfile::SYSTEM;
|
||||
|
||||
foreach ($levels as $level => $settings) {
|
||||
if ($level === ProcessProfile::CHANNEL && ! in_array($intake, $setting->channelIntakes(), true)) {
|
||||
continue;
|
||||
}
|
||||
$value = $setting->normalize($settings[$setting->value] ?? null);
|
||||
if ($value !== null) {
|
||||
$values[$setting->value] = $value;
|
||||
$sources[$setting->value] = $level;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if ($intake !== IntakeKind::Booking) {
|
||||
// A request is answered with our own offer and an internal case is ours anyway: the documents are ours.
|
||||
$values[ProcessSetting::Documents->value] = Responsibility::Landlord->value;
|
||||
$sources[ProcessSetting::Documents->value] = ProcessProfile::SYSTEM;
|
||||
}
|
||||
|
||||
$documents = Responsibility::from((string) $values[ProcessSetting::Documents->value]);
|
||||
$payments = Responsibility::from((string) $values[ProcessSetting::Payments->value]);
|
||||
|
||||
return new ProcessProfile($intake, ProcessProfile::caseTypeFor($intake, $channel !== null, $documents, $payments), $values, $sources);
|
||||
}
|
||||
|
||||
/**
|
||||
* The settings that would apply to a case right now (its frozen profile is what counts for the case itself).
|
||||
*/
|
||||
public function forBooking(Booking $booking): ProcessProfile
|
||||
{
|
||||
// The case's own landlord counts, whichever landlord is current (e.g. a case written by the system).
|
||||
$property = $booking->property ?? Property::withoutGlobalScope('tenant')->findOrFail($booking->property_id);
|
||||
|
||||
return $this->resolve($property, $booking->processChannel(), $booking->intake ?? self::intakeFor($booking));
|
||||
}
|
||||
|
||||
/**
|
||||
* Landlord defaults as stored on the tenant (not set: empty).
|
||||
*
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
public function tenantDefaults(?int $tenantId): array
|
||||
{
|
||||
if ($tenantId === null) {
|
||||
return [];
|
||||
}
|
||||
|
||||
return (array) (Tenant::query()->find($tenantId)?->process_defaults ?? []);
|
||||
}
|
||||
|
||||
/**
|
||||
* Intake kind of a case that does not name one: a case from a channel that only passes on requests is a request,
|
||||
* from other channels a booking that is already binding; everything else (website, phone, e-mail) a request.
|
||||
*/
|
||||
public static function intakeFor(Booking $booking): IntakeKind
|
||||
{
|
||||
$channel = $booking->processChannel();
|
||||
if ($channel === null) {
|
||||
return IntakeKind::Inquiry;
|
||||
}
|
||||
|
||||
return $channel->booking_model === ChannelBookingModel::Inquiry ? IntakeKind::Inquiry : IntakeKind::Booking;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,89 @@
|
||||
<?php
|
||||
|
||||
namespace App\Process;
|
||||
|
||||
use App\Enums\ActivityState;
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\ChannelTaskAction;
|
||||
use App\Filament\Resources\Bookings\BookingResource;
|
||||
use App\Filament\Resources\ChannelTasks\ChannelTaskResource;
|
||||
use App\Filament\Resources\InboxMessages\InboxMessageResource;
|
||||
use App\Filament\Resources\PortalOccupations\PortalOccupationResource;
|
||||
use App\Models\BlockedPeriod;
|
||||
use App\Models\Booking;
|
||||
use App\Models\ChannelTask;
|
||||
use App\Models\InboxMessage;
|
||||
|
||||
/**
|
||||
* "Zu erledigen": everything the landlord has to do, in one list – the next step of every open case, portals to block
|
||||
* or release, calendar entries nobody knows yet and system notices that need a decision. Each entry names the thing in
|
||||
* plain words and leads to the one place where it is done.
|
||||
*/
|
||||
class WorkList
|
||||
{
|
||||
/**
|
||||
* @return list<array{title: string, detail: ?string, url: string, button: string, tone: string, sort: string}>
|
||||
*/
|
||||
public static function items(): array
|
||||
{
|
||||
$items = [];
|
||||
|
||||
$cases = Booking::query()
|
||||
->with(['guest', 'property', 'payments', 'importChannel', 'originChannel'])
|
||||
->whereNull('archived_at')
|
||||
->whereNotIn('status', [BookingStatus::Declined, BookingStatus::Expired, BookingStatus::Completed])
|
||||
->where(fn ($query) => $query->whereNot('status', BookingStatus::Cancelled)->orWhereHas('tasks', fn ($tasks) => $tasks->where('status', 'open')))
|
||||
->get();
|
||||
foreach ($cases as $case) {
|
||||
$next = CaseActivities::next($case);
|
||||
if ($next === null) {
|
||||
continue;
|
||||
}
|
||||
$items[] = [
|
||||
'title' => $next->label,
|
||||
'detail' => $case->guestName().' · '.$case->arrival->format('d.m.').'–'.$case->departure->format('d.m.Y').' · '.$case->property->name.($next->detail ? ' · '.$next->detail : ''),
|
||||
'url' => BookingResource::getUrl('view', ['record' => $case]),
|
||||
'button' => 'Vorgang öffnen',
|
||||
'tone' => $next->state === ActivityState::Problem ? 'danger' : 'warning',
|
||||
'sort' => ($next->state === ActivityState::Problem ? '0' : '1').$case->arrival->format('Ymd'),
|
||||
];
|
||||
}
|
||||
|
||||
foreach (ChannelTask::query()->open()->with('channel.property')->orderBy('starts_on')->get() as $task) {
|
||||
$items[] = [
|
||||
'title' => ($task->action === ChannelTaskAction::Block ? 'In '.$task->channel?->name.' sperren' : 'In '.$task->channel?->name.' wieder freigeben'),
|
||||
'detail' => $task->period().' · '.$task->channel?->property?->name.' · '.$task->reason,
|
||||
'url' => ChannelTaskResource::getUrl(),
|
||||
'button' => 'Erledigen',
|
||||
'tone' => 'danger',
|
||||
'sort' => '0'.$task->starts_on->format('Ymd'),
|
||||
];
|
||||
}
|
||||
|
||||
foreach (BlockedPeriod::query()->unclear()->with(['channel', 'property'])->whereDate('ends_on', '>=', today())->orderBy('starts_on')->get() as $occupation) {
|
||||
$items[] = [
|
||||
'title' => 'Unbekannte Belegung von '.($occupation->channel?->name ?? 'einem Portal').' – was ist das?',
|
||||
'detail' => $occupation->starts_on->format('d.m.').'–'.$occupation->ends_on->format('d.m.Y').' · '.$occupation->property?->name,
|
||||
'url' => PortalOccupationResource::getUrl('view', ['record' => $occupation]),
|
||||
'button' => 'Klären',
|
||||
'tone' => 'warning',
|
||||
'sort' => '1'.$occupation->starts_on->format('Ymd'),
|
||||
];
|
||||
}
|
||||
|
||||
foreach (InboxMessage::query()->whereNull('read_at')->latest()->get() as $message) {
|
||||
$items[] = [
|
||||
'title' => $message->subject,
|
||||
'detail' => str($message->body)->limit(160)->toString(),
|
||||
'url' => $message->action_url ?: InboxMessageResource::getUrl(),
|
||||
'button' => 'Ansehen',
|
||||
'tone' => 'info',
|
||||
'sort' => '2'.$message->created_at?->format('YmdHis'),
|
||||
];
|
||||
}
|
||||
|
||||
usort($items, fn (array $a, array $b): int => strcmp($a['sort'], $b['sort']));
|
||||
|
||||
return $items;
|
||||
}
|
||||
}
|
||||
@@ -3,6 +3,8 @@
|
||||
namespace App\Providers\Filament;
|
||||
|
||||
use App\Enums\AdminMode;
|
||||
use App\Filament\Pages\Dashboard;
|
||||
use App\Http\Controllers\DocumentPreviewController;
|
||||
use App\Http\Controllers\SwitchPropertyController;
|
||||
use App\Http\Middleware\ResolveTheme;
|
||||
use App\Models\User;
|
||||
@@ -13,7 +15,6 @@
|
||||
use Filament\Http\Middleware\AuthenticateSession;
|
||||
use Filament\Http\Middleware\DisableBladeIconComponents;
|
||||
use Filament\Http\Middleware\DispatchServingFilamentEvent;
|
||||
use Filament\Pages\Dashboard;
|
||||
use Filament\Panel;
|
||||
use Filament\PanelProvider;
|
||||
use Filament\Support\Colors\Color;
|
||||
@@ -74,6 +75,7 @@ public function panel(Panel $panel): Panel
|
||||
->renderHook(PanelsRenderHook::SIDEBAR_NAV_START, fn (): View => view('filament.property-switcher'))
|
||||
->authenticatedRoutes(function (): void {
|
||||
Route::post('wohnung-wechseln', SwitchPropertyController::class)->name('switch-property');
|
||||
Route::get('vorgaenge/{booking}/dokument-vorschau/{kind}', DocumentPreviewController::class)->name('document-preview');
|
||||
})
|
||||
->navigationGroups(['Verwaltung', 'Einrichtung', 'Webseite', 'System'])
|
||||
->colors([
|
||||
|
||||
@@ -1,212 +0,0 @@
|
||||
<?php
|
||||
|
||||
namespace App\Support;
|
||||
|
||||
use App\Enums\BookingStatus;
|
||||
use App\Enums\BookingTaskKind;
|
||||
use App\Enums\BookingTaskStatus;
|
||||
use App\Enums\ChannelBookingModel;
|
||||
use App\Models\Booking;
|
||||
use App\Models\BookingMessage;
|
||||
use App\Models\BookingTask;
|
||||
use App\Models\Cancellation;
|
||||
use Carbon\CarbonImmutable;
|
||||
|
||||
/**
|
||||
* One view on where a booking stands: what kind of process it is, the steps with their state and the next
|
||||
* thing the landlord has to do. Everything is derived from the booking, nothing is stored.
|
||||
*/
|
||||
class BookingProgress
|
||||
{
|
||||
public const OWN = 'own';
|
||||
|
||||
public const MANUAL = 'manual';
|
||||
|
||||
public const PORTAL_BOOKING = 'portal_booking';
|
||||
|
||||
public const PORTAL_INQUIRY = 'portal_inquiry';
|
||||
|
||||
public static function kind(Booking $booking): string
|
||||
{
|
||||
$channel = $booking->importChannel ?? $booking->originChannel;
|
||||
if ($channel !== null) {
|
||||
return $channel->booking_model === ChannelBookingModel::PortalBooking ? self::PORTAL_BOOKING : self::PORTAL_INQUIRY;
|
||||
}
|
||||
|
||||
return $booking->source === 'website' ? self::OWN : self::MANUAL;
|
||||
}
|
||||
|
||||
public static function kindLabel(Booking $booking): string
|
||||
{
|
||||
$portal = ($booking->importChannel ?? $booking->originChannel)?->name;
|
||||
|
||||
return match (self::kind($booking)) {
|
||||
self::OWN => 'Eigene Webseite: Anfrage → Angebot → Annahme',
|
||||
self::MANUAL => 'Manuell erfasste Buchung',
|
||||
self::PORTAL_BOOKING => 'Portal-Buchung'.($portal ? " ({$portal})" : '').': beim Portal verbindlich, Vertrag von uns',
|
||||
default => 'Portal-Anfrage'.($portal ? " ({$portal})" : '').': wir antworten persönlich, Angebot und Vertrag von uns',
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* The milestones of the process with the activities that belong to each. An activity names the action on the
|
||||
* booking page that does it ("action"), so the landlord sees what was done, what is open and where to do it.
|
||||
*
|
||||
* @return list<array{label: string, state: string, detail: ?string, activities: list<array{label: string, done: bool, action: ?string}>}>
|
||||
*/
|
||||
public static function steps(Booking $booking): array
|
||||
{
|
||||
$today = CarbonImmutable::today();
|
||||
$kind = self::kind($booking);
|
||||
$closed = in_array($booking->status, [BookingStatus::Cancelled, BookingStatus::Declined, BookingStatus::Expired], true);
|
||||
$binding = in_array($booking->status, BookingStatus::occupying(), true);
|
||||
$hasEmail = filled($booking->guest?->email);
|
||||
$activity = fn (string $label, bool $done, ?string $action = null): array => ['label' => $label, 'done' => $done, 'action' => $done ? null : $action];
|
||||
$steps = [];
|
||||
|
||||
$steps[] = ['label' => 'Anfrage / Eingang', 'state' => 'done', 'detail' => $booking->created_at?->format('d.m.Y'), 'activities' => [
|
||||
$activity($kind === self::OWN ? 'Anfrage über die Webseite eingegangen' : 'Vorgang angelegt ('.$booking->bookingChannelLabel().')', true),
|
||||
]];
|
||||
|
||||
if (in_array($kind, [self::PORTAL_BOOKING, self::PORTAL_INQUIRY], true)) {
|
||||
$asked = $booking->contact_requested_at !== null;
|
||||
$steps[] = ['label' => 'Gast & Kontaktdaten', 'state' => $hasEmail ? 'done' : ($closed ? 'skipped' : 'current'), 'detail' => $hasEmail ? null : ($asked ? 'erfragt am '.$booking->contact_requested_at->format('d.m.Y') : 'fehlen noch'), 'activities' => [
|
||||
$activity('Gast um Kontaktdaten bitten', $hasEmail || $asked, 'Gast um Kontaktdaten bitten'),
|
||||
$activity('Kontaktdaten eintragen (Name, E-Mail, Anschrift)', $hasEmail, 'Kontaktdaten eintragen'),
|
||||
]];
|
||||
}
|
||||
|
||||
$needsOffer = in_array($kind, [self::OWN, self::PORTAL_INQUIRY, self::MANUAL], true);
|
||||
if ($needsOffer) {
|
||||
$steps[] = [
|
||||
'label' => 'Angebot',
|
||||
'state' => $booking->offer_version > 0 || $binding ? 'done' : ($closed ? 'skipped' : 'current'),
|
||||
'detail' => $booking->offer_version > 0 ? 'Version '.$booking->offer_version.', '.$booking->offer_sent_at?->format('d.m.Y') : null,
|
||||
'activities' => [$activity('Angebot mit Vertragsentwurf an den Gast senden', $booking->offer_version > 0 || $binding, 'Angebot senden')],
|
||||
];
|
||||
}
|
||||
|
||||
$steps[] = [
|
||||
'label' => $needsOffer ? 'Annahme / Vertrag' : 'Bestätigung / Vertrag',
|
||||
'state' => $binding ? ($booking->confirmation_sent_at !== null || $booking->accepted_at !== null || $needsOffer ? 'done' : 'current') : ($closed ? 'skipped' : ($booking->status === BookingStatus::OfferSent ? 'current' : 'todo')),
|
||||
'detail' => $booking->accepted_at ? 'angenommen '.$booking->accepted_at->format('d.m.Y') : ($booking->confirmation_sent_at ? 'Vertrag gesendet '.$booking->confirmation_sent_at->format('d.m.Y') : null),
|
||||
'activities' => array_values(array_filter([
|
||||
$needsOffer ? $activity('Gast nimmt das Angebot an (oder Buchung direkt bestätigen)', $binding, 'Direkt bestätigen') : $activity('Buchung bestätigen (Zeitraum fest belegen)', $binding, 'Direkt bestätigen'),
|
||||
$activity('Mietvertrag mit Anlagen an den Gast senden', $booking->confirmation_sent_at !== null, $binding ? 'Bestätigung erneut senden' : null),
|
||||
$booking->guest_confirmed_at ? $activity('Gast hat die Buchung per E-Mail bestätigt', true) : null,
|
||||
])),
|
||||
];
|
||||
|
||||
if ($booking->wantsPaymentTasks()) {
|
||||
$paid = $booking->paidAmount();
|
||||
$steps[] = ['label' => 'Anzahlung', 'state' => $closed ? 'skipped' : ($paid >= $booking->deposit && $binding ? 'done' : ($binding ? 'current' : 'todo')), 'detail' => $booking->deposit_due_on ? 'fällig '.$booking->deposit_due_on->format('d.m.Y') : null, 'activities' => [
|
||||
$activity('Zahlungseingang erfassen', $paid >= $booking->deposit && $binding, 'Zahlungen (unten)'),
|
||||
]];
|
||||
$steps[] = ['label' => 'Restzahlung', 'state' => $closed ? 'skipped' : ($paid >= $booking->total && $binding ? 'done' : ($binding && $paid >= $booking->deposit ? 'current' : 'todo')), 'detail' => 'fällig '.$booking->balance_due_on?->format('d.m.Y'), 'activities' => [
|
||||
$activity('Restzahlung erfassen', $paid >= $booking->total && $binding, 'Zahlungen (unten)'),
|
||||
]];
|
||||
} else {
|
||||
$steps[] = ['label' => 'Zahlung', 'state' => 'skipped', 'detail' => 'läuft über das Portal', 'activities' => []];
|
||||
}
|
||||
|
||||
$arrived = ! $closed && $binding && $booking->arrival <= $today;
|
||||
$left = ! $closed && $binding && $booking->departure <= $today;
|
||||
$steps[] = ['label' => 'Anreise', 'state' => $closed ? 'skipped' : ($arrived ? 'done' : 'todo'), 'detail' => $booking->arrival->format('d.m.Y'), 'activities' => [
|
||||
$activity('Anreise-Informationen ('.$booking->property->arrival_info_days_before.' Tage vorher, automatisch)', $booking->arrival_info_sent_at !== null),
|
||||
]];
|
||||
$steps[] = ['label' => 'Vor Ort', 'state' => $closed ? 'skipped' : ($arrived && ! $left ? 'current' : ($left ? 'done' : 'todo')), 'detail' => null, 'activities' => []];
|
||||
$steps[] = ['label' => 'Abreise', 'state' => $closed ? 'skipped' : ($left ? 'done' : 'todo'), 'detail' => $booking->departure->format('d.m.Y'), 'activities' => []];
|
||||
|
||||
return $steps;
|
||||
}
|
||||
|
||||
/**
|
||||
* What has happened so far, oldest first: milestones from the booking's own timestamps, payments and mails.
|
||||
*
|
||||
* @return list<array{at: CarbonImmutable, label: string}>
|
||||
*/
|
||||
public static function history(Booking $booking): array
|
||||
{
|
||||
$events = [];
|
||||
$add = function (mixed $at, string $label) use (&$events): void {
|
||||
if ($at !== null) {
|
||||
$events[] = ['at' => CarbonImmutable::instance($at), 'label' => $label];
|
||||
}
|
||||
};
|
||||
|
||||
$add($booking->created_at, 'Vorgang angelegt ('.$booking->bookingChannelLabel().')');
|
||||
$add($booking->contact_requested_at, 'Gast um Kontaktdaten gebeten');
|
||||
$add($booking->offer_sent_at, 'Angebot Version '.$booking->offer_version.' gesendet');
|
||||
$add($booking->accepted_at, 'Angebot vom Gast angenommen');
|
||||
$add($booking->guest_confirmed_at, 'Gast hat die Buchung per E-Mail bestätigt');
|
||||
$add($booking->confirmed_at, 'Buchung verbindlich bestätigt');
|
||||
$add($booking->confirmation_sent_at, 'Bestätigung mit Mietvertrag an den Gast gesendet');
|
||||
$add($booking->confirmation_failed_at, 'Versand der Bestätigung fehlgeschlagen');
|
||||
$add($booking->arrival_info_sent_at, 'Anreise-Informationen gesendet');
|
||||
$add($booking->cancelled_at, 'Storniert');
|
||||
$add($booking->archived_at, 'Archiviert');
|
||||
|
||||
foreach ($booking->payments()->get() as $payment) {
|
||||
$add($payment->paid_on ?? $payment->created_at, ($payment->amount < 0 ? 'Erstattung ' : 'Zahlung ').Money::format(abs($payment->amount)).' erfasst');
|
||||
}
|
||||
foreach (BookingMessage::query()->where('booking_id', $booking->id)->get() as $message) {
|
||||
$add($message->sent_at, 'E-Mail: '.$message->subject.' ('.$message->audience.')');
|
||||
}
|
||||
foreach (BookingTask::query()->where('booking_id', $booking->id)->where('status', BookingTaskStatus::Done)->get() as $task) {
|
||||
$add($task->completed_at, 'Aufgabe erledigt: '.$task->kind->getLabel());
|
||||
}
|
||||
|
||||
usort($events, fn (array $a, array $b): int => $a['at'] <=> $b['at']);
|
||||
|
||||
return $events;
|
||||
}
|
||||
|
||||
private static function cancelledText(Booking $booking, bool $open): string
|
||||
{
|
||||
$cancellation = Cancellation::query()->where('booking_id', $booking->id)->first();
|
||||
if ($cancellation === null) {
|
||||
return $open ? 'Stornokosten bzw. Rückzahlung sind noch zu klären (siehe Aufgaben).' : 'Nichts mehr zu tun. Die Buchung bleibt zur Historie erhalten.';
|
||||
}
|
||||
|
||||
$balance = $cancellation->balance();
|
||||
$text = 'Storniert am '.$cancellation->cancelled_on->format('d.m.Y').' ('.($cancellation->days_before ?? '?').' Tage vor Anreise). Stornokosten '.Money::format($cancellation->fee()).', bezahlt '.Money::format($cancellation->paid_amount).'.';
|
||||
|
||||
return $text.($cancellation->status === Cancellation::OPEN ? ($balance > 0 ? ' Noch einzufordern: '.Money::format($balance).'.' : ($balance < 0 ? ' Zu erstatten: '.Money::format(-$balance).'.' : ' Ausgeglichen – bitte als abgerechnet markieren.')) : ' Erledigt.');
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array{title: string, text: string, color: string}
|
||||
*/
|
||||
public static function next(Booking $booking): array
|
||||
{
|
||||
$today = CarbonImmutable::today();
|
||||
$kind = self::kind($booking);
|
||||
$money = fn (int $cents): string => Money::format($cents);
|
||||
|
||||
$openTasks = BookingTask::query()->where('booking_id', $booking->id)->where('status', BookingTaskStatus::Open)->get();
|
||||
$costs = $openTasks->firstWhere('kind', BookingTaskKind::CancellationFee);
|
||||
$wish = $openTasks->firstWhere('kind', BookingTaskKind::CancellationRequest);
|
||||
|
||||
if ($wish !== null && $booking->status !== BookingStatus::Cancelled) {
|
||||
return ['title' => 'Stornierungswunsch des Gastes', 'text' => 'Der Gast möchte stornieren. Bitte prüfen: stornieren (mit Mail an den Gast) oder ablehnen, und Stornokosten klären.', 'color' => 'danger'];
|
||||
}
|
||||
|
||||
return match (true) {
|
||||
$booking->status === BookingStatus::Cancelled => ['title' => 'Storniert', 'text' => self::cancelledText($booking, $costs !== null || $wish !== null), 'color' => $costs !== null ? 'warning' : 'gray'],
|
||||
$booking->status === BookingStatus::Declined => ['title' => 'Abgelehnt', 'text' => 'Der Zeitraum ist wieder frei.', 'color' => 'gray'],
|
||||
$booking->status === BookingStatus::Expired => ['title' => 'Abgelaufen', 'text' => 'Die Haltefrist ist verstrichen. Sie können die Anfrage trotzdem noch bestätigen, solange der Zeitraum frei ist.', 'color' => 'gray'],
|
||||
blank($booking->guest?->email) && $booking->departure > $today => ['title' => 'Kontaktdaten fehlen', 'text' => ($booking->contact_requested_at ? 'Die Kontaktdaten wurden am '.$booking->contact_requested_at->format('d.m.Y').' erfragt – Antwort abwarten. ' : 'Den Gast um Kontaktdaten bitten („Gast um Kontaktdaten bitten“). ').'Sobald sie da sind: „Kontaktdaten eintragen“ – dort lässt sich der Vertragsprozess automatisch starten oder von Hand weiterführen.', 'color' => 'warning'],
|
||||
$booking->status === BookingStatus::Reserved => ['title' => 'Anfrage prüfen', 'text' => $kind === self::PORTAL_BOOKING
|
||||
? 'Kontaktdaten des Gastes eintragen, dann „Direkt bestätigen“ – der Vertrag geht per E-Mail an den Gast.'
|
||||
: 'Angebot senden („Angebot senden“) oder ablehnen.'.($booking->hold_expires_at ? ' Vorgemerkt bis '.$booking->hold_expires_at->format('d.m.Y, H:i').' Uhr.' : ' Es ist kein Zeitraum vorgemerkt.'), 'color' => 'warning'],
|
||||
$booking->status === BookingStatus::OfferSent => ['title' => 'Wartet auf den Gast', 'text' => 'Angebot Version '.$booking->offer_version.' ist beim Gast. Gültig bis '.$booking->hold_expires_at?->format('d.m.Y, H:i').' Uhr.', 'color' => 'info'],
|
||||
$booking->confirmation_failed_at !== null && $booking->confirmation_sent_at === null => ['title' => 'Bestätigung nicht zugestellt', 'text' => 'Die Buchung steht, aber die Bestätigungs-E-Mail ist nicht beim Gast angekommen. „Bestätigung erneut senden“.', 'color' => 'danger'],
|
||||
$kind === self::PORTAL_BOOKING && $booking->confirmation_sent_at === null && $booking->contract_path === null => ['title' => 'Vertrag senden', 'text' => 'Die Buchung ist beim Portal verbindlich. Bitte den Vertrag an den Gast senden (Bestätigung erneut senden).', 'color' => 'warning'],
|
||||
$booking->wantsPaymentTasks() && $booking->openDeposit() > 0 && $booking->status === BookingStatus::Confirmed => ['title' => 'Anzahlung offen', 'text' => $money($booking->openDeposit()).' fällig bis '.$booking->deposit_due_on?->format('d.m.Y').'. Zahlungseingang unter „Zahlungen“ erfassen.', 'color' => $booking->deposit_due_on?->isPast() ? 'danger' : 'warning'],
|
||||
$booking->wantsPaymentTasks() && $booking->openAmount() > 0 && $booking->balance_due_on?->lessThanOrEqualTo($today->addDays(14)) => ['title' => 'Restzahlung offen', 'text' => $money($booking->openAmount()).' fällig bis '.$booking->balance_due_on->format('d.m.Y').'.', 'color' => $booking->balance_due_on->isPast() ? 'danger' : 'warning'],
|
||||
$booking->arrival <= $today && $booking->departure > $today => ['title' => 'Gast ist vor Ort', 'text' => 'Abreise am '.$booking->departure->format('d.m.Y').'.', 'color' => 'success'],
|
||||
$booking->arrival > $today => ['title' => 'Anreise in '.$today->diffInDays($booking->arrival).' Tagen', 'text' => 'Anreise am '.$booking->arrival->format('d.m.Y').'. Anreise-Informationen gehen '.$booking->property->arrival_info_days_before.' Tage vorher automatisch an den Gast.', 'color' => 'success'],
|
||||
default => ['title' => 'Aufenthalt beendet', 'text' => 'Abreise war am '.$booking->departure->format('d.m.Y').'.', 'color' => 'gray'],
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -1,5 +1,6 @@
|
||||
<?php
|
||||
|
||||
use App\Http\Middleware\ForceHttps;
|
||||
use App\Http\Middleware\ResolveTheme;
|
||||
use App\Http\Middleware\SecurityHeaders;
|
||||
use Illuminate\Foundation\Application;
|
||||
@@ -21,6 +22,7 @@
|
||||
'components.*.updates.data.export_mapping.*.separator',
|
||||
]);
|
||||
$middleware->web(append: [ResolveTheme::class]);
|
||||
$middleware->prepend(ForceHttps::class);
|
||||
$middleware->append(SecurityHeaders::class);
|
||||
})
|
||||
->withExceptions(function (Exceptions $exceptions): void {
|
||||
|
||||
@@ -121,6 +121,12 @@
|
||||
*/
|
||||
'scheduler_token' => env('FEWO_SCHEDULER_TOKEN'),
|
||||
|
||||
/*
|
||||
| Redirect plain-HTTP requests to HTTPS (App\Http\Middleware\ForceHttps). On by default everywhere except
|
||||
| local development and tests.
|
||||
*/
|
||||
'force_https' => (bool) env('FEWO_FORCE_HTTPS', ! in_array(env('APP_ENV', 'production'), ['local', 'testing'], true)),
|
||||
|
||||
/*
|
||||
| Optional external automation (e.g. a browser bot on a private server) that carries out
|
||||
| manual blocking tasks. Tasks are POSTed signed with HMAC-SHA256 of the body.
|
||||
|
||||
@@ -0,0 +1,80 @@
|
||||
<?php
|
||||
|
||||
use Illuminate\Database\Migrations\Migration;
|
||||
use Illuminate\Database\Schema\Blueprint;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
|
||||
/**
|
||||
* The booking becomes the one "case" (Vorgang) of every business occasion (docs/Prozessarchitektur, package 1 of
|
||||
* UMSETZUNGSPLAN_v0.10): unknown guest, number of guests and amounts are allowed, every case knows its intake kind,
|
||||
* its case type and the process profile frozen when it came in, and its history is stored as events. Settings get
|
||||
* three levels: landlord defaults (tenant), optional deviations of a property (expert area) and of a channel per
|
||||
* intake kind. Purely additive – nothing existing is removed here.
|
||||
*/
|
||||
return new class extends Migration
|
||||
{
|
||||
public function up(): void
|
||||
{
|
||||
Schema::table('bookings', function (Blueprint $table): void {
|
||||
$table->foreignId('guest_id')->nullable()->change();
|
||||
$table->unsignedTinyInteger('guests')->nullable()->change();
|
||||
$table->json('quote')->nullable()->change();
|
||||
$table->unsignedInteger('total')->nullable()->change();
|
||||
$table->unsignedInteger('deposit')->nullable()->change();
|
||||
$table->date('balance_due_on')->nullable()->change();
|
||||
|
||||
$table->string('intake', 12)->nullable()->after('source');
|
||||
$table->string('case_type', 4)->nullable()->index()->after('intake');
|
||||
$table->json('profile')->nullable()->after('case_type');
|
||||
$table->string('processing_mode', 12)->nullable()->after('profile');
|
||||
});
|
||||
|
||||
Schema::table('tenants', function (Blueprint $table): void {
|
||||
$table->json('process_defaults')->nullable();
|
||||
});
|
||||
|
||||
Schema::table('properties', function (Blueprint $table): void {
|
||||
$table->json('process_overrides')->nullable();
|
||||
});
|
||||
|
||||
Schema::table('channels', function (Blueprint $table): void {
|
||||
$table->json('process_overrides')->nullable();
|
||||
});
|
||||
|
||||
Schema::create('booking_events', function (Blueprint $table): void {
|
||||
$table->id();
|
||||
$table->foreignId('tenant_id')->nullable()->constrained()->cascadeOnDelete();
|
||||
$table->foreignId('booking_id')->constrained()->cascadeOnDelete();
|
||||
$table->string('type', 30);
|
||||
$table->string('summary', 500);
|
||||
$table->string('actor', 120)->nullable();
|
||||
$table->text('reason')->nullable();
|
||||
$table->json('data')->nullable();
|
||||
$table->timestamp('occurred_at');
|
||||
$table->timestamps();
|
||||
$table->index(['booking_id', 'occurred_at']);
|
||||
});
|
||||
}
|
||||
|
||||
public function down(): void
|
||||
{
|
||||
Schema::dropIfExists('booking_events');
|
||||
|
||||
Schema::table('channels', function (Blueprint $table): void {
|
||||
$table->dropColumn('process_overrides');
|
||||
});
|
||||
|
||||
Schema::table('properties', function (Blueprint $table): void {
|
||||
$table->dropColumn('process_overrides');
|
||||
});
|
||||
|
||||
Schema::table('tenants', function (Blueprint $table): void {
|
||||
$table->dropColumn('process_defaults');
|
||||
});
|
||||
|
||||
Schema::table('bookings', function (Blueprint $table): void {
|
||||
$table->dropIndex(['case_type']);
|
||||
$table->dropColumn(['intake', 'case_type', 'profile', 'processing_mode']);
|
||||
});
|
||||
}
|
||||
};
|
||||
@@ -0,0 +1,213 @@
|
||||
<?php
|
||||
|
||||
use Illuminate\Database\Migrations\Migration;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
|
||||
/**
|
||||
* Carries the existing data over to the case core without changing behaviour:
|
||||
*
|
||||
* 1. Process settings of the properties (handling mode, pre-reservation, hold, arrival info) become landlord defaults
|
||||
* where all properties of a landlord agree. Where they differ, nothing is unified: the landlord default stays the
|
||||
* built-in default and every property keeps its own value as a deviation (expert area). Report:
|
||||
* `php artisan process:settings-report`.
|
||||
* 2. Channel switches (payment tasks per booking model, contract templates) become channel deviations per intake kind.
|
||||
* 3. Every existing case gets intake kind, case type and a profile frozen with exactly the values the old code used
|
||||
* for it (origin "migration").
|
||||
* 4. The history so far is written from the timestamps, payments, mails and finished tasks.
|
||||
* 5. Placeholder guests ("Gast (Portal)", no e-mail) are detached; unknown guests stay unknown.
|
||||
*
|
||||
* Only plain queries – no models, so later model changes cannot alter what this migration did.
|
||||
*/
|
||||
return new class extends Migration
|
||||
{
|
||||
/** Old property column => setting key. */
|
||||
private const PROPERTY_SETTINGS = [
|
||||
'offer_mode' => 'processing',
|
||||
'pre_reservation_enabled' => 'pre_reservation',
|
||||
'hold_hours' => 'hold_hours',
|
||||
'arrival_info_days_before' => 'arrival_info_days_before',
|
||||
];
|
||||
|
||||
public function up(): void
|
||||
{
|
||||
$this->moveSettings();
|
||||
$this->moveChannelSwitches();
|
||||
$this->backfillCases();
|
||||
$this->backfillHistory();
|
||||
$this->detachPlaceholderGuests();
|
||||
}
|
||||
|
||||
public function down(): void
|
||||
{
|
||||
DB::table('booking_events')->delete();
|
||||
DB::table('bookings')->update(['intake' => null, 'case_type' => null, 'profile' => null, 'processing_mode' => null]);
|
||||
DB::table('channels')->update(['process_overrides' => null]);
|
||||
DB::table('properties')->update(['process_overrides' => null]);
|
||||
DB::table('tenants')->update(['process_defaults' => null]);
|
||||
}
|
||||
|
||||
private function moveSettings(): void
|
||||
{
|
||||
foreach (DB::table('properties')->get() as $property) {
|
||||
$byTenant[$property->tenant_id][] = $property;
|
||||
}
|
||||
|
||||
foreach ($byTenant ?? [] as $tenantId => $properties) {
|
||||
$defaults = [];
|
||||
$overrides = [];
|
||||
foreach (self::PROPERTY_SETTINGS as $column => $key) {
|
||||
$values = array_map(fn (object $property): mixed => $this->settingValue($column, $property->{$column}), $properties);
|
||||
if (count(array_unique($values, SORT_REGULAR)) === 1) {
|
||||
$defaults[$key] = $values[0];
|
||||
|
||||
continue;
|
||||
}
|
||||
foreach ($properties as $property) {
|
||||
$overrides[$property->id][$key] = $this->settingValue($column, $property->{$column});
|
||||
}
|
||||
}
|
||||
|
||||
DB::table('tenants')->where('id', $tenantId)->update(['process_defaults' => json_encode($defaults)]);
|
||||
foreach ($overrides as $propertyId => $values) {
|
||||
DB::table('properties')->where('id', $propertyId)->update(['process_overrides' => json_encode($values)]);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private function settingValue(string $column, mixed $value): string|int|bool
|
||||
{
|
||||
return match ($column) {
|
||||
'offer_mode' => $value === 'automatic' ? 'automatic' : 'manual',
|
||||
'pre_reservation_enabled' => (bool) $value,
|
||||
default => (int) $value,
|
||||
};
|
||||
}
|
||||
|
||||
private function moveChannelSwitches(): void
|
||||
{
|
||||
foreach (DB::table('channels')->get() as $channel) {
|
||||
$inquiry = [];
|
||||
$booking = [];
|
||||
if (! $channel->payment_tasks_inquiry) {
|
||||
$inquiry['payments'] = 'portal';
|
||||
}
|
||||
if (! $channel->payment_tasks_reservation) {
|
||||
$booking['payments'] = 'portal';
|
||||
}
|
||||
if ($channel->contract_template_id !== null) {
|
||||
$inquiry['contract_template_id'] = (int) $channel->contract_template_id;
|
||||
}
|
||||
if (($channel->contract_template_reservation_id ?? $channel->contract_template_id) !== null) {
|
||||
$booking['contract_template_id'] = (int) ($channel->contract_template_reservation_id ?? $channel->contract_template_id);
|
||||
}
|
||||
|
||||
DB::table('channels')->where('id', $channel->id)->update(['process_overrides' => json_encode(array_filter(['inquiry' => $inquiry, 'booking' => $booking]))]);
|
||||
}
|
||||
}
|
||||
|
||||
private function backfillCases(): void
|
||||
{
|
||||
$properties = DB::table('properties')->get()->keyBy('id');
|
||||
$channels = DB::table('channels')->get()->keyBy('id');
|
||||
|
||||
foreach (DB::table('bookings')->orderBy('id')->get() as $booking) {
|
||||
$property = $properties[$booking->property_id] ?? null;
|
||||
$channel = $channels[$booking->import_channel_id ?? $booking->origin_channel_id ?? 0] ?? null;
|
||||
|
||||
$intake = $channel === null || $channel->booking_model === 'inquiry' ? 'inquiry' : 'booking';
|
||||
// Exactly what the old code did: payment tasks by the channel's booking model, documents always ours.
|
||||
$payments = $channel === null || ($channel->booking_model === 'portal_booking' ? $channel->payment_tasks_reservation : $channel->payment_tasks_inquiry) ? 'landlord' : 'portal';
|
||||
$caseType = $intake === 'inquiry' ? ($channel === null ? 'a1' : 'a2') : ($payments === 'portal' ? 'a4' : 'a3');
|
||||
|
||||
$values = [
|
||||
'processing' => $property?->offer_mode === 'automatic' ? 'automatic' : 'manual',
|
||||
'pre_reservation' => (bool) ($property->pre_reservation_enabled ?? true),
|
||||
'hold_hours' => (int) ($property->hold_hours ?? 48),
|
||||
'documents' => 'landlord',
|
||||
'payments' => $payments,
|
||||
'guest_messages' => 'landlord',
|
||||
'arrival_info_days_before' => (int) ($property->arrival_info_days_before ?? 3),
|
||||
];
|
||||
|
||||
DB::table('bookings')->where('id', $booking->id)->update([
|
||||
'intake' => $intake,
|
||||
'case_type' => $caseType,
|
||||
'profile' => json_encode([
|
||||
'intake' => $intake,
|
||||
'case_type' => $caseType,
|
||||
'values' => $values,
|
||||
'sources' => array_fill_keys(array_keys($values), 'migration'),
|
||||
'frozen_at' => now()->toIso8601String(),
|
||||
'origin' => 'migration',
|
||||
]),
|
||||
]);
|
||||
}
|
||||
}
|
||||
|
||||
private function backfillHistory(): void
|
||||
{
|
||||
$facts = [
|
||||
'created_at' => 'Vorgang angelegt',
|
||||
'contact_requested_at' => 'Gast um Kontaktdaten gebeten',
|
||||
'offer_sent_at' => 'Angebot gesendet',
|
||||
'accepted_at' => 'Angebot vom Gast angenommen',
|
||||
'guest_confirmed_at' => 'Gast hat die Buchung per E-Mail bestätigt',
|
||||
'confirmed_at' => 'Buchung verbindlich',
|
||||
'confirmation_sent_at' => 'Bestätigung mit Unterlagen an den Gast gesendet',
|
||||
'confirmation_failed_at' => 'Versand der Bestätigung fehlgeschlagen',
|
||||
'arrival_info_sent_at' => 'Anreise-Informationen gesendet',
|
||||
'review_requested_at' => 'Gast um eine Bewertung gebeten',
|
||||
'cancelled_at' => 'Storniert',
|
||||
'archived_at' => 'Archiviert',
|
||||
];
|
||||
$now = now();
|
||||
|
||||
foreach (DB::table('bookings')->orderBy('id')->get() as $booking) {
|
||||
$rows = [];
|
||||
$add = function (mixed $at, string $type, string $summary) use (&$rows, $booking, $now): void {
|
||||
if ($at !== null) {
|
||||
$rows[] = ['tenant_id' => $booking->tenant_id, 'booking_id' => $booking->id, 'type' => $type, 'summary' => mb_substr($summary, 0, 500), 'actor' => 'System', 'reason' => null, 'data' => null, 'occurred_at' => $at, 'created_at' => $now, 'updated_at' => $now];
|
||||
}
|
||||
};
|
||||
|
||||
foreach ($facts as $column => $summary) {
|
||||
$add($booking->{$column} ?? null, 'migrated', $column === 'offer_sent_at' ? 'Angebot Version '.$booking->offer_version.' gesendet' : $summary);
|
||||
}
|
||||
foreach (DB::table('payments')->where('booking_id', $booking->id)->get() as $payment) {
|
||||
$add($payment->paid_on ?? $payment->created_at, 'payment', ($payment->amount < 0 ? 'Erstattung ' : 'Zahlung ').number_format(abs($payment->amount) / 100, 2, ',', '.').' € erfasst');
|
||||
}
|
||||
foreach (DB::table('booking_messages')->where('booking_id', $booking->id)->get() as $message) {
|
||||
$add($message->sent_at, 'mail', 'E-Mail: '.$message->subject);
|
||||
}
|
||||
foreach (DB::table('booking_tasks')->where('booking_id', $booking->id)->where('status', 'done')->get() as $task) {
|
||||
$add($task->completed_at, 'task', 'Aufgabe erledigt ('.$task->kind.')');
|
||||
}
|
||||
$add($now, 'migrated', 'Bisheriger Verlauf aus den vorhandenen Daten übernommen');
|
||||
|
||||
foreach (array_chunk($rows, 100) as $chunk) {
|
||||
DB::table('booking_events')->insert($chunk);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Guests created only to fill the required guest of a portal reservation: first name "Gast", the channel name in
|
||||
* brackets as last name, no e-mail. Their cases now simply have no guest yet.
|
||||
*/
|
||||
private function detachPlaceholderGuests(): void
|
||||
{
|
||||
$placeholders = DB::table('guests')->where('first_name', 'Gast')->where('last_name', 'like', '(%)')->where(fn ($query) => $query->whereNull('email')->orWhere('email', ''))->pluck('id');
|
||||
if ($placeholders->isEmpty()) {
|
||||
return;
|
||||
}
|
||||
|
||||
DB::table('bookings')->whereIn('guest_id', $placeholders)->update(['guest_id' => null]);
|
||||
DB::table('blocked_periods')->whereIn('guest_id', $placeholders)->update(['guest_id' => null]);
|
||||
|
||||
foreach ($placeholders as $guestId) {
|
||||
if (! DB::table('bookings')->where('guest_id', $guestId)->exists()) {
|
||||
DB::table('guests')->where('id', $guestId)->delete();
|
||||
}
|
||||
}
|
||||
}
|
||||
};
|
||||
@@ -0,0 +1,44 @@
|
||||
<?php
|
||||
|
||||
use Illuminate\Database\Migrations\Migration;
|
||||
use Illuminate\Database\Schema\Blueprint;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
|
||||
/**
|
||||
* Package 3 of UMSETZUNGSPLAN_v0.10 (documents): a contract template version is released for guests or not, and it may
|
||||
* be confirmed as reproducing only what guests accept when booking on a portal (E-004). The landlord releases the texts
|
||||
* of each document kind (tenants.document_releases).
|
||||
*
|
||||
* Existing template versions were used without such a release so far; they count as released to keep today's offers
|
||||
* and confirmations working. None is confirmed as portal terms – that is the landlord's statement to make.
|
||||
*/
|
||||
return new class extends Migration
|
||||
{
|
||||
public function up(): void
|
||||
{
|
||||
Schema::table('contract_templates', function (Blueprint $table): void {
|
||||
$table->timestamp('released_at')->nullable();
|
||||
$table->string('released_by', 120)->nullable();
|
||||
$table->timestamp('portal_terms_confirmed_at')->nullable();
|
||||
$table->string('portal_terms_confirmed_by', 120)->nullable();
|
||||
});
|
||||
|
||||
Schema::table('tenants', function (Blueprint $table): void {
|
||||
$table->json('document_releases')->nullable();
|
||||
});
|
||||
|
||||
DB::table('contract_templates')->update(['released_at' => now(), 'released_by' => 'Übernahme (bisher schon verwendet)']);
|
||||
}
|
||||
|
||||
public function down(): void
|
||||
{
|
||||
Schema::table('contract_templates', function (Blueprint $table): void {
|
||||
$table->dropColumn(['released_at', 'released_by', 'portal_terms_confirmed_at', 'portal_terms_confirmed_by']);
|
||||
});
|
||||
|
||||
Schema::table('tenants', function (Blueprint $table): void {
|
||||
$table->dropColumn('document_releases');
|
||||
});
|
||||
}
|
||||
};
|
||||
@@ -206,6 +206,8 @@ ## 7a. Datensicherung, Löschfristen, Automationen
|
||||
- **Löschfristen** (Vorschläge, rechtlich zu bestätigen – `config/fewo.php` bzw. `.env`): Gästedaten 10 Jahre nach letztem Aufenthalt (`FEWO_GUEST_RETENTION_YEARS`), nie verbindlich gewordene Anfragen/Angebote 6 Monate (`FEWO_RETENTION_INQUIRY_MONTHS`), Textauszüge von Portal-Mails 90 Tage (`FEWO_RETENTION_PORTAL_EMAIL_EXCERPT_DAYS`), Herkunftsangaben/UTM 24 Monate (`FEWO_RETENTION_ATTRIBUTION_MONTHS`). Läuft täglich 03:00. Anonymisierung ersetzt Name, Kontaktdaten, Nachrichten, Notizen, Herkunft und Bewertungs-Anzeigenamen; Buchung, Preise und Zahlungen bleiben als Beleg.
|
||||
- **Bot-Schutz der Buchungsanfrage** (ohne externen Captcha-Dienst, `config/fewo.php › spam`): verstecktes Köderfeld, Zeitsperre (Absenden schneller als 4 s nach dem Öffnen = Bot, wird still ignoriert), höchstens 5 Anfragen/Stunde je IP, 3/Tag je E-Mail-Adresse, 30/Stunde insgesamt, höchstens 2 gleichzeitig vorgemerkte Anfragen je E-Mail-Adresse (sonst könnten Bots den Kalender blockieren), keine Links in Namen und höchstens 1 Link in der Nachricht.
|
||||
- **Automationen (n8n):** Token bitte als Header `Authorization: Bearer <token>` senden (landet nicht in Server-Logs); `?token=` funktioniert übergangsweise weiter.
|
||||
- **HTTPS:** `App\Http\Middleware\ForceHttps` leitet HTTP-Aufrufe (GET/HEAD 301, sonst 308) auf HTTPS um, in der Anwendung statt in der `.htaccess` – diese wird bei jedem Deployment neu geschrieben. Abschaltbar mit `FEWO_FORCE_HTTPS=false`. Zusätzlich sollte in Strato „SSL erzwingen“ aktiv sein, falls das Paket die Option anbietet.
|
||||
- **Restore-Test (30.10.2026, lokal, SQLite):** Dump mit `backup:database` aus einer frisch migrierten und gesäten Datenbank, in eine leere Datei zurückgespielt: 42 von 42 Tabellen, alle Zeilenzahlen gleich, 66 Migrationen „Ran“, keine ausstehend. Für **MariaDB (Strato) steht der Nachweis noch aus**: Dump mit `backup:database` erzeugen, in eine zweite, leere Strato-Datenbank per phpMyAdmin/`mysql` einspielen und Zeilenzahlen von `bookings`, `guests`, `pages`, `channels` vergleichen. Die Produktionsdatenbank wird dabei nicht verändert.
|
||||
- **Fotos:** Beim Hochladen werden Metadaten (GPS, Kamera) aus dem Original entfernt; bestehende Fotos einmalig: `php artisan photos:strip-metadata` (`--force` bearbeitet auch bereits markierte erneut). Hinweis: bewusst mit GD – Imagick (auf Strato installiert) behält EXIF beim Speichern.
|
||||
|
||||
## 8. Bekannte Eigenheiten und Lösungen
|
||||
|
||||
+1
@@ -0,0 +1 @@
|
||||
{}
|
||||
@@ -0,0 +1 @@
|
||||
{}
|
||||
@@ -0,0 +1,33 @@
|
||||
{
|
||||
"file-explorer": true,
|
||||
"global-search": true,
|
||||
"switcher": true,
|
||||
"graph": true,
|
||||
"backlink": true,
|
||||
"canvas": true,
|
||||
"outgoing-link": true,
|
||||
"tag-pane": true,
|
||||
"footnotes": false,
|
||||
"properties": true,
|
||||
"page-preview": true,
|
||||
"daily-notes": true,
|
||||
"templates": true,
|
||||
"note-composer": true,
|
||||
"command-palette": true,
|
||||
"slash-command": false,
|
||||
"editor-status": true,
|
||||
"bookmarks": true,
|
||||
"markdown-importer": false,
|
||||
"zk-prefixer": false,
|
||||
"random-note": false,
|
||||
"outline": true,
|
||||
"word-count": true,
|
||||
"slides": false,
|
||||
"audio-recorder": false,
|
||||
"workspaces": false,
|
||||
"file-recovery": true,
|
||||
"publish": false,
|
||||
"sync": true,
|
||||
"bases": true,
|
||||
"webviewer": false
|
||||
}
|
||||
+22
@@ -0,0 +1,22 @@
|
||||
{
|
||||
"collapse-filter": true,
|
||||
"search": "",
|
||||
"showTags": false,
|
||||
"showAttachments": false,
|
||||
"hideUnresolved": false,
|
||||
"showOrphans": true,
|
||||
"collapse-color-groups": true,
|
||||
"colorGroups": [],
|
||||
"collapse-display": true,
|
||||
"showArrow": false,
|
||||
"textFadeMultiplier": 0,
|
||||
"nodeSizeMultiplier": 1,
|
||||
"lineSizeMultiplier": 1,
|
||||
"collapse-forces": true,
|
||||
"centerStrength": 0.518713248970312,
|
||||
"repelStrength": 10,
|
||||
"linkStrength": 1,
|
||||
"linkDistance": 250,
|
||||
"scale": 1,
|
||||
"close": false
|
||||
}
|
||||
+200
@@ -0,0 +1,200 @@
|
||||
{
|
||||
"main": {
|
||||
"id": "e551ceee940ecb6c",
|
||||
"type": "split",
|
||||
"children": [
|
||||
{
|
||||
"id": "45ad11e6bd426ed7",
|
||||
"type": "tabs",
|
||||
"children": [
|
||||
{
|
||||
"id": "6f2679f564edc126",
|
||||
"type": "leaf",
|
||||
"state": {
|
||||
"type": "markdown",
|
||||
"state": {
|
||||
"file": "00_Prozesslandkarte.md",
|
||||
"mode": "source",
|
||||
"source": false
|
||||
},
|
||||
"icon": "lucide-file",
|
||||
"title": "00_Prozesslandkarte"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"direction": "vertical"
|
||||
},
|
||||
"left": {
|
||||
"id": "677ae3e7a3c51888",
|
||||
"type": "split",
|
||||
"children": [
|
||||
{
|
||||
"id": "d98321f663785e14",
|
||||
"type": "tabs",
|
||||
"children": [
|
||||
{
|
||||
"id": "cd2450a4f1ac56b2",
|
||||
"type": "leaf",
|
||||
"state": {
|
||||
"type": "file-explorer",
|
||||
"state": {
|
||||
"sortOrder": "alphabetical",
|
||||
"autoReveal": false,
|
||||
"showSearch": false,
|
||||
"searchQuery": ""
|
||||
},
|
||||
"icon": "lucide-folder-closed",
|
||||
"title": "Dateiexplorer"
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "5ac14d1839d3ff95",
|
||||
"type": "leaf",
|
||||
"state": {
|
||||
"type": "search",
|
||||
"state": {
|
||||
"query": "",
|
||||
"matchingCase": false,
|
||||
"explainSearch": false,
|
||||
"collapseAll": false,
|
||||
"extraContext": false,
|
||||
"sortOrder": "alphabetical"
|
||||
},
|
||||
"icon": "lucide-search",
|
||||
"title": "Suchen"
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "faa5cd42d8f20e2b",
|
||||
"type": "leaf",
|
||||
"state": {
|
||||
"type": "bookmarks",
|
||||
"state": {
|
||||
"showSearch": false,
|
||||
"searchQuery": ""
|
||||
},
|
||||
"icon": "lucide-bookmark",
|
||||
"title": "Lesezeichen"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"direction": "horizontal",
|
||||
"width": 300
|
||||
},
|
||||
"right": {
|
||||
"id": "d7407959975136f3",
|
||||
"type": "split",
|
||||
"children": [
|
||||
{
|
||||
"id": "5595addba8cae338",
|
||||
"type": "tabs",
|
||||
"children": [
|
||||
{
|
||||
"id": "7aa1456df3c0e543",
|
||||
"type": "leaf",
|
||||
"state": {
|
||||
"type": "backlink",
|
||||
"state": {
|
||||
"file": "00_Prozesslandkarte.md",
|
||||
"collapseAll": false,
|
||||
"extraContext": false,
|
||||
"sortOrder": "alphabetical",
|
||||
"showSearch": false,
|
||||
"searchQuery": "",
|
||||
"backlinkCollapsed": false,
|
||||
"unlinkedCollapsed": true
|
||||
},
|
||||
"icon": "links-coming-in",
|
||||
"title": "Rückverweise"
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "71826ebd06babd87",
|
||||
"type": "leaf",
|
||||
"state": {
|
||||
"type": "outgoing-link",
|
||||
"state": {
|
||||
"file": "00_Prozesslandkarte.md",
|
||||
"linksCollapsed": false,
|
||||
"unlinkedCollapsed": true
|
||||
},
|
||||
"icon": "links-going-out",
|
||||
"title": "Ausgehende Links"
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "94047f11d8cf598a",
|
||||
"type": "leaf",
|
||||
"state": {
|
||||
"type": "tag",
|
||||
"state": {
|
||||
"sortOrder": "frequency",
|
||||
"useHierarchy": true,
|
||||
"showSearch": false,
|
||||
"searchQuery": ""
|
||||
},
|
||||
"icon": "lucide-tags",
|
||||
"title": "Tags"
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "ca2a154a0256f6d4",
|
||||
"type": "leaf",
|
||||
"state": {
|
||||
"type": "all-properties",
|
||||
"state": {
|
||||
"sortOrder": "frequency",
|
||||
"showSearch": false,
|
||||
"searchQuery": ""
|
||||
},
|
||||
"icon": "lucide-archive",
|
||||
"title": "Alle Eigenschaften"
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "154170f0a686e7f0",
|
||||
"type": "leaf",
|
||||
"state": {
|
||||
"type": "outline",
|
||||
"state": {
|
||||
"file": "00_Prozesslandkarte.md",
|
||||
"followCursor": false,
|
||||
"showSearch": false,
|
||||
"searchQuery": ""
|
||||
},
|
||||
"icon": "lucide-list",
|
||||
"title": "Gliederung"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"direction": "horizontal",
|
||||
"width": 300,
|
||||
"collapsed": true
|
||||
},
|
||||
"left-ribbon": {
|
||||
"hiddenItems": {
|
||||
"switcher:Schnellauswahl öffnen": false,
|
||||
"graph:Graph-Ansicht öffnen": false,
|
||||
"canvas:Neuen Canvas erstellen": false,
|
||||
"daily-notes:Heutige Notiz öffnen": false,
|
||||
"templates:Vorlage einfügen": false,
|
||||
"command-palette:Befehlspalette öffnen": false,
|
||||
"bases:Neue Base erstellen": false
|
||||
}
|
||||
},
|
||||
"active": "6f2679f564edc126",
|
||||
"lastOpenFiles": [
|
||||
"00_Prozesslandkarte.md",
|
||||
"00_Buchungsarchetypen.md",
|
||||
"00_Portalprofile_und_Vertragsvorlagen.md",
|
||||
"Buchsungsprozesse/Willkommen.md",
|
||||
"README.md",
|
||||
"QUELLENMANIFEST.md"
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,168 @@
|
||||
---
|
||||
id: A00
|
||||
typ: archetypenkatalog
|
||||
titel: FewoPortal – Buchungsarchetypen und Verantwortungsübergaben
|
||||
status: diskussionsentwurf
|
||||
version: "0.9"
|
||||
stand: 2026-11-01
|
||||
prozess: V01
|
||||
bezugsstand_prozessarchitektur: "0.7"
|
||||
---
|
||||
|
||||
# A00 – Buchungsarchetypen und Verantwortungsübergaben
|
||||
|
||||
> **Arbeitsstand für das Fachinterview, nicht abschließend freigegeben.** Grundlage: Betreiberbeschreibung vom 31.10.2026; Übergaben `UEBERGABE-BUCHUNGSPROZESS.md` (30.10.2026) und `crystalline-floating-glacier.md` (31.10.2026); Prozessarchitektur v0.7 und Szenarien R01/R08. **Bestätigte Geschäftsregeln, aktueller Praxisablauf, Annahmen und offene Fragen werden getrennt ausgewiesen.**
|
||||
|
||||
## 1. Gemeinsamer Grundsatz
|
||||
|
||||
FewoPortal ist das **führende interne Buchungsverwaltungssystem** für mehrere kleine Vermieter mit typischerweise 1–3 Wohnungen je Vermieter. Es gibt **einen generischen Wertschöpfungsprozess V01** mit den Phasen:
|
||||
|
||||
1. **P01** Buchungseingang & Verfügbarkeitssicherung
|
||||
2. **P02** Konditionen & Buchungsverbindlichkeit
|
||||
3. **P03** Buchungsverwaltung & kaufmännische Abwicklung
|
||||
4. **P04** Leistungsvorbereitung & Aufenthalt
|
||||
5. **P05** Abschluss & Nachbereitung
|
||||
|
||||
**Archetypen sind Geschäftskonstellationen, keine getrennt zu implementierenden Workflows.** Sie bestimmen die bei Eintritt bekannten Tatsachen, Zuständigkeiten, notwendigen Aktivitäten, Kommunikationswege und Nachweise. Derselbe **Vorgang** und dieselben Fachfunktionen werden verwendet. Die früher diskutierte zusätzlich anzulegende „Buchungsakte“ entfällt als eigenständige fachliche Einheit. Ein Portal kann einzelne Tätigkeiten durchführen; FewoPortal behält den konsolidierten Vorgangsüberblick, ohne fremde Primärnachweise vorzutäuschen.
|
||||
|
||||
## 2. Katalog der sechs Archetypen
|
||||
|
||||
| ID | Geschäftskonstellation | Zustand beim Eingang | Vertragsunterlagen | Zahlung / Storno | Informationsbedarf |
|
||||
|---|---|---|---|---|---|
|
||||
| **A1** | Kompletter Vorgang über eigene Website / FewoPortal | Unverbindliche Anfrage | Verbindliches eigenes Angebot, fristgerechte Annahme, anschließend Vertragsdokumentation | Wir | Eigene Anfrage- und Gastdaten, ggf. ergänzen |
|
||||
| **A2** | Unverbindliche Anfrage eines Vermittlungsportals, Eingang z. B. über Portalnachricht, E-Mail, Telefon oder erkennbare iCal-Information | Noch keine Buchungsverbindlichkeit | Angebot/Annahme/Vertrag bei uns | Typischerweise wir, profilabhängig | Häufig unvollständig; gezielte Nachforderung |
|
||||
| **A3** | Externe Direktbuchung mit anschließender vollständiger Abwicklung durch uns | Bereits verbindliche Portalbuchung | Wir versenden Dokumentation der bestehenden Vereinbarung, **keine zweite Annahme** | Wir | Buchung, Portalpreis und Gastdaten übernehmen / ergänzen |
|
||||
| **A4** | Externe Direktbuchung mit **geteilter Abwicklung** (heutiger FeWo-direkt-Fall) | Bereits verbindliche Portalbuchung | Vertragsdokumentation durch uns ohne zweite Annahme | Zahlung über Portal; tatsächliche Storno-/Mahnverantwortung noch prüfen | Gastdaten, rechtsrelevante Konditionen, Portalstatus, lokale Abgaben |
|
||||
| **A5** | Externe Direktbuchung mit weitgehend vollständiger Portalabwicklung | Bereits verbindliche Portalbuchung | Durch Portal, soweit tatsächlich vereinbart | Durch Portal, soweit tatsächlich vereinbart | Für Vor-Ort-Betreuung und rechtliche Pflichten benötigte Daten und Status |
|
||||
| **A6** | Eigenbelegung, private Überlassung (z. B. Familie/Freunde) und sonstige Verfügbarkeitssperre | Interner Belegungsanlass | Je nach Fall Buchungs-/Aufenthaltsbestätigung, interne Reservierungsbestätigung oder kein Dokument | Gegebenenfalls Kurabgabe, Wäsche und andere Zusatzleistungen; bei reiner Sperre keine Gastzahlung | Gäste, Personen und Leistungen **optional**, Sperrgrund immer dokumentieren |
|
||||
|
||||
**Historische Einordnung E-012, fortgeschrieben durch E-022:** Der **frühere A6 „Hub-/Partnervermittlung“** wurde abgeschafft und bleibt abgeschafft. Die Kennung **A6 wird neu für interne Belegungs- und Sperrvorgänge** verwendet. Die Weitervermittlungsherkunft ist nur ein optionales kaufmännisches Merkmal. „Manuell/telefonisch“ ist weiterhin ein Eingangskanal und kein eigener Archetyp.
|
||||
|
||||
## 3. Gegenüberstellung entlang des generischen Prozesses
|
||||
|
||||
| Phase | A1 | A2 | A3 | A4 | A5 | A6 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| **P01 Eingang** | Gastanfrage, Verfügbarkeit, ggf. zeitlicher Hold | Portalinformation prüfen, Anfrage qualifizieren, fehlende Daten nachfordern, ggf. Hold | Extern verbindliche Buchung übernehmen, Belegung sichern | Wie A3; Nachricht ggf. nur mit wenigen Gastdaten | Wie A3; lokale Datenversorgung sicherstellen | Internen Anlass erfassen, Zeitraum sichern, Sperrgrund protokollieren |
|
||||
| **P02 Konditionen / Bindung** | Eigener Preis, bindendes Angebot, fristgerechte Annahme | Nach Ergänzung der Daten grundsätzlich wie A1 | **Verbindlichen Portalpreis übernehmen**; externen Abschluss nachweisen | Gleiches Prinzip; zusätzliche Prüfung der tatsächlich vereinbarten Portalbedingungen | Externen Abschluss/Konditionsstand dokumentieren, kein eigenes Angebot | Optional Gast-/Belegungsbestätigung; kein Mietvertrag für reine Sperre |
|
||||
| **P03 Abwicklung** | Vertrag, Kalender, Fristen und eigene Zahlungsüberwachung | Grundsätzlich wie A1, Kommunikation ggf. im Portal | Vertragsdokumentation und gesamte weitere Abwicklung durch uns | Vertrag durch uns; Zahlung über Portal; Storno/Mahnung noch abgrenzen | Externe Abwicklung überwachen, soweit für unsere Aufgaben/Haftung erforderlich | Ggf. Gastdaten, Kurabgabe und gebuchte Zusatzleistungen/Zahlungen; reine Sperre ohne Gastabrechnung |
|
||||
| **P04 Leistung** | Anreise, lokale Pflichten, Aufenthalt, Abreise | Wie A1 | Wie A1 | Wie A1, zuvor Gastinformationen nachfordern | Wie A1, soweit wir vor Ort verantwortlich sind | Private Nutzung oder Wartung; nur notwendige Aktivitäten |
|
||||
| **P05 Abschluss** | Aufenthalt, Feedback, offene Fälle übergeben | Wie A1 | Wie A1 | Wie A1, ggf. offener Portal-Auszahlungs-/Stornofall | Lokale Erfüllung abschließen, relevante Portal-Ergebnisse erfassen | Nutzung/Arbeit beenden, Belegung freigeben, Folgen nachhalten |
|
||||
|
||||
Die Partnerherkunft begründet **keinen zusätzlichen Archetyp**; sie wird nur bei relevantem Einfluss auf die Vermittlerprovision oder notwendige Auswertung erfasst. Phasen können sich zeitlich überlappen; eine bereits extern verbindliche Buchung darf nicht durch offene Stammdaten künstlich unverbindlich werden.
|
||||
|
||||
## 4. Gemeinsame Informations- und Übergabegates
|
||||
|
||||
| Gate | Einheitlich benötigte Information / Nachweis | Vorgehen bei Lücke |
|
||||
|---|---|---|
|
||||
| **G1 – Eingang qualifiziert** | Objekt, Zeitraum, Eingangskanal, Buchungs-/Anfrageart, ggf. externe Referenz; Herkunft, soweit ermittelbar | Unklare Belegung als Klärungsfall; keine ungeprüfte verbindliche Buchung behaupten |
|
||||
| **G2 – Bindung geklärt** | Entweder **eigenes** fristgerecht angenommenes Angebot oder **externer** Nachweis der Buchungsverbindlichkeit; maßgebliche Konditionen und Preis | Nachweis nachfordern / manuell prüfen; keine zweite Annahme der bereits verbindlichen Portalbuchung |
|
||||
| **G3 – Abwicklung zugeordnet** | Zuständig für Vertrag, Zahlungsaufforderung, Zahlung, Mahnung, Storno, Rückerstattung, Kommunikation; relevante Fristen und Statusquellen | Zuständigkeit als offen markieren, Klärungsaufgabe erzeugen |
|
||||
| **G4 – Leistung vorbereitet** | Erforderliche Gästedaten, Kontaktmöglichkeit, Anreise-/Leistungsinformationen, lokale gesetzliche Meldedaten soweit einschlägig | Datenbeschaffung über Portal, Gast oder manuell; Aufenthaltsvorbereitung gezielt verfolgen |
|
||||
| **G5 – Leistung abgeschlossen** | Aufenthalt/Leistung beendet, Feedbackprozess angestoßen bzw. bearbeitet, offene Nachläufer einer zuständigen Bearbeitung übergeben | Fehlende Übergaben und lokale Folgeaufgaben sichtbar halten |
|
||||
|
||||
Pro Gate sind die Zustände **intern erfüllt / extern erfüllt (mit Quelle) / nicht anwendbar / offen** zu unterscheiden. Die **fachliche Bindung** und die **Vollständigkeit der Gastdaten** sind getrennte Dimensionen. Für einzelne Tätigkeiten kann es zusätzliche Feld- oder Fristvoraussetzungen geben.
|
||||
|
||||
## 5. A4 – FeWo-direkt als realer Referenzfall (Betreiberangaben)
|
||||
|
||||
**Bekannter bzw. beschriebener Ablauf:**
|
||||
|
||||
1. Gast bucht unmittelbar über FeWo-direkt; eine verbindliche Buchung entsteht laut Betreiber bereits dort.
|
||||
2. FeWo-direkt bestätigt die Buchung und fordert Zahlungen (Anzahlung, Restbetrag) über seinen Zahlungsweg an.
|
||||
3. FewoPortal erhält die Buchungsinformation; der Informationsumfang ist geringer als für die eigene Vertrags- und Aufenthaltsabwicklung erforderlich. Nach jüngster Betreiberangabe sind Name und E-Mail bekannt, die Anschrift fehlt; **tatsächlich übermittelte Felder müssen anhand eines Beispiels verifiziert werden**.
|
||||
4. FewoPortal ordnet Buchung, Belegung, Portalkonditionen und Referenz zu. **Der vom Gast gebuchte Portalpreis wird nicht durch unsere Kalkulation ersetzt.**
|
||||
5. Fehlende Gäste-/Vertrags- und ggf. örtliche Meldedaten werden über den verfügbaren Kontaktweg nachgefordert; manueller Fallback bleibt möglich.
|
||||
6. Wir erstellen und versenden unsere Vertragsdokumentation **ohne erneute formale Annahme**; die Vereinbarung darf dabei nicht stillschweigend um andere Konditionen erweitert werden.
|
||||
7. FewoPortal steuert Anreise, lokale Betreuung, Aufenthalt, Abreise und Abschluss. Externe Zahlungen/Statusmeldungen werden, soweit verfügbar und erforderlich, referenziert.
|
||||
|
||||
**Noch nicht bestätigt / zu prüfen:**
|
||||
|
||||
- Welche Vertragsinhalte und Zusatzbedingungen sieht der Gast **vor seiner bindenden Buchung** tatsächlich? Deckt sich das mit dem späteren von uns versandten Vertrag?
|
||||
- Welche Partei / welcher Zahlungsdienstleister wickelt **Mahnung, Stornierung, Rückerstattung, Nichtzahlung und Schäden** in welcher Konstellation konkret ab?
|
||||
- Welche Angaben umfasst der **verbindlich vereinbarte Gastpreis**? Werden Plattform-Servicegebühr für Reisende, Vermieterprovision, Steuer/Kurabgabe und Auszahlungsbetrag getrennt ausgewiesen? **Vermieterprovision nicht ohne Grundlage dem Gast zusätzlich berechnen.**
|
||||
- Wie erhalten wir belastbare Statusinformationen über erfolgte Zahlungen, Stornos und Erstattungen? Wenn das Portal diese nicht maschinenlesbar liefert, ist der manuelle Nachweisweg zu definieren.
|
||||
- Welche Daten sind für Kurabgabe/Meldepflichten tatsächlich erforderlich, und wann müssen diese vorliegen?
|
||||
- Welches Ereignis wird beim Eingang einer Portalstornierung/Änderung ausgelöst; wie wird die Belegung aktualisiert und der Betreiber informiert?
|
||||
|
||||
**Rechtlicher Prüfvermerk, keine abschließende Bewertung:** Die offiziellen FeWo-direkt-Gastgeberbedingungen beschreiben die Vertragsbeziehung grundsätzlich zwischen Gast und Vermieter sowie Vorgaben zu offenzulegenden Bedingungen und Gebühren. Daraus lässt sich **nicht allein** ableiten, dass der konkrete nachträgliche Versand unseres Vertragsdokuments rechtswidrig oder rechtssicher ist. Zu prüfen sind tatsächlich angezeigte Vertragsbedingungen und konkreter Buchungsablauf. Quellen: [FeWo-direkt Gastgeberbedingungen](https://www.fewo-direkt.de/lp/b/partner-terms-of-use), [FeWo-direkt Gastbedingungen](https://www.fewo-direkt.de/lp/b/terms-of-service).
|
||||
|
||||
## 6. Übergreifende Regeln und bewusste Grenzen
|
||||
|
||||
- **Einheitliche Akte, einheitliche Konditions- und Vertragszusammenstellung**, keine getrennten Formulare je Kanal.
|
||||
- Bei **A1/A2** ist unser befristetes Angebot für uns bindend; rechtzeitige Annahme macht die Buchung verbindlich. Bei Fristablauf ohne Annahme endet der Vorgang ohne Buchung, eigene Belegungssperre wird nach Konfliktprüfung freigegeben. **Hold- und Angebotsfrist müssen zusammenpassen** (konkrete Regel noch offen).
|
||||
- Bei **A3–A5** wird die bestehende externe Verbindlichkeit **nicht** durch eigenen Angebotsversand oder einen erneuten Annahmeklick ersetzt.
|
||||
- Portalpreise und zugesagte Konditionen sind als **externe Vereinbarung mit Quelle** abzulegen; unsere Vergleichskalkulation darf höchstens erklärend sein.
|
||||
- Ein iCal-Belegungsereignis **allein** beweist nicht zwingend den Buchungsvertrag. Sichere Klassifikation kann zur automatischen Akte führen; unklare Ereignisse werden nicht still als Buchung interpretiert.
|
||||
- Fehlende oder widersprüchliche Daten bleiben als **fehlt / unbestätigt / bekannt**, jeweils mit Quelle, sichtbar. Keine erfundenen Werte, keine vermeidbaren Dubletten-Gäste.
|
||||
- Die Software für kleine Vermieter benötigt **keinen frei skriptbaren Workflow-Designer**; wenige nachvollziehbare Abwicklungsprofile und konfigurierbare Auslöser/Aktivitäten genügen zunächst.
|
||||
- Automatisierte Entscheidungen sind nachzuvollziehen und bei Fehlzuordnung korrigierbar. Geschäftlich oder rechtlich wirksame Vorgänge sind nicht durch bloßes Löschen „rückgängig“ zu machen.
|
||||
- Der V01-Prozess kann **regulär abgeschlossen**, **ohne Buchung beendet** oder **storniert** enden. Offene Folgefälle werden kontrolliert übergeben; nicht still verworfen.
|
||||
|
||||
## 7. Portalunabhängige Konditions- und Vertragsprofile (Ergänzung 31.10.2026)
|
||||
|
||||
**Bestätigte fachliche Regel:** Ein Buchungsportal kann eigene Preise, Rabatte, Stornoregeln und Buchungsbedingungen verwalten. Bei extern verbindlichen Buchungen sind die **tatsächlich vereinbarten Portalkonditionen** maßgeblich. Bei unverbindlichen externen Anfragen kann die anschließende Angebotsgestaltung vollständig bei uns liegen. Der konkrete Datenumfang und die Verfügbarkeit von Nachweisen sind je Portal verschieden.
|
||||
|
||||
**Vertragsvorlagen dürfen sich je Vermieter, Wohnung, Portal, Buchungstyp und ggf. tatsächlicher Partnerherkunft unterscheiden.** Die Auswahl erfolgt über das zutreffende Buchungs-/Abwicklungsprofil, **nicht nur über den allgemeinen Portaltyp**; der Vermieter kann sie bei Bedarf in der gemeinsamen Konditionszusammenstellung bewusst ändern. Die gewählte Vorlagenversion, Anlagen und der zugrunde liegende Konditionsstand werden pro Buchung unveränderlich dokumentiert.
|
||||
|
||||
Unterscheidung der Dokumentfunktion: **A1/A2** verwenden bindendes eigenes Angebot mit Annahme; **A3/A4** dokumentieren und versenden ggf. die bereits extern verbindliche Vereinbarung **ohne zweite Annahme**; **A5** verlangt eigene Vertragsdokumente nur, soweit dies fachlich/rechtlich tatsächlich erforderlich ist. Nicht belegte oder abweichende Konditionen sind Klärungsfälle, keine automatisch ergänzten Vertragspflichten.
|
||||
|
||||
**Zu konfigurierende Kanalmerkmale:** Herkunft verbindlicher Preise/Rabatte/Stornobedingungen, Erkennbarkeit und Nachweise, Zuständigkeiten, erlaubte Dokumente, automatische oder manuelle Datenerfassung und Vertragsversand. Kein hardcodiertes FeWo-direkt-Verhalten.
|
||||
|
||||
Siehe [[00_Portalprofile_und_Vertragsvorlagen|00 – Portalprofile und Vertragsvorlagen]] für das schlanke Referenzmodell.
|
||||
|
||||
## 8. Bezug zu vorhandenen Dokumenten
|
||||
|
||||
- [[00_Prozesslandkarte|Prozesslandkarte]] – V01/V02, fünf Phasen und übergreifende Leitregeln.
|
||||
- [[G00_Gates_und_Uebergaben|Gates und Übergaben]] – konzeptionelle Gate-Logik.
|
||||
- [[E00_Entscheidungsprotokoll|Entscheidungsprotokoll]] – bereits bestätigte Entscheidungen.
|
||||
- [[X00_Sonderprozesse|Sonderprozesse]] – derzeit bekannte Ausnahmefamilien.
|
||||
- [[R00_Szenarien/R01_Eigene_Webseite|Referenzfall eigene Webseite]] – gesonderter Arbeitsentwurf (sofern dieser bereits ins Repository übernommen wurde).
|
||||
|
||||
## 9. Ergänzende A4-Vertragsanalyse (Stand 31.10.2026)
|
||||
|
||||
Die vom Betreiber bereitgestellte vierseitige FeWo-direkt-Vertragsvorlage wurde unter [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 – Vertragsvorlage und Prozessanalyse]] gesondert bewertet. Besonders prüfbedürftig sind: Verbindlichkeit vor dem nachträglichen Vertragsversand (§ 5), zuvor einbezogene Konditionen, Preis-/Gebührentrennung (§ 4), Portalstorno gegenüber eigener Stornoklausel (§ 13), Datenbedarf sowie sichere Trennung von Vertragsdokument und Zugangs-/Anreiseinformationen. **Keine Änderung der Betreibervertragsklauseln ohne gesonderte rechtliche und fachliche Freigabe.**
|
||||
|
||||
**Status dieses Dokuments:** Fünf Archetypen (A1–A5) nach E-012; Portalprofile und rechtliche Detailfragen bleiben offen. Neben FeWo-direkt (A4) ist Destination Solutions (A3) dokumentierter Praxisfall.
|
||||
|
||||
## 10. A4-Praxisnachweis aus FeWo-direkt-Ansichten (31.10.2026)
|
||||
|
||||
Für eine konkrete zukünftige Buchung sind **aggregierte Übernachtungsrate, Rabatt, Gebühren/Steuern, Gesamtzahlung des Gastes, Abzug an FeWo-direkt, Auszahlungsvorschau sowie zwei Zahlungsraten und deren Fälligkeits-/Zahlungsstatus** im Vermieterbereich sichtbar. Auch angezeigte Stornobedingungen und der vorgesehene 72-Stunden-Anreiseinformationsversand sind erkennbar. **Nicht nachgewiesen** sind die vollständigen Tagespreis- und Gebührenbestandteile, ein belastbarer allgemeiner Zahlungsexport, die tatsächliche Auszahlung, der vollständige Vertragsinhalt der Gastbestätigung und die vollständigen Gaststammdaten. Zwei Ansichten weisen zudem **unterschiedliche voraussichtliche Vermieterauszahlungen (900,20 € / 894,69 €)** aus, Ursache offen. Details im [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse#7. Nachtrag aus belegten Bildschirmansichten (31.10.2026) – Ist-Zustand, nicht allgemeines Portalverhalten|A4-Vertrags- und Prozessdokument]].
|
||||
|
||||
**Portalinvariante:** Verantwortlichkeit für Zahlung oder Kommunikation, Portalstatus und tatsächlicher Erfüllungsnachweis sind getrennt zu verwalten.
|
||||
|
||||
|
||||
## 11. Änderungs- und Stornoereignisse (portalunabhängig)
|
||||
|
||||
Ein Storno bzw. eine Buchungsänderung ist ein **Teilprozess auf demselben Vorgang**, kein zusätzlicher Archetyp. Die fachliche Ursache (Gastwunsch, Unmöglichkeit beim Vermieter, Doppelbuchung, Regelverstoß, technischer Fehler), der Initiator, der ausführende Beteiligte und die Abwicklungsverantwortung sind voneinander zu unterscheiden. Anfrage, Bestätigung und tatsächliche Wirksamkeit sind getrennte Ereigniszustände. Kalender, Konditionen, Vertrag und Zahlungen werden erst nach ausreichend belegter Wirksamkeit angepasst. Eine durch den Vermieter verursachte Stornierung darf nicht durch Aufforderung an den Gast als Gaststorno umetikettiert werden. **FeWo-direkt** ist dafür ein dokumentiertes Portalbeispiel (siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 Abschnitt 8]]); andere Portale können abweichende Wege, Daten und Zuständigkeiten haben.
|
||||
|
||||
|
||||
## 12. Destination Solutions als Praxisreferenz A3 (E-012/E-016/E-017/E-018)
|
||||
|
||||
- **Verbindlicher Buchungseingang**, vollständige weitere Vertrags-, Gäste-, Zahlungs- und Aufenthaltsabwicklung beim Vermieter; keine zweite Angebotsannahme. Der Vermieter erhält laut Betreiber eine vollständige Buchungsmeldung für seine Abwicklung, **nicht zwingend eine vollständige Einzelpreis- oder Gebührenzerlegung**.
|
||||
- **Keine im genutzten Zugang funktionierende automatische Kalendersynchronisation**; manuelles Blockieren anderer Portale. Ein Portalbeleg über den Zeitpunkt oder die wirksame Verteilung an Partnerkanäle steht nach Betreibererfahrung nicht zur Verfügung.
|
||||
- **Vermittlerprovisionen** können nach Vertriebskanal variieren. Sie sind nicht nachträglich vom Gast zu fordern. Ob zusätzlich ein direkter Gast-Aufschlag/Serviceentgelt oder Partner-Endpreisaufschlag existiert, muss beim Anbieter und anhand einer Gastbestätigung geprüft werden.
|
||||
- **Stornostaffel** vom Betreiber angegeben: ≥60 Tage 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, ≤11 Tage 100 % vom „Mietpreis“; **vorvertragliche Einbeziehung, Berechnungsbasis und rechtliche Wirksamkeit offen**.
|
||||
|
||||
Siehe [[R00_Szenarien/R08_Destination_Solutions|R08 Destination Solutions]] und [[O00_Offene_Portalprueffaelle|O00 Offene Portalprüffälle]].
|
||||
|
||||
## 13. Portaldaten können unterschiedlich detailliert und zusammengesetzt sein (E-014/E-015)
|
||||
|
||||
Bei A2–A5 sind **automatische, manuelle und hybride** Informationen und Tätigkeiten gleichwertig zu modellieren. Pro Buchung sind vollständig aufgeschlüsselte Positionen, **kombinierte Service-/Gebührenpositionen**, bloße Gesamtbeträge sowie nur teilweise verfügbare Zahlungsauszüge möglich. Keine fiktive Zerlegung des Gesamtpreises; unbekannte Gebührenarten, Zahlende/Empfänger und Provisionsanteile bleiben offen. Nachträgliche Zuordnung oder Aufteilung erhält den originalen Portalbetrag und verhindert doppelte Summierung. Fehlende rein interne Kostenanalyse blockiert nicht ohne Weiteres den vertraglichen Aufenthalt. Siehe [[K01_Preisstruktur_und_Abrechnung|K01]].
|
||||
|
||||
## 14. Erweiterung v0.9 – A6, einheitlicher Vorgang und pragmatischer Angebotsweg
|
||||
|
||||
**Beschluss E-022 bis E-027 (01.11.2026):** A6 umfasst **Eigenbelegung, unentgeltliche oder private Überlassung und sonstige Sperren**, mit konfigurierbarem Grund (z. B. Eigennutzung, Familienbesuch, Reparatur, Reinigung, organisatorische Sperre). Der Vorgang entsteht bei Erfassung des internen Anlasses genauso wie bei A1–A5; eine gesonderte „Buchungsakte anlegen“-Entscheidung entfällt. Die vorhandene Zuordnung extern eingehender Buchungen zum Auslöserportal/Owner wird **als bereits implementiert** vorausgesetzt, nicht neu beauftragt.
|
||||
|
||||
- **Optional statt ausnahmslos entgeltfrei:** Familienmitglieder oder Freunde können als Gäste mit Teilnehmerdaten erfasst werden; Kurabgabe, Wäschepakete und andere Zusatzleistungen können anfallen. Eine Mietzahlung ist keine Voraussetzung für diese Funktionen.
|
||||
- **Gemeinsamer Prozesskern:** Belegung, Kontakte, Aktivitäten, Dokumente, Zahlungen, Ereignishistorie und Storno-/Änderungsfunktion werden soweit benötigt wiederverwendet. Bei einer Wartungssperre dürfen Gäste, Rechnungen und Vertragsdokumente vollständig entfallen. Keine künstliche Durchführung aller P01–P05-Teilschritte.
|
||||
- **Dokument nach Profil:** Reservierungs-, Buchungs- oder Aufenthaltsbestätigung abhängig von Vermieter, Objekt, Anlass und Vorgangs-/Buchungstyp; reine Sperre kann ohne Versand bleiben. Ein Bestätigungsdokument darf keine nicht vereinbarten Pflichten erzeugen.
|
||||
- **Abgrenzung zum Hold:** Eine zeitlich begrenzte Reservierung im Rahmen einer A1/A2-Anfrage ist **Teil desselben Vermietungsvorgangs**, kein separater A6.
|
||||
- **Storno/Änderung:** Verkürzung, Verlängerung, Verschiebung oder Aufhebung einer A6-Belegung nutzt den gleichen technischen Mechanismus, jedoch ohne pauschal mietvertragliche Stornofolgen zu unterstellen.
|
||||
|
||||
**A1/A2-Angebotsvereinfachung (E-025/E-026):** Die konfigurierbare **Haltefrist** steuert die eigene Vorreservierung (beispielsweise 0, 24, 48 oder 72 Stunden). Bei Haltefrist größer null kann ein verbindliches, fristgebundenes Angebot mit passender Vorlage erstellt werden, sofern die eigene Sicherung zum Angebot passt. Bei **0** entsteht **keine Reservierung**; versendet wird eine passende Preis-/Verfügbarkeitsauskunft **ohne uneingeschränkt annehmbares Buchungsangebot**. Vor verbindlicher Buchung wird die Verfügbarkeit erneut geprüft und der Abschluss bestätigt. Eine **separate Preisbindefrist** wird **nicht** als MVP-Standard benötigt: Preise werden typischerweise jahresweise gepflegt, Dynamik-/Yield-Management ist nicht vorgesehen. Es bleibt der jeweils vereinbarte, historisierte Buchungspreis maßgeblich.
|
||||
|
||||
**Verhältnismäßigkeit (E-027):** Das verbleibende Doppelbuchungsrisiko wird nicht weggemodelliert; Betreiberangabe: zwei Doppelbuchungen in rund zwanzig Jahren. Externe Live-Prüfung wäre vorteilhaft, steht aber nicht überall zur Verfügung. Ein einfacher nachweisbarer Konflikt-/Sperrablauf reicht für den MVP, kein komplexes Risikomodul.
|
||||
|
||||
|
||||
## Verknüpfungen (Obsidian)
|
||||
|
||||
[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]] · [[R00_Szenarien/R01_Eigene_Webseite|A1 – Eigene Webseite]] · [[R00_Szenarien/R08_Destination_Solutions|A3 – Destination Solutions]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A4 – FeWo-direkt]] · [[00_Portalprofile_und_Vertragsvorlagen|Vertragsprofile]] · [[G00_Gates_und_Uebergaben|Gates]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
|
||||
@@ -0,0 +1,125 @@
|
||||
---
|
||||
id: K00
|
||||
typ: fachliches-konzept
|
||||
titel: Portalprofile, Konditionsquellen und Vertragsvorlagen
|
||||
status: diskussionsentwurf
|
||||
version: "0.9"
|
||||
stand: 2026-11-01
|
||||
prozess: V01
|
||||
bezugsstand_archetypen: "0.6"
|
||||
---
|
||||
|
||||
# K00 – Portalprofile und Vertragsvorlagen
|
||||
|
||||
## 1. Fachliche Leitentscheidung
|
||||
|
||||
FewoPortal ist das führende **interne** Verwaltungs- und Dokumentationssystem für die Buchung. **Jeder externe Kanal kann abweichende eigene Regeln und Fähigkeiten haben**: Preis- und Rabattpflege, Stornobedingungen, Vertragsabschluss, Zahlungsabwicklung, Kommunikation sowie Datenlieferung und -nachweis. Das Verhalten eines konkreten Portals (z. B. FeWo-direkt) wird **nicht** als generelle Logik fest in die Software eingebaut.
|
||||
|
||||
**Bestätigt:** Für unterschiedliche Portale und Buchungstypen müssen **unterschiedliche, versionierte Vertragsvorlagen/-entwürfe und Anlagen** auswählbar sein. Auch verschiedene Buchungsarten desselben Portals können abweichende Dokumente benötigen.
|
||||
|
||||
## 2. Minimaler Portal-/Buchungskontext (fachlich, keine technische Datenmodellvorgabe)
|
||||
|
||||
| Eigenschaft | Bedeutung |
|
||||
|---|---|
|
||||
| Vermieter und Wohnung | Wer vermietet welches Objekt? |
|
||||
| Eingangskanal | Eigene Website, Portalnachricht, E-Mail, iCal, Telefon/manuelle Erfassung usw. |
|
||||
| Portal und ggf. Partnerherkunft | Über welchen Anbieter kam die Buchung, ggf. von welchem Unter-/Partnerportal? |
|
||||
| Art des Eingangs | Unverbindliche Anfrage oder bereits extern verbindliche Direktbuchung? |
|
||||
| Verantwortlichkeiten | Wer erstellt/übermittelt den Vertrag, steuert Zahlung, Mahnungen, Storno, Erstattungen, Gastkommunikation? |
|
||||
| Konditionsquelle | Wo wurden Gastpreis, Rabatte, Zusatzleistungen und Stornoregeln maßgeblich vereinbart? |
|
||||
| Informationsquelle/-status | Welche Werte/Nachweise sind bekannt, unbestätigt oder fehlen? Wann wurden sie erfasst? |
|
||||
| Dokumentenprofil | Welche Vorlage, Bedingungen, Anlagen und Versandschritte gelten für diesen Buchungstyp? |
|
||||
|
||||
**Zuordnung:** Standard des Vermieters/Objekts → spezifischeres Portalprofil → spezifischer Buchungstyp → ggf. tatsächliche Partnerherkunft. Eine **bewusste Einzelfallauswahl** der Vorlage bleibt möglich und wird dokumentiert. Bei unklarer Zuordnung **kein stillschweigender Vertragssende-Automatismus**.
|
||||
|
||||
## 3. Fachliche Dokumentenarten und Auswahl
|
||||
|
||||
| Buchungskonstellation | Dokument und Prozess |
|
||||
|---|---|
|
||||
| A1 / A2, eigener Angebotsabschluss | Eigenes **bindendes Angebot** mit ausgewählten Vertragsbedingungen/Anlagen. Wirksam angenommene Version wird unverändert nachgewiesen; anschließend Vertragsdokument bzw. Bestätigung aus diesem Stand. |
|
||||
| A3 / A4, extern bereits verbindlich, Vertragstext/Unterlagen durch uns | **Kanal- und buchungstypspezifische Vertragsdokumentation** der bereits vereinbarten Bedingungen; **keine zweite obligatorische Annahme**. Widersprechende/neue Klauseln nicht still ergänzen. |
|
||||
| A5, Vertrag/Abwicklung extern | Externen Vertrags- und Konditionsnachweis referenzieren/ablegen, eigene Dokumente nur, wenn erforderlich. Keine doppelte Vertragsbegründung. |
|
||||
| Optional: Partnerherkunft | **Keine eigenständige Hub-/Vermittlungsvariante.** Nur bei kaufmännischer Relevanz (z. B. unterschiedliche Vermittlerprovision) Herkunft erfassen. **A6 bezeichnet inzwischen interne Belegung und Sperren**, nicht Vermittlung. |
|
||||
|
||||
Eine **gemeinsame Konditions-/Vertragszusammenstellung** soll vor dem Versand anzeigen: maßgeblicher Preis, enthaltene/optionale Leistungen, Rabatte, Stornoregel, Gastdaten, gewählte **Vorlage mit Version**, passende **Anlagen**, nachweisbarer Konditionsstand und Dokumentenvorschau. Der Vermieter kann die Auswahl im Rahmen der rechtlich/fachlich zulässigen Regeln korrigieren; keine separaten Portalfomulare.
|
||||
|
||||
## 4. Preis- und Konditionsherkunft
|
||||
|
||||
- **Eigener Angebotsprozess (A1, typischerweise A2):** FewoPortal berechnet das verbindliche Angebot nach den eigenen für den Vorgang geltenden Regeln.
|
||||
- **Extern bereits verbindlich (A3–A5):** Der vom Gast beim Abschluss akzeptierte **Portalpreis und Konditionsstand** muss zugrunde gelegt werden. Eigene Berechnung höchstens als Vergleich, niemals als stiller Ersatz.
|
||||
- Preis, Rabatt, Leistungen, Steuern/Abgaben, Stornoregeln, etwaige Gast-Servicegebühren, Vermieterprovision und Nettoauszahlung **nach tatsächlicher Vertrags- und Gebührenstruktur** unterscheiden; fehlende Angaben als unbekannt markieren.
|
||||
- Konditionen je Portal können aus API, E-Mail, Portalansicht, Dokumenten oder manueller Erfassung stammen. **Herkunft, Erfassungszeitpunkt und ggf. Nachweis** mitführen.
|
||||
- Der zum Abschluss gehörende **Konditions-Snapshot** und die tatsächlich generierten Vertragsdokumente bleiben mit Versionsstand/Prüfsumme unverändert nachvollziehbar.
|
||||
- **Wenn verbindliche Portalbedingungen nicht nachgewiesen werden können, gilt nicht „eigene Standardbedingungen einsetzen“.** Stattdessen Klärungsfall und Prüfung vor Generierung/Versand möglicherweise widersprüchlicher Dokumente.
|
||||
|
||||
## 5. Übergabegates, die daraus folgen
|
||||
|
||||
- **G2 Verbindlichkeit:** Nachweis *wie* die Buchung verbindlich wurde und welche Konditionen zugrunde liegen; Dokumentenversand ist **nicht** gleich Vertragsschluss.
|
||||
- **G3 Abwicklung:** Vertragserstellung und -versand, Zahlung, Storno, Mahnung, Rückerstattung und Kommunikationskanal je Buchung einem Akteur zuordnen. Dokumententwurf und Anlagen müssen zum konkreten Profil passen.
|
||||
- Fehlende Anschrift oder Reisendendaten blockieren nicht rückwirkend die bereits verbindliche Portalbuchung, können aber **eigene Dokumentenerstellung oder lokale Vorbereitung** bis zur Klärung aufhalten.
|
||||
|
||||
## 6. Praxisreferenz FeWo-direkt (A4), keine universelle Regel
|
||||
|
||||
- Der Vermieter pflegt nach eigener Angabe **Mietpreise im Portal-Belegungskalender** sowie **Rabatte und Stornobedingungen** im Portal.
|
||||
- Der vierseitige **eigene Mietvertrag ist im FeWo-direkt-Inserat derzeit nicht hinterlegt** und wird später von uns gesendet.
|
||||
- Der Vermieter kann aktuell nicht verifizieren, welche vollständigen Buchungs-/Vertragsunterlagen der Gast bei Portalabschluss sieht oder erhält. **Unbekannt und rechtlich/operativ zu klären; nicht als nachgewiesene Zustimmung darstellen.**
|
||||
- Zahlung nach aktuellem Ablauf über FeWo-direkt. Vertragsdokumentation und lokale Gästebetreuung bei uns; Storno-/Mahnverantwortung ist noch genauer zu prüfen.
|
||||
- Die heutige FeWo-direkt-Vertragsvorlage ist **ein spezielles Dokumentenprofil**, kein globaler Vertragsstandard.
|
||||
|
||||
Siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 – Analyse der bisherigen FeWo-direkt-Vertragsvorlage]].
|
||||
|
||||
## 7. Bewusste Grenzen / offene Punkte
|
||||
|
||||
1. **Keine juristische Freigabe:** Vorlagen und Stornobedingungen werden nicht durch die Software neu formuliert. Prüfung der tatsächlichen Einbeziehung und Wirksamkeit bleibt erforderlich ([§ 305 BGB](https://www.gesetze-im-internet.de/bgb/__305.html)).
|
||||
2. **Keine Konfigurationshölle:** Es braucht wenige nachvollziehbare Schalter/Zuordnungen und eine manuelle Übersteuerung mit Nachweis, keinen freien Workflow-Designer.
|
||||
3. **Kein vollständiger Portalpreis-Sync als implizite Voraussetzung:** Daten dürfen je Portal auch kontrolliert manuell übernommen werden, solange Quelle und Status nachvollziehbar sind.
|
||||
4. **Noch offen:** Welche konkreten Dokumententypen und Anlagen sollen über Vermieter/Objekt/Portal hinweg wiederverwendbar sein, und welche müssen zwingend getrennt bleiben?
|
||||
|
||||
**Status:** Portalübergreifende Fachregeln aus dem Interview festgehalten; Auswahlregeln sind ein fachlicher Vorschlag zur späteren Validierung, **keine freigegebene technische Implementierung**.
|
||||
|
||||
|
||||
## 8. Erweiterung v0.2 – Flexible Portal- und Preisfunktionen
|
||||
|
||||
**Konfiguration nach tatsächlicher Fähigkeit statt Portalname fest in Programmcode:**
|
||||
|
||||
| Merkmal | Konfigurierbare Ausprägungen / Konsequenz |
|
||||
|---|---|
|
||||
| Eingang/Belegung | iCal/API/E-Mail/Portalansicht/manuell; zeitverzögert, nicht verfügbar oder unbekannt; manuelle Sperraufgabe zulässig |
|
||||
| Gast-/Vertragsdaten | vollständig, teilweise, nicht geliefert; ggf. manuell über Gast oder Portal abrufen |
|
||||
| Vertrag und Preisquelle | eigene verbindliche Angebotsdaten oder extern bestätigter Gastpreis; Gesamtbetrag auch ohne Einzelpreise zulässig |
|
||||
| Preisdetailtiefe | Einzelpositionen, Sammelpositionen, reiner Gesamtpreis; Gebührentyp oder Empfänger kann ungeklärt bleiben |
|
||||
| Preisaufschlag/Provision | Vermieterprovision, zusätzliche Gast-Servicegebühr, partnerkanalabhängiger Endpreisaufschlag – getrennt, sofern belegbar; auch kombinierte/unbekannte Position zulassen |
|
||||
| Zahlungszuständigkeit | Eigener Einzug oder Portal/Paymentanbieter; Ratenstatus, Auszahlungsvorschau und Bankeingang getrennt |
|
||||
| Stornobedingungen | Portalkonfiguration, beim Vertragsschluss nachweislich vereinbarter Stand, später übermitteltes eigenes Dokument trennen |
|
||||
| Bearbeitungsmodus | automatisch / manuell / gemischt, nach einzelner Aktivität bzw. verfügbarem Feld; offene Klärungsaufgabe statt erfundene Daten |
|
||||
| Nachweise | Zeitpunkt der Erfassung, ggf. Screenshot/Buchungsbestätigung, Zeitpunkt und Wirksamkeit einer Kalendersperre soweit nachgewiesen |
|
||||
|
||||
**Keine freie Regel-Engine für MVP erforderlich.** Wenige Profilparameter sowie manuelle, nachvollziehbare Bearbeitungsschritte reichen zunächst. Die tatsächliche Informationstiefe kann **von Buchung zu Buchung** variieren, nicht nur pro Portal.
|
||||
|
||||
### Konkrete Kanalprofile als gesonderte Referenzfälle
|
||||
|
||||
- **FeWo-direkt (A4):** Eigene Miet-/Rabatt-/Stornokonfiguration im Portal; im Vermieterposteingang sind bei einer Buchung einzelne Summen, Zahlungsraten und erwartete Auszahlung ersichtlich, nicht notwendigerweise die Einzelpreiszerlegung. Eigener statischer Mietvertrag bislang nicht im Inserat hinterlegt. Angeblich/öffentlich angebotene Funktionen sind nicht automatisch im konkreten Betreiberkonto vorhanden.
|
||||
- **Destination Solutions (A3):** Extern bereits verbindliche Buchung; danach vollständige Abwicklung beim Vermieter. **In aktuellem Betreiberzugang keine Kalendersynchronisation**; manuelle Portalsperrung mit begrenzter Nachweisbarkeit. Provision kann nach Vertriebskanal differieren; Gast-Serviceaufschlag, Preisaufschläge und vorvertragliche Anzeige der Stornobedingungen sind noch ungeklärt.
|
||||
|
||||
Details: [[K01_Preisstruktur_und_Abrechnung|K01 Preise & Abrechnung]]; [[R00_Szenarien/R08_Destination_Solutions|R08 Destination Solutions]]; [[O00_Offene_Portalprueffaelle|O00 offene Fragen]].
|
||||
|
||||
## 9. Erweiterung v0.9 – Vorgangs- und Angebotsabhängige Vorlagen
|
||||
|
||||
**Dokumentprofil = Vermieter/Objekt + Kanal/Owner + Vorgangstyp/Archetyp + Angebots-/Verbindlichkeitsart**, gegebenenfalls mit bewusster manueller Auswahl. Das Profil bestimmt nicht allein das Dokument, sondern auch die notwendigen Aufgaben und Versandbedingungen. Die bereits vorhandene automatische Zuordnung externer Buchungen zum **Owner-Portal** wird dabei **genutzt**, nicht neu eingeführt.
|
||||
|
||||
| Fall | Geeignete Vorlage | Folgeschritte |
|
||||
|---|---|---|
|
||||
| A1/A2, Hold > 0 | **Verbindliches Angebot** mit passender Annahmefrist, AGB/Anlagen und Annahmelink | Reservierung/externen Sperrabgleich, Annahme prüfen, verbindliche Buchung, Bestätigung |
|
||||
| A1/A2, Hold = 0 | **Preis-/Verfügbarkeitsauskunft unter Vorbehalt**, keine unbedingte Annahmemöglichkeit | Keine Reservierung; bei Buchungswunsch erneut Verfügbarkeit prüfen und explizit bestätigen |
|
||||
| A3/A4/A5 | **Dokumentation/Bestätigung einer bereits extern verbindlichen Buchung**, soweit eigene Unterlagen benötigt werden | Externen Konditionsstand übernehmen; keine zweite Vertragsannahme |
|
||||
| A6 privat/Familie/Freunde | **Buchungs-/Aufenthalts- oder Reservierungsbestätigung** mit konkreten Zusatzleistungen und Kosten, falls vereinbart | Gastdaten optional erfassen, Abgaben/Zusatzleistungen prüfen, ggf. Zahlung steuern |
|
||||
| A6 Wartung/sonstige Sperre | **Interne Bestätigung** oder **kein Dokument** | Kalender sperren, Grund/Aufgaben dokumentieren, bei Ende freigeben |
|
||||
|
||||
**Keine eigenständige Preisbindefrist im MVP.** Normalfall ist jahresbezogene Tarifpflege; die Haltefrist ist ein Konfigurationswert für die Belegungssicherung, nicht eine zusätzliche Preisregel. Eine verbindliche Preiszusage ohne verfügbarkeitsgesicherte Annahme muss in der rechtlich geprüften Vorlage klar vom Vertragsschluss unterschieden werden. **Bereits vereinbarte** individuelle Gast-/Portalpreise bleiben als Snapshot unverändert.
|
||||
|
||||
**Keine unnötige Konfigurationskomplexität:** Wenige feste Dokumenttypen und transparente Zuordnungen, keine freie Workflow-Engine; Vorlagen und ihre Versionen müssen im Einzelfall überprüfbar sein.
|
||||
|
||||
|
||||
## Verknüpfungen (Obsidian)
|
||||
|
||||
[[README|Startseite]] · [[00_Buchungsarchetypen|Archetypen]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02 Vertragsverbindlichkeit]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Vertragsabwicklung]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]] · [[O00_Offene_Portalprueffaelle|Offene Fragen]]
|
||||
@@ -0,0 +1,143 @@
|
||||
---
|
||||
id: MAP-00
|
||||
typ: prozesslandkarte
|
||||
titel: FewoPortal – Prozesslandkarte
|
||||
status: arbeitsstand
|
||||
version: "0.9"
|
||||
---
|
||||
|
||||
# 00 – Prozesslandkarte FewoPortal v0.9
|
||||
|
||||
**Status:** gemeinsamer Arbeitsstand; übergreifendes Modell, nicht vollständig freigegeben.
|
||||
**Stand:** 01.11.2026
|
||||
|
||||
## A. Führungsprinzip
|
||||
|
||||
FewoPortal ist das **führende Verwaltungssystem für den gesamten Buchungsvorgang**: einheitlicher Vorgang, Prozesszustände, Fristen, Aufgaben, Dokumente, Kontakte, Kalender und Ereignisse. Ein angebundenes Portal kann fachliche Schritte übernehmen. FewoPortal hält **Ergebnis, Herkunft/Nachweis, Zuständigkeit und erforderliche Folgeaktivitäten** fest. Für externe Tatsachen (z. B. Portalzahlungen) bleibt das Portal die primäre Informationsquelle.
|
||||
|
||||
Es gibt **einen generischen Buchungsprozess**; je Portal, Eingangsart und ggf. Herkunft sind Auslöser, Aktivitäten, Verantwortlichkeiten, Datenbeschaffung und Ausgänge konfigurierbar. **Keine parallelen Buchungsprozesse und Verwaltungsoberflächen.**
|
||||
|
||||
Ein extern ausgeführter Schritt bedeutet nicht automatisch „übersprungen“; zu unterscheiden sind **intern erledigt / extern erfüllt / fachlich nicht anwendbar / offen bzw. Klärungsbedarf**.
|
||||
|
||||
## A1. Produktmandat und bewusste Abgrenzung (Betreiberentscheidungen E-007 bis E-009)
|
||||
|
||||
- **Heute:** Eigene Internetpräsenz als einheitlicher Einstiegspunkt für die Ferienwohnungen eines Vermieters; mehrere getrennte Vermieter/Mandanten möglich. Typischer Zielkunde vermietet **eine bis maximal etwa drei Wohnungen**.
|
||||
- **Geschäftsziel:** Über eigene Website und externe Kanäle Gäste gewinnen, Buchungen abschließen und deren Abwicklung mit möglichst wenig Betreiberaufwand zentralisieren und automatisieren. **Kein eigener Marktplatz.**
|
||||
- **Produktschwerpunkt:** V01 Buchung/Aufenthalt und V02 Vermarktung, Gästegewinnung und Gästebindung. Dazu zählen auch Social Media, Print, externe Portale, Stammkundenmanagement und Loyalty als fachlich vorgesehene Ausbaubereiche.
|
||||
- **Keine Überdehnung:** Buchungsbezogene Reinigung, Schlüsselübergabe und lokale Leistungen werden möglichst einfach **innerhalb desselben Vorgangs** angestoßen und nachvollzogen. Umfangreiche Objektverwaltung, Personal-/Tourenplanung und Agentur-/Zimmervermittlungsfunktionen sind **nicht Teil der aktuellen Schwerpunktsetzung**.
|
||||
- **Erweiterbarkeit ohne Vorabkomplexität:** Eine spätere SaaS-Erweiterung für größere Vermittler bleibt möglich, bestimmt aber **nicht** heutige Masken, Prozessvarianten oder Modulzuschnitte. Fachliche Prozessfamilien sind **keine automatische Vorgabe** für eigenständige Softwaremodule.
|
||||
- **Bedienprinzip:** Der Vermieter sieht wenige, konkrete Aufgaben im Buchungskontext statt die interne Prozessarchitektur. Fachliche Vollständigkeit im Hintergrund darf nicht zu einer komplexen Bedienoberfläche führen.
|
||||
|
||||
## B. Wertschöpfungsprozesse
|
||||
|
||||
| ID | Wertschöpfungsprozess | Phasen / Zweck |
|
||||
|---|---|---|
|
||||
| **V01** | **Buchung und Aufenthalt** | P01–P05, einschließlich Feedback |
|
||||
| **V02** | **Vermarktung, Gästegewinnung und Gästebindung** | Eigenständiger, V01 vor- und nachgelagerter Wertschöpfungsprozess: Multichannel-Marketing, Interessentengewinnung, CRM, Wiederbuchung, Loyalty (E-001, E-008) |
|
||||
|
||||
### V01 – Generischer Hauptwertschöpfungsprozess
|
||||
|
||||
| Phase | Arbeitsbezeichnung | Fachliches Kernergebnis |
|
||||
|---|---|---|
|
||||
| **P01** | Buchungseingang & Verfügbarkeitssicherung | Anfrage oder verbindliche externe Buchung erkannt; Belegung/Hold korrekt vermerkt; fehlende Eingangsdaten als Aufgaben sichtbar |
|
||||
| **P02** | Konditionen & Buchungsverbindlichkeit | Verbindlichkeit durch fristgerechte Annahme des **von uns bindenden Angebots** oder Nachweis einer schon verbindlichen Portalbuchung; gültige Konditionen revisionsfähig festgehalten |
|
||||
| **P03** | Buchungsverwaltung & kaufmännische Abwicklung | Vertragsdokumente, Zahlungszuständigkeit, Fristen und Verwaltungsaufgaben gesteuert, auch bei extern verantworteten Aktivitäten |
|
||||
| **P04** | Leistungsvorbereitung & Aufenthalt | Informationen und lokale Leistungen bereitgestellt; Anreise, Aufenthalt, Abreise betreut |
|
||||
| **P05** | Abschluss & Nachbereitung | Buchungs- und Leistungserbringung fachlich abgeschlossen; offene, danach eigenständig zu bearbeitende Fälle kontrolliert an Folgeprozesse übergeben; Feedback und objektbezogene Folgeaufgaben; zulässige Übergabe an V02 |
|
||||
|
||||
### V02 – Vermarktung, Gästegewinnung und Gästebindung (fachlich vorgesehen, Details später)
|
||||
|
||||
- **Vor der Buchung:** Reichweite und Interessenten über eigene Website, Social Media, Print und externe Portale gewinnen; Herkunft einer Anfrage/Buchung möglichst nachvollziehbar halten. Externe Portale können dabei **Marketing- und Buchungskanal** zugleich sein.
|
||||
- **Nach der Buchung:** Bestehende Gäste für Wiederbuchung und Loyalty berücksichtigen; zulässige CRM-/Marketingaktivitäten und passende Angebote ermöglichen. Loyalty-Merkmale können als Eingabe für die Konditionsbildung in P02 dienen.
|
||||
- **Schnittstelle:** V02 kann Nachfrage/Anfragen an V01 übergeben; P05 bleibt für **Dank, Feedback und Bewertungsabwicklung** zuständig und kann bei zulässiger Grundlage Ereignisse an V02 melden.
|
||||
- **Priorisierung:** Fachlich vorsehen, aber jetzt nicht die detaillierte Kampagnenverwaltung oder einen eigenständigen Marketing-Funktionskomplex implementieren.
|
||||
|
||||
**Die Phasen sind logische Gruppierungen, keine zwingend exklusiven Zeitfenster.** Zahlungen/Fristen laufen u. U. über P03 hinaus, Datenbeschaffung kann nach der verbindlichen Buchung weiterlaufen. Kern-Gates beschreiben nachweisbare Zustände; Detail-Gates beschreiben Voraussetzungen für konkrete Tätigkeiten.
|
||||
|
||||
## C. Eingangspfade und Verbindlichkeit (fachlich vom Betreiber präzisiert)
|
||||
|
||||
| Pfad | Entstehung der Verbindlichkeit | Preis/Konditionen | Vertrag und Verwaltung |
|
||||
|---|---|---|---|
|
||||
| Eigene Website / manuell / unverbindliche Portalanfrage | Wir geben **ein für uns verbindliches, befristetes Angebot** ab; die rechtzeitige Annahme durch den Gast führt zum Vertrag | Eigene Preisermittlung mit Sonderleistungen, Saison/Rabatten/Loyalty; versionierter Konditionsstand | FewoPortal erstellt Angebot, Annahmenachweis und Vertragsunterlagen; danach eigene Verwaltung |
|
||||
| Verbindliche Portal-Direktbuchung, Vertrag durch uns | **Bereits beim Portal verbindlich**; **keine zweite Annahme** bei uns | **Im Portal vereinbarter Preis zwingend als Buchungspreis übernehmen**; unsere Berechnung darf ihn nicht still ersetzen | Wir erzeugen/übermitteln das Dokument zur bestehenden Buchung; etwaige Zusatzpflichten nicht nachträglich einseitig hinzufügen; Zahlungszuständigkeit nach Profil |
|
||||
| Verbindliche Portal-Direktbuchung, vollständige Abwicklung durch Portal | **Bereits beim Portal verbindlich** | Externe Konditionen als maßgeblich kennzeichnen, soweit für lokale Ausführung nötig | Portal verantwortet z. B. Vertrag, Zahlung, Mahnung, Storno; FewoPortal verwaltet notwendige Gästeinfos, lokale Betreuung, Abgaben und relevante externe Status/Ereignisse |
|
||||
|
||||
Bei **eigenem Angebot**: Konfigurierbare Annahmefrist; wir bleiben im beschriebenen Zeitraum gebunden. Rechtzeitige Annahme beendet das Angebot mit dem Ergebnis „verbindlich gebucht“; ohne rechtzeitige Annahme erlischt das Angebot und die **eigene** Vorreservierung wird nur nach Konfliktprüfung freigegeben. Ein extern bereits bestätigter Aufenthalt wird dadurch nicht gelöscht. Angebote und Nachweise bleiben historisch erhalten.
|
||||
|
||||
Vertraglicher Nachweis und ggf. PDF-Übermittlung dürfen rechtliche Verbindlichkeit **nicht neu definieren**: Eine bereits verbindliche Portalbuchung bleibt verbindlich; ihr Preis und ihre maßgeblichen Bedingungen müssen gewahrt bleiben. Die rechtlichen Anforderungen der jeweiligen Konstellation sind separat zu prüfen.
|
||||
|
||||
## D. Wiederverwendbare Supportprozessfamilien (vorläufig)
|
||||
|
||||
Diese Familien dienen der **fachlichen Vollständigkeit**. Sie werden in der aktuellen kleinen Vermieterplattform in erster Linie als **integrierte Funktionen und Aktivitäten** von V01/V02 realisiert. Eine eigenständige Verwaltungsoberfläche ist weder aus dem Namen noch aus der Dokumentation abzuleiten. Buchungsunabhängige Objekt- und Agenturverwaltung sind nachrangige mögliche Erweiterungen.
|
||||
|
||||
- S01: Portal-, Kanal- und Integrationsmanagement
|
||||
- S02: Verfügbarkeit, Belegung, Kalenderabgleich und Synchronisationskontrolle
|
||||
- S03: Gast-, Objekt- und weitere Stammdaten
|
||||
- S04: Preis-, Leistungs-, Rabatt- und Konditionsmanagement
|
||||
- S05: Dokumenten-, Vorlagen- und Nachweismanagement
|
||||
- S06: Kommunikation, Aufgaben, Fristen und Eskalation
|
||||
- S07: Zahlungen, Forderungen und Portalstatus-Abgleich
|
||||
- S08: Buchungsbezogene Objekt- und Dienstleisterleistungen (Schlüssel, Reinigung, Vorbereitung, Reparatur) **integriert in P04/P05**; umfangreiches eigenständiges Objektmanagement derzeit **nicht priorisiert**
|
||||
- S09: Mandanten, Berechtigungen, Compliance und Sicherheit
|
||||
|
||||
## E. Wiederverwendbare Sonderprozessfamilien (vorläufig)
|
||||
|
||||
- X01: Angebotsänderung und Neuangebot
|
||||
- X02: Vertragsänderung, Umbuchung und Zusatzleistungen nach Vertragsschluss
|
||||
- X03: Ablehnung, Angebotsablauf, Holdablauf und Freigabe
|
||||
- X04: Stornierung/Rücktritt durch Gast, Portal oder Vermieter
|
||||
- X05: Zahlungsverzug, Mahnung, Erstattung, Streitfall
|
||||
- X06: Widersprüchliche/unvollständige Daten und Dubletten
|
||||
- X07: Doppelbuchung, Kalenderkonflikt, Portal-/Importfehler
|
||||
- X08: No-show, vorzeitige Abreise, Verlängerung
|
||||
- X09: Reklamation, Schaden, Kaution und Nachforderung
|
||||
|
||||
Ein Sonderprozess kann mehrere Phasen betreffen und verwendet denselben Vorgang und dieselbe Ereignishistorie. **Nach abgeschlossenem Buchungs- und Leistungsprozess** können noch offene Ansprüche oder Konflikte als eigenständig zu bearbeitende Folgeprozesse weitergeführt werden; die Referenz auf die ursprüngliche Buchung und der Übergabenachweis bleiben erhalten (E-010).
|
||||
|
||||
**Alternative fachliche Endergebnisse V01 (E-011):** Ein regulär erfüllter Aufenthalt, eine ohne Buchung beendete Anbahnung (z. B. Angebotsablauf oder Ablehnung) und die Stornierung nach entstandener Verbindlichkeit sind unterschiedliche Ergebnisse **desselben** generischen Prozesses. Eine reguläre Leistungserbringung durchläuft typischerweise P05; ein früher Abbruch muss nicht künstlich P03–P05 durchlaufen. Auslösende Ereignisse, Nachweise, ggf. Belegungsfreigabe und verbleibende Folgepflichten werden nachvollziehbar dokumentiert. Weitere Endergebnisse sowie exakte Übergangsbedingungen sind offen.
|
||||
|
||||
## F. Zentrale Gate-Philosophie
|
||||
|
||||
**P05-Abschluss-/Übergabegate (E-010):** Abschluss der Buchungs- und Leistungserbringung ist vom Ende nachlaufender Forderungs-, Schadens- oder Streitfälle zu unterscheiden. Offene Fälle werden mit Kontext, Verantwortlichkeit und Referenz zur Buchung an den jeweils zuständigen Folgeprozess übergeben. Die endgültigen Pflichtkriterien und Zustände werden in P05 spezifiziert.
|
||||
|
||||
Gates dokumentieren **Trigger, erwartetes Ergebnis, erforderliche Daten, Herkunft/Nachweis, zuständige Stelle, Ergebnisstatus, Folgeschritt**. Pflichtinformationen sind **aktivitätsbezogen**, nicht für alle Portale pauschal identisch. Fehlende Adressdaten dürfen eine durch Portalnachweis verbindliche Buchung nicht entwerten; sie blockieren nur Tätigkeiten, für die sie wirklich erforderlich sind.
|
||||
|
||||
## G. Noch zu entscheiden
|
||||
|
||||
1. **Detailkriterien für den fachlichen Abschluss von V01:** Welche Leistungen, Informationen und Übergaben müssen konkret abgeschlossen sein? Die Grundentscheidung ist getroffen: Nachlaufende Forderungen/Schäden blockieren nicht allein den Abschluss der Buchungs- und Leistungserbringung, wenn sie nachvollziehbar an einen verantwortlichen Folgeprozess übergeben wurden (E-010).
|
||||
2. Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; **keine Entscheidung für ein eigenständiges Objektmanagement-Modul**.
|
||||
3. Genauer Status- und Gate-Katalog, **einschließlich alternativer Prozessausgänge nach E-011**, Synchronisationssicherheit und externer Stornoereignisse.
|
||||
4. Abgrenzung P03/P04; Relevanz und Nachweisbarkeit der lokalen Prozesse.
|
||||
5. Pro Kanal tatsächlicher Verbindlichkeitsnachweis, Datenlage und Portalbestimmungen.
|
||||
|
||||
Die detaillierte Umsetzung erfolgt erst nach Abstimmung der Prozesslandkarte.
|
||||
|
||||
|
||||
## H. Konkretisierung v0.7: Portalneutralität, Informationslücken und Verantwortlichkeit
|
||||
|
||||
**A1–A5 (E-012, historischer Stand):** Buchungs- und Abwicklungsverantwortung klassifizieren die Vermietungsarchetypen. Der **damalige A6 für Partnervermittlung** entfiel; Herkunft/Partnervertrieb bleibt lediglich eine kaufmännische Metainformation. **Aktuelle Fortschreibung E-022:** Zusätzlich gilt **A6 = Eigenbelegung, private Überlassung und sonstige Sperren**, im gemeinsamen Vorgang mit bedarfsabhängig verkürzten Aktivitäten. Referenzfälle: **FeWo-direkt A4**, **Destination Solutions A3**. Der identische V01-Prozess durchläuft dieselben fachlichen Phasen/Gates, Aktivitäten können je Profil extern/intern oder manuell/automatisch erfolgen.
|
||||
|
||||
**Fünf unabhängige Dimensionen je Buchung:** (1) rechtlicher Bindungs-/Konditionsnachweis, (2) operative Zuständigkeit, (3) technische Datenquelle/Übermittlungsweg und Verfügbarkeit, (4) preisliche Detailtiefe bzw. Zuordnungsgrad, (5) tatsächliche Nachweisqualität. Aus „Portal zuständig“ folgt weder „erledigt“ noch „nachgewiesen“.
|
||||
|
||||
**Kaufmännischer Grundsatz (E-014/E-015):** Das Portal kann Einzelposten, Teilaggregationen, Gesamtpreise, unbekannte Gebührenmischungen oder widersprüchliche Auszahlungsansichten liefern. FewoPortal darf den verbindlichen Gastpreis bei externer Buchung nicht durch Eigenkalkulation ersetzen, keine unbekannten Einzelposten erfinden und keine Vermittlerprovision ohne Vereinbarung dem Gast nachberechnen. Eine manuelle Klärung kann ergänzen; ursprüngliche Rohdaten bleiben erhalten.
|
||||
|
||||
**Verfügbarkeit (E-018):** Keine generelle Aussage, dass alle Vertriebskanäle synchron oder endgültig gesperrt sind. Manuell oder zeitversetzt übertragenes Blockieren ist kein Nachweis partnernetzweiter Wirksamkeit. Sofort bestätigte externe Doppelbuchungen bleiben wirksame **Konfliktfälle**, nicht automatisch ablehnbare Anfragen. Eine vorgeschlagene Livefreigabe/10-Minuten-Karenz ist derzeit nur **optionales Zukunfts-/Integrationskonzept**, kein Ist-Ablauf.
|
||||
|
||||
**Nachträgliche Ereignisse (E-019):** Änderungsanfrage, bestätigte Änderung, Stornierungswunsch und wirksame Stornierung unterscheiden. Ursache, Durchführender, vertragliche Folgen, Belegung und Geldflüsse getrennt dokumentieren.
|
||||
|
||||
**Zu vertiefen:** [[K01_Preisstruktur_und_Abrechnung|K01 Preis- und Abrechnungsmodell]], [[X01_Belegungskonflikte_und_Sperrnachweise|X01 Belegungskonflikt- und Sperrnachweise]], [[O00_Offene_Portalprueffaelle|O00 offene Portalfragen]].
|
||||
|
||||
## I. Fachliche Konsolidierung 01.11.2026: Vorgang und A6 (E-022–E-028)
|
||||
|
||||
**V01** ist der gemeinsame fachliche Wertschöpfungs-/Bearbeitungsrahmen für **A1–A6**. **Vorgang** bedeutet die durchgehende Bearbeitung ab qualifiziertem Anlass – Anfrage, bindende externe Buchung oder interner Belegungs-/Sperrwunsch – bis zum passenden Ende. Ein zusätzlicher Schritt „Buchungsakte anlegen“ entfällt. Die bereits implementierte Owner-Zuordnung bei externen Buchungen bleibt bestehen. **Belegung** (Objekt, Zeitraum, Sperr-/Reservierungswirkung) ist mit dem Vorgang verknüpft, aber nicht gleichbedeutend mit dem ganzen Vorgang.
|
||||
|
||||
**A6** bündelt Eigenbelegung, Familien-/Freundesaufenthalt und Wartungs-/sonstige Sperren. Es nutzt je nach konkretem Anlass die allgemeinen Aktivitäten von P01–P05; nicht benötigte Vertrags-, Gästekommunikations-, Zahlungs- oder Aufenthaltsaktivitäten sind **nicht anwendbar**. Private Überlassung kann dagegen Gastdaten, Kurabgabe, Wäschepakete, Zahlung und eine passende Bestätigung benötigen. Ein Hold für ein A1/A2-Angebot bleibt **Teil dieses Vermietungsvorgangs**, kein zweiter A6.
|
||||
|
||||
**Angebot (A1/A2):** Haltefrist pro Anfragekanal konfigurierbar. Hold > 0 ermöglicht bei passender Sicherung und Frist ein bindendes Angebot; Hold = 0 führt zu einer Preis-/Verfügbarkeitsauskunft ohne reservierte Wohnung, mit erneuter Prüfung vor verbindlicher Bestätigung. Die Auswahl von **Dokumentenvorlage, Versand und Folgeaktivitäten erfolgt automatisch nach Kanal und Vorgangstyp**; eine separate Preisbindefrist/Yield-Management ist kein MVP-Standard. Jährliche Tarifpflege und tatsächlicher vertraglicher Buchungspreis bleiben voneinander getrennt.
|
||||
|
||||
**Implementierungsgrenze:** Die derzeitige Konzeption ist keine vollständige Coding-Freigabe; zuerst Bestands-/Gap-Analyse gegen die vorhandene Anwendung, anschließend begrenzte Arbeitsaufträge.
|
||||
|
||||
|
||||
## Verknüpfungen (Obsidian)
|
||||
|
||||
[[README|Startseite]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01 Buchungseingang]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02 Konditionen und Bindung]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Verwaltung und Abwicklung]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04 Aufenthalt]] · [[P05/P05_Abschluss_und_Nachbereitung|P05 Abschluss]] · [[G00_Gates_und_Uebergaben|Gates]] · [[S00_Supportprozesse|Supportprozesse]] · [[X00_Sonderprozesse|Sonderprozesse]] · [[00_Buchungsarchetypen|Archetypen]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
|
||||
@@ -0,0 +1,174 @@
|
||||
---
|
||||
id: A04-DOK-01
|
||||
typ: prozessanalyse
|
||||
titel: FeWo-direkt – Vertragsvorlage und Einordnung in den A4-Istprozess
|
||||
status: diskussionsentwurf
|
||||
version: "0.6"
|
||||
stand: 2026-10-31
|
||||
prozess: V01
|
||||
archetyp: A4
|
||||
quellen:
|
||||
- "Vorlage MV für fewo-direkt.pdf (4 Seiten, Betreiber)"
|
||||
- "Betreiberbeschreibung: manueller A4-Istprozess, 31.10.2026"
|
||||
---
|
||||
|
||||
# A4 – Vertragsvorlage und Prozessanalyse
|
||||
|
||||
> **Arbeitsdokument, keine Freigabe zur Änderung rechtlicher Klauseln.** Die Vertragsvorlage ist ein Beispiel für den aktuellen Ablauf, kein Nachweis der beim Buchungsabschluss über FeWo-direkt tatsächlich akzeptierten Konditionen. **Zugangscodes, Passwörter, persönliche Kontaktdaten und Namen von Gästen werden hier bewusst nicht reproduziert.**
|
||||
|
||||
## 1. Einordnung in den dokumentierten Istprozess
|
||||
|
||||
1. FeWo-direkt bestätigt extern eine verbindliche Buchung und sendet eine E-Mail mit Gastname und Zeitraum.
|
||||
2. Der Vermieter sperrt andere Belegungskalender manuell.
|
||||
3. Im FeWo-direkt-Vermieterbereich werden verfügbare Gastkontakte und Buchungs-/Preisdaten ermittelt.
|
||||
4. Fehlende Angaben aller tatsächlich erforderlichen Reisenden werden per Gastkontakt angefordert.
|
||||
5. Der Vermieter erstellt einen individuellen Mietvertrag anhand der vierseitigen Vorlage und versendet ihn mit der Internetvereinbarung.
|
||||
6. FeWo-direkt fordert Anzahlung und Restzahlung an und verarbeitet diese. **Korrektur durch Screenshots vom 31.10.2026:** In der einzelnen Buchungs-Kommunikation ist ein Zahlungsplan mit Raten, Fälligkeiten und Zahlungsmarkierung sichtbar; die vollständige Zahlungs-, Gebühren- und Auszahlungstransparenz bleibt unbewiesen.
|
||||
7. FeWo-direkt versendet ca. 72 Stunden vor Check-in eine Gastinformation (Betreiberangabe).
|
||||
8. Vermieter informiert lokale Dienstleister (Schlüssel, Reinigung, Gästebetreuung).
|
||||
9. Stornierungen werden nach aktueller Praxis über FeWo-direkt abgewickelt; konkrete Verantwortlichkeiten und Statusübermittlung sind noch zu prüfen.
|
||||
|
||||
### Nachtrag: vom Betreiber bestätigte Portalpraxis (31.10.2026)
|
||||
|
||||
- **Der eigene vierseitige Mietvertrag ist nicht im FeWo-direkt-Inserat hinterlegt.** Gäste erhalten ihn erst im nachgelagerten eigenen Versand, soweit der derzeitige Ablauf beschrieben ist.
|
||||
- Der Betreiber **kann derzeit nicht einsehen**, welche Buchungs-/Vertragsunterlagen FeWo-direkt dem Gast im konkreten Abschluss zusendet. Deshalb ist **nicht nachgewiesen**, welche Klauseln der Gast wann erhält und akzeptiert.
|
||||
- **Mietpreise müssen nach bisheriger Praxis im FeWo-direkt-Kalender gepflegt werden**; Rabatte und Stornobedingungen werden ebenfalls im Portal verwaltet. Der bei Buchung vereinbarte Portalkonditionsstand ist für diese Buchung maßgeblich und darf nicht durch unsere eigene Kalkulation ersetzt werden.
|
||||
- Dies ist ein **konkretes Kanalprofil A4**, **keine allgemeine Regel** für andere Portale. Andere Kanäle können Preise, Konditionen, Vertrag und Abwicklung anders verteilen.
|
||||
- **Die Vertragsvorlage wird passend zu Portal, tatsächlichem Buchungstyp und ggf. Herkunft ausgewählt**. Andere Portale können eigene Vorlagen und Anlagen erfordern; bestehende Vertragsdokumente werden versioniert.
|
||||
|
||||
## 2. Was die vierseitige Vorlage derzeit enthält
|
||||
|
||||
| Textabschnitt | Inhalt | Prozesszuordnung |
|
||||
|---|---|---|
|
||||
| Präambel, § 1–2 | Vertragsparteien, konkrete Ferienwohnung, Zeitraum, An-/Abreisezeiten | P02/P04 |
|
||||
| § 2–3 | Schlüsselübergabe durch lokalen Dienstleister, Kurabgabe/Anmeldung | P04 |
|
||||
| § 4 | Mietsumme einschließlich verschiedener Kosten; Portal-Servicegebühr; Anzahlung/Restzahlung | P02/P03 |
|
||||
| § 5 | 'Annahme' des Vertrages durch Anzahlung; Sorgfalt/Schäden | P02 / Sonderfall |
|
||||
| § 6–9 | Wäsche, Sauna, Schlüssel, Hausordnung | P04 |
|
||||
| § 10–12 | Sorgfalt, Beanstandungen, Rauchverbot, Internet und Internetvereinbarung | P02/P04 |
|
||||
| § 13 | Rücktritt: 60+ Tage 0 %, 59–30 Tage 50 %, ab 29 Tage 100 % des Mietpreises; Ersatzmieterregelung | Sonderprozess Stornierung |
|
||||
| § 14 | Abreise- und Reinigungsanforderungen | P04/P05 |
|
||||
| § 15–18 | Gerichtsstand, Form, Datenschutz, salvatorische Klausel | Recht/Compliance |
|
||||
| Anlage Seite 4 | Internetnutzung, WLAN-Zugang, Gerätehinweise | Gästeinformation/Sicherheitsdaten |
|
||||
|
||||
## 3. Wesentliche Befunde und Prüfaufträge
|
||||
|
||||
**F-01 – Verbindlichkeit (§ 5), hohe Priorität.** Die Klausel setzt 'Annahme des Vertrages' mit einer bereits gezahlten Anzahlung in Zusammenhang. Nach der fachlich angenommenen A4-Logik besteht die bindende Portalbuchung aber **vor** unserem späteren Dokumentenversand. Es ist zu prüfen, was vor Vertragsschluss auf FeWo-direkt bereitgestellt wurde. Ein nachgeschicktes PDF darf neue Bedingungen nicht stillschweigend zur bisherigen Buchung hinzufügen. **Fachliches Soll:** Trennung zwischen Nachweis der externen Buchung und nachgelagerter Übermittlung bestehender Bedingungen.
|
||||
|
||||
**F-02 – Vollständige Konditionen vor Buchung, hohe Priorität.** Der bisherige Ablauf lässt offen, ob Hausordnung, Internetanlage, Stornoregel, Zusatzleistungen und weitere Bedingungen vor dem FeWo-direkt-Klick einsehbar waren. Die offiziellen Vermieter-AGB verlangen die Offenlegung der jeweiligen Konditionen und erlauben Zusatzvereinbarungen nur im Einklang mit den zuvor veröffentlichten Informationen. **Bestätigter Ist-Zustand:** Die PDF-Vorlage ist nicht im Inserat hinterlegt. **Offen:** Welche Vertragsbedingungen und Unterlagen FeWo-direkt im konkreten Abschluss anzeigt oder übersendet, kann der Betreiber derzeit nicht nachvollziehen. Ob eine Hinterlegung sinnvoll ist, bleibt eine optionale Maßnahme, keine allgemeine Systemvorgabe. Die konkret angezeigten Bedingungen sind gesondert zu ermitteln.
|
||||
|
||||
**F-03 – Preisstruktur (§ 4), hohe Priorität.** Das Dokument nennt Gesamtbetrag, Endreinigung, Betreuung, Servicegebühr des Portals, Anzahlung und Restzahlung in einem Text. Erforderlich sind fachlich getrennte Werte: vom Gast verbindlich vereinbarte Gesamtkonditionen, darin enthaltene Unterkunfts-/Leistungsentgelte, ggf. separate Reisenden-Servicegebühr des Portals, Vermieterprovision, Auszahlungsbetrag und Zahlungsstatus. **Keine zusätzlichen Beträge durch FewoPortal erheben, die nicht Bestandteil der Vereinbarung sind.** Konkrete Gebührenstruktur im Vermieter-/Gastbeleg gegenprüfen.
|
||||
|
||||
**F-04 – Storno (§ 13), hohe Priorität.** Die Vorlage enthält die oben genannten Staffeln. Nicht belegt ist, ob exakt diese Staffel für die konkrete FeWo-direkt-Buchung vor Abschluss angezeigt und vereinbart wurde. Der Gast kann laut FeWo-direkt über sein Konto stornieren; Erstattungen richten sich nach der anwendbaren Richtlinie. Der Vermieter darf daher aus der nachträglich versandten Vorlage keine abweichenden Gebühren ableiten. Vermieterseitige Stornierungen sind zusätzlich durch FeWo-direkt-Sanktionsregeln besonders riskant.
|
||||
|
||||
**F-05 – Gast- und Meldedaten (§ 3), mittlere Priorität.** Der Vertrag sieht die örtliche Anmeldung durch einen Dienstleister und die Kurabgabe vor. Welche Felder für wen und zu welchem Zeitpunkt rechtlich erforderlich sind, muss anhand der kommunalen Vorgaben gesondert definiert werden. Die im Vertrag genannten Tarife und Altersgrenzen stimmen mit der derzeit öffentlich ausgewiesenen Kühlungsborner Information überein, sollten aber nicht dauerhaft als fixe Vertragskonstanten im Produkt behandelt werden.
|
||||
|
||||
**F-06 – Rechtlich prüfbedürftige Vertragsklauseln, hohe Priorität.** Besonders § 10–11 (pauschale Einschränkungen von Mietminderung/Beanstandungen), § 15 (vorgegebener Gerichtsstand Dortmund für private Gäste), § 16 (Schriftform/E-Mail), § 17 (Datenverwendung/Übermittlung an Dienstleister) und die Formulierung zur maschinellen Unterschrift sind juristisch zu prüfen. Die Wirksamkeit ist nicht allein aus dieser Analyse abschließend zu beurteilen.
|
||||
|
||||
**F-07 – Zugangsdaten und Anlagen, hohe Priorität.** Seite 2 und 4 enthalten feste Zutritts-/WLAN-Daten. Diese sollten nicht dauerhaft Bestandteil der allgemeinen, archivierten Vertragsvorlage sein. Empfehlung: separate, gezielt zur Anreise freigegebene Gästeinformation. Bereits offengelegte Zugangsdaten kontrollieren/ggf. wechseln. Eine separate Internet-Nutzungsvereinbarung ist fachlich eine versionierte Anlage, muss aber in ihrem rechtlichen Status geklärt sein.
|
||||
|
||||
**F-08 – Unterschiedliche Dokumentzwecke, mittlere Priorität.** Vertrags-/Konditionsnachweis, ortsbezogene Aufenthaltshinweise und sensible Zugriffsinformationen nicht zwingend in einem vierseitigen 'Mietvertrag' bündeln. Ziel: **ein gemeinsames, einfaches FewoPortal-Dokumentenmanagement** mit richtigem Zeitpunkt der Bereitstellung, kein neues eigenständiges Buchungsformular.
|
||||
|
||||
**F-09 – Datenqualität, mittlere Priorität.** Die konkrete Vorlage enthält variable, noch unbesetzte Felder (z. B. Reisende, Daten, Preis, Nächte). Beim Dokumenterstellen müssen Vollständigkeit, Übereinstimmung mit der Portalbuchung und Version der gültigen Anlagen geprüft werden; bei einem Konflikt wird der Versand gesperrt bzw. eine Klärung ausgelöst.
|
||||
|
||||
## 4. Soll-Funktionsbild für A4 (noch nicht beschlossen)
|
||||
|
||||
**Bindungsnachweis aus FeWo-direkt** → **Portalpreis und bei Buchung vereinbarte Konditionen übernehmen** → **Gastdaten gezielt nachfordern** → **Dokumente aus verifiziertem Konditionsstand erstellen und ohne zweite Annahme übermitteln** → **Portalzahlungen/Storno extern verfolgen, ohne Zahlungen zu erfinden** → **separate Anreiseinformationen und Dienstleisteraufgaben auslösen**.
|
||||
|
||||
Bei einer Abweichung zwischen dem vom Gast akzeptierten Konditionsstand und dem späteren Dokument **nicht automatisch ein abweichendes Vertragsdokument verschicken**, sondern in FewoPortal einen Klärungsfall eröffnen.
|
||||
|
||||
## 5. Noch offene fachliche Klärung
|
||||
|
||||
**Welche Konditionen sieht und bestätigt der Gast bei einer konkreten FeWo-direkt-Direktbuchung und welche Dokumente erhält er anschließend tatsächlich vom Portal?**
|
||||
|
||||
Der nachträgliche eigene Mietvertrag ist **nicht** vorab hinterlegt. Ein extern zu prüfender Beispielbuchungsablauf bzw. belegbarer Buchungsauszug soll die tatsächlichen Konditionen und Dokumente identifizieren; die Buchung bleibt schon vor unserer Datennachforderung verbindlich, soweit der Portalabschluss dies belegt. Auf Basis dieser Feststellung wird je Kanal die passende **versionierte eigene Vertrags-/Dokumentenvorlage** zugeordnet. Siehe [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile und Vertragsvorlagen]].
|
||||
|
||||
## 6. Öffentliche Quellen für die juristisch-technischen Prüfpunkte
|
||||
|
||||
- [FeWo-direkt – AGB für Vermieter (29.10.2026), insb. Nr. 2.2–2.3](https://www.fewo-direkt.de/lp/b/partner-terms-of-use)
|
||||
- [FeWo-direkt – Hochladen Ihres Mietvertrags](https://hilfe.fewo-direkt.de/articles/Wie-kann-ich-meinen-Mietvertrag-hochladen)
|
||||
- [FeWo-direkt – Stornierungen durch Gäste](https://hilfe.fewo-direkt.de/articles/Kann-ein-Urlauber-eine-Reservierung-stornieren)
|
||||
- [FeWo-direkt – Richtlinie für Gastgeberstornierungen](https://www.fewo-direkt.de/tlp/trust-and-safety/partner-initiated-cancellation-policy)
|
||||
- [§ 305 BGB – Einbeziehung von AGB](https://www.gesetze-im-internet.de/bgb/__305.html)
|
||||
- [§ 307 BGB – Inhaltskontrolle](https://www.gesetze-im-internet.de/bgb/__307.html)
|
||||
- [§ 309 Nr. 5 BGB – Pauschalierter Schadensersatz](https://www.gesetze-im-internet.de/bgb/__309.html)
|
||||
- [§ 536 BGB – Mietminderung](https://www.gesetze-im-internet.de/bgb/__536.html)
|
||||
- [§ 38 ZPO – Gerichtsstandsvereinbarung](https://www.gesetze-im-internet.de/zpo/__38.html)
|
||||
- [§ 126 BGB – Schriftform](https://www.gesetze-im-internet.de/bgb/__126.html), [§ 127 BGB – Vereinbarte Form](https://www.gesetze-im-internet.de/bgb/__127.html)
|
||||
- [Kühlungsborn – Kurabgabe](https://www.kuehlungsborn.de/kurabgabe/)
|
||||
|
||||
**Abgrenzung:** Dies ist eine fachliche Prozess- und Risikoprüfung, keine rechtliche Freigabe und keine eigenmächtige Überarbeitung der Betreiber-Vertragstexte.
|
||||
|
||||
## 7. Nachtrag aus belegten Bildschirmansichten (31.10.2026) – Ist-Zustand, nicht allgemeines Portalverhalten
|
||||
|
||||
**Quelle:** Vier Screenshots aus dem FeWo-direkt-Vermieterbereich zu einer konkreten, erst im Juli 2027 stattfindenden Buchung. Gastname, Buchungsreferenz und Unterkunfts-ID werden aus Datenschutzgründen hier nicht reproduziert. Die Screenshots belegen die Anzeige in dieser Buchung, nicht automatisch die generelle Exportierbarkeit oder die vertragsrechtliche Richtigkeit.
|
||||
|
||||
### 7.1 Nachgewiesene Buchungs- und Zahlungsinformationen
|
||||
|
||||
| Datenpunkt | In der konkreten Buchung sichtbar | Bedeutung / Grenze |
|
||||
|---|---|---|
|
||||
| Zeitraum und Gäste | 10.–17.07.2027, sieben Nächte, zwei Erwachsene | Belegungssachverhalt, keine vollständigen Gaststammdaten |
|
||||
| Übernachtungspreis | 840,00 € über sieben Nächte | Aggregierter Betrag, keine einzelnen Tagespreise |
|
||||
| Rabatt | −42,00 € | Rabattbetrag bekannt, Berechnungs-/Aktionsregel nicht belegt |
|
||||
| Gebühren und Steuern | 181,51 € | Als Summe ausgewiesen, Einzelbestandteile nicht nachgewiesen |
|
||||
| Gesamtzahlung des Gastes | 979,51 € | Rechnerisch 840 − 42 + 181,51; kann gastseitige Gebühren enthalten |
|
||||
| An FeWo-direkt gezahlt | −84,82 € | So beschriftet; genaue Gebührenart/Zuordnung nicht belegt |
|
||||
| Ausgewiesene Gesamtauszahlung | 894,69 € | Rechnerisch 979,51 − 84,82 |
|
||||
| Andere Buchungsübersicht | **900,20 € voraussichtliche Auszahlung** | **Abweichung von 5,51 €** zur Zahlungsübersicht; ungeklärt, nicht als korrekt/fehlerhaft einstufen |
|
||||
| Rate 1 von 2 | 390,61 €, als bezahlt am 01.10.2026 markiert | Nachweis eines Portal-Zahlungsstatus, **kein Bank-Auszahlungsnachweis** |
|
||||
| Rate 2 von 2 | 588,90 €, fällig am 12.06.2027 | In Screenshot nicht als bezahlt ausgewiesen; beide Raten zusammen ergeben 979,51 € |
|
||||
| Voraussichtliche Vermieterauszahlung | 11.07.2027 angekündigt | Geplantes Ereignis, nicht als tatsächlich ausgeführt nachgewiesen |
|
||||
| Stornoübersicht | 100 % Erstattung bei mehr als 60 Tagen; 50 % bei mehr als 30 Tagen; keine Erstattung bei weniger als 30 Tagen | Angezeigte Portalbedingungen; Grenzfall bei exakt 60/30 Tagen und rechtliche Einbeziehung separat prüfen |
|
||||
| Zugangsinformationen | Portal kündigt Gäste-E-Mail 72 Stunden vor Check-in an, zeigt Schlüsselabholart und Vorschautext | Angekündigter Portalversand, **kein Versand-/Empfangsnachweis** |
|
||||
|
||||
**Korrektur früherer Aussage:** Nicht „keine Zahlungsinformationen zugänglich“, sondern **teilweise buchungsbezogene Zahlungsinformationen in der Kommunikationsansicht zugänglich**. Der Betreiber berichtete weiterhin über fehlenden brauchbaren allgemeinen Export/Zahlungsverlauf und fehlende vollständige Einzelpreis-/Gebührenaufschlüsselung. Dies bleibt als Beobachtung bestehen, sofern nicht durch andere Ansichten widerlegt.
|
||||
|
||||
### 7.2 Auswirkungen auf den generischen Prozess
|
||||
|
||||
- **P02/G2 – Konditionen:** Gesamtpreis, Rabatt, angezeigte Gebühren, Stornoregel und Quelle getrennt mit Nachweis speichern; unbekannte Einzelpreise oder Gebührenarten **nicht rekonstruieren oder schätzen**.
|
||||
- **P03/G3 – Zahlungen:** Separate Zustände für *Rate fällig*, *Rate laut Portal bezahlt*, *Vermieterauszahlung erwartet* und *Vermieterauszahlung tatsächlich eingegangen*. Die Markierung „bezahlt“ ist **kein Nachweis der Auszahlung an den Vermieter**.
|
||||
- **P03 – Abrechnungskonflikt:** Unterschied 900,20 € vs. 894,69 € als konkreter Klärungsfall; nicht automatisch einen der beiden Beträge überschreiben.
|
||||
- **P04 – Anreise:** Geplante E-Mail 72 Stunden vor Check-in als externe Kommunikationsaktivität berücksichtigen; dokumentieren, ob tatsächliche Versendung oder nur Ankündigung bekannt ist.
|
||||
- **Portabilität:** Der Screenshotsatz ist eine **Portalreferenz A4**, kein festverdrahtetes Datenmodell für alle externen Kanäle.
|
||||
|
||||
### 7.3 Unverändert offene Prüfpunkte
|
||||
|
||||
1. Ergebnis von **„Vollständige Zahlungsdetails ansehen“**: Gibt es eine tiefere Aufschlüsselung der 181,51 € und der 84,82 €?
|
||||
2. Ursache der **5,51-€-Differenz** zwischen zwei angezeigten Auszahlungsbeträgen.
|
||||
3. Nachweis tatsächlicher Auszahlungen und belastbarer Status-/Exportmöglichkeit für abgeschlossene Buchungen.
|
||||
4. Welche Bedingungen und Bestätigungsunterlagen erhält der Gast beim verbindlichen Portalabschluss?
|
||||
5. Umfang der benötigten und tatsächlich bereitgestellten Gäste- und Meldedaten.
|
||||
|
||||
**Bewertungsregel:** Beobachtete Portaloberfläche, fachliche Interpretation und noch nicht geprüfte Annahmen konsequent getrennt führen.
|
||||
|
||||
|
||||
## 8. Buchungsänderung und Storno – geprüfter Erkenntnisstand (31.10.2026)
|
||||
|
||||
**Ist-Praxis (Betreiber):** Bislang wurden weder eine Vermieterstornierung noch eine Buchungsänderung selbst durchgeführt. Bei Konflikten oder Doppelbuchungen wurde versucht, den Gast zur Stornierung zu bewegen. Das ist keine freigegebene Soll-Regel.
|
||||
|
||||
**Offiziell von FeWo-direkt beschrieben:** Gäste können selbst stornieren oder eine Stornierungsanfrage stellen. Gäste können Änderungsanfragen für Daten, Gästezahl oder Check-in stellen; Vermieter können solche Anfragen bearbeiten, ggf. mit neuer Preis-/Steuerberechnung. Gastgeber können über ihr Vermieterkonto stornieren, müssen mit Gebühren/Sanktionen rechnen und können in bestimmten begründeten Fällen einen Stornierungsverzicht beantragen. Doppelbuchungen des Gastgebers gelten grundsätzlich als gastgeberveranlasster Stornogrund. Die Richtlinie untersagt es ausdrücklich, Gäste zur Stornierung zu bewegen, um Sanktionen für den Gastgeber zu umgehen. Der bloße persönliche Konflikt mit einem Gast ist keine gesicherte Ausnahme; mögliche Hausregelverstöße müssen konkret geprüft werden.
|
||||
|
||||
**Generische Prozessanforderung:** Für jeden Änderungs-/Stornofall Ursache, tatsächlichen Initiator, technisch ausführenden Beteiligten, Verantwortlichen für Entscheidung/Erstattung, Ausführungs- und Nachweisstatus sowie Folgen für Konditionen, Vertrag, Belegung und Zahlung getrennt führen. Eine Storno-/Änderungsanfrage verändert nicht automatisch eine verbindliche Buchung. Datenquellen können je Portal unterschiedlich sein (Portal, API, E-Mail, iCal, manuell).
|
||||
|
||||
**Weiter ungeklärt:** Tatsächliche Benachrichtigungs- und Statusübermittlung an FewoPortal; Ablauf/Fristen und Nachweise im konkreten Konto; Verfahren anderer Portale.
|
||||
|
||||
**Offizielle Quellen:**
|
||||
- https://hilfe.fewo-direkt.de/articles/Kann-ein-Urlauber-eine-Reservierung-stornieren
|
||||
- https://hilfe.fewo-direkt.de/articles/Accept-or-decline-a-guest-s-change-request
|
||||
- https://hilfe.fewo-direkt.de/articles/Die-Reservierung-eines-Gastes-stornieren
|
||||
- https://www.fewo-direkt.de/tlp/trust-and-safety/partner-initiated-cancellation-policy
|
||||
|
||||
|
||||
## 9. Einordnung nach Gesamt-Konsolidierung v0.7
|
||||
|
||||
1. **A4 bleibt realer Praxisfall**, nicht Muster für alle Portale. FeWo-direkt zeigt in einer Buchung im Posteingang Zahlungsplan, einige aggregierte Preisbestandteile, Gäste-Gesamtzahlung, Abzug und erwartete Auszahlung; eine lückenlose Einzelpreis-/Gebührentransparenz und eine konsistente Auszahlungsübersicht sind weiter **nicht nachgewiesen**. Das frühere pauschale Urteil „keinerlei Zahlungsdaten“ ist überholt; konkrete Screenshots in Abschnitt 7 sind maßgeblich.
|
||||
2. **Ical-Verzögerung:** Direkte Buchung kann vor Verarbeitung einer anderswo veranlassten Blockierung verbindlich werden. FewoPortal darf eigene erfolgreiche Exporte nicht als Portal- oder Partnernetzbestätigung behandeln. Die Idee eines 10-Minuten-Freigabefensters ist **kein aktuell verfügbarer A4-Prozess**.
|
||||
3. **Vertragsdokumente:** Der eigene vierseitige Vertrag wird bisher nach der Portalbuchung versandt und ist nicht als statisches PDF in FeWo-direkt hinterlegt; Inhalt der dem Gast vor/bei Buchung gezeigten Bedingungen bleibt zu verifizieren. Statische allgemeine Bedingungen von individuellen Preis-/Zahlungsdetails trennen; keine still nachgeschobenen Verpflichtungen.
|
||||
4. **Sonderprozesse:** Bisher keine konkret selbst durchlaufene FeWo-direkt-Buchungsänderung und keine eigene Vermieterstornierung. Kein nicht erprobtes Verfahren als gelebte Praxis behaupten. Differenzierung **tatsächliche Stornoursache, Antragsteller, ausführender Beteiligter** beachten.
|
||||
5. **Abrechnung:** Unbekannte Gast-Servicegebühren, Portalabzüge, Vermieterprovisionen oder kombinierte Sammelpositionen müssen nicht künstlich zerlegt werden. Portalinformationen und manuelle Ergänzungen mit Quelle sichern; bei abweichenden Summen Klärungsaufgabe.
|
||||
|
||||
Fachliche Konkretisierung: [[K01_Preisstruktur_und_Abrechnung|K01]], [[X01_Belegungskonflikte_und_Sperrnachweise|X01]] und [[O00_Offene_Portalprueffaelle|O00]]. Keine Aktualisierung oder juristische Freigabe des ursprünglichen PDF-Vertrags durch diese Analyse.
|
||||
|
||||
## Verknüpfungen (Obsidian)
|
||||
|
||||
[[README|Startseite]] · [[00_Buchungsarchetypen|Archetypen]] · [[00_Portalprofile_und_Vertragsvorlagen|Vertragsprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[O00_Offene_Portalprueffaelle|Offene Prüffälle]] · [[P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_historisch|Frühere Fassung im P03-Archiv]]
|
||||
@@ -0,0 +1,184 @@
|
||||
--- a/00_Prozesslandkarte.md
|
||||
+++ b/00_Prozesslandkarte.md
|
||||
@@ -1,4 +1,5 @@
|
||||
-# 00 – Prozesslandkarte FewoPortal
|
||||
+
|
||||
+# 00 – Prozesslandkarte FewoPortal v0.5
|
||||
|
||||
**Status:** gemeinsamer Arbeitsstand; übergreifendes Modell, nicht vollständig freigegeben.
|
||||
**Stand:** 31.10.2026
|
||||
@@ -35,7 +36,7 @@
|
||||
| **P02** | Konditionen & Buchungsverbindlichkeit | Verbindlichkeit durch fristgerechte Annahme des **von uns bindenden Angebots** oder Nachweis einer schon verbindlichen Portalbuchung; gültige Konditionen revisionsfähig festgehalten |
|
||||
| **P03** | Buchungsverwaltung & kaufmännische Abwicklung | Vertragsdokumente, Zahlungszuständigkeit, Fristen und Verwaltungsaufgaben gesteuert, auch bei extern verantworteten Aktivitäten |
|
||||
| **P04** | Leistungsvorbereitung & Aufenthalt | Informationen und lokale Leistungen bereitgestellt; Anreise, Aufenthalt, Abreise betreut |
|
||||
-| **P05** | Abschluss & Nachbereitung | Offene Vorgänge transparent; Abschluss, Feedback und objektbezogene Folgeaufgaben; zulässige Übergabe an V02 |
|
||||
+| **P05** | Abschluss & Nachbereitung | Buchungs- und Leistungserbringung fachlich abgeschlossen; offene, danach eigenständig zu bearbeitende Fälle kontrolliert an Folgeprozesse übergeben; Feedback und objektbezogene Folgeaufgaben; zulässige Übergabe an V02 |
|
||||
|
||||
### V02 – Vermarktung, Gästegewinnung und Gästebindung (fachlich vorgesehen, Details später)
|
||||
|
||||
@@ -84,15 +85,17 @@
|
||||
- X08: No-show, vorzeitige Abreise, Verlängerung
|
||||
- X09: Reklamation, Schaden, Kaution und Nachforderung
|
||||
|
||||
-Ein Sonderprozess kann mehrere Phasen betreffen und verwendet dieselbe Buchungsakte und Ereignishistorie.
|
||||
+Ein Sonderprozess kann mehrere Phasen betreffen und verwendet dieselbe Buchungsakte und Ereignishistorie. **Nach abgeschlossenem Buchungs- und Leistungsprozess** können noch offene Ansprüche oder Konflikte als eigenständig zu bearbeitende Folgeprozesse weitergeführt werden; die Referenz auf die ursprüngliche Buchung und der Übergabenachweis bleiben erhalten (E-010).
|
||||
|
||||
## F. Zentrale Gate-Philosophie
|
||||
+
|
||||
+**P05-Abschluss-/Übergabegate (E-010):** Abschluss der Buchungs- und Leistungserbringung ist vom Ende nachlaufender Forderungs-, Schadens- oder Streitfälle zu unterscheiden. Offene Fälle werden mit Kontext, Verantwortlichkeit und Referenz zur Buchung an den jeweils zuständigen Folgeprozess übergeben. Die endgültigen Pflichtkriterien und Zustände werden in P05 spezifiziert.
|
||||
|
||||
Gates dokumentieren **Trigger, erwartetes Ergebnis, erforderliche Daten, Herkunft/Nachweis, zuständige Stelle, Ergebnisstatus, Folgeschritt**. Pflichtinformationen sind **aktivitätsbezogen**, nicht für alle Portale pauschal identisch. Fehlende Adressdaten dürfen eine durch Portalnachweis verbindliche Buchung nicht entwerten; sie blockieren nur Tätigkeiten, für die sie wirklich erforderlich sind.
|
||||
|
||||
## G. Noch zu entscheiden
|
||||
|
||||
-1. Fachlicher Abschluss von V01 bei offenen Rechnungen, Schäden oder Portalrückmeldungen.
|
||||
+1. **Detailkriterien für den fachlichen Abschluss von V01:** Welche Leistungen, Informationen und Übergaben müssen konkret abgeschlossen sein? Die Grundentscheidung ist getroffen: Nachlaufende Forderungen/Schäden blockieren nicht allein den Abschluss der Buchungs- und Leistungserbringung, wenn sie nachvollziehbar an einen verantwortlichen Folgeprozess übergeben wurden (E-010).
|
||||
2. Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; **keine Entscheidung für ein eigenständiges Objektmanagement-Modul**.
|
||||
3. Genauer Status- und Gate-Katalog, insbesondere Synchronisationssicherheit und externe Stornoereignisse.
|
||||
4. Abgrenzung P03/P04; Relevanz und Nachweisbarkeit der lokalen Prozesse.
|
||||
--- a/E00_Entscheidungsprotokoll.md
|
||||
+++ b/E00_Entscheidungsprotokoll.md
|
||||
@@ -1,3 +1,4 @@
|
||||
+
|
||||
# E00 – Entscheidungsprotokoll
|
||||
|
||||
**Stand:** 31.10.2026. Entscheidungen sind fachliche Betreiberfestlegungen, keine bestätigte Rechtsprüfung oder Implementierungsfreigabe.
|
||||
@@ -13,9 +14,10 @@
|
||||
| **E-007** | Beschlossen / Betreiberpräzisierung | Produktfokus: Eigene Website als zentraler Einstieg für einen Vermieter mit typischerweise **1–3 Ferienwohnungen**; mehrere Mandanten möglich; **kein Marktplatz**. Primär Gästegewinnung, Buchung und weitgehend automatisierte Abwicklung, nicht umfangreiche Haus-/Objektverwaltung. |
|
||||
| **E-008** | Beschlossen / Betreiberpräzisierung | V02 umfasst **Multichannel-Marketing und Gästegewinnung** (eigene Website, Social Media, Print, externe Portale) **sowie CRM, Stammkundenmanagement und Loyalty**. Damit ist V02 nicht nur Folgeprozess, sondern auch vorgelagert. Feedback/Bewertungen bleiben in V01. Detaillierung von V02 folgt später. |
|
||||
| **E-009** | Beschlossen / Betreiberpräzisierung | Buchungsbezogene Objektaufgaben (Reinigung, Schlüsselübergabe, lokale Leistungen) im Hauptprozess **einfach und integriert** behandeln. Die fachliche Existenz von Supportprozessen bedeutet **keine Pflicht zu eigenen Verwaltungsmodulen**. Erweiterte Objektverwaltung, Dienstleister-/Personalplanung und Vermittlungsagentur-Funktionen derzeit nicht priorisieren; Erweiterbarkeit offenhalten. |
|
||||
+| **E-010** | Grundsatz bestätigt / Details offen | Der Hauptwertschöpfungsprozess V01 endet fachlich mit Abschluss der Buchungs- und Leistungserbringung. Danach weiterlaufende Forderungs-, Schaden- oder Streitfälle sind **an zuständige Folgeprozesse zu übergeben**, anstatt den gesamten Buchungsprozess künstlich offen zu halten. Zusammenhang zur Buchung, Zuständigkeit und Übergabe müssen nachvollziehbar bleiben. Das genaue Abschluss-Gate ist noch zu spezifizieren. |
|
||||
|
||||
## Offene Grundsatzentscheidungen
|
||||
-- Fachliche Abschlusskriterien von V01 bei nachlaufenden Forderungen/Schäden/Portalstatus.
|
||||
+- Konkrete Mindestkriterien für P05-Abschluss, Übergabenachweis und Zuständigkeit der Folgeprozesse; Umgang mit abgebrochenen oder stornierten Vorgängen.
|
||||
- Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; Umfang späterer buchungsunabhängiger Funktionen.
|
||||
- Exakter Mindest-Nachweis und Datenumfang je externem Portalprofil.
|
||||
|
||||
@@ -29,4 +31,4 @@
|
||||
|
||||
## Dokumentationsregel (Arbeitsvereinbarung)
|
||||
|
||||
-Die bestehende Gitea-Dokumentation ist die führende Ablage. Es gibt **eine aktuelle Markdown-Datei je Thema**, P01–P05 dürfen jeweils mehrere Unterdokumente enthalten. Bei **neuen Markdown-Dateien** einen knappen YAML-Header (`id`, `typ`, `titel`, `status`) verwenden. Bestehende Abschnitte bei Fortschreibungen nicht still kürzen oder löschen; fachliche Entscheidungen mit ID verknüpfen und Änderungen per Git-Diff kontrollieren. **Keine implizite Freigabe von Implementierung oder Go-live.**
|
||||
+Die bestehende Gitea-Dokumentation ist die führende Ablage. Es gibt **eine aktuelle Markdown-Datei je Thema**, P01–P05 dürfen jeweils mehrere Unterdokumente enthalten. Bei **neuen und fachlich aktualisierten Markdown-Dateien** einen knappen YAML-Header (`id`, `typ`, `titel`, `status`, `version`) verwenden. Bestehende Abschnitte bei Fortschreibungen nicht still kürzen oder löschen; fachliche Entscheidungen mit ID verknüpfen und Änderungen per Git-Diff kontrollieren. **Keine implizite Freigabe von Implementierung oder Go-live.**
|
||||
--- a/G00_Gates_und_Uebergaben.md
|
||||
+++ b/G00_Gates_und_Uebergaben.md
|
||||
@@ -1,3 +1,4 @@
|
||||
+
|
||||
# G00 – Gate- und Übergabemodell (Arbeitsstand)
|
||||
|
||||
## Grundregel
|
||||
@@ -23,5 +24,10 @@
|
||||
- **GD:** Erforderliche Gästedaten für lokale Abwicklung liegen vor; darf auch nach GC offen sein.
|
||||
- **GE:** Externer Portalprozess vollständig verantwortet: für lokale Abwicklung notwendige Informationen vorhanden, extern zuständige Vorgänge ausgewiesen.
|
||||
|
||||
+## P05 – Abschluss- und Folgeprozess-Übergabe (Grundsatz E-010)
|
||||
+- **Abschluss V01:** Fachliche Buchungs- und Leistungserbringung ist beendet; ein ausstehender Anspruch allein blockiert den Prozessabschluss nicht, wenn dessen Bearbeitung wirksam an einen verantwortlichen Folgeprozess übergeben wurde.
|
||||
+- **Übergabe:** Benötigt mindestens Referenz zur ursprünglichen Buchung, Beschreibung des offenen Sachverhalts, verantwortliche Stelle und nachweisbaren Übergabestatus. Detailumfang und Automatismus bleiben offen.
|
||||
+- **Status:** Buchungsprozess abgeschlossen und Folgeprozess offen sind gleichzeitig möglich. Die technische Ausgestaltung der Akte ist noch nicht beschlossen.
|
||||
+
|
||||
## Noch offen
|
||||
-Konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
|
||||
+Detailkriterien für das P05-Abschlussgate und die Behandlung von Storno-/Abbruch-Ausgängen; konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
|
||||
--- a/S00_Supportprozesse.md
|
||||
+++ b/S00_Supportprozesse.md
|
||||
@@ -1,3 +1,4 @@
|
||||
+
|
||||
# S00 – Supportprozesse (vorläufiger Katalog)
|
||||
|
||||
Diese Prozesse unterstützen V01 und V02. **Produktmandat E-007 bis E-009:** FewoPortal richtet sich zunächst an Vermieter mit typischerweise 1–3 Ferienwohnungen, mehreren möglichen Mandanten, aber **ohne Marktplatz-/Agentur-Schwerpunkt**. Ein fachlicher Supportprozess rechtfertigt **kein eigenständiges Softwaremodul**. Buchungsbezogene Aufgaben sind möglichst in der Buchungsakte integriert und automatisiert; weitergehende Objektverwaltung bleibt Zukunftsoption.
|
||||
--- a/X00_Sonderprozesse.md
|
||||
+++ b/X00_Sonderprozesse.md
|
||||
@@ -1,3 +1,4 @@
|
||||
+
|
||||
# X00 – Sonder- und Ausnahmeprozesse (vorläufiger Katalog)
|
||||
|
||||
Sonderprozesse können aus unterschiedlichen Phasen starten. Sie nutzen dieselbe Vorgangsakte; keine parallelen Buchungsformulare/-workflows.
|
||||
@@ -14,4 +15,6 @@
|
||||
| X08 | Aufenthaltsabweichung | No-show, Verlängerung, vorzeitige Abreise |
|
||||
| X09 | Schäden/Reklamation | Mangel, Schaden, Kaution/Nachforderung |
|
||||
|
||||
+**Prozessübergabe nach V01 (E-010):** Nach Abschluss der Buchungs- und Leistungserbringung noch offene Fälle (z. B. Schadenersatzforderung, Erstattung, Streitfall) werden an einen zuständigen Folgeprozess übergeben. Sie bleiben mit der ursprünglichen Buchung verbunden. Ob dafür ein separater Vorgang oder eine verknüpfte Aktivität angelegt wird, ist noch nicht entschieden.
|
||||
+
|
||||
**Rechtsfragen separat:** Für externe Vollabwicklung liegt die Vertrags-/Mahn-/Storno-Verantwortung beim Portal gemäß vertraglicher Vereinbarung; FewoPortal braucht einen nachvollziehbaren Übergabestatus und mindestens die für eigene Pflichten nötigen Informationen.
|
||||
--- a/README.md
|
||||
+++ b/README.md
|
||||
@@ -1,18 +1,19 @@
|
||||
-# FewoPortal – Prozessarchitektur v0.4
|
||||
+
|
||||
+# FewoPortal – Prozessarchitektur v0.5
|
||||
|
||||
**Status:** Fachlicher Arbeitsstand / Interview, keine Implementierungsfreigabe
|
||||
**Stand:** 31.10.2026
|
||||
|
||||
-Diese Version konsolidiert die Betreiberangaben vom 31.10.2026, die v0.3 und die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert.
|
||||
+Diese Version konsolidiert die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die danach bestätigten Entscheidungen E-007 bis E-010 und die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
|
||||
|
||||
## Dateien
|
||||
|
||||
- `00_Prozesslandkarte.md` – Generischer Gesamtprozess, Prozessfamilien und Zuordnung
|
||||
-- `P01_Buchungseingang_und_Verfuegbarkeit.md` bis `P05_Abschluss_und_Nachbereitung.md` – getrennte Phasengerüste
|
||||
+- `P01/` bis `P05/` – je ein eigener Unterordner mit dem bisherigen Phasengerüst; weitere Detaildokumente können dort ergänzt werden
|
||||
- `G00_Gates_und_Uebergaben.md` – übergreifende Gates
|
||||
- `S00_Supportprozesse.md` und `X00_Sonderprozesse.md` – vorläufige Kataloge
|
||||
- `E00_Entscheidungsprotokoll.md` – beschlossene Punkte und offene Fragen
|
||||
|
||||
**Quellen:** `crystalline-floating-glacier.md`, `UEBERGABE-BUCHUNGSPROZESS.md`, Gesamtprozess v0.3 und die Betreiberpräzisierung vom 31.10.2026. Weitere Fach- und Rechtsprüfung erforderlich.
|
||||
|
||||
-**Arbeitsregel:** Nur ausdrücklich beschlossene Punkte als Entscheidung kennzeichnen; Vorschläge als solche markieren. Keine automatischen Änderungen am produktiven System.
|
||||
+**Arbeitsregel:** Nur ausdrücklich beschlossene Punkte als Entscheidung kennzeichnen; Vorschläge als solche markieren. Jede Datei trägt einen YAML-Header mit `id`, `typ`, `titel`, `status`, `version`. Die Version v0.5 bezeichnet den konsolidierten **Dokumentationsstand**, nicht eine Implementierungsversion. Bestehende Inhalte werden nicht stillschweigend gekürzt. Änderungen an Gitea erfolgen erst nach Abgleich mit dem dortigen Stand. Keine automatischen Änderungen am produktiven System.
|
||||
--- a/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
|
||||
+++ b/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
|
||||
@@ -1,3 +1,4 @@
|
||||
+
|
||||
# P01 – Buchungseingang und Verfügbarkeitssicherung
|
||||
|
||||
**Status:** Phasengerüst – Detailinterview steht aus.
|
||||
--- a/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
|
||||
+++ b/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
|
||||
@@ -1,3 +1,4 @@
|
||||
+
|
||||
# P02 – Konditionen und Buchungsverbindlichkeit
|
||||
|
||||
**Status:** wesentliche Geschäftsregeln im Betreiberinterview bestätigt; Detail- und Rechtsprüfung offen.
|
||||
--- a/P03/P03_Buchungsverwaltung_und_Abwicklung.md
|
||||
+++ b/P03/P03_Buchungsverwaltung_und_Abwicklung.md
|
||||
@@ -1,3 +1,4 @@
|
||||
+
|
||||
# P03 – Buchungsverwaltung und kaufmännische Abwicklung
|
||||
|
||||
**Status:** Phasengerüst; Detailinterview steht aus.
|
||||
--- a/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
|
||||
+++ b/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
|
||||
@@ -1,3 +1,4 @@
|
||||
+
|
||||
# P04 – Leistungsvorbereitung und Aufenthalt
|
||||
|
||||
**Status:** Phasengerüst; Detailinterview steht aus.
|
||||
--- a/P05/P05_Abschluss_und_Nachbereitung.md
|
||||
+++ b/P05/P05_Abschluss_und_Nachbereitung.md
|
||||
@@ -1,19 +1,20 @@
|
||||
+
|
||||
# P05 – Abschluss und Nachbereitung
|
||||
|
||||
**Status:** Phasengerüst; Detailinterview steht aus.
|
||||
|
||||
## Zweck
|
||||
-Aufenthalt und Buchung nachvollziehbar abschließen, Feedback einholen und offene Folgeaufgaben kontrolliert weiterführen.
|
||||
+Buchungs- und Leistungserbringung nachvollziehbar abschließen, Feedback einholen und offene nachlaufende Fälle **kontrolliert an zuständige Folgeprozesse übergeben**, ohne den V01-Hauptprozess deshalb künstlich offen zu halten (E-010).
|
||||
|
||||
## Aktivitäten (vorläufig)
|
||||
- Abreise und Leistungsabschluss dokumentieren.
|
||||
-- Ausstehende Abrechnung, Erstattungen, Schäden oder Nachforderungen erkennen und behandeln.
|
||||
+- Ausstehende Abrechnung, Erstattungen, Schäden oder Nachforderungen erkennen, soweit Teil der unmittelbaren Buchungsabwicklung behandeln und sonst mit nachvollziehbarer Zuständigkeit und Buchungsreferenz an einen Folgeprozess übergeben.
|
||||
- Reinigung/Reparatur/Objektbereitstellung für nächsten Aufenthalt initiieren und Status verfolgen.
|
||||
- Dankesnachricht, Feedback und Bewertung im **Buchungsprozess V01** abwickeln.
|
||||
- Zulässige Informationen an den **eigenständigen Wertschöpfungsprozess V02 – Gästebindung/Marketing** übergeben; ggf. Loyalty-Ereignis auslösen.
|
||||
|
||||
## Gates
|
||||
-Fachlicher, finanzieller und objektbezogener Abschluss können unterschiedliche Zustände haben. Das exakte Schließkriterium ist noch zu entscheiden.
|
||||
+Fachlicher, finanzieller und objektbezogener Abschluss können unterschiedliche Zustände haben. **Grundsatz (E-010):** V01 kann nach erfolgter Buchungs- und Leistungserbringung fachlich abgeschlossen werden, auch wenn übergebene Ansprüche oder Konflikte noch zu bearbeiten sind. Übergaben müssen zugeordnet, nachvollziehbar und mit der Buchung verknüpft bleiben. **Welche Pflichtaktivitäten den V01-Abschluss konkret freigeben, ist noch offen.**
|
||||
|
||||
## Noch offen
|
||||
-Wann Akte abgeschlossen sein darf; Weiterverfolgung offener Forderungen; Objektbereitstellung und Abgrenzung zum Folgeaufenthalt.
|
||||
+Genaue Abschlusskriterien und erforderliche Nachweise; Zuständigkeit und Verknüpfung nachlaufender Folgeprozesse; Objektbereitstellung und Abgrenzung zum Folgeaufenthalt; alternativer Ausgang bei Stornierung oder abgebrochenem Vorgang. **Ob die technische Buchungsakte geschlossen wird oder nur der V01-Prozessstatus wechselt, ist nicht entschieden.**
|
||||
@@ -0,0 +1,193 @@
|
||||
--- v0.5/00_Prozesslandkarte.md
|
||||
+++ v0.6/00_Prozesslandkarte.md
|
||||
@@ -3,10 +3,10 @@
|
||||
typ: prozesslandkarte
|
||||
titel: FewoPortal – Prozesslandkarte
|
||||
status: arbeitsstand
|
||||
-version: '0.5'
|
||||
+version: '0.6'
|
||||
---
|
||||
|
||||
-# 00 – Prozesslandkarte FewoPortal v0.5
|
||||
+# 00 – Prozesslandkarte FewoPortal v0.6
|
||||
|
||||
**Status:** gemeinsamer Arbeitsstand; übergreifendes Modell, nicht vollständig freigegeben.
|
||||
**Stand:** 31.10.2026
|
||||
@@ -94,6 +94,8 @@
|
||||
|
||||
Ein Sonderprozess kann mehrere Phasen betreffen und verwendet dieselbe Buchungsakte und Ereignishistorie. **Nach abgeschlossenem Buchungs- und Leistungsprozess** können noch offene Ansprüche oder Konflikte als eigenständig zu bearbeitende Folgeprozesse weitergeführt werden; die Referenz auf die ursprüngliche Buchung und der Übergabenachweis bleiben erhalten (E-010).
|
||||
|
||||
+**Alternative fachliche Endergebnisse V01 (E-011):** Ein regulär erfüllter Aufenthalt, eine ohne Buchung beendete Anbahnung (z. B. Angebotsablauf oder Ablehnung) und die Stornierung nach entstandener Verbindlichkeit sind unterschiedliche Ergebnisse **desselben** generischen Prozesses. Eine reguläre Leistungserbringung durchläuft typischerweise P05; ein früher Abbruch muss nicht künstlich P03–P05 durchlaufen. Auslösende Ereignisse, Nachweise, ggf. Belegungsfreigabe und verbleibende Folgepflichten werden nachvollziehbar dokumentiert. Weitere Endergebnisse sowie exakte Übergangsbedingungen sind offen.
|
||||
+
|
||||
## F. Zentrale Gate-Philosophie
|
||||
|
||||
**P05-Abschluss-/Übergabegate (E-010):** Abschluss der Buchungs- und Leistungserbringung ist vom Ende nachlaufender Forderungs-, Schadens- oder Streitfälle zu unterscheiden. Offene Fälle werden mit Kontext, Verantwortlichkeit und Referenz zur Buchung an den jeweils zuständigen Folgeprozess übergeben. Die endgültigen Pflichtkriterien und Zustände werden in P05 spezifiziert.
|
||||
@@ -104,7 +106,7 @@
|
||||
|
||||
1. **Detailkriterien für den fachlichen Abschluss von V01:** Welche Leistungen, Informationen und Übergaben müssen konkret abgeschlossen sein? Die Grundentscheidung ist getroffen: Nachlaufende Forderungen/Schäden blockieren nicht allein den Abschluss der Buchungs- und Leistungserbringung, wenn sie nachvollziehbar an einen verantwortlichen Folgeprozess übergeben wurden (E-010).
|
||||
2. Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; **keine Entscheidung für ein eigenständiges Objektmanagement-Modul**.
|
||||
-3. Genauer Status- und Gate-Katalog, insbesondere Synchronisationssicherheit und externe Stornoereignisse.
|
||||
+3. Genauer Status- und Gate-Katalog, **einschließlich alternativer Prozessausgänge nach E-011**, Synchronisationssicherheit und externer Stornoereignisse.
|
||||
4. Abgrenzung P03/P04; Relevanz und Nachweisbarkeit der lokalen Prozesse.
|
||||
5. Pro Kanal tatsächlicher Verbindlichkeitsnachweis, Datenlage und Portalbestimmungen.
|
||||
|
||||
--- v0.5/E00_Entscheidungsprotokoll.md
|
||||
+++ v0.6/E00_Entscheidungsprotokoll.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: entscheidungsprotokoll
|
||||
titel: Entscheidungsprotokoll
|
||||
status: arbeitsstand
|
||||
-version: '0.5'
|
||||
+version: '0.6'
|
||||
---
|
||||
|
||||
# E00 – Entscheidungsprotokoll
|
||||
@@ -22,9 +22,10 @@
|
||||
| **E-008** | Beschlossen / Betreiberpräzisierung | V02 umfasst **Multichannel-Marketing und Gästegewinnung** (eigene Website, Social Media, Print, externe Portale) **sowie CRM, Stammkundenmanagement und Loyalty**. Damit ist V02 nicht nur Folgeprozess, sondern auch vorgelagert. Feedback/Bewertungen bleiben in V01. Detaillierung von V02 folgt später. |
|
||||
| **E-009** | Beschlossen / Betreiberpräzisierung | Buchungsbezogene Objektaufgaben (Reinigung, Schlüsselübergabe, lokale Leistungen) im Hauptprozess **einfach und integriert** behandeln. Die fachliche Existenz von Supportprozessen bedeutet **keine Pflicht zu eigenen Verwaltungsmodulen**. Erweiterte Objektverwaltung, Dienstleister-/Personalplanung und Vermittlungsagentur-Funktionen derzeit nicht priorisieren; Erweiterbarkeit offenhalten. |
|
||||
| **E-010** | Grundsatz bestätigt / Details offen | Der Hauptwertschöpfungsprozess V01 endet fachlich mit Abschluss der Buchungs- und Leistungserbringung. Danach weiterlaufende Forderungs-, Schaden- oder Streitfälle sind **an zuständige Folgeprozesse zu übergeben**, anstatt den gesamten Buchungsprozess künstlich offen zu halten. Zusammenhang zur Buchung, Zuständigkeit und Übergabe müssen nachvollziehbar bleiben. Das genaue Abschluss-Gate ist noch zu spezifizieren. |
|
||||
+| **E-011** | Beschlossen / Detailkriterien offen | V01 kann mit **unterschiedlichen fachlichen Endergebnissen** enden: regulär abgeschlossen (erbrachte Leistung), ohne Buchung beendet (z. B. abgelehnte/abgelaufene Anfrage bzw. nicht angenommenes Angebot) oder storniert (nach entstandener Verbindlichkeit, soweit zutreffend). Diese Ergebnisse sind **alternative Ausgänge eines einzigen generischen Prozesses**, keine zusätzlichen Buchungsworkflows. Nachweise, Historie und erforderliche Folgeaktivitäten/Übergaben bleiben erhalten. Die vollständige Taxonomie und konkrete Zustandsübergänge sind noch zu spezifizieren. |
|
||||
|
||||
## Offene Grundsatzentscheidungen
|
||||
-- Konkrete Mindestkriterien für P05-Abschluss, Übergabenachweis und Zuständigkeit der Folgeprozesse; Umgang mit abgebrochenen oder stornierten Vorgängen.
|
||||
+- Konkrete Mindestkriterien für P05-Abschluss, Übergabenachweis und Zuständigkeit der Folgeprozesse; **Detailkriterien** und die vollständige Taxonomie der alternativen Prozessausgänge (E-011).
|
||||
- Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; Umfang späterer buchungsunabhängiger Funktionen.
|
||||
- Exakter Mindest-Nachweis und Datenumfang je externem Portalprofil.
|
||||
|
||||
--- v0.5/G00_Gates_und_Uebergaben.md
|
||||
+++ v0.6/G00_Gates_und_Uebergaben.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: gate-modell
|
||||
titel: Gate- und Übergabemodell
|
||||
status: arbeitsstand
|
||||
-version: '0.5'
|
||||
+version: '0.6'
|
||||
---
|
||||
|
||||
# G00 – Gate- und Übergabemodell (Arbeitsstand)
|
||||
@@ -36,5 +36,8 @@
|
||||
- **Übergabe:** Benötigt mindestens Referenz zur ursprünglichen Buchung, Beschreibung des offenen Sachverhalts, verantwortliche Stelle und nachweisbaren Übergabestatus. Detailumfang und Automatismus bleiben offen.
|
||||
- **Status:** Buchungsprozess abgeschlossen und Folgeprozess offen sind gleichzeitig möglich. Die technische Ausgestaltung der Akte ist noch nicht beschlossen.
|
||||
|
||||
+## Alternative End-Gates V01 (E-011)
|
||||
+Je nach tatsächlichem Verlauf weist V01 ein eigenes fachliches Endergebnis aus: **regulär abgeschlossen**, **ohne Buchung beendet** oder **storniert** (nach Verbindlichkeit). End-Gates sichern die jeweils zutreffenden Nachweise und gegebenenfalls erforderliche Folgeübergaben; nicht erforderliche Zwischenphasen werden nicht künstlich ausgeführt. Vollständiger Ergebnis- und Nachweiskatalog bleibt offen.
|
||||
+
|
||||
## Noch offen
|
||||
-Detailkriterien für das P05-Abschlussgate und die Behandlung von Storno-/Abbruch-Ausgängen; konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
|
||||
+Detailkriterien für das P05-Abschlussgate und die Detailbedingungen der Storno-/Abbruch-Ausgänge; konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
|
||||
--- v0.5/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
|
||||
+++ v0.6/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Buchungseingang und Verfügbarkeitssicherung
|
||||
status: entwurf
|
||||
-version: '0.5'
|
||||
+version: '0.6'
|
||||
---
|
||||
|
||||
# P01 – Buchungseingang und Verfügbarkeitssicherung
|
||||
--- v0.5/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
|
||||
+++ v0.6/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Konditionen und Buchungsverbindlichkeit
|
||||
status: entwurf
|
||||
-version: '0.5'
|
||||
+version: '0.6'
|
||||
---
|
||||
|
||||
# P02 – Konditionen und Buchungsverbindlichkeit
|
||||
--- v0.5/P03/P03_Buchungsverwaltung_und_Abwicklung.md
|
||||
+++ v0.6/P03/P03_Buchungsverwaltung_und_Abwicklung.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Buchungsverwaltung und kaufmännische Abwicklung
|
||||
status: entwurf
|
||||
-version: '0.5'
|
||||
+version: '0.6'
|
||||
---
|
||||
|
||||
# P03 – Buchungsverwaltung und kaufmännische Abwicklung
|
||||
--- v0.5/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
|
||||
+++ v0.6/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Leistungsvorbereitung und Aufenthalt
|
||||
status: entwurf
|
||||
-version: '0.5'
|
||||
+version: '0.6'
|
||||
---
|
||||
|
||||
# P04 – Leistungsvorbereitung und Aufenthalt
|
||||
--- v0.5/P05/P05_Abschluss_und_Nachbereitung.md
|
||||
+++ v0.6/P05/P05_Abschluss_und_Nachbereitung.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Abschluss und Nachbereitung
|
||||
status: entwurf
|
||||
-version: '0.5'
|
||||
+version: '0.6'
|
||||
---
|
||||
|
||||
# P05 – Abschluss und Nachbereitung
|
||||
@@ -23,5 +23,8 @@
|
||||
## Gates
|
||||
Fachlicher, finanzieller und objektbezogener Abschluss können unterschiedliche Zustände haben. **Grundsatz (E-010):** V01 kann nach erfolgter Buchungs- und Leistungserbringung fachlich abgeschlossen werden, auch wenn übergebene Ansprüche oder Konflikte noch zu bearbeiten sind. Übergaben müssen zugeordnet, nachvollziehbar und mit der Buchung verknüpft bleiben. **Welche Pflichtaktivitäten den V01-Abschluss konkret freigeben, ist noch offen.**
|
||||
|
||||
+## Abgrenzung zu alternativen Prozessausgängen (E-011)
|
||||
+P05 beschreibt den regulären Abschluss nach Buchungs- und Leistungserbringung. **Ohne Buchung beendete** Vorgänge (z. B. Angebotsablauf) und **stornierte** verbindliche Buchungen können V01 über andere End-Gates beenden, ohne die regulären P05-Aktivitäten künstlich zu durchlaufen. Offene Folgepflichten und Belege bleiben mit dem ursprünglichen Vorgang verknüpft. Die konkreten Gate- und Nachweiskriterien sind noch offen.
|
||||
+
|
||||
## Noch offen
|
||||
Genaue Abschlusskriterien und erforderliche Nachweise; Zuständigkeit und Verknüpfung nachlaufender Folgeprozesse; Objektbereitstellung und Abgrenzung zum Folgeaufenthalt; alternativer Ausgang bei Stornierung oder abgebrochenem Vorgang. **Ob die technische Buchungsakte geschlossen wird oder nur der V01-Prozessstatus wechselt, ist nicht entschieden.**
|
||||
--- v0.5/README.md
|
||||
+++ v0.6/README.md
|
||||
@@ -3,15 +3,15 @@
|
||||
typ: projektindex
|
||||
titel: FewoPortal Prozessarchitektur
|
||||
status: arbeitsstand
|
||||
-version: '0.5'
|
||||
+version: '0.6'
|
||||
---
|
||||
|
||||
-# FewoPortal – Prozessarchitektur v0.5
|
||||
+# FewoPortal – Prozessarchitektur v0.6
|
||||
|
||||
**Status:** Fachlicher Arbeitsstand / Interview, keine Implementierungsfreigabe
|
||||
**Stand:** 31.10.2026
|
||||
|
||||
-Diese Version konsolidiert die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die danach bestätigten Entscheidungen E-007 bis E-010 und die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
|
||||
+Diese Version führt den konsolidierten Stand v0.5 mit **E-011 (alternative fachliche Prozessausgänge)** fort und bewahrt die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die Entscheidungen E-001 bis E-010 sowie die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
|
||||
|
||||
## Dateien
|
||||
|
||||
--- v0.5/S00_Supportprozesse.md
|
||||
+++ v0.6/S00_Supportprozesse.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozesskatalog
|
||||
titel: Supportprozesse
|
||||
status: arbeitsstand
|
||||
-version: '0.5'
|
||||
+version: '0.6'
|
||||
---
|
||||
|
||||
# S00 – Supportprozesse (vorläufiger Katalog)
|
||||
--- v0.5/X00_Sonderprozesse.md
|
||||
+++ v0.6/X00_Sonderprozesse.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozesskatalog
|
||||
titel: Sonder- und Ausnahmeprozesse
|
||||
status: arbeitsstand
|
||||
-version: '0.5'
|
||||
+version: '0.6'
|
||||
---
|
||||
|
||||
# X00 – Sonder- und Ausnahmeprozesse (vorläufiger Katalog)
|
||||
@@ -22,6 +22,8 @@
|
||||
| X08 | Aufenthaltsabweichung | No-show, Verlängerung, vorzeitige Abreise |
|
||||
| X09 | Schäden/Reklamation | Mangel, Schaden, Kaution/Nachforderung |
|
||||
|
||||
+**Alternative Prozessausgänge (E-011):** X03 kann zu **ohne Buchung beendet** führen; X04 kann eine bereits verbindliche Buchung zu **storniert** führen. Dies sind Endergebnisse von V01, keine eigenständigen parallelen Buchungsworkflows. Vorreservierung, Kalender, Dokumentation und offene Pflichten müssen je Fall nachweisbar behandelt werden. Einzelregeln noch offen.
|
||||
+
|
||||
**Prozessübergabe nach V01 (E-010):** Nach Abschluss der Buchungs- und Leistungserbringung noch offene Fälle (z. B. Schadenersatzforderung, Erstattung, Streitfall) werden an einen zuständigen Folgeprozess übergeben. Sie bleiben mit der ursprünglichen Buchung verbunden. Ob dafür ein separater Vorgang oder eine verknüpfte Aktivität angelegt wird, ist noch nicht entschieden.
|
||||
|
||||
**Rechtsfragen separat:** Für externe Vollabwicklung liegt die Vertrags-/Mahn-/Storno-Verantwortung beim Portal gemäß vertraglicher Vereinbarung; FewoPortal braucht einen nachvollziehbaren Übergabestatus und mindestens die für eigene Pflichten nötigen Informationen.
|
||||
@@ -0,0 +1,783 @@
|
||||
--- basis/X00_Sonderprozesse.md
|
||||
+++ v0.7/X00_Sonderprozesse.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozesskatalog
|
||||
titel: Sonder- und Ausnahmeprozesse
|
||||
status: arbeitsstand
|
||||
-version: '0.6'
|
||||
+version: '0.7'
|
||||
---
|
||||
|
||||
# X00 – Sonder- und Ausnahmeprozesse (vorläufiger Katalog)
|
||||
@@ -27,3 +27,10 @@
|
||||
**Prozessübergabe nach V01 (E-010):** Nach Abschluss der Buchungs- und Leistungserbringung noch offene Fälle (z. B. Schadenersatzforderung, Erstattung, Streitfall) werden an einen zuständigen Folgeprozess übergeben. Sie bleiben mit der ursprünglichen Buchung verbunden. Ob dafür ein separater Vorgang oder eine verknüpfte Aktivität angelegt wird, ist noch nicht entschieden.
|
||||
|
||||
**Rechtsfragen separat:** Für externe Vollabwicklung liegt die Vertrags-/Mahn-/Storno-Verantwortung beim Portal gemäß vertraglicher Vereinbarung; FewoPortal braucht einen nachvollziehbaren Übergabestatus und mindestens die für eigene Pflichten nötigen Informationen.
|
||||
+
|
||||
+
|
||||
+## Präzisierung v0.7: Änderungs-/Stornovorgang und Konfliktnachweise
|
||||
+
|
||||
+- **X02/X04:** Zwischen *Anfrage*, *Annahme/Bestätigung*, *wirksamer Vertragsänderung/Stornierung* und *tatsächlichen Finanz-/Belegungsfolgen* unterscheiden. Ursache, Initiator, Ausführender und Verantwortlicher sind keine austauschbaren Felder. Tatsächlicher Vermieterstornogrund bleibt Vermieterstornogrund, selbst wenn ein Gast auf der Portaloberfläche die Aktion ausführt; Portalregeln und rechtliche Wirkungen gesondert prüfen. Der Betreiber hat beim FeWo-direkt-Konto bislang keine solche Änderung oder Vermieterstornierung selbst durchgeführt; unbekannte Prozesse nicht als erprobte Ist-Abläufe ausgeben.
|
||||
+- **X05/X06:** Fehlende Preisdetails, zusammengefasste Service-/Provisionsanteile oder abweichende Auszahlungssummen sind normale Klärungsfälle; manuelle Zuordnung und erneuter Abgleich, ohne Buchungspreis zu überschreiben.
|
||||
+- **X07:** Bei Destination Solutions manuelle Kalendersperre ohne serverseitig/partnernetzweit bestätigten Sperrnachweis; bei FeWo-direkt verzögerter iCal-Import. Technische Ursache und mögliche Rechts-/Haftungsfolgen getrennt bewerten. [Ausführlicher Fachfall X07](X01_Belegungskonflikte_und_Sperrnachweise.md).
|
||||
--- basis/AENDERUNGSUEBERSICHT.md
|
||||
+++ v0.7/AENDERUNGSUEBERSICHT.md
|
||||
@@ -6,3 +6,14 @@
|
||||
- Offene Detailkriterien und Zustandsübergänge ausdrücklich **nicht** als entschieden dargestellt.
|
||||
- Keine Löschung bestehender Inhalte, keine Änderung des Anwendungscodes. Gitea selbst wurde nicht verändert.
|
||||
- `AENDERUNGEN_ZU_V0.6.diff` dokumentiert die tatsächlichen Textänderungen.
|
||||
+
|
||||
+
|
||||
+# Änderung v0.7 gegenüber v0.6 (Konsolidierung 31.10.2026)
|
||||
+
|
||||
+- E-012–E-021 aus dem fachlichen Interview nachgeführt; fünf Archetypen, kein A6.
|
||||
+- Destination Solutions (A3) als realer Referenzfall samt Stornostaffel, manueller Sperre ohne Übernahmenachweis, provisionsabhängigen Partnerkanälen und ungeklärtem Gast-Aufschlag dokumentiert.
|
||||
+- FeWo-direkt (A4) um differenzierte Zahlungsdaten, iCal-Risiko, noch offene Rechts-/Gast- und Gebühreninformationen ergänzt.
|
||||
+- Flexible Preispositionen und Sammelbeträge, manuelle/hybride Klärung und kontrollierbare Nachweiskette in P01–P05, K00/K01, G00, X00 aufgenommen.
|
||||
+- Neues Portalfragenregister und verbindliche Dokumentationsarbeitsregel: aktuelle Originaldokumente künftig **vor jedem Edit erneut anfordern**.
|
||||
+- R01-Referenzentwurf inhaltlich unverändert übernommen, R08 neu ergänzt.
|
||||
+- Ausgangsdokumente unverändert gelassen; Diff und Prüfliste im Paket. Keine Gitea-Änderung/Implementierungsfreigabe.
|
||||
--- basis/00_Portalprofile_und_Vertragsvorlagen.md
|
||||
+++ v0.7/00_Portalprofile_und_Vertragsvorlagen.md
|
||||
@@ -3,10 +3,10 @@
|
||||
typ: fachliches-konzept
|
||||
titel: Portalprofile, Konditionsquellen und Vertragsvorlagen
|
||||
status: diskussionsentwurf
|
||||
-version: "0.1"
|
||||
+version: "0.2"
|
||||
stand: 2026-10-31
|
||||
prozess: V01
|
||||
-bezugsstand_archetypen: "0.3"
|
||||
+bezugsstand_archetypen: "0.6"
|
||||
---
|
||||
|
||||
# K00 – Portalprofile und Vertragsvorlagen
|
||||
@@ -39,7 +39,7 @@
|
||||
| A1 / A2, eigener Angebotsabschluss | Eigenes **bindendes Angebot** mit ausgewählten Vertragsbedingungen/Anlagen. Wirksam angenommene Version wird unverändert nachgewiesen; anschließend Vertragsdokument bzw. Bestätigung aus diesem Stand. |
|
||||
| A3 / A4, extern bereits verbindlich, Vertragstext/Unterlagen durch uns | **Kanal- und buchungstypspezifische Vertragsdokumentation** der bereits vereinbarten Bedingungen; **keine zweite obligatorische Annahme**. Widersprechende/neue Klauseln nicht still ergänzen. |
|
||||
| A5, Vertrag/Abwicklung extern | Externen Vertrags- und Konditionsnachweis referenzieren/ablegen, eigene Dokumente nur, wenn erforderlich. Keine doppelte Vertragsbegründung. |
|
||||
-| A6, Hub/Partnervermittlung | Aus Herkunft und tatsächlicher Zuständigkeit das passende A2–A5-Profil und damit Dokumentenprofil bestimmen. |
|
||||
+| Optional: Partnerherkunft | **Kein eigener Archetyp A6.** Nur bei kaufmännischer Relevanz (z. B. unterschiedliche Vermittlerprovision) Herkunft erfassen; Buchung bleibt A1–A5. |
|
||||
|
||||
Eine **gemeinsame Konditions-/Vertragszusammenstellung** soll vor dem Versand anzeigen: maßgeblicher Preis, enthaltene/optionale Leistungen, Rabatte, Stornoregel, Gastdaten, gewählte **Vorlage mit Version**, passende **Anlagen**, nachweisbarer Konditionsstand und Dokumentenvorschau. Der Vermieter kann die Auswahl im Rahmen der rechtlich/fachlich zulässigen Regeln korrigieren; keine separaten Portalfomulare.
|
||||
|
||||
@@ -76,3 +76,29 @@
|
||||
4. **Noch offen:** Welche konkreten Dokumententypen und Anlagen sollen über Vermieter/Objekt/Portal hinweg wiederverwendbar sein, und welche müssen zwingend getrennt bleiben?
|
||||
|
||||
**Status:** Portalübergreifende Fachregeln aus dem Interview festgehalten; Auswahlregeln sind ein fachlicher Vorschlag zur späteren Validierung, **keine freigegebene technische Implementierung**.
|
||||
+
|
||||
+
|
||||
+## 8. Erweiterung v0.2 – Flexible Portal- und Preisfunktionen
|
||||
+
|
||||
+**Konfiguration nach tatsächlicher Fähigkeit statt Portalname fest in Programmcode:**
|
||||
+
|
||||
+| Merkmal | Konfigurierbare Ausprägungen / Konsequenz |
|
||||
+|---|---|
|
||||
+| Eingang/Belegung | iCal/API/E-Mail/Portalansicht/manuell; zeitverzögert, nicht verfügbar oder unbekannt; manuelle Sperraufgabe zulässig |
|
||||
+| Gast-/Vertragsdaten | vollständig, teilweise, nicht geliefert; ggf. manuell über Gast oder Portal abrufen |
|
||||
+| Vertrag und Preisquelle | eigene verbindliche Angebotsdaten oder extern bestätigter Gastpreis; Gesamtbetrag auch ohne Einzelpreise zulässig |
|
||||
+| Preisdetailtiefe | Einzelpositionen, Sammelpositionen, reiner Gesamtpreis; Gebührentyp oder Empfänger kann ungeklärt bleiben |
|
||||
+| Preisaufschlag/Provision | Vermieterprovision, zusätzliche Gast-Servicegebühr, partnerkanalabhängiger Endpreisaufschlag – getrennt, sofern belegbar; auch kombinierte/unbekannte Position zulassen |
|
||||
+| Zahlungszuständigkeit | Eigener Einzug oder Portal/Paymentanbieter; Ratenstatus, Auszahlungsvorschau und Bankeingang getrennt |
|
||||
+| Stornobedingungen | Portalkonfiguration, beim Vertragsschluss nachweislich vereinbarter Stand, später übermitteltes eigenes Dokument trennen |
|
||||
+| Bearbeitungsmodus | automatisch / manuell / gemischt, nach einzelner Aktivität bzw. verfügbarem Feld; offene Klärungsaufgabe statt erfundene Daten |
|
||||
+| Nachweise | Zeitpunkt der Erfassung, ggf. Screenshot/Buchungsbestätigung, Zeitpunkt und Wirksamkeit einer Kalendersperre soweit nachgewiesen |
|
||||
+
|
||||
+**Keine freie Regel-Engine für MVP erforderlich.** Wenige Profilparameter sowie manuelle, nachvollziehbare Bearbeitungsschritte reichen zunächst. Die tatsächliche Informationstiefe kann **von Buchung zu Buchung** variieren, nicht nur pro Portal.
|
||||
+
|
||||
+### Konkrete Kanalprofile als gesonderte Referenzfälle
|
||||
+
|
||||
+- **FeWo-direkt (A4):** Eigene Miet-/Rabatt-/Stornokonfiguration im Portal; im Vermieterposteingang sind bei einer Buchung einzelne Summen, Zahlungsraten und erwartete Auszahlung ersichtlich, nicht notwendigerweise die Einzelpreiszerlegung. Eigener statischer Mietvertrag bislang nicht im Inserat hinterlegt. Angeblich/öffentlich angebotene Funktionen sind nicht automatisch im konkreten Betreiberkonto vorhanden.
|
||||
+- **Destination Solutions (A3):** Extern bereits verbindliche Buchung; danach vollständige Abwicklung beim Vermieter. **In aktuellem Betreiberzugang keine Kalendersynchronisation**; manuelle Portalsperrung mit begrenzter Nachweisbarkeit. Provision kann nach Vertriebskanal differieren; Gast-Serviceaufschlag, Preisaufschläge und vorvertragliche Anzeige der Stornobedingungen sind noch ungeklärt.
|
||||
+
|
||||
+Details: [K01 Preise & Abrechnung](K01_Preisstruktur_und_Abrechnung.md); [R08 Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md); [O00 offene Fragen](O00_Offene_Portalprueffaelle.md).
|
||||
--- basis/S00_Supportprozesse.md
|
||||
+++ v0.7/S00_Supportprozesse.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozesskatalog
|
||||
titel: Supportprozesse
|
||||
status: arbeitsstand
|
||||
-version: '0.6'
|
||||
+version: '0.7'
|
||||
---
|
||||
|
||||
# S00 – Supportprozesse (vorläufiger Katalog)
|
||||
@@ -25,3 +25,11 @@
|
||||
**Einordnung für den heutigen Produktumfang:** S01–S07 und S09 soweit für Buchungsabwicklung nötig; S08 schlank in P04/P05. V02-Marketing und Loyalty sind **Wertschöpfung** und nicht bloß allgemeine administrative Supportprozesse. Marketingfunktionen werden fachlich vorgesehen, aber nach dem Kernbuchungsprozess detailliert.
|
||||
|
||||
Einzelheiten folgen nach Freigabe der Gesamtprozesslandkarte. Keine zusätzlichen Organisations-/Oberflächenmodule aus dieser Tabelle ableiten.
|
||||
+
|
||||
+
|
||||
+## Präzisierung v0.7 (E-012 bis E-020)
|
||||
+
|
||||
+- **S01:** Portalprofil umfasst tatsächliche Datenschnittstelle (oder manuelle Schritte), Ausführungsverantwortung, Quellennachweis, Preis-/Storno-Verfügbarkeit und den Status nachgelagerter Vertriebskanäle, soweit relevant. Partnerherkunft ist **kein A6-Prozess**; nur kaufmännisches Merkmal bei Bedarf.
|
||||
+- **S02:** Kalenderverzögerung, manuelle Sperrung und fehlender Bestätigungsbeleg als reale Normalfälle. „Exportiert“ oder „im Portal eingetragen“ ist nicht gleich „partnernetzweit wirksam“.
|
||||
+- **S04/S07:** Kaufmännische **Einzel-, Sammel- und Gesamtbeträge** unterstützen; Gast-Servicegebühr, Vermieterprovision, Preisaufschlag, Rabatte, Zahlung und Auszahlung getrennt, soweit feststellbar. Unbekannte Zusammenhänge bleiben ungeklärt; manueller Abgleich möglich.
|
||||
+- **S05/S06:** unterschiedliche Vertragsvorlagen/Anlagen und Versionen je Buchungsprofil; manuelle Daten-/Dokumentenbeschaffung und Klärungsaufgaben ohne separate Portalsoftware-Workflows.
|
||||
--- basis/G00_Gates_und_Uebergaben.md
|
||||
+++ v0.7/G00_Gates_und_Uebergaben.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: gate-modell
|
||||
titel: Gate- und Übergabemodell
|
||||
status: arbeitsstand
|
||||
-version: '0.6'
|
||||
+version: '0.7'
|
||||
---
|
||||
|
||||
# G00 – Gate- und Übergabemodell (Arbeitsstand)
|
||||
@@ -41,3 +41,14 @@
|
||||
|
||||
## Noch offen
|
||||
Detailkriterien für das P05-Abschlussgate und die Detailbedingungen der Storno-/Abbruch-Ausgänge; konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
|
||||
+
|
||||
+
|
||||
+## Ergänzende Gates / Informationsbewertung v0.7 (E-013 bis E-020)
|
||||
+
|
||||
+- **G1/P01 – Externe Belegung:** Zeitpunkt und Quelle von Kalenderexport, manueller Sperre oder Meldung dokumentieren. **Veranlasst**, **im Zielportal beobachtet** und **in nachgelagerten Kanälen nachgewiesen** sind verschiedene Zustände; letzterer kann unbekannt bleiben.
|
||||
+- **G2/P02 – Konditionsstand:** Extern verbindlicher **Gastgesamt-/Mietpreis** kann hinreichend belegt sein, auch wenn Tages-/Einzelpreise fehlen. Portalkonfiguration, Buchungssnapshot, gastseitig tatsächlich vereinbarter Konditionsstand und nachträglich versandte Unterlagen getrennt. Fehlt ein für Vertragsdokumentation erforderlicher Beleg, nur die konkrete Tätigkeit zur Klärung vorsehen; bereits bindende Buchung nicht rückwirkend entwerten.
|
||||
+- **G3/P03 – Kaufmännische Teilinformationen:** Einzelposition, Sammelposten und Gesamtbetrag zulässig; Quelle, Betrag, Währung, zugeordneter Zahler/Empfänger (oder **ungeklärt**), Status und mögliche Doppelzählung prüfen. Gast-Mietforderung ≠ Gast-Portalservicegebühr ≠ Vermieterprovision ≠ Auszahlung. Aufklärung je Tätigkeit; fehlende Provisionsdetails blockieren beispielsweise nicht automatisch die Anreisevorbereitung.
|
||||
+- **G3/P03 – Zahlung:** **Fällig laut Zahlungsplan**, **laut Portal bezahlt**, **Auszahlung angekündigt** und **tatsächlicher Bankeingang** sind unabhängige Status. Widersprüchliche Portalwerte bleiben offen, nicht automatisch überschrieben.
|
||||
+- **X02/X04/X07:** Storno-/Änderungsantrag ist **kein** wirksames Ergebnis. Bei Belegungskonflikt Ursache, zeitliche Abfolge, Bindung beider Buchungen, belegte extern wirksame Sperren und verbleibende Handlungsmöglichkeiten erfassen; Verantwortlichkeit wird nicht aus einem einzigen Button abgeleitet.
|
||||
+
|
||||
+**Evidenzstatus je Datenpunkt:** `übermittelt / durch externe Quelle behauptet / anhand Beleg geprüft / intern erfasst / manuell ergänzt / nicht geliefert / widersprüchlich / nicht anwendbar`; als **fachliche Beispiele**, nicht als freigegebene technische Enum. `unbekannt` ist **nicht** `0` oder `nicht vorhanden`.
|
||||
--- basis/E00_Entscheidungsprotokoll.md
|
||||
+++ v0.7/E00_Entscheidungsprotokoll.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: entscheidungsprotokoll
|
||||
titel: Entscheidungsprotokoll
|
||||
status: arbeitsstand
|
||||
-version: '0.6'
|
||||
+version: '0.7'
|
||||
---
|
||||
|
||||
# E00 – Entscheidungsprotokoll
|
||||
@@ -40,3 +40,25 @@
|
||||
## Dokumentationsregel (Arbeitsvereinbarung)
|
||||
|
||||
Die bestehende Gitea-Dokumentation ist die führende Ablage. Es gibt **eine aktuelle Markdown-Datei je Thema**, P01–P05 dürfen jeweils mehrere Unterdokumente enthalten. Bei **neuen und fachlich aktualisierten Markdown-Dateien** einen knappen YAML-Header (`id`, `typ`, `titel`, `status`, `version`) verwenden. Bestehende Abschnitte bei Fortschreibungen nicht still kürzen oder löschen; fachliche Entscheidungen mit ID verknüpfen und Änderungen per Git-Diff kontrollieren. **Keine implizite Freigabe von Implementierung oder Go-live.**
|
||||
+
|
||||
+
|
||||
+## Ergänzende Beschlüsse und Prüfstände vom 31.10.2026 – Konsolidierung v0.7
|
||||
+
|
||||
+Die folgenden IDs ergänzen **E-001–E-011**. Betreiberangaben und die daraus fachlich bestätigten Regeln sind von ausstehenden Portal- und Rechtsprüfungen zu unterscheiden.
|
||||
+
|
||||
+| ID | Status | Festlegung |
|
||||
+|---|---|---|
|
||||
+| **E-012** | **Beschlossen** | **Genau fünf Buchungsarchetypen A1–A5**. Der zuvor verwendete A6-Eintrag („Hub/Partnervermittlung“) entfällt als Archetyp. Partnerherkunft ist nur als optionales kaufmännisches Merkmal zu erfassen, soweit sie etwa Provisionssatz oder Auswertungen beeinflusst; keine eigenständige Vermittlungskettenlogik. |
|
||||
+| **E-013** | **Beschlossen** | **Vertrags-/Dokumentenprofil je Vermieter/Objekt/Portal/Buchungsart**, inklusive unterschiedlicher Vorlagen und Anlagen, Versionierung und unverändertem Buchungs-/Konditionsstand. Nach externer Direktbuchung **keine zweite Annahme und keine einseitigen neuen Gastpflichten**. Die tatsächliche vorvertragliche Einbeziehung bleibt Prüffall. |
|
||||
+| **E-014** | **Beschlossen** | Die Informationsbeschaffung kann je Portal und Feld **automatisch, manuell oder gemischt** erfolgen. Fehlen Einzelbeträge, dürfen Buchungen mit **Gesamtpreis oder Sammelpositionen** bearbeitet werden; fehlende Daten sind ausdrücklich unbekannt, nicht null und nicht geschätzt. |
|
||||
+| **E-015** | **Beschlossen** | **Gast-Mietforderung, ggf. gesonderte Gast-Servicegebühr, Vermieterprovision/-gebühr, Zahlungsraten, Auszahlung und Rabatte** sind fachlich getrennte Sachverhalte, auch wenn ein Portal Beträge zusammenfasst. Flexible kaufmännische Positionen, spätere manuelle Zuordnung/Aufteilung, Nachweis und Differenzabgleich sind erforderlich; ursprüngliche Portalwerte bleiben erhalten. **Keine doppelte Zählung** zusammengefasster Teil- und Gesamtbeträge. |
|
||||
+| **E-016** | **Beschlossen / Referenzbetrieb** | **Destination Solutions = A3**, keine Ergänzung „A6“: bereits extern verbindliche Buchung, nachfolgende Vertrags-/Zahlungs-/Aufenthaltsabwicklung durch Vermieter. Partnerherkunft kann unterschiedliche **Vermittlerprovisionen zu Lasten des Vermieters** bewirken, aber **keine nachträgliche Belastung des Gastes**. Ob das Portal selbst eine zusätzliche Gastgebühr erhebt oder den Endpreis erhöht, bleibt ungeklärt. |
|
||||
+| **E-017** | **Bestätigte Betreiberangabe, Wirksamkeit ungeklärt** | Bei Destination Solutions ist folgende **sechsstufige Stornostaffel** genannt: mindestens 60 Tage vorher 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, 11 Tage oder weniger 100 % jeweils vom „Mietpreis“. **Nicht nachgewiesen** ist, ob diese Staffel im Portal bereits vor Buchung transparent gemacht und wirksam einbezogen wird; die Preisbasis („Mietpreis“) ist zu klären. |
|
||||
+| **E-018** | **Beschlossen / Risiko festgehalten** | **Externe Verfügbarkeit ist nicht allein durch korrekte Pflege des FewoPortal-Kalenders sicher**: FeWo-direkt importiert iCal nur zeitverzögert; beim verwendeten Destination-Solutions-Zugang erfolgt **manuelle Sperrung ohne bestätigtes Partnernetz-Sync und ohne verwertbaren Sperrbeleg**. Vorgang „Sperre veranlasst / Zielportal erkennbar / partnernetzweit wirksam“ getrennt; letzteren Zustand niemals ohne Nachweis behaupten. |
|
||||
+| **E-019** | **Beschlossen** | Buchungsänderung, Storno und Doppelbuchung sind **Teil-/Sonderprozesse derselben Akte**. Auslösende Ursache, Initiator, ausführender Akteur, Zuständigkeit, verbindliche Wirksamkeit sowie Kalender-/Vertrags-/Finanzfolgen getrennt führen. Technische Stornierung durch den Gast ersetzt nicht die wahrheitsgemäße Einordnung einer Vermieterursache; Fremdportalregelungen und Rechtslage fallbezogen prüfen. |
|
||||
+| **E-020** | **Beobachteter A4-Iststand** | In einer FeWo-direkt-Buchung sind **aggregierter Übernachtungspreis, Rabatt, Sammelgebühren, Gastgesamtbetrag, portalbezogener Abzug, Auszahlungsvorschau und Ratenstatus** einsehbar. **Nicht belegt** sind Einzelpreise, Gebührenzusammensetzung, durchgängige Exporte und alle tatsächlich vom Gast akzeptierten Unterlagen. Widersprüchliche Auszahlungsangaben bleiben offener Prüffall. |
|
||||
+| **E-021** | **Verbindliche Dokumentationsarbeitsregel** | **Vor jeder künftigen Dokumentänderung/Erweiterung die aktuell gültigen Originaldateien erneut explizit beim Betreiber anfordern**. Gitea bleibt führende Ablage; ältere lokale Chat-/ZIP-Kopien allein reichen für spätere Änderungen nicht. Änderungen ausschließlich auf bestätigter Basis, mit Versionsfortschreibung, Bestandsbewahrung, Diff und Quellvermerk. |
|
||||
+
|
||||
+**Nicht beschlossen:** Dass technische Portalprobleme automatisch rechtlich fehlendes Verschulden beweisen; dass eine 10-Minuten-Freigabe heute bei den genannten Portalen möglich ist; dass alle Portale gleiche Preis-/Gast-/Zahlungsdaten bereitstellen; dass nachträglich versandte Stornobedingungen wirksam werden. Solche Aussagen bleiben Prüffälle.
|
||||
+
|
||||
+**Weitere Fachkonzepte:** [Archetypen A1–A5](00_Buchungsarchetypen.md), [Portal-/Vertragsprofile](00_Portalprofile_und_Vertragsvorlagen.md), [Flexible kaufmännische Positionen](K01_Preisstruktur_und_Abrechnung.md), [Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md), [offene Portalprüffälle](O00_Offene_Portalprueffaelle.md).
|
||||
--- basis/00_Buchungsarchetypen.md
|
||||
+++ v0.7/00_Buchungsarchetypen.md
|
||||
@@ -3,15 +3,15 @@
|
||||
typ: archetypenkatalog
|
||||
titel: FewoPortal – Buchungsarchetypen und Verantwortungsübergaben
|
||||
status: diskussionsentwurf
|
||||
-version: "0.5"
|
||||
+version: "0.6"
|
||||
stand: 2026-10-31
|
||||
prozess: V01
|
||||
-bezugsstand_prozessarchitektur: "0.6"
|
||||
+bezugsstand_prozessarchitektur: "0.7"
|
||||
---
|
||||
|
||||
# A00 – Buchungsarchetypen und Verantwortungsübergaben
|
||||
|
||||
-> **Arbeitsstand für das Fachinterview, nicht abschließend freigegeben.** Grundlage: Betreiberbeschreibung vom 31.10.2026; Übergaben `UEBERGABE-BUCHUNGSPROZESS.md` (30.10.2026) und `crystalline-floating-glacier.md` (31.10.2026); Prozessarchitektur v0.6 und Szenario R01. **Bestätigte Geschäftsregeln, aktueller Praxisablauf, Annahmen und offene Fragen werden getrennt ausgewiesen.**
|
||||
+> **Arbeitsstand für das Fachinterview, nicht abschließend freigegeben.** Grundlage: Betreiberbeschreibung vom 31.10.2026; Übergaben `UEBERGABE-BUCHUNGSPROZESS.md` (30.10.2026) und `crystalline-floating-glacier.md` (31.10.2026); Prozessarchitektur v0.7 und Szenarien R01/R08. **Bestätigte Geschäftsregeln, aktueller Praxisablauf, Annahmen und offene Fragen werden getrennt ausgewiesen.**
|
||||
|
||||
## 1. Gemeinsamer Grundsatz
|
||||
|
||||
@@ -25,7 +25,7 @@
|
||||
|
||||
**Archetypen sind Geschäftskonstellationen, keine getrennt zu implementierenden Workflows.** Sie bestimmen die bei Eintritt bekannten Tatsachen, Zuständigkeiten, notwendigen Aktivitäten, Kommunikationswege und Nachweise. Dieselbe Buchungsakte und dieselben Fachfunktionen werden verwendet. Ein Portal kann einzelne Tätigkeiten durchführen; FewoPortal behält den konsolidierten Vorgangsüberblick, ohne fremde Primärnachweise vorzutäuschen.
|
||||
|
||||
-## 2. Katalog der sechs Archetypen
|
||||
+## 2. Katalog der fünf Archetypen
|
||||
|
||||
| ID | Geschäftskonstellation | Zustand beim Eingang | Vertragsunterlagen | Zahlung / Storno | Informationsbedarf |
|
||||
|---|---|---|---|---|---|
|
||||
@@ -34,9 +34,8 @@
|
||||
| **A3** | Externe Direktbuchung mit anschließender vollständiger Abwicklung durch uns | Bereits verbindliche Portalbuchung | Wir versenden Dokumentation der bestehenden Vereinbarung, **keine zweite Annahme** | Wir | Buchung, Portalpreis und Gastdaten übernehmen / ergänzen |
|
||||
| **A4** | Externe Direktbuchung mit **geteilter Abwicklung** (heutiger FeWo-direkt-Fall) | Bereits verbindliche Portalbuchung | Vertragsdokumentation durch uns ohne zweite Annahme | Zahlung über Portal; tatsächliche Storno-/Mahnverantwortung noch prüfen | Gastdaten, rechtsrelevante Konditionen, Portalstatus, lokale Abgaben |
|
||||
| **A5** | Externe Direktbuchung mit weitgehend vollständiger Portalabwicklung | Bereits verbindliche Portalbuchung | Durch Portal, soweit tatsächlich vereinbart | Durch Portal, soweit tatsächlich vereinbart | Für Vor-Ort-Betreuung und rechtliche Pflichten benötigte Daten und Status |
|
||||
-| **A6** | Portal / Buchungshub vermittelt über weitere Partnerportale | Abhängig vom zugrunde liegenden A2–A5 | Abhängig von Herkunft und Abwicklungsmodell | Abhängig von Herkunft und Abwicklungsmodell | **Eingangskanal**, **tatsächliche Herkunft** und **Abwicklungsverantwortung** getrennt erfassen |
|
||||
|
||||
-**Modellierungshinweis:** A6 ist ein **zusätzliches Herkunfts- und Vermittlungsmerkmal**, kein eigener alternativer Lebenszyklus. „Manuell/telefonisch“ ist ein **Eingangskanal** und kann insbesondere bei A1/A2 verwendet werden. Eine reine Eigenbelegung/Sperrzeit ist ein angrenzender Belegungsfall, **kein siebter Buchungsarchetyp**.
|
||||
+**Modellierungshinweis (E-012):** Die ehemalige Kennung **A6 wurde ausdrücklich gestrichen**; Partnervertrieb ist allenfalls ein optionales kaufmännisches Herkunftsmerkmal. „Manuell/telefonisch“ ist ein **Eingangskanal** und kann insbesondere bei A1/A2 verwendet werden. Eine reine Eigenbelegung/Sperrzeit ist ein angrenzender Belegungsfall, **kein weiterer Buchungsarchetyp**.
|
||||
|
||||
## 3. Gegenüberstellung entlang des generischen Prozesses
|
||||
|
||||
@@ -48,7 +47,7 @@
|
||||
| **P04 Leistung** | Anreise, lokale Pflichten, Aufenthalt, Abreise | Wie A1 | Wie A1 | Wie A1, zuvor Gastinformationen nachfordern | Wie A1, soweit wir vor Ort verantwortlich sind |
|
||||
| **P05 Abschluss** | Aufenthalt, Feedback, offene Fälle übergeben | Wie A1 | Wie A1 | Wie A1, ggf. offener Portal-Auszahlungs-/Stornofall | Lokale Erfüllung abschließen, relevante Portal-Ergebnisse erfassen |
|
||||
|
||||
-**A6** wird auf die zutreffende Spalte gelegt; die Herkunft kann Konditionen, Pflichten und Kommunikationswege beeinflussen. Phasen können sich zeitlich überlappen; eine bereits extern verbindliche Buchung darf nicht durch offene Stammdaten künstlich unverbindlich werden.
|
||||
+Die Partnerherkunft begründet **keinen sechsten Archetyp**; sie wird nur bei relevantem Einfluss auf die Vermittlerprovision oder notwendige Auswertung erfasst. Phasen können sich zeitlich überlappen; eine bereits extern verbindliche Buchung darf nicht durch offene Stammdaten künstlich unverbindlich werden.
|
||||
|
||||
## 4. Gemeinsame Informations- und Übergabegates
|
||||
|
||||
@@ -121,7 +120,7 @@
|
||||
|
||||
Die vom Betreiber bereitgestellte vierseitige FeWo-direkt-Vertragsvorlage wurde unter [A04 – Vertragsvorlage und Prozessanalyse](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md) gesondert bewertet. Besonders prüfbedürftig sind: Verbindlichkeit vor dem nachträglichen Vertragsversand (§ 5), zuvor einbezogene Konditionen, Preis-/Gebührentrennung (§ 4), Portalstorno gegenüber eigener Stornoklausel (§ 13), Datenbedarf sowie sichere Trennung von Vertragsdokument und Zugangs-/Anreiseinformationen. **Keine Änderung der Betreibervertragsklauseln ohne gesonderte rechtliche und fachliche Freigabe.**
|
||||
|
||||
-**Status dieses Dokuments:** Sechs Betreiber-Archetypen strukturiert, aber nicht als vollständige oder rechtlich validierte Portalprofile freigegeben. Nächster Fachschritt: **A4 als vollständigen Ist-/Soll-Ablauf durchspielen**, einschließlich Vertrag, Zahlung, Gastdaten und Storno; anschließend A3 und A5 dagegenlegen.
|
||||
+**Status dieses Dokuments:** Fünf Archetypen (A1–A5) nach E-012; Portalprofile und rechtliche Detailfragen bleiben offen. Neben FeWo-direkt (A4) ist Destination Solutions (A3) dokumentierter Praxisfall.
|
||||
|
||||
## 10. A4-Praxisnachweis aus FeWo-direkt-Ansichten (31.10.2026)
|
||||
|
||||
@@ -130,6 +129,20 @@
|
||||
**Portalinvariante:** Verantwortlichkeit für Zahlung oder Kommunikation, Portalstatus und tatsächlicher Erfüllungsnachweis sind getrennt zu verwalten.
|
||||
|
||||
|
||||
-## 9. Änderungs- und Stornoereignisse (portalunabhängig)
|
||||
+## 11. Änderungs- und Stornoereignisse (portalunabhängig)
|
||||
|
||||
Ein Storno bzw. eine Buchungsänderung ist ein **Teilprozess auf derselben Buchungsakte**, kein zusätzlicher Archetyp. Die fachliche Ursache (Gastwunsch, Unmöglichkeit beim Vermieter, Doppelbuchung, Regelverstoß, technischer Fehler), der Initiator, der ausführende Beteiligte und die Abwicklungsverantwortung sind voneinander zu unterscheiden. Anfrage, Bestätigung und tatsächliche Wirksamkeit sind getrennte Ereigniszustände. Kalender, Konditionen, Vertrag und Zahlungen werden erst nach ausreichend belegter Wirksamkeit angepasst. Eine durch den Vermieter verursachte Stornierung darf nicht durch Aufforderung an den Gast als Gaststorno umetikettiert werden. **FeWo-direkt** ist dafür ein dokumentiertes Portalbeispiel (siehe [A04 Abschnitt 8](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md)); andere Portale können abweichende Wege, Daten und Zuständigkeiten haben.
|
||||
+
|
||||
+
|
||||
+## 12. Destination Solutions als Praxisreferenz A3 (E-012/E-016/E-017/E-018)
|
||||
+
|
||||
+- **Verbindlicher Buchungseingang**, vollständige weitere Vertrags-, Gäste-, Zahlungs- und Aufenthaltsabwicklung beim Vermieter; keine zweite Angebotsannahme. Der Vermieter erhält laut Betreiber eine vollständige Buchungsmeldung für seine Abwicklung, **nicht zwingend eine vollständige Einzelpreis- oder Gebührenzerlegung**.
|
||||
+- **Keine im genutzten Zugang funktionierende automatische Kalendersynchronisation**; manuelles Blockieren anderer Portale. Ein Portalbeleg über den Zeitpunkt oder die wirksame Verteilung an Partnerkanäle steht nach Betreibererfahrung nicht zur Verfügung.
|
||||
+- **Vermittlerprovisionen** können nach Vertriebskanal variieren. Sie sind nicht nachträglich vom Gast zu fordern. Ob zusätzlich ein direkter Gast-Aufschlag/Serviceentgelt oder Partner-Endpreisaufschlag existiert, muss beim Anbieter und anhand einer Gastbestätigung geprüft werden.
|
||||
+- **Stornostaffel** vom Betreiber angegeben: ≥60 Tage 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, ≤11 Tage 100 % vom „Mietpreis“; **vorvertragliche Einbeziehung, Berechnungsbasis und rechtliche Wirksamkeit offen**.
|
||||
+
|
||||
+Siehe [R08 Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md) und [O00 Offene Portalprüffälle](O00_Offene_Portalprueffaelle.md).
|
||||
+
|
||||
+## 13. Portaldaten können unterschiedlich detailliert und zusammengesetzt sein (E-014/E-015)
|
||||
+
|
||||
+Bei A2–A5 sind **automatische, manuelle und hybride** Informationen und Tätigkeiten gleichwertig zu modellieren. Pro Buchung sind vollständig aufgeschlüsselte Positionen, **kombinierte Service-/Gebührenpositionen**, bloße Gesamtbeträge sowie nur teilweise verfügbare Zahlungsauszüge möglich. Keine fiktive Zerlegung des Gesamtpreises; unbekannte Gebührenarten, Zahlende/Empfänger und Provisionsanteile bleiben offen. Nachträgliche Zuordnung oder Aufteilung erhält den originalen Portalbetrag und verhindert doppelte Summierung. Fehlende rein interne Kostenanalyse blockiert nicht ohne Weiteres den vertraglichen Aufenthalt. Siehe [K01](K01_Preisstruktur_und_Abrechnung.md).
|
||||
--- basis/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md
|
||||
+++ v0.7/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessanalyse
|
||||
titel: FeWo-direkt – Vertragsvorlage und Einordnung in den A4-Istprozess
|
||||
status: diskussionsentwurf
|
||||
-version: "0.4"
|
||||
+version: "0.5"
|
||||
stand: 2026-10-31
|
||||
prozess: V01
|
||||
archetyp: A4
|
||||
@@ -157,3 +157,14 @@
|
||||
- https://hilfe.fewo-direkt.de/articles/Accept-or-decline-a-guest-s-change-request
|
||||
- https://hilfe.fewo-direkt.de/articles/Die-Reservierung-eines-Gastes-stornieren
|
||||
- https://www.fewo-direkt.de/tlp/trust-and-safety/partner-initiated-cancellation-policy
|
||||
+
|
||||
+
|
||||
+## 9. Einordnung nach Gesamt-Konsolidierung v0.7
|
||||
+
|
||||
+1. **A4 bleibt realer Praxisfall**, nicht Muster für alle Portale. FeWo-direkt zeigt in einer Buchung im Posteingang Zahlungsplan, einige aggregierte Preisbestandteile, Gäste-Gesamtzahlung, Abzug und erwartete Auszahlung; eine lückenlose Einzelpreis-/Gebührentransparenz und eine konsistente Auszahlungsübersicht sind weiter **nicht nachgewiesen**. Das frühere pauschale Urteil „keinerlei Zahlungsdaten“ ist überholt; konkrete Screenshots in Abschnitt 7 sind maßgeblich.
|
||||
+2. **Ical-Verzögerung:** Direkte Buchung kann vor Verarbeitung einer anderswo veranlassten Blockierung verbindlich werden. FewoPortal darf eigene erfolgreiche Exporte nicht als Portal- oder Partnernetzbestätigung behandeln. Die Idee eines 10-Minuten-Freigabefensters ist **kein aktuell verfügbarer A4-Prozess**.
|
||||
+3. **Vertragsdokumente:** Der eigene vierseitige Vertrag wird bisher nach der Portalbuchung versandt und ist nicht als statisches PDF in FeWo-direkt hinterlegt; Inhalt der dem Gast vor/bei Buchung gezeigten Bedingungen bleibt zu verifizieren. Statische allgemeine Bedingungen von individuellen Preis-/Zahlungsdetails trennen; keine still nachgeschobenen Verpflichtungen.
|
||||
+4. **Sonderprozesse:** Bisher keine konkret selbst durchlaufene FeWo-direkt-Buchungsänderung und keine eigene Vermieterstornierung. Kein nicht erprobtes Verfahren als gelebte Praxis behaupten. Differenzierung **tatsächliche Stornoursache, Antragsteller, ausführender Beteiligter** beachten.
|
||||
+5. **Abrechnung:** Unbekannte Gast-Servicegebühren, Portalabzüge, Vermieterprovisionen oder kombinierte Sammelpositionen müssen nicht künstlich zerlegt werden. Portalinformationen und manuelle Ergänzungen mit Quelle sichern; bei abweichenden Summen Klärungsaufgabe.
|
||||
+
|
||||
+Fachliche Konkretisierung: [K01](K01_Preisstruktur_und_Abrechnung.md), [X01](X01_Belegungskonflikte_und_Sperrnachweise.md) und [O00](O00_Offene_Portalprueffaelle.md). Keine Aktualisierung oder juristische Freigabe des ursprünglichen PDF-Vertrags durch diese Analyse.
|
||||
--- basis/README.md
|
||||
+++ v0.7/README.md
|
||||
@@ -3,15 +3,15 @@
|
||||
typ: projektindex
|
||||
titel: FewoPortal Prozessarchitektur
|
||||
status: arbeitsstand
|
||||
-version: '0.6'
|
||||
+version: '0.7'
|
||||
---
|
||||
|
||||
-# FewoPortal – Prozessarchitektur v0.6
|
||||
+# FewoPortal – Prozessarchitektur v0.7
|
||||
|
||||
**Status:** Fachlicher Arbeitsstand / Interview, keine Implementierungsfreigabe
|
||||
**Stand:** 31.10.2026
|
||||
|
||||
-Diese Version führt den konsolidierten Stand v0.5 mit **E-011 (alternative fachliche Prozessausgänge)** fort und bewahrt die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die Entscheidungen E-001 bis E-010 sowie die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
|
||||
+Diese Konsolidierung führt die Version v0.6 mit **E-011 (alternative fachliche Prozessausgänge)** fort und bewahrt die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die Entscheidungen E-001 bis E-010 sowie die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
|
||||
|
||||
## Dateien
|
||||
|
||||
@@ -24,3 +24,25 @@
|
||||
**Quellen:** `crystalline-floating-glacier.md`, `UEBERGABE-BUCHUNGSPROZESS.md`, Gesamtprozess v0.3 und die Betreiberpräzisierung vom 31.10.2026. Weitere Fach- und Rechtsprüfung erforderlich.
|
||||
|
||||
**Arbeitsregel:** Nur ausdrücklich beschlossene Punkte als Entscheidung kennzeichnen; Vorschläge als solche markieren. Jede Datei trägt einen YAML-Header mit `id`, `typ`, `titel`, `status`, `version`. Die Version v0.5 bezeichnet den konsolidierten **Dokumentationsstand**, nicht eine Implementierungsversion. Bestehende Inhalte werden nicht stillschweigend gekürzt. Änderungen an Gitea erfolgen erst nach Abgleich mit dem dortigen Stand. Keine automatischen Änderungen am produktiven System.
|
||||
+
|
||||
+
|
||||
+## Konsolidierung v0.7 (31.10.2026)
|
||||
+
|
||||
+**Wichtige Entscheidung E-012:** Fünf Buchungsarchetypen **A1–A5**, **A6 gestrichen**. Referenzportale: Destination Solutions = **A3**, FeWo-direkt = **A4**. Ein generischer V01-Buchungsprozess mit variabler Aktivitäts- und Informationslage; keine separaten Portalworkflows.
|
||||
+
|
||||
+**Neue Anforderungen:** Portal-/Dokumentenprofile, versionierter Vertrags-/Konditionsnachweis, manuelle/automatische/gemischte Datenbeschaffung, flexible Einzel- und Sammelpreise, unbekannte Gastgebühr/Provision ohne Scheingenauigkeit, Abstimmung Zahlungsplan vs. tatsächliche Auszahlung, unsichere Kalender-/Sperrnachweise und Änderungs-/Stornoteilprozesse. Externe Direktbuchungen werden nicht durch neues Eigenangebot ersetzt. Rechtlich ungeklärte Portal- und Stornokonditionen bleiben offene Prüffälle.
|
||||
+
|
||||
+**Neue bzw. fortgeschriebene Dateien:**
|
||||
+
|
||||
+- [`00_Buchungsarchetypen.md`](00_Buchungsarchetypen.md) – A1–A5 und reale Referenzfälle
|
||||
+- [`00_Portalprofile_und_Vertragsvorlagen.md`](00_Portalprofile_und_Vertragsvorlagen.md) – Profile und Vertragstypen
|
||||
+- [`K01_Preisstruktur_und_Abrechnung.md`](K01_Preisstruktur_und_Abrechnung.md) – Einzel-/Sammel-/Gesamtbeträge, Provisionen, Zahlungsfluss
|
||||
+- [`A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md`](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md) – konkrete A4-Beobachtungen und rechtliche Prüffragen
|
||||
+- [`R00_Szenarien/R01_Eigene_Webseite.md`](R00_Szenarien/R01_Eigene_Webseite.md) – früherer Referenzentwurf, **inhaltlich unverändert**
|
||||
+- [`R00_Szenarien/R08_Destination_Solutions.md`](R00_Szenarien/R08_Destination_Solutions.md) – A3 Referenzfall
|
||||
+- [`X01_Belegungskonflikte_und_Sperrnachweise.md`](X01_Belegungskonflikte_und_Sperrnachweise.md) – X07-Vertiefung
|
||||
+- [`O00_Offene_Portalprueffaelle.md`](O00_Offene_Portalprueffaelle.md) – spätere Konfigurations- und Nachweispunkte
|
||||
+- [`D00_Dokumentationsregel_und_Uebergabe.md`](D00_Dokumentationsregel_und_Uebergabe.md) – **Pflicht zur erneuten Dokumentenanforderung vor jedem zukünftigen Edit**
|
||||
+- [`E00_Entscheidungsprotokoll.md`](E00_Entscheidungsprotokoll.md) – Beschlüsse E-012–E-021
|
||||
+
|
||||
+**Quellenintegrität:** v0.6 aus dem originalen ZIP extrahiert, da die entpackte v0.6-Verzeichnisansicht P01–P05 nicht enthielt; ergänzende Dokumente aus ihrem jeweils neuesten im Chat verfügbaren Bearbeitungsstand. **Kein direkter Schreibzugriff auf Gitea; keine Repository-Aktualisierung behauptet.** Vor jeder künftigen Änderung aktuelle Quelldokumente erneut vom Betreiber anfordern.
|
||||
--- basis/00_Prozesslandkarte.md
|
||||
+++ v0.7/00_Prozesslandkarte.md
|
||||
@@ -3,10 +3,10 @@
|
||||
typ: prozesslandkarte
|
||||
titel: FewoPortal – Prozesslandkarte
|
||||
status: arbeitsstand
|
||||
-version: '0.6'
|
||||
+version: '0.7'
|
||||
---
|
||||
|
||||
-# 00 – Prozesslandkarte FewoPortal v0.6
|
||||
+# 00 – Prozesslandkarte FewoPortal v0.7
|
||||
|
||||
**Status:** gemeinsamer Arbeitsstand; übergreifendes Modell, nicht vollständig freigegeben.
|
||||
**Stand:** 31.10.2026
|
||||
@@ -111,3 +111,18 @@
|
||||
5. Pro Kanal tatsächlicher Verbindlichkeitsnachweis, Datenlage und Portalbestimmungen.
|
||||
|
||||
Die detaillierte Umsetzung erfolgt erst nach Abstimmung der Prozesslandkarte.
|
||||
+
|
||||
+
|
||||
+## H. Konkretisierung v0.7: Portalneutralität, Informationslücken und Verantwortlichkeit
|
||||
+
|
||||
+**A1–A5 (E-012):** Nur die tatsächliche Buchungs- und Abwicklungsverantwortung klassifiziert den Archetyp. Der bisherige A6-Eintrag entfällt; Herkunft/Partnervertrieb ist bei Bedarf eine separate **kaufmännische Metainformation**, keine eigene Prozessvariante. Referenzfälle: **FeWo-direkt A4**, **Destination Solutions A3**. Der identische V01-Prozess durchläuft dieselben fachlichen Phasen/Gates, Aktivitäten können je Profil extern/intern oder manuell/automatisch erfolgen.
|
||||
+
|
||||
+**Fünf unabhängige Dimensionen je Buchung:** (1) rechtlicher Bindungs-/Konditionsnachweis, (2) operative Zuständigkeit, (3) technische Datenquelle/Übermittlungsweg und Verfügbarkeit, (4) preisliche Detailtiefe bzw. Zuordnungsgrad, (5) tatsächliche Nachweisqualität. Aus „Portal zuständig“ folgt weder „erledigt“ noch „nachgewiesen“.
|
||||
+
|
||||
+**Kaufmännischer Grundsatz (E-014/E-015):** Das Portal kann Einzelposten, Teilaggregationen, Gesamtpreise, unbekannte Gebührenmischungen oder widersprüchliche Auszahlungsansichten liefern. FewoPortal darf den verbindlichen Gastpreis bei externer Buchung nicht durch Eigenkalkulation ersetzen, keine unbekannten Einzelposten erfinden und keine Vermittlerprovision ohne Vereinbarung dem Gast nachberechnen. Eine manuelle Klärung kann ergänzen; ursprüngliche Rohdaten bleiben erhalten.
|
||||
+
|
||||
+**Verfügbarkeit (E-018):** Keine generelle Aussage, dass alle Vertriebskanäle synchron oder endgültig gesperrt sind. Manuell oder zeitversetzt übertragenes Blockieren ist kein Nachweis partnernetzweiter Wirksamkeit. Sofort bestätigte externe Doppelbuchungen bleiben wirksame **Konfliktfälle**, nicht automatisch ablehnbare Anfragen. Eine vorgeschlagene Livefreigabe/10-Minuten-Karenz ist derzeit nur **optionales Zukunfts-/Integrationskonzept**, kein Ist-Ablauf.
|
||||
+
|
||||
+**Nachträgliche Ereignisse (E-019):** Änderungsanfrage, bestätigte Änderung, Stornierungswunsch und wirksame Stornierung unterscheiden. Ursache, Durchführender, vertragliche Folgen, Belegung und Geldflüsse getrennt dokumentieren.
|
||||
+
|
||||
+**Zu vertiefen:** [K01 Preis- und Abrechnungsmodell](K01_Preisstruktur_und_Abrechnung.md), [X01 Belegungskonflikt- und Sperrnachweise](X01_Belegungskonflikte_und_Sperrnachweise.md), [O00 offene Portalfragen](O00_Offene_Portalprueffaelle.md).
|
||||
--- basis/P05/P05_Abschluss_und_Nachbereitung.md
|
||||
+++ v0.7/P05/P05_Abschluss_und_Nachbereitung.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Abschluss und Nachbereitung
|
||||
status: entwurf
|
||||
-version: '0.6'
|
||||
+version: '0.7'
|
||||
---
|
||||
|
||||
# P05 – Abschluss und Nachbereitung
|
||||
@@ -28,3 +28,8 @@
|
||||
|
||||
## Noch offen
|
||||
Genaue Abschlusskriterien und erforderliche Nachweise; Zuständigkeit und Verknüpfung nachlaufender Folgeprozesse; Objektbereitstellung und Abgrenzung zum Folgeaufenthalt; alternativer Ausgang bei Stornierung oder abgebrochenem Vorgang. **Ob die technische Buchungsakte geschlossen wird oder nur der V01-Prozessstatus wechselt, ist nicht entschieden.**
|
||||
+
|
||||
+
|
||||
+## Ergänzung v0.7: Abrechnung und Nachweislücken
|
||||
+
|
||||
+Eine Buchung darf nach erbrachter Leistung fachlich regulär enden, selbst wenn **Provisionsaufschlüsselung, ausstehende Auszahlung oder ungeklärte Sammelgebühren** in einem gesondert zugewiesenen Folgefall weiterbearbeitet werden. Gastbezogene offene Forderungen, Storno- oder Auszahlungsdifferenzen müssen mit Quelle, Verantwortlichem und Buchungsreferenz nachvollziehbar übergeben werden. Fehlende detaillierte Preisaufteilung ist nicht automatisch eine unvollständige Gastleistung.
|
||||
--- basis/P03/P03_Buchungsverwaltung_und_Abwicklung.md
|
||||
+++ v0.7/P03/P03_Buchungsverwaltung_und_Abwicklung.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Buchungsverwaltung und kaufmännische Abwicklung
|
||||
status: entwurf
|
||||
-version: '0.6'
|
||||
+version: '0.7'
|
||||
---
|
||||
|
||||
# P03 – Buchungsverwaltung und kaufmännische Abwicklung
|
||||
@@ -26,3 +26,16 @@
|
||||
|
||||
## Noch offen
|
||||
Mindestdaten je Portalprofil, eigene versus externe Zahlungsstände, Reconciliation, Übergänge zum Abschluss.
|
||||
+
|
||||
+
|
||||
+## Flexible Preis- und Zahlungsbearbeitung v0.7
|
||||
+
|
||||
+1. Übernommene Positionen **unverändert mit Quelle** speichern: Einzelpositionen, Misch-/Sammelbeträge oder nur verbindlichen Gesamtbetrag. Fehlende Details nicht als 0 interpretieren.
|
||||
+2. **Preis-/Kostenbeziehungen** unterscheiden: Gast ↔ Vermieter (Mietforderung und enthaltene Leistungen); Gast ↔ Portal (mögliche eigene Servicegebühr); Vermieter ↔ Portal (Provision/Servicekosten); Zahlungen, Rückerstattungen und spätere Auszahlungen jeweils separat.
|
||||
+3. **Manuelle Ergänzung und Aufteilung** ermöglichen (auch ohne Portal-API): originalen Sammelbetrag erhalten, abgeleitete Teilpositionen zuordnen, Summen abstimmen, doppelte Zählung verhindern. Nicht bekannte Debitoren/Kreditoren, Rabattbezüge und Gebührenarten als **ungeklärt** führen.
|
||||
+4. **Zahlungsstände** trennen: Gast-Fälligkeit, portalbestätigte Gastzahlung, Auszahlungsvorschau, tatsächlicher Geldeingang, Abweichung/Erstattung. Widersprüche als Klärung auf derselben Buchungsakte, nicht heimlich mit Eigenkalkulation ausgleichen.
|
||||
+5. **Pflicht nur je Tätigkeit:** Fehlt für eine von uns zu stellende Rechnung die rechtlich nötige Aufschlüsselung, Klärungsaktivität einplanen. Fehlende reine Vermieter-Kostenanalytik darf Anreise oder andere unabhängige Schritte nicht grundsätzlich sperren.
|
||||
+6. **Destination Solutions A3:** Vermieter führt Vertrag, Zahlungsanforderung, Zahlungskontrolle und ggf. Stornobearbeitung; Höhe der Vermittlerprovision je Herkunft unterschiedlich möglich. Keine zusätzliche Provisionsrechnung an den Gast ohne vorbestehende Vereinbarung.
|
||||
+7. **FeWo-direkt A4:** Sichtbarer Gastzahlungsplan und erwartete Auszahlung ersetzen weder den Beleg über Bankeingang noch vollständige Gebührenaufschlüsselung; siehe konkrete A4-Screenshots und offenen 5,51-€-Differenzfall.
|
||||
+
|
||||
+[Vertiefung: K01](../K01_Preisstruktur_und_Abrechnung.md).
|
||||
--- basis/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
|
||||
+++ v0.7/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Buchungseingang und Verfügbarkeitssicherung
|
||||
status: entwurf
|
||||
-version: '0.6'
|
||||
+version: '0.7'
|
||||
---
|
||||
|
||||
# P01 – Buchungseingang und Verfügbarkeitssicherung
|
||||
@@ -29,3 +29,13 @@
|
||||
|
||||
## Noch offen
|
||||
Mindestfelder nach Eingangstyp, Übergaberegeln für unklare iCal-Ereignisse, Konfliktverhalten, genaue Hold- und Kalenderregeln.
|
||||
+
|
||||
+
|
||||
+## Praxisfälle und Aktivitätsvarianten v0.7
|
||||
+
|
||||
+- **FeWo-direkt (A4):** Sofortbuchung kann während verzögertem iCal-Abgleich entstehen. Portal-Verfügbarkeitsstatus darf nicht als Echtzeitgarantie dargestellt werden; eigenes Sync-Ereignis, Zeitpunkt des Abrufs und bekannte Konflikte festhalten.
|
||||
+- **Destination Solutions (A3):** Im konkret genutzten Zugang **keine aktive Kalender-Synchronisation** laut Betreiber; externe neue Buchung kommt bereits verbindlich an. Andere Vertriebskanäle müssen im Portal **manuell blockiert** werden; nachgelagerter Partnervertrieb kann weitere Verzögerungen verursachen. Eigene protokollierte Aufgabe mit Zeitpunkt, Bearbeiter, Portalanzeige/Screenshot (wenn möglich) – keine Behauptung, der Portalserver habe eine rechtzeitige Übernahme quittiert.
|
||||
+- **Portalunabhängig:** Art des Belegungs-Inputs (iCal, API, E-Mail, manuell), Ausführungspfad (automatisch/manuell/hybrid), Verzögerung/Unsicherheit und Kontrollmöglichkeiten im Portalprofil hinterlegen. Neue, extern **bereits verbindliche** Kollisionsbuchung als Konflikt behandeln; keine stillschweigende Ablehnung oder Löschung.
|
||||
+- **Drei Sperrzustände:** `Sperrung veranlasst`, `im Zielportal sichtbar`, `nachweislich im relevanten Vertrieb wirksam`. Fehlender Nachweis bleibt **unbekannt**. Für eigene Holds eigene atomare Freihaltung und Sicherung des bindenden Angebots prüfen, ohne fremde Echtzeitwirkung zu versprechen.
|
||||
+
|
||||
+Siehe [X01 – Konfliktmanagement und Nachweise](../X01_Belegungskonflikte_und_Sperrnachweise.md).
|
||||
--- basis/R00_Szenarien/00_Szenariomatrix.md
|
||||
+++ v0.7/R00_Szenarien/00_Szenariomatrix.md
|
||||
@@ -4,7 +4,7 @@
|
||||
titel: Buchungsszenarien und Vergleichsfälle
|
||||
autor: FewoPortal Fachinterview
|
||||
status: diskussionsentwurf
|
||||
-version: '0.1'
|
||||
+version: '0.2'
|
||||
---
|
||||
|
||||
# R00 – Buchungsszenarien und Vergleichsfälle
|
||||
@@ -18,7 +18,12 @@
|
||||
| R03 | Unverbindliche Portalanfrage | Portal-Anfrage → eigenes Angebot → Annahme | Fehlende Gastdaten, Portal-Kommunikation | Vorgemerkt |
|
||||
| R04 | Verbindliche Portalbuchung, Vertrag durch uns | Bereits extern verbindlich | Externer bindender Preis, nachträgliche Vertragsdokumentation ohne erneute Annahme, Zahlung je Portal | Vorgemerkt |
|
||||
| R05 | Portal wickelt verbindliche Buchung vollständig ab | Bereits extern verbindlich | Lokale Leistung und notwendige Informationen, Portal für Vertrag/Zahlung/Mahnung/Storno zuständig | Vorgemerkt |
|
||||
-| R06 | Hub/Partnerportal | Je Herkunft Anfragen oder Direktbuchungen | Herkunftserkennung bestimmt Profil | Vorgemerkt |
|
||||
+| R06 | (Historisch) Hub-/Partnervermittlung | Kein eigener Buchungsprozess; A1–A5 richten sich nach Bindung/Abwicklungszuständigkeit | Herkunft allenfalls für Provision/Auswertung relevant | Als separates Szenario nicht weiterführen (E-012) |
|
||||
| R07 | Eigenbelegung/Sperre | Keine Gastbuchung | Belegungsmanagement ohne Gästeakte | Angrenzender Fall, kein vollständiger V01-Buchungsweg |
|
||||
|
||||
**Quellen:** Ausgangsdokumente vom 30./31.10.2026 und Entscheidungsstand der Prozessarchitektur v0.6. Die Bearbeitungsstände beziehen sich auf das Fachinterview, nicht auf die Implementierung.
|
||||
+
|
||||
+
|
||||
+## Ergänzung v0.2: Externe Direktbuchung
|
||||
+
|
||||
+**R08 – Destination Solutions (A3):** Bereits verbindliche Buchung, danach Vertrags-/Zahlungs-/Gastabwicklung durch Vermieter; manuelle Sperre externer Kalender, kein belegter Partner-Sync; unterschiedliche Vermittlerprovisionen je Kanal, zusätzliche Gastgebühren und einzelne Preispositionen derzeit unklar. **A6 entfällt** als Archetyp. [R08 Referenzfall](R08_Destination_Solutions.md).
|
||||
--- basis/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
|
||||
+++ v0.7/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Leistungsvorbereitung und Aufenthalt
|
||||
status: entwurf
|
||||
-version: '0.6'
|
||||
+version: '0.7'
|
||||
---
|
||||
|
||||
# P04 – Leistungsvorbereitung und Aufenthalt
|
||||
@@ -25,3 +25,8 @@
|
||||
|
||||
## Noch offen
|
||||
Ob die Organisation des Objektbetriebs vollständig als Supportprozess geführt wird; örtliche Anforderungen; Übergabe- und Eskalationsstandards.
|
||||
+
|
||||
+
|
||||
+## Ergänzung v0.7: externe Kommunikationszuständigkeit
|
||||
+
|
||||
+Bei Portal-Direktbuchungen unterscheiden: Portal kündigt Gastnachricht an, Portalversand ist tatsächlich bestätigt oder Vermieter versendet eigene Informationen. FeWo-direkt kündigt in der gezeigten Buchung eine E-Mail etwa 72 Stunden vor Anreise an; dies ist **noch kein Nachweis**, dass sie dem Gast zugegangen ist. Falls erforderliche Gäste-/Meldedaten fehlen, manuell nachfordern. Bei Destination Solutions führt Vermieter die Gast- und Dienstleisterkommunikation im Rahmen der eigenen Abwicklung.
|
||||
--- basis/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
|
||||
+++ v0.7/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Konditionen und Buchungsverbindlichkeit
|
||||
status: entwurf
|
||||
-version: '0.6'
|
||||
+version: '0.7'
|
||||
---
|
||||
|
||||
# P02 – Konditionen und Buchungsverbindlichkeit
|
||||
@@ -49,3 +49,13 @@
|
||||
- [§ 148 BGB – Bestimmung einer Annahmefrist](https://www.gesetze-im-internet.de/bgb/__148.html)
|
||||
- [§ 150 BGB – verspätete und abändernde Annahme](https://www.gesetze-im-internet.de/bgb/__150.html)
|
||||
- [§ 312j BGB – Besonderheiten im elektronischen Geschäftsverkehr](https://www.gesetze-im-internet.de/bgb/__312j.html)
|
||||
+
|
||||
+
|
||||
+## Konditions- und Vertragsprofile v0.7
|
||||
+
|
||||
+- **Kanalabhängige Vorlagen:** Für A1/A2 bindendes Angebot einschließlich wirksam zur Kenntnis gegebener Bedingungen; für A3/A4 Dokumentation bereits extern abgeschlossener Buchung; für A5 nur die zur eigenen Tätigkeit nötigen Unterlagen. Vorlagen/Anlagen je Vermieter, Objekt, Portal und Buchungstyp unterscheiden, Version + verwendeten Konditionsstand aufbewahren.
|
||||
+- **Extern verbindliche Preisgrundlage:** Der bestätigte Gastpreis kann lediglich **als Gesamtbetrag** vorliegen. Dies ist kein Grund, Tagespreise oder einzelne Gebühren zu erfinden. Vom Portal selbst erhobene Gast-Servicegebühren und Vermieterprovisionen können davon abweichen und separat oder nur aggregiert bekannt sein.
|
||||
+- **Vorvertragliche Einbeziehung:** Ob dem Gast vor Abschluss Stornostaffeln, Pflichtgebühren und sonstige Bedingungen angezeigt wurden, ist je Portal zu prüfen; ein nachträgliches Dokument erzeugt nicht automatisch neue Vertragspflichten.
|
||||
+- **Destination Solutions:** Genannte Stornostaffel (vom Betreiber berichtet): mindestens 60 Tage vorher 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, 11 Tage oder weniger 100 % des „Mietpreises“. **Ungeklärt:** Nachweis im Buchungsprozess, Durchsetzbarkeit, genaue Kostenbasis. Nicht als globalen A3-Standard verwenden.
|
||||
+
|
||||
+Siehe [K00](../00_Portalprofile_und_Vertragsvorlagen.md), [K01](../K01_Preisstruktur_und_Abrechnung.md) und [R08 Destination Solutions](../R00_Szenarien/R08_Destination_Solutions.md).
|
||||
--- /dev/null
|
||||
+++ v0.7/D00_Dokumentationsregel_und_Uebergabe.md
|
||||
@@ -0,0 +1,34 @@
|
||||
+---
|
||||
+id: D00
|
||||
+typ: arbeitsregel
|
||||
+titel: Dokumentationsregeln, Quellenbasis und Übergabe
|
||||
+status: diskussionsentwurf
|
||||
+version: "0.1"
|
||||
+stand: 2026-10-31
|
||||
+---
|
||||
+
|
||||
+# D00 – Dokumentationspflege und Kontextübergabe
|
||||
+
|
||||
+**Verbindliche Arbeitsvereinbarung des Betreibers vom 31.10.2026:**
|
||||
+
|
||||
+> **Vor jeder zukünftigen Änderung oder Erweiterung der Fachdokumentation muss ChatGPT den Betreiber ausdrücklich bitten, die aktuell gültigen Originaldokumente erneut bereitzustellen.** Nicht aus Erinnerung oder einem alten Chat-ZIP heraus eine bestehende Datei überschreiben. Maßgebliche Ablage bleibt **Gitea**. Dieser Stand v0.7 ist eine **lokale konsolidierte Bearbeitungsfassung**, kein nachgewiesener Gitea-Stand.
|
||||
+
|
||||
+## Vorgehen bei der nächsten Dokumentationsänderung
|
||||
+
|
||||
+1. **Vor dem Editieren** aktuelle Gitea-Originaldateien bzw. aktuellen Export/Snapshot **explizit beim Betreiber anfordern** (auch wenn eine ältere Version in /mnt/data oder der Chat-Historie vorhanden ist).
|
||||
+2. Vergleich mit diesem Stand / bisherigen Entscheidungen, YAML-Metadaten, Dokumenten-IDs und Verlinkungen; Unterschiede und mögliche Konflikte aufzeigen.
|
||||
+3. Nur auf dem bestätigten Stand weiterarbeiten; bestehende Inhalte nicht still kürzen, vereinbarte Regeln nicht als unbelegte Produktfunktionen ausgeben.
|
||||
+4. Versionsnummern je geändertem Dokument erhöhen, Entscheidungshistorie und Prüffälle aktualisieren; Änderungen via **Diff/Manifest** nachvollziehbar machen.
|
||||
+5. Dateipaket zur **kontrollierten Übernahme nach Gitea** bereitstellen; keine Behauptung, Dateien seien bereits im Repository gespeichert. Unklare Rechts-/Portalfragen offen kennzeichnen.
|
||||
+
|
||||
+## Quellen und Sicherungsstand der jetzigen Konsolidierung
|
||||
+
|
||||
+- Ausgangsbasis Hauptdokumentation: `FewoPortal_Dokumentation_v0.6.zip` **einschließlich P01–P05, die im separaten entpackten Ordner fehlten**.
|
||||
+- Zusätzliche Ausgangsbasis: `FewoPortal_Portalprofile_Update/{00_Buchungsarchetypen.md v0.5, 00_Portalprofile_und_Vertragsvorlagen.md v0.1, A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md v0.4}`.
|
||||
+- Weiteres Referenzmaterial: `FewoPortal_R01_Arbeitsentwurf/R00_Szenarien/{00_Szenariomatrix.md, R01_Eigene_Webseite.md}`.
|
||||
+- Nachzutragende Betreiberangaben: Gespräch vom 31.10.2026 zu FeWo-direkt-Screenshots, Destination Solutions, fünf Archetypen, Storno, unsicheren Kalendern und flexibler Preis-/Gebührenbearbeitung.
|
||||
+- **Nicht verifiziert:** Ob in Gitea neuere Fassungen dieser Dateien existieren. Vor künftigen Änderungen deshalb erneute Anforderung.
|
||||
+
|
||||
+## Kompakter Kontext für den nächsten Chat
|
||||
+
|
||||
+FewoPortal ist eine **kleine, mandantenfähige Vermieterwebsite-/Buchungsanwendung für typischerweise 1–3 Ferienwohnungen je Vermieter, kein Marktplatz**. Ein gemeinsamer Hauptprozess V01 P01–P05, dazu V02 Vermarktung/Gästegewinnung/Gästebindung. Fünf Archetypen: A1 eigene Webseite, A2 externe unverbindliche Anfrage, A3 externe verbindliche Buchung mit weiterer eigener Gesamtabwicklung (**Destination Solutions**), A4 externe verbindliche Buchung mit geteilter Abwicklung (**FeWo-direkt**), A5 überwiegend externe Vollabwicklung. **A6 gestrichen**; Partnerherkunft nur bei Provisionsrelevanz. Ein Vorgang/eine Akte. Externer Preis und beim Vertragsschluss vereinbarte Bedingungen bleiben maßgeblich, spätere Dokumente keine stillen neuen Pflichten. Unterschiedliche/versionierte Vorlagen pro Kanal/Buchungstyp. Portale liefern unterschiedlich vollständige Daten; **manuelle Bearbeitung und Sammel-/Gesamtpreise** sind konstitutive Fachfunktionen. Gast-Mietforderung, externe Gastgebühr, Vermieterprovision, Auszahlung und Zahlung getrennt. Kein Erfinden unbekannter Gebührenanteile. Verfügbarkeit extern nicht garantiert: FeWo-direkt verzögerter iCal-Import, Destination Solutions manuelles Sperren ohne verlässlichen Portal-/Partnernachweis; Doppelbuchungen möglich, deshalb Ausnahmeprozess und Belegkette. Nicht bekannte Vertrags- und Portalfragen im O00-Prüffallregister. **Vor der nächsten Dokumentbearbeitung aktuelle Gitea-Fassung explizit erfragen.**
|
||||
--- /dev/null
|
||||
+++ v0.7/K01_Preisstruktur_und_Abrechnung.md
|
||||
@@ -0,0 +1,73 @@
|
||||
+---
|
||||
+id: K01
|
||||
+typ: fachliches-konzept
|
||||
+titel: Preis-, Gebühren- und Abrechnungsinformationen
|
||||
+status: diskussionsentwurf
|
||||
+version: "0.1"
|
||||
+stand: 2026-10-31
|
||||
+---
|
||||
+
|
||||
+# K01 – Flexible Preis-, Gebühren- und Abrechnungsinformationen
|
||||
+
|
||||
+**Fachstatus:** Betreiberentscheidungen E-014/E-015 sind bestätigt; konkrete Feldliste/Technik, Steuern und portalbezogene Berechnungsregeln bleiben zu validieren. Zielgruppe: kleine Vermieter (typischerweise 1–3 Wohnungen), keine komplexe Vollbuchhaltung.
|
||||
+
|
||||
+## 1. Zentrales Prinzip
|
||||
+
|
||||
+Portale können vollständige Einzelposten, **nur Teilaufschlüsselungen**, **kombinierte Sammelgebühren** oder ausschließlich einen **Gesamtpreis** bereitstellen. FewoPortal muss all diese Informationsstände aufnehmen und später ergänzen können. **Die Gesamtpreisangabe ist ein gültiger Ausgangswert; sie berechtigt nicht zur Erfindung unbekannter Einzelpreise.** Extern bestätigter Gastpreis bleibt Grundlage der bestehenden Buchung.
|
||||
+
|
||||
+## 2. Unbedingt zu unterscheidende wirtschaftliche Sachverhalte
|
||||
+
|
||||
+| Dimension | Beispiel | Fachliche Bedeutung / Grenze |
|
||||
+|---|---|---|
|
||||
+| **Gast ↔ Vermieter** | Vereinbarte Unterkunftsmiete, ggf. vertragliche Zusatzleistungen und Rabatte | Eigene Mietforderung gegenüber Gast; tatsächlich vereinbarter Gastpreis maßgeblich |
|
||||
+| **Gast ↔ externes Portal** | Eventuelle Vermittlungs-/Servicegebühr des Portals | Fremde Forderung, nicht automatisch unsere Miete oder unser Umsatz |
|
||||
+| **Vermieter ↔ Vermittler/Portal** | Provision, Transaktionskosten, sonstige vertragliche Dienstleistung | Eigene Kosten des Vermieters; nicht nachträglich dem Gast belasten |
|
||||
+| **Gastzahlungen** | Anzahlung/Restzahlung, Erstattung, Kaution | Zahlungsplan und Zahlungsstatus unabhängig von der Mietforderung |
|
||||
+| **Auszahlung an Vermieter** | Nettoauszahlung nach Portalabzügen | Ist-Zahlungsfluss; nicht mit Gastpreis oder vereinbartem Mietbetrag gleichsetzen |
|
||||
+| **Ungeklärte Mischposition** | Eine „Servicepauschale“ mit unbekanntem Anteil an Reinigung, Portalgebühr oder Provision | **Nicht ohne Nachweis in Einzelpositionen umwandeln**; Zahler/Empfänger ggf. offen |
|
||||
+| **Preisdifferenz/Vertriebsaufschlag** | Höherer Endpreis auf Partnerkanal möglich | Nur bei Nachweis; unterscheiden von gesonderter Gastgebühr und Vermieterprovision |
|
||||
+
|
||||
+**Begriffe:** „Brutto“, „Netto“, „Provision“ und „Servicegebühr“ können auf Portalen unterschiedlich verwendet werden. Keine umsatzsteuerliche Zuordnung ohne überprüfte Angaben. Für die Rechnungsstellung sind tatsächlich geschuldete Leistungen/Steuerregeln separat rechtlich/kaufmännisch zu prüfen.
|
||||
+
|
||||
+## 3. Fachliche Positionsstruktur – Vorschlag, noch keine technische Datenmodellfreigabe
|
||||
+
|
||||
+Je Position oder Aggregateintrag mindestens soweit bekannt: Bezeichnung, Betrag, Währung, positive/negative Wirkung, **Art der Position** (Einzelpreis, Teilaggregat, Gesamtbetrag, Rabatt, Zahlung, Aufwand, Auszahlung, unbekannt), **wer schuldet wem**, Preis-/Leistungsbezug, Quelle und Erfassungszeitpunkt, zugehörige Buchung und Konditionsstand, Status/Nachweis. Optional: Zeitraum, Menge, Steuerregel, ursprüngliche Portalzeile, externe Referenz, Verknüpfung zu Teilpositionen.
|
||||
+
|
||||
+**Qualitäts- und Nachweisstatus:** vom Portal behauptet / im Portal sichtbar / durch Beleg belegt / manuell übernommen / abgeleitet mit Rechenweg / unbekannt / widersprüchlich / nicht anwendbar. Das sind fachliche Kategorien, kein verbindlich vorgeschriebenes Enum.
|
||||
+
|
||||
+### Regeln zur Zerlegung und zum Summenabgleich
|
||||
+
|
||||
+1. **Original erhalten:** Jede Portal-Sammelposition bleibt mit Ursprung und Betrag historisch erhalten, auch nach Aufteilung.
|
||||
+2. **Zerlegung mit Rechenweg:** Teilpositionen nur bei ausreichender Quelle oder ausdrücklicher dokumentierter manueller Zuordnung. Rest bleibt als „ungeklärter Anteil“.
|
||||
+3. **Doppelzählung vermeiden:** Ein Gesamtaggregat und seine Unterpositionen dürfen in Summen **nicht additiv** gezählt werden. Die Aggregationshierarchie bleibt nachvollziehbar.
|
||||
+4. **Keine Scheingenauigkeit:** Nur Gesamtpreis bekannt → keine Tagespreise aus Durchschnittswert als tatsächliche Portalpreise deklarieren. Interne Vergleichskalkulation ausdrücklich von Vertragsfakten trennen.
|
||||
+5. **Widersprüche erhalten:** Zwei verschiedene Portal-Auszahlungswerte bleiben beide mit Herkunft stehen, bis sie belegt geklärt werden.
|
||||
+6. **Keine Umdeutung der Vertragspflicht:** Aufteilung, interne Provision oder Auszahlung ändern den verbindlichen Gastpreis nicht rückwirkend.
|
||||
+7. **Korrekturen historisieren:** Neue Information ergänzt oder korrigiert die interne Zuordnung nachvollziehbar; die ursprünglichen Portalwerte bleiben referenzierbar.
|
||||
+
|
||||
+## 4. Beschaffung und manuelle Bearbeitung
|
||||
+
|
||||
+- **Automatisch:** Datenimport per vorhandener Schnittstelle, Parser oder anderem verlässlichen Kanal, soweit die Daten tatsächlich verfügbar sind.
|
||||
+- **Manuell:** Vermieter ruft Portalbestätigung, Posteingang oder Abrechnungsseite auf, erfasst Werte und kann Belege/Screenshot hinterlegen.
|
||||
+- **Hybrid:** Automatisch importierter Gesamtpreis, manuell nacherfasste Provision oder einzelne Gebühren.
|
||||
+- **Klärungsaufgabe:** Wenn tatsächlich für die **nächste Fachhandlung** erforderlich, z. B. noch fehlender Betrag zur korrekten Gastrechnung oder Zahlungseinforderung.
|
||||
+- **Kein unnötiger Prozessstopp:** Rein interne Provisionszerlegung oder fehlende Tagespreise blockieren nicht automatisch bereits verbindliche Buchung, Kalender- oder Anreisevorbereitung.
|
||||
+
|
||||
+## 5. Getrennte Finanzzustände (kein unzulässiger Statusschluss)
|
||||
+
|
||||
+`Gastbetrag vereinbart` → `Rate fällig` → `Rate laut Portal bezahlt` → `Auszahlung angekündigt` → `Auszahlung auf Bankkonto belegt`. Diese Ereignisse sind **nicht zwangsläufig linear** und nicht in allen Portalen sichtbar. Eine sichtbare „bezahlt“-Markierung ist noch kein eigener Zahlungseingang beim Vermieter; Kaution, Mietzahlung, Gebühr und Erstattung gesondert betrachten.
|
||||
+
|
||||
+## 6. Reale Prüfbeispiele
|
||||
+
|
||||
+**FeWo-direkt A4 – beobachteter Screenshot, Buchung 10.–17.07.2027:** 840,00 € Übernachtungen, −42,00 € Rabatt, +181,51 € „Gebühren und Steuern“, 979,51 € Gastgesamtbetrag, −84,82 € „An FeWo-direkt gezahlt“, 894,69 € ausgewiesene Gesamtauszahlung. In anderer Ansicht 900,20 € erwartete Auszahlung (5,51 € Differenz). Sichtbarer Zahlungsplan 390,61 € bezahlt und 588,90 € später fällig. **Keine belegte Zerlegung** von 181,51 €/84,82 € oder der 5,51-€-Differenz; einzelne Tagespreise fehlen. Siehe [A04 Abschnitt 7](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md).
|
||||
+
|
||||
+**Destination Solutions A3 – Betreiberangaben:** Extern bestätigter Buchungspreis ist zu übernehmen und Zahlung durch Vermieter abzuwickeln. Provisionssatz kann nach vermittelndem Partner variieren. Ob Partnerportal den Endpreis erhöht oder eine separate Gast-Servicegebühr erhebt, ist derzeit nicht bestätigt; auch dort darf nur ein übermittelter Gesamtpreis zulässig sein. Keine nachträgliche Provisionsbelastung des Gastes.
|
||||
+
|
||||
+## 7. Noch zu entscheiden
|
||||
+
|
||||
+- Für welche Dokumente/Rechnungen ist eine echte Einzelpositionsauflösung zwingend? Gesetzliche Buchführungs-/Umsatzsteuerpflichten jeweils gesondert prüfen.
|
||||
+- Wie sollen Rundungsdifferenzen, Fremdwährungen, Kaution, Kurabgabe, Auszahlungstermine und Teilrückerstattungen technisch dargestellt werden?
|
||||
+- Welche Vereinbarungen gelten für Stornokostenbasis („Mietpreis“ vs. Gesamtbetrag; inkludierte/ausgeschlossene Leistungen), wenn nur eine Gesamtsumme vorliegt?
|
||||
+- Welche individuellen Portalberichte, tatsächlichen Zahlungsnachweise und Importformate stehen zur Verfügung?
|
||||
+
|
||||
+**Fachliche Herkunft:** Betreiberinterview vom 31.10.2026, FeWo-direkt-Screenshots, [E00 E-014–E-020](E00_Entscheidungsprotokoll.md). Rechtliche Gestaltung separat prüfen.
|
||||
--- /dev/null
|
||||
+++ v0.7/O00_Offene_Portalprueffaelle.md
|
||||
@@ -0,0 +1,49 @@
|
||||
+---
|
||||
+id: O00
|
||||
+typ: prueffallregister
|
||||
+titel: Portalbezogene Prüf- und Klärungsfälle
|
||||
+status: diskussionsentwurf
|
||||
+version: "0.1"
|
||||
+stand: 2026-10-31
|
||||
+---
|
||||
+
|
||||
+# O00 – Offene Portalprüffälle / spätere Konfiguration
|
||||
+
|
||||
+**Status:** Keine offenen Fragen als beantwortet ausgeben, solange konkrete Portalansichten, Verträge, Anbieterantworten oder Gastbuchungen fehlen. Unterschiedliche Vermieter-/Portalverträge können unterschiedlich sein. Die untenstehenden Prüfpunkte sind **keine Vorbedingungen für alle Prozessschritte**.
|
||||
+
|
||||
+## A. Destination Solutions / Kühlungsborn (A3)
|
||||
+
|
||||
+| ID | Prüffall | Bekannter Stand | Erforderlicher Nachweis / spätere Konfiguration |
|
||||
+|---|---|---|---|
|
||||
+| DS-01 | Erhält Gast Stornobedingungen **vor** verbindlicher Buchung? | Staffel laut Betreiber separat im späteren Vertrag; Betreiber vermutet ggf. Portal-Einstellungen / Hinweis | Gast-Buchungsstrecke, Gast-Bestätigung, Portal-AGB/Smart-Account-Einstellungen, ggf. Betreibervereinbarung |
|
||||
+| DS-02 | Welche Basis ist „Mietpreis“ für Storno? | Unklar, ob Übernachtung allein oder zusätzliche Leistungen | Vertrag/Preisaufschlüsselung und rechtliche Prüfung |
|
||||
+| DS-03 | Gibt es eigene Gast-Servicegebühr oder Partner-Aufschläge? | **Unbekannt**; nur unterschiedliche **Vermieterprovisionen** je Vermittlungskanal sind berichtet | Gastansicht/Gastbestätigung plus Provisionsrechnung des konkreten Kanals |
|
||||
+| DS-04 | Vollständiger Preisnachweis | Buchung kommt mit Gesamtinformationen; Einzelposten nicht gesichert | Beispieldokumente/Muster einer echten Buchung; Fähigkeit „nur Gesamtpreis“ zulassen |
|
||||
+| DS-05 | Kalender-/Sperrprotokoll | Nach Betreibererfahrung **manuelle Sperre, kein formaler Sperrnachweis** | Anbieterantwort zum Serverzeitstempel, Änderungslog und Partnerweitergabe |
|
||||
+| DS-06 | Verfahren und Zuständigkeit für Storno/Umbuchung | Noch kein durchlaufener Prozess beschrieben | Portalvertrag, Beispielbuchung, konkrete Änderung/Storno aus Praxistest wenn möglich |
|
||||
+
|
||||
+## B. FeWo-direkt (A4)
|
||||
+
|
||||
+| ID | Prüffall | Bekannter Stand | Benötigter Nachweis |
|
||||
+|---|---|---|---|
|
||||
+| FW-01 | Welche Dokumente/Bedingungen werden vor verbindlicher Buchung gezeigt? | Eigene vierseitige Vertragsvorlage **nicht** im Portal hochgeladen; exakte Gastansicht unbekannt | Gastansicht, Buchungsbestätigung, Portal-AGB und tatsächlich bei Buchung vereinbarte Konditionen |
|
||||
+| FW-02 | Sind Gast-Servicegebühr, Portalabzug, Vermieterprovision und Steuerbestandteile trennbar? | Im Screenshot Gesamt- und Teilaggregationen; 181,51 € „Gebühren und Steuern“, 84,82 € „An FeWo-direkt gezahlt“ nicht weiter zerlegt | Vollständige Detailansicht/Provisionsabrechnung, ggf. vertraglicher Abgleich |
|
||||
+| FW-03 | Wieso zwei Auszahlungsbeträge? | 894,69 € und 900,20 € (Differenz 5,51 €) | Ursachenprüfung anhand derselben Buchung und Zahlungskonto |
|
||||
+| FW-04 | Welche Zahlungsdaten sind wirklich exportierbar? | Posteingang pro Buchung mit Raten, jedoch allgemeiner Zahlungsverlauf/Export vom Betreiber als unzureichend beschrieben | Exporttest, Auszahlungsbeleg und tatsächlicher Bankeingang |
|
||||
+| FW-05 | Änderungs- und Stornoprozess / Sanktionen | Betreiber hat bisher selbst weder Vermieterstorno noch Änderung ausgeführt | Portalregeln, Betreiberkonto, konkrete Verfahrensnachweise; tatsächliche Ursache korrekt klassifizieren |
|
||||
+| FW-06 | Gastdaten und örtliche Meldepflichten | Vollständige Gastanschrift nicht immer verfügbar | Tatsächlich vom Portal lieferbare Felder und konkret erforderliche lokale Pflichtdaten prüfen |
|
||||
+| FW-07 | iCal-Übernahme und Nachweis | Verzögerter Fremdkalenderabgleich, reale Doppelbuchungsgefahr | Zeit- und Änderungsnachweise soweit technisch verfügbar; keine Echtzeitgarantie |
|
||||
+
|
||||
+## C. Portalübergreifende Rechts-/Funktionsfragen
|
||||
+
|
||||
+- **Rechtswirksame Einbeziehung** von AGB, Storno- und Pflichtkosten vor Vertragsschluss bei externen Direktbuchungen; **späterer Dokumentversand ≠ neue automatische Einbeziehung**. Einzelprüfung anhand konkreter Verträge und Buchungsscreens.
|
||||
+- **Stornokosten**: Wirksamkeit der Pauschalierung und mögliche Abzüge ersparter Aufwendungen / alternative Vermietung; gesetzliche Regeln und Portal-AGB beachten, kein automatisches Rechtsurteil in FewoPortal.
|
||||
+- **Vollständigkeit**: Unbekannte Posten und aggregierte Beträge sind im Fachmodell ausdrücklich zulässig; der nächste notwendige Schritt kann dennoch manuelle Klärung verlangen.
|
||||
+- **Verfügbarkeit**: Manuelle Sperre, Zielportal-Sichtbarkeit und partnernetzweite Wirksamkeit unterscheiden. Nicht nachgewiesene Serverbestätigung nicht fingieren.
|
||||
+- **Datensparsamkeit**: Nur tatsächlich erforderliche Gast- und Mitreisendendaten für Vertrag und anwendbare örtliche Vorschriften erheben.
|
||||
+
|
||||
+## D. Was sich vor späterer Konfiguration beschaffen lässt
|
||||
+
|
||||
+Pro Portal idealerweise **ein vollständig anonymisierter realer Buchungsfall**, Gast-Buchungsbestätigung soweit vorhanden, Betreiber-Provisionsabrechnung, Preis-/Stornokonfiguration und ein Beispiel für Änderung/Stornierung. **Nicht alle Nachweise müssen jetzt vorliegen**; Fehlen führt zu manuellen Aufgaben oder offenen Informationsfeldern, nicht zum Erfinden von Regeln.
|
||||
+
|
||||
+**Referenzen:** [Portalprofil K00](00_Portalprofile_und_Vertragsvorlagen.md), [Preisstruktur K01](K01_Preisstruktur_und_Abrechnung.md), [FeWo-direkt A04](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md), [Destination Solutions R02](R00_Szenarien/R08_Destination_Solutions.md).
|
||||
--- /dev/null
|
||||
+++ v0.7/R00_Szenarien/R08_Destination_Solutions.md
|
||||
@@ -0,0 +1,61 @@
|
||||
+---
|
||||
+id: R08
|
||||
+typ: geschaeftsszenario
|
||||
+titel: Verbindliche Direktbuchung – Destination Solutions
|
||||
+status: diskussionsentwurf
|
||||
+version: "0.1"
|
||||
+stand: 2026-10-31
|
||||
+---
|
||||
+
|
||||
+# R08 – Destination Solutions: Verbindliche Direktbuchung mit Abwicklung durch Vermieter
|
||||
+
|
||||
+**Zuordnung:** A3; Partnerherkunft **kein A6**. Dies ist ein reales, vom Betreiber beschriebenes Referenzszenario, keine Implementierungsfreigabe. Anbieter: [Destination Solutions](https://www.ds-destinationsolutions.com/). Die Angaben beschreiben den **konkret verwendeten Betreiberzugang**, nicht zwangsläufig alle Kunden und Softwareprodukte des Unternehmens.
|
||||
+
|
||||
+## 1. Dokumentierter Ist-Sachverhalt (Betreiberangaben)
|
||||
+
|
||||
+- Der Anbieter bzw. sein Partnernetz vermittelt und bestätigt Buchungen **verbindlich**, bevor der Vermieter sie erhält.
|
||||
+- Die Buchung wird dem Vermieter mit den für die weitere Abwicklung vorgesehenen Daten übermittelt; die Abwicklung von **Vertragsunterlagen, Gastkommunikation, Zahlungsforderung/-kontrolle, Aufenthalt und Folgevorgängen** liegt danach beim Vermieter. Einzelne Preis-/Gebührenpositionen können trotzdem fehlen; vollständige kaufmännische Aufschlüsselung ist nicht bestätigt.
|
||||
+- Für diesen Betreiberzugang gibt es **keinen automatischen Abgleich mit den Vermieterkalendern**. Andere Portale müssen nach Eingang einer Buchung **unverzüglich manuell gesperrt** werden. Für den Zeitpunkt der Portalübernahme/Weitergabe der Sperrung gibt es nach Betreiberangabe **keinen belastbaren Bestätigungsbeleg**.
|
||||
+- Destination Solutions nutzt zusätzlich Partnervertrieb. Der Vermieter erhält je nach Vertriebspartner **unterschiedliche Provisionen**. Eine unbekannte Gastgebühr oder ein Endpreisaufschlag ist **nicht nachgewiesen** und darf nicht als Tatsache modelliert werden.
|
||||
+- Beim Buchungsabschluss ist der Preis bereits vereinbart. Unsere Provision an den Vermittler darf daher **nicht nachträglich als Zusatzforderung gegenüber dem Gast** erhoben werden.
|
||||
+
|
||||
+## 2. Generischer Sollablauf P01–P05 mit manuellen Aufgaben
|
||||
+
|
||||
+| Phase | Tätigkeiten / Abweichung | Gate / Nachweis |
|
||||
+|---|---|---|
|
||||
+| **P01 Eingang & Belegung** | Eingehende **bereits verbindliche** Buchung übernehmen, Objekt/Zeitraum/Referenz und Gastdaten zuordnen. Eigene Kalender sofort aktualisieren, für nicht angebundene Portale **manuelle Sperraufgabe** erzeugen, mit Bearbeiter und Zeitpunkt quittieren. Bei Kollision X07. | Buchung verbindlich extern; Sperraufgabe erledigt ≠ nachweislich partnernetzweit wirksam |
|
||||
+| **P02 Konditionen/Vertrag** | Ursprünglich vereinbarten Gastpreis und bekannte Konditionen übernehmen, nicht selbst nachkalkulieren. Zugehöriges Vertragsprofil/Anlagen auswählen; Gast bereits gebunden – **keine zweite Annahme**. Storno-/Pflichtbedingungen auf vorvertragliche Einbeziehung prüfen. | Quelle für Gastpreis, vertragsrelevante Bedingungen und ggf. offene Rechts-/Datenlücke |
|
||||
+| **P03 Kaufmännisch** | Eigene Buchungsdokumentation versenden; Zahlungsplan/Anzahlung/Restzahlung festlegen bzw. gemäß Vereinbarung übernehmen, Zahlungen überwachen, Mahn-/Stornofälle selbst führen. Vermittlerrechnung/Provision ggf. nach Kanal zuordnen, Gastservicegebühren nur soweit nachgewiesen. | Eigener Zahlungsstand und offene Finanz-/Konditionsprüfungen erkennbar |
|
||||
+| **P04 Aufenthalt** | Gastkontakt, lokale Ansprechpartner, Anreise, Schlüssel, Reinigung, Kurabgabe/Meldedaten soweit nötig, Aufenthalt/Abreise. | Erforderliche Leistungsinformationen vorhanden; manuelle Schritte möglich |
|
||||
+| **P05 Abschluss** | Aufenthalt abschließen, Feedback, finanzielle Rest-/Provisionsprüfung ggf. Folgefall. | V01 regulär beendet oder offener Nachläufer verantwortlich übergeben |
|
||||
+
|
||||
+## 3. Betreiberangabe zu Stornobedingungen
|
||||
+
|
||||
+| Zeit vor Mietbeginn | Stornopauschale vom „Mietpreis“ |
|
||||
+|---|---:|
|
||||
+| 60 Tage oder mehr | 0 % |
|
||||
+| 59–45 Tage | 35 % |
|
||||
+| 44–33 Tage | 50 % |
|
||||
+| 32–22 Tage | 70 % |
|
||||
+| 21–12 Tage | 90 % |
|
||||
+| 11 Tage oder weniger | 100 % |
|
||||
+
|
||||
+**Wichtige Einschränkung:** Der Betreiber ist nicht sicher, ob diese Bedingungen **bereits vor der Buchung** im Portal angezeigt und wirksam einbezogen wurden oder erst mit dem eigenen, nachträglich übersandten Vertrag vereinbart werden sollen. Ein späteres Dokument kann nicht ohne Weiteres einseitig neue Pflichten begründen. Auch ob „Mietpreis“ nur Übernachtungen oder Zusatzleistungen enthält und wie 90–100 % als Pauschalierung rechtlich einzuordnen sind, muss geprüft werden. Siehe [§ 305 BGB](https://www.gesetze-im-internet.de/bgb/__305.html), [§ 309 Nr. 5 BGB](https://www.gesetze-im-internet.de/bgb/__309.html) und [§ 537 BGB](https://www.gesetze-im-internet.de/bgb/__537.html) als Prüfquellen, **nicht als abschließendes Rechtsgutachten**.
|
||||
+
|
||||
+## 4. Finanzielle Unklarheiten / Konfigurationsfragen
|
||||
+
|
||||
+1. Wird die vereinbarte Gastmiete vom Portal oder einem Partnerportal **durch eigene Gast-Servicegebühr** ergänzt?
|
||||
+2. Werden je Vermittlungskanal unterschiedliche **Gäste-Endpreise/Vertriebsaufschläge** berechnet?
|
||||
+3. Wie werden Provisionskosten und die (eventuell andere) **vertragliche Mietforderung** beim Vermieter nachgewiesen?
|
||||
+4. Welche Beträge/Positionen sieht der Gast vor dem Abschluss und in der Gast-Buchungsbestätigung?
|
||||
+5. Wie ist die **Stornokostenbasis** bei unbekannten Einzelpreisen definiert; was passiert bei optionalen Leistungen und Neuvermietung?
|
||||
+
|
||||
+## 5. Risiko: Nachweislose Sperrung trotz Sofortbuchung
|
||||
+
|
||||
+Das System muss die **eigene Ausführung** dokumentieren (Sperraufgabe, Zeitstempel, Screenshot sofern verfügbar) und gleichzeitig ehrlich kennzeichnen, dass kein Nachweis über den Servereingang bzw. die Partnernetz-Verteilung vorliegt. Buchungsüberschneidungen können auch dann auftreten, wenn der Vermieter schnell handelt. **Technisch verursachte Verzögerung beweist für sich genommen keine rechtliche Entlastung.** Livefreigabe durch Vermieter oder Karenzfrist sind hier **nicht vorhandene Ist-Funktionen** und bleiben lediglich hypothetische Integrationsoptionen.
|
||||
+
|
||||
+## 6. Quellen- und Verifizierungsstatus
|
||||
+
|
||||
+- **Bestätigt aus dem Betreiberinterview:** verbindliche Buchungsübermittlung, komplette weitere Vermieterabwicklung, manuelle Sperre ohne Bestätigungsbeleg, unterschiedliche Vermittlerprovisionen je Partner, Stornostaffel als genannte Vertragsbedingung.
|
||||
+- **Nicht verifiziert:** konkrete Ansicht/Bestätigung des Gastes, Vertragseinbeziehung der Stornoregeln, zusätzliche Gastgebühren oder Aufschläge, Preisaufschlüsselung, verwendete Destination-Solutions-Vertragsvariante, technische Verteilung/Protokollierung.
|
||||
+- Weitere Nachweise erforderlich: [O00](../O00_Offene_Portalprueffaelle.md).
|
||||
--- /dev/null
|
||||
+++ v0.7/X01_Belegungskonflikte_und_Sperrnachweise.md
|
||||
@@ -0,0 +1,41 @@
|
||||
+---
|
||||
+id: X07-DOK
|
||||
+typ: sonderprozess
|
||||
+titel: Verfügbarkeitsabgleich, Sperrnachweise und Doppelbuchungen
|
||||
+status: diskussionsentwurf
|
||||
+version: "0.1"
|
||||
+stand: 2026-10-31
|
||||
+---
|
||||
+
|
||||
+# X07 – Verfügbarkeitsabgleich, Sperrnachweise und Doppelbuchungen
|
||||
+
|
||||
+**Geltungsbereich:** Alle Buchungsarchetypen und Vertriebskanäle. Das Dokument ist eine Vertiefung von X07 aus [X00](X00_Sonderprozesse.md), kein zusätzlicher Buchungsarchetyp.
|
||||
+
|
||||
+## 1. Reale Ursachen und Grenzen
|
||||
+
|
||||
+- **FeWo-direkt:** Verzögertes iCal-Importintervall kann dazu führen, dass nach einer eigenen verbindlichen Buchung dort noch buchbare Zeiten angezeigt werden. Dass ein eigener Export korrekt aktualisiert wurde, beweist keine rechtzeitige Portalübernahme.
|
||||
+- **Destination Solutions:** Beim konkreten Vermieteraccount fehlt ein automatischer Kalenderabgleich; manuelle Sperrung im Zielportal. Anschließende Weitergabe an Partnerportale und wirksamer Zeitpunkt sind **nicht verifizierbar**; eine protokollierte Sichtkontrolle des Vermieters ist kein Portalserver-Zeitstempel.
|
||||
+- **Generische Grenze:** Bei heute sofort wirksam werdenden externen Direktbuchungen verhindert FewoPortal **nicht jede Doppelbuchung**. Vom Betreiber vorgeschlagene 10-Minuten-Bestätigung oder Livefreigabe sind sinnvolle technische Zukunftsoptionen, werden **nicht als bestehende Funktionen** vorausgesetzt.
|
||||
+
|
||||
+## 2. Minimale Nachweiskette, ohne Überbürokratisierung
|
||||
+
|
||||
+1. **Auslösende Buchung:** Portal/Quelle, externe Referenz, Ankunft der Nachricht, soweit ermittelbarer tatsächlicher Buchungs-/Bestätigungszeitpunkt.
|
||||
+2. **Eigene Belegungsänderung:** Zeitstempel, interne Buchungs-ID, Zeitraum, Nutzer/Systemaktion, Stand eigener Kalender.
|
||||
+3. **Propagation:** Ausgeführter Export oder angelegte manuelle Sperraufgabe; Zeitpunkt und verantwortliche Person.
|
||||
+4. **Zielportal:** Soweit möglich manuelle Sichtkontrolle und optionaler Screenshot. Status nur **„angezeigt“**, wenn dadurch belegt.
|
||||
+5. **Partnernetz:** Nur als **„wirksam nachgewiesen“** markieren, falls geeignete Rückmeldung/Protokoll vorhanden; sonst **„unbekannt“**.
|
||||
+6. **Fehler:** Doppelbuchung → Meldungszeitpunkte, beide Verbindlichkeitsnachweise, mögliche Ursache, Kommunikation und Entscheidung gesondert festhalten.
|
||||
+
|
||||
+**Rechtliche Vorsicht:** Ein technisch nicht vermeidbarer Sync-Verzug belegt nicht automatisch fehlendes Verschulden nach Miet- und Portalvertrag. Verantwortlichkeit erst nach Vertrags- und Sachverhaltsprüfung beurteilen. FeWo-direkt-Richtlinien zu Gastgeberstornierungen gesondert beachten; die tatsächliche Ursache nicht durch Gast-Button umdeklarieren.
|
||||
+
|
||||
+## 3. Generischer Konflikt-Teilprozess
|
||||
+
|
||||
+Konflikt entdecken → unverändert dokumentieren → **bereits verbindliche Buchungen** und Zeitachse prüfen → Ursache/Zuständigkeiten ermitteln → realistische Lösung mit Gästen/Portalen abstimmen → **rechtlich tatsächlich wirksame** Umbuchung/Stornierung oder Alternativleistung dokumentieren → Kalender/Finanzen/Vertragsdokumente aktualisieren → Folgefälle übergeben.
|
||||
+
|
||||
+Keine bereits verbindliche externe Buchung nur aufgrund widersprüchlicher Kalenderdaten löschen; keine bloße Stornoanfrage als wirksam verbuchen. Mit dem Gast wird transparent kommuniziert, ohne durch Druck eine abweichende Ursache zu konstruieren.
|
||||
+
|
||||
+## 4. Zielarchitektur, nicht Ist-Funktionen
|
||||
+
|
||||
+Mögliche spätere technische Fähigkeiten: Live-API-Verfügbarkeitsabfrage, atomare Reservierung, Portalbestätigung vor Vertragsschluss, Webhooks/Audit-Logs, automatische Konfliktfrüherkennung. **Aktuell nicht als verfügbar oder implementiert voraussetzen.** Für den MVP zunächst: gut sichtbare Sperraufgaben und revisionsfähige Eigenprotokolle.
|
||||
+
|
||||
+Siehe [P01](P01/P01_Buchungseingang_und_Verfuegbarkeit.md), [E00](E00_Entscheidungsprotokoll.md), [Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md).
|
||||
@@ -0,0 +1,689 @@
|
||||
--- v0.7/00_Buchungsarchetypen.md
|
||||
+++ v0.8/00_Buchungsarchetypen.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: archetypenkatalog
|
||||
titel: FewoPortal – Buchungsarchetypen und Verantwortungsübergaben
|
||||
status: diskussionsentwurf
|
||||
-version: "0.6"
|
||||
+version: "0.7"
|
||||
stand: 2026-10-31
|
||||
prozess: V01
|
||||
bezugsstand_prozessarchitektur: "0.7"
|
||||
@@ -106,32 +106,32 @@
|
||||
|
||||
**Zu konfigurierende Kanalmerkmale:** Herkunft verbindlicher Preise/Rabatte/Stornobedingungen, Erkennbarkeit und Nachweise, Zuständigkeiten, erlaubte Dokumente, automatische oder manuelle Datenerfassung und Vertragsversand. Kein hardcodiertes FeWo-direkt-Verhalten.
|
||||
|
||||
-Siehe [00 – Portalprofile und Vertragsvorlagen](00_Portalprofile_und_Vertragsvorlagen.md) für das schlanke Referenzmodell.
|
||||
+Siehe [[00_Portalprofile_und_Vertragsvorlagen|00 – Portalprofile und Vertragsvorlagen]] für das schlanke Referenzmodell.
|
||||
|
||||
## 8. Bezug zu vorhandenen Dokumenten
|
||||
|
||||
-- [Prozesslandkarte](00_Prozesslandkarte.md) – V01/V02, fünf Phasen und übergreifende Leitregeln.
|
||||
-- [Gates und Übergaben](G00_Gates_und_Uebergaben.md) – konzeptionelle Gate-Logik.
|
||||
-- [Entscheidungsprotokoll](E00_Entscheidungsprotokoll.md) – bereits bestätigte Entscheidungen.
|
||||
-- [Sonderprozesse](X00_Sonderprozesse.md) – derzeit bekannte Ausnahmefamilien.
|
||||
-- [Referenzfall eigene Webseite](R00_Szenarien/R01_Eigene_Webseite.md) – gesonderter Arbeitsentwurf (sofern dieser bereits ins Repository übernommen wurde).
|
||||
+- [[00_Prozesslandkarte|Prozesslandkarte]] – V01/V02, fünf Phasen und übergreifende Leitregeln.
|
||||
+- [[G00_Gates_und_Uebergaben|Gates und Übergaben]] – konzeptionelle Gate-Logik.
|
||||
+- [[E00_Entscheidungsprotokoll|Entscheidungsprotokoll]] – bereits bestätigte Entscheidungen.
|
||||
+- [[X00_Sonderprozesse|Sonderprozesse]] – derzeit bekannte Ausnahmefamilien.
|
||||
+- [[R00_Szenarien/R01_Eigene_Webseite|Referenzfall eigene Webseite]] – gesonderter Arbeitsentwurf (sofern dieser bereits ins Repository übernommen wurde).
|
||||
|
||||
## 9. Ergänzende A4-Vertragsanalyse (Stand 31.10.2026)
|
||||
|
||||
-Die vom Betreiber bereitgestellte vierseitige FeWo-direkt-Vertragsvorlage wurde unter [A04 – Vertragsvorlage und Prozessanalyse](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md) gesondert bewertet. Besonders prüfbedürftig sind: Verbindlichkeit vor dem nachträglichen Vertragsversand (§ 5), zuvor einbezogene Konditionen, Preis-/Gebührentrennung (§ 4), Portalstorno gegenüber eigener Stornoklausel (§ 13), Datenbedarf sowie sichere Trennung von Vertragsdokument und Zugangs-/Anreiseinformationen. **Keine Änderung der Betreibervertragsklauseln ohne gesonderte rechtliche und fachliche Freigabe.**
|
||||
+Die vom Betreiber bereitgestellte vierseitige FeWo-direkt-Vertragsvorlage wurde unter [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 – Vertragsvorlage und Prozessanalyse]] gesondert bewertet. Besonders prüfbedürftig sind: Verbindlichkeit vor dem nachträglichen Vertragsversand (§ 5), zuvor einbezogene Konditionen, Preis-/Gebührentrennung (§ 4), Portalstorno gegenüber eigener Stornoklausel (§ 13), Datenbedarf sowie sichere Trennung von Vertragsdokument und Zugangs-/Anreiseinformationen. **Keine Änderung der Betreibervertragsklauseln ohne gesonderte rechtliche und fachliche Freigabe.**
|
||||
|
||||
**Status dieses Dokuments:** Fünf Archetypen (A1–A5) nach E-012; Portalprofile und rechtliche Detailfragen bleiben offen. Neben FeWo-direkt (A4) ist Destination Solutions (A3) dokumentierter Praxisfall.
|
||||
|
||||
## 10. A4-Praxisnachweis aus FeWo-direkt-Ansichten (31.10.2026)
|
||||
|
||||
-Für eine konkrete zukünftige Buchung sind **aggregierte Übernachtungsrate, Rabatt, Gebühren/Steuern, Gesamtzahlung des Gastes, Abzug an FeWo-direkt, Auszahlungsvorschau sowie zwei Zahlungsraten und deren Fälligkeits-/Zahlungsstatus** im Vermieterbereich sichtbar. Auch angezeigte Stornobedingungen und der vorgesehene 72-Stunden-Anreiseinformationsversand sind erkennbar. **Nicht nachgewiesen** sind die vollständigen Tagespreis- und Gebührenbestandteile, ein belastbarer allgemeiner Zahlungsexport, die tatsächliche Auszahlung, der vollständige Vertragsinhalt der Gastbestätigung und die vollständigen Gaststammdaten. Zwei Ansichten weisen zudem **unterschiedliche voraussichtliche Vermieterauszahlungen (900,20 € / 894,69 €)** aus, Ursache offen. Details im [A4-Vertrags- und Prozessdokument](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md#7-nachtrag-aus-belegten-bildschirmansichten-31102026--ist-zustand-nicht-allgemeines-portalverhalten).
|
||||
+Für eine konkrete zukünftige Buchung sind **aggregierte Übernachtungsrate, Rabatt, Gebühren/Steuern, Gesamtzahlung des Gastes, Abzug an FeWo-direkt, Auszahlungsvorschau sowie zwei Zahlungsraten und deren Fälligkeits-/Zahlungsstatus** im Vermieterbereich sichtbar. Auch angezeigte Stornobedingungen und der vorgesehene 72-Stunden-Anreiseinformationsversand sind erkennbar. **Nicht nachgewiesen** sind die vollständigen Tagespreis- und Gebührenbestandteile, ein belastbarer allgemeiner Zahlungsexport, die tatsächliche Auszahlung, der vollständige Vertragsinhalt der Gastbestätigung und die vollständigen Gaststammdaten. Zwei Ansichten weisen zudem **unterschiedliche voraussichtliche Vermieterauszahlungen (900,20 € / 894,69 €)** aus, Ursache offen. Details im [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse#7. Nachtrag aus belegten Bildschirmansichten (31.10.2026) – Ist-Zustand, nicht allgemeines Portalverhalten|A4-Vertrags- und Prozessdokument]].
|
||||
|
||||
**Portalinvariante:** Verantwortlichkeit für Zahlung oder Kommunikation, Portalstatus und tatsächlicher Erfüllungsnachweis sind getrennt zu verwalten.
|
||||
|
||||
|
||||
## 11. Änderungs- und Stornoereignisse (portalunabhängig)
|
||||
|
||||
-Ein Storno bzw. eine Buchungsänderung ist ein **Teilprozess auf derselben Buchungsakte**, kein zusätzlicher Archetyp. Die fachliche Ursache (Gastwunsch, Unmöglichkeit beim Vermieter, Doppelbuchung, Regelverstoß, technischer Fehler), der Initiator, der ausführende Beteiligte und die Abwicklungsverantwortung sind voneinander zu unterscheiden. Anfrage, Bestätigung und tatsächliche Wirksamkeit sind getrennte Ereigniszustände. Kalender, Konditionen, Vertrag und Zahlungen werden erst nach ausreichend belegter Wirksamkeit angepasst. Eine durch den Vermieter verursachte Stornierung darf nicht durch Aufforderung an den Gast als Gaststorno umetikettiert werden. **FeWo-direkt** ist dafür ein dokumentiertes Portalbeispiel (siehe [A04 Abschnitt 8](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md)); andere Portale können abweichende Wege, Daten und Zuständigkeiten haben.
|
||||
+Ein Storno bzw. eine Buchungsänderung ist ein **Teilprozess auf derselben Buchungsakte**, kein zusätzlicher Archetyp. Die fachliche Ursache (Gastwunsch, Unmöglichkeit beim Vermieter, Doppelbuchung, Regelverstoß, technischer Fehler), der Initiator, der ausführende Beteiligte und die Abwicklungsverantwortung sind voneinander zu unterscheiden. Anfrage, Bestätigung und tatsächliche Wirksamkeit sind getrennte Ereigniszustände. Kalender, Konditionen, Vertrag und Zahlungen werden erst nach ausreichend belegter Wirksamkeit angepasst. Eine durch den Vermieter verursachte Stornierung darf nicht durch Aufforderung an den Gast als Gaststorno umetikettiert werden. **FeWo-direkt** ist dafür ein dokumentiertes Portalbeispiel (siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 Abschnitt 8]]); andere Portale können abweichende Wege, Daten und Zuständigkeiten haben.
|
||||
|
||||
|
||||
## 12. Destination Solutions als Praxisreferenz A3 (E-012/E-016/E-017/E-018)
|
||||
@@ -141,8 +141,12 @@
|
||||
- **Vermittlerprovisionen** können nach Vertriebskanal variieren. Sie sind nicht nachträglich vom Gast zu fordern. Ob zusätzlich ein direkter Gast-Aufschlag/Serviceentgelt oder Partner-Endpreisaufschlag existiert, muss beim Anbieter und anhand einer Gastbestätigung geprüft werden.
|
||||
- **Stornostaffel** vom Betreiber angegeben: ≥60 Tage 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, ≤11 Tage 100 % vom „Mietpreis“; **vorvertragliche Einbeziehung, Berechnungsbasis und rechtliche Wirksamkeit offen**.
|
||||
|
||||
-Siehe [R08 Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md) und [O00 Offene Portalprüffälle](O00_Offene_Portalprueffaelle.md).
|
||||
+Siehe [[R00_Szenarien/R08_Destination_Solutions|R08 Destination Solutions]] und [[O00_Offene_Portalprueffaelle|O00 Offene Portalprüffälle]].
|
||||
|
||||
## 13. Portaldaten können unterschiedlich detailliert und zusammengesetzt sein (E-014/E-015)
|
||||
|
||||
-Bei A2–A5 sind **automatische, manuelle und hybride** Informationen und Tätigkeiten gleichwertig zu modellieren. Pro Buchung sind vollständig aufgeschlüsselte Positionen, **kombinierte Service-/Gebührenpositionen**, bloße Gesamtbeträge sowie nur teilweise verfügbare Zahlungsauszüge möglich. Keine fiktive Zerlegung des Gesamtpreises; unbekannte Gebührenarten, Zahlende/Empfänger und Provisionsanteile bleiben offen. Nachträgliche Zuordnung oder Aufteilung erhält den originalen Portalbetrag und verhindert doppelte Summierung. Fehlende rein interne Kostenanalyse blockiert nicht ohne Weiteres den vertraglichen Aufenthalt. Siehe [K01](K01_Preisstruktur_und_Abrechnung.md).
|
||||
+Bei A2–A5 sind **automatische, manuelle und hybride** Informationen und Tätigkeiten gleichwertig zu modellieren. Pro Buchung sind vollständig aufgeschlüsselte Positionen, **kombinierte Service-/Gebührenpositionen**, bloße Gesamtbeträge sowie nur teilweise verfügbare Zahlungsauszüge möglich. Keine fiktive Zerlegung des Gesamtpreises; unbekannte Gebührenarten, Zahlende/Empfänger und Provisionsanteile bleiben offen. Nachträgliche Zuordnung oder Aufteilung erhält den originalen Portalbetrag und verhindert doppelte Summierung. Fehlende rein interne Kostenanalyse blockiert nicht ohne Weiteres den vertraglichen Aufenthalt. Siehe [[K01_Preisstruktur_und_Abrechnung|K01]].
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]] · [[R00_Szenarien/R01_Eigene_Webseite|A1 – Eigene Webseite]] · [[R00_Szenarien/R08_Destination_Solutions|A3 – Destination Solutions]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A4 – FeWo-direkt]] · [[00_Portalprofile_und_Vertragsvorlagen|Vertragsprofile]] · [[G00_Gates_und_Uebergaben|Gates]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
|
||||
--- v0.7/00_Portalprofile_und_Vertragsvorlagen.md
|
||||
+++ v0.8/00_Portalprofile_und_Vertragsvorlagen.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: fachliches-konzept
|
||||
titel: Portalprofile, Konditionsquellen und Vertragsvorlagen
|
||||
status: diskussionsentwurf
|
||||
-version: "0.2"
|
||||
+version: "0.3"
|
||||
stand: 2026-10-31
|
||||
prozess: V01
|
||||
bezugsstand_archetypen: "0.6"
|
||||
@@ -66,7 +66,7 @@
|
||||
- Zahlung nach aktuellem Ablauf über FeWo-direkt. Vertragsdokumentation und lokale Gästebetreuung bei uns; Storno-/Mahnverantwortung ist noch genauer zu prüfen.
|
||||
- Die heutige FeWo-direkt-Vertragsvorlage ist **ein spezielles Dokumentenprofil**, kein globaler Vertragsstandard.
|
||||
|
||||
-Siehe [A04 – Analyse der bisherigen FeWo-direkt-Vertragsvorlage](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md).
|
||||
+Siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 – Analyse der bisherigen FeWo-direkt-Vertragsvorlage]].
|
||||
|
||||
## 7. Bewusste Grenzen / offene Punkte
|
||||
|
||||
@@ -101,4 +101,8 @@
|
||||
- **FeWo-direkt (A4):** Eigene Miet-/Rabatt-/Stornokonfiguration im Portal; im Vermieterposteingang sind bei einer Buchung einzelne Summen, Zahlungsraten und erwartete Auszahlung ersichtlich, nicht notwendigerweise die Einzelpreiszerlegung. Eigener statischer Mietvertrag bislang nicht im Inserat hinterlegt. Angeblich/öffentlich angebotene Funktionen sind nicht automatisch im konkreten Betreiberkonto vorhanden.
|
||||
- **Destination Solutions (A3):** Extern bereits verbindliche Buchung; danach vollständige Abwicklung beim Vermieter. **In aktuellem Betreiberzugang keine Kalendersynchronisation**; manuelle Portalsperrung mit begrenzter Nachweisbarkeit. Provision kann nach Vertriebskanal differieren; Gast-Serviceaufschlag, Preisaufschläge und vorvertragliche Anzeige der Stornobedingungen sind noch ungeklärt.
|
||||
|
||||
-Details: [K01 Preise & Abrechnung](K01_Preisstruktur_und_Abrechnung.md); [R08 Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md); [O00 offene Fragen](O00_Offene_Portalprueffaelle.md).
|
||||
+Details: [[K01_Preisstruktur_und_Abrechnung|K01 Preise & Abrechnung]]; [[R00_Szenarien/R08_Destination_Solutions|R08 Destination Solutions]]; [[O00_Offene_Portalprueffaelle|O00 offene Fragen]].
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Buchungsarchetypen|Archetypen]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02 Vertragsverbindlichkeit]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Vertragsabwicklung]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]] · [[O00_Offene_Portalprueffaelle|Offene Fragen]]
|
||||
--- v0.7/00_Prozesslandkarte.md
|
||||
+++ v0.8/00_Prozesslandkarte.md
|
||||
@@ -3,10 +3,10 @@
|
||||
typ: prozesslandkarte
|
||||
titel: FewoPortal – Prozesslandkarte
|
||||
status: arbeitsstand
|
||||
-version: '0.7'
|
||||
+version: "0.8"
|
||||
---
|
||||
|
||||
-# 00 – Prozesslandkarte FewoPortal v0.7
|
||||
+# 00 – Prozesslandkarte FewoPortal v0.8
|
||||
|
||||
**Status:** gemeinsamer Arbeitsstand; übergreifendes Modell, nicht vollständig freigegeben.
|
||||
**Stand:** 31.10.2026
|
||||
@@ -125,4 +125,8 @@
|
||||
|
||||
**Nachträgliche Ereignisse (E-019):** Änderungsanfrage, bestätigte Änderung, Stornierungswunsch und wirksame Stornierung unterscheiden. Ursache, Durchführender, vertragliche Folgen, Belegung und Geldflüsse getrennt dokumentieren.
|
||||
|
||||
-**Zu vertiefen:** [K01 Preis- und Abrechnungsmodell](K01_Preisstruktur_und_Abrechnung.md), [X01 Belegungskonflikt- und Sperrnachweise](X01_Belegungskonflikte_und_Sperrnachweise.md), [O00 offene Portalfragen](O00_Offene_Portalprueffaelle.md).
|
||||
+**Zu vertiefen:** [[K01_Preisstruktur_und_Abrechnung|K01 Preis- und Abrechnungsmodell]], [[X01_Belegungskonflikte_und_Sperrnachweise|X01 Belegungskonflikt- und Sperrnachweise]], [[O00_Offene_Portalprueffaelle|O00 offene Portalfragen]].
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01 Buchungseingang]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02 Konditionen und Bindung]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Verwaltung und Abwicklung]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04 Aufenthalt]] · [[P05/P05_Abschluss_und_Nachbereitung|P05 Abschluss]] · [[G00_Gates_und_Uebergaben|Gates]] · [[S00_Supportprozesse|Supportprozesse]] · [[X00_Sonderprozesse|Sonderprozesse]] · [[00_Buchungsarchetypen|Archetypen]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
|
||||
--- v0.7/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md
|
||||
+++ v0.8/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessanalyse
|
||||
titel: FeWo-direkt – Vertragsvorlage und Einordnung in den A4-Istprozess
|
||||
status: diskussionsentwurf
|
||||
-version: "0.5"
|
||||
+version: "0.6"
|
||||
stand: 2026-10-31
|
||||
prozess: V01
|
||||
archetyp: A4
|
||||
@@ -81,7 +81,7 @@
|
||||
|
||||
**Welche Konditionen sieht und bestätigt der Gast bei einer konkreten FeWo-direkt-Direktbuchung und welche Dokumente erhält er anschließend tatsächlich vom Portal?**
|
||||
|
||||
-Der nachträgliche eigene Mietvertrag ist **nicht** vorab hinterlegt. Ein extern zu prüfender Beispielbuchungsablauf bzw. belegbarer Buchungsauszug soll die tatsächlichen Konditionen und Dokumente identifizieren; die Buchung bleibt schon vor unserer Datennachforderung verbindlich, soweit der Portalabschluss dies belegt. Auf Basis dieser Feststellung wird je Kanal die passende **versionierte eigene Vertrags-/Dokumentenvorlage** zugeordnet. Siehe [Portalprofile und Vertragsvorlagen](00_Portalprofile_und_Vertragsvorlagen.md).
|
||||
+Der nachträgliche eigene Mietvertrag ist **nicht** vorab hinterlegt. Ein extern zu prüfender Beispielbuchungsablauf bzw. belegbarer Buchungsauszug soll die tatsächlichen Konditionen und Dokumente identifizieren; die Buchung bleibt schon vor unserer Datennachforderung verbindlich, soweit der Portalabschluss dies belegt. Auf Basis dieser Feststellung wird je Kanal die passende **versionierte eigene Vertrags-/Dokumentenvorlage** zugeordnet. Siehe [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile und Vertragsvorlagen]].
|
||||
|
||||
## 6. Öffentliche Quellen für die juristisch-technischen Prüfpunkte
|
||||
|
||||
@@ -167,4 +167,8 @@
|
||||
4. **Sonderprozesse:** Bisher keine konkret selbst durchlaufene FeWo-direkt-Buchungsänderung und keine eigene Vermieterstornierung. Kein nicht erprobtes Verfahren als gelebte Praxis behaupten. Differenzierung **tatsächliche Stornoursache, Antragsteller, ausführender Beteiligter** beachten.
|
||||
5. **Abrechnung:** Unbekannte Gast-Servicegebühren, Portalabzüge, Vermieterprovisionen oder kombinierte Sammelpositionen müssen nicht künstlich zerlegt werden. Portalinformationen und manuelle Ergänzungen mit Quelle sichern; bei abweichenden Summen Klärungsaufgabe.
|
||||
|
||||
-Fachliche Konkretisierung: [K01](K01_Preisstruktur_und_Abrechnung.md), [X01](X01_Belegungskonflikte_und_Sperrnachweise.md) und [O00](O00_Offene_Portalprueffaelle.md). Keine Aktualisierung oder juristische Freigabe des ursprünglichen PDF-Vertrags durch diese Analyse.
|
||||
+Fachliche Konkretisierung: [[K01_Preisstruktur_und_Abrechnung|K01]], [[X01_Belegungskonflikte_und_Sperrnachweise|X01]] und [[O00_Offene_Portalprueffaelle|O00]]. Keine Aktualisierung oder juristische Freigabe des ursprünglichen PDF-Vertrags durch diese Analyse.
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Buchungsarchetypen|Archetypen]] · [[00_Portalprofile_und_Vertragsvorlagen|Vertragsprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[O00_Offene_Portalprueffaelle|Offene Prüffälle]] · [[P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_historisch|Frühere Fassung im P03-Archiv]]
|
||||
--- v0.7/AENDERUNGSNOTIZ.md
|
||||
+++ v0.8/AENDERUNGSNOTIZ.md
|
||||
@@ -1,3 +1,11 @@
|
||||
+---
|
||||
+id: CHANGE-NOTE
|
||||
+typ: dokumentationshilfe
|
||||
+titel: "Änderungsnotiz"
|
||||
+status: arbeitsstand
|
||||
+version: "0.1"
|
||||
+---
|
||||
+
|
||||
# Änderungsnotiz – Portalprofile und Vertragsvorlagen (31.10.2026)
|
||||
|
||||
- `00_Buchungsarchetypen.md`: v0.2 → v0.3, **Abschnitt 7 neu**, frühere Abschnitte 7/8 nur umnummeriert; bestehende Archetypen/Gates unverändert.
|
||||
@@ -5,3 +13,7 @@
|
||||
- `00_Portalprofile_und_Vertragsvorlagen.md`: **neu** v0.1, portable Portal-/Buchungstyp-/Herkunftsprofile, zugehörige Vertragsvorlagen/Anlagen, Konditionsquellen, Snapshot/Gates.
|
||||
|
||||
**Keine Produktivänderungen, kein Code.** Dateien für manuelle Übernahme in bestehende Gitea-Dokumentation; Repository-Stand konnte nicht gegen Gitea selbst verglichen werden. Änderungen vor Übernahme gegen aktuelle Git-Dateien prüfen.
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[AENDERUNGSUEBERSICHT|Änderungsübersicht]]
|
||||
--- v0.7/AENDERUNGSUEBERSICHT.md
|
||||
+++ v0.8/AENDERUNGSUEBERSICHT.md
|
||||
@@ -1,3 +1,11 @@
|
||||
+---
|
||||
+id: CHANGELOG
|
||||
+typ: dokumentationshilfe
|
||||
+titel: "Änderungshistorie"
|
||||
+status: arbeitsstand
|
||||
+version: "0.1"
|
||||
+---
|
||||
+
|
||||
# Änderung v0.6 gegenüber v0.5
|
||||
|
||||
- **E-011 bestätigt:** Alternative fachliche Endergebnisse von V01: regulär abgeschlossen, ohne Buchung beendet, storniert (nach Verbindlichkeit). Keine zusätzlichen Buchungsworkflows.
|
||||
@@ -17,3 +25,17 @@
|
||||
- Neues Portalfragenregister und verbindliche Dokumentationsarbeitsregel: aktuelle Originaldokumente künftig **vor jedem Edit erneut anfordern**.
|
||||
- R01-Referenzentwurf inhaltlich unverändert übernommen, R08 neu ergänzt.
|
||||
- Ausgangsdokumente unverändert gelassen; Diff und Prüfliste im Paket. Keine Gitea-Änderung/Implementierungsfreigabe.
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[D00_Dokumentationsregel_und_Uebergabe|Dokumentationsregeln]] · [[QUELLENMANIFEST|Quellenmanifest]]
|
||||
+
|
||||
+# Änderung v0.8 gegenüber v0.7 – Obsidian-Verknüpfungen (31.10.2026)
|
||||
+
|
||||
+- Ausgangspunkt: vom Betreiber erneut hochgeladene vollständige ZIP-Fassung „v0.7 komplett.zip“. Keine Übernahme einer unbestätigten Gitea-Version behauptet.
|
||||
+- Interne relative Markdown-Links in eindeutige Obsidian-Wikilinks mit Vault-relativen Pfaden umgewandelt; externe Quellen-URLs unverändert.
|
||||
+- Verknüpfungsnavigation für sämtliche vorhandenen Markdown-Dokumente ergänzt, mit README als Startseite und P01–P05 als zusammenhängendem Phasenpfad.
|
||||
+- Ein bestehender Verweis auf Abschnitt 7 der FeWo-direkt-Analyse in einen Obsidian-Überschriftenlink umgewandelt.
|
||||
+- Zwei Dateien mit gleichem Namen und gleicher Dokumenten-ID „A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md“ identifiziert: P03-Unterordnerdatei als historische Fassung eindeutig umbenannt und historischer Identifikator abgesetzt. Die aktuelle kanonische Datei im Root bleibt am ursprünglichen Pfad.
|
||||
+- **Keine inhaltliche Änderung an den Buchungs-/Vertrags-/Zahlungsentscheidungen**. Die ursprünglichen Änderungs-Diffs zu v0.5–v0.7 bleiben unverändert, ein eigener Diff v0.8 wird ergänzt.
|
||||
+- Alle Wikilinks und Überschriftenziele programmatisch auf vorhandene Dateien/Abschnitte geprüft.
|
||||
--- v0.7/D00_Dokumentationsregel_und_Uebergabe.md
|
||||
+++ v0.8/D00_Dokumentationsregel_und_Uebergabe.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: arbeitsregel
|
||||
titel: Dokumentationsregeln, Quellenbasis und Übergabe
|
||||
status: diskussionsentwurf
|
||||
-version: "0.1"
|
||||
+version: "0.2"
|
||||
stand: 2026-10-31
|
||||
---
|
||||
|
||||
@@ -32,3 +32,13 @@
|
||||
## Kompakter Kontext für den nächsten Chat
|
||||
|
||||
FewoPortal ist eine **kleine, mandantenfähige Vermieterwebsite-/Buchungsanwendung für typischerweise 1–3 Ferienwohnungen je Vermieter, kein Marktplatz**. Ein gemeinsamer Hauptprozess V01 P01–P05, dazu V02 Vermarktung/Gästegewinnung/Gästebindung. Fünf Archetypen: A1 eigene Webseite, A2 externe unverbindliche Anfrage, A3 externe verbindliche Buchung mit weiterer eigener Gesamtabwicklung (**Destination Solutions**), A4 externe verbindliche Buchung mit geteilter Abwicklung (**FeWo-direkt**), A5 überwiegend externe Vollabwicklung. **A6 gestrichen**; Partnerherkunft nur bei Provisionsrelevanz. Ein Vorgang/eine Akte. Externer Preis und beim Vertragsschluss vereinbarte Bedingungen bleiben maßgeblich, spätere Dokumente keine stillen neuen Pflichten. Unterschiedliche/versionierte Vorlagen pro Kanal/Buchungstyp. Portale liefern unterschiedlich vollständige Daten; **manuelle Bearbeitung und Sammel-/Gesamtpreise** sind konstitutive Fachfunktionen. Gast-Mietforderung, externe Gastgebühr, Vermieterprovision, Auszahlung und Zahlung getrennt. Kein Erfinden unbekannter Gebührenanteile. Verfügbarkeit extern nicht garantiert: FeWo-direkt verzögerter iCal-Import, Destination Solutions manuelles Sperren ohne verlässlichen Portal-/Partnernachweis; Doppelbuchungen möglich, deshalb Ausnahmeprozess und Belegkette. Nicht bekannte Vertrags- und Portalfragen im O00-Prüffallregister. **Vor der nächsten Dokumentbearbeitung aktuelle Gitea-Fassung explizit erfragen.**
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[E00_Entscheidungsprotokoll|Entscheidungen]] · [[QUELLENMANIFEST|Quellenmanifest]] · [[AENDERUNGSUEBERSICHT|Änderungshistorie]]
|
||||
+
|
||||
+## Technische Dokumentationsregel v0.8 – Obsidian
|
||||
+
|
||||
+- Die Dokumentationsbasis wird als Obsidian-Vault genutzt; Querverweise zwischen Markdown-Dateien bevorzugt als eindeutige Wikilinks mit Pfad und Anzeigename erstellen.
|
||||
+- Nach jeder Dateiänderung interne Links, Überschriftenverweise und vorhandene Zielnotizen prüfen; keine Phantom-Links oder versehentliche Duplikate erzeugen.
|
||||
+- **Unverändert bindend:** Vor der nächsten Dokumentänderung die dann aktuelle Gitea-Originalfassung beim Betreiber ausdrücklich erneut anfordern.
|
||||
--- v0.7/E00_Entscheidungsprotokoll.md
|
||||
+++ v0.8/E00_Entscheidungsprotokoll.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: entscheidungsprotokoll
|
||||
titel: Entscheidungsprotokoll
|
||||
status: arbeitsstand
|
||||
-version: '0.7'
|
||||
+version: "0.8"
|
||||
---
|
||||
|
||||
# E00 – Entscheidungsprotokoll
|
||||
@@ -61,4 +61,8 @@
|
||||
|
||||
**Nicht beschlossen:** Dass technische Portalprobleme automatisch rechtlich fehlendes Verschulden beweisen; dass eine 10-Minuten-Freigabe heute bei den genannten Portalen möglich ist; dass alle Portale gleiche Preis-/Gast-/Zahlungsdaten bereitstellen; dass nachträglich versandte Stornobedingungen wirksam werden. Solche Aussagen bleiben Prüffälle.
|
||||
|
||||
-**Weitere Fachkonzepte:** [Archetypen A1–A5](00_Buchungsarchetypen.md), [Portal-/Vertragsprofile](00_Portalprofile_und_Vertragsvorlagen.md), [Flexible kaufmännische Positionen](K01_Preisstruktur_und_Abrechnung.md), [Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md), [offene Portalprüffälle](O00_Offene_Portalprueffaelle.md).
|
||||
+**Weitere Fachkonzepte:** [[00_Buchungsarchetypen|Archetypen A1–A5]], [[00_Portalprofile_und_Vertragsvorlagen|Portal-/Vertragsprofile]], [[K01_Preisstruktur_und_Abrechnung|Flexible kaufmännische Positionen]], [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]], [[O00_Offene_Portalprueffaelle|offene Portalprüffälle]].
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[00_Buchungsarchetypen|Archetypen]] · [[G00_Gates_und_Uebergaben|Gates]] · [[D00_Dokumentationsregel_und_Uebergabe|Dokumentationsregeln]] · [[O00_Offene_Portalprueffaelle|Offene Prüffälle]]
|
||||
--- v0.7/G00_Gates_und_Uebergaben.md
|
||||
+++ v0.8/G00_Gates_und_Uebergaben.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: gate-modell
|
||||
titel: Gate- und Übergabemodell
|
||||
status: arbeitsstand
|
||||
-version: '0.7'
|
||||
+version: "0.8"
|
||||
---
|
||||
|
||||
# G00 – Gate- und Übergabemodell (Arbeitsstand)
|
||||
@@ -52,3 +52,7 @@
|
||||
- **X02/X04/X07:** Storno-/Änderungsantrag ist **kein** wirksames Ergebnis. Bei Belegungskonflikt Ursache, zeitliche Abfolge, Bindung beider Buchungen, belegte extern wirksame Sperren und verbleibende Handlungsmöglichkeiten erfassen; Verantwortlichkeit wird nicht aus einem einzigen Button abgeleitet.
|
||||
|
||||
**Evidenzstatus je Datenpunkt:** `übermittelt / durch externe Quelle behauptet / anhand Beleg geprüft / intern erfasst / manuell ergänzt / nicht geliefert / widersprüchlich / nicht anwendbar`; als **fachliche Beispiele**, nicht als freigegebene technische Enum. `unbekannt` ist **nicht** `0` oder `nicht vorhanden`.
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04]] · [[P05/P05_Abschluss_und_Nachbereitung|P05]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
|
||||
--- v0.7/K01_Preisstruktur_und_Abrechnung.md
|
||||
+++ v0.8/K01_Preisstruktur_und_Abrechnung.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: fachliches-konzept
|
||||
titel: Preis-, Gebühren- und Abrechnungsinformationen
|
||||
status: diskussionsentwurf
|
||||
-version: "0.1"
|
||||
+version: "0.2"
|
||||
stand: 2026-10-31
|
||||
---
|
||||
|
||||
@@ -59,7 +59,7 @@
|
||||
|
||||
## 6. Reale Prüfbeispiele
|
||||
|
||||
-**FeWo-direkt A4 – beobachteter Screenshot, Buchung 10.–17.07.2027:** 840,00 € Übernachtungen, −42,00 € Rabatt, +181,51 € „Gebühren und Steuern“, 979,51 € Gastgesamtbetrag, −84,82 € „An FeWo-direkt gezahlt“, 894,69 € ausgewiesene Gesamtauszahlung. In anderer Ansicht 900,20 € erwartete Auszahlung (5,51 € Differenz). Sichtbarer Zahlungsplan 390,61 € bezahlt und 588,90 € später fällig. **Keine belegte Zerlegung** von 181,51 €/84,82 € oder der 5,51-€-Differenz; einzelne Tagespreise fehlen. Siehe [A04 Abschnitt 7](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md).
|
||||
+**FeWo-direkt A4 – beobachteter Screenshot, Buchung 10.–17.07.2027:** 840,00 € Übernachtungen, −42,00 € Rabatt, +181,51 € „Gebühren und Steuern“, 979,51 € Gastgesamtbetrag, −84,82 € „An FeWo-direkt gezahlt“, 894,69 € ausgewiesene Gesamtauszahlung. In anderer Ansicht 900,20 € erwartete Auszahlung (5,51 € Differenz). Sichtbarer Zahlungsplan 390,61 € bezahlt und 588,90 € später fällig. **Keine belegte Zerlegung** von 181,51 €/84,82 € oder der 5,51-€-Differenz; einzelne Tagespreise fehlen. Siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 Abschnitt 7]].
|
||||
|
||||
**Destination Solutions A3 – Betreiberangaben:** Extern bestätigter Buchungspreis ist zu übernehmen und Zahlung durch Vermieter abzuwickeln. Provisionssatz kann nach vermittelndem Partner variieren. Ob Partnerportal den Endpreis erhöht oder eine separate Gast-Servicegebühr erhebt, ist derzeit nicht bestätigt; auch dort darf nur ein übermittelter Gesamtpreis zulässig sein. Keine nachträgliche Provisionsbelastung des Gastes.
|
||||
|
||||
@@ -70,4 +70,8 @@
|
||||
- Welche Vereinbarungen gelten für Stornokostenbasis („Mietpreis“ vs. Gesamtbetrag; inkludierte/ausgeschlossene Leistungen), wenn nur eine Gesamtsumme vorliegt?
|
||||
- Welche individuellen Portalberichte, tatsächlichen Zahlungsnachweise und Importformate stehen zur Verfügung?
|
||||
|
||||
-**Fachliche Herkunft:** Betreiberinterview vom 31.10.2026, FeWo-direkt-Screenshots, [E00 E-014–E-020](E00_Entscheidungsprotokoll.md). Rechtliche Gestaltung separat prüfen.
|
||||
+**Fachliche Herkunft:** Betreiberinterview vom 31.10.2026, FeWo-direkt-Screenshots, [[E00_Entscheidungsprotokoll|E00 E-014–E-020]]. Rechtliche Gestaltung separat prüfen.
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt]]
|
||||
--- v0.7/O00_Offene_Portalprueffaelle.md
|
||||
+++ v0.8/O00_Offene_Portalprueffaelle.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prueffallregister
|
||||
titel: Portalbezogene Prüf- und Klärungsfälle
|
||||
status: diskussionsentwurf
|
||||
-version: "0.1"
|
||||
+version: "0.2"
|
||||
stand: 2026-10-31
|
||||
---
|
||||
|
||||
@@ -46,4 +46,8 @@
|
||||
|
||||
Pro Portal idealerweise **ein vollständig anonymisierter realer Buchungsfall**, Gast-Buchungsbestätigung soweit vorhanden, Betreiber-Provisionsabrechnung, Preis-/Stornokonfiguration und ein Beispiel für Änderung/Stornierung. **Nicht alle Nachweise müssen jetzt vorliegen**; Fehlen führt zu manuellen Aufgaben oder offenen Informationsfeldern, nicht zum Erfinden von Regeln.
|
||||
|
||||
-**Referenzen:** [Portalprofil K00](00_Portalprofile_und_Vertragsvorlagen.md), [Preisstruktur K01](K01_Preisstruktur_und_Abrechnung.md), [FeWo-direkt A04](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md), [Destination Solutions R02](R00_Szenarien/R08_Destination_Solutions.md).
|
||||
+**Referenzen:** [[00_Portalprofile_und_Vertragsvorlagen|Portalprofil K00]], [[K01_Preisstruktur_und_Abrechnung|Preisstruktur K01]], [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt A04]], [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions R02]].
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
|
||||
--- v0.7/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
|
||||
+++ v0.8/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Buchungseingang und Verfügbarkeitssicherung
|
||||
status: entwurf
|
||||
-version: '0.7'
|
||||
+version: "0.8"
|
||||
---
|
||||
|
||||
# P01 – Buchungseingang und Verfügbarkeitssicherung
|
||||
@@ -38,4 +38,8 @@
|
||||
- **Portalunabhängig:** Art des Belegungs-Inputs (iCal, API, E-Mail, manuell), Ausführungspfad (automatisch/manuell/hybrid), Verzögerung/Unsicherheit und Kontrollmöglichkeiten im Portalprofil hinterlegen. Neue, extern **bereits verbindliche** Kollisionsbuchung als Konflikt behandeln; keine stillschweigende Ablehnung oder Löschung.
|
||||
- **Drei Sperrzustände:** `Sperrung veranlasst`, `im Zielportal sichtbar`, `nachweislich im relevanten Vertrieb wirksam`. Fehlender Nachweis bleibt **unbekannt**. Für eigene Holds eigene atomare Freihaltung und Sicherung des bindenden Angebots prüfen, ohne fremde Echtzeitwirkung zu versprechen.
|
||||
|
||||
-Siehe [X01 – Konfliktmanagement und Nachweise](../X01_Belegungskonflikte_und_Sperrnachweise.md).
|
||||
+Siehe [[X01_Belegungskonflikte_und_Sperrnachweise|X01 – Konfliktmanagement und Nachweise]].
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|Weiter zu P02]] · [[G00_Gates_und_Uebergaben|Gates]] · [[X01_Belegungskonflikte_und_Sperrnachweise|X07 Belegungskonflikte]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]]
|
||||
--- v0.7/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
|
||||
+++ v0.8/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Konditionen und Buchungsverbindlichkeit
|
||||
status: entwurf
|
||||
-version: '0.7'
|
||||
+version: "0.8"
|
||||
---
|
||||
|
||||
# P02 – Konditionen und Buchungsverbindlichkeit
|
||||
@@ -58,4 +58,8 @@
|
||||
- **Vorvertragliche Einbeziehung:** Ob dem Gast vor Abschluss Stornostaffeln, Pflichtgebühren und sonstige Bedingungen angezeigt wurden, ist je Portal zu prüfen; ein nachträgliches Dokument erzeugt nicht automatisch neue Vertragspflichten.
|
||||
- **Destination Solutions:** Genannte Stornostaffel (vom Betreiber berichtet): mindestens 60 Tage vorher 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, 11 Tage oder weniger 100 % des „Mietpreises“. **Ungeklärt:** Nachweis im Buchungsprozess, Durchsetzbarkeit, genaue Kostenbasis. Nicht als globalen A3-Standard verwenden.
|
||||
|
||||
-Siehe [K00](../00_Portalprofile_und_Vertragsvorlagen.md), [K01](../K01_Preisstruktur_und_Abrechnung.md) und [R08 Destination Solutions](../R00_Szenarien/R08_Destination_Solutions.md).
|
||||
+Siehe [[00_Portalprofile_und_Vertragsvorlagen|K00]], [[K01_Preisstruktur_und_Abrechnung|K01]] und [[R00_Szenarien/R08_Destination_Solutions|R08 Destination Solutions]].
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|Zurück zu P01]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|Weiter zu P03]] · [[G00_Gates_und_Uebergaben|Gates]] · [[00_Portalprofile_und_Vertragsvorlagen|Vertragsprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]]
|
||||
--- v0.7/P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md
|
||||
+++ v0.8/P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_historisch.md
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
-id: A04-DOK-01
|
||||
+id: A04-DOK-ARCHIV
|
||||
typ: prozessanalyse
|
||||
titel: FeWo-direkt – Vertragsvorlage und Einordnung in den A4-Istprozess
|
||||
status: diskussionsentwurf
|
||||
-version: "0.2"
|
||||
+version: "0.3"
|
||||
stand: 2026-10-31
|
||||
prozess: V01
|
||||
archetyp: A4
|
||||
@@ -12,7 +12,9 @@
|
||||
- "Betreiberbeschreibung: manueller A4-Istprozess, 31.10.2026"
|
||||
---
|
||||
|
||||
-# A4 – Vertragsvorlage und Prozessanalyse
|
||||
+> **Historischer Bearbeitungsstand (ursprünglich v0.2)** – für die aktuelle Analyse siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A4 – aktuelle Hauptfassung]].
|
||||
+
|
||||
+# A4 – Vertragsvorlage und Prozessanalyse (historische Fassung)
|
||||
|
||||
> **Arbeitsdokument, keine Freigabe zur Änderung rechtlicher Klauseln.** Die Vertragsvorlage ist ein Beispiel für den aktuellen Ablauf, kein Nachweis der beim Buchungsabschluss über FeWo-direkt tatsächlich akzeptierten Konditionen. **Zugangscodes, Passwörter, persönliche Kontaktdaten und Namen von Gästen werden hier bewusst nicht reproduziert.**
|
||||
|
||||
@@ -81,7 +83,7 @@
|
||||
|
||||
**Welche Konditionen sieht und bestätigt der Gast bei einer konkreten FeWo-direkt-Direktbuchung und welche Dokumente erhält er anschließend tatsächlich vom Portal?**
|
||||
|
||||
-Der nachträgliche eigene Mietvertrag ist **nicht** vorab hinterlegt. Ein extern zu prüfender Beispielbuchungsablauf bzw. belegbarer Buchungsauszug soll die tatsächlichen Konditionen und Dokumente identifizieren; die Buchung bleibt schon vor unserer Datennachforderung verbindlich, soweit der Portalabschluss dies belegt. Auf Basis dieser Feststellung wird je Kanal die passende **versionierte eigene Vertrags-/Dokumentenvorlage** zugeordnet. Siehe [Portalprofile und Vertragsvorlagen](00_Portalprofile_und_Vertragsvorlagen.md).
|
||||
+Der nachträgliche eigene Mietvertrag ist **nicht** vorab hinterlegt. Ein extern zu prüfender Beispielbuchungsablauf bzw. belegbarer Buchungsauszug soll die tatsächlichen Konditionen und Dokumente identifizieren; die Buchung bleibt schon vor unserer Datennachforderung verbindlich, soweit der Portalabschluss dies belegt. Auf Basis dieser Feststellung wird je Kanal die passende **versionierte eigene Vertrags-/Dokumentenvorlage** zugeordnet. Siehe [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile und Vertragsvorlagen]].
|
||||
|
||||
## 6. Öffentliche Quellen für die juristisch-technischen Prüfpunkte
|
||||
|
||||
@@ -98,3 +100,7 @@
|
||||
- [Kühlungsborn – Kurabgabe](https://www.kuehlungsborn.de/kurabgabe/)
|
||||
|
||||
**Abgrenzung:** Dies ist eine fachliche Prozess- und Risikoprüfung, keine rechtliche Freigabe und keine eigenmächtige Überarbeitung der Betreiber-Vertragstexte.
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|Aktuelle FeWo-direkt-Analyse]]
|
||||
--- v0.7/P03/P03_Buchungsverwaltung_und_Abwicklung.md
|
||||
+++ v0.8/P03/P03_Buchungsverwaltung_und_Abwicklung.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Buchungsverwaltung und kaufmännische Abwicklung
|
||||
status: entwurf
|
||||
-version: '0.7'
|
||||
+version: "0.8"
|
||||
---
|
||||
|
||||
# P03 – Buchungsverwaltung und kaufmännische Abwicklung
|
||||
@@ -38,4 +38,8 @@
|
||||
6. **Destination Solutions A3:** Vermieter führt Vertrag, Zahlungsanforderung, Zahlungskontrolle und ggf. Stornobearbeitung; Höhe der Vermittlerprovision je Herkunft unterschiedlich möglich. Keine zusätzliche Provisionsrechnung an den Gast ohne vorbestehende Vereinbarung.
|
||||
7. **FeWo-direkt A4:** Sichtbarer Gastzahlungsplan und erwartete Auszahlung ersetzen weder den Beleg über Bankeingang noch vollständige Gebührenaufschlüsselung; siehe konkrete A4-Screenshots und offenen 5,51-€-Differenzfall.
|
||||
|
||||
-[Vertiefung: K01](../K01_Preisstruktur_und_Abrechnung.md).
|
||||
+[[K01_Preisstruktur_und_Abrechnung|Vertiefung: K01]].
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|Zurück zu P02]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|Weiter zu P04]] · [[K01_Preisstruktur_und_Abrechnung|Preis und Abrechnung]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|Aktuelle FeWo-direkt-Analyse]] · [[P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_historisch|Historischer FeWo-direkt-Entwurf]]
|
||||
--- v0.7/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
|
||||
+++ v0.8/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Leistungsvorbereitung und Aufenthalt
|
||||
status: entwurf
|
||||
-version: '0.7'
|
||||
+version: "0.8"
|
||||
---
|
||||
|
||||
# P04 – Leistungsvorbereitung und Aufenthalt
|
||||
@@ -30,3 +30,7 @@
|
||||
## Ergänzung v0.7: externe Kommunikationszuständigkeit
|
||||
|
||||
Bei Portal-Direktbuchungen unterscheiden: Portal kündigt Gastnachricht an, Portalversand ist tatsächlich bestätigt oder Vermieter versendet eigene Informationen. FeWo-direkt kündigt in der gezeigten Buchung eine E-Mail etwa 72 Stunden vor Anreise an; dies ist **noch kein Nachweis**, dass sie dem Gast zugegangen ist. Falls erforderliche Gäste-/Meldedaten fehlen, manuell nachfordern. Bei Destination Solutions führt Vermieter die Gast- und Dienstleisterkommunikation im Rahmen der eigenen Abwicklung.
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|Zurück zu P03]] · [[P05/P05_Abschluss_und_Nachbereitung|Weiter zu P05]] · [[G00_Gates_und_Uebergaben|Gates]] · [[S00_Supportprozesse|Supportprozesse]]
|
||||
--- v0.7/P05/P05_Abschluss_und_Nachbereitung.md
|
||||
+++ v0.8/P05/P05_Abschluss_und_Nachbereitung.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozessphase
|
||||
titel: Abschluss und Nachbereitung
|
||||
status: entwurf
|
||||
-version: '0.7'
|
||||
+version: "0.8"
|
||||
---
|
||||
|
||||
# P05 – Abschluss und Nachbereitung
|
||||
@@ -33,3 +33,7 @@
|
||||
## Ergänzung v0.7: Abrechnung und Nachweislücken
|
||||
|
||||
Eine Buchung darf nach erbrachter Leistung fachlich regulär enden, selbst wenn **Provisionsaufschlüsselung, ausstehende Auszahlung oder ungeklärte Sammelgebühren** in einem gesondert zugewiesenen Folgefall weiterbearbeitet werden. Gastbezogene offene Forderungen, Storno- oder Auszahlungsdifferenzen müssen mit Quelle, Verantwortlichem und Buchungsreferenz nachvollziehbar übergeben werden. Fehlende detaillierte Preisaufteilung ist nicht automatisch eine unvollständige Gastleistung.
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|Zurück zu P04]] · [[G00_Gates_und_Uebergaben|Gates]] · [[S00_Supportprozesse|Supportprozesse]]
|
||||
--- v0.7/QUELLENMANIFEST.md
|
||||
+++ v0.8/QUELLENMANIFEST.md
|
||||
@@ -1,3 +1,11 @@
|
||||
+---
|
||||
+id: SOURCE-MANIFEST
|
||||
+typ: dokumentationshilfe
|
||||
+titel: "Quellenmanifest"
|
||||
+status: arbeitsstand
|
||||
+version: "0.1"
|
||||
+---
|
||||
+
|
||||
# QUELLENMANIFEST – FewoPortal v0.7
|
||||
|
||||
Erstellt: 2026-10-31. 22 Markdown-Dateien im Paket.
|
||||
@@ -33,3 +41,7 @@
|
||||
- R01 / R00 Szenarien: `/mnt/data/FewoPortal_R01_Arbeitsentwurf/R00_Szenarien/`.
|
||||
- Entscheidungen: Nutzerinterview vom 31.10.2026.
|
||||
- Gitea-Stand unbekannt und nicht verändert. **Vor weiteren Änderungen aktuelle Originale anfordern.**
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[D00_Dokumentationsregel_und_Uebergabe|Dokumentationsregeln]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
|
||||
--- v0.7/R00_Szenarien/00_Szenariomatrix.md
|
||||
+++ v0.8/R00_Szenarien/00_Szenariomatrix.md
|
||||
@@ -4,7 +4,7 @@
|
||||
titel: Buchungsszenarien und Vergleichsfälle
|
||||
autor: FewoPortal Fachinterview
|
||||
status: diskussionsentwurf
|
||||
-version: '0.2'
|
||||
+version: "0.3"
|
||||
---
|
||||
|
||||
# R00 – Buchungsszenarien und Vergleichsfälle
|
||||
@@ -13,7 +13,7 @@
|
||||
|
||||
| ID | Szenario | Eingang und Bindung | Typische Abweichung | Bearbeitungsstand |
|
||||
|---|---|---|---|---|
|
||||
-| R01 | Eigene Webseite | Anfrage → eigenes bindendes Angebot → Annahme | Hold/Angebotsfrist, eigene Zahlung, Kalenderabgleich | **In Diskussion:** [R01](R01_Eigene_Webseite.md) |
|
||||
+| R01 | Eigene Webseite | Anfrage → eigenes bindendes Angebot → Annahme | Hold/Angebotsfrist, eigene Zahlung, Kalenderabgleich | **In Diskussion:** [[R00_Szenarien/R01_Eigene_Webseite|R01]] |
|
||||
| R02 | Telefonisch/manuell | Manuell erfasste Anfrage → eigenes Angebot | Eingabe durch Betreiber, Kommunikationskanal | Vorgemerkt |
|
||||
| R03 | Unverbindliche Portalanfrage | Portal-Anfrage → eigenes Angebot → Annahme | Fehlende Gastdaten, Portal-Kommunikation | Vorgemerkt |
|
||||
| R04 | Verbindliche Portalbuchung, Vertrag durch uns | Bereits extern verbindlich | Externer bindender Preis, nachträgliche Vertragsdokumentation ohne erneute Annahme, Zahlung je Portal | Vorgemerkt |
|
||||
@@ -26,4 +26,8 @@
|
||||
|
||||
## Ergänzung v0.2: Externe Direktbuchung
|
||||
|
||||
-**R08 – Destination Solutions (A3):** Bereits verbindliche Buchung, danach Vertrags-/Zahlungs-/Gastabwicklung durch Vermieter; manuelle Sperre externer Kalender, kein belegter Partner-Sync; unterschiedliche Vermittlerprovisionen je Kanal, zusätzliche Gastgebühren und einzelne Preispositionen derzeit unklar. **A6 entfällt** als Archetyp. [R08 Referenzfall](R08_Destination_Solutions.md).
|
||||
+**R08 – Destination Solutions (A3):** Bereits verbindliche Buchung, danach Vertrags-/Zahlungs-/Gastabwicklung durch Vermieter; manuelle Sperre externer Kalender, kein belegter Partner-Sync; unterschiedliche Vermittlerprovisionen je Kanal, zusätzliche Gastgebühren und einzelne Preispositionen derzeit unklar. **A6 entfällt** als Archetyp. [[R00_Szenarien/R08_Destination_Solutions|R08 Referenzfall]].
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[00_Buchungsarchetypen|Archetypen]] · [[R00_Szenarien/R01_Eigene_Webseite|R01 – Eigene Webseite]] · [[R00_Szenarien/R08_Destination_Solutions|R08 – Destination Solutions]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A4 – FeWo-direkt]]
|
||||
--- v0.7/R00_Szenarien/R01_Eigene_Webseite.md
|
||||
+++ v0.8/R00_Szenarien/R01_Eigene_Webseite.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: geschaeftsszenario
|
||||
titel: Buchung über eigene Webseite – End-to-End-Referenzfall
|
||||
status: diskussionsentwurf
|
||||
-version: '0.1'
|
||||
+version: "0.2"
|
||||
---
|
||||
|
||||
# R01 – Buchung über die eigene Webseite
|
||||
@@ -65,3 +65,7 @@
|
||||
## 6. Noch nicht entschieden
|
||||
|
||||
Weder genaue Zeitregeln des Holds noch die Konfliktpriorisierung, die Pflichtfelder je Schritt oder der Automatisierungsgrad sind durch dieses Szenariodokument neu entschieden. Dieses Dokument ist ein **Diskussionsentwurf**, der erst nach Betreiberprüfung in die vorhandenen Phasen- und Gate-Dokumente übernommen werden soll.
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[R00_Szenarien/00_Szenariomatrix|Szenariomatrix]] · [[00_Buchungsarchetypen|Archetypen]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04]] · [[P05/P05_Abschluss_und_Nachbereitung|P05]]
|
||||
--- v0.7/R00_Szenarien/R08_Destination_Solutions.md
|
||||
+++ v0.8/R00_Szenarien/R08_Destination_Solutions.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: geschaeftsszenario
|
||||
titel: Verbindliche Direktbuchung – Destination Solutions
|
||||
status: diskussionsentwurf
|
||||
-version: "0.1"
|
||||
+version: "0.2"
|
||||
stand: 2026-10-31
|
||||
---
|
||||
|
||||
@@ -58,4 +58,8 @@
|
||||
|
||||
- **Bestätigt aus dem Betreiberinterview:** verbindliche Buchungsübermittlung, komplette weitere Vermieterabwicklung, manuelle Sperre ohne Bestätigungsbeleg, unterschiedliche Vermittlerprovisionen je Partner, Stornostaffel als genannte Vertragsbedingung.
|
||||
- **Nicht verifiziert:** konkrete Ansicht/Bestätigung des Gastes, Vertragseinbeziehung der Stornoregeln, zusätzliche Gastgebühren oder Aufschläge, Preisaufschlüsselung, verwendete Destination-Solutions-Vertragsvariante, technische Verteilung/Protokollierung.
|
||||
-- Weitere Nachweise erforderlich: [O00](../O00_Offene_Portalprueffaelle.md).
|
||||
+- Weitere Nachweise erforderlich: [[O00_Offene_Portalprueffaelle|O00]].
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[R00_Szenarien/00_Szenariomatrix|Szenariomatrix]] · [[00_Buchungsarchetypen|Archetypen A1–A5]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[X01_Belegungskonflikte_und_Sperrnachweise|Sperrnachweise]] · [[O00_Offene_Portalprueffaelle|Offene Prüffälle]]
|
||||
--- v0.7/README.md
|
||||
+++ v0.8/README.md
|
||||
@@ -3,15 +3,28 @@
|
||||
typ: projektindex
|
||||
titel: FewoPortal Prozessarchitektur
|
||||
status: arbeitsstand
|
||||
-version: '0.7'
|
||||
+version: "0.8"
|
||||
---
|
||||
|
||||
-# FewoPortal – Prozessarchitektur v0.7
|
||||
+# FewoPortal – Prozessarchitektur v0.8
|
||||
|
||||
**Status:** Fachlicher Arbeitsstand / Interview, keine Implementierungsfreigabe
|
||||
**Stand:** 31.10.2026
|
||||
|
||||
Diese Konsolidierung führt die Version v0.6 mit **E-011 (alternative fachliche Prozessausgänge)** fort und bewahrt die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die Entscheidungen E-001 bis E-010 sowie die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
|
||||
+
|
||||
+
|
||||
+## Start in Obsidian – Navigationsübersicht v0.8
|
||||
+
|
||||
+Dieses Verzeichnis als **Obsidian-Vault** öffnen. Interne Verweise sind als Obsidian-Wikilinks hinterlegt und verweisen mit Vault-relativen Pfaden auf die vorhandenen Notizen. Die **Prozesslandkarte** dient als fachlicher Ausgangspunkt; Szenarien, Gates und Teilprozesse sind gegenseitig vernetzt.
|
||||
+
|
||||
+**Hauptprozess:** [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01 Eingang]] → [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02 Bindung]] → [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Abwicklung]] → [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04 Aufenthalt]] → [[P05/P05_Abschluss_und_Nachbereitung|P05 Abschluss]].
|
||||
+
|
||||
+**Fachliche Navigation:** [[00_Prozesslandkarte|Prozesslandkarte]] · [[00_Buchungsarchetypen|Archetypen]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]] · [[G00_Gates_und_Uebergaben|Gates]] · [[S00_Supportprozesse|Support]] · [[X00_Sonderprozesse|Sonderfälle]] · [[E00_Entscheidungsprotokoll|Entscheidungen]].
|
||||
+
|
||||
+**Vertiefungen:** [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preis- und Abrechnung]] · [[O00_Offene_Portalprueffaelle|Offene Portalfragen]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt (aktuell)]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]].
|
||||
+
|
||||
+> **Dateihistorie:** Die ältere FeWo-direkt-Bearbeitungsfassung wurde aus `P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md` in [[P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_historisch|P03 – historischer Stand]] umbenannt. So sind beide Fassungen eindeutig adressierbar; die fachlich aktuelle Hauptfassung steht im Vault-Stammverzeichnis.
|
||||
|
||||
## Dateien
|
||||
|
||||
@@ -34,15 +47,19 @@
|
||||
|
||||
**Neue bzw. fortgeschriebene Dateien:**
|
||||
|
||||
-- [`00_Buchungsarchetypen.md`](00_Buchungsarchetypen.md) – A1–A5 und reale Referenzfälle
|
||||
-- [`00_Portalprofile_und_Vertragsvorlagen.md`](00_Portalprofile_und_Vertragsvorlagen.md) – Profile und Vertragstypen
|
||||
-- [`K01_Preisstruktur_und_Abrechnung.md`](K01_Preisstruktur_und_Abrechnung.md) – Einzel-/Sammel-/Gesamtbeträge, Provisionen, Zahlungsfluss
|
||||
-- [`A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md`](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md) – konkrete A4-Beobachtungen und rechtliche Prüffragen
|
||||
-- [`R00_Szenarien/R01_Eigene_Webseite.md`](R00_Szenarien/R01_Eigene_Webseite.md) – früherer Referenzentwurf, **inhaltlich unverändert**
|
||||
-- [`R00_Szenarien/R08_Destination_Solutions.md`](R00_Szenarien/R08_Destination_Solutions.md) – A3 Referenzfall
|
||||
-- [`X01_Belegungskonflikte_und_Sperrnachweise.md`](X01_Belegungskonflikte_und_Sperrnachweise.md) – X07-Vertiefung
|
||||
-- [`O00_Offene_Portalprueffaelle.md`](O00_Offene_Portalprueffaelle.md) – spätere Konfigurations- und Nachweispunkte
|
||||
-- [`D00_Dokumentationsregel_und_Uebergabe.md`](D00_Dokumentationsregel_und_Uebergabe.md) – **Pflicht zur erneuten Dokumentenanforderung vor jedem zukünftigen Edit**
|
||||
-- [`E00_Entscheidungsprotokoll.md`](E00_Entscheidungsprotokoll.md) – Beschlüsse E-012–E-021
|
||||
+- [[00_Buchungsarchetypen|`00_Buchungsarchetypen.md`]] – A1–A5 und reale Referenzfälle
|
||||
+- [[00_Portalprofile_und_Vertragsvorlagen|`00_Portalprofile_und_Vertragsvorlagen.md`]] – Profile und Vertragstypen
|
||||
+- [[K01_Preisstruktur_und_Abrechnung|`K01_Preisstruktur_und_Abrechnung.md`]] – Einzel-/Sammel-/Gesamtbeträge, Provisionen, Zahlungsfluss
|
||||
+- [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|`A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md`]] – konkrete A4-Beobachtungen und rechtliche Prüffragen
|
||||
+- [[R00_Szenarien/R01_Eigene_Webseite|`R00_Szenarien/R01_Eigene_Webseite.md`]] – früherer Referenzentwurf, **inhaltlich unverändert**
|
||||
+- [[R00_Szenarien/R08_Destination_Solutions|`R00_Szenarien/R08_Destination_Solutions.md`]] – A3 Referenzfall
|
||||
+- [[X01_Belegungskonflikte_und_Sperrnachweise|`X01_Belegungskonflikte_und_Sperrnachweise.md`]] – X07-Vertiefung
|
||||
+- [[O00_Offene_Portalprueffaelle|`O00_Offene_Portalprueffaelle.md`]] – spätere Konfigurations- und Nachweispunkte
|
||||
+- [[D00_Dokumentationsregel_und_Uebergabe|`D00_Dokumentationsregel_und_Uebergabe.md`]] – **Pflicht zur erneuten Dokumentenanforderung vor jedem zukünftigen Edit**
|
||||
+- [[E00_Entscheidungsprotokoll|`E00_Entscheidungsprotokoll.md`]] – Beschlüsse E-012–E-021
|
||||
|
||||
**Quellenintegrität:** v0.6 aus dem originalen ZIP extrahiert, da die entpackte v0.6-Verzeichnisansicht P01–P05 nicht enthielt; ergänzende Dokumente aus ihrem jeweils neuesten im Chat verfügbaren Bearbeitungsstand. **Kein direkter Schreibzugriff auf Gitea; keine Repository-Aktualisierung behauptet.** Vor jeder künftigen Änderung aktuelle Quelldokumente erneut vom Betreiber anfordern.
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[00_Prozesslandkarte|Prozesslandkarte]] · [[00_Buchungsarchetypen|Archetypen A1–A5]] · [[R00_Szenarien/00_Szenariomatrix|Szenariomatrix]] · [[G00_Gates_und_Uebergaben|Gates und Übergaben]] · [[00_Portalprofile_und_Vertragsvorlagen|Portal- und Vertragsprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preis und Abrechnung]] · [[E00_Entscheidungsprotokoll|Entscheidungen]] · [[O00_Offene_Portalprueffaelle|Offene Prüffälle]] · [[D00_Dokumentationsregel_und_Uebergabe|Dokumentationsregeln]]
|
||||
--- v0.7/S00_Supportprozesse.md
|
||||
+++ v0.8/S00_Supportprozesse.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozesskatalog
|
||||
titel: Supportprozesse
|
||||
status: arbeitsstand
|
||||
-version: '0.7'
|
||||
+version: "0.8"
|
||||
---
|
||||
|
||||
# S00 – Supportprozesse (vorläufiger Katalog)
|
||||
@@ -33,3 +33,7 @@
|
||||
- **S02:** Kalenderverzögerung, manuelle Sperrung und fehlender Bestätigungsbeleg als reale Normalfälle. „Exportiert“ oder „im Portal eingetragen“ ist nicht gleich „partnernetzweit wirksam“.
|
||||
- **S04/S07:** Kaufmännische **Einzel-, Sammel- und Gesamtbeträge** unterstützen; Gast-Servicegebühr, Vermieterprovision, Preisaufschlag, Rabatte, Zahlung und Auszahlung getrennt, soweit feststellbar. Unbekannte Zusammenhänge bleiben ungeklärt; manueller Abgleich möglich.
|
||||
- **S05/S06:** unterschiedliche Vertragsvorlagen/Anlagen und Versionen je Buchungsprofil; manuelle Daten-/Dokumentenbeschaffung und Klärungsaufgaben ohne separate Portalsoftware-Workflows.
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Abwicklung]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04 Aufenthalt]] · [[X00_Sonderprozesse|Sonderprozesse]]
|
||||
--- v0.7/X00_Sonderprozesse.md
|
||||
+++ v0.8/X00_Sonderprozesse.md
|
||||
@@ -3,7 +3,7 @@
|
||||
typ: prozesskatalog
|
||||
titel: Sonder- und Ausnahmeprozesse
|
||||
status: arbeitsstand
|
||||
-version: '0.7'
|
||||
+version: "0.8"
|
||||
---
|
||||
|
||||
# X00 – Sonder- und Ausnahmeprozesse (vorläufiger Katalog)
|
||||
@@ -33,4 +33,8 @@
|
||||
|
||||
- **X02/X04:** Zwischen *Anfrage*, *Annahme/Bestätigung*, *wirksamer Vertragsänderung/Stornierung* und *tatsächlichen Finanz-/Belegungsfolgen* unterscheiden. Ursache, Initiator, Ausführender und Verantwortlicher sind keine austauschbaren Felder. Tatsächlicher Vermieterstornogrund bleibt Vermieterstornogrund, selbst wenn ein Gast auf der Portaloberfläche die Aktion ausführt; Portalregeln und rechtliche Wirkungen gesondert prüfen. Der Betreiber hat beim FeWo-direkt-Konto bislang keine solche Änderung oder Vermieterstornierung selbst durchgeführt; unbekannte Prozesse nicht als erprobte Ist-Abläufe ausgeben.
|
||||
- **X05/X06:** Fehlende Preisdetails, zusammengefasste Service-/Provisionsanteile oder abweichende Auszahlungssummen sind normale Klärungsfälle; manuelle Zuordnung und erneuter Abgleich, ohne Buchungspreis zu überschreiben.
|
||||
-- **X07:** Bei Destination Solutions manuelle Kalendersperre ohne serverseitig/partnernetzweit bestätigten Sperrnachweis; bei FeWo-direkt verzögerter iCal-Import. Technische Ursache und mögliche Rechts-/Haftungsfolgen getrennt bewerten. [Ausführlicher Fachfall X07](X01_Belegungskonflikte_und_Sperrnachweise.md).
|
||||
+- **X07:** Bei Destination Solutions manuelle Kalendersperre ohne serverseitig/partnernetzweit bestätigten Sperrnachweis; bei FeWo-direkt verzögerter iCal-Import. Technische Ursache und mögliche Rechts-/Haftungsfolgen getrennt bewerten. [[X01_Belegungskonflikte_und_Sperrnachweise|Ausführlicher Fachfall X07]].
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[X01_Belegungskonflikte_und_Sperrnachweise|X07 Belegungskonflikte]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]]
|
||||
--- v0.7/X01_Belegungskonflikte_und_Sperrnachweise.md
|
||||
+++ v0.8/X01_Belegungskonflikte_und_Sperrnachweise.md
|
||||
@@ -3,13 +3,13 @@
|
||||
typ: sonderprozess
|
||||
titel: Verfügbarkeitsabgleich, Sperrnachweise und Doppelbuchungen
|
||||
status: diskussionsentwurf
|
||||
-version: "0.1"
|
||||
+version: "0.2"
|
||||
stand: 2026-10-31
|
||||
---
|
||||
|
||||
# X07 – Verfügbarkeitsabgleich, Sperrnachweise und Doppelbuchungen
|
||||
|
||||
-**Geltungsbereich:** Alle Buchungsarchetypen und Vertriebskanäle. Das Dokument ist eine Vertiefung von X07 aus [X00](X00_Sonderprozesse.md), kein zusätzlicher Buchungsarchetyp.
|
||||
+**Geltungsbereich:** Alle Buchungsarchetypen und Vertriebskanäle. Das Dokument ist eine Vertiefung von X07 aus [[X00_Sonderprozesse|X00]], kein zusätzlicher Buchungsarchetyp.
|
||||
|
||||
## 1. Reale Ursachen und Grenzen
|
||||
|
||||
@@ -38,4 +38,8 @@
|
||||
|
||||
Mögliche spätere technische Fähigkeiten: Live-API-Verfügbarkeitsabfrage, atomare Reservierung, Portalbestätigung vor Vertragsschluss, Webhooks/Audit-Logs, automatische Konfliktfrüherkennung. **Aktuell nicht als verfügbar oder implementiert voraussetzen.** Für den MVP zunächst: gut sichtbare Sperraufgaben und revisionsfähige Eigenprotokolle.
|
||||
|
||||
-Siehe [P01](P01/P01_Buchungseingang_und_Verfuegbarkeit.md), [E00](E00_Entscheidungsprotokoll.md), [Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md).
|
||||
+Siehe [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]], [[E00_Entscheidungsprotokoll|E00]], [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]].
|
||||
+
|
||||
+## Verknüpfungen (Obsidian)
|
||||
+
|
||||
+[[README|Startseite]] · [[X00_Sonderprozesse|Sonderprozesse]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt]]
|
||||
File diff suppressed because it is too large.
Load diff
Loaded 100 of 162 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user