Part G · Technical contract
The backend owns state. Everything else submits business commands.
Frontend users, vendors, lenders, integrations and AI submit business commands; they never directly patch current_state. Every transition re-checks current state and version, actor authority, prerequisites, evidence, rules, holds, exceptions, approval and idempotency.
Live graph
The lifecycle, as a guarded signal chain
InteractiveHover or focus any state to isolate its guarded inbound and outbound transitions. No edge exists without a gate; no gate passes without an audit entry.
State catalog
Guarded transitions, RECEIVED → CLOSED_ARCHIVED
| From | To | Trigger / required gate |
|---|---|---|
| RECEIVED | VALIDATING | Assignment created; validation workflow starts. |
| VALIDATING | PENDING_INFORMATION | Required field or evidence missing / conflicted. |
| PENDING_INFORMATION | VALIDATING | New required information received. |
| VALIDATING | COMPLIANCE_REVIEW | Identity, duplicate and lender configuration gates pass. |
| COMPLIANCE_REVIEW | DISPATCH_READY | Readiness checklist passes; no blocking hold. |
| DISPATCH_READY | DISPATCHED | Vendor eligible at point of dispatch; approval valid. |
| DISPATCHED | AWAITING_VENDOR_RESPONSE | Dispatch delivery initiated successfully. |
| AWAITING_VENDOR_RESPONSE | VENDOR_ASSIGNED | Vendor accepts while the attempt is valid. |
| VENDOR_ASSIGNED | ACTIVE_RECOVERY | Qualifying First Action recorded. |
| ACTIVE_RECOVERY | VEHICLE_LOCATED | Qualifying vehicle-location event reported. |
| VEHICLE_LOCATED | RECOVERY_REPORTED | Vendor submits recovery package. |
| RECOVERY_REPORTED | RECOVERY_VERIFIED | Evidence passes identity and verification gates. |
| RECOVERY_VERIFIED | POST_RECOVERY | Post-recovery workflow initializes. |
| POST_RECOVERY | CUSTODY_VERIFICATION | Custody verification starts. |
| CUSTODY_VERIFICATION | AWAITING_LENDER_DIRECTION | Custodian known; critical issues resolved. |
| AWAITING_LENDER_DIRECTION | TRANSPORT / DISPOSITION | Authorized direction, no conflicting hold. |
| TRANSPORT | DISPOSITION | Authorized transport completed; handoff verified. |
| DISPOSITION | OPERATIONALLY_COMPLETE | Outcome and evidence complete. |
| OPERATIONALLY_COMPLETE | FINANCIAL_REVIEW | Financial close workflow starts. |
| FINANCIAL_REVIEW | FINANCIALLY_COMPLETE | Ledger reconciled; controls satisfied. |
| FINANCIALLY_COMPLETE | PENDING_FINAL_CERTIFICATION | Operational and financial prerequisites met. |
| PENDING_FINAL_CERTIFICATION | CERTIFICATION_HOLD | Certification deficiency discovered. |
| CERTIFICATION_HOLD | PENDING_FINAL_CERTIFICATION | Deficiency remediated or exception documented. |
| PENDING_FINAL_CERTIFICATION | FINAL_CERTIFICATION_COMPLETE | Certifications and human review pass. |
| FINAL_CERTIFICATION_COMPLETE | CLOSURE_REVIEW | Closure requested; human review required. |
| CLOSURE_REVIEW | CLOSED_ARCHIVED | Human closes after final guards re-run. |
| CLOSED_ARCHIVED | REOPENED | Authorized reopen with reason and target workflow. |
Engineering noteOverlays, not state explosion: HOLD restrictions, exceptions, SLA risk, Human Takeover, AI paused and system-degraded conditions are overlays or domain statuses — they never multiply the primary lifecycle into hundreds of combined states.
Part B · Architecture evidence
Capability classification
AI has no direct state-write authority
State transitions are guard-controlled
Illegal transitions rejected
Role authorization enforced
Version conflicts enforced
Hash-chained audit verifies
Human closure guard
Full vertical lifecycle population
Timers derived from obligations
Vendor hard-gate filtering
Vendor/lender production UX
Real lender SLA behavior
Real compliance/legal inputs
AI recommendation quality
Trial economics / time savings
Results are preserved under a tagged test/build record — commit SHA, fixture version, rule version, schema migrations, automated test results, audit-chain verification result and date.
Part F · Domain responsibilities
Seventeen systems and what each owns
Identity & Access
Users, roles, permissions, MFA, sessions, service identities.
Assignment
Lifecycle, state, Living Operational Plan, dependencies, next action.
Lender
Configuration, SLAs, vendor approvals, communication and billing rules.
Vendor
Coverage, capabilities, capacity, performance, relationship status.
Compliance
Requirements, evidence, verification, eligibility gates.
Dispatch
Eligibility filtering, ranking, offer, acceptance, backup routing.
Active Operations
Work sessions, check-ins, stagnation detection, escalation.
Recovery
Location events, recovery packages, identity verification.
Custody
Storage, personal property, authorization and release control.
Documents
Document intelligence, extraction, classification, integrity.
Communications
Templated, approved, logged outbound and inbound traffic.
Finance
Ledger, reconciliation, billing, payment and exception controls.
Certification
Operational, financial and compliance certification gates.
Archive / Reopen
Retention, authorized reopen with reason and target workflow.
Exceptions
Incidents, holds, overlays, severity and ownership.
AI Gateway
Bounded AI authority, prompts, refusals, kill switch.
Audit / Observability
Hash-chained history, negative-action auditability.