REQ-009 Padronizar estados de tela

Padronizar estados de tela

Problema / Contexto

Todo PRD de interface deve prever loading, empty, error, processamento de IA, resultado indisponível e informação insuficiente.

História de usuário

Como vendedor, gestor, sócio, administrador, equipe de entrega, quero entender quando a tela está carregando, vazia, com erro ou sem informação suficiente, para não confundir falha técnica com conclusão comercial.

Comportamento esperado

1. Mostrar loading durante carregamento.
2. Explicar empty state e próximo passo.
3. Identificar processamento de IA.
4. Em erro, preservar dados digitados quando possível.
5. Quando não houver base, mostrar informação insuficiente.

Papel da IA

Não se aplica.

Regras de negócio

• RN1: Resultado indisponível não pode virar conteúdo fictício.
• RN2: Erro não deve apagar silenciosamente dados digitados.

Dados envolvidos

• estado_tela — loading/empty/error/processing/unavailable/insufficient/ready — sim — fato
• mensagem — orientação — quando aplicável — fato

Critérios de aceite

• Dada tela sem dados, quando abrir, então mostra empty state e próximo passo.
• Dado processamento de IA, quando em andamento, então não exibe conclusão parcial como final.

Exceções e erros

• Erro inesperado deve ser registrado sem expor segredo técnico ao usuário.

Fora de escopo

• Observabilidade avançada além do mínimo do piloto.

Dúvidas em aberto

• Nenhuma dúvida aberta identificada nas fontes atuais.

Histórico

Data	O que mudou	Quem	Referência
2026-09-15	Criado no pacote de requisitos do MVP	LC Verum	Índice do MVP - Requisitos
2026-09-16	Numerado e importado para a documentação	Luiz	Registro de Mudanças