Skip to main content
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.