Skip to content
solutions-backend

solutions_backend.api.orders

Authenticated canonical WorkOrder reads and execute-once operation routes.

Functions

execute_work_order_operation

execute_work_order_operation(work_order_id: UUID, request: WorkOrderOperationRequest, response: Response, runtime: AuthenticatedRuntime) -> WorkOrderOperationResult

Execute, recover, or replay one exact authenticated WorkOrder intent.

get_work_order

get_work_order(work_order_id: UUID, runtime: AuthenticatedRuntime) -> WorkOrder

Load one complete canonical aggregate snapshot.

get_work_order_operation

get_work_order_operation(operation_id: UUID, runtime: AuthenticatedRuntime) -> WorkOrderOperationState

Inspect durable running, unknown, or terminal operation state.

get_work_order_timeline

get_work_order_timeline(work_order_id: UUID, runtime: AuthenticatedRuntime, before_version: Annotated[int | None, Query(ge=1)] = None, limit: Annotated[int, Query(ge=1, le=500)] = 100) -> WorkOrderTimelinePage

Return newest-first immutable canonical business history.

list_work_order_calendar

list_work_order_calendar(runtime: AuthenticatedRuntime, window_start: datetime, window_end: datetime, limit: Annotated[int, Query(ge=1, le=1000)] = 500) -> WorkOrderCalendarPage

Return canonical appointments overlapping one half-open time window.

list_work_orders

list_work_orders(runtime: AuthenticatedRuntime, phase: OperationalPhase | None = None, client_id: UUID | None = None, property_id: UUID | None = None, cursor: str | None = None, limit: Annotated[int, Query(ge=1, le=200)] = 50) -> WorkOrderListPage

Return a compact stable operational queue page.