نظرة عامة
خلال تدريبي في إدارة تنمية الموارد البشرية بالمؤسسة الوطنية للنفط، كانت طلبات نقل الموظفين وإعارتهم وتكليفهم تتنقّل على الورق وبين جداول بيانات متفرقة. لم يكن أحد يستطيع الإجابة بسرعة عن سؤال بسيط: أين هذا الطلب الآن، وعند من ينتظر؟ فصمّمت وبنيت نظام إدارة سير عمل يجمع كل طلب وكل خطوة اعتماد وكل مستند داعم في مكان واحد.
المشكلة
- لا يوجد مصدر واحد موثوق للبيانات. بيانات الطلبات موزّعة على ملفات منفصلة، فقد يظهر الموظف نفسه بشكل مختلف في مكانين.
- حالة الاعتماد غير مرئية. متابعة أي طلب كانت تعني الاتصال هاتفياً بالإدارة التالية في السلسلة.
- المستندات منفصلة عن الطلبات. الأوراق الداعمة تُؤرشف بعيداً عن القرار الذي تبرّره.
- التقارير تُعدّ يدوياً. كل ملخص للإدارة كان يُجمع من جديد يدوياً من الجداول الخام.
دورة حياة الطلب
01تقديم الطلبيُنشأ طلب النقل أو الإعارة أو التكليف مرتبطاً بسجل الموظف، مع تحديد الإدارة المُرسِلة والمستقبِلة من البداية.
02إرفاق المستنداتتُرفق المستندات الداعمة بالطلب نفسه، فلا تنفصل الأوراق عن القرار أبداً.
03سلسلة الاعتماديمرّ الطلب عبر خطوات الاعتماد المحدّدة، ويُسجَّل كل قرار: من اتخذه، وما هو، ومتى.
04متابعة الحالةلكل طلب حالة محدّثة باستمرار، فيرى أي شخص مخوّل المرحلة الحالية دون أي مكالمة هاتفية.
05التقاريرتغذّي الطلبات المكتملة والجارية لوحات المعلومات المستخدمة في التقارير واتخاذ القرار.
ما الذي بنيته
محرك سير العمل
حالات الطلب ومسارات الاعتماد مُصمَّمة بشكل صريح، فلا يتحرك الطلب إلا في المسارات التي يسمح بها الإجراء فعلاً.
إدارة المستندات
الملفات الداعمة مرفقة مباشرة بكل طلب، فيبقى المبرّر الكامل متاحاً مع السجل.
جودة البيانات
تنظيف السجلات الموجودة والتحقق منها وتحليلها لتحسين جودة البيانات واتساقها وموثوقيتها.
لوحات التقارير
إعادة تنظيم عرض البيانات وتسهيل استخدامها لتقرأ الإدارة وضع عمليات الموارد البشرية بنظرة واحدة.
البنية
تتواصل واجهة ويب بـ React مع خادم ASP.NET Core عبر REST/JSON مع مصادقة JWT. ويتبع الخادم Clean Architecture: الاعتماديات تتجه نحو الداخل، فلا تعتمد قواعد العمل مباشرة على قاعدة البيانات أو HTTP أو البريد.
APIنقطة الدخولالمتحكّمات، والمصادقة، وCORS، ووسيط واحد يحوّل كل استثناء إلى استجابة API موحّدة.
APPحالات الاستخدامالخدمات، وكائنات DTO، ومدقّقات FluentValidation. تستدعي المتحكّمات الخدمات عبر واجهات ولا تتعامل مع EF Core مباشرة.
DOMالمجالالكيانات وقواعد العمل، خالية من أي تفاصيل تقنية.
PERالحفظEF Core مع SQL Server، ومستودعات، ووحدة عمل، وMigrations، وبيانات أولية.
INFالبنية التحتيةتفاصيل خارجية قابلة للاستبدال: إصدار JWT، والمستخدم الحالي، وتخزين الملفات، والبريد.
سير عمل يفرضه الخادم
تُسجَّل كل مرحلة من مراحل الطلب بإحدى الحالات: انتظار، أو حالية، أو مكتملة، أو مرفوضة. والقواعد موجودة في الخادم، فتبقى سارية حتى لو أُرسل طلب من خارج الواجهة:
- لا ينتقل الطلب إلا من مرحلته الحالية إلى التالية مباشرة — لا تخطّي ولا رجوع.
- مراحل القرار وحدها يمكنها الرفض، ولا يُغلق الطلب إلا في مرحلته الأخيرة.
- لا يمكن تعديل الطلب المؤرشف أو المرفوض مرة أخرى.
- تحفظ كل مرحلة وقت بدايتها ونهايتها، فتعرض الواجهة مدة كل مرحلة والعمر الكلي للطلب.
التقنيات
الخادم
ASP.NET Core 10، C#، EF Core 10 مع Migrations، FluentValidation، Mapster.
الواجهة
React 19، TypeScript، Vite، React Router — واجهة عربية بالكامل من اليمين لليسار ومتجاوبة.
الأمان
رموز JWT، وتشفير كلمات المرور بـ BCrypt، والتحقق من كل المدخلات في الخادم.
الملفات والبريد
مرفقات حتى 10 MB من قائمة أنواع مستندات وصور مسموحة، تُخزَّن خارج قاعدة البيانات؛ وMailKit للإشعارات.
تفاصيل الموثوقية
سجل تدقيق
كل إجراء على طلب أو مرفق يُسجَّل مع المستخدم والوقت وعنوان IP.
البريد لا يعطّل العمل
الإشعارات بأفضل جهد: إذا فشل الإرسال بعد الحفظ، يبقى الطلب محدّثاً ويُسجَّل الخطأ.
التاريخ محمي
العلاقات المهمة لا تحذف بالتتابع، فلا يمكن أن يمحو حذف سجل ما التاريخ بصمت.
الوقت بتوقيت UTC
كل الأوقات تُنشأ بتوقيت UTC وتُحوَّل للتوقيت المحلي عند العرض فقط.
ما الذي تعلّمته
الجانب التقني كان الجزء الأصغر. العمل الأصعب كان فهم كيف تتنقّل طلبات النقل والإعارة فعلياً بين الإدارات في مؤسسة كبيرة، ثم تمثيل ذلك بدقة في البرنامج — بما في ذلك الاستثناءات التي كان الموظفون يتعاملون معها بشكل غير رسمي. وكانت أيضاً أول مرة أبني فيها شيئاً يجب أن يتكيّف مع ثقافة إدارية قائمة بدلاً من أن يستبدلها.
ملاحظة: بُني هذا النظام للاستخدام الداخلي في المؤسسة الوطنية للنفط. الكود المصدري والبيانات سرّية، لذلك لا يتوفر مستودع أو عرض مباشر — تصف هذه الصفحة التصميم والمشكلة التي حلّها.