API — المجموعات والإعارة

الغرض

إدارة المجموعات (مجموعات العمال، واحدة افتراضية لكل قسم) وقواعد إعارة المجموعات الاتجاهية التي تسمح بالاستعارة عبر المجموعات وقت التخصيص.

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

المجموعات — القاعدة /api/pools · قراءة pool.read، كتابة pool.write (SYS_ADMIN + HR_ADMIN + MANAGER).
قواعد إعارة المجموعات — القاعدة /api/pool-lending-rules · قراءة pool_lending_rule.read، كتابة pool_lending_rule.write (الحاملون أنفسهم).

انظر مصفوفة RBAC.

نقاط النهاية

Pools — /api/pools

Method	Path	Purpose	Gate
GET / POST	`/api/pools`	سرد / إنشاء مجموعات	read / write
GET / PATCH / DELETE	`/api/pools/{id}`	قراءة / تحديث / حذف مجموعة	read / write

Pool-lending rules — /api/pool-lending-rules

Method	Path	Purpose	Gate
GET / POST	`/api/pool-lending-rules`	سرد / إنشاء قواعد إعارة	read / write
GET / PATCH / DELETE	`/api/pool-lending-rules/{id}`	قراءة / تحديث / حذف قاعدة	read / write

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

قاعدة الإعارة اتجاهية (المجموعة المصدر ← المجموعة الهدف). تُفرَض الأهلية عبر المجموعات وقت التخصيص بواسطة CrossPoolEligibilityRule (سلوك وقت تشغيل LIVE، الورقة 22)، وليس مجرد تهيئة. ProblemDetails القياسي.

المزالق

الإعارة عبر المجموعات مفروضة وقت التشغيل، وليست مخزَّنة فقط — إذ تشكّل من هو المؤهَّل أثناء جولة التخصيص (الورقة 12 / 22).
سقف MaxConcurrentBorrows، وسير عمل اعتماد، ودفتر إعارة، كلها مخططة (PLANNED) — تقرر القاعدة الأهلية؛ ولا يوجد بعدُ سقف لعدد الاستعارات ولا سلسلة اعتماد (الورقة 22).
يُحسب سبب حظر مرشَّح بقواعد العبر المجموعات على جانب الخادم لكنه غير مُبرَز في الواجهة (جزء من F8) — انظر الجداول وجولات التخصيص لمكان وجود بيانات السبب.
المجموعة الافتراضية لكل قسم ثابتة — كل قسم له مجموعة افتراضية.