Skip to main content
المواصفة المفتوحة لـ StackKit هي العقد المنشور الرفيع خلف عبارة “معيار المختبر المنزلي المفتوح”. وهي تفهرس ملفات تُشحن مع كل إصدار من StackKits؛ ولا تُدخل أي مخطط جديد. يتبع إصدار المواصفة وسم الإصدار الذي تُشحن معه، والتغييرات ضمن v0 إضافية. تقع النسخة المرجعية في المستودع العام على docs/OPEN-SPEC.md. كل ما في المواصفة لا يتطلب حسابًا: لا يحتاج Standard Mode إلى حساب kombify ولا إلى نقطة نهاية kombify مستضافة ولا إلى Techstack.

​
1. لقطة المعمارية

تصف لقطة المعمارية القائمة على الحقائق فقط إصدارًا: الأطقم والطوبولوجيا والقدرات ونموذج التوزيع والوحدات والإضافات ونضج الدعم. CUE هو مصدر الحقيقة التقني؛ واللقطة إسقاط منه. يقرأ المستهلك اللقطة، لا CUE أبدًا، ويجب أن يتسامح مع الحقول الإضافية.

​
2. أفعال دورة الحياة

يُدار كل طقم بالأفعال نفسها عبر CLI stackkit وموصّل stackkit-mcp. المدخلات والمخرجات موثّقة في مرجع CLI وشرح CLI خطوة بخطوة. ينتهي الفعل إما باكتمال مع دليل أو بفشل مع سبب نهائي. ولا يبلّغ أبدًا عن نجاح لعمل لم ينفّذه.

​
3. تصنيف التوزيع

يصف التوزيع أين يجوز تشغيل طقم أو وحدة. المفردات منشورة في foundation/placement.cue:
  • #PlacementMode: local-only وstandard وmanaged-serverless
  • #PlacementSupport: بيانات أهلية لكل وحدة (أي الأوضاع التي يمكن للوحدة العمل فيها)
تحقق دورة الحياة مفتوحة المصدر local-only وstandard. أما managed-serverless فهو بيانات أهلية فقط؛ وتحقيقه خارج StackKits وخارج هذه المواصفة.

​
4. أدلة التحقق

كلمات النضج مدعومة بالأدلة ولا تُعلن أبدًا. أشكال الأدلة هي مخططات JSON عامة؛ ويشحن الإصدار النسخ الفعلية. المفردات:
  • الأطقم: supported (يوجد مسار تحقق مستشهَد به للخلية المثبتة)، وpreview (يُثبَّت، لكن أدلة التحقق أو الاسترداد معلّقة)، وalpha (تعريف فقط).
  • صفوف التوافق (أنظمة التشغيل ومنصات المحاكاة والأطقم حسب البيئة والتطبيقات): supported (اجتازت كل مراحل دورة الحياة في أحدث تشغيل على إصدار الأدلة)، وpreview (اجتاز التثبيت حتى verify؛ وفشلت مرحلة لاحقة) أو unverified (لا يوجد تشغيل مكتمل على ذلك الإصدار بعد، أو فشل أحدث تشغيل قبل verify). يُنشر غياب الدليل بوصفه unverified، لا دعمًا أبدًا.
  • لا تتسع الحالة إلا عند وجود تشغيل مستشهَد به للإصدار المحدد نفسه.

​
5. المطابقة

تكون الأداة أو الخدمة متوافقة مع StackKit عندما
  1. تستهلك لقطة المعمارية للإصدار المحدد الذي تستهدفه،
  2. تدير الأطقم فقط عبر أفعال دورة الحياة أعلاه (مباشرةً أو عبر موصّل MCP) وتحفظ أدلتها،
  3. تصف التوزيع بالتصنيف المنشور، و
  4. تنشر نتائج التحقق بأشكال الأدلة أعلاه مع وسم الإصدار الذي تنتمي إليه.

​
الحالة

هذه مسودة v0 نُشرت مع النسخة التجريبية العامة. يتبع ذلك مستودع مواصفات منفصل مع سياسة إصدارات بعد النسخة التجريبية؛ وإلى ذلك الحين يكون مستند المستودع والملفات المرتبطة به هي المواصفة.