​
Configuração pública

O backend ou a fonte pública de configuração associa cada domínio ou subdomínio a uma marca pública. O Site usa essa resposta em runtime para renderizar logo, cores, favicon, banners e produtos habilitados. Os campos públicos esperados são:
  • tenantId, partnerId e sourceDomain;
  • displayName;
  • publicBrand, com logos, cores e favicon;
  • banners da página inicial e das páginas de produto;
  • enabledProducts.
src/shared/marca/publicTenantRuntime.ts ilustra a resolução local por host. src/shared/marca/tenantConfig.ts mantém a marca FORT usada como fallback e referência visual. Em produção, o backend ou uma fonte pública equivalente deve entregar dados com a mesma finalidade, sem incluir informações operacionais.

​
Como trocar uma marca pública

  1. Cadastre o domínio ou subdomínio na allowlist do backend e associe-o ao tenant público.
  2. Publique logos, favicon e banners otimizados em caminhos públicos.
  3. Entregue publicBrand, enabledProducts, tenantId, partnerId e sourceDomain pela fonte de configuração pública.
  4. Abra o Site no host cadastrado e confira identidade, banners e produtos visíveis.
  5. Mantenha os Fluxos de Empréstimos, a Área Logada e o rodapé legal com FortCard.
A marca FORT é o fallback para ambiente local ou host desconhecido. Esse fallback não cria um parceiro operacional nem substitui a validação do backend.

​
Assets públicos

Os banners são referenciados por src/site/banner-assets.json. Os arquivos ficam em public/assets e as versões otimizadas em public/assets/generated. Depois de alterar arquivos de origem, execute npm run assets:optimize. npm run dev e npm run build executam essa otimização automaticamente.

​
Limites

  • Logos, cores, favicon e banners valem somente para o Site e páginas públicas.
  • Fluxos de Empréstimos, Área Logada e rodapé legal usam FortCard.
  • A configuração pública não contém credenciais, token, usuário, senha, strLojista ou strLoja.
  • O backend valida host, parceiro e produto antes de usar qualquer contexto recebido do Site.

​
Critérios de aceite

  • Logo legível em superfícies claras e escuras.
  • Botões com contraste suficiente.
  • Banners corretos em web, tablet e mobile.
  • Produtos não habilitados ausentes da oferta pública.
  • Rodapé legal, Fluxos de Empréstimos e Área Logada sem alteração de marca.