Visão geral

A aplicação tem três superfícies com responsabilidades distintas: O domínio ou subdomínio é a entrada do Site público. A partir dele, o backend fornece ou confirma uma configuração pública de tenant. Essa configuração limita a identidade exibida e os produtos disponíveis, sem deslocar responsabilidades operacionais para o navegador.

Caminho do tráfego

  1. A pessoa acessa um domínio ou subdomínio público.
  2. O Site identifica o host observado e solicita a configuração pública correspondente.
  3. O Site apresenta a marca FORT autorizada, banners e produtos habilitados para aquela origem.
  4. Ao selecionar um produto, o front inicia o fluxo com a origem comercial pública e o ID estável do produto.
  5. O backend revalida o host, resolve a operação FortCard e continua a proposta.
O fallback público é FORT para ambiente local ou host sem configuração reconhecida. Esse fallback é apenas de apresentação. Ele não autoriza uma origem comercial nem substitui a validação do backend.

Responsabilidades por camada

strLojista, strLoja, filial, ponto de atendimento, usuário, senha, credenciais e tokens são dados exclusivamente do backend. O produto público selecionado é uma intenção do usuário. O backend o mapeia para strProduto e resolve strPlano conforme produto, simulação ou regra de crédito.

Limites entre superfícies

  • src/site contém página inicial, páginas de produto e páginas institucionais públicas.
  • src/plataforma contém os Fluxos de Empréstimos e a Área Logada FortCard.
  • src/shared reúne componentes, tema, formulários, dados e contratos reutilizáveis.
  • src/rotas mantém os caminhos públicos e das jornadas.
  • Adaptadores de rede ficam fora dos componentes visuais. A tela recebe dados e estados já preparados.
A marca pública não se propaga para Fluxos de Empréstimos, Área Logada ou rodapé legal. Nessas superfícies, FortCard é a marca de referência jurídica, operacional e de integração.

Decisões que dependem do backend

  • a fonte da configuração pública por host;
  • a allowlist de domínios e subdomínios;
  • o mapeamento de produto público para código FortCard;
  • a origem de strPlano, que pode ser escolha do cliente, regra do produto ou resultado de simulação;
  • a regra para acesso direto a uma página de produto desabilitada.
Essas decisões devem ser fechadas no contrato do backend antes de serem tratadas como autorização no front.