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

API — التقارير

الغرض

التقارير التشغيلية: تقريرا الجدول اليومي والشهري، وتقرير تباين التسوية، ومقياس الاستغلال — كلٌّ بصيغة JSON إضافةً، لتقريري الجدول/التباين، إلى تصديرات .xlsx و.pdf.

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

  • تقارير الجدول — القاعدة /api/reports · roster.view.
  • التباين والاستغلال — reconciliation.view.

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

نقاط النهاية

Method Path Purpose Gate
GET /api/reports/daily-roster (+ .xlsx, .pdf) تقرير الجدول اليومي roster.view
GET /api/reports/monthly-roster (+ .xlsx, .pdf) تقرير الجدول الشهري roster.view
GET /api/reports/variance (+ .xlsx, .pdf) تقرير تباين التسوية reconciliation.view
GET /api/reports/utilization مقياس الاستغلال reconciliation.view

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

يُصيَّر تقريرا الجدول اليومي/الشهري + التباين بصيغة JSON مع متغيري .xlsx (تصدير) و.pdf (QuestPDF، مدرك للـ RTL). ProblemDetails القياسي.

المزالق

  • الاستغلال والمساواة بصيغة JSON فقط — لا متغير تصدير، ولا رسوم بيانية (الورقة 17). بطاقات لوحة المعلومات أعداد، لا تصوّرات مرئية.
  • لا مكتبة رسوم بيانية في أي مكان في المنتج — التقارير جدولية JSON / جدول بيانات / PDF (الورقة 17).
  • تصديرات PDF مدركة للـ RTL (العربية) — تعيد استخدام نمط مُصدِّر PDF للجدول اليومي.

حالة البناء

جزئية — تقريرا الجدول اليومي/الشهري + تقارير التسوية (JSON + xlsx + pdf) وبطاقات لوحة معلومات المدير حيّة (LIVE)؛ والاستغلال/المساواة بصيغة JSON فقط؛ لا رسوم بيانية (الورقة 17).

ذات صلة