API — الحضور
الغرض
سجلات الحضور وعرضها، وأسطح التحرير/الاستيراد/المراجعة الإدارية، والتسوية (التباين بين المخطط والفعلي).
المصادقة والأدوار
| Area | Base | Gate |
|---|---|---|
| Attendance (view) | /api/attendance, /api/me/attendance |
attendance.view.all / .scoped / .own |
| Edit | /api/admin/attendance/{id} |
attendance.edit |
| Import | /api/admin/attendance/import |
attendance.import |
| Review | /api/admin/attendance/pending-reviews |
attendance.review |
| Reconciliation | /api/admin/reconciliation |
reconciliation.view / reconciliation.validate |
انظر مصفوفة RBAC — لاحظ أن HR_DIRECTOR/COO يحملان نطاق استيراد/تحرير/مراجعة الحضور.
نقاط النهاية
View — /api/attendance (+ /api/me/attendance)
| Method | Path | Purpose | Gate |
|---|---|---|---|
| GET | /api/attendance/all |
كل السجلات | attendance.view.all |
| GET | /api/attendance/scoped |
سجلات على نطاق | attendance.view.scoped |
| GET | /api/attendance/{id} · /{id}/audit |
السجل + أثر تدقيقه | attendance.view.all |
| GET | /api/me/attendance |
الحضور الخاص | attendance.view.own |
Edit / import / review — /api/admin/attendance
| Method | Path | Purpose | Gate |
|---|---|---|---|
| PUT | /api/admin/attendance/{id} |
تحرير سجل إداريًا | attendance.edit |
| POST | /api/admin/attendance/import/preview · /commit |
استيراد Excel (معاينة ← تثبيت) | attendance.import |
| GET | /api/admin/attendance/template |
قالب الاستيراد | attendance.import |
| GET | /api/admin/attendance/pending-reviews (+ /count) |
طابور المراجعة | attendance.review |
| POST | /api/admin/attendance/pending-reviews/{id}/acknowledge · /revert |
إقرار / إرجاع تحرير | attendance.review |
Reconciliation — /api/admin/reconciliation
| Method | Path | Purpose | Gate |
|---|---|---|---|
| GET | /api/admin/reconciliation/exceptions (+ /pending-count) |
طابور الاستثناءات | reconciliation.view |
| POST | /api/admin/reconciliation/exceptions/validate |
التحقق من استثناء | reconciliation.validate |
| GET | /api/admin/reconciliation/variance |
بيانات تقرير التباين | reconciliation.view |
الأشكال والأخطاء
الحضور مصدره Excel — استيراد معاينة/تثبيت، وتحرير إداري مع إرجاع المدير، وجداول التسوية (الورقة 13). ProblemDetails القياسي.
المزالق
- لا تغذية أجهزة/تسجيل بصمة. تأتي الأوقات من استيراد Excel، لا من بوابات دوّارة أو أجهزة قياس حيوي (الورقة 13). لا توثّق تكاملًا حقيقيًا لتسجيل البصمة في الوقت الفعلي.
Time_Outعبر منتصف الليل مرفوض (نتيجة الطور 3 C2) — الوردية المنتهية بعد منتصف الليل تحتاج معالجة خارج مسار الاستيراد البسيط.- التحريرات قابلة للمراجعة — يُنشئ التحرير الإداري مراجعة معلّقة يمكن للمدير إرجاعها؛ ويسجّل أثر
…/{id}/auditالتغيير.
ذات صلة
- تسجيل الحضور (مهمة) · عرض لوحة المعلومات والتقارير (مهمة)
- التقارير — تصدير تقرير التباين.
- Swagger:
/swagger· ورقة الحقائق 13 (الحضور والفعليات).