دليل المطوّر — نظرة عامة
هذا الدليل هو المنظور الهندسي لـ ManpowerIQ: كيف بُني النظام ولماذا. وهو مكتوب للمطوّرين المنضمّين إلى قاعدة الشيفرة، والمراجعين، وكل من يحتاج إلى الوثوق بالتوثيق بما يكفي لتغيير الشيفرة الكامنة وراءه.
وهو رفيق دليل المطوّر لـ دليل المستخدم: فحيث يشرح دليل المستخدم ماذا يفعل المنتج، يشرح هذا كيف نُفِّذ — البنية، ونموذج الوصول، واصطلاحات إضافة الميزة التالية.
القاعدة الوحيدة التي يتبعها هذا الدليل
كل ادّعاء معماري هنا مُتحقَّق منه مقابل الشيفرة، لا مقابل العرض التسويقي. تصف وثائق تصميم ManpowerIQ ومواد التسليم حزمة تقنية طموحة — MediatR/CQRS، ومهام في الخلفية مجدولة، وOpenTelemetry، وSSO، ورموز التحديث. عدد منها غير موصول. يذكر هذا الدليل حالة بناء كل مكوّن بأمانة:
- Available — مُسلَّم ومُنفَّذ في المنتج.
- Partial — مُسلَّم بنطاق مُخفَّض؛ تذكر الصفحة بدقة أين تقع الحافة.
- Planned — مُصمَّم أو مُهيكَل، لكن لم يُبنَ. مُوثَّق على أنه غائب، وليس أبدًا على أنه بنية قيد الاستخدام.
حيث تطرح صفحة ادّعاءً غير بديهي، فإنها تتتبّع إلى قاعدة الحقائق للمرحلة Phase-0 (المصدر المُتحقَّق منه file.cs:line لكل نظام فرعي). أوراق الحقائق هي مصدر الحقيقة؛ وحيث تتعارض وثائق التصميم الأقدم مع الشيفرة، تفوز الشيفرة.
ما هو فعلاً في الحزمة التقنية
توجيه أمين سريع قبل صفحات التفصيل — تحقّقت الأحكام في 2026-06-10 مقابل لقطة نموذج EF والمصدر:
| المكوّن | الحالة | سطر واحد |
|---|---|---|
| Clean Architecture (Domain / Application / Infrastructure / API) | Available | طبقي، قائم على الخدمات — لا CQRS/MediatR |
| EF Core 8 + Npgsql / PostgreSQL | Available | snake-case، الهجرات هي مصدر الحقيقة للمخطط |
| تعدّد المستأجرين (مرشحات الاستعلام + ختم الكتابة + Postgres RLS) | Available | ثلاث طبقات عزل مستقلة |
| RBAC (متمحور حول الصلاحيات) | Available | 97 صلاحية × 9 أدوار، مُنفَّذة في وقت التشغيل |
| مصادقة JWT (اسم مستخدم/كلمة مرور + بديل التطوير + الإغلاق) | Available | رمز وصول لمدة 8 ساعات فقط |
| رموز تحديث JWT | Planned | غير مُنفَّذ — إعادة تسجيل دخول عند الانتهاء |
| SSO / Active Directory | Planned | غير مبني |
| تسجيل Serilog المُهيكَل | Available | موصول في Program.cs |
| OpenTelemetry / التتبّع الموزّع | Planned | غير موجود |
| i18n (BE resx + FE i18next + RTL + أعمدة ثنائية اللغة) | Available | إنجليزي/عربي من طرف إلى طرف |
| المهام في الخلفية (Hangfire) | Partial | مهمة استيراد إطلاق-ونسيان فقط؛ لا مهام مجدولة/متكررة |
| تطبيق الجوّال | Planned | هيكل Expo (شاشة فحص الصحة)؛ المنتج الحقيقي هو تطبيق الويب المتجاوب |
كيف نُظِّم هذا الدليل
Architecture — الصفحات البنيوية:
- نظرة عامة على البنية — الحزمة التقنية وكيف تتلاءم الطبقات معًا.
- تخطيط الحل — المشاريع واتجاه اعتماديتها.
- Clean Architecture — قاعدة التطبيق الطبقي (ولماذا لا يوجد MediatR).
- تعدّد المستأجرين — طبقات العزل الثلاث.
- المصادقة وRBAC — تسجيل الدخول، والرموز، وإنفاذ الصلاحيات.
- التدقيق والحذف الناعم — نموذج التدقيق ونمط الحذف الناعم.
- التدويل — إنجليزي/عربي عبر الواجهة الخلفية والأمامية.
- المهام في الخلفية — ما يشغّله Hangfire فعلاً (وما لا يشغّله).
- مصفوفة RBAC — المرجع القانوني 9 أدوار × 97 صلاحية.
Conventions — أنماط "كيف تبني الشيء التالي" — تأتي بعد صفحات البنية.
ذات صلة
- دليل المستخدم — نظرة عامة
- الأدوار والصلاحيات — العرض المُوجَّه للمستخدم لـ RBAC.