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
sourcepranexio_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
verifiedAtdo field se presente, senãoupdated_atda row. - Field promovido nunca é pruned (pq tem
verifiedAtrecente). - Suporta
dryRun=truepra contar sem persistir. - Aceita
catalogIdpra 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
$metadatapra 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