$priceLines * @param list $services * @param list $cancellation * @param list $annexes * @param array|null $terms the terms the document freezes (null: the website texts apply live) * @param list $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 */ public function blockers(): array { return $this->messages(DocumentFinding::BLOCKER); } /** * @param list $except codes of findings left out * @return list */ public function toConfirm(array $except = []): array { return $this->messages(DocumentFinding::CONFIRM, $except); } /** * @return list */ 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 */ 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 $except * @return list */ 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)))); } }