Manual — Palavras Normalizadas

O que e

Organiza os termos de busca de cada cliente (hoje espremidos na tabela PalavrasBusca) em entidades claras, com tipo e suas variantes — pra responder na hora "quais sao os termos do cliente X?", revisar com gente, emitir relatorio e (opcional) corrigir a origem.

Conceitos

• Termo = uma entidade buscada (pessoa, empresa, orgao publico...).
• Variante = cada grafia/abreviacao com que o termo e procurado no jornal.
• Tipo = Advogado, Pessoa, Empresa, Publico, Busca de Numero, Indefinido.
• AUTO = variante que veio da origem (PalavrasBusca). MANUAL = variante criada/editada aqui na tela.

Tela do cliente (revisar)

1. Buscar o cliente (nome ou codigo) e abrir.
2. Resumo no topo: total de termos/variantes e contagem por tipo.
3. Por linha: editar nome / tipo / OAB e salvar (marca ✓ revisado).
4. Variantes ("N ▾" expande): ✎ editar, ↦ mover p/ outro termo, + adicionar (manual), × remover.
5. Novo termo (inclusao manual) no topo.
6. Excluir termo: confirma; se tiver variantes pergunta "apagar termo E variantes?" (cascata). E soft-delete — some da tela mas fica gravado/logado (reversivel).
7. Filtrar (texto/tipo) e ordenar clicando nas colunas — util p/ cliente grande.
8. Residuos: o que a maquina nao fechou vira pendencia com sugestao.
9. Cada acao mostra um aviso (toast) no canto, que some sozinho.

Modelo x Origem (importante)

A tela edita a camada normalizada (nosso modelo). A PalavrasBusca (origem, lida por outros sistemas) e mantida tambem pela tela atual da empresa.

• Tipo, agrupamento e mover variante = so no modelo (a origem nao tem esse conceito).
• Conteudo (texto da variante, remover, editar) = pode ir pra origem — controlado em Config.

Config — "Aplicar na origem"

Desligado (padrao): editar/remover variante AUTO fica so no modelo (a origem nao muda). Ligado: remover/editar variante AUTO altera a celula de verdade na PalavrasBusca — sempre com snapshot da linha antes (pra reverter) e registro na fila de writeback.

Emitir relatorio

Ver na tela → Ver PDF (completo com variantes, ou resumido so termos) → Enviar por email. So libera o email depois de ver.

Fila de revisao

Em Revisao ve tudo que precisa de gente, com filtros (empresa, cliente, tipo de pendencia, confianca): TIPO_INDEFINIDO (classificador nao decidiu Pessoa x Empresa), TIPO_SUSPEITO (tipo provavelmente errado), POSSIVEL_DUPLICATA (dois termos parecidos), SEM_NOME (linha vazia na origem). Cada item tem uma sugestao e o botao abrir leva ao cliente pra resolver.

API (terceiros)

Em API ha a documentacao completa pra um sistema externo incluir, consultar e excluir termos de um cliente (auth por chave). Variantes sao opcionais — se nao vierem, a API deriva. Por ora so na rede interna (endereco publico depois).

Logs (auditoria)

Em Logs ve tudo: Edicoes (quem fez o que, de→para) e Writeback na origem (com snapshot e status). Nada se apaga — log append-only. Da pra filtrar por cliente.