Estados da OS e como funcionam as transições
A jornada de uma OS
Uma ordem de serviço passa por uma sequência de estados, do nascimento até a entrega. O AutoBaze controla essa sequência e bloqueia transições que não fazem sentido.
Os sete estados
- Orçamento: OS recém-criada, ainda não aprovada pelo cliente
- Aprovado: cliente confirmou, pronta para iniciar
- Em Execução: técnico já começou o trabalho
- Aguardando Peças: parou no meio porque falta peça
- Concluído: trabalho terminado, aguardando entrega
- Entregue: cliente já recebeu e a OS está fechada
- Cancelado: OS abortada por qualquer motivo
Para onde cada estado pode ir
A regra é a seguinte:
- Orçamento pode virar Aprovado ou Cancelado
- Aprovado pode virar Em Execução ou Cancelado
- Em Execução pode virar Aguardando Peças, Concluído ou Cancelado
- Aguardando Peças volta para Em Execução ou vai para Cancelado
- Concluído pode virar Entregue ou Cancelado
- Entregue e Cancelado são finais (não saem mais)
Se você tenta uma transição que não está nessa lista, o AutoBaze avisa: "Transição não permitida".
O que acontece automaticamente em cada virada
Algumas transições disparam efeitos no resto do sistema:
- Quando vira Aprovado: o AutoBaze gera uma venda vinculada à OS e baixa o estoque das peças listadas. A venda já entra como finalizada (o pagamento é controlado pela OS).
- Quando vira Concluído: é criada uma conta a receber com valor total da OS, status "sem vencimento" (você define quando o cliente vai pagar).
- Quando vira Cancelado: se já existia venda vinculada, o estoque é devolvido automaticamente (peças voltam para o estoque) e a venda é marcada como cancelada.
Idempotência
Os efeitos automáticos são idempotentes: se por alguma razão a mesma transição rodar duas vezes (ex.: você arrasta o cartão, perde conexão, tenta de novo), o sistema não duplica venda nem baixa estoque duas vezes. Cada hook checa se já fez antes de fazer de novo.
Atalhos de configuração
Em configurações você pode ajustar comportamentos:
- Exigir aprovação de orçamento: se ligado, OS sempre nasce em "Orçamento" e precisa passar por aprovação explícita
- Permitir reabrir: deixa você voltar status manualmente (por exemplo, de Concluído para Em Execução)
- Exigir pagamento na entrega: bloqueia a virada para Entregue se a OS não estiver 100% paga
- Exigir comprovante de entrega: pede assinatura digital antes de marcar como Entregue
Histórico de transições
Cada mudança de status fica registrada no histórico da OS, com quem fez, quando e qualquer observação anexada. Você consulta esse histórico dentro do modal da OS, na aba do mesmo nome.
