V2.1: Erweiterungspunkt-Nachweis, Fälle G/H, Abnahmeprotokoll, Status

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Sonnet 5.5 committed 2026-11-05 08:17:51 +01:00
1 parent fdf226535b
commit 0d51c673eb
7 files changed
+239 -2

No files matched your search

+3
View File
@@ -47,6 +47,9 @@ public function variants(): array
->testerOnly()
->insert(Point::AfterGuestIdentified, 'guest.loyalty_status')
->insert(Point::BeforePriceFixing, 'pricing.loyalty_discount'),
Variant::make('address_check', 'Angebot mit Anschriftsprüfung (Zusatzschritt, nur im Prozess-Tester)')
->testerOnly()
->insert(Point::AfterGuestIdentified, 'guest.address_check'),
];
}
}
@@ -0,0 +1,71 @@
<?php
namespace App\Process\Modules\Guest;
use App\Enums\ActivityState;
use App\Process\Activity;
use App\Process\CaseContext;
use App\Process\Modules\Dependency;
use App\Process\Modules\Module;
use App\Process\Modules\ModuleDefinition;
use App\Process\Modules\StepState;
/**
* V2.1 case H (docs/Prozessarchitektur/V2.1/ABNAHME_V2_1.md): an optional plausibility check of the guest's address, added
* at the extension point „after the guest is identified“ without touching any other model. It only informs – the result
* never holds back an offer or a booking (the address gate of v0.11 stays the only rule). Tester only until released.
*/
final class AddressCheck extends Module
{
public static function key(): string
{
return 'guest.address_check';
}
public static function definition(): ModuleDefinition
{
return new ModuleDefinition(
label: 'Anschrift auf Plausibilität prüfen',
purpose: 'Prüft, ob die Anschrift des Gastes plausibel aussieht (Postleitzahl, Ort). Es ist ein Hinweis; nichts wird dadurch aufgehalten.',
phase: 'P01',
requires: [Dependency::hard('guest.details')],
triggers: ['facts.applied'],
toggle: ModuleDefinition::TOGGLE_OPTIONAL,
events: ['facts'],
points: ['after_guest_identified'],
availability: ModuleDefinition::AVAILABILITY_TESTER_ONLY,
);
}
/**
* @return list<string> what looks implausible (empty: plausible)
*/
public function findings(CaseContext $case): array
{
$guest = $case->booking->guest;
$findings = [];
if (blank($guest?->street)) {
$findings[] = 'Straße fehlt';
}
if (blank($guest?->city)) {
$findings[] = 'Ort fehlt';
}
if (in_array(mb_strtoupper((string) $guest?->country), ['', 'DE', 'DEUTSCHLAND'], true) && ! preg_match('/^\d{5}$/', trim((string) $guest?->postal_code))) {
$findings[] = 'Postleitzahl hat nicht fünf Ziffern';
}
return $findings;
}
public function activities(CaseContext $case): array
{
$findings = $this->findings($case);
return [new Activity('address_check', 'Anschrift auf Plausibilität prüfen', ActivityState::Done, $findings === [] ? 'Anschrift wirkt plausibel' : 'Hinweis: '.implode(', ', $findings))];
}
public function state(CaseContext $case): ?StepState
{
return StepState::Done;
}
}
@@ -84,7 +84,7 @@ public function activities(CaseContext $case): array
}, $evidence === null ? 'confirmPortal' : null)];
}
/** Due when the time ran out without the mail (escalate once), or when the mail arrived and the escalation is still open. */
/** Due when the time ran out without the mail: escalate once; or when the mail arrived and the escalation is still open. */
public function due(CaseContext $case): bool
{
$open = $this->openTask($case) !== null;
@@ -10,7 +10,7 @@
use Carbon\CarbonImmutable;
/**
* V2.1: a booking binding at the portal is known without the portal's confirmation mail (calendar or manual entry); the
* V2.1: a booking binding at the portal is known without the portal's confirmation mail, e.g. from a calendar or a manual entry; the
* mail comes at once, late or never. Shows what waits (documents, booking information), that the occupation does not,
* and the escalation when the mail stays away.
*/
+2
View File
@@ -1,6 +1,7 @@
<?php
use App\Process\Models;
use App\Process\Modules\Guest;
use App\Process\Modules\Intake;
use App\Process\Modules\Loyalty;
use App\Process\Modules\Money;
@@ -47,6 +48,7 @@
Stay\Stay::class,
Stay\ReviewRequest::class,
// Architecture proof, tester only (decision E7).
Guest\AddressCheck::class,
Loyalty\LoyaltyStatusCheck::class,
Loyalty\LoyaltyDiscount::class,
],
@@ -0,0 +1,73 @@
# V2.1 – Abnahme: Fälle A–H und kritische Selbstprüfung
Stand: 05.11.2026, Branch `feature/prozessarchitektur-v2-1`. Grundlage: [01 Lücken](01_KONFIGURATIONSLUECKEN.md), [02 Zielbild](02_FACHLICHES_ZIELBILD.md). Alle Nachweise sind automatisierte Tests; „Tester“ meint den isolierten Prozess-Tester (Kanal › Ablauf › Ablauf testen).
## 1. Was V2.1 ergänzt
| Bereich | Umsetzung |
|---|---|
| Kanalfähigkeiten | `Capability`, `ChannelCapabilities`: bestätigt / abgeleitet / vorgeschlagen / unbekannt. Sie entscheiden, welche Modelle zulässig sind. |
| Erklärte Einschränkungen | `Restriction`: was fehlt, welche Variante erlaubt ist, was zu ändern ist, Grund (fachlich / technisch / Fähigkeit). |
| Abgleich alter Werte | Gespeicherte Einstellungen gegen `fixes()` des Modells: ausdrückliche Bestätigung, Eintrag in `settings.process_history`. |
| Ausführungsvarianten | `Execution` (automatisch, Freigabe, von Hand, Portal, Dienstleister, extern, nicht nötig), je Modul mit `why` (Begründung der Pflicht) und `condition`. |
| Dokumente entkoppelt | `contract_delivery` (wie bisher / automatisch / von Hand / nur intern ablegen), `booking_notice` (aus / automatisch / automatisch, außer das Portal bestätigt) als eigener Schritt. |
| Portalbestätigung | Modul `portal.confirmation`: Belegung sofort gesichert, gästebezogene Schritte warten, Frist, genau eine Aufgabe bei Ausbleiben, Wiederaufnahme per Portalmail oder Bestätigung im Vorgang. |
| Kommunikation | `config/communication.php`, `CommunicationRules`, `IntentClassifier`, `MessageIntake`: Medium × Absicht × Wirkung; Vermieter dürfen nur einschränken. |
| Nichtlineare Ansicht | Konfigurator zeigt je Schritt „braucht zuerst“, „soll nach“, „läuft unabhängig“, „nur wenn“, „So darf das erfüllt werden“; keine Nummerierung. Quelle: dieselben Moduldefinitionen wie der `ProcessRunner`. |
| Tester | Neue Szenarien: Portalbestätigung (sofort / verspätet / ausbleibend), Nachricht über WhatsApp/Chat, allgemeine Frage ohne Vorgang. |
| Erweiterungspunkt | `guest.address_check` (nur Tester) als Variante `address_check` des A1-Angebotsmodells. |
Modellversionen: a3/a4/a5 Version 1 bleiben für laufende Vorgänge erhalten, Version 2 enthält die neuen Module (`config/process.php`, `compatible`). Die Standardwerte der neuen Einstellungen reproduzieren das V2-Verhalten (Golden-Master- und Laufende-Vorgänge-Tests unverändert grün).
## 2. Nachweisfälle
| Fall | Konfiguration | Module / Regeln | Ausführung | Vorschau & Tester | Wirkung auf andere Archetypen | Tests |
|---|---|---|---|---|---|---|
| **A** Destination Solutions heute | Kanal mit Fähigkeit „Portal kassiert nicht“ (bestätigt) → Modell A3, Zahlungen eigen | A3 v2, `documents.send`, `payments.internal` | Eigene Zahlungsabwicklung und Dokumentation wie bisher | Vorschau zeigt A3-Schritte; Tester `portal_booking` | keine | `ChannelCapabilityTest`, `BehaviourComparisonTest` |
| **B** Destination Solutions künftig | Fähigkeit „Portal kassiert“ bestätigen (mit Bestätigung des Abgleichs) → A4 | A4 v2, `money.portal_payout` statt interner Zahlung | Neue Vorgänge laufen als A4; laufende behalten ihren eingefrorenen Plan; **keine neue A4-Logik** | Vorschau und Tester zeigen A4; nicht erfüllte Modelle bleiben sichtbar mit Erklärung | A3/A5 unverändert | `ChannelCapabilityTest` (Wechsel, Abgleich `payments = portal`, Historie) |
| **C** Portalbestätigung als Voraussetzung | `await_portal_confirmation = ja`, Wartezeit, `booking_notice` | `portal.confirmation`, harte Abhängigkeit von `documents.send` und `documents.booking_notice` | Belegung sofort gesichert; Unterlagen/Information warten; nach Frist **eine** Aufgabe, nichts wird automatisch gesendet; Mail oder Bestätigung im Vorgang setzt fort | Szenario „Bestätigungsmail: sofort / verspätet / ausbleibend“ | nur Modelle, die das Modul enthalten (A3–A5 v2) | `DocumentsAndPortalConfirmationTest`, `ProcessTesterTest` |
| **D** Alternative Dokumentenverarbeitung | `contract_delivery = intern`, `booking_notice = automatisch` | `documents.send` (v2), `documents.booking_notice` | Vertrag erstellt und abgelegt, nicht gesendet; Gast erhält nur die Buchungsinformation; spätere Versendung von Hand möglich; Unterdrückung, wenn das Portal selbst informiert und bestätigt hat | Tester über Entwurf der Einstellungen | wie C | `DocumentsAndPortalConfirmationTest` |
| **E** Kommunikation über verschiedene Medien | Medium in `config/communication.php` aktiv, Vermieter kann einschränken | `MessageIntake`, `IntentClassifier`, `MessageMatcher` (E-Mail unverändert) | Antwort mit überprüftem Bezug wird dem Vorgang zugeordnet, Herkunft (`medium`, Kanal der Buchung) bleibt, Aufgabe „Posteingang prüfen“, nichts wird automatisch übernommen | Szenario „Nachricht über WhatsApp oder Chat“ | keine | `MessageMediumIntentTest`, `ProcessTesterTest` |
| **F** Auskunft ohne Buchungsanfrage | wie E | Wirkungen `answer_information`, `handoff_inquiry`, sonst `review` | Es entsteht weder Vorgang noch Reservierung, Angebot oder Buchung (strukturell: kein Wirkungstyp legt einen Vorgang an) | Szenario „Allgemeine Frage im Chat“ | keine | `MessageMediumIntentTest`, `ProcessTesterTest` |
| **G** Nichtlineare Datenbeschaffung | A1-Standard | `hold`, `guest.details`, `guest.data_request` unabhängig; `offer.binding` hart von den Angaben abhängig | Klärungsreservierung steht sofort, Datenbeschaffung läuft; das Angebot wartet („erst wenn alle Angaben da sind“) | Ansicht „braucht zuerst / läuft unabhängig“ | keine | `ExtensionAndIndependentStepsTest`, `ProcessRunnerTest` |
| **H** Neuer Zusatzschritt | Variante `address_check` (nur Tester) am Erweiterungspunkt `after_guest_identified` | `guest.address_check` | Nur Hinweis, hält nichts auf; echte Vorgänge können die Variante nicht erhalten | Tester-Entwurf | nur A1-Angebot hat die Variante; Standardabläufe aller Modelle unverändert (Test) | `ExtensionAndIndependentStepsTest` |
## 3. Regression (Phase 3)
Bestehende Suites unverändert grün: Prozesskern, Golden Master, laufende Vorgänge, Sandbox-Sicherheit (`ProcessTesterSecurityTest`, `SideEffectPathsTest`), Posteingang (`GuestMailInboxTest`), Dokumente (`DocumentCompositionTest`). Schwerpunkte:
| Thema | Absicherung |
|---|---|
| Vertragsverbindlichkeit, Angebotsversionen, Preisfestlegung | unveränderte Module; Loyalty-Nachweis und Angebots-Tests grün |
| Reservierungsfristen | Halte-Logik unverändert; Portalbestätigung berührt `occupying()` nicht (Test: Belegung bleibt während des Wartens) |
| Portalbestätigungen, Idempotenz | Mail zweimal → ein Vorgang; Aufgabe „Portalbestätigung fehlt“ nur einmal; zweiter Lauf von `bookings:advance-waiting` ohne Wirkung |
| Nachrichten: Zuordnung, Dubletten, Widersprüche | gleiche externe Kennung → einmal gespeichert; Absender/Name/Zeitraum allein ordnen nie zu; abweichende Vorgangsnummer → `review` |
| Bestehende Buchungen | Einstellungen mit V2-Standardwerten; eingefrorene Pläne (Version 1 bleibt) |
| Versand | Mail-Gate `EnforceMailTestMode` unverändert; keine neuen Versandwege; Medien-Antworten werden nicht gesendet |
| Mandantentrennung | `communication_rules` je Mandant, `InboundMessage` mandantengebunden (`BelongsToTenant`) |
| Sandbox | Szenarien nutzen nur die Sandbox-Datenbank; Sicherheitstests grün |
## 4. Offene Fachfragen (bewusst nicht entschieden)
Siehe `01_KONFIGURATIONSLUECKEN.md` F1–F7: Einwilligung für WhatsApp je Absender, Ausbleiben-Frist (48 h ist ein Vorschlag, einstellbar), Inkasso bei Destination Solutions, Storno/Erstattung je Modell, DS-/FW-Prüfungen. Kein Provideranschluss für WhatsApp/Chat; sie sind Testfälle der Architektur und standardmäßig **ausgeschaltet** (`config/communication.php`).
## 5. Kritische Selbstprüfung
1. **Konfigurierbarkeit wiederhergestellt oder nur weitere starre Modelle?** Wiederhergestellt, soweit fachlich zulässig: Innerhalb eines Archetyps stellt der Betreiber Ausführungsvariante, Dokumentenbehandlung, Wartebedingung, Zuständigkeit und Kommunikationswege ein; das Modell folgt aus den Kanalfähigkeiten. Neue Modelle (a3–a5 v2) enthalten nur zusätzliche Module, keine neuen Sonderabläufe.
2. **DS auf anderes Modell?** Ja (Fall B): Fähigkeit bestätigen → A4, mit erklärtem Abgleich alter Werte. Ohne neue A4-Logik.
3. **Dokumente unabhängig?** Ja: Vertrag erstellen/ablegen/senden, Buchungsinformation und Ergänzungsunterlagen getrennt; Pflichtgrenzen (Vertragsinhalt, Freigabe der Dokumentarten) bleiben.
4. **Auf Portal-Mail oder überprüften Eingang warten?** Ja (Fall C): Portal-Mail, die dem Vorgang deterministisch zugeordnet ist, oder Bestätigung des Vermieters.
5. **Medien mit unterschiedlichen Befugnissen je Absicht?** Ja: Wirkungen je Medium × Absicht; Vermieter dürfen nur einschränken.
6. **WhatsApp löst Auskunft aus, ohne Buchungskanal zu sein?** Ja (Fall F): `answer_information` / `handoff_inquiry`; kein Wirkungstyp erzeugt Vorgang oder Buchung.
7. **Künftiger KI-Chat?** Ja, als Adapter: Er liefert `IncomingMessage` mit überprüftem Bezug; Klassifikation und Regeln liegen im Kern. Der Chat-Anschluss ist nicht gebaut; die Absichtserkennung kann später hinter derselben Schnittstelle (`IntentClassifier`) durch ein Modell ersetzt werden.
8. **Unabhängige Schritte schreiten fort?** Ja (Fall G, `ProcessRunner`: harte Abhängigkeit hält nur den abhängigen Schritt).
9. **Tatsächliches Verhalten oder starre Liste?** Ansicht aus denselben Definitionen wie die Ausführung; Phasen gruppiert, Abhängigkeiten, Unabhängigkeit, Bedingungen und Ausführungsvarianten sichtbar. Einschränkung: keine grafische Darstellung (bewusst, kein BPMN-Editor).
10. **Im Tester durchspielbar?** Ja, drei neue Szenarien; Entwurfseinstellungen werden ohne Speichern getestet. Die geforderte Szenarienliste ist damit nicht vollständig als einzelne Szenarien abgebildet: Dokumentvarianten und eingefrorene Konfiguration laufen über den Entwurf bestehender Szenarien (siehe Abschnitt 6).
11. **Änderungen beeinflussen andere Archetypen?** Nein: Version 1 der Modelle bleibt, neue Module bedingt/aus als Standard, Standardabläufe unverändert (Test), `process:impact` zeigt die betroffenen Modelle.
12. **Verständlich und wirtschaftlich?** Die neuen Einstellungen sind Auswahlfelder an dem Schritt, den sie betreffen, mit Standard „wie bisher“; Einschränkungen werden in Klartext erklärt. Für Vermieter mit nur einer Website ändert sich nichts. Aufwand der Konfiguration lohnt sich vor allem für Portalkanäle; das ist so gewollt.
## 6. Bekannte Grenzen und Restpunkte
- Dokumentvarianten, Stammdaten-Abgleich, eingefrorene Konfiguration und unabhängige Aktivitäten sind als Tests, nicht als eigene Tester-Szenarien abgebildet (der Tester spielt die Szenarien mit beliebigen Entwurfseinstellungen durch).
- Eingehende Nachrichten anderer Medien werden gespeichert und entschieden; ein Posteingangs-Bildschirm zeigt `medium`, `intent` und `decision` nicht gesondert an.
- Keine Antwort wird über WhatsApp/Chat gesendet.
@@ -0,0 +1,88 @@
<?php
namespace Tests\Feature\Process;
use App\Actions\CreateReservation;
use App\Enums\ActivityState;
use App\Models\Booking;
use App\Models\Property;
use App\Pricing\StayRequest;
use App\Process\CaseActivities;
use App\Process\ProcessCatalogue;
use App\Process\ProcessPlan;
use Carbon\CarbonImmutable;
use Database\Seeders\PropertySeeder;
use Database\Seeders\SiteSeeder;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Mail;
use PHPUnit\Framework\Attributes\Group;
use Tests\TestCase;
/**
* V2.1 cases G and H: independent steps proceed while others wait (G); a new optional step is added at an existing
* extension point without touching any other model (H).
*/
#[Group('module:guest.address_check')]
class ExtensionAndIndependentStepsTest extends TestCase
{
use RefreshDatabase;
private Property $property;
protected function setUp(): void
{
parent::setUp();
$this->travelTo(CarbonImmutable::parse('2026-10-23 10:00'));
$this->seed([PropertySeeder::class, SiteSeeder::class]);
$this->property = Property::sole();
Mail::fake();
}
/** Case H: the optional address check sits at an extension point; only the A1 offer model offers the variant. */
public function test_case_h_an_optional_address_check_is_added_at_an_extension_point_without_changing_other_models(): void
{
$catalogue = app(ProcessCatalogue::class);
$using = array_keys(array_filter($catalogue->models(), fn ($model): bool => collect($model->variants())->contains(fn ($variant): bool => in_array('guest.address_check', $model->modules($variant->key), true))));
$this->assertSame(['a1.offer'], $using);
$this->assertSame([], $catalogue->problems());
foreach ($catalogue->models() as $key => $model) {
$this->assertNotContains('guest.address_check', $model->modules('standard'), "{$key}: standard course unchanged");
}
$booking = $this->request(postalCode: '1011');
$plan = ProcessPlan::freeze($booking->process(), ['model' => 'a1.offer', 'variant' => 'address_check'], sandbox: true);
$booking->forceFill(['profile' => [...$booking->profile, 'plan' => $plan->toArray()]])->saveQuietly();
$check = collect(CaseActivities::for($booking->fresh()))->firstWhere('key', 'address_check');
$this->assertSame(ActivityState::Done, $check->state, 'the check only informs and holds nothing back');
$this->assertStringContainsString('Postleitzahl hat nicht fünf Ziffern', $check->detail);
}
public function test_case_h_the_address_check_cannot_reach_a_real_case(): void
{
$this->expectExceptionMessage('nur im Prozess-Tester');
ProcessPlan::freeze($this->request()->process(), ['model' => 'a1.offer', 'variant' => 'address_check']);
}
/** Case G: the clarification hold stands while the missing details are collected; the offer waits for them, not for the hold. */
public function test_case_g_hold_and_data_collection_run_independently_and_the_offer_waits_for_the_details(): void
{
$booking = $this->request(street: '');
$activities = collect(CaseActivities::for($booking->fresh()))->keyBy('key');
$this->assertTrue(Booking::query()->occupying()->whereKey($booking->id)->exists(), 'the dates are held at once, independent of the missing details');
$this->assertSame(ActivityState::Open, $activities['contact']->state);
$this->assertStringContainsString('fehlt: Straße und Hausnummer', $activities['contact']->detail);
$this->assertSame(ActivityState::Later, $activities['offer']->state, 'no binding offer before the required details');
$this->assertSame('erst wenn alle Angaben da sind', $activities['offer']->detail);
}
private function request(string $street = 'Weg 1', string $postalCode = '10115'): Booking
{
return app(CreateReservation::class)->handle($this->property->fresh(), new StayRequest(CarbonImmutable::parse('2026-11-07'), CarbonImmutable::parse('2026-11-10'), 2), ['first_name' => 'Gesa', 'last_name' => 'Gast', 'email' => 'gesa@example.org', 'street' => $street, 'postal_code' => $postalCode, 'city' => 'Berlin', 'country' => 'DE'])->fresh();
}
}