Fiscalizador de Lives

Visão geral

O Fiscalizador de Lives processa transmissões em vídeo de sessões legislativas municipais e estaduais para transformá-las em bases de texto indexáveis e pesquisáveis. A ferramenta pode operar de forma autônoma monitorando canais cadastrados ou receber arquivos de vídeo específicos via linha de comando e interface textual.

A ferramenta automatiza o fluxo de captura, particionamento de áudio, transcrição fonética e extração de entidades. As saídas estruturadas apoiam analistas e auditores na triagem rápida de temas como votações nominais, projetos de lei, menções a contratos públicos e pedidos de abertura de crédito.

Pipeline de processamento

O fluxo de processamento é executado em cinco etapas coordenadas:

1. Ingestão de vídeo. O yt-dlp realiza o download do fluxo de áudio ou vídeo da transmissão indicada.
2. Segmentação de áudio. O FFmpeg extrai faixas sonoras, normaliza taxas de amostragem e divide o áudio em blocos temporais balanceados para atender aos limites de processamento da API.
3. Transcrição fonética. Modelos Whisper processam os blocos de áudio e consolidam a transcrição completa com marcação temporal de início e fim por segmento.
4. Extração e síntese estruturada. Modelos de linguagem processam os blocos transcritos para gerar resumos executivos, identificar oradores e catalogar menções a empenhos, licitações e votações.
5. Geração de relatórios. O sistema consolida as informações em documentos versionáveis em Markdown e arquivos para distribuição em PDF.

O pipeline possui controle granular de execução por bloco. Caso ocorra uma falha de conexão durante a transcrição de um trecho específico, o sistema reprocessa apenas o segmento pendente com políticas de exponential backoff, preservando os dados já convertidos.

Interfaces e saídas operacionais

O estado de cada processamento evolui por fases explícitas: aguardando, transferindo, transcrevendo, sintetizando e concluído.

• Interface de linha de comando (CLI). Permite a execução em lote a partir de arquivos descritores YAML e agendamentos cron.
• Interface textual em terminal (TUI). Construída com a biblioteca Textual, exibe em tempo real o progresso de cada etapa, buffers de memória, logs do sistema e caminhos dos arquivos gerados.
• Relatório analítico. Apresenta metadados da sessão (data, duração, órgão), síntese geral da pauta, trechos transcritos com carimbo de tempo (timestamp) e tabela de termos de interesse para conferência direta na gravação original.

Tratamento de ruído e precisão acústica

Gravações de sessões plenárias apresentam variações de captação sonora, sobreposição de vozes e reverberação em plenário. Para assegurar a fidelidade da análise, os relatórios preservam referências temporais exatas que permitem ao revisor reproduzir o trecho do áudio e validar a transcrição antes de consolidar qualquer apontamento técnico.