clientflow_backend/RELEASE_NOTES_v4928_1_5_12.md

ClientFlow v4928.1.5.12 — Fiscal enrichment guards from real audit

Correção baseada na auditoria de 87 oportunidades reais ao serviço de enriquecimento fiscal.

Alterações

• email_identity_company_internal deixa de ser match muito forte para auto-aplicação.
• Menções de empresa extraídas do email passam a gerar sugestão pendente, salvo prova adicional por domínio compatível.
• Tokens genéricos/setoriais deixam de validar clientes fiscais por si só: engenharia, construções, seguros, mediação, contabilidade, energy, power, solutions, etc.
• Lookup fiscal por customer_name só corre quando o nome parece empresa; nomes pessoais como Nuno Silva ou Bárbara Gonçalves são bloqueados.
• Valores inválidos como pt, com, geral, info, mail não disparam pesquisas fiscais por nome.
• Rejeição manual passa a bloquear a mesma sugestão/NIF, sem impedir uma sugestão correta futura para o mesmo texto de lookup.
• Badge UI atualizado para v4928.1.5.12.

Casos protegidos

• Verifone Portugal já não faz match com ERT TÊXTIL PORTUGAL, S.A. por Portugal.
• Feteira e Torrão Engenharia já não faz match com HUASI - ENGENHARIA E CONSTRUÇÕES por Engenharia/Construções.
• DS Seguros já não faz match com Carlos Reis - Mediação de Seguros apenas por Seguros/Mediação.

Validação

• Novos testes funcionais em tests/test_v4928_1_5_12_fiscal_enrichment_guards.py.