FT-CATALOG-PROVENANCE-V1· 1.0.0Integrações
Catálogo: proveniência declarada + sub-tipos manual
Cada campo no catálogo declara fonte (spec/IA/curado/cliente), com link público pra spec quando disponível. Sub-tipos manual distinguem curadoria Lefia (global) de validação do cliente (tenant).
Atualizado em 8/6/2026
Catálogo: proveniência declarada
Pra catálogo virar fonte de confiança (ativo defensável enterprise), cada campo declara explicitamente de onde veio + quem validou + link público pra spec.
Hierarquia de confiança (FieldSource)
| Source | Cor | Quando |
|---|---|---|
| spec_verified | Verde | Parsed de XSD/EDMX/spec oficial (SAP EDMX, NF-e Sefaz, EDIFACT XSD) |
| nexio_curated | Esmeralda | Admin Lefia curou — válido pra todos os tenants |
| customer_verified | Ciano | User do tenant verificou — escopo do tenant dele |
| ai_suggested | Azul | IA gerou — aguarda verificação humana |
| manual (legacy) | Amarelo | Hand-coded antes da hierarquia atual |
| stub | Cinza | Placeholder vazio |
A diferença
nexio_curated vs customer_verified importa pra clientes que rodam multi-tenant: a curadoria Lefia vale pra todo mundo; a curadoria do cliente vale só pro tenant dele (não vaza pra outro).Provenance pública
Quando a spec tem URL pública gratuita, o catálogo armazena em
provenanceUrl. UI mostra como link externo na coluna Verificação da tabela do catálogo.Exemplos hoje:
- NF-e:
https://www.nfe.fazenda.gov.br/portal/listaConteudo.aspx...(Sefaz Nacional). - SAP EDMX: não há URL pública (cada serviço é EDMX privado do cliente).
- X12: spec licenciada por ASC X12 (paga) — NÃO linkamos.
Audit trail
Cada field pode ter:
verifiedBy: user_id que aprovou (NULL se nunca foi validado).verifiedAt: timestamp da última verificação.sourceVersion: versão da spec quando verified (e.g. "X12-005010").provenanceUrl: link público (quando aplicável).
A tabela do catálogo mostra coluna Verificação com "há X dias", versão, e ícone de link externo.
Tickets relacionados
- #207.3 implementação (proveniência + sub-tipos manual + UI badge).
- #207 épico em progresso (Verified Integration Knowledge Base).
Histórico de versões
- 1.0.0
FieldSource ganha nexio_curated + customer_verified (sub-tipos manual com escopo distinto). FormatField + LocalFormat ganham provenanceUrl/sourceVersion. SourceBadge com 2 novos badges (Building2 verde, UserCheck cyan). catalog-browser ganha coluna Verificação com link público pra spec. NF-e parser popula provenanceUrl da Sefaz. PR #47.
5/17/2026 · new