Spring til hovedindhold
Symphony API Contract Vector (SACV) styrer versionerede API-kontrakter på tværs af platformen. Dens motor er en uafhængigt installerbar C++-proces, der udfører afgrænset OpenAPI 3.2.0 JSON-validering, deterministiske kompatibilitetsdiffs og engangsinventarer. Endpoint-semantik forbliver hos den domæneejende vektor eller det domæneejende modul; SACV styrer kontraktform og kompatibilitet.

Operationer

  • Inspect og check: valider, at et OpenAPI 3.2.0 JSON-dokument overholder den afgrænsede profil.
  • Diff: beregn deterministiske kompatibilitetsdiffs mellem kontraktversioner.
  • Propose: accepter kalderdeklarerede registerforslag for nye eller ændrede kontrakter.
  • Project: udsend engangsinventarer til reviewere og efterfølgende værktøjer.

Hvad SACV styrer

SACV afgrænser:
  • Kontraktformen (OpenAPI 3.2.0 med SACV-profilen)
  • Kompatibilitetsklassificering mellem versioner
  • Registermedlemskab for accepterede kontrakter
Den gør ikke følgende:
  • Ejer endpoint-semantik (hver vektor eller hvert modul beholder den)
  • Genererer SDK’er, publicerer artefakter eller udsteder tokens
  • Antyder, at der findes en live netværksflade (omtale af et fremtidigt privat API skaber ikke et)
SACV understøtter kun læsning, forespørgsel, validering og forslag. Programmatisk kanonisk apply er deaktiveret på tværs af SKV-motorerne.

Relaterede flader

Oversigt over SKV

Det overordnede rammeværk og Contract Quad-modellen.

SODV

Styrer enhver officiel publicering af en SACV-registreret kontrakt.

SAV

Evaluerer komposition og kompatibilitet på tværs af deklarerede komponenter.

qxctl-vektorkommandoer

Kør qxctl sacv ... for at inspicere, kontrollere, diffe og foreslå.
Sidst ændret 10. oktober 2026