A ronda virtual passa pelas câmeras de um local em cadência, avalia cada uma por
IA e registra o resultado. O relatório é o documento que sai disso, e é o que o seu
cliente compra.
Achar o que tem relatório
Sem since, a janela padrão é de 2 dias.
finished_at: null significa que a ronda ainda não acabou, há câmera
pendente. Nesse estado o relatório afirma menos do que a ronda vai apurar. Espere
cameras_pending: 0.
Pegar o relatório
ref é o identificador do evento. Use-o na rota do relatório:
A resposta tem quatro partes: source, header, items (a folha) e cameras.
A folha: oito perguntas
items é o checklist, na ordem, com number e question. Cada número é um
assunto fixo; o texto da pergunta é o do checklist da central, e ela pode
adaptá-lo:
Case pelo number, nunca pelo texto da pergunta. O número é o contrato — o
assunto do item 3 é sempre “canais sem imagem”. A redação é da central: ela pode
usar as palavras do checklist dela, e duas contas podem devolver frases
diferentes para o mesmo number.
Cada item traz um state, e os três são diferentes de propósito:
Nunca imprima not_measured como “Não”. “Não há câmera sem imagem” e “não
foi possível verificar” são afirmações diferentes, e a primeira você não pode
fazer. Um relatório que afirma o que não mediu é pior que um com linha em branco:
ele parece completo.
As câmeras
cameras traz uma linha por câmera da ronda:
Use situation_label, verdict_label e reason_label na folha: são as frases
escritas para o operador. Os campos crus são para a sua lógica.
header fecha a conta: cameras_total, cameras_with_frame,
cameras_without_frame (as que o gravador não entregou — é o que a pergunta 3
conta) e as não avaliadas.
A distinção entre “o gravador não entregou imagem” e “não avaliada” é o que
mantém a pergunta 3 honesta. Câmera sem medição não entra como canal sem
imagem: o relatório afirmaria um defeito no local que ele não verificou.
Virar PDF
Baixe as imagens no mesmo momento em que lê o relatório. Gerador de PDF que
embute o link em vez dos bytes produz documento que abre hoje e falha depois.
O relatório impresso
Se você gera o PDF pelo navegador, duas coisas sempre escapam:
- A moldura do seu sistema não vai para o papel. Barra, menu e cabeçalho
precisam sair no
@media print, senão o cliente recebe a sua navegação em cima
da folha.
- As imagens precisam estar carregadas antes de imprimir.
window.print()
disparado cedo produz retângulos vazios onde estavam as evidências.