الاعتمادات
سجلات اليوم حسب مرحلة الاعتماد
العمل الإضافي
طلبات العمل الإضافي تمر بالمدير المباشر ثم الموارد البشرية
قائمة الموظفين وإعدادات الدوام
التعديل يُحفظ مباشرة. المدير المباشر إلزامي لكل موظف، ويعتمد سجلاته قبل الموارد البشرية.
المدراء المباشرون
كل موظف يتبع مديراً مباشراً. عند حذف مدير تختار مديراً آخر ينتقل إليه فريقه.
المراقبون ومصدر الصورة
حدد لكل مراقب: الكاميرا فقط، أو الاستديو فقط، أو الاثنين.
الإدارات
حسابات الدخول
كل حساب مرتبط بشخص ودور. الدور يحدد الصفحات التي يراها والبيانات التي يصل إليها.
صلاحيات كل دور
فعّل أو أوقف أي صلاحية لأي دور. التغيير يسري فوراً على كل المستخدمين الذين يحملون هذا الدور.
نطاق البيانات لكل دور
تحديد موظفي كل مدير مباشر
اختر المدير، ثم انقل الموظفين بين القائمتين. الموظف المنقول للفريق تبدأ دورته من هذا المدير.
فريق المدير
موظفون خارج الفريق
تحديد موظفي كل مراقب
الموظف في مجموعة مراقب يصبح «يُحضَّر عن طريق مراقب»، ولا يستطيع تسجيل حضوره بنفسه.
مجموعة المراقب
موظفون خارج المجموعة
الأماكن المحظورة على الموظف
إذا كان الموظف داخل أي نطاق محظور، يرفض النظام تسجيل حضوره أو انصرافه ويوضح السبب.
مواقع محظورة على الجميع
تُطبَّق على كل الموظفين إضافة إلى قائمة كل موظف
محاولات مرفوضة بسبب المكان
آخر المحاولات التي منعها النظام
طلبات بانتظار اعتمادك
بعد اعتمادك تنتقل إلى الموارد البشرية للاعتماد النهائي
مواقع فريقك الآن
مواقع الحضور الميداني المعتمدة لفريقك
العمل الإضافي لفريقك
ما يرفعه الموظف أو المراقب يصلك أولاً ثم يذهب للموارد البشرية، وما تسجّله أنت يذهب للموارد البشرية مباشرة
إعارة ونقل موظفيك بين المراقبين
طلبات المراقبين تصلك للموافقة، وتستطيع نقل موظفيك بين المراقبين مباشرة
فريقك
تشاهد موظفيك المباشرين فقط
الموظفون التابعون لك
العمل الإضافي لمجموعتك
ترفعه أنت، فيذهب إلى المدير المباشر للموظف، ثم الموارد البشرية
إعارة ونقل الموظفين
هوية المؤسسة
الاسم والشعار يظهران في صفحة الدخول والقائمة الجانبية وعنوان المتصفح وملفات التصدير، لكل المستخدمين
يفضّل شعار مربع بخلفية شفافة (PNG). يُصغَّر تلقائياً إلى 256 بكسل.
إعدادات النظام
ساعات الدوام وبدايته تُضبط لكل موظف من البيانات الأساسية
المستخدمون حسب الدور
سجل التدقيق
كل إجراء يُحفظ مع المستخدم والوقت
معمارية الخدمات المصغّرة
يدخل كل طلب عبر بوابة API تتحقق من رمز JWT ومن صلاحية الدور. تسجيل الحضور يتطلب إحداثيات من الجهاز وصورة، ويمر على فحص الأماكن المحظورة قبل القبول، ثم ينشر حدثاً تستهلكه خدمة الاعتماد والاحتساب والإشعارات.
flowchart LR
subgraph C["العملاء — ويب متجاوب"]
EP["بوابة الموظف"]
SP["بوابة المراقب"]
WD["لوحات الإدارة"]
end
GW["API Gateway
JWT · RBAC · Rate Limit"]
subgraph S["Microservices"]
AU["Identity & Auth
المستخدمون والأدوار"]
OR["Org & Schedules
الهيكل وأوقات الدوام"]
AT["Attendance
الحضور والانصراف"]
PH["Photo Service"]
GE["Location & Zones
الموقع والأماكن المحظورة"]
WF["Approval Workflow
مدير مباشر ← HR"]
TC["Time Engine"]
RP["Reports & Export"]
NO["Notifications"]
AD["Audit Log"]
end
BUS[["Event Bus"]]
subgraph D["البيانات"]
PG[("PostgreSQL + PostGIS")]
RD[("Redis")]
OB[("Object Storage")]
end
EP --> GW
SP --> GW
WD --> GW
GW --> AU & OR & AT & WF & RP
AT --> PH --> OB
AT --> GE
AT -- "AttendanceSubmitted" --> BUS
BUS --> WF & TC & NO & AD
WF -- "StepApproved" --> BUS
AT & WF & TC & OR & RP & GE --> PG
AU --> RD
مخطط العلاقات
ملف SQL الكامل يحتوي هذه الجداول مع القيود والفهارس والدوال. الأماكن المحظورة مرتبطة بالموظف، وهناك نوع عام يُطبَّق على الجميع.
erDiagram
DEPARTMENTS ||--o{ EMPLOYEES : contains
EMPLOYEES ||--o{ EMPLOYEES : manages
EMPLOYEES ||--o| USERS : has_account
ROLES ||--o{ USERS : assigned
ROLES ||--o{ ROLE_PERMISSIONS : grants
PERMISSIONS ||--o{ ROLE_PERMISSIONS : in
EMPLOYEES ||--o| SUPERVISORS : is
SUPERVISORS ||--o{ SUPERVISOR_ASSIGNMENTS : covers
EMPLOYEES ||--o{ SUPERVISOR_ASSIGNMENTS : covered_by
EMPLOYEES ||--o{ EMPLOYEE_SCHEDULES : follows
BLOCKED_ZONES ||--o{ EMPLOYEE_BLOCKED_ZONES : applied_to
EMPLOYEES ||--o{ EMPLOYEE_BLOCKED_ZONES : blocked_from
EMPLOYEES ||--o{ ATTENDANCE_RECORDS : owns
ATTENDANCE_RECORDS ||--|{ ATTENDANCE_EVENTS : has
ATTENDANCE_EVENTS ||--|| ATTENDANCE_PHOTOS : captures
ATTENDANCE_RECORDS ||--o| APPROVAL_REQUESTS : requires
APPROVAL_REQUESTS ||--|{ APPROVAL_STEPS : flows
EMPLOYEES ||--o{ ATTENDANCE_BLOCKS : attempted
BLOCKED_ZONES ||--o{ ATTENDANCE_BLOCKS : caused
APPROVAL_STEPS {
uuid id PK
uuid request_id FK
int step_order
enum approver_role
uuid approver_id FK
enum decision
text comment
timestamptz decided_at
}
BLOCKED_ZONES {
uuid id PK
string name
enum scope
geography center
int radius_m
text reason
bool is_active
}
رحلة تسجيل الحضور
ثلاث بوابات قبل القبول: إذن الموقع، ثم الأماكن المحظورة، ثم الصورة.
flowchart TD
A["الضغط على تسجيل حضور"] --> B["قراءة موقع الحضور الميداني"]
B --> C{"إذن الموقع مسموح؟"}
C -- "لا" --> X1["إيقاف التسجيل
عرض خطوات التفعيل"]
C -- "نعم" --> Z{"الموقع داخل مكان محظور؟"}
Z -- "نعم" --> X2["رفض التسجيل
تسجيل المحاولة وإشعار الإدارة"]
Z -- "لا" --> F["فتح الكاميرا"]
F --> G{"من يسجّل؟"}
G -- "الموظف" --> H["كاميرا فقط"]
G -- "المراقب" --> I["حسب إعداده"]
H --> J["وصف المهمة"]
I --> J
J --> K["إرسال مع وقت الخادم"]
K --> L["بدء دورة الاعتماد"]
دورة الاعتماد
كل موظف له مدير مباشر إلزامي يعتمد سجله أولاً، ثم الموارد البشرية للاعتماد النهائي.
flowchart TD S1["الموظف يسجّل نفسه"] --> DM S2["المراقب يسجّل للموظف"] --> DM DM["المدير المباشر"] -- "اعتماد" --> HR["الموارد البشرية"] HR -- "اعتماد نهائي" --> OK["معتمد"] DM -- "رفض" --> XX["مرفوض"] HR -- "رفض" --> XX DM -- "طلب تعديل" --> BK["يعود لمن سجّل"] HR -- "طلب تعديل" --> BK BK --> DM
دورة اعتماد العمل الإضافي
من يرفع الطلب يحدد أول مرحلة. الموظف يسجّل بعد انتهاء دوامه بجلسة موقع وصورة، أو يطلب يدوياً لعمل سابق.
flowchart TD E1["الموظف: بدء وإنهاء الإضافي
بالموقع والصورة"] --> DM E2["الموظف: طلب يدوي"] --> DM SV["المراقب يسجّل لمجموعته"] --> DM DM["المدير المباشر"] -- "اعتماد" --> HR["الموارد البشرية"] MG["المدير المباشر يسجّل لفريقه"] --> HR HR -- "اعتماد نهائي" --> OK["إضافي معتمد"] HRR["الموارد البشرية تسجّل"] --> OK DM -- "طلب تعديل" --> BK["يعود لمن رفعه"] HR -- "طلب تعديل" --> BK BK -- "تعديل وإعادة إرسال" --> DM
قواعد الاحتساب
أسماء الجداول والحقول
هذه هي جداول ملف smart_field_attendance.sql المرفق. كل الجداول تحتوي created_at و updated_at، والحذف منطقي عبر deleted_at.
مصفوفة الصلاحيات
هذه المصفوفة تعكس الإعدادات الحالية في صفحة الصلاحيات، وتتغير معها.
خارطة التحسينات
مرتبة حسب الأثر على موثوقية الحضور