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