Ir para o conteúdo

Banco da Amazônia — Onboarding Hub

Bem-vindo à documentação oficial do Onboarding Hub!

O Onboarding Hub é uma aplicação intermediária projetada para realizar a integração no processo de onboarding digital do Banco da Amazônia.

Objetivo

O hub recebe cadastros pendentes de decisão (classificados como risco alto/crítico, PEP, ou com falhas de validação de documentos/selfies), realiza a tramitação com a equipe de contact center (atendimento de 1º nível) e devolve as propostas saneadas para a mesa de decisão final do banco (2º nível).

Como as integrações finais do banco (APIs do Sandbox/CorBanks, APIs do SmartShare, tópicos reais do Kafka e MDM/CIF) estão em desenvolvimento, este repositório adota uma estratégia contract-first:

  1. O modelo de domínio em Python (Pydantic) serve como a fonte da verdade.
  2. Contratos agnósticos de transporte (JSON Schema / Avro) são gerados a partir desses modelos.
  3. Desenvolvemos ponta a ponta utilizando dados sintéticos gerados dinamicamente para simular payloads reais, permitindo testes de qualidade de dados antes da liberação dos acessos do banco.

Estrutura da Documentação

Nesta documentação você encontrará:

  • Começando: Guia passo a passo para configurar o ambiente de desenvolvimento local, incluindo serviços via Docker e comandos úteis.
  • Arquitetura: Estrutura do projeto e fluxos de integração representados graficamente.
  • Referência da API: Detalhamento automático dos pacotes e módulos em Python documentados no código fonte.
  • ADRs (Architecture Decision Records): Histórico de decisões técnicas de arquitetura tomadas ao longo do projeto.