Todos os artigos
FT-CATALOG-PRUNING-V1· 1.0.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 8/6/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 /edi-hub/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).

  • Heurística de idade: usa verifiedAt do field se presente, senão updated_at da row.
  • 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.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.

    5/17/2026 · new