Saltar al contingut principal
El Symphony API Contract Vector (SACV) governa els contractes d’API versionats de tota la plataforma. El seu motor és un procés en C++ instal·lable de manera independent que fa validació acotada de JSON OpenAPI 3.2.0, diferències de compatibilitat deterministes i inventaris d’un sol ús. La semàntica dels endpoints continua sent del vector o mòdul propietari del domini; SACV governa la forma i la compatibilitat dels contractes.

Operacions

  • Inspecció i comprovació: valida que un document JSON OpenAPI 3.2.0 s’ajusti al perfil acotat.
  • Diferències: calcula diferències de compatibilitat deterministes entre versions de contractes.
  • Proposta: accepta propostes de registre declarades per l’invocador per a contractes nous o modificats.
  • Projecció: emet inventaris d’un sol ús per a revisors i eines posteriors.

Què governa SACV

SACV acota:
  • La forma del contracte (OpenAPI 3.2.0 amb el perfil SACV)
  • La classificació de compatibilitat entre versions
  • La pertinença al registre dels contractes acceptats
No:
  • És propietari de la semàntica dels endpoints (cada vector o mòdul la conserva)
  • Genera SDK, publica artefactes ni emet tokens
  • Implica que existeixi una superfície de xarxa activa (esmentar una futura API privada no en crea cap)
SACV és només de lectura, consulta, validació i proposta. L’aplicació canònica programàtica està desactivada a tots els motors SKV.

Superfícies relacionades

Visió general de SKV

El marc general i el model del Contract Quad.

SODV

Governa qualsevol publicació oficial d’un contracte registrat a SACV.

SAV

Avalua la composició i la compatibilitat entre components declarats.

Ordres de vectors de qxctl

Executeu qxctl sacv ... per inspeccionar, comprovar, comparar i proposar.
Darrera modificació el 10 d’octubre del 2026