Estados por ação
Áreas críticas
- envio de token;
- validação de token;
- consulta de banco;
- consulta de endereço;
- criação de proposta;
- consulta de oferta;
- assinatura;
- listagem de propostas na área logada.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Estados que precisam existir na integração real.
| Estado | Expectativa |
|---|---|
| Loading | CTA desabilitado com feedback visual |
| Sucesso | Navegação para próxima rota ou atualização da tela |
| Erro validável | Mensagem próxima ao campo ou bloco relacionado |
| Erro sistêmico | Mensagem de falha sem perder dados digitados e opção de tentar novamente |
| Vazio | Estado claro quando não há propostas, bancos ou cidades |
| Cenário | Sinal recebido pelo backend | Estado da interface | Regra |
|---|---|---|---|
| Validação de campo | HTTP 400, por exemplo CPF, CEP, prazo ou documento inválido | Erro validável | Associar a mensagem ao campo quando o backend identificar o dado. |
| Recurso ou condição indisponível | HTTP 404 ou 409 | Erro de negócio | Preservar a jornada e orientar alternativa, sem expor detalhe técnico. |
| Sessão técnica expirada | HTTP 401 da integração | Reautenticação ou tentativa segura | Só o backend renova credenciais FortCard; a sessão da pessoa tem tratamento próprio. |
| Tempo excedido ou serviço indisponível | HTTP 408 ou ausência de resposta | Erro sistêmico | Manter dados digitados e oferecer nova tentativa. |
| Pré-análise em andamento | Identificador de proposta, indicador de espera e tempo estimado | Carregamento prolongado | Consultar o backend no intervalo definido por ele, sem chamadas diretas à FortCard. |
| Sem margem CLT | Resultado de elegibilidade sem valor disponível | Vazio ou exceção de elegibilidade | Mostrar a próxima alternativa; o formato definitivo da resposta depende de confirmação. |
| Sem limite de antecipação | Retorno de elegibilidade sem valor antecipável | Vazio ou exceção de elegibilidade | Não interpretar valores demonstrativos como decisão de crédito. |
| Assinatura ou documento pendente | Situação de assinatura ou lista de pendências | Pendente | Exibir ação e validade do link quando o backend disponibilizar esses dados. |
| Área logada sem proposta | Lista vazia para a pessoa autenticada | Vazio | Não confundir ausência de proposta com falha de login. |
| Conteúdo adaptado pelo backend | Comportamento do front |
|---|---|
| Mensagem geral da operação | Exibir mensagem compreensível no resumo da etapa. |
| Lista de ocorrências | Exibir cada ocorrência e relacioná-la ao campo quando houver referência confiável. |
| Identificador de proposta ausente ou igual a zero | Não avançar a jornada nem tratar a resposta como sucesso. |
| Documento obrigatório ausente | Voltar para pendência de documentos, preservando o restante da proposta. |