Documentação do Módulo de Carga Externa

Serviço responsável por receber lotes de Alvos para a fiscalização de Reconhecimento Facial (RF), persistindo os dados de voo e alvos e acionando o reconhecimento facial do eDBV para o Neoface.

Página Pública Form Login + HTTP Basic Java/Spring

1. Visão Geral

O módulo eDBV Carga Externa RF foi projetado para facilitar a inclusão de alvos tanto manualmente através de uma interface web dinâmica quanto de forma automatizada por integrações via API REST.

🌐 Envio Web de Alvos

Permite o preenchimento de múltiplos alvos com suporte ao envio da foto do passaporte convertida automaticamente em Base64.

⚡ API REST Integrada

Endpoint JSON preparado para receber listas de alvos em lote com resposta imediata e autenticação via HTTP Basic.

🔒 Segurança Flexível

Autenticação protegida por Spring Security com controle centralizado configurável via ambiente.

💻 Ambientes

O sistema de carga externa está disponível em apenas em Homologação.

2. Autenticação & Segurança

A aplicação está protegida pelo Spring Security. O acesso às rotas do sistema é diferenciado conforme o tipo de cliente:

Recurso	Mecanismo	Acesso Público
Página Inicial (`/`)	Livre / Desautenticado	Sim
Swagger UI (`/api`)	Livre / Desautenticado	Sim
Formulário Web (`/alvos/novo`)	Form Login (Sessão / Cookies)	Não
API REST (`/api/alvos`)	HTTP Basic Auth (Header Authorization)	Não

Nota Importante sobre Credenciais:
Os dados reais de autenticação (usuário e senha) para uso nos ambientes de homologação serão informados oportunamente pela equipe eDBV.

3. Envio via Interface Web

A interface web está disponível no caminho /alvos/novo e permite enviar um lote contendo um ou mais alvos.

Recursos do Formulário Web:

Adição e Remoção Dinâmica: Adicione novos alvos com o botão "+ Adicionar Outro Alvo" sem perder o progresso.
Upload de Imagem: Selecione a imagem do passaporte para conversão automática em Base64 antes do envio.
Reindexação Inteligente: Garante que os campos do formulário sejam enviados em sequência (alvos[0], alvos[1]...).

4. Envio via API REST

As integrações externas podem submeter alvos enviando uma requisição HTTP POST para o endpoint /api/alvos.

POST https://rfce.edbv.estaleiro.serpro.gov.br/api/alvos

Headers Obrigatórios:

Content-Type: application/json
Authorization: Basic <credentials_base64>

Exemplo de Payload (JSON):

[
  {
    "nome": "CARLOS EDUARDO SILVA",
    "local": "GRU",
    "tipoCanal": "VERMELHO",
    "imagemPassaporteBase64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  },
  {
    "nome": "MARIA FERNANDA OLIVEIRA",
    "local": "GIG",
    "tipoCanal": "VERDE", //não-implementado
    "imagemPassaporteBase64": ""
  }
]

Exemplo de Chamada via cURL (Com credenciais de exemplo):

curl -X 'POST' \
  'https://rfce.edbv.estaleiro.serpro.gov.br/api/alvos' \
  -H 'accept: */*' \
  -H 'Authorization: Basic YWRtaW46YWRtaW4xMjM=' \
  -H 'Content-Type: application/json' \
  -d '[
  {
    "nome": "JULIANA COSTA",
    "local": "GRU",
    "tipoCanal": "VERMELHO",
    "imagemPassaporteBase64": ""
  }
]'

5. Processamento Interno de Cargas

Após a recepção dos alvos (seja via Web ou API), a aplicação executa o seguinte fluxo transacional de carga:

1. Gravação das Informações

Persiste de forma transacional os dados do voo, arquivos de transmissão, viajantes e os registros de resultado para fiscalização.

2. Notificação do Módulo e-DBV RF

Ao concluir com sucesso a gravação, dispara uma chamada para o serviço de Reconhecimento Facial que irá gerá as respectivas listas de alvos para envio ao Neoface.

6. Evolução de Versões & Roadmap

Acompanhe a evolução do serviço de Carga Externa do Reconhecimento Facial (RF):

📌 Versão 1.0 (Versão Atual)

Primeira versão funcional do serviço para recebimento de alvos:

Local / Recinto: Fixado com o valor GRU nesta versão.
Tipo de Canal: Fixado com o valor VERMELHO
Foto do Passaporte (Base64): Campo disponibilizado no formulário/API, porém a foto está fixa na v1.0.

🚀 Próxima Versão (Planejada)

Evoluções funcionais previstas para as próximas entregas:

Recintos Dinâmicos: Seleção e envio flexível para outros aeroportos/recintos além de GRU.
Processamento de Foto: Integração completa da imagem do passaporte (Base64) para carga e envio ao Neoface.
Canais Configuráveis: Tratamento dinâmico e flexível dos tipos de canal VERDE e VERMELHO.