Pular para o conteúdo principal

Endpoints de execução

ReferênciaParaQuem integra ou mantémLeitura5 min

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étodoCaminhoEfeito
POST/api/checklists/execucoes/:id/abrirSe já é dela, devolve o id. Se é nominal, recusa. Se é por cargo, assume.
POST/api/checklists/execucoes/:id/assumirO 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.