الموارد البشرية والحضور

موارد HRM للمستأجر تحت /v1/businesses/{business_id}/hrm-* ومجموعة تنقل HRM في البوابة. إدارة المنصة لا تتضمن لوحة HRM في هذا الإصدار.

أجهزة ZKTeco

تُستطلَع الأجهزة بواسطة worker تدبير عبر TCP (المنفذ الافتراضي 4370). يجب أن يكون الجهاز قابلاً للوصول من شبكة worker (IP عام أو VPN أو نفق عكسي).

الإجراء	الغرض
اختبار الاتصال	الاتصال ومصافحة بروtocol الجهاز
مزامنة الآن	إدراج استطلاع فوري
استطلاع مجدول	كل بضع دقائق للأجهزة poll_enabled

اربط معرّف مستخدم الجهاز (zk_user_id) لكل موظف بمعرّف PIN/الشارة على الطرفية. تُتخطى المعرفات غير المعروفة وتُسجَّل في last_error للجهاز. كلمات مرور الأجهزة مشفّرة في التخزين ومُقنّعة في استجابات الواجهة البرمجية.

الرواتب والمكافآت والسلف

تدفقات الحالة (v1 لا يرحّل الرواتب تلقائياً إلى GL):

المورد	الإجراءات
دورات الرواتب	generate، approve، mark-paid، cancel
المكافآت	approve، mark-paid، cancel
السلف	approve، mark-paid، repay، cancel

generate يبني البنود من الموظفين النشطين: الراتب الأساسي + المكافآت المعتمدة في الفترة − أرصدة السلف المفتوحة. وضع علامة مدفوع على الدورة يطبّق خصومات السلف على الأرصدة المتبقية.

ذات صلة

• شرح مفصّل في المستودع: docs/hrm.md
• سجل التغييرات