# QA Review Flow

## الهدف

فلو ثابت لمراجعة تذاكر مشروع `whatsapp` فقط، project id `286`.

الدور QA فقط: لا تعديل كود، لا نشر verification/analysis، لا إغلاق تذاكر. المسموح على المنصة: قراءة، comment، reopen فقط.

## بداية كل جلسة

1. اقرأ `QA_MEMORY.md`.
2. اقرأ manual المنصة: `GET /api/agent/manual`.
3. أكد المشروع: `GET /api/projects` وتأكد أن `whatsapp` هو id `286`.
4. تأكد أن بيئة Codex سليمة:
   - shell commands تعمل.
   - الصور تفتح بـ `view_image`.
   - لو ظهر `bwrap` راجع `CODEX_ENVIRONMENT_NOTES.md`.

## اختيار التذاكر

راجع فقط التذاكر المسلمة:

- `closed`
- `client_review`

لا تراجع `new`, `analysis`, `awaiting_client`, `in_implementation` إلا كقراءة فقط لو المستخدم طلب.

## مراجعة تذكرة واحدة

1. افتح التذكرة كاملة:
   - `GET /api/issues/{ref}`
2. اقرأ التايملاين بالكامل:
   - submission
   - client answers
   - analysis
   - verification
   - attachments
3. افحص كل المرفقات:
   - الصور: افتحها بـ `view_image`.
   - المستندات: استخدم `text_url`.
4. استخرج المطلوب الحقيقي من كلام العميل والمرفقات، وليس من عنوان التذكرة فقط.
5. اقرأ ما تم تسليمه في verification وحدد الملفات/الأسطر المذكورة.
6. راجع الكود الحقيقي:
   - افتح الملفات المعنية.
   - تأكد أن الشرط/المنطق موجود فعلاً.
   - راجع أن الواجهة تستخدم الـAPI المصحح.
7. شغل اختبارات مناسبة:
   - `php -l` للملفات المعدلة PHP.
   - فحص routes/endpoints.
   - UI visual check لو التذكرة فيها واجهة أو صورة.
8. القرار:
   - سليمة: لا تعمل أي action على التذكرة، فقط سجل في الذاكرة والملخص.
   - مكسورة بدليل: `POST /api/issues/{ref}/reopen` مع دليل محدد.
   - غير مؤكدة وتحتاج معلومة: `POST /api/issues/{ref}/comment`.

## صيغة دليل reopen

لا تفتح التذكرة إلا بدليل حقيقي:

- ملف وسطر.
- خطوات إعادة إنتاج.
- مرفق يثبت أن المطلوب غير منفذ.
- API response خطأ.

## بعد كل مراجعة

حدث `QA_MEMORY.md` بأعلى الملف:

- التاريخ.
- ref.
- الحكم.
- المطلوب الحقيقي من المرفقات.
- الملفات والأسطر التي تم فحصها.
- الاختبارات التي اشتغلت.
- النسخة والكوميت لو متاح.

## ملخص الجولة

اعرض جدول:

`ref | العنوان | الحكم | الدليل باختصار`

ثم الإجمالي:

- كام سليمة.
- كام اترجعت.
- كام عليها تعليق/انتباه.