Supervision Supervision
Abrir Supervision
Visão computacional · YOLO + ByteTrack

Analise o fluxo de pessoas em vídeo

Suba um vídeo, desenhe zonas e linhas, defina a cor do uniforme e a IA rastreia cada pessoa, gerando vídeo anotado, heatmap, contagem por zona, tempo de permanência e cobertura de trabalhadores.

Abrir Supervision Ver recursos
YOLO + ByteTrack
0
pessoas rastreadas
Dwell
0
tempo médio de permanência
Zonas & linhas
0
cruzamentos na linha de contagem
Heatmap · cobertura
0
cobertura de trabalhadores

Números de uma análise de demonstração, para ilustrar a leitura do painel. Não são resultado de cliente nem promessa de desempenho, o que sai de cada vídeo depende da cena, do enquadramento e das áreas que você marcar.

O problema

A câmera já está lá. Ninguém assiste.

Operação de varejo, posto, pátio ou chão de fábrica costuma ter gravação de sobra e nenhum dado. A imagem serve para tirar dúvida depois de um incidente e não responde a pergunta que decide escala, layout e meta.

Dor nº 1

Ninguém tem tempo de ver o vídeo

Uma hora de gravação leva uma hora para ser assistida, e o gestor precisa de dezenas delas. Na prática, a imagem só é aberta depois que o problema já aconteceu, o que a transforma em prova, nunca em indicador.

Dor nº 2

Contagem manual é cara e some

Contratar alguém para contar fluxo por amostragem custa caro, cobre poucas horas e produz um número que ninguém consegue reproduzir depois. Sensor de porta conta quem entra e não sabe onde a pessoa ficou.

Dor nº 3

"Fila grande" é opinião

Sem medir, a discussão sobre escala de caixa é entre memórias conflitantes. Com medida, ela vira comparação: um caixa passou 64,8% do tempo com fila e o outro 13,9%, dois números que fecham a conversa.

Dor nº 4

Área proibida sem testemunha

Entrada em zona de risco, doca de descarga ou área de tanques só é descoberta quando dá errado. O evento existia na gravação, faltava alguém olhando no momento certo.

Dor nº 5

Software de segurança resolve outra coisa

O que se vende no mercado é vigilância ao vivo, licenciada por câmera e instalada por integrador. O dono da operação não quer alarme de intruso: quer saber quanto tempo o cliente esperou e quantas cargas saíram da pilha A.

Dor nº 6

Números que ninguém consegue auditar

Um painel que devolve "37" sem mostrar o vídeo anotado é um número que não sobrevive à primeira contestação. Sem o quadro marcado, não há como conferir se a régua está certa.

O que a análise entrega

Recursos de ponta a ponta

Da detecção quadro a quadro ao relatório de fluxo, cada pessoa é detectada, rastreada por ID e medida por zona, linha e tempo de permanência.

Detecção + rastreio

O YOLO detecta cada pessoa e o ByteTrack mantém o mesmo ID quadro a quadro, mesmo com oclusões e cruzamentos na cena.

Zonas e linhas

Desenhe áreas e linhas de contagem diretamente sobre o primeiro frame do vídeo, cada entrada, saída e cruzamento é registrado.

Heatmap

Um mapa de calor de permanência revela os pontos quentes da cena: onde as pessoas mais se concentram e por quanto tempo.

Tempo de permanência

O dwell mede quanto tempo cada pessoa fica em cada zona, ideal para filas, atendimento e ocupação de áreas críticas.

Cobertura de trabalhadores

Classifica o trabalhador pela cor do uniforme e mede a cobertura, quanto tempo e quais zonas tiveram equipe presente.

Fluxo no tempo

Vídeo anotado somado a gráficos de fluxo e contagem ao longo do tempo, a leitura completa do movimento da cena.

Recursos em profundidade

O que cada medida significa, e o que a impede de mentir

Todos os indicadores saem do mesmo laço de detecção e rastreio. Nenhum deles pede uma inferência extra: numa máquina sem placa de vídeo, contabilidade sobre o laço que já roda é a diferença entre caber e não caber.

Detecção e rastreio

Cada pessoa vira um identificador que sobrevive à oclusão

O detector encontra as pessoas quadro a quadro e o rastreador amarra as detecções num mesmo identificador ao longo do tempo. É esse identificador que permite dizer "quarenta e duas pessoas distintas" em vez de somar detecções, e que permite medir permanência, porque só faz sentido cronometrar alguém que se sabe ser a mesma pessoa.

O que faz
Distingue quantas pessoas passaram de quantas estavam ao mesmo tempo, números diferentes que costumam ser confundidos.
Como faz
Detector de família YOLO em três perfis de qualidade, com rastreio por associação de caixas entre quadros consecutivos.
O que entrega
Total de indivíduos, pico simultâneo com o instante do pico, média de simultâneos e tempo médio em cena.
Zonas e linhas

Você desenha sobre o primeiro quadro e a geometria vira métrica

Áreas são polígonos livres; linhas de contagem são segmentos com sentido. Uma área pode ser marcada como de trabalho (balcão, posto de montagem) ou restrita, nesta, a primeira entrada já é evento, sem limiar. Um detalhe que parece pequeno decide a qualidade do número: a entrada e a saída da área usam limiares diferentes, porque com um limiar só a caixa que "respira" em torno de uma pessoa parada faz a ocupação piscar. Sem essa histerese, um único rastro chegou a registrar oito entradas.

O que faz
Conta entradas, saídas, ocupação e cruzamentos, por área e por linha, com o nome que você deu.
Como faz
Sobreposição da caixa com o polígono, com limiar de entrada maior que o de saída para não oscilar na borda.
O que entrega
Ocupação de pico, tempo ocupado, maior janela vazia e a lista de cruzamentos por linha.
Permanência e calor

Onde as pessoas ficam, e por quanto tempo

A permanência é o tempo que cada rastro passa dentro de cada área, a base de fila, atendimento e giro de mesa. O mapa de calor acumula presença sobre o quadro de fundo, mostrando os pontos quentes da cena mesmo onde você não marcou nada. Um complementa o outro: o calor sugere onde marcar, a permanência mede depois de marcado.

O que faz
Cronometra estadias por área e desenha a concentração espacial da cena inteira.
Como faz
Acumula presença por rastro e por posição; o calor é renderizado sobre um quadro real do vídeo.
O que entrega
Média, mediana e máximo por área, histograma de permanência e a imagem do mapa de calor.
Operação

Fila, atendimento e funil, as três perguntas de quem toca a operação

A fila mede a espera observada e, quando o tempo de vídeo permite, também a espera estimada pela relação clássica entre tamanho médio da fila e taxa de chegada; além disso registra a fração do tempo em que havia duas ou mais pessoas aguardando. O atendimento é uma máquina de estados entre cliente e funcionário dentro da área de trabalho, com tolerância de um segundo e meio a oclusão, sem ela, o rastreador perdendo um único quadro parte a sessão em duas e o tempo médio despenca. O funil responde quantos, dos que passaram pela área A, chegaram à área B.

O que faz
Traduz movimento em espera, tempo de atendimento e conversão entre áreas.
Como faz
Contabilidade sobre o rastreio já calculado. Nenhuma inferência adicional, inegociável em máquina sem GPU.
O que entrega
Espera média por área, vazão por hora, percentual de tempo com fila e taxa de passagem entre áreas.
Alertas

Cinco gatilhos, cada um com o instante em que aconteceu

Lotação por área, permanência longa numa área, aglomeração no total, área ociosa por tempo demais e entrada em área restrita. Existe ainda a permanência suspeita na cena inteira, que não depende de nenhuma área marcada, serve para perímetro, onde a diferença entre quem passa e quem ronda é o tempo. Cada alerta carrega o segundo em que ocorreu, e no painel isso vira um botão que leva o vídeo direto ao momento.

O que faz
Transforma limiar em ocorrência com hora, área e nível, alto, médio ou informativo.
Como faz
Todos os limiares são configuráveis e zero desliga. Há um conjunto sugerido por setor.
O que entrega
Lista de ocorrências clicáveis, sincronizada com o vídeo anotado.
Funcionário × cliente

Quem é equipe e quem é público, por cor de uniforme ou por IA

O caminho simples classifica pela cor do uniforme, com faixa de matiz e saturação ajustáveis. Ele falha quando a equipe não tem cor distinta, e falha em silêncio, o que é pior. Por isso existe o caminho por IA: o melhor recorte de cada pessoa é enviado a um modelo de visão que decide o papel, com justificativa e confiança. O sinal que mais discrimina não é o tempo em cena nem a área ocupada, e sim a rotatividade: quantas outras pessoas chegaram e foram embora enquanto aquela permanecia. Quem atende vê vários ciclos; quem é atendido, nenhum.

O que faz
Separa equipe de público e mede a cobertura de atendimento por área e por tempo.
Como faz
Duas passagens: a primeira rastreia e junta recortes, a segunda reescreve o vídeo já com os papéis decididos.
O que entrega
Tabela de pessoas identificadas com papel, confiança e motivo, mais os rótulos no vídeo anotado.
Pergunte ao vídeo

Uma pergunta em português, respondida a partir das métricas

A resposta é ancorada nos números que a análise já calculou, contagem, pico, filas, áreas, linhas e alertas, nunca em impressão sobre a imagem. Quando o modelo de linguagem não está disponível, um caminho determinístico casa a pergunta com a métrica certa por palavra-chave, de modo que a tela nunca trava. Quando a resposta tem um instante associado, o player pula para lá.

O que faz
Responde "quando foi o pico?" ou "qual caixa teve mais fila?" sem você caçar no painel.
Como faz
As métricas viram um resumo compacto de fatos; o modelo só pode responder com base nele.
O que entrega
Texto curto, a métrica de origem e, quando cabe, o segundo para onde pular no vídeo.
Modelos salvos

A configuração que você acertou vira preset com nome

Toda análise já guardava a sua configuração; o que faltava era poder nomear e recarregar. Um modelo salvo guarda o estado do editor, tipo de análise, qualidade, áreas, linhas, cor do uniforme e os cinco limiares de alerta, e reabre o mesmo vídeo com tudo no lugar. Ele nunca é sobrescrito: salvar cria outro, porque a versão anterior costuma ser a que funcionava.

O que faz
Repete a mesma leitura em outro dia sem redesenhar a cena.
Como faz
Guarda o estado do editor, não o pedido enviado, o recarregamento precisa da qualidade e da matiz crua.
O que entrega
Resultado reproduzível: recarregar e rodar devolveu números idênticos aos da análise original.
Perfis por setor

Um motor, vários vocabulários

O que muda de um segmento para outro não é o algoritmo, é o nome das coisas, quais alertas fazem sentido e quais métricas merecem destaque. Uma área é uma vaga no estacionamento, uma mesa no restaurante e um posto na fábrica. Cada perfil é um preset que já abre o editor configurado.

Perfis de análise disponíveis, o setor de cada um e as perguntas que respondem
PerfilSetor típicoO que responde
Análise livreGenéricoVocê configura do zero: contagem, permanência e mapa de calor.
Varejo e atendimentoLoja, supermercado, farmáciaFila e espera, tempo de atendimento, funcionário × cliente, horário de pico.
Restaurante e barAlimentação fora do larOcupação de mesas, giro, fila na entrada, pico de casa cheia.
EstacionamentoPátio, garagemOcupação de vagas, rotatividade, tempo médio parado, vaga ociosa.
Trânsito e viasRua, cruzamento, pedágioContagem por tipo de veículo, fluxo por sentido, leitura de placa, congestionamento.
Segurança e patrimônioPerímetro, vigilânciaIntrusão em área restrita, aglomeração, permanência suspeita na cena.
Indústria e segurança do trabalhoFábrica, obra, galpãoZona de perigo, ocupação de posto, permanência em área de risco, ociosidade.
Pátio de carregamentoMadeireira, serraria, depósitoCargas colocadas no caminhão, pilha de origem, evidência e confiança por carga.
PecuáriaPasto, curral, sobrevoo de droneTotal do lote e pico, com o quadro numerado para conferência.
Uso de celularConformidade, segurança do trabalhoQuem aparece com o aparelho na mão, com recorte de evidência por pessoa.
Os perfis de pecuária e de uso de celular seguem por um caminho próprio e não passam pelo editor de áreas, num pasto não há zona a marcar, e o resultado tem outra forma. Esse desvio é declarado no próprio catálogo de perfis, e não espalhado em exceções pelas telas.
Fluxo de trabalho

Como funciona

Do upload ao relatório em quatro passos, você configura a cena uma vez e a IA processa o vídeo inteiro.

1
Upload

Suba o vídeo

Envie o arquivo da câmera nos formatos mp4, mov, avi ou mkv. O primeiro frame é usado para você configurar a cena.

2
Configuração

Desenhe zonas e linhas

Trace as áreas de interesse e as linhas de contagem sobre o primeiro frame e defina a cor do uniforme dos trabalhadores.

3
Processamento

Rode a análise

O YOLO detecta e o ByteTrack rastreia cada pessoa quadro a quadro, mantendo os IDs e acumulando as métricas da cena.

4
Resultados

Veja os resultados

Receba o vídeo anotado, o heatmap, as contagens por zona e linha, o tempo de permanência e a cobertura de trabalhadores.

Como funciona por dentro

Um laço de detecção, e contabilidade em cima dele

A regra que organiza o sistema é simples: a inferência é o recurso caro, então ela roda uma vez e todo o resto é conta feita sobre o resultado dela. Métrica nova não pode custar mais uma passada no vídeo.

Backend
Serviço HTTP em Python com FastAPI, rodando como serviço do sistema em usuário próprio, atrás do nginx do domínio. O progresso da análise volta por fluxo contínuo de eventos.
Visão
Detector da família YOLO em três perfis, rápido, equilibrado e máximo, e a biblioteca supervision (Roboflow, licença MIT) para anotação e geometria. O perfil máximo usa recorte em ladrilhos, que enxerga objeto pequeno ao custo de bem mais tempo.
Rastreio
Associação de caixas entre quadros consecutivos, com janela de tolerância a sumiço declarada em segundos e convertida para quadros conforme a taxa do vídeo, copiar o número de quadros entre vídeos de taxas diferentes é copiar o número errado.
Banco
SQLite no próprio servidor, com vídeos, análises, modelos salvos, contagens, sessões ao vivo e eventos. A configuração de cada análise é gravada junto com o resultado, então o histórico é um registro de parâmetros, não só uma lista de arquivos.
Fila
Uma vaga única para trabalho pesado, compartilhada por todos os tipos de análise. Numa máquina de poucos núcleos e sem placa de vídeo, rodar dois trabalhos ao mesmo tempo não aumenta vazão: divide a mesma CPU. Quem chega além da vaga espera com posição visível, em vez de competir.
Vídeo
ffmpeg transcodifica a saída para H.264, para que o vídeo anotado toque direto no navegador. As respostas de vídeo aceitam requisição por faixa de bytes, o que é o que faz o "pular para o segundo X" realmente funcionar.
Frontend
Aplicação React compilada e servida como arquivos estáticos por um contêiner nginx. Gráficos em Recharts, linha do tempo navegável e a mesma cor para a mesma entidade em todos os gráficos.
Monitoramento ao vivo

Apontar para a câmera e contar enquanto o pátio trabalha

Além da análise de arquivo, existe o modo contínuo: uma fonte de rede (ou o subfluxo do gravador) é aberta e analisada enquanto a operação acontece. O que torna isso honesto é o que a tela faz quando não pode contar.

Câmera que gira

Todo o raciocínio acontece num quadro de referência

Uma câmera móvel destrói qualquer marcação feita à mão: a área que você desenhou sobre o pátio deixa de estar onde estava. A saída é levar cada detecção para um quadro de referência fixo, estimado a cada imagem. Assim o rastreador, as áreas e o monitoramento continuam vendo uma câmera parada, que é a única coisa que eles sabem tratar. As áreas marcadas ficam gravadas nessa referência e continuam certas depois de um giro.

O que faz
Mantém rótulo, área e contagem no lugar mesmo quando a câmera se move.
Como faz
Estimativa sempre numa cópia reduzida e a matriz reescalada: custo constante, qualquer que seja a resolução da câmera.
O que entrega
Marcação à mão aplicada a quente, sem reiniciar a sessão.
Quando a cena se perde

A contagem congela em vez de continuar somando errado

Três critérios independentes aprovam cada estimativa de referência, e o terceiro existe porque os dois primeiros são cegos para um caso real e medido: todos os indicadores estatísticos pareciam ótimos enquanto o erro verdadeiro era cinco vezes maior que o relatado. Reprovada a estimativa, a sessão segura a última boa por dois segundos e depois entra em cena perdida: nenhuma visita, nenhuma carga, nenhuma entrada de área. A tela toma uma tarja dizendo isso. Um contador que segue somando com o mapa errado não parece errado, só vira um número maior no fim do turno.

O que faz
Prefere não responder a responder errado.
Como faz
Além dos indicadores usuais, mede a continuidade: quanto os cantos do quadro saltaram em relação ao tempo decorrido.
O que entrega
Bloqueios escritos em português, cada um com a ação que o resolve.
Cadência declarada

"Ao vivo" aqui não é trinta quadros por segundo, e a tela diz o número

Sem placa de vídeo, cada detecção custa centenas de milissegundos. Em vez de fingir tempo real, a sessão detecta a cerca de duas vezes por segundo, ancora todo quadro exibido e declara a taxa real. Havendo análise de arquivo disputando a máquina, quem cede é a transmissão ao vivo: ela aumenta o intervalo entre detecções e avisa, em vez de os dois brigarem pela CPU.

O que faz
Mantém a transmissão de pé sem derrubar o resto do produto.
Como faz
Vaga própria na fila, teto de horas por sessão e limite de espectadores simultâneos.
O que entrega
Vídeo anotado no navegador, fita de eventos com evidência e a taxa de análise à vista.
Especificação

O que entra, e quanto tempo leva

Os tempos abaixo foram minerados de análises reais já executadas neste servidor, quatro núcleos virtuais, sem placa de vídeo. Servem de base para promessa: capacidade se calcula, não se estima.

Formatos e limites de entrada aceitos pela análise de vídeo
EntradaAceitoPor quê
Formatosmp4 · mov · avi · mkvOs contêineres que saem de gravador, celular e câmera de rede.
Tamanho do arquivoaté 500 MBProtege o disco. O envio é abortado durante a transferência, não depois.
Duraçãoaté 20 minProtege a CPU: vinte minutos no perfil equilibrado já ocupam a máquina por horas.
Resoluçãolado até 4096 pxTeto generoso de propósito: o quadro é reescalado antes da inferência, então 4K não custa proporcionalmente mais. Recusar 4K puniria quem filma com celular moderno.
Áreas e linhassem limite práticoPolígonos livres e segmentos com sentido, desenhados sobre um quadro real do vídeo.
Perfis de qualidade, custo por quadro medido e capacidade resultante
PerfilCusto por quadroVídeo processado por horaQuando usar
Rápida0,31 s~52 mintriagem Passar o olho em muito material e achar onde vale olhar direito.
Equilibrada~1,0 s~8 minpadrão A leitura de trabalho: é dela que saem os números que vão ao relatório.
Máxima5,54 smenos de 1 mincena difícil Objeto pequeno ou cena densa. Setenta e duas vezes o tempo real, não cabe em preço de tabela.
Cinco minutos de vídeo na qualidade padrão levam cerca de 38 minutos de relógio. E rodar dois trabalhos ao mesmo tempo piora o total: duas análises idênticas levaram 339 segundos sozinhas e 1.684 segundos disputando a CPU, cinco vezes mais lento. É exatamente por isso que existe uma vaga só.
O que você recebe

Cada número acompanhado da imagem que o sustenta

Nenhum indicador é entregue sozinho. O vídeo anotado existe para que qualquer número possa ser conferido quadro a quadro, é o que faz a medida sobreviver à primeira contestação.

Vídeo anotado

O vídeo original com caixas, identificadores, áreas, linhas e rótulos desenhados, transcodificado para tocar direto no navegador.

MP4 · H.264

Mapa de calor

Imagem da concentração de presença acumulada, sobreposta a um quadro real da cena.

Imagem

Painel de fluxo

Total de indivíduos, pico simultâneo com o instante, média, tempo médio em cena e a série de ocupação ao longo do vídeo.

Tela · JSON

Por área e por linha

Ocupação de pico, tempo ocupado, maior janela vazia, número de estadias, média, mediana e máximo de permanência, e cruzamentos por linha.

Tela · JSON

Painel de operação

Fila por área com espera medida e estimada, tempo de atendimento, vazão por hora e taxa de passagem entre áreas.

Tela · JSON

Alertas com instante

Lista de ocorrências por nível, cada uma com o segundo em que aconteceu e um botão que leva o vídeo ao momento.

Tela

Pessoas identificadas

Quando a separação entre equipe e público está ligada: tabela com papel, confiança e o motivo da decisão, pessoa por pessoa.

Tela

Histórico filtrável

Todas as análises com busca por nome, tipo, situação e período, com o estado do filtro na URL, sobrevive ao recarregar e pode ser compartilhado como link.

Tela · link

Não há, hoje, geração de relatório em PDF nem exportação em planilha. Os números saem na tela e no JSON da análise; quem precisa de documento imprime a página. Está mapeado como próximo passo, mas não é promessa desta versão.

Para quem é

O comprador é o dono da operação, não o chefe da segurança

Ferramenta de vigilância responde "quem entrou onde não devia". Esta responde "quanto tempo o cliente esperou, quantas cargas saíram da pilha A e a que horas o pátio parou".

Varejo

Dimensionar caixa e turno com número

Fluxo por faixa de horário, tempo de espera por caixa e cobertura de atendimento. A conversa sobre escala deixa de ser entre memórias e passa a ser entre duas medidas do mesmo dia.

Posto e conveniência

Tempo de abastecimento por bomba

Cada bomba vira uma área: a permanência ali é o tempo de abastecimento, e a maior janela vazia é a ociosidade. Com a leitura de placa ligada, o pátio também vira contagem de veículos por tipo.

Indústria

Área de risco e ocupação de posto

Zona perigosa marcada como restrita dispara na primeira entrada. Postos de trabalho viram áreas comuns, e a ociosidade de cada um aparece como janela sem ninguém.

Pátio e logística

Contar carga e creditar à pilha certa

Duas evidências independentes sustentam cada carga: o trajeto da pilha ao caminhão e a mudança permanente no estrado. Aparência de garfo carregado nunca decide sozinha, as faixas medidas se sobrepõem.

Restaurante

Giro de mesa e fila na porta

Cada mesa é uma área; o tempo em cada uma é o giro. A fila na entrada sai da mesma medida de permanência, sem instrumentação nenhuma no salão.

Pecuária

Conferir o lote pelo vídeo do drone

Contagem por sobrevoo, com vídeo rastreado e quadro numerado para conferência a olho. O total é entregue como faixa, e o pico é declarado como piso, o drone varre o pasto em faixas.

Integrações e dados

O que se conecta, e onde as coisas ficam

Arquivo de vídeo

Envio direto pelo navegador, com o nome do arquivo gerado no servidor, o nome original fica só como rótulo, o que fecha a porta de travessia de caminho.

Câmera de rede

Fonte RTSP ou o subfluxo do gravador para o modo ao vivo. O subfluxo é a fonte preferida: o detector reescala de qualquer jeito, então o fluxo principal gasta decodificação sem entregar informação útil.

Modelo de visão externo

Usado apenas em três pontos opcionais: papel de cada pessoa, marca/modelo/placa de veículo e a resposta em linguagem natural. Sem chave configurada, os três degradam com aviso, a análise não quebra.

Banco local

Tudo em SQLite no próprio servidor: vídeos, análises, configurações, modelos salvos, sessões ao vivo e eventos. Não há dependência de serviço externo para o produto funcionar.

Biblioteca de exemplos

Uma pasta de clipes de demonstração no servidor, com miniatura gerada na hora. Serve para provar o produto sem que o cliente precise mandar a filmagem dele na primeira conversa.

Saídas em arquivo

O vídeo anotado e o mapa de calor ficam em disco, servidos por rotas autenticadas que aceitam requisição por faixa de bytes, é isso que faz o "pular para o segundo X" funcionar de verdade.

Segurança e privacidade

O que já está fechado, e o que ainda não está

O que a plataforma já fecha por construção, e o que cada operação ainda precisa resolver no projeto.

Tudo atrás de login

A exigência de sessão é aplicada na inclusão dos roteadores, não rota a rota, rota nova nasce protegida. Só a porta de autenticação e a verificação de saúde ficam públicas.

Sessão revogável

A sessão é opaca e vive numa tabela: apagar a linha encerra o acesso na hora. O cookie é httpOnly, com caminho próprio, escolha deliberada, porque as marcações de vídeo e imagem não enviam cabeçalho de autorização.

Freio de força bruta

Há janela deslizante por IP e por conta alvo, sem o alvo na chave, um atacante com muitos endereços atacaria a mesma conta sem nunca bater no limite.

Documentação da API fechada

As páginas interativas de documentação e o esquema aberto ficam desligadas em produção, para não servirem de mapa a quem visita o domínio.

Serviço sem privilégio de administrador

O processo roda em usuário próprio do sistema, e não como superusuário. Uma falha no processamento de vídeo deixa de ser uma falha na máquina inteira.

Sem reconhecimento facial

O produto detecta e conta corpos, mede permanência e trajeto. Não extrai características do rosto nem cria assinatura biométrica de ninguém, e essa é uma decisão de escopo, não uma limitação técnica a ser removida depois.

Um ponto de honestidade sobre proteção de dados: imagem de pessoa identificável é dado pessoal. Antes de operar com gravação real de cliente, o tratamento precisa de base legal declarada, aviso de privacidade, contrato de tratamento com quem opera e prazo de expurgo. O envio de recortes a um modelo de visão externo é transferência internacional de dados, o que exige cláusulas próprias. Nada disso é conformidade que se anuncia numa página de produto; é trabalho de projeto que precisa ser feito para cada operação.

Limites e o que ainda não faz

Onde a régua ainda não é confiável

Medição só vale se disser onde erra. O que segue foi encontrado medindo, e está escrito aqui para não ser descoberto dentro de um contrato.

Cobertura de atendimento nem sempre é medível

Ela mede "cliente dentro da área de trabalho com funcionário presente". Num caixa em que o cliente fica do lado de fora do balcão, o denominador é zero. Nesse caso o valor volta como não medida, em vez de zero por cento, que acusaria a equipe de não atender ninguém.

O funil ignora a ordem da visita

A conversão entre duas áreas é calculada sobre o conjunto de áreas visitadas por cada rastro, sem preservar a sequência. Na prática, alguém que foi de B para A é contado como conversão de A para B. Serve para ver proporção, não para provar sentido.

Permanência longa usa tempo total

O alerta de permanência soma o tempo dentro da área ao longo do vídeo, não a maior estadia contínua. Quem entra e sai várias vezes pode disparar o alerta sem nunca ter ficado parado, a leitura correta é "esteve muito tempo ali", não "ficou muito tempo de uma vez".

Permanência suspeita é janela, não presença

O indicador de ronda de perímetro mede a distância entre o primeiro e o último quadro em que a pessoa apareceu. Se ela sair de cena e voltar, a janela conta o intervalo inteiro. É um bom sinal de triagem e um mau número para relatório.

Contagem de rebanho entrega faixa, não exatidão

Nenhum modelo pré-treinado reconhece gado visto a prumo, e a solução usada aqui é por contraste de cor, com três travas que fazem o sistema recusar em vez de inventar. O pico é declarado como piso do rebanho: o drone varre o pasto em faixas, então o total real é maior que o que cabe num quadro.

No pátio, carga pode sair sem pilha de origem

Quando o rastro do carregador se parte entre a pilha e o caminhão, a ligação com a origem se perde. Há um resgate por proximidade no tempo, que marca a origem como inferida e rebaixa a confiança; quando nem ele alcança, a carga sai sem origem. Número certo com pilha errada é pior que número certo sem pilha.

Qualidade máxima não cabe em rotina

O perfil máximo roda a setenta e duas vezes o tempo real. Ele existe para cena difícil pontual, não para operação diária, e o próprio recorte em ladrilhos pode contar duas vezes o objeto cortado na emenda, em cena muito densa.

Sem relatório em PDF e sem exportação em planilha

Os números aparecem na tela e no JSON da análise. Documento formatado, envio automático por mensagem e organização por unidade e por câmera estão mapeados, e nenhum deles existe hoje.

Uma vaga de processamento

A máquina atual processa um trabalho pesado por vez, mais uma transmissão ao vivo. Quem chega depois espera na fila, com posição visível. Isso é escolha consciente: paralelizar aqui não aumenta vazão, só divide a mesma CPU.

Perguntas frequentes

O que perguntam antes de subir o primeiro vídeo

Preciso trocar as câmeras?

Não. A análise trabalha sobre o arquivo que o seu gravador já produz, nos formatos mp4, mov, avi e mkv. Enquadramento importa mais que resolução: uma câmera bem posicionada em 720p rende mais que uma câmera em 4K apontada para o teto.

Quanto tempo leva para analisar um vídeo?

Na qualidade padrão, cerca de 7,5 minutos de processamento para cada minuto de vídeo, cinco minutos de gravação levam cerca de 38 minutos. Na qualidade rápida a máquina processa perto de 52 minutos de vídeo por hora. Os números são medidos neste servidor, sem placa de vídeo; com hardware dedicado a conta muda inteira.

Ele reconhece rosto ou identifica quem é a pessoa?

Não. O sistema detecta corpos, mantém um identificador temporário enquanto a pessoa está em cena e mede onde ela esteve e por quanto tempo. Esse identificador não atravessa vídeos nem câmeras. Não há extração de características faciais nem assinatura biométrica.

Posso usar isso com dados reais de cliente hoje?

Tecnicamente sim; juridicamente depende de trabalho que não é de software. Imagem de pessoa identificável é dado pessoal: é preciso base legal declarada, aviso de privacidade no local, contrato de tratamento e prazo de expurgo, que o produto ainda não automatiza. Além disso, a classificação por IA envia recortes a um provedor fora do país, o que exige cláusulas próprias de transferência.

O que acontece se eu não configurar chave de IA?

A análise principal roda igual: detecção, rastreio, áreas, linhas, permanência, calor, fila, atendimento, funil e alertas não dependem de serviço externo. Perdem-se três coisas opcionais: a classificação de papel por IA (que cai na heurística de cor de uniforme), a leitura de marca, modelo e placa, e a resposta em linguagem natural, esta última cai num caminho determinístico por palavra-chave.

Por que dois vídeos parecidos dão números diferentes?

Porque o resultado depende do perfil de qualidade, do passo entre quadros e das áreas que você marcou, e tudo isso é gravado junto com a análise. O histórico é, na prática, um registro de varredura de parâmetros: o mesmo arquivo aparece várias vezes com configurações diferentes, e é a configuração que explica a diferença.

Dá para monitorar uma câmera ao vivo?

Dá, com uma fonte de rede. Duas ressalvas honestas: a taxa de análise fica em torno de duas por segundo e é declarada na tela em vez de mascarada, e quando a ancoragem da cena falha o sistema congela a contagem e avisa, em vez de continuar somando com o mapa errado.

Consigo exportar o relatório?

Hoje você recebe o vídeo anotado, a imagem do mapa de calor e as métricas em JSON, além de tudo na tela. Relatório em PDF com marca e exportação em planilha estão mapeados como próximos passos e não existem nesta versão.

Quantos vídeos posso analisar ao mesmo tempo?

Um por vez, mais uma transmissão ao vivo. O motivo é medido: numa máquina de quatro núcleos sem placa de vídeo, dois trabalhos simultâneos mediram cinco vezes mais lento no total. Quem chega depois entra numa fila com posição visível, em vez de aparecer como "processando" sem ter começado.

Glossário

As palavras que aparecem no painel

Detecção
Encontrar objetos de interesse em um quadro isolado. Devolve uma caixa e uma classe (pessoa, carro, caminhão) com um grau de confiança.
Rastreio
Amarrar as detecções de quadros sucessivos numa mesma identidade. É o que transforma "duzentas detecções" em "quarenta pessoas".
ByteTrack
O método de rastreio usado aqui. Sua ideia central é aproveitar também as detecções de baixa confiança para não perder quem está parcialmente escondido.
Identificador (id)
O número temporário dado a cada pessoa ou veículo enquanto ele está em cena. Não é identificação de pessoa: some quando o rastro acaba e não atravessa vídeos.
Zona ou área
Polígono desenhado sobre o quadro. Pode ser comum, de trabalho (onde a equipe atua) ou restrita (onde a primeira entrada já é um evento).
Linha de contagem
Segmento com sentido. Conta quem cruza, separando entrada de saída, sem precisar de área desenhada.
Dwell (permanência)
O tempo que uma pessoa passa dentro de uma área. É a base de fila, tempo de atendimento e giro de mesa.
Heatmap (mapa de calor)
Imagem que acumula presença ao longo do vídeo. Mostra onde as pessoas se concentram mesmo em pontos que você não marcou.
Histerese
Usar limiares diferentes para entrar e sair de uma área. Sem ela, a caixa que oscila em torno de alguém parado faz a ocupação piscar e infla a contagem de entradas.
Oclusão
Quando algo passa na frente e esconde a pessoa rastreada. Uma tolerância declarada em segundos evita que o rastro se parta e o tempo de atendimento despenque.
Cobertura de atendimento
A fração do tempo em que havia cliente na área de trabalho com funcionário presente. Volta como "não medida" quando a área desenhada não inclui o lado do cliente.
Funil
De quem passou pela área A, quantos chegaram à área B. Mede proporção entre áreas; não prova a ordem da visita.
Ancoragem
No modo ao vivo, levar cada detecção para um quadro de referência fixo, de modo que uma câmera que gira continue sendo tratada como parada.
Cena perdida
O estado em que a ancoragem foi reprovada e toda contagem congela, com tarja na tela. É a alternativa deliberada a continuar somando com o mapa errado.
Perfil de qualidade
A escolha entre rápida, equilibrada e máxima. Ele decide o modelo, a resolução de inferência e o passo entre quadros, e, portanto, o tempo de processamento.

Transforme vídeo em fluxo de pessoas

Suba um vídeo, marque as zonas e a cor do uniforme, e receba o rastreamento completo: heatmap, contagens, dwell e cobertura.

Abrir Supervision Ver recursos