Přejít na hlavní obsah
Symphony API Contract Vector (SACV) spravuje verzované API kontrakty napříč platformou. Jeho engine je nezávisle instalovatelný proces v C++, který provádí ohraničenou validaci JSON podle OpenAPI 3.2.0, deterministické rozdíly kompatibility a jednorázové inventáře. Sémantika koncových bodů zůstává u vektoru nebo modulu, který vlastní danou doménu; SACV spravuje tvar a kompatibilitu kontraktů.

Operace

  • Inspect a check: ověří, že dokument JSON podle OpenAPI 3.2.0 odpovídá ohraničenému profilu.
  • Diff: vypočítá deterministické rozdíly kompatibility mezi verzemi kontraktů.
  • Propose: přijímá návrhy registru deklarované volajícím pro nové nebo změněné kontrakty.
  • Project: emituje jednorázové inventáře pro recenzenty a navazující nástroje.

Co SACV spravuje

SACV ohraničuje:
  • Tvar kontraktu (OpenAPI 3.2.0 s profilem SACV)
  • Klasifikaci kompatibility mezi verzemi
  • Členství přijatých kontraktů v registru
SACV naopak:
  • Nevlastní sémantiku koncových bodů (tu si ponechává každý vektor nebo modul)
  • Negeneruje SDK, nepublikuje artefakty ani nevydává tokeny
  • Neimplikuje existenci živé síťové plochy (zmínka o budoucím privátním API žádné nevytváří)
SACV slouží pouze ke čtení, dotazování, validaci a navrhování. Programové kanonické apply je napříč enginy SKV zakázáno.

Související oblasti

Přehled SKV

Zastřešující framework a model Contract Quad.

SODV

Spravuje jakoukoli oficiální publikaci kontraktu registrovaného v SACV.

SAV

Vyhodnocuje kompozici a kompatibilitu napříč deklarovanými komponentami.

Vektorové příkazy qxctl

Spusťte qxctl sacv ... pro inspect, check, diff a propose.
Naposledy změněno 10. října 2026