Endpoints de execução
Estas rotas também ficam em /api, com o access token da sessão. A lista e a leitura da foto pedem checklist:ver. Salvar resposta e concluir pedem checklist:editar. Pedir a URL de upload pede checklist:criar.
A lista de hoje também dispara a geração da rede antes de responder.
Lista do dia
GET /api/checklists/hoje devolve as execuções cujo periodo é hoje no fuso da rede e que a pessoa alcança:
- o dono vê as da rede;
- a execução em que
usuarioé ela; - a execução nominal em que
pessoaé ela; - a execução por cargo no local dela, se o cargo dela está na atribuição e não há exceção no nome dela.
Cada item traz a tarefa, o local, o status, limite, prazo, comentário de devolução e as atividades com a resposta já gravada. Se a execução voltou ao cargo e o responsável anterior é outra pessoa, o item indica o nome e se o motivo foi saída ou troca de cargo.
Assumir
A execução por cargo nasce sem dono.
| Método | Caminho | Efeito |
|---|---|---|
POST | /api/checklists/execucoes/:id/abrir | Se já é dela, devolve o id. Se é nominal, recusa. Se é por cargo, assume. |
POST | /api/checklists/execucoes/:id/assumir | O mesmo assumir, sem o atalho de quem já é o dono. |
Assumir exige o local no escopo da pessoa, o cargo dela na atribuição daquele local e a ausência de exceção. A segunda pessoa recebe "Esta execução já foi assumida." A auditoria grava assumir.
Respostas
PUT /api/checklists/execucoes/:id/respostas grava o rascunho. Só o usuario atual altera uma execução aberto, atrasado ou devolvido.
{
"respostas": [
{ "atividadeId": "cka-geladeira", "texto": "sim" },
{ "atividadeId": "cka-temperatura", "numero": 3.2, "evidencia": "pao-quente/evidencias/…" },
{ "atividadeId": "cka-obs", "texto": "" }
]
}
Uma resposta vazia apaga a linha daquela atividade. Sim ou não aceita sim e nao. Temperatura fora da faixa grava conforme: false e segue. A chave da evidência tem de ser da rede e, quando a atividade pede foto, tem de estar vinculada àquela atividade.
Concluída ou aprovada não é alterada. Sem ter assumido, a resposta é "Abra a execução antes de responder."
Concluir
POST /api/checklists/execucoes/:id/concluir envia para revisão. Antes disso, cada atividade obrigatória precisa de resposta, e cada atividade que exige evidência precisa da chave quando é obrigatória ou quando já foi respondida. Foto obrigatória é a própria evidência.
O sucesso passa o status para concluido, grava concluida_em, limpa o comentário da revisão anterior e zera refazer. A resposta inclui a quantidade de não conformidades. Temperatura fora da faixa não bloqueia o envio.
Evidência
POST /api/evidencias/upload pede a URL assinada e já cria checklist_evidencia.
{
"execucaoId": "ckx-…",
"atividadeId": "cka-…",
"nome": "vitrine.jpg",
"contentType": "image/jpeg",
"tamanho": 240000
}
A execução precisa estar aberta para essa pessoa. A atividade precisa ser da versão dela. Os tipos aceitos são JPEG, PNG, WebP, HEIC e HEIF. O tamanho padrão máximo é 10 MB. A resposta traz a URL de upload e a chave, que depois entra na resposta da atividade.
GET /api/evidencias/leitura?chave= devolve outra URL assinada. A chave fora da rede é recusada. Quem não alcança o local, ou a pessoa da execução nominal, recebe 403.
Offline, devolvido e troca de cargo
Não há endpoint de fila offline. O aparelho guarda resposta, foto e conclusão e chama as rotas desta página quando a rede volta. O passo a passo da faixa Sem conexão está em Responder sem conexão.
POST .../devolver, no dono, passa a execução para devolvido. POST .../concluir devolve para concluido e limpa o comentário e refazer.
Trocar o cargo ou desativar a pessoa, nas rotas de equipe, solta a execução aberto, atrasado ou devolvido do cargo que o cargo novo não cobre. A auditoria grava devolver_cargo. Concluída e aprovada continuam com quem fez. A revisão só troca a tabela pela linha do tempo quando esse registro existe.