Estrutura e rotas

fortcard-emprestimo/
  docs/
  public/
  scripts/
  src/
    aplicacao/
    plataforma/
    preview/
    rotas/
    shared/
    site/
  index.html
  package.json

Pastas principais

Caminho	Responsabilidade
`src/main.tsx`	Entrada React
`src/aplicacao`	Providers, roteador e composição
`src/rotas`	Contrato público de rotas
`src/site`	Página inicial, páginas de produto e institucionais
`src/plataforma/fluxos`	Jornadas de contratação
`src/plataforma/area-logada`	Login, propostas e dados cadastrais
`src/shared/componentes`	Primitivas reutilizáveis
`src/shared/formularios`	Máscaras e utilitários de formulário
`src/shared/dados`	Fixtures, datasets locais e fronteira de dados demonstrativos
`src/shared/marca`	Marca FortCard e configuração pública
`src/shared/tema`	Tokens TypeScript e tema Material UI
`src/shared/design-system`	Tokens CSS e estilos compartilhados
`src/preview`	Navegador técnico, pilot e showcase
`public/assets`	Logos, fontes, imagens e banners
`docs`	Documentação Mintlify

Regra de isolamento

docs/ documenta a entrega, mas não é importado por src/. src/site usa src/shared e o contrato de src/rotas. Ele não importa src/plataforma nem src/preview. src/plataforma usa src/shared e o contrato de src/rotas. Ele não importa src/site nem src/preview. src/shared contém infraestrutura e contratos reutilizáveis. Ele não importa src/site, src/plataforma, src/aplicacao nem src/preview. src/preview é uma superfície técnica que pode consumir rotas para visualização. Nenhuma superfície de produto depende dele.

Leitura para implementação

Para desenvolvimento backend, os caminhos mais importantes são:

Necessidade	Onde olhar primeiro
Entender rotas e slugs	`src/rotas/routes.json` e esta página.
Entender páginas públicas	`src/site` e Site público e produtos.
Entender jornadas FortCard	`src/plataforma/fluxos` e páginas em Fluxos de Empréstimos.
Entender Área Logada	`src/plataforma/area-logada` e Área Logada.
Substituir dados demonstrativos	`src/shared/dados/mock-boundary.json` e Dados demonstrativos e autofill.
Conectar backend	Contratos do backend da aplicação.
Configurar white label público	`src/shared/marca` e White label.

Se o projeto for dividido em Site público e Plataforma, src/shared deve ser tratado como dependência compartilhada controlada. Ele contém tema, componentes, formulários, dados locais e contratos que não devem ser duplicados de forma divergente.

Contrato de rotas

O arquivo src/rotas/routes.json é a fonte de verdade de slugs, grupos, ordem e navegação.

Rotas públicas

Rota	Uso
`/`	Página inicial
`/emprestimo`	Página de empréstimo pessoal
`/consignado`	Página de consignado CLT
`/antecipacao`	Página de antecipação salarial
`/termos`	Termos e condições de uso
`/privacidade`	Política de privacidade
`/atendimento`	Contato e atendimento
`/exemplo-white-label`	Demonstração de troca de marca pública

Rotas de fluxo

Prefixo	Uso
`/emprestimo/<screen-id>`	Fluxo de empréstimo pessoal
`/consignado/<screen-id>`	Fluxo de consignado CLT
`/antecipacao/<screen-id>`	Fluxo de antecipação salarial
`/arealogada/<screen-id>`	Telas da Área Logada

Requisito de hospedagem

Hosts estáticos precisam retornar index.html para rotas internas, preservando o path solicitado.

Começando

Arquitetura

Site e white label

Fluxos de Empréstimos

Integração backend

Qualidade e componentes

Pastas principais

Regra de isolamento

Leitura para implementação

Contrato de rotas

Rotas públicas

Rotas de fluxo

Requisito de hospedagem

​Pastas principais

​Regra de isolamento

​Leitura para implementação

​Contrato de rotas

​Rotas públicas

​Rotas de fluxo

​Requisito de hospedagem

Pastas principais

Regra de isolamento

Leitura para implementação

Contrato de rotas

Rotas públicas

Rotas de fluxo

Requisito de hospedagem