Criando Tasks Manualmente

Em uma frota madura, a maioria das ordens de servico e criada pelo rule engine, mas criacao manual continua sendo a resposta certa para trabalho ad-hoc: a ligacao de um cliente sobre um moped vazando em um estacionamento, uma modificacao planejada, uma inspecao unica. Este artigo cobre os tres caminhos manuais.

Pelo quadro Kanban

E o caminho mais rapido e o que sua equipe de operacoes vai usar em 90% dos casos.

Pela pagina de detalhe do veiculo

Se voce ja esta olhando o historico de um veiculo, e mais rapido criar a task no contexto:

1. Abra o veiculo em /dashboard/vehicles/[id]
2. Role ate o card Open Tasks a direita
3. Clique + New Task
4. O dialog abre com o veiculo pre-selecionado - preencha type, priority, title, description e crie

A pagina de detalhe do veiculo tambem mostra toda task fechada contra a maquina na secao Maintenance History, entao voce pode confirmar se uma determinada falha esta recorrente antes de abrir outra ordem.

Pela API

Para integracoes e scripts, faca POST em /api/tasks:

POST /api/tasks
Content-Type: application/json

{
  "vehicle_uuid": "uuid-here",
  "task_type": "repair",
  "priority": "high",
  "title": "Front brake cable replacement",
  "description": "Reported by rider - cable slipping. Replace cable + housing.",
  "assignee_id": "team-member-uuid-or-null"
}

A rota aplica a regra uma task aberta do mesmo type por veiculo. Se ja existe uma task repair aberta contra o veiculo, a resposta e 200 com skipped_duplicate: true em vez de 201. Isso evita duplicatas de rule-loop e de bugs de integracao.

O que acontece apos criar

Tres coisas disparam imediatamente:

1. Relogio de SLA comeca. sla_due_at e escrito com base na sua config de priority.
2. Checagem de status do veiculo. Se priority for high ou critical, um trigger de banco vira vehicles.status para maintenance - a menos que o veiculo esteja in_use (com corrida ativa), caso em que a virada aguarda o fim.
3. Distribuicao de notificacao. Se a task estiver atribuida, o assignee recebe um Expo push. Se a priority for critical, o ops_manager do subaccount tambem recebe push e mensagem no Slack.

O que voce nao pode fazer manualmente

Algumas regras para manter os dados limpos:

• Voce nao pode criar uma task sem vehicle_uuid. Ativos que nao sao veiculos (carregadores, baterias na prateleira) estao fora do escopo ate a expansao CMMS.
• Voce nao pode criar uma task duplicada do mesmo task_type contra o mesmo veiculo. Feche a primeira ou escolha outro type.
• Voce nao pode criar uma task para um veiculo de outro subaccount. RLS bloqueia no servidor.