وثائق بوابة القرار

تقييم بوابة حتمي وقابل لإعادة التشغيل مع قرارات قابلة للتدقيق.

وثائق Asset Core

تنسيقات تأليف بوابة القرار

قرار بوابة القرار يقبل إدخال تأليف ScenarioSpec بصيغة JSON أو RON. JSON هو التنسيق القياسي المستخدم للتجزئة، والمخططات، وحزم التشغيل. RON موجود فقط كطبقة تأليف صديقة للبشر ويجب تحويله إلى JSON القياسي قبل التنفيذ.

JSON القياسي

  • يستخدم JSON القياسي RFC 8785 (JCS) لترتيب حتمي.
  • يتم حساب تجزئة ScenarioSpec على بايتات JSON القياسية.
  • يتم إصدار JSON القياسي بواسطة decision-gate authoring normalize.

المدخلات المدعومة

  • JSON: تنسيق قياسي للتخزين، التجزئة، والتحقق.
  • RON: تنسيق مؤلف فقط تم تطبيعه إلى JSON القياسي.
  • YAML: غير مدعوم بشكل افتراضي (يضاف فقط عند الحاجة الصريحة).

خط أنابيب التطبيع

  1. تحليل JSON أو RON إلى قيمة منظمة.
  2. تحقق من صحة schemas/scenario.schema.json.
  3. تشغيل التحقق الدلالي لـ ScenarioSpec (المعرفات، الشروط، البوابات).
  4. تحويل إلى JSON (RFC 8785).
  5. احسب تجزئة المواصفة الكانونية.

الحدود

  • الحد الأقصى لحجم إدخال التأليف: 16777216 بايت.
  • عمق التعشيش الأقصى: 64.

استخدام واجهة سطر الأوامر

تحقق من إدخال تأليف RON:

decision-gate authoring validate --input examples/scenario.ron --format ron

قم بتطبيع إلى JSON القياسي:

decision-gate authoring normalize --input examples/scenario.ron --format ron \
  --output examples/scenario.json

المراجع

  • examples/scenario.ron: مثال تأليف في RON.
  • examples/scenario.json: مخرجات JSON القياسية.
  • schemas/scenario.schema.json: مخطط JSON لـ ScenarioSpec.