Modul-Konfigurationsmatrix und Auswirkungs-Abgleich im Kanalkonfigurator
Deploy FeWo mit PipelineManager / deploy (push) Successful in 6m16s
Deploy FeWo mit PipelineManager / deploy (push) Successful in 6m16s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
a3ab1b6657
commit
381720763c
6 files changed
+327
No files matched your search
@@ -14,6 +14,7 @@
|
||||
use App\Process\Capability;
|
||||
use App\Process\ChannelCapabilities;
|
||||
use App\Process\ChannelProcessConfiguration;
|
||||
use App\Process\ConfigurationImpact;
|
||||
use App\Process\Models\ProcessModel;
|
||||
use App\Process\ProcessCatalogue;
|
||||
use App\Process\ProcessProfile;
|
||||
@@ -245,6 +246,16 @@ public function problems(): array
|
||||
return app(ChannelProcessConfiguration::class)->problems($this->record, IntakeKind::from($this->intake), $this->draft());
|
||||
}
|
||||
|
||||
/**
|
||||
* What the switched-off steps of the draft mean for the others (suggestions only, nothing is changed).
|
||||
*
|
||||
* @return list<array<string, mixed>>
|
||||
*/
|
||||
public function impacts(): array
|
||||
{
|
||||
return app(ConfigurationImpact::class)->of($this->record, IntakeKind::from($this->intake), $this->draft());
|
||||
}
|
||||
|
||||
/**
|
||||
* Running cases of this channel and intake kind (they keep their frozen plan).
|
||||
*/
|
||||
|
||||
@@ -0,0 +1,97 @@
|
||||
<?php
|
||||
|
||||
namespace App\Process;
|
||||
|
||||
use App\Enums\Execution;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Models\Channel;
|
||||
use App\Process\Modules\ModuleDefinition;
|
||||
|
||||
/**
|
||||
* Rule-based comparison of a configuration draft (docs/Prozessarchitektur/MODUL_KONFIGURATIONSMATRIX.md §5): for every
|
||||
* step the landlord switched off it names the steps that depend on it, what stays required, the admissible ways to
|
||||
* achieve the result otherwise and what the configurator suggests. Derived from the module definitions the runner uses –
|
||||
* no second set of rules. Pure: it reads and explains, it never changes a setting.
|
||||
*/
|
||||
final class ConfigurationImpact
|
||||
{
|
||||
public function __construct(private ProcessCatalogue $catalogue, private ChannelProcessConfiguration $configuration) {}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $draft
|
||||
* @return list<array{module: string, label: string, valid: bool, affected: list<string>, relaxed: list<string>, remains: list<string>, alternatives: list<string>, suggestion: string}>
|
||||
*/
|
||||
public function of(Channel $channel, IntakeKind $intake, array $draft): array
|
||||
{
|
||||
$rows = collect($this->configuration->preview($channel, $intake, $draft));
|
||||
$active = $rows->where('on', true)->pluck('module')->all();
|
||||
$labels = $rows->mapWithKeys(fn (array $row): array => [$row['module'] => $row['label']])->all();
|
||||
$impacts = [];
|
||||
|
||||
foreach ($rows as $row) {
|
||||
$definition = $this->catalogue->modules()[$row['module']]::definition();
|
||||
if (($draft['steps'][$row['module']]['on'] ?? true) !== false) {
|
||||
continue;
|
||||
}
|
||||
$affected = $relaxed = [];
|
||||
foreach ($active as $other) {
|
||||
foreach ($this->catalogue->modules()[$other]::definition()->requires as $dependency) {
|
||||
if ($dependency->module !== $row['module']) {
|
||||
continue;
|
||||
}
|
||||
if ($dependency->hard) {
|
||||
$affected[] = $labels[$other];
|
||||
} else {
|
||||
$relaxed[] = $labels[$other];
|
||||
}
|
||||
}
|
||||
}
|
||||
$alternatives = array_values(array_map(fn (Execution $execution): string => $execution->getLabel(), array_filter($definition->executions, fn (Execution $execution): bool => $execution !== Execution::NotRequired)));
|
||||
$valid = $definition->isOptional();
|
||||
|
||||
$impacts[] = [
|
||||
'module' => $row['module'], 'label' => $row['label'], 'valid' => $valid,
|
||||
'affected' => array_values(array_unique($affected)), 'relaxed' => array_values(array_unique($relaxed)),
|
||||
'remains' => $this->remains($definition, $affected, $labels),
|
||||
'alternatives' => $alternatives,
|
||||
'suggestion' => $this->suggestion($row['label'], $definition, $valid, $alternatives),
|
||||
];
|
||||
}
|
||||
|
||||
return $impacts;
|
||||
}
|
||||
|
||||
/**
|
||||
* The results that stay necessary although the step is off: what the steps depending on it still need.
|
||||
*
|
||||
* @param list<string> $affected
|
||||
* @param array<string, string> $labels
|
||||
* @return list<string>
|
||||
*/
|
||||
private function remains(ModuleDefinition $definition, array $affected, array $labels): array
|
||||
{
|
||||
$remains = [];
|
||||
if ($affected !== []) {
|
||||
$remains[] = 'Weiterhin nötig, damit „'.implode('“, „', array_unique($affected)).'“ laufen kann: '.lcfirst($definition->purpose);
|
||||
}
|
||||
if ($definition->why !== null) {
|
||||
$remains[] = $definition->why;
|
||||
}
|
||||
|
||||
return $remains;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param list<string> $alternatives
|
||||
*/
|
||||
private function suggestion(string $label, ModuleDefinition $definition, bool $valid, array $alternatives): string
|
||||
{
|
||||
if (! $valid) {
|
||||
return '„'.$label.'“ ist Pflicht und kann nicht abgeschaltet werden.'.($alternatives !== [] ? ' Zulässig sind stattdessen: '.implode('; ', $alternatives).'.' : '');
|
||||
}
|
||||
|
||||
return $alternatives === []
|
||||
? '„'.$label.'“ entfällt ersatzlos; es ist nichts weiter einzustellen.'
|
||||
: 'Statt abzuschalten, können Sie „'.$label.'“ auch so erledigen lassen: '.implode('; ', $alternatives).'. Es wird nichts anderes automatisch geändert.';
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,174 @@
|
||||
# Modul-Konfigurationsmatrix
|
||||
|
||||
Stand: 05.11.2026 (nach V2.1). **Die** verbindliche Übersicht, was an jedem registrierten Fachmodul tatsächlich einstellbar ist – und was nicht. Quelle: `config/process.php` (28 Module), `ModuleDefinition` der Module, `ChannelProcessConfiguration::STEP_CONTROLS`, `ProcessSetting`, die Modelle A1–A6 und der Code der Aktionen. Die technische Modul-/Modell-Tabelle (`Architektur/MODULMATRIX.md`) wird von `process:check --matrix` erzeugt; dieses Dokument ergänzt die **fachliche** Sicht und wird von Hand gepflegt.
|
||||
|
||||
Ein Modul gilt erst dann als konfigurierbar, wenn seine Varianten **auswählbar, speicherbar, wirksam und testbar** sind. Spalte „Zustand“ benennt das je Modul ehrlich.
|
||||
|
||||
## 1. Einordnung der Einschränkungen
|
||||
|
||||
| Kürzel | Bedeutung |
|
||||
|---|---|
|
||||
| **V** | Technisch vorhanden, im Konfigurator nicht (mehr) sichtbar |
|
||||
| **R** | Unnötig restriktive Validierung oder historische Implementierungsentscheidung |
|
||||
| **P** | Zulässige Option, aber der Konfigurationsparameter fehlt |
|
||||
| **F** | Fachliche Fähigkeit fehlt (Implementierungsumfang angegeben) |
|
||||
| **S** | Unveränderliche Sicherheitsregel (nicht Gegenstand der Konfiguration) |
|
||||
| **O** | Fachliche Festlegung offen (blockiert die Umsetzung nicht) |
|
||||
|
||||
Grundregeln, die für **alle** Module gelten (S): Pflichtschritte sind nicht abschaltbar; Verbindlichkeit beim Portal wird nie von uns aufgehoben (E-036); Verfügbarkeit wird immer geprüft (E-027); Preise kommen nur aus `PriceCalculator` bzw. dem Portal; kein Versand an Gäste außerhalb des Mail-Tores (`EnforceMailTestMode`); laufende Vorgänge behalten ihren eingefrorenen Plan (E3); Nachrichten werden nur über einen verifizierten Bezug einem Vorgang zugeordnet (CH-07).
|
||||
|
||||
Wirkungsweise einer Einstellung: Landlord → Wohnung → Kanal je Eingangsart (`ProcessSettings`); das Modell kann Werte festlegen (`fixes()`), bestätigte Altwerte, die das Modell überstimmt, werden nach ausdrücklicher Bestätigung entfernt (`ConfigureChannelProcess`, Konflikte). Neue Vorgänge folgen der neuen Konfiguration, laufende nicht.
|
||||
|
||||
## 2. Übersicht
|
||||
|
||||
| Modul | Ablauf | Abschaltbar | Einstellbar im Konfigurator | Zustand |
|
||||
|---|---|---|---|---|
|
||||
| `intake.record` | alle | nein (S) | – | vollständig, nichts einzustellen |
|
||||
| `guest.details` | A1–A5 | nein (S) | Anschrift im Formular Pflicht | vollständig |
|
||||
| `guest.data_request` | A1–A5 | ja | Modus, Erinnerungen, Folgefragen, Abstand, Linkdauer | vollständig |
|
||||
| `hold` | A1/A2 | bedingt | Vorreservierung, Frist, Klärungsfrist | vollständig |
|
||||
| `availability.check` | A1/A2 | nein (S) | – | vollständig |
|
||||
| `binding.portal` | A3–A5 | nein (S) | – | vollständig |
|
||||
| `channels.block` | alle | nein (S) | – | Aufgabenweg je Portal über Kanaldaten |
|
||||
| `portal.confirmation` | A3–A5 | bedingt | Warten ja/nein, Wartefrist | Nachweis-Mindestumfang **O** |
|
||||
| `offer.information` | A1/A2 | nein | Modus, Linkdauer | vollständig |
|
||||
| `offer.binding` | A1/A2 | nein | Modus, Haltefrist, Vorlage | vollständig |
|
||||
| `offer.acceptance` | A1/A2 | nein (S) | – | vollständig |
|
||||
| `documents.send` | A1–A5 | nein | Modus, Zustellung, Vorlage | Zustellwege vollständig, Varianten siehe 3.12 |
|
||||
| `documents.booking_notice` | A3–A5 | bedingt | Buchungsinformation: Art | vollständig |
|
||||
| `documents.stay_confirmation` | A6 | ja | – | nur manuell (P) |
|
||||
| `case.tasks` | alle | – | – | ereignisgesteuert |
|
||||
| `change.proposal` | A1–A5 | – | – | ereignisgesteuert |
|
||||
| `case.closure` | alle | nein (S) | – | – |
|
||||
| `case.settlement` | alle | nein (S) | – | – |
|
||||
| `payments.monitor` | A1–A5 | nein | Zahler (durch Modell) | **Zahlungsanforderung, Erinnerung, Mahnung nicht konfigurierbar (F/P)** |
|
||||
| `portal.payout` | A1–A5 | nein | – | Nachweis-Mindestumfang **O** |
|
||||
| `payments.internal` | A6 | bedingt | – | – |
|
||||
| `arrival.details` | A1–A5 | ja | nur Schalter | Parameter fehlen (P) |
|
||||
| `arrival.info` | A1–A5 | nein | Absender, Tage vor Anreise | Zustellweg Dienstleister nicht ausgeführt (F) |
|
||||
| `stay` | alle | nein (S) | – | – |
|
||||
| `review.request` | A1–A5 | ja | Absender (über Gastkommunikation) | Zeitpunkt nur mandantenweit (P) |
|
||||
| `guest.address_check` | Tester | ja | – | nur Prozess-Tester (Erweiterungsnachweis) |
|
||||
| `guest.loyalty_status` | Tester | ja | Mindestbesuche, Rückblick | nur Prozess-Tester (E7) |
|
||||
| `pricing.loyalty_discount` | Tester | ja | Prozent, Höchstbetrag | nur Prozess-Tester (E7) |
|
||||
|
||||
## 3. Module im Einzelnen
|
||||
|
||||
Die zwölf Punkte je Modul sind in der Kurzform: **Ergebnis/Invarianten · Aktivierung · Varianten · Auslöser · Voraussetzungen · Parameter · Kommunikation/Nachweis · Alternativen · Wirkung auf andere · Fehler/Warten/Eskalation · Ist (Code/UI) · Fehlt**. Was nicht aufgeführt ist, gibt es für das Modul nicht und wird nicht gebraucht.
|
||||
|
||||
### 3.1 `intake.record` – Eingang
|
||||
Ergebnis: Vorgang mit eingefrorenem Plan, Belegung gesetzt. Invarianten (S): immer; friert Modell und Version ein. Auslöser: `intake`. Alle anderen Module hängen hart daran. Keine Parameter. Ist: vollständig. Fehlt: nichts.
|
||||
|
||||
### 3.2 `guest.details` – Angaben des Gastes
|
||||
Ergebnis: Gast identifiziert, Angaben aus allen Quellen zusammengeführt, Vollständigkeit geprüft (G2a). Pflicht, wenn wir selbst schreiben. Varianten (Ausführung): automatisch, von Hand. Auslöser: `facts.applied`. Parameter: `form_requires_address` (Anschrift im Formular Pflicht; nur Anfragen). Beschaffung der fehlenden Angaben ist **unabhängig** vom Modul `guest.data_request`; beim Wegfall der Anfrage bleiben die Pflichtangaben erforderlich, die Alternative ist die manuelle Erfassung/Aufgabe. Ist: vollständig. Fehlt: Pflichtfeldliste je Kanal (P, später).
|
||||
|
||||
### 3.3 `guest.data_request` – Fehlende Angaben anfragen
|
||||
Ergebnis: fehlende Pflichtangaben kommen per Link vom Gast. Optional (V2.1 unabhängig). Varianten: automatisch, nach Freigabe, von Hand, nicht erforderlich. Auslöser: `request.created`, `booking.taken_over`, Wunsch. Parameter (alle einstellbar): `data_request_mode`, `data_request_reminders_max`, `data_request_followups_max`, `data_request_reminder_hours`, `guest_link_valid_days` (nur Landlord-/Wohnungsebene, nicht je Kanal). Kommunikation: Mail mit signiertem Link; Nachweis: Antwort-Fakten (Provenienz). Warten: Gast, Zeit, danach Übergabe an Sie. Wirkung: bei „nicht erforderlich“ bleiben `guest.details` und alles, was es voraussetzt, bestehen – der Konfigurator zeigt die Ersatzwege (siehe Abschnitt 5). Ist: vollständig. Fehlt: Medium je Anfrage (WhatsApp usw.) – F, hängt an F4/F5.
|
||||
|
||||
### 3.4 `hold` – Reservierung
|
||||
Ergebnis: Zeitraum frei halten, nach Ablauf freigeben (`Booking::occupying()` ignoriert abgelaufene Haltefristen). Varianten: nur Anfragen mit Vorreservierung. Parameter: `pre_reservation`, `hold_hours`, `clarification_hold_auto_minutes`, `clarification_hold_manual_minutes`. Zustand: vollständig. Fehlt: nichts.
|
||||
|
||||
### 3.5 `availability.check` – Verfügbarkeit
|
||||
Pflicht (S, E-027). Keine Parameter. Fehlt nichts.
|
||||
|
||||
### 3.6 `binding.portal` – Verbindlichkeit beim Portal
|
||||
Ergebnis: Buchung verbindlich beim Portal (E-036), Gesamtpreis laut Portal übernommen. Pflicht (S). Ausführung: Portal, von Hand. Auslöser: `intake`, `portal.amounts`. Fehlt nichts.
|
||||
|
||||
### 3.7 `channels.block` – Andere Kanäle sperren
|
||||
Ergebnis: Belegung in Portalen nachgezogen, Nachweis je Portal. Pflicht (S). Ausführung: automatisch (iCal/Connector) oder von Hand (`ChannelTask`). Parameter je Portal in den Kanaldaten (`requires_manual_blocking`, iCal-URL); Erinnerung `task_reminder_after_minutes` (Betrieb). Eskalation: Aufgabe, Erinnerung, Postfach. Fehlt: nichts im Ablauf.
|
||||
|
||||
### 3.8 `portal.confirmation` – Bestätigung des Portals abwarten
|
||||
Ergebnis: Nachweis der Portalbestätigung (PortalEmail-Buchung deterministisch verknüpft oder Ereignis des Vermieters). Bedingt: nur bei extern verbindlicher Buchung. Varianten: automatisch, von Hand, nicht erforderlich. Parameter: `await_portal_confirmation`, `portal_confirmation_wait_hours` (Vorschlag 48). Wirkung: **nur** `documents.send` und `documents.booking_notice` warten; Belegung, Datenbeschaffung, Zahlungsüberwachung nicht. Fristablauf: genau eine Aufgabe `PortalConfirmationMissing`, kein automatisches Aufheben. Fortsetzung: `portal.mail`, `schedule:waiting`. **O**: Mindestnachweis (D3) und akzeptierte Angaben (D4) = F2; Wartefrist = F3 (Vorschlag steht). Ist: vollständig im Rahmen der Vorschläge.
|
||||
|
||||
### 3.9 `offer.information` / `offer.binding` / `offer.acceptance`
|
||||
Ergebnis: Auskunft (A1/A2 ohne Reservierung) bzw. verbindliches Angebot mit Vertragsentwurf (Version, signierter Link) und Annahme durch den Gast. Annahme ist Pflicht (S, E-003). Parameter: `processing` (automatisch/Freigabe/von Hand), `hold_hours`, `contract_template_id`, `guest_link_valid_days`. Preisänderungen nur als `Adjustment`-Zeile. Fehlt: nichts; ein Zahlungsplan im Angebot (Anzahlungsanteil/Termine) ist nicht je Kanal einstellbar (siehe 3.17).
|
||||
|
||||
### 3.10 `documents.send` – Buchungsunterlagen (Vertragsdokumentation)
|
||||
Ergebnis: die Vertragsdokumentation erreicht den Gast – von uns oder vom Portal (O1). Pflicht (S). Varianten (`Execution`): automatisch, nach Freigabe, von Hand, durch das Portal (A5). Parameter: `documents` (Verantwortung; durch das Modell festgelegt), `processing`, `contract_delivery` (folgt dem Modus / automatisch / von Hand / intern), `contract_template_id`. Auslöser: `automation`, `booking.taken_over`, `portal.mail`, `schedule:waiting`. Voraussetzungen hart: `guest.details`, `portal.confirmation` (sofern im Plan). Fehlt: Auswahl mehrerer Dokumentenarten (z. B. nur Buchungsbestätigung ohne Vertrag) – der Weg dafür ist `documents.booking_notice`; Dokumentenarten selbst sind **F** (mittel).
|
||||
|
||||
### 3.11 `documents.booking_notice` – Buchungsinformation
|
||||
Ergebnis: kurze Information ohne Vertrag, unabhängig von den Vertragsunterlagen. Parameter: `booking_notice` (aus/automatisch/von Hand/Portal). Wartet auf `portal.confirmation`, falls im Plan. Vollständig.
|
||||
|
||||
### 3.12 `documents.stay_confirmation` (A6)
|
||||
Nur manuell oder nicht erforderlich. Kein Parameter nötig. Fehlt nichts.
|
||||
|
||||
### 3.13 `case.tasks`, `change.proposal` (ereignisgesteuert)
|
||||
Zeigen Aufgaben bzw. Änderungsvorschläge. Keine Einstellung; Eskalation über Postfach/Digest (`reminder_interval_days`, Betrieb).
|
||||
|
||||
### 3.14 `case.closure`, `case.settlement`, `stay`
|
||||
Pflicht (S). Abschluss erst, wenn nichts mehr offen ist (E-010); kaufmännischer Abschluss braucht tatsächliche Nachweise (O5), eine Portalmeldung ersetzt sie nicht. Keine Parameter. Fehlt: Storno-/Erstattungsregeln je Modell (F, **O**: DS-06/FW-05).
|
||||
|
||||
### 3.15 `payments.monitor` – Zahlungen des Gastes
|
||||
Ergebnis: Anzahlung/Restzahlung überwacht (wir) oder „laut Portal“ (Portal zieht ein). Wer kassiert, legt das **Modell** fest (A3 wir, A4/A5 Portal); bei A1–A3 sind die Fristen:
|
||||
|
||||
| Teil | Ist | Zustand |
|
||||
|---|---|---|
|
||||
| Frist Anzahlung | `deposit_due_days` (Betrieb, mandantenweit; im Angebot eingefroren) | **P**: nicht je Kanal/Eingang |
|
||||
| Zahlungsanforderung (Restzahlung) | Aufgabe 7 Tage vor Fälligkeit (`SendBookingReminders::BALANCE_REQUEST_DAYS_BEFORE`, Konstante) | **P**: Konstante, einstellbar machen |
|
||||
| Zahlungserinnerung | Aufgabe für den Vermieter, Versand per Klick (`SendPaymentReminder`) | vorhanden, **nicht automatisch** (bewusst, S); Modus automatisch/Freigabe = **F** (klein) |
|
||||
| Mahnung (mehrstufig) | gibt es nicht | **F** (mittel): Stufen, Fristen, Texte, Gebühren-Regel; rechtlich zu prüfen **O** |
|
||||
| Zahlungseingang | Vermieter erfasst (`RecordPayment`); Bank-Abgleich nicht vorhanden | **F** (groß, später) |
|
||||
|
||||
Fehlt (Referenzfall A3): konfigurierbare Zahlungsanforderungen/-erinnerungen/Mahnungen. Priorisiert in Abschnitt 6.
|
||||
|
||||
### 3.16 `portal.payout`
|
||||
Nachweis des tatsächlichen Eingangs der Auszahlung (O5). Nur wo das Portal einzieht (A4/A5). Manuell. **O**: DS-Inkasso F7.
|
||||
|
||||
### 3.17 `arrival.details`, `arrival.info`
|
||||
`arrival.details` (optional): Telefon, Anreisezeit; keine Parameter (P: Pflichtfelder, Erinnerungsabstand). `arrival.info`: Absender (wir/Portal/Dienstleister/nicht erforderlich) über `guest_messages` (nach Modell erlaubt), Zeitpunkt `arrival_info_days_before` (≤ 14, Konstante). Zurückgehalten bei offener Portalmeldung (O4). **F**: Zustellung durch Dienstleister (Ausführung „service_provider“ ohne Anbindung – klein, nur Aufgabe).
|
||||
|
||||
### 3.18 `review.request`
|
||||
Optional. Absender wie `arrival.info` (Portal schreibt dem Gast → Schritt entfällt). Zeitpunkt `review_request_after_days` nur mandantenweit (**P**). Vollständig sonst.
|
||||
|
||||
### 3.19 `payments.internal` (A6)
|
||||
Zahlung ohne Erinnerungen, manuell. Fehlt nichts.
|
||||
|
||||
### 3.20 Tester-Module
|
||||
`guest.address_check`, `guest.loyalty_status`, `pricing.loyalty_discount`: Erweiterungsnachweis (E7); nur im Prozess-Tester, nie im Plan eines echten Vorgangs (S). Parameter dort sichtbar. Bleiben so, solange nicht ausdrücklich freigegeben.
|
||||
|
||||
## 4. Technisch vorhanden, im Konfigurator nicht sichtbar (V) – Ergebnis der Prüfung
|
||||
|
||||
Geprüft wurde jede der 20 Einstellungen aus `ProcessSetting` gegen `STEP_CONTROLS`: **17 sitzen an einem Schritt; die übrigen drei (`pre_reservation`, `documents`, `payments`) werden durch die Wahl des Modells entschieden** (A1/A2 Angebot oder Auskunft, A3–A5 Verantwortung für Unterlagen und Inkasso) und sind deshalb bewusst kein Schrittparameter. Es gibt keine versteckte, bereits implementierte Variante, die nur freizulegen wäre. Gefunden wurden stattdessen:
|
||||
|
||||
| Befund | Art | Maßnahme |
|
||||
|---|---|---|
|
||||
| Veralteter Altwert (`payments`/`guest_messages = portal`) blockierte den Wechsel zu A3 trotz Bestätigung | Implementierungsdefekt | **behoben** (`a3ab1b6`): Konflikte umfassen auch nicht mehr erlaubte variable Verantwortlichkeiten; bestätigte Altwerte werden nicht mehr gegen das neue Modell geprüft |
|
||||
| Balance-Anforderung 7 Tage, Anreise-Info Obergrenze 14 Tage, Bewertungsbitte-Tage, Anzahlungsfrist | **P** | als Einstellung einführen (Abschnitt 6, Prio 2) |
|
||||
| Linkdauer/Erinnerungsparameter der Datenanfrage nur auf Landlord-/Wohnungsebene | **R** (historisch) | je Kanal ermöglichen, wenn gewünscht (klein) |
|
||||
| Auswahl der Ersatzstrategie bei Wegfall eines Moduls | fehlte als Hilfe | **neu**: Auswirkungs-Abgleich (Abschnitt 5) |
|
||||
|
||||
## 5. Auswirkungs-Abgleich (Auftrag 4)
|
||||
|
||||
`App\Process\ConfigurationImpact` wertet die Moduldefinitionen aus (`requires` hart/weich, `executions`, `why`, Plan des Modells) für den **Entwurf** des Konfigurators und liefert je Änderung: betroffene abhängige Schritte, weiterhin erforderliche fachliche Ergebnisse, zulässige Ersatzwege und einen Vorschlag. Er ändert nie selbst etwas. Das Beispiel „automatische Datenanfrage aus“ ergibt: Pflichtangaben bleiben erforderlich (`guest.details`), Ersatz: „nach Freigabe“, „von Hand“ (Aufgabe).
|
||||
|
||||
## 6. Fehlende Fähigkeiten, priorisiert
|
||||
|
||||
| Prio | Fähigkeit | Umfang | Abhängigkeit |
|
||||
|---|---|---|---|
|
||||
| 1 | Zahlungsplan je Kanal/Eingang: Anzahlungsanteil, Fristen (Tage), Anforderung X Tage vor Fälligkeit als `ProcessSetting` | klein–mittel: Enum-Fall(e), ConfirmBooking/TakeOver, `SendBookingReminders`, Konfigurator, Tests | F7 (wer kassiert) |
|
||||
| 1 | Zahlungserinnerung automatisch/mit Freigabe statt nur Aufgabe | klein, aber Tor `EnforceMailTestMode` und Gastkommunikation beachten | Prio 1 oben |
|
||||
| 2 | Mahnstufen (Fristen, Texte, Stufen) | mittel; rechtliche Prüfung nötig **O** | Zahlungsplan |
|
||||
| 2 | Einstellbare Zeitpunkte: Anreise-Info Obergrenze, Bewertungsbitte je Kanal | klein | – |
|
||||
| 3 | Nachweis-Mindestumfang Portalbestätigung (D3/D4) | klein, nach Beschluss F2 | **O** F2 |
|
||||
| 3 | Dienstleister-Zustellung Anreise-Info | klein (Aufgabe) bis mittel (Anbindung) | – |
|
||||
| 4 | Dokumentenarten je Kanal wählbar | mittel | – |
|
||||
| 4 | Kommunikationskanal je Anfrage (WhatsApp usw.) | groß, Anbindung ausgeschlossen | F4/F5 |
|
||||
| 4 | Bank-Abgleich Zahlungseingang | groß | – |
|
||||
|
||||
## 7. Offene Festlegungen (blockieren nichts)
|
||||
|
||||
F2 Mindestnachweis, F3 Wartefrist (Vorschlag 48 h), F4/F5 Messenger, F6 DS-01…06/FW-01…07 Prüfpunkte, F7 Inkasso Destination Solutions, Storno/Erstattung je Modell (DS-06/FW-05), rechtliche Ausgestaltung der Mahnung. Siehe `V2.1/01_KONFIGURATIONSLUECKEN.md`.
|
||||
|
||||
## 8. Referenzfall Destination Solutions A3 – was heute **ohne Quellcodeänderung** einstellbar ist
|
||||
|
||||
| Anforderung | Einstellbar? |
|
||||
|---|---|
|
||||
| Extern verbindliche Buchung | ja (Modell A3, `binding.portal`) |
|
||||
| Eigene Zahlungsabwicklung | ja (A3, Inkasso beim Vermieter; Wechsel A4↔A3 inkl. Bestätigung getestet) |
|
||||
| Dokumentenerstellung/-übermittlung | ja: `processing`, `contract_delivery`, Vorlage, Buchungsinformation |
|
||||
| Zahlungsanforderung, Fristen | **teilweise**: Anzahlungsfrist mandantenweit; Rest-Anforderung fest 7 Tage (P) |
|
||||
| Zahlungserinnerung | **teilweise**: Aufgabe + Versand per Klick |
|
||||
| Mahnung | **nein** (F) |
|
||||
| Warten auf Portalbestätigung für Folgeaktionen | ja (Schalter + Frist) |
|
||||
| Unabhängige Datenbeschaffung | ja (`guest.data_request`, eigene Modi) |
|
||||
| Fristen, Nachweise, Eskalationen | ja (Aufgaben, Postfach, Digest); Zahlungs-Eskalation siehe oben |
|
||||
@@ -1,5 +1,11 @@
|
||||
# Projektstand
|
||||
|
||||
## Nachtrag (05.11.2026): Konfigurierbarkeit der Fachmodule
|
||||
|
||||
- **Speicherkonflikt behoben:** Ein bestätigter Wechsel A4 → A3 (Destination Solutions mit `payments = portal`) scheiterte an „Inkasso … nicht zulässig“, weil der Entwurf den Altwert vor der bestätigten Entfernung gegen das neue Modell prüfte; nicht mehr erlaubte variable Verantwortlichkeiten zählten zudem nicht als Konflikt. Jetzt: `ChannelProcessConfiguration::conflicts()` + `withoutOverriddenSettings()`, Regressionstests in `ChannelCapabilityTest`.
|
||||
- **Modul-Konfigurationsmatrix:** [MODUL_KONFIGURATIONSMATRIX.md](Prozessarchitektur/MODUL_KONFIGURATIONSMATRIX.md) – je Modul Varianten, Parameter, Abhängigkeiten, Zustand, fehlende Fähigkeiten (priorisiert). Wichtigste Lücke im Referenzfall: Zahlungsplan/-erinnerung/Mahnung nicht konfigurierbar.
|
||||
- **Auswirkungs-Abgleich:** `App\Process\ConfigurationImpact` + Abschnitt „Was die Abschaltung bedeutet“ im Kanalkonfigurator (nur Hinweise, ändert nichts).
|
||||
|
||||
## Aktueller Stand (05.11.2026): V2.1 – fachliche Konfigurierbarkeit
|
||||
|
||||
**Umgesetzt auf `feature/prozessarchitektur-v2-1`:** Kanalfähigkeiten steuern die Modellwahl (mit erklärten Einschränkungen und Abgleich alter Werte), Ausführungsvarianten je Modul, Dokumentenerstellung/-ablage/-versand und Buchungsinformation entkoppelt, Warten auf die Bestätigungsmail des Portals (Belegung sofort gesichert, Eskalation, Wiederaufnahme), Kommunikation nach Medium × Absicht × Wirkung (WhatsApp/Chat nur als Testfälle der Architektur, kein Provider), nichtlineare Prozessansicht im Kanalkonfigurator, neue Tester-Szenarien, Erweiterungspunkt-Nachweis (Anschriftsprüfung).
|
||||
|
||||
@@ -91,6 +91,18 @@
|
||||
</x-filament::section>
|
||||
@endif
|
||||
|
||||
@if ($impacts = $this->impacts())
|
||||
<x-filament::section heading="Was die Abschaltung bedeutet">
|
||||
@foreach ($impacts as $impact)
|
||||
<div style="font-size:.9rem;margin-bottom:.6rem">
|
||||
<strong>{{ $impact['label'] }}</strong>: {{ $impact['suggestion'] }}
|
||||
@foreach ($impact['remains'] as $text)<div style="color:#b45309">{{ $text }}</div>@endforeach
|
||||
@if ($impact['affected'] !== [])<div>Betrifft: {{ implode(', ', $impact['affected']) }}</div>@endif
|
||||
</div>
|
||||
@endforeach
|
||||
</x-filament::section>
|
||||
@endif
|
||||
|
||||
<div style="display:grid;grid-template-columns:minmax(0,2fr) minmax(0,1fr);gap:1rem;align-items:start">
|
||||
<div>
|
||||
@foreach (collect($steps)->groupBy('phase') as $phase => $group)
|
||||
|
||||
@@ -14,6 +14,7 @@
|
||||
use App\Process\Capability;
|
||||
use App\Process\ChannelCapabilities;
|
||||
use App\Process\ChannelProcessConfiguration;
|
||||
use App\Process\ConfigurationImpact;
|
||||
use App\Process\ProcessProfile;
|
||||
use Carbon\CarbonImmutable;
|
||||
use Database\Seeders\PropertySeeder;
|
||||
@@ -211,6 +212,32 @@ public function test_a_confirmed_switch_does_not_touch_running_cases_or_other_ch
|
||||
$this->assertSame(['hold_hours' => 24], array_intersect_key($ds->fresh()->process_overrides['inquiry'], ['hold_hours' => 1]), 'the other intake kind is untouched');
|
||||
}
|
||||
|
||||
/** Switching a step off never drops the duty it served: the impact names dependants, what stays and the admissible ways. */
|
||||
public function test_switching_off_the_data_request_shows_what_stays_and_the_alternatives_without_changing_anything(): void
|
||||
{
|
||||
$ds = $this->channel('Destination Solution', []);
|
||||
$impact = app(ConfigurationImpact::class);
|
||||
|
||||
$this->assertSame([], $impact->of($ds, IntakeKind::Booking, ['model' => 'a3.portal_booking']), 'nothing switched off, nothing to report');
|
||||
|
||||
$draft = ['model' => 'a3.portal_booking', 'steps' => ['guest.data_request' => ['on' => false]]];
|
||||
$result = collect($impact->of($ds, IntakeKind::Booking, $draft))->firstWhere('module', 'guest.data_request');
|
||||
|
||||
$this->assertTrue($result['valid']);
|
||||
$this->assertSame([], $result['affected'], 'no step of this model waits for the data request: they carry on');
|
||||
$this->assertContains('von Ihnen von Hand', $result['alternatives'], 'the admissible ways to obtain the data remain offered');
|
||||
$this->assertStringContainsString('Es wird nichts anderes automatisch geändert', $result['suggestion']);
|
||||
$this->assertSame([], app(ChannelProcessConfiguration::class)->problems($ds, IntakeKind::Booking, $draft), 'the combination is valid');
|
||||
|
||||
$mandatory = collect($impact->of($ds, IntakeKind::Booking, ['model' => 'a3.portal_booking', 'steps' => ['documents.send' => ['on' => false]]]))->firstWhere('module', 'documents.send');
|
||||
$this->assertFalse($mandatory['valid']);
|
||||
$this->assertStringContainsString('Pflicht', $mandatory['suggestion']);
|
||||
|
||||
$dependants = collect($impact->of($ds, IntakeKind::Booking, ['model' => 'a3.portal_booking', 'steps' => ['portal.confirmation' => ['on' => false]]]))->firstWhere('module', 'portal.confirmation');
|
||||
$this->assertContains('Buchungsunterlagen (Vertragsdokumentation)', $dependants['affected'], 'the documents depend hard on the confirmation step');
|
||||
$this->assertNotEmpty($dependants['remains']);
|
||||
}
|
||||
|
||||
public function test_unknown_capabilities_block_nothing_but_ask_for_confirmation(): void
|
||||
{
|
||||
$generic = $this->channel('Irgendein Portal', []);
|
||||
|
||||
Reference in new issue
Block a user