v0.11 U2: Angebots-Gate, gemeinsamer Fakteneingang mit Herkunft
- CaseRequirements: Vor einem eigenen verbindlichen Angebot und vor der verbindlichen Bestätigung eines Buchungswunsches müssen Vor- und Nachname, E-Mail, vollständige Anschrift mit Land, Personenzahl und Zeitraum vorliegen – harter Blocker, auch von Hand (G2a, B3). Die Auskunft unter Vorbehalt bleibt ohne dieses Gate. - ContributeCaseFacts (S5): jede Angabe mit Herkunft und Ergebnis in case_facts; fehlend → übernommen, gleich → bestätigt, abweichend vom Gast → Prüfaufgabe (Kartei bleibt), Vermieterin maßgeblich, Zeitraum und Personen → Änderungswunsch; idempotent; danach einmal CaseAutomation. - ProvideGuestContact und Webformular nutzen den Fakteneingang. - Land als ISO-Code mit „Deutschland“ als änderbarem Formularstandard; guests.country ohne stillen Standardwert (B4). - Testdaten bestehender Tests um Anschriften ergänzt. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
799869c6a4
commit
ccac78a6c9
33 files changed
+1041
-47
No files matched your search
@@ -0,0 +1,138 @@
|
||||
<?php
|
||||
|
||||
namespace App\Process;
|
||||
|
||||
use App\Models\Booking;
|
||||
|
||||
/**
|
||||
* The details a case needs before an action (v0.11, G2a / E-032 / CH §1.3). The one place that knows the required
|
||||
* details: before an own binding offer and before the binding confirmation of a booking wish the contracting party's
|
||||
* first and last name, e-mail, full postal address including the country, the number of guests and the dates must be
|
||||
* there. The information "unter Vorbehalt" needs none of them beyond what it needs today (B3). A missing address is
|
||||
* a blocker that cannot be confirmed away.
|
||||
*
|
||||
* A pre-filled country of a form counts only when the guest sent it (B4); an empty field is never assumed.
|
||||
*/
|
||||
final class CaseRequirements
|
||||
{
|
||||
/** Own binding offer (A1/A2). */
|
||||
public const OFFER = 'offer';
|
||||
|
||||
/** Binding confirmation of a booking wish after an information without hold (package 7). */
|
||||
public const WISH_CONFIRMATION = 'wish_confirmation';
|
||||
|
||||
/** @var array<string, string> field key => label */
|
||||
public const FIELDS = [
|
||||
'guest.first_name' => 'Vorname',
|
||||
'guest.last_name' => 'Nachname',
|
||||
'guest.email' => 'E-Mail-Adresse',
|
||||
'guest.street' => 'Straße und Hausnummer',
|
||||
'guest.postal_code' => 'PLZ',
|
||||
'guest.city' => 'Ort',
|
||||
'guest.country' => 'Land',
|
||||
'booking.guests' => 'Personenzahl',
|
||||
'booking.arrival' => 'Anreise',
|
||||
'booking.departure' => 'Abreise',
|
||||
];
|
||||
|
||||
/** Fields the guest can give for a case (contact and stay details beyond the required ones). */
|
||||
public const OPTIONAL_FIELDS = [
|
||||
'guest.phone' => 'Telefon',
|
||||
'booking.arrival_time' => 'Voraussichtliche Anreisezeit',
|
||||
];
|
||||
|
||||
/**
|
||||
* Required fields of the action that are missing or not valid.
|
||||
*
|
||||
* @return list<string> field keys of {@see self::FIELDS}
|
||||
*/
|
||||
public static function missing(Booking $booking, string $action = self::OFFER): array
|
||||
{
|
||||
$missing = [];
|
||||
foreach (array_keys(self::FIELDS) as $field) {
|
||||
if (! self::isValid($field, self::value($booking, $field))) {
|
||||
$missing[] = $field;
|
||||
}
|
||||
}
|
||||
|
||||
return $missing;
|
||||
}
|
||||
|
||||
public static function isComplete(Booking $booking, string $action = self::OFFER): bool
|
||||
{
|
||||
return self::missing($booking, $action) === [];
|
||||
}
|
||||
|
||||
/**
|
||||
* The blocker text for the action, or null when nothing is missing.
|
||||
*/
|
||||
public static function blocker(Booking $booking, string $action = self::OFFER): ?string
|
||||
{
|
||||
$missing = self::missing($booking, $action);
|
||||
if ($missing === []) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$what = $action === self::WISH_CONFIRMATION ? 'die verbindliche Bestätigung' : 'ein verbindliches Angebot';
|
||||
|
||||
return 'Für '.$what.' fehlen noch Angaben: '.implode(', ', self::labels($missing)).'.';
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether an incomplete request may get the clarification hold (V1, E-033): property, unambiguous dates and an
|
||||
* e-mail address that can be written to. The free calendar is checked by the caller.
|
||||
*/
|
||||
public static function qualifiesForClarificationHold(Booking $booking): bool
|
||||
{
|
||||
return $booking->property_id !== null
|
||||
&& $booking->arrival !== null && $booking->departure !== null && $booking->departure->greaterThan($booking->arrival)
|
||||
&& self::isValid('guest.email', $booking->guest?->email);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param list<string> $fields
|
||||
* @return list<string>
|
||||
*/
|
||||
public static function labels(array $fields): array
|
||||
{
|
||||
return array_map(fn (string $field): string => self::FIELDS[$field] ?? self::OPTIONAL_FIELDS[$field] ?? $field, $fields);
|
||||
}
|
||||
|
||||
public static function label(string $field): string
|
||||
{
|
||||
return self::labels([$field])[0];
|
||||
}
|
||||
|
||||
/**
|
||||
* Current value of a field of the case (guest fields from the guest record).
|
||||
*/
|
||||
public static function value(Booking $booking, string $field): mixed
|
||||
{
|
||||
[$scope, $attribute] = explode('.', $field, 2);
|
||||
$value = $scope === 'guest' ? $booking->guest?->{$attribute} : $booking->{$attribute};
|
||||
|
||||
return $value instanceof \DateTimeInterface ? $value->format('Y-m-d') : $value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether a value is usable for the field.
|
||||
*/
|
||||
public static function isValid(string $field, mixed $value): bool
|
||||
{
|
||||
if (is_string($value)) {
|
||||
$value = trim($value);
|
||||
}
|
||||
if ($value === null || $value === '') {
|
||||
return false;
|
||||
}
|
||||
|
||||
return match ($field) {
|
||||
'guest.email' => filter_var($value, FILTER_VALIDATE_EMAIL) !== false,
|
||||
'guest.postal_code' => (bool) preg_match('/^[A-Za-z0-9][A-Za-z0-9 \-]{1,9}$/', (string) $value),
|
||||
'guest.country' => (bool) preg_match('/^[A-Z]{2}$/', (string) $value),
|
||||
'booking.guests' => is_numeric($value) && (int) $value >= 1,
|
||||
'booking.arrival', 'booking.departure' => strtotime((string) $value) !== false,
|
||||
default => mb_strlen((string) $value) >= 1,
|
||||
};
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user