Saltar para o conteúdo principal
O Symphony API Contract Vector (SACV) governa contratos de API versionados em toda a plataforma. O seu engine é um processo C++ instalável de forma independente que realiza validação limitada de JSON OpenAPI 3.2.0, diffs de compatibilidade determinísticos e inventários descartáveis. A semântica dos endpoints permanece com o vetor ou módulo responsável pelo domínio; o SACV governa a forma e a compatibilidade dos contratos.

Operações

  • Inspect e check: validam que um documento JSON OpenAPI 3.2.0 está em conformidade com o perfil limitado.
  • Diff: calcula diffs de compatibilidade determinísticos entre versões de contratos.
  • Propose: aceita propostas de registo declaradas pelo chamador para contratos novos ou alterados.
  • Project: emite inventários descartáveis para revisores e ferramentas a jusante.

O que o SACV governa

O SACV delimita:
  • A forma do contrato (OpenAPI 3.2.0 com o perfil SACV)
  • A classificação de compatibilidade entre versões
  • A pertença ao registo dos contratos aceites
Não:
  • É responsável pela semântica dos endpoints (cada vetor ou módulo mantém-na)
  • Gera SDKs, publica artefactos nem emite tokens
  • Implica que existe uma superfície de rede ativa (mencionar uma futura API privada não a cria)
O SACV é apenas de leitura, consulta, validação e proposta. A aplicação canónica programática está desativada em todos os engines SKV.

Superfícies relacionadas

Visão geral do SKV

A framework abrangente e o modelo Contract Quad.

SODV

Governa qualquer publicação oficial de um contrato registado no SACV.

SAV

Avalia a composição e a compatibilidade entre componentes declarados.

Comandos de vetores do qxctl

Execute qxctl sacv ... para inspecionar, verificar, comparar e propor.
Última modificação em 10 de outubro de 2026