Modelo de dados
Tudo fica no Postgres, por rede (cliente_id). A versão publicada não muda. A execução aponta para a versão em que nasceu e não troca depois.
checklist_tarefa
└── checklist_tarefa_versao
└── checklist_atividade
└── checklist_atribuicao
└── checklist_atribuicao (exceção)
└── checklist_realizacao
├── checklist_resposta
└── checklist_evidencia
Tarefa
checklist_tarefa é o checklist em si: nome e status.
| Status | Significado |
|---|---|
rascunho | Ainda não gera execução. |
publicado | A última versão publicada entra na geração. |
arquivado | Não gera mais e não volta a ser editado. |
Versão e atividade
checklist_tarefa_versao numera o modelo. numero começa em 1. publicado_em nulo é rascunho. Só pode existir um rascunho por tarefa. Depois de publicado, a linha não é atualizada nem apagada.
checklist_atividade pertence a uma versão. A ordem começa em 0. O tipo é um destes:
| Tipo | O que guarda | Regra |
|---|---|---|
sim_nao | texto sim ou nao | Sem faixa e sem unidade. |
temperatura | numero | Exige faixa_min, faixa_max e unidade. A mínima não passa da máxima. |
foto | evidencia | A foto é a resposta. |
texto | texto | Sem faixa e sem unidade. |
obrigatoria nasce verdadeira. exige_evidencia pede uma foto além da resposta. Atividade de versão publicada também é imutável.
Atribuição
checklist_atribuicao diz quem recebe o checklist e quando ele abre. Há três formas, e a forma é rígida:
| Modo | Preenche | Não preenche |
|---|---|---|
cargo_local | cargo e local_id | pessoa e origem_id |
pessoa | pessoa | cargo, local_id e origem_id |
excecao | pessoa e origem_id | cargo e local_id |
O cargo é um papel da rede: owner, admin, purchasing, franchisee, dc-manager, central-kitchen, store-manager ou kitchen-lead. O local precisa ser da mesma rede e do tipo Loja ou CD. A exceção aponta para uma atribuição cargo_local da mesma tarefa e tira aquela pessoa dessa atribuição. A exceção não gera execução própria.
A agenda da atribuição está em Recorrência e versionamento.
Execução
checklist_realizacao é o checklist de um período.
| Campo | Uso |
|---|---|
versao_id | Versão publicada no momento em que a execução nasceu. Não muda. |
modo | cargo_local ou pessoa. |
local_id | Loja ou CD, no modo por cargo. Nulo no modo por pessoa. |
usuario | Quem assumiu. Nulo enquanto a execução por cargo não tem dono. |
cargo / pessoa | O destino da atribuição que gerou a execução. |
periodo | O dia, no fuso da rede. Na recorrência única, a data marcada. |
limite_em | Hora em que a execução abre. |
prazo_em | limite_em mais prazo_minutos. Depois disso, aberto vira atrasado. |
concluida_em | Quando foi enviada para revisão. |
revisao_comentario, revisado_por, revisado_em | A devolução. Aprovar limpa o comentário. |
Status da execução:
| Status | Significado |
|---|---|
aberto | Dentro do prazo, ainda não enviada. |
atrasado | Passou de prazo_em e ainda não foi enviada. Continua podendo ser concluída. |
concluido | Enviada. Entra na fila de revisão. |
aprovado | Aceita. Não volta a ser editada. |
devolvido | Voltou para quem executou, com comentário. |
Não há duas execuções da mesma tarefa, versão, local e período no modo por cargo. No modo por pessoa, a unicidade é tarefa, versão, pessoa e período.
Resposta e evidência
checklist_resposta é uma linha por atividade da execução.
| Campo | Uso |
|---|---|
texto | Sim, não ou o texto livre. |
numero | Temperatura. |
evidencia | Chave do arquivo na rede. |
conforme | Na temperatura, verdadeiro quando o número está na faixa. Fora da faixa não impede a conclusão. |
refazer | A revisão marcou a atividade para correção. Concluir de novo zera a marca. |
checklist_evidencia registra a foto antes do upload: execução, atividade, chave única, autor e local. A chave pertence à rede. O arquivo fica num bucket privado; a API entrega URL assinada para gravar e para ler.
Auditoria da troca de responsável
Assumir, devolver ao cargo, trocar perfil e desativar gravam em auditoria. A revisão lê assumir e devolver_cargo da execução, e trocar_cargo ou desativar da pessoa, para montar a linha do tempo. Respostas e evidências permanecem quando a execução volta ao cargo. Execução concluída ou aprovada continua com quem fez.