> ## 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: governance dei contratti API per QuanuX Symphony

> SACV governa i contratti API versionati tramite controlli delimitati OpenAPI 3.2.0, diff di compatibilità deterministici, proposte dichiarate dal chiamante e inventari.

Il Symphony API Contract Vector (SACV) governa i contratti API versionati in tutta la piattaforma. Il suo engine è un processo C++ installabile in modo indipendente che esegue una validazione JSON OpenAPI 3.2.0 delimitata, diff di compatibilità deterministici e inventari usa e getta. La semantica degli endpoint resta al vettore o modulo proprietario del dominio; SACV governa la forma e la compatibilità dei contratti.

## Operazioni

* **Inspect e check**: verificano che un documento JSON OpenAPI 3.2.0 sia conforme al profilo delimitato.
* **Diff**: calcola diff di compatibilità deterministici tra versioni dei contratti.
* **Propose**: accetta proposte di registro dichiarate dal chiamante per contratti nuovi o modificati.
* **Project**: emette inventari usa e getta per revisori e strumenti a valle.

## Cosa governa SACV

SACV delimita:

* La forma del contratto (OpenAPI 3.2.0 con il profilo SACV)
* La classificazione della compatibilità tra versioni
* L'appartenenza al registro dei contratti accettati

Non:

* Possiede la semantica degli endpoint (ogni vettore o modulo la mantiene)
* Genera SDK, pubblica artefatti o emette token
* Implica l'esistenza di una superficie di rete attiva (menzionare una futura API privata non la crea)

> [!NOTE]
>
> SACV è limitato a lettura, interrogazione, validazione e proposta. L'apply canonico programmatico è disabilitato in tutti gli engine SKV.

## Superfici correlate

> [card] [Panoramica di SKV](https://docs.quanux.org/symphony/it/skv/overview.md)
>
> Il framework ombrello e il modello Contract Quad.

> [card] [SODV](https://docs.quanux.org/symphony/it/skv/sodv.md)
>
> Governa qualsiasi pubblicazione ufficiale di un contratto registrato in SACV.

> [card] [SAV](https://docs.quanux.org/symphony/it/skv/sav.md)
>
> Valuta composizione e compatibilità tra i componenti dichiarati.

> [card] [Comandi dei vettori di qxctl](https://docs.quanux.org/symphony/it/qxctl/vector-commands.md)
>
> Esegui `qxctl sacv ...` per inspect, check, diff e propose.


## Related topics

- [SODV: governance della documentazione ufficiale e dei rilasci](https://docs.quanux.org/symphony/it/skv/sodv.md)
- [Guida rapida: esplora QuanuX Symphony](https://docs.quanux.org/symphony/it/quickstart.md)
- [Documentazione di QuanuX Symphony](https://docs.quanux.org/symphony/it/index.md)
- [Vector e fasi di consegna di Symphony](https://docs.quanux.org/symphony/it/concepts/vectors.md)
- [Dottrina della piattaforma QuanuX Symphony](https://docs.quanux.org/symphony/it/doctrine.md)


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