O projeto usa dados demonstrativos para permitir navegação visual, validação de estados e apresentação dos fluxos antes da integração real. Esses dados não são fonte de verdade, não persistem negócio e não substituem validações de backend. O autofill é um recurso local de demonstração. Ele permite clicar em campos e preencher valores fictícios para navegar com agilidade durante validação visual.

​
Fontes removíveis

O manifesto oficial é src/shared/dados/mock-boundary.json. Ele lista os pontos que precisam ser substituídos, desativados ou mantidos conscientemente durante a integração.

​
Como o autofill liga e desliga

O autofill fica ativo quando todas as condições abaixo são verdadeiras:
  • public/demo/autofill.json existe;
  • VITE_FORT_DEMO_AUTOFILL não está definido como false;
  • a fixture responde com JSON válido.
Para desativar localmente:
Também é possível remover public/demo/autofill.json. Depois de alterar a variável ou a fixture, reinicie o servidor local.

​
Processo de substituição pelo backend

  1. Criar um cliente HTTP para falar somente com o backend da aplicação.
  2. Criar adaptadores por domínio para transformar respostas da API nos formatos esperados pelas telas.
  3. Manter componentes, rotas e navegação.
  4. Substituir a fonte demonstrativa indicada em src/shared/dados/mock-boundary.json.
  5. Desativar o autofill com VITE_FORT_DEMO_AUTOFILL=false.
  6. Mapear carregamento, vazio, erro, pendência, sucesso e bloqueio para os estados já previstos nas telas.
  7. Rodar npm run quality e npm run docs:check.

​
Adapters recomendados

O adapter deve receber respostas do backend já sanitizadas e devolver o mesmo contrato visual esperado pelas telas. Assim, a equipe troca a origem dos dados sem reescrever layout, componentes ou rotas.

​
Regras de segurança

  • O navegador nunca deve chamar a API FortCard diretamente.
  • O navegador nunca deve armazenar credenciais, tokens operacionais, strLojista ou strLoja.
  • tenantId, partnerId, sourceDomain e selectedProductId são contexto público e precisam ser revalidados pelo backend.
  • O backend resolve produto operacional, lojista, loja, credenciais, filial e regras comerciais antes de chamar FortCard.