المرحلة: ملف الموظف

للمسؤولين

ملف الموظف: أفراد المنظمة على وظائفهم ومع مديريهم. يملكه نظام ERP عادةً ويعكسه جديرون، بينما تعود التعيينات التي تجري في جديرون في الاتجاه المعاكس.

الموارد

الموردالواجهة البرمجيةالصفحات
الموظفونإنشاء وقراءة وتعديل وDELETE (= إنهاء الخدمة)، وأرشفة، وإنشاء أو تعديل بالمعرّف الخارجي، وإدراج مجمّعالموظفون

المسار المعتاد

  1. حمّل القوى العاملة مرة واحدة بالإدراج المجمّع (انظر الترحيل المجمّع).
  2. أرسل التغييرات بـ PUT /api/v1/employees/by-external/{system}/{externalId}: التعيينات الجديدة في ERP، والتنقلات (currentPosition)، وتغيير المدير (manager).
  3. أنهِ خدمة المغادرين بـ DELETE /api/v1/employees/{id}: يبقى السجل بالحالة FORMER_EMPLOYEE وتتلقى employee.offboarded.
  4. اشترك في employee.* لتتلقى التعيينات التي تجري في جديرون (employee.created) وتغييرات الملف التي يجريها الموظفون بأنفسهم.

قواعد تستحق المعرفة

  • لا تحذف الواجهة البرمجية أي شخص نهائيًا أبدًا؛ أرشفه بـ POST /api/v1/employees/{id}/archive.
  • الراتب ليس جزءًا من كائن الموظف.
  • الوظيفة المكتملة السعة ترفض موظفًا إضافيًا (409 conflict، position_full).