توفير مشروع جديد

كل ارتباط عميل جديد يُهيّأ بنفس الطريقة — نفس قالب الـ repo، ونفس الـ pipelines، ونفس الـ branch policies، ونفس البيئات. هذه الصفحة هي قائمة التحقق. الإعدادات الفعلية تعيش في Azure DevOps وفي قالب الـ repo؛ وهذا هو الترتيب الذي تُطبَّق به.

مسار التوفير

flowchart TD
  A["Create ADO project + team"] --> B["Create repos from template"]
  B --> C["Wire pipelines from template"]
  C --> D["Apply branch policies"]
  D --> E["Create environments + approvals"]
  E --> F["Open comms channel"]
  F --> G["Grant access by role"]
  G --> H["Seed AGENTS.md + runbook stub"]
  H --> I["Ready — first sprint can start"]

قائمة التحقق

#	الخطوة	كيف يبدو الإنجاز الصحيح
1	project و team في ADO	project واحد لكل ارتباط عميل. إنشاء الـ team الافتراضي. تهيئة الـ area/iteration paths حسب اللوحات.
2	الـ repos	backend‏ (.NET)، وfrontend‏ (Angular + PrimeNG)، وmobile‏ (Android/iOS) حسب الحاجة — كل واحد يُنشأ ومعه ملفات اليوم الأول أدناه، ولا repo فارغ أبدًا.
3	الـ pipelines	pipeline للـ PR يُشغّل كل بوابة مانعة، وpipeline للـ CD يبني مرة واحدة ويروِّج الـ artifact.
4	الـ branch policies	حماية main: build validation، وreviewer واحد على الأقل، وwork item مرتبط، ومنع الـ push المباشر. حسب الـ Branching والـ PRs.
5	البيئات والموافقات	dev تنشر تلقائيًا عند الـ merge إلى main، وqa عند نجاح deploy الـ dev؛ أمّا uat وprod فتشترطان موافقة. أربعة أسماء ولا مرادفات. والأسرار في variable groups مربوطة بـ Key Vault، لا في الـ repo أبدًا.
6	قناة التواصل	قناة واحدة للعميل وقناة داخلية للتسليم. الـ PM‏ (Firas Alhawasli) يملك الـ cadence.
7	منح الوصول حسب الدور	أقل صلاحية ممكنة حسب الدور — contributors على الـ repos، وapprovers على الـ environments. بيانات اعتماد التسليم تبقى داخلية حتى حدث الـ handover.
8	زرع AGENTS.md و runbook مبدئي	إضافة AGENTS.md وقالب runbook مبدئي في كل repo. انظر سياق وكلاء الـ AI.

اليوم الأول، داخل الـ repo

الـ repo لا يُعدّ مُجهَّزًا حتى توجد هذه الملفات:

.editorconfig · .gitattributes · .gitignore · Directory.Build.props · Directory.Packages.props · global.json · azure-pipelines/pr.yml + cd.yml · مشروع اختبار موصول بـ pipeline الـ PR · README.md يجعل المطوّر الجديد قادرًا على التشغيل · AGENTS.md · docs/adr/README.md · docs/runbook.md

الستة الأولى هي أساس الـ .NET؛ وrepo الـ Angular يستبدلها بـ eslint.config.js و.prettierrc وكتلة الـ budgets. وإذا نقص الـ repo أحد هذه الملفات فهو ليس مُجهَّزًا — وهي قائمة يستطيع إنسان أو وكيل التحقّق منها في دقيقة.

الاصطلاحات

• لا شيء فارغ أبدًا. الـ repo الجديد يبدأ بملفات اليوم الأول أعلاه، حتى يكون الـ linting والـ CI والبنية متطابقة بين كل العملاء.
• الـ linter هو المعيار. قواعد الكود تُشحن كـ config مُلتزَم به ومُفعَّل في الـ CI — لا شيء هنا يُضبط يدويًا.
• الـ ADRs والـ runbooks وAGENTS.md تعيش في الـ repo، لا في الـ wiki. هذه الصفحة تصف ترتيب التهيئة فقط.

نصيحة

التوفير يتم مرة واحدة لكل ارتباط ويجب أن يستغرق بعد ظهر يوم، لا أسبوعًا. وإذا احتاجت خطوة قرارًا (بيئات إضافية، أو release/x.x مُصان)، فسجّله كـ ADR في الـ repo.

تنبيه

لا تمنح العميل الوصول إلى بيانات اعتماد الـ production أو إلى بيئة النشر قبل استيفاء شروط الـ handover. وحدّ الـ Warranty يُعرّف ما هي تلك الشروط وبأي ترتيب.