2.0 KiB
ClientFlow v4.8.2 — Production Stabilization & Guided Operations
Esta versão fecha o ciclo de atualização com melhorias pequenas e focadas na operação diária. Não adiciona novas integrações, não muda regras LLM, não altera auto-complete e não requer migração de base de dados.
Objetivo
Reduzir erros reais do operador:
- cliente fiscal errado;
- documento emitido sem dados mínimos;
- envio preparado sem morada/telefone;
- outbox falhada sem explicação operacional;
- operador sem próximo passo claro.
O que muda
Cliente fiscal e contacto Chatwoot separados
Operations, oportunidades e detalhe de task passam a mostrar explicitamente:
- Cliente fiscal;
- Contacto Chatwoot;
- conversa/contacto de origem quando disponível.
Prontidão antes de documento ou envio
A UI mostra uma checklist mínima:
- cliente fiscal associado;
- NIF;
- email de faturação;
- morada fiscal;
- código postal;
- localidade;
- telefone para envio quando aplicável.
Quando falta informação, a UI mostra que a ação deve aguardar correção dos dados.
Próximo passo e bloqueios atuais
A ficha de oportunidade passa a destacar:
- próxima ação;
- bloqueios atuais;
- dados fiscais/contacto;
- prontidão para documentos;
- prontidão para envio.
Outbox em linguagem operacional
A outbox passa a mostrar uma leitura operacional do erro, por exemplo:
Motivo provável: Cliente fiscal sem NIF válido ou dados fiscais incompletos.
O detalhe do item continua a incluir o payload e o erro técnico para diagnóstico.
Health para operação
/system/health passa a mostrar estado simples:
- OK;
- Atenção;
- Crítico.
Também mostra contadores de oportunidades sem cliente fiscal, clientes fiscais incompletos em oportunidades ativas, produtos sem código externo e último webhook Chatwoot.
Validação
PYTHONPATH=. python -m compileall app scripts tests
PYTHONPATH=. pytest -q
Sem migração
Esta versão é apenas UI/health/readability. Não requer alteração de schema.