@startuml uml-state-orden
!include _style.iuml

title 1. State machine — Orden (estatus_orden)

' Estado inicial implicito hasta que el cliente solicita el servicio.
[*] --> solicitada : solicitar(cliente, servicio, zona)

solicitada    --> asignada     : asignar(prestador) [match exitoso]
solicitada    --> cancelada    : cancelar(motivo) / log_auditoria

asignada      --> en_camino    : iniciar_camino() / push_cliente
asignada      --> cancelada    : cancelar(motivo)

en_camino     --> en_progreso  : llegar() / iniciar_servicio()
en_camino     --> cancelada    : cancelar(motivo) [pre-completada]

en_progreso   --> completada   : completar(evidencia) / firma_cliente
en_progreso   --> cancelada    : cancelar(motivo) [pre-completada]

completada    --> [*]
cancelada     --> [*]

note right of solicitada
  Estado por defecto en alta de la orden
  (00.sql:402, DEFAULT 'solicitada').
end note

note right of completada
  Dispara liquidacion al prestador,
  cargos_extra aceptados y CSAT.
end note

note left of cancelada
  Cancelable desde cualquier estado
  pre-completada. Registra motivo y
  actor en historial_estatus_orden.
end note

footer Fuente: ENUM estatus_orden 00.sql:52 | tabla ordenes 00.sql:402 | historial_estatus_orden 00.sql:426 | actions ordenes.ts

@enduml