Skip to content
SepulvedaRafaelPublic

About

This project was developed as part of the Supervised Practical Activities (APS) of the Computer Science (CC) course at Universidade Paulista (UNIP), aiming to create a robust and high-security web solution integrated with Multifactor Authentication (2FA) and Temporal Validity of Biometrics (TTL) for the control of strategic access to environmental.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

SIMBA Logo SIMBA Logo

Java 21 Spring Boot OpenCV PostgreSQL PostGIS Docker Maven

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.


🔐 Autenticação Multifator (2FA) e Validade Temporal (TTL)

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
Loading

1. 1º Fator — Credenciamento Seguro

  • Validação de username e password utilizando 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 HTTP 401 Unauthorized ou 403 Forbidden.

2. 2º Fator — Biometria Facial em Tempo Real

  • 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).

3. Validade Temporal da Biometria (Biometric TTL & Step-up Re-validation)

  • 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.

👥 Matriz de Autorização e Usabilidade por Nível (nivel_acesso)

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).

📱 Responsividade Total (PC & Celular)

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-hint visí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.

🗄️ Banco de Dados — NALA (Núcleo de Armazenamento e Localização Ambiental)

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.

Contas Pré-Cadastradas para Avaliação Rápida

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

💻 Pré-requisitos

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.

🚀 Como Executar o Projeto

1. Clonando o Repositório

git clone https://github.com/SepulvedaRafael/simba.git
cd simba

2. Execução via Makefile (Recomendado)

O 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

3. Execução Direta via Docker Compose

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 down

🧪 Modo de Testes e Bypass Biométrico (BYPASS=true)

Para 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.

Como ativar o Bypass no Docker:

# 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

Como retornar ao Modo Padrão (Biometria Obrigatória):

# Basta executar o build normal (o padrão é BYPASS=false):
make build

Configuração via application.yaml ou Variável de Ambiente:

  • Variável de Ambiente: SIMBA_BIOMETRIA_BYPASS=true
  • Configuração no application.yaml:
    simba:
      biometria:
        bypass: ${SIMBA_BIOMETRIA_BYPASS:false}

🛠️ Ferramentas de Qualidade e Comandos Úteis

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

Executando Compilação e Testes Automatizados

# 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=SimbaApplicationTests

📦 Estrutura do Projeto

simba/
├── 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

🚨 Solução de Problemas Comuns

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.

📚 Referências Técnicas

  • 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_AUTH e FULL_AUTH) com sessão segura.
  • PostGIS & Hibernate Spatial: Mapeamento de tipos org.locationtech.jts.geom.Geometry e 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 🦁🌿💧

About

This project was developed as part of the Supervised Practical Activities (APS) of the Computer Science (CC) course at Universidade Paulista (UNIP), aiming to create a robust and high-security web solution integrated with Multifactor Authentication (2FA) and Temporal Validity of Biometrics (TTL) for the control of strategic access to environmental.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages