Sistema
de Selos
Veiculares.
Aplicação em Python e Django para organizar cadastros, veículos, emissão de selos com QR Code e consultas operacionais, com módulos de ocorrências e revisão de leituras de placas.
Este estudo de caso descreve a versão pública sanitizada. Não expõe dados institucionais, credenciais nem infraestrutura interna.
testes automatizados aprovados na validação documentada
rotas verificadas no navegador Chromium
capturas de tela revisadas com dados fictícios
Fonte: relatório de validação da versão pública. Esses números não representam métricas da operação institucional.
O problema
Rotinas de identificação veicular envolvem cadastros, vínculos entre pessoas e veículos, validade de selos, consultas e registro de ocorrências. Quando essas informações não estão integradas, a conferência operacional se torna mais trabalhosa e sujeita a inconsistências.
A proposta foi consolidar o fluxo em uma aplicação web, preservando histórico, regras de validação e controle de acesso. O problema e a solução são descritos aqui de forma genérica para proteger o contexto original.
Minha contribuição
Desenvolvimento
Trabalho na evolução de funcionalidades em Python e Django, incluindo fluxos de cadastro, consulta, emissão de selos, relatórios e componentes de apoio à identificação de veículos.
Operação e implantação
Atuação na preparação e migração do sistema para Linux, na configuração de serviços de aplicação e coleta, e na verificação de funcionamento e persistência de dados.
A demonstração pública é um projeto sanitizado e independente; seus testes documentados não certificam o ambiente original nem uma implantação de produção.
Como funciona
- Gestão de pessoas, veículos e vínculos de propriedade.
- Importação de dados com prévia e validações.
- Geração de selo em PDF e QR Code para consulta autenticada.
- Controle de validade e situação dos registros.
- Histórico de ocorrências e movimentações.
- Revisão manual de leituras LPR e regras de correção.
- Perfis de acesso e proteção de documentos e mídia.
- Adaptador opcional Hikvision ISAPI, desativado na demonstração.
Decisões técnicas
QR não é permissão
O QR Code identifica a consulta, mas não libera os dados automaticamente. A visualização exige sessão autenticada e respeita perfis de operador.
Leitura ambígua pede revisão
O módulo LPR preserva a leitura original. Quando há mais de um veículo possível, o sistema direciona à revisão em vez de escolher arbitrariamente.
Dados fora do Git
Banco, mídia, anexos, backups e variáveis privadas não fazem parte da versão pública. Os exemplos e as imagens de demonstração usam dados sintéticos.
Validação reproduzível
A edição pública inclui verificações Django, checagem de migrações e testes automatizados no fluxo de CI, além de roteiro para execução local.
O que é verificável
O repositório fornece código, instruções de execução, testes, capturas com registros artificiais e um documento com o escopo da validação.
Limites e próximos passos
O que foi validado: a versão pública em Windows, com Python 3.12, Django 5.2 e Chromium; verificação de rotas, testes automatizados e geração de PDFs.
O que não foi validado nessa edição pública: câmera Hikvision física, leitor de câmera de celular em aparelho real, systemd na instalação Linux nativa e impressão em equipamento físico.
Por que isso importa: a demonstração não deve ser confundida com uma certificação de produção. Não apresento ganhos de tempo, redução de custo ou escala de utilização sem métricas públicas verificáveis.
O que o projeto demonstra
Este trabalho combina modelagem de fluxos operacionais, desenvolvimento web, controle de acesso, tratamento de dados, integrações opcionais e preocupações de implantação. O diferencial não é apenas gerar um QR Code: é estruturar um processo consultável, auditável e reproduzível em uma demonstração pública que respeita a privacidade dos dados.