---
name: production-readiness-audit
description: تدقيق جاهزية البرودكشن / go-live readiness review لمشروع من مشاريع سهيل — فحص READ-ONLY بيبني نسبة جاهزية بمنهجية معلنة + جدول فجوات مرتّب P0/P1/P2 بأعمدة (الناقص/الحالة/المسؤول/التأثير/الوقت) + قايمة إطلاق بأوامر حقيقية + قايمة "مستني من العميل" + مخاطر + قرارات. Use when Sohail says «اعمل تدقيق جاهزية برودكشن لـX», «المشروع جاهز للإطلاق؟», «قولي ناقص إيه قبل ما ننزل», "production readiness", "go-live checklist", "audit X for launch", or hands a repo + a live URL and asks for a launch verdict. NOT a functional test run and NOT a fix pass.
---

# 🛫 Production readiness audit (تدقيق جاهزية البرودكشن)

**المنتج = تقرير واحد فيه نسبة + جدول فجوات مرتّب + قايمة إطلاق.** مش تقرير QA، مش إصلاح، مش نشر.
أنا بفتش وأقول «إيه اللي ناقص ومن مين» — الإصلاح بعده بقرار (`software-factory` الظاهر في T3).

**Trigger:** «تدقيق جاهزية برودكشن لـX» · «المشروع جاهز للإطلاق؟» · «قولي ناقص إيه قبل ما ننزل» ·
"production readiness" · "go-live checklist" · أو تسليم ريبو + لينك حيّ وسؤال «هننزل امتى».

## 0. العقد: read-only — ده أولاً

- **ممنوع** تعديل كود، ممنوع تعديل/إقفال إيشوز أو PRs، ممنوع أي كتابة على Cloudflare أو D1.
- **GET/HEAD على الداتا الحقيقية مسموح**؛ أي **POST بيسجّل طلب/دفعة/سجل في قاعدة الإنتاج ممنوع** —
  جرّبه لحد خطوة قبل التسجيل بس، واكتب صراحة «مااختبرتش X لأنه كان هيكتب في D1 الإنتاج».
  (مثال حقيقي: زرار «أكمل على واتساب» مكسر واتصال على إنتاج → اتخطيته وقولت كده.)
- لو المستخدم سمّح صراحةً بتعديل (قيد في الطلب نفسه) فده استثناء ويتجسّس في التقرير.
- **ما تلمسش الـworktree/اللوپ** لو فيه شغل تاني شغّال — خلّي التدقيق في `~/workspace/reports/<slug>-*`.

## 1. سُلّم الدليل (وإنت بتبص بنفسك)

كل ادعاء في التقرير لازم يبقى مربوط بمصدر **شفته في نفس الجولة**:

| الطبقة | الأداة | إيه اللي بياخده |
|---|---|---|
| كود ساكن | `read_file` / `search_files` / `git log` | الراوتات، الصفحات، الدوال، الميزات، الإعدادات |
| بنية حيّة | wrangler / gh / vault | السيرفرات، الأسرار (أسماء بس)، الدومين، الـmigrations |
| سلوك حيّ | Playwright / `curl` | HTTP status، نص الصفحة، أخطاء الكونسول، فلو فعلي |
| بصري | `vision_analyze` | التصميم، الـRTL، السكرينشوتات |

**«خلص/مكتمل» = فتحته وشوفته.** لو مافيش دليل، اكتب «ماتأكدتش لأن…» بدل ✅.

## 2. الست جولات (بالترتيب)

1. **جرد الريبو:** الفرع + `git log origin/<branch>` آخر كوميت + شجرة الملفات + جرد الميزات **حسب
   المحاور** (واجهة · متجر/أوردرز · أدمن · سياسات · SEO · أداء · موثوقية) — مش قائمة مسطحة.
2. **Cloudflare Pages:** المشروع، **ـprovenance للنشر** (أي كوميت الـpreview/الإنتاج بيشغّله فعلًا)،
   الدومينات المرتبطة، **أسماء** الأسرار فقط (`wrangler pages secret list`) مقابل متغيرات البناء،
   والـenv المطلوب من الكود. التفاصيل: `references/cloudflare-pages-infra-audit.md`.
3. **D1 البعيد:** المخطط الحقيقي مقابل ملفات الـmigrations (صفاً بصف)، عدّادات الداتا، وأي drift.
4. **E2E حيّ:** مسح كل الراوتات (status + طول النص + أخطاء الكونسول + `pageerror` + طلبات فاشلة)
   على ديسكتوب **وموبايل**، ثم **فلو واحد حرج** (أضف للسلة → عبّئ → دفع) لحد ما يفشل فعلاً.
5. **فحص بصري:** اقرأ الصور مباشرة بأداة عرض الصور على الرئيسية/المنتج/السلة/الأدمن — «RTL سليم؟ عناصر مقطوعة؟».
6. **التجميع:** نسبة + جدول فجوات + قايمة إطلاق.

## 3. رقمين مش رقم واحد — والمنهجية مكتوبة

- **جاهزية الميزات** = (مكتمل + ٠٫٥×جزئي) ÷ إجمالي البنود. **اظهر الأعداد نفسها** (مثلاً
  «40 مكتمل ✅ · 9 جزئي ⚠️ · 11 ناقص ❌ من 60 بند = 74%») — نسبة بلا مسطر = كلام.
- **حكم الإطلاق الفعلي:** اعرض البلوكرز والأدلة على كل منها، واذكر هل تمنع أول طلب حقيقي. لا تفرض نسبة إطلاق بلا منهجية وحساب.

## 4. جدول الفجوات — الأعمدة بالحرف

اجمعه في **P0 (بلوكرز) / P1 (مهم قبل الإطلاق) / P2 (تحسينات)**، وكل صف خمس خانات:

| # | الناقص | الحالة | المسؤول | التأثير لو نزلناه كده | وقت تقديري |

- **«المسؤول» عمود حاسم:** قسّمه بين **إحنا** (شغلنا، فيه وقت تقديري) · **العميل/الداتا**
  (مش شغلنا — يروح في القسم ٥) · **قرار** (محتاج سهيل، مش تنفيذ).
- **«الوقت التقديري» لأي صف شغلنا بس.** متحطّش وقت جنب حاجة مستني داتا.

## 5. قسم مستقل: «الحاجات اللي محتاجة داتا من العميل»

دايماً بند منفصل **قبل** قايمة الإطلاق وبرقم العناصر (١..١٠ مثلاً)، مكتوب بلغة العميل مش بلغة
كود («الأسعار الحقيقية»، «رقم الواتساب الرسمي»، «الدومين الرسمي»، «حساب Paymob»).
**السبب العملي:** العميل بيقرا القايمة دي ويجيب الداتا — لو مزجناها مع شغلنا، محدش يعرف يبدأ.

## 6. قايمة الإطلاق (Go-Live Checklist)

- قائمة تأشيرات `[ ]` كل بند **أمر نسخ/لصق حقيقي** بالأسماء الحقيقية للمشروع
  (`wrangler d1 execute … --file=migrations/0003_….sql`، أسماء الأسرار المطلوبة بالحرف).
- **طريقة الأمان قبل أي migration:** `wrangler d1 export --remote --output=backup-YYYYMMDD.sql`
  أول سطر، دايمًا.
- آخر بند دايمًا **«اختبار شراء حقيقي بعد الإطلاق»** — لأن الاختبار قبل الإطلاق بيئة تجريبية.

## 7. المخاطر + قرارات سهيل

- **الثغرات/الموثوقية:** دايمًا على الأقل: rate limiter متذبذب لو in-memory، غياب backup،
  غياب monitoring/error tracking، غياب CI، صفحة خطأ (Error Boundary).
- **جدول «قرارات مطلوبة من سهيل»:** أسئلة قرار صريحة (شحن؟ COD؟ دومين؟ أداة تحليلات؟ ميعاد إطلاق؟)
  — كل سؤال فيه **نصيحتنا**. **ماتسألهش أسئلة تنفيذية**؛ دي قرارات هو بس اللي ياخدها.

## 8. التسليم

- عربي كامل، والرد يبدأ بحرف عربي، والمخرجات في `~/workspace/reports/<slug>.md` + `.pdf`.
- بنية التقرير بالحرف (النسبة، الجداول، الأقسام التسعة): `references/readiness-report-structure.md`.
- الرد في الشات **قصير** (سطر عنوان + أهم بلوكر + لينك الملف) — التفاصيل كلها جوه التقرير
  (`arabic-report-deliverables` §1b).

## 9. فخاخ

- **🔴 الـpreview اللي فتحته ممكن يكون قديم.** اقرأ الـprovenance من `wrangler pages deployments
  list` — على مشروع حقيقي، آخر نشر كان كوميت PR #30 بتاريخ ١٣ أكتوبر بينما الفرع وصل PR #40،
  يعني الـpreview **مش بيشغّل** إصلاحات الأمان والثيم المدموجة. **قولها في التقرير** وإلا هتقيم
  كود منشور وهو مش منشور.
- **🔴 «مفيش migration على البعيد» ≠ «الجدول ناقص».** افصل الملفات عن المخطط: اقرأ
  `pragma table_info` من الـremote نفسه. جدول ممكن موجود من migration تاني/قديم وعمود واحد بس ناقص
  (مثال: `products` موجودة و`stock` ناقصة). المطابقة بـPRAGMA صفاً بصف هي الدليل، مش عدّ الملفات.
- **🔴 كلها 200 ومع ذلك مش جاهز.** نجاح الراوتات يعني «الصفحة اتفتحت» بس — مش إن فيه سعر، مش إن
  الدفع شغال. لازم فلو حرج واحد على الأقل يوصل لخطوته الحقيقية الفاشلة.
- **.relative `og:image` في الـHTML الثابت:** الكرايلرز اللي بتشتغل من غير JS (واتساب/تيليجرام)
  مش هتشوفها — افحص `index.html` مش الـSPA.
- **الخطوط العربية في PDF:** التحقق بصري إجباري بعد التوليد (شوف `arabic-report-deliverables` §5).
- **اختبار التحقق:** سكربتات الـQA اللي كتبتها هم نفسهم متغيّرات → راجعهم بـ`ad-hoc-verification`.

## 10. الأصناف المرتبطة

- **تشغيل وظيفي عميق** (seed، مسح API كامل، اشتراء حقيقي): `fullstack-functional-qa` — التدقيق
  بيستخدم مسح راوتات أخف منه، ولو السؤال «التطبيق بيشتغل صح؟» روحله هو.
- **بنية D1 والنشر:** `cloudflare-d1-ops` · `preview-deployments`.
- **بنية التقرير العربي وإخراجه PDF/PNG:** `arabic-report-deliverables`.
- **التحقق من سكربتات التحقق:** `ad-hoc-verification`.
