Esse projeto foi desenvolvido como parte das Atividades Práticas Supervisionadas (APS) do curso de Ciência da Computação (CC) da Universidade Paulista (UNIP), visando criar uma solução web robusta e de alta segurança integrada com Autenticação Multifator (2FA) e Validade Temporal da Biometria (TTL) para o controle de acesso estratégico aos dados ambientais do Ministério do Meio Ambiente.
Nesse sentido, o SIMBA (Sistema Inteligente de Mapeamento Biométrico e Autenticação) opera como guardião do banco de dados geoespacial NALA (Núcleo de Armazenamento e Localização Ambiental), permitindo o monitoramento em tempo real de propriedades rurais registradas no CAR, cruzamento de vulnerabilidade de bacias hidrográficas (lençóis freáticos, aquíferos, rios e mares) e fiscalização ministerial sobre o uso de agrotóxicos proibidos no Brasil.
Note
🎯 Objetivo: Garantir a soberania, integridade e sigilo das informações de inteligência ambiental do Estado brasileiro através da exigência obrigatória de credenciais seguras e reconhecimento facial por visão computacional (OpenCV), associado a um controle de acesso baseado em papéis (RBAC) com expiração progressiva por nível hierárquico.
A autenticação no SIMBA segue uma arquitetura em duas etapas estritamente sequenciais, onde o sucesso do primeiro fator não concede acesso aos dados, servindo apenas para autorizar o escaneamento biométrico:
%%{init: {
'themeVariables': {
'noteBkgColor': '#77BC31',
'noteBorderColor': '#65a128',
'noteTextColor': '#071004'
}
}}%%
sequenceDiagram
autonumber
actor U as Usuário
participant W as Frontend Web
participant A as Backend API
participant CV as OpenCV
participant DB as Banco NALA
Note over U,DB: 1º Fator — Credenciais
U->>W: Login e Senha
W->>A: POST /api/auth/login
A->>DB: Valida hash BCrypt
DB-->>A: Credenciais válidas
A-->>W: Sessão PENDING_2FA
Note over U,DB: 2º Fator — Biometria Facial
U->>W: Captura frame da webcam
W->>A: POST /api/auth/verify-biometria
A->>CV: Processa e compara face
CV-->>A: Face compatível
A-->>W: Sessão FULL_AUTH (TTL Ativo)
Note over U,DB: Acesso ao Painel NALA
W->>A: GET /api/nala/painel
A->>DB: Consulta dados do Nível
DB-->>A: Dados NALA
A-->>W: Renderiza Dashboard
Note over U,DB: Expiração e Revalidação (TTL)
A-->>W: TTL expirado (Retorno a PENDING_2FA)
W-->>U: Solicita novo scan facial
U->>W: Novo frame da webcam
W->>A: POST /api/auth/verify-biometria
A-->>W: Acesso restabelecido
- Validação de
usernameepasswordutilizando criptografia adaptativa de via única com algoritmo BCrypt (BCryptPasswordEncoder). - Em caso de êxito, a sessão é colocada no estado intermediário
PENDING_2FA, liberando unicamente a interface de captura biométrica. Qualquer tentativa de requisição aos endpoints de dados do NALA é barrada com código HTTP401 Unauthorizedou403 Forbidden.
- Captura de quadros em tempo real via navegador do operador por meio da API
navigator.mediaDevices.getUserMedia(<video>+<canvas>). - O frame codificado em Base64 é transmitido via HTTP para processamento nativo em memória na JVM pelo OpenCV 4.9.0 (
Imgcodecs.imdecode). - O classificador em cascata Haar (
haarcascade_frontalface_default.xml) detecta e recorta a face, aplicando equalização de histograma e cálculo de similaridade contra a biometria de referência cadastrada no banco (usuarios.foto).
- A validação facial não é eterna: ela possui um prazo de expiração regressivo (
biometricExpiresAt) calculado conforme a criticidade do cargo do operador:- Nível 1 (Público / Analista): 30 minutos de validade.
- Nível 2 (Diretores de Divisões): 15 minutos de validade.
- Nível 3 (Ministro do Meio Ambiente): 5 minutos de validade.
- O painel exibe um cronômetro regressivo contínuo e alerta preventivo com barra de progresso aos 45 segundos restantes.
- Ao expirar o prazo, a sessão retorna automaticamente para
PENDING_2FA. O usuário não precisa digitar novamente seu login e senha: basta realizar um novo escaneamento facial de 1 segundo para renovar a autorização aos dados.
Tanto as rotas de backend (Spring Security) quanto os componentes do frontend Web adaptam seus dados dinamicamente de acordo com o nível hierárquico autenticado:
| Nível | Perfil Oficial (APS) | TTL Facial | Escopo de Visualização e Usabilidade no Sistema |
|---|---|---|---|
| 1 | Público / Analista Básico | 30 min | Visão Geral e Educativa: Catálogo de 50 agrotóxicos banidos (substancias_proibidas), justificativas de banimento e grau de risco hídrico. Listagem de recursos hídricos gerais (recursos_hidricos). Dados sobre proprietários, fazendas, autuações e coordenadas GPS exatas permanecem restritos. |
| 2 | Diretores de Divisões | 15 min | Visão Tática e Regional: Tudo do Nível 1 + consulta às propriedades rurais monitoradas no CAR (propriedades_rurais), áreas em hectares, municípios e cruzamento de vulnerabilidade hídrica. Nomes de proprietários autuados ficam sob sigilo ministerial. |
| 3 | Ministro do Meio Ambiente | 5 min | Visão Estratégica e Executiva Total: Tudo dos Níveis 1 e 2 + acesso irrestrito às autuações de fiscalização (autuacoes_fiscalizacao), nomes de proprietários infratores, volumes apreendidos em litros, valores nominais de multas, coordenadas GPS (WKT), dossiês e auditoria de operadores (usuarios). |
O painel foi completamente desenhado e otimizado para funcionar perfeitamente em telas de qualquer tamanho — desde monitores desktop widescreen até celulares compactos:
- Arrasto de Tabelas com o Mouse (Drag-to-Scroll no PC): Usuários de computador podem clicar em qualquer ponto livre da tabela e arrastar lateralmente como em planilhas modernas, sem depender da barra de rolagem horizontal.
- Deslize Fluido no Celular (Touch Scrolling): No smartphone, a navegação horizontal responde instantaneamente ao toque com aceleração nativa (
-webkit-overflow-scrolling: touch), sem travar o scroll vertical da página. - Dica Visual e Sombras de Overflow: Indicador
.table-scroll-hintvisível e sombras laterais dinâmicas que indicam se ainda há colunas ocultas à direita ou à esquerda. - Menu de Abas Deslizáveis no Mobile: Em telas menores que
860px, a barra lateral converte-se automaticamente em um carrossel horizontal de abas compactas, economizando espaço vertical e permitindo alternar de seção com um toque. - Células sem Compressão: Larguras mínimas individuais por tabela garantem que valores monetários, datas, status e coordenadas geográficas WKT permaneçam 100% legíveis.
O banco de dados do Ministério opera com PostgreSQL 16 e extensão espacial PostGIS 3.4, armazenando dados relacionais e feições vetoriais georreferenciadas (GEOMETRY(..., 4326)).
A carga inicial reproduzível é executada automaticamente pelo Spring Data JPA (NalaDataSeeder) na primeira inicialização:
substancias_proibidas: 50 compostos químicos ativos banidos (ex.: Paraquate, Endossulfam, Aldrin, Lindano, DDT) com toxicidade e grau de risco aquático.recursos_hidricos: 35 corpos d'água catalogados (Aquífero Guarani, Aquífero Alter do Chão, Bacia do Rio São Francisco, Bacia do Paraná, etc.) com geometrias geoespaciais.propriedades_rurais: 65 fazendas monitoradas com códigos CAR reais por UF (SP, MS, MT, BA, PR), áreas em hectares e polígonos delimitadores.autuacoes_fiscalizacao: 50 autuações ambientais com apreensão de agrotóxicos ilegais, processos sancionatórios, valores de multas em reais e coordenadas GPS de coleta.usuarios: mais de 30 operadores cadastrados nos 3 níveis de acesso com credenciais criptografadas e biometria facial de referência.
| Usuário | Senha Padrão | Nível | Cargo / Perfil |
|---|---|---|---|
analista |
simba123 |
1 | Analista Ambiental Público |
diretor |
simba123 |
2 | Diretora de Divisão de Recursos Hídricos |
ministro |
simba123 |
3 | Ministro do Meio Ambiente |
Antes de iniciar, certifique-se de possuir em seu ambiente:
- Docker (versão 24.x ou superior) e Docker Compose instalados.
- Git configurado para clonagem do repositório.
- (Opcional para desenvolvimento local) JDK 21 e Maven para execução direta sem containers.
- Navegador Web moderno (Chrome, Firefox, Safari ou Edge) com permissão de acesso à webcam.
git clone https://github.com/SepulvedaRafael/simba.git
cd simbaO projeto conta com comandos simplificados e padronizados no Makefile:
# Sobe todo o ambiente (Banco PostGIS + Aplicação Spring Boot) em segundo plano
make build
# Acompanha os logs da aplicação em tempo real
make logs
# Exibe o status de saúde dos containers e volumes
make status
# Para a execução preservando os dados persistidos no banco NALA
make down
# Reseta totalmente containers e volumes (recria o banco NALA do zero)
make reset🌐 Assim que os containers iniciarem, acesse o sistema pelo navegador em:
http://localhost:8081
Caso prefira utilizar os comandos nativos do Docker:
# Construir imagens e iniciar containers em segundo plano
docker compose up -d --build
# Visualizar logs em tempo real
docker compose logs -f simba-app
# Encerrar os serviços
docker compose downPara permitir testes de integração rápidos, avaliações em servidores sem webcam conectada ou homologação de regras de negócio sem necessidade de posicionar o rosto na câmera, o SIMBA possui um mecanismo de bypass configurável.
Important
O bypass de biometria não adiciona nenhum elemento gráfico, botão ou aviso na interface. Ele opera de forma transparente: ao validar usuário e senha, o 2º fator é aprovado automaticamente pelo backend e o operador é redirecionado direto para o painel de dados.
# Subir o ambiente com o bypass de biometria ativo:
make build BYPASS=true
# Ou recriar o ambiente limpo do zero com bypass:
make reset BYPASS=true# Basta executar o build normal (o padrão é BYPASS=false):
make build- Variável de Ambiente:
SIMBA_BIOMETRIA_BYPASS=true - Configuração no
application.yaml:simba: biometria: bypass: ${SIMBA_BIOMETRIA_BYPASS:false}
O projeto segue padrões de código com Java 21 LTS e Spring Boot 4.x, garantindo manutenibilidade e cobertura de testes:
| Ferramenta / Tecnologia | Finalidade |
|---|---|
| ☕ Java 21 LTS | Records imutáveis, pattern matching, guard clauses e performance |
| 🍃 Spring Boot 4.x | WebMVC, Spring Security, Spring Data JPA e Actuator |
| 👁️ OpenCV 4.9.0 | Haar Cascade Classifier para detecção facial e comparação de histogramas |
| 🐘 PostgreSQL + PostGIS | Persistência relacional e suporte nativo a dados espaciais (Geometry) |
| 🧪 JUnit 5 + MockMvc | Suíte de testes unitários e de integração com cobertura total de RBAC e 2FA |
| 🐳 Docker Multi-Stage | Empacotamento enxuto com eclipse-temurin:21-jre e bibliotecas nativas |
# Compilar o código e verificar tipos sem rodar testes
make compile
# ou: ./mvnw compile
# Executar a suíte completa de testes automatizados (40 testes JUnit 5)
make test
# ou: ./mvnw test
# Executar apenas uma classe específica de testes
./mvnw test -Dtest=SimbaApplicationTestssimba/
├── docker/
│ └── init-db/ # Scripts SQL de schema e extensão PostGIS
├── docs/
│ ├── SIMBA_black.svg # Identidade visual tema claro
│ └── SIMBA_white.svg # Identidade visual tema escuro
├── src/
│ ├── main/
│ │ ├── java/com/simba/simba/
│ │ │ ├── config/ # SecurityFilterChain, PostGIS e DataSeeder
│ │ │ ├── controller/ # Endpoints REST (Auth, Painel, Video)
│ │ │ ├── dto/ # Records imutáveis de entrada/saída (RBAC)
│ │ │ ├── model/ # Entidades JPA (NALA: CAR, Recursos, Infratores)
│ │ │ ├── repository/ # Interfaces Spring Data JPA + PostGIS
│ │ │ └── service/ # Regras 2FA, OpenCV, Biometria e TTL
│ │ └── resources/
│ │ ├── application.yaml # Configurações de ambiente, portas e TTL
│ │ ├── haarcascade_frontalface_default.xml # Modelo treinado Haar Cascade
│ │ └── static/
│ │ ├── index.html # Tela de Login 2FA e Captura Facial
│ │ ├── painel.html # Dashboard responsivo com abas e tabelas NALA
│ │ └── simba-logo.svg # Logo vetorial do Ministério
│ └── test/
│ ├── java/com/simba/simba/ # Suíte de testes JUnit 5 (RBAC, 2FA, Bypass)
│ └── resources/
│ └── application.yaml # Configuração com H2 em memória para testes
├── docker-compose.yml # Orquestração do PostgreSQL/PostGIS e da aplicação
├── Dockerfile # Build multi-stage otimizado com libs OpenCV
├── Makefile # Automação de comandos (build, reset, logs, test)
├── pom.xml # Gerenciamento de dependências Maven
└── README.md # Documentação oficial do projeto| Problema | Causa Provável | Solução Recomendada |
|---|---|---|
❌ Porta 8081 ou 5432 ocupada |
Outro processo local ou container está escutando na porta | Altere SERVER_PORT ou POSTGRES_PORT no docker-compose.yml ou finalize o processo com lsof -i :8081. |
| ❌ Câmera não inicia no navegador | Navegador bloqueou permissão de mídia ou contexto HTTP inseguro | Clique no ícone de cadeado na barra de endereços do navegador e permita o acesso à câmera para localhost:8081. |
| ❌ Biometria falhando em testes | Iluminação insuficiente ou ausência de dispositivo de vídeo | Utilize o modo de teste com bypass: make build BYPASS=true para autenticar diretamente via login e senha. |
| ❌ Banco NALA com dados dessincronizados | Volume antigo do PostgreSQL mantendo schema desatualizado | Execute make reset para derrubar containers, apagar volumes e recriar o schema e os seeds do zero. |
| ❌ Erro de compilação de bibliotecas OpenCV nativas | Falta de libglib2.0-0 ou libgomp1 no host |
Utilize o ambiente containerizado via Docker, onde todas as dependências nativas C/C++ já vêm pré-instaladas. |
- OpenCV (Open Source Computer Vision): Detecção facial via Haar Cascade Classifier e análise de histogramas espaciais.
- Spring Security 6/7: Arquitetura de filtros de autorização em duas fases (
PRE_AUTHeFULL_AUTH) com sessão segura. - PostGIS & Hibernate Spatial: Mapeamento de tipos
org.locationtech.jts.geom.Geometrye projeção cartográfica WGS84 (SRID 4326). - RFC 6238 & NIST SP 800-63B: Diretrizes de segurança digital para autenticação multifator e controle temporal de sessão (TTL).
Desenvolvido por: Júlia dos Santos Martins, Lucas Silva Machado, Lucas Alexsandre Aguiar Martins e Rafael Arley de Sousa Sepulveda
Instituição: UNIP – Universidade Paulista, Faculdade de Ciência da Computação
Ano: 2026 🦁🌿💧