Mapa de dados

Fontes contratuais

Fonte	Tipo	Regra
`src/rotas/routes.json`	Contrato	Slugs, grupos, ordem e navegação
`src/shared/dados/mock-boundary.json`	Contrato	Dados demonstrativos, autofill e motivo de remoção
`src/shared/tema/fortTokens.ts`	Visual	Tokens de cor, raio, sombra e tipografia
`src/shared/marca/tenantConfig.ts`	Marca	Marca FORT fixa e marca pública do Site
`src/site/banner-assets.json`	Assets	Fontes e saídas otimizadas dos banners públicos

publicBrand é consumida somente no Site, nas páginas de produto e nas páginas institucionais públicas. Fluxos de Empréstimos, área logada e rodapé legal FortCard continuam fora dessa troca. Os dados demonstrativos relacionados na fronteira são pontos de substituição, não uma promessa de backend pronto. A integração deve criar adaptadores por domínio e preservar os contratos de rota, componente e navegação.

Fronteira de adaptadores

Os componentes não devem depender do formato bruto da API. O backend entrega respostas normalizadas e o front consome adaptadores por domínio.

Adaptador esperado	Entrada principal	Saída para a interface
`PublicTenantDataSource`	Host observado e configuração pública	Marca, produtos habilitados, banners e contexto público.
`JourneyDataSource`	Contexto público, CPF, produto e valor	Identificador de jornada, próxima rota e estado inicial.
`PersonalLoanDataSource`	Cadastro, simulação, proposta e assinatura	Oferta, proposta, status, pendências e documentos.
`CltLoanDataSource`	CPF, vínculo, margem e proposta consignada	Elegibilidade, margem, oferta e motivo de indisponibilidade.
`SalaryAdvanceDataSource`	Identificação, Open Finance, conta e quitação	Limite, salário elegível, quitação, Pix e confirmação.
`LoggedAreaDataSource`	CPF, OTP, sessão e pessoa autenticada	Sessão, propostas, pendências e ações disponíveis.
`AddressLookupDataSource`	CEP informado pela pessoa	Logradouro, bairro, UF e cidade normalizados.

Esses nomes são referência de arquitetura, não exigem uma biblioteca específica. O ponto importante é não espalhar parsing da API dentro dos componentes visuais.

Classificação

Classificação	Uso na fronteira
`API-native`	A referência recebida descreve o dado no pedido ou na resposta da FortCard. O backend adapta o formato para a tela.
`backend-derived`	O backend calcula, normaliza, revalida ou monta o dado a partir de integrações e regras.
`backend-persisted`	O backend guarda o dado de negócio para retomar a jornada, consultar status ou auditar a operação.
`public-config`	Dado público de host, marca e catálogo. Não autoriza operação nem substitui validação no servidor.
`demo-fixture`	Valor demonstrativo removível, usado até o adaptador real entregar o mesmo contrato.
`pending-decision`	Dado sem contrato suficiente na referência recebida. Não deve ser presumido pela interface.
`remove-from-contract`	Dado que a interface não deve pedir nem esperar porque é técnico, sensível ou fora da jornada.

Mapa por tela e grupo de dados

Tela ou grupo	Front coleta ou envia	Front espera receber	Classificação	Destino e resolução
Entrada pública	`tenantId`, `partnerId`, `sourceDomain`, `selectedProductId`	Marca pública e produtos habilitados	`public-config`	O backend confere host e allowlist; o contexto não carrega `strLojista` nem `strLoja`.
Simulação	CPF, produto público, valor desejado, prazo e data preferida	Parcela, CET, IOF, tarifas, valor líquido e vencimento	`API-native`	O backend mapeia o produto, consulta condições e normaliza valores monetários antes de devolver à tela.
Ranges de produto	Produto público e valor desejado	Valores mínimo e máximo, prazos e carência	`API-native`	O backend obtém a faixa permitida para o produto e não aceita limites enviados pelo navegador como autorização.
Consignado CLT	CPF, dados de vínculo e autorização para consulta	Elegibilidade, margem, parcela máxima, oferta e motivo de recusa	`pending-decision`	A referência cita consulta de margem, mas não define o retorno; o backend normaliza o contrato após confirmação da FortCard.
Antecipação salarial	Identificação, contato, autorização e conta de recebimento	Elegibilidade, salário, dias trabalhados, limite, tarifa, IOF e quitação	`demo-fixture`	O fluxo exibido depende de Open Finance e serviços de antecipação não descritos na referência; substituir a fixture por adaptador de backend.
Cadastro e proposta	Dados pessoais, endereço, renda, profissão, conta, documentos e aceites	Identificador da proposta, etapa, tempo de espera e documentos exigidos	`API-native`	O backend persiste a jornada, aplica conversões e envia campos técnicos somente para a FortCard.
Consulta de CEP	CEP	Logradouro, bairro, estado e cidade	`backend-derived`	O front atual simula loading e preenchimento. Na integração, o backend ou adaptador validado consulta o serviço de CEP e devolve resposta normalizada.
Assinatura e documentos	Aceite e ação de assinar	Link seguro, validade, situação da assinatura e documentos disponíveis	`pending-decision`	A referência menciona assinatura digital e impressão de documentos, mas não confirma ordem nem formato da etapa.
Área logada	CPF, desafio de acesso e alterações cadastrais	Sessão, contato mascarado, propostas, status, pendências e próxima ação	`backend-derived`	A referência não define autenticação da pessoa; o backend fornece sessão própria e consulta ou persiste o que for necessário.
Retomada e auditoria	Identificadores de jornada e ações da pessoa	Estado salvo e mensagens consistentes	`backend-persisted`	O backend mantém lead, proposta, eventos e aceites. O navegador recebe apenas o necessário para continuar.

Dados coletados pela interface

Cadastro

CPF;
nome;
data de nascimento;
e-mail;
celular;
profissão;
renda;
aceites.

Endereço

CEP;
endereço;
número;
complemento;
bairro;
estado;
cidade.

Conta bancária

banco;
agência;
conta;
dígito;
tipo de conta.

Proposta

valor solicitado;
valor aprovado;
parcelas;
data de primeira parcela;
custos;
status;
validade da oferta;
etapa atual.

Área logada

CPF;
lista de propostas;
status da proposta;
pendências;
dados cadastrais.

O front solicita um desafio de acesso e envia o código informado pela pessoa, mas não recebe nem armazena token técnico da FortCard. O backend devolve contato mascarado, sessão própria e o resumo seguro da conta.

Dados que não entram no contrato do navegador

strLojista, strLoja, filial, ponto de atendimento, usuário, senha, credenciais, token de integração e códigos técnicos de produto ou condição são remove-from-contract. Consulte campos operacionais FortCard para a regra completa.

Começando

Arquitetura

Site e white label

Fluxos de Empréstimos

Integração backend

Qualidade e componentes

Fontes contratuais

Fronteira de adaptadores

Classificação

Mapa por tela e grupo de dados

Dados coletados pela interface

Cadastro

Endereço

Conta bancária

Proposta

Área logada

Dados que não entram no contrato do navegador

​Fontes contratuais

​Fronteira de adaptadores

​Classificação

​Mapa por tela e grupo de dados

​Dados coletados pela interface

​Cadastro

​Endereço

​Conta bancária

​Proposta

​Área logada

​Dados que não entram no contrato do navegador

Fontes contratuais

Fronteira de adaptadores

Classificação

Mapa por tela e grupo de dados

Dados coletados pela interface

Cadastro

Endereço

Conta bancária

Proposta

Área logada

Dados que não entram no contrato do navegador