> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quanux.org/symphony/llms.txt
> Use this file to discover all available pages before exploring further.

# SACV: QuanuX Symphony の API コントラクトガバナンス

> SACV は、範囲が限定された OpenAPI 3.2.0 チェック、決定的な互換性差分、呼び出し元が宣言する提案、インベントリを通じて、バージョン管理された API コントラクトを管理します。

Symphony API Contract Vector（SACV）は、プラットフォーム全体のバージョン管理された API コントラクトを管理します。そのエンジンは個別にインストール可能な C++ プロセスで、範囲が限定された OpenAPI 3.2.0 JSON の検証、決定的な互換性差分、使い捨てのインベントリを実行します。エンドポイントのセマンティクスはドメインを所有するベクトルまたはモジュールに残り、SACV はコントラクトの形状と互換性を管理します。

## 操作

* **inspect と check**: OpenAPI 3.2.0 JSON ドキュメントが範囲限定プロファイルに準拠していることを検証します。
* **diff**: コントラクトのバージョン間で決定的な互換性差分を計算します。
* **propose**: 新規または変更されたコントラクトについて、呼び出し元が宣言したレジストリ提案を受け付けます。
* **project**: レビュアーや下流ツール向けに使い捨てのインベントリを出力します。

## SACV が管理するもの

SACV が制約するもの:

* コントラクトの形状（SACV プロファイルを伴う OpenAPI 3.2.0）
* バージョン間の互換性の分類
* 受け入れられたコントラクトのレジストリメンバーシップ

SACV が行わないこと:

* エンドポイントのセマンティクスを所有すること（それは各ベクトルまたはモジュールが保持します）
* SDK の生成、成果物の公開、トークンの発行
* ライブなネットワークサーフェスの存在を示唆すること（将来のプライベート API に言及しても、それが作成されるわけではありません）

> [!NOTE]
>
> SACV は読み取り、クエリ、検証、提案のみを行います。プログラムによる正規の apply は、SKV エンジン全体で無効になっています。

## 関連するサーフェス

> [card] [SKV の概要](https://docs.quanux.org/symphony/ja/skv/overview.md)
>
> 包括的なフレームワークと Contract Quad モデル。

> [card] [SODV](https://docs.quanux.org/symphony/ja/skv/sodv.md)
>
> SACV に登録されたコントラクトの公式な公開を管理します。

> [card] [SAV](https://docs.quanux.org/symphony/ja/skv/sav.md)
>
> 宣言されたコンポーネント間のコンポジションと互換性を評価します。

> [card] [qxctl ベクトルコマンド](https://docs.quanux.org/symphony/ja/qxctl/vector-commands.md)
>
> `qxctl sacv ...` を実行して inspect、check、diff、propose を行います。


## Related topics

- [SODV: 公式ドキュメントとリリースのガバナンス](https://docs.quanux.org/symphony/ja/skv/sodv.md)
- [Symphony Knowledge Vector: SKV フレームワークの概要](https://docs.quanux.org/symphony/ja/skv/overview.md)
- [QuanuX Symphony プラットフォームドクトリン](https://docs.quanux.org/symphony/ja/doctrine.md)
- [QuanuX Symphony ドキュメント](https://docs.quanux.org/symphony/ja/index.md)
- [クイックスタート: QuanuX Symphony を探索する](https://docs.quanux.org/symphony/ja/quickstart.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.