Pular para o conteúdo principal

Modelo de dados

ReferênciaParaQuem integra ou mantémLeitura5 min

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.

StatusSignificado
rascunhoAinda não gera execução.
publicadoA última versão publicada entra na geração.
arquivadoNã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:

TipoO que guardaRegra
sim_naotexto sim ou naoSem faixa e sem unidade.
temperaturanumeroExige faixa_min, faixa_max e unidade. A mínima não passa da máxima.
fotoevidenciaA foto é a resposta.
textotextoSem 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:

ModoPreencheNão preenche
cargo_localcargo e local_idpessoa e origem_id
pessoapessoacargo, local_id e origem_id
excecaopessoa e origem_idcargo 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.

CampoUso
versao_idVersão publicada no momento em que a execução nasceu. Não muda.
modocargo_local ou pessoa.
local_idLoja ou CD, no modo por cargo. Nulo no modo por pessoa.
usuarioQuem assumiu. Nulo enquanto a execução por cargo não tem dono.
cargo / pessoaO destino da atribuição que gerou a execução.
periodoO dia, no fuso da rede. Na recorrência única, a data marcada.
limite_emHora em que a execução abre.
prazo_emlimite_em mais prazo_minutos. Depois disso, aberto vira atrasado.
concluida_emQuando foi enviada para revisão.
revisao_comentario, revisado_por, revisado_emA devolução. Aprovar limpa o comentário.

Status da execução:

StatusSignificado
abertoDentro do prazo, ainda não enviada.
atrasadoPassou de prazo_em e ainda não foi enviada. Continua podendo ser concluída.
concluidoEnviada. Entra na fila de revisão.
aprovadoAceita. Não volta a ser editada.
devolvidoVoltou 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.

CampoUso
textoSim, não ou o texto livre.
numeroTemperatura.
evidenciaChave do arquivo na rede.
conformeNa temperatura, verdadeiro quando o número está na faixa. Fora da faixa não impede a conclusão.
refazerA 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.