> ## 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: حوكمة عقود API في QuanuX Symphony

> يحكم SACV عقود API ذات الإصدارات عبر فحوص OpenAPI 3.2.0 المحدودة، وفروقات التوافق الحتمية، والمقترحات التي يصرّح بها المستدعي، وقوائم الجرد.

يحكم متجه عقود API في Symphony ‏(SACV) عقود API ذات الإصدارات عبر المنصة. ومحركه عملية C++ قابلة للتثبيت بشكل مستقل تُجري تحققًا محدودًا من JSON وفق OpenAPI 3.2.0، وفروقات توافق حتمية، وعمليات جرد مؤقتة. تبقى دلالات نقاط النهاية لدى المتجه أو الوحدة المالكة للنطاق؛ أما SACV فيحكم شكل العقد وتوافقه.

## العمليات

* **الفحص والتحقق**: التحقق من أن مستند JSON وفق OpenAPI 3.2.0 يطابق ملف التعريف المحدود.
* **المقارنة (Diff)**: حساب فروقات توافق حتمية بين إصدارات العقود.
* **الاقتراح**: قبول مقترحات السجل التي يصرّح بها المستدعي للعقود الجديدة أو المعدّلة.
* **الإسقاط**: إصدار عمليات جرد مؤقتة للمراجعين والأدوات اللاحقة.

## ما يحكمه SACV

يقيّد SACV ما يلي:

* شكل العقد (OpenAPI 3.2.0 مع ملف تعريف SACV)
* تصنيف التوافق بين الإصدارات
* عضوية السجل للعقود المقبولة

وهو لا:

* يملك دلالات نقاط النهاية (يحتفظ بها كل متجه أو وحدة)
* يولّد حزم SDK أو ينشر مخرجات أو يصدر رموزًا مميزة (tokens)
* يوحي بوجود واجهة شبكية حية (ذكر واجهة API خاصة مستقبلية لا ينشئها)

> [!NOTE]
>
> SACV مخصص للقراءة والاستعلام والتحقق والاقتراح فقط. التطبيق القانوني البرمجي معطّل عبر محركات SKV.

## واجهات ذات صلة

> [card] [نظرة عامة على SKV](https://docs.quanux.org/symphony/ar/skv/overview.md)
>
> الإطار الشامل ونموذج Contract Quad.

> [card] [SODV](https://docs.quanux.org/symphony/ar/skv/sodv.md)
>
> يحكم أي نشر رسمي لعقد مسجّل في SACV.

> [card] [SAV](https://docs.quanux.org/symphony/ar/skv/sav.md)
>
> يقيّم التركيب والتوافق عبر المكونات المصرّح بها.

> [card] [أوامر المتجهات في qxctl](https://docs.quanux.org/symphony/ar/qxctl/vector-commands.md)
>
> شغّل `qxctl sacv ...` للفحص والتحقق والمقارنة والاقتراح.


## Related topics

- [SODV: حوكمة التوثيق الرسمي والإصدارات](https://docs.quanux.org/symphony/ar/skv/sodv.md)
- [المتجه الكمي في Symphony: عقود الإطار](https://docs.quanux.org/symphony/ar/vectors/sqv.md)
- [توثيق QuanuX Symphony](https://docs.quanux.org/symphony/ar/index.md)
- [عزل المسار الساخن في QuanuX Symphony](https://docs.quanux.org/symphony/ar/concepts/hot-path-isolation.md)
- [مبادئ منصة QuanuX Symphony](https://docs.quanux.org/symphony/ar/doctrine.md)


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