Voltar para Central de ajuda
FT-CATALOG-PRUNING-V1· 1.1.0Integrações

Catálogo: workflow promoção IA → curado

Promova fields sugeridos por IA a "curado por Lefia" com 1 clique (após revisão humana). Pruning automático remove sugestões IA não-promovidas mais velhas que 90 dias.

Atualizado em 26/09/2026

Workflow promoção + pruning



Catálogo separa fontes confiáveis (spec_verified, nexio_curated, customer_verified) de sugestões a verificar (ai_suggested).

Promover IA → Curado



Cada field com source = ai_suggested mostra botão "Promover" (verde com ShieldCheck) no /mapeamentos/catalogo para super_admin. Click chama /api/admin/catalog/promote-field:
  • Muda source pra nexio_curated (default — válido pra todos os tenants).
  • Grava verifiedBy = user.id + verifiedAt = now.


Outros targets disponíveis via API:
  • spec_verified — confirmou contra spec oficial.
  • customer_verified — validação do cliente (escopo tenant).


Pruning de IA não-promovidos



Endpoint /api/admin/catalog/prune-ai-suggested remove fields ai_suggested mais velhos que olderThanDays (default 90).

  • Idade: usa verifiedAt do field se presente, senão suggestedAt (data da sugestão, gravada no próprio field). Field sem nenhuma das duas não é removido e sai contado em totalFieldsUnknownAge. Gravar a mensagem de novo não renova a data da sugestão.
  • Field promovido nunca é pruned (pq tem verifiedAt recente).
  • Suporta dryRun=true pra contar sem persistir.
  • Aceita catalogId pra escopo específico, omitido = catálogo todo.


Quando usar



  • Após sessão de mapping com sugestões IA: revisar e promover as boas via botão.
  • Limpeza trimestral: rodar prune com dryRun primeiro pra ver impacto, depois real.
  • Migração SAP: prune antes de re-importar via $metadata pra evitar lixo.


Tickets



  • #207.6 implementação (PR #51).

Histórico de versões

  • 1.1.0

    A limpeza de campos sugeridos pela IA mede a idade pela data da sugestão, guardada no próprio campo. Antes usava a data da última gravação da mensagem inteira, e qualquer gravação nela fazia sugestões antigas parecerem novas. Campo sem data não é removido e aparece contado no resultado.

    26/09/2026 · updated

  • 1.0.0

    Workflow promoção IA → curado + pruning. POST /api/admin/catalog/promote-field muda source de ai_suggested → nexio_curated/customer_verified/spec_verified com verifiedBy/verifiedAt. POST /api/admin/catalog/prune-ai-suggested remove fields ai_suggested mais velhos que N dias (default 90), suporta dryRun. LocalFormat._dbId pra UI saber qual row atualizar. PromoteFieldButton emerald. PR #51.

    17/05/2026 · new