المساهمة

ما هي

كيفية الإضافة إلى ManpowerIQ دون كسر الأشياء التي يوثّقها هذا الدليل. يعيش الجوهر في قسم الاصطلاحات؛ هذه الصفحة هي نقطة الدخول وتدفّق المساهمة.

اقرأ الاصطلاح ذا الصلة أولًا. هل تضيف CRUD لقائمة بحث؟ → قالب Lookup CRUD. هل تُعيد خطأ نطاق؟ → الاستثناءات. هل تُعيد استخدام/تستخرج مساعدًا؟ → فهرس المساعدات + انضباط §G. هل تضيف رسالة مترجمة؟ → مفاتيح BE i18n.
حاكِ كيانًا موجودًا بدلًا من اختراع شكل — فالاصطلاحات هي "انسخ آخر واحد يناسب"، لا إطار عمل.
تحقّق من حالة البناء بصدق — إن كنت تلمس شيئًا موسومًا بـ PARTIAL/PLANNED، فأبقِ الحالة دقيقة.

اعمل في مرحلة. تتبع التغييرات الجوهرية انضباط التدقيق-أولًا: ابنِ مرحلة، دقّقها (البناء أخضر، القرارات مسجّلة، الانحدارات مفحوصة، قائمة "لا-تفترض")، ثم تقدّم. لا تتخطَّ البوابة.
الترحيلات — أضف ترحيل EF لأي تغيير في المخطط؛ تذكّر أن إعادة الضبط هي إسقاط + إعادة إنشاء، ويجب أن تتحمّل عبارات INSERT للزرع ذلك (PB-025). طبّق بـ dotnet ef database update — لا يوجد ترحيل-عند-الإقلاع.
i18n — أضف مفاتيح resx (en + ar بالتوازي) وملفّي FE en.json/ar.json بالتكافؤ.
الاختبارات — اتبع أنماط الاختبار: ملكية try/finally لحجب FK، حرّاس تبديل-المحتوى للّغة AR، واختبار [Collection("PostgresIntegration")] لأي تجميع (InMemory ≠ Npgsql).
شغّل البناء أخضر — dotnet build، وجولات الاختبار، و(للتوثيق) mkdocs build.

لا يفرض المشروع اصطلاح التزام ثقيلًا؛ الأعراف الخفيفة المرصودة في التاريخ:

فرع لكل ميزة/تذكرة، مُسمّى باسم العمل (مثل MIQ-NNN أو PB-NNN الذي يُنفّذه).
رسائل الالتزام تصف الماذا + اللماذا باختصار؛ تُسجَّل المشاركة في التأليف بذيل Co-Authored-By: حيث ينطبق.

(هذه ملاحظة خفيفة بالتصميم — لم يكن هناك معيار التزام/فرع موثّق رسميًا لإعادة إنتاجه؛ عامِلها كممارسة مرصودة، لا تكليفًا.)

لا توسّع شكلًا مشتركًا مقفلًا ليناسب حالة جديدة — أبقِه ضمنيًا (انضباط §G).
لا تُحوّر صفوف النظام ولا تفترض أن كتابة غير مُدقّقة قد دُقّقت (التدقيق انتقائي).
لا تدّعِ قدرة طموحة في تعليقات الشيفرة أو التوثيق — أبقِ الحالة صادقة (القاعدة التي يتبعها هذا الدليل بأكمله).
ما قبل الإنتاج: نفّذ تنظيف التشخيصات (F9 / PB-114) قبل أي نشر حقيقي.