Skip to main content

Module checkout_completion

Module checkout_completion 

Source
Expand description

Checkout-closeout packets, gates, and safe handoff drafts. Checkout-completion workflow rules for staff departure handoff and closeout review.

§Operator summary

Staff use this workflow to decide whether a departure belongs in the verified-checkout queue, the staff-handoff-review queue, or the source-status-reconciliation queue. It compares the source reservation status with front-desk handoff evidence such as belongings return, care summary, and departure-note review so operators do not manually audit every checkout record across the PMS, care notes, and follow-up queues.

The workflow can reduce labor by summarizing checkout evidence, creating an internal handoff task, drafting retention follow-up for review, and producing audit-event drafts. It is not allowed to close a live PMS/provider record, send a customer message, apply a checkout status without staff/source agreement, release capacity, waive/discount/refund, collect payment, or move money. Payment and closeout surfaces remain review queues, not autonomous execution.

Source facts remain authoritative in their own systems: domain::source::Provenance and domain::source::reservation::Status for observed provider state, staff-submitted handoff evidence for belongings and departure notes, domain::entities::reservation::Status for the normalized lifecycle suggestion, and approved payment/ledger records for balances, refunds, discounts, or waivers. Review gates protect pets, customers, and staff by requiring manager approval when source or handoff evidence is incomplete and customer-message approval before any departure or retention copy leaves draft form.

Structs§

CareSummary
Packet
Reviewable packet handed to staff or agents with deterministic gates already applied.
Request
Input rules for building the workflow packet from source-grounded records.
RequestBuilder
Use builder syntax to set the inputs and finish with build().
StaffHandoff
Staff handoff used by the checkout completion workflow; it keeps checkout tasks, payment exceptions, and handoff notes explicit for staff review.
StaffHandoffBuilder
Use builder syntax to set the inputs and finish with build().
Workflow
Workflow used by the checkout completion workflow; it keeps checkout tasks, payment exceptions, and handoff notes explicit for staff review.

Enums§

AuditEventDraft
Decision choices for audit event draft in the checkout completion workflow; each value routes reviewed source facts to the right queue, draft, or staff gate.
BelongingsStatus
Decision choices for belongings status in the checkout completion workflow; each value routes reviewed source facts to the right queue, draft, or staff gate.
BlockedAction
Actions the agent must never perform without a human/operator system of record.
CareSummaryError
CompletionStatus
Decision choices for completion status in the checkout completion workflow; each value routes reviewed source facts to the right queue, draft, or staff gate.
DepartureNotesReview
Decision choices for departure notes review in the checkout completion workflow; each value routes reviewed source facts to the right queue, draft, or staff gate.
SafeAgentAction
Review-safe agent tasks allowed to save staff time without crossing mutation or send gates.