انتقل إلى المحتوى

API — قواعد التخصيص

الغرض

تهيئة محرك القواعد للتخصيص: مجموعات القواعد، والقواعد داخلها، ونطاقاتها، وكتالوج أنواع القواعد. هذا سطح تهيئة المحرك؛ أما تشغيل المحرك فعلى الجداول وجولات التخصيص.

المصادقة والأدوار

القاعدة /api/allocation/rules · الصنف [Authorize]. تقيّد القراءات على allocation_rule.read؛ وكل الكتابات تقيّد على allocation_rule.write — SYS_ADMIN + HR_ADMIN فقط (يستطيع PLANNER تشغيل المحرك لكن لا يمكنه تحرير مجموعات القواعد؛ انظر مصفوفة RBAC).

نقاط النهاية

Rule sets

Method Path Purpose Gate
GET / POST /api/allocation/rules/sets سرد / إنشاء مجموعات قواعد read / write
GET / PUT / DELETE /api/allocation/rules/sets/{id} قراءة / تحديث / حذف مجموعة read / write
PATCH /api/allocation/rules/sets/{id}/reorder إعادة ترتيب القواعد في مجموعة write
POST /api/allocation/rules/sets/{id}/rules إضافة قاعدة إلى مجموعة write
POST /api/allocation/rules/sets/{id}/set-default تعيين المجموعة كافتراضية write

Rules & scopes

Method Path Purpose Gate
PUT / DELETE /api/allocation/rules/{id} تحديث / حذف قاعدة write
GET / POST /api/allocation/rules/{ruleId}/scope قراءة / إضافة نطاق قاعدة read / write
DELETE /api/allocation/rules/scope/{scopeId} إزالة نطاق write

Rule-type catalog

Method Path Purpose Gate
GET / POST /api/allocation/rules/types سرد / إضافة أنواع قواعد read / write

الأشكال والأخطاء

تحزم مجموعة القواعد قواعد من أنواع الكتالوج (7 صارمة + 7 مرنة — كلها LIVE، الورقة 07)؛ وتحمل القواعد نطاقات تضيّق أين تنطبق. الـ handler_class_name في الكتالوج للعرض فقط — يجري التوزيع حسب RuleTypeCode، لا حسب سلسلة الكتالوج. ProblemDetails القياسي؛ وحذف آخر قاعدة صارمة حرجة من نوعها محظور (400 CRITICAL_HARD_RULE_REQUIRED — انظر نمط التعايش).

المزالق

  • allocation_rule.write لـ SYS_ADMIN + HR_ADMIN فقط — أشيع افتراض خاطئ في RBAC. PLANNER يُشغّل، لا يُحرّر.
  • كل القواعد الـ 14 حيّة — المحرك غير مُكعّب (يعكس ادعاء تسليم قديم، عنوان فهرس 00 #1). فقط NoOpAllocationRule المخصص للاختبار هو كعب.
  • handler_class_name في الكتالوج تجميلي — لا تعتمد عليه في السلوك.
  • القواعد الصارمة الحرجة محمية — لا يمكنك حذف آخر واحدة من نوع.

ذات صلة