docs: record local Flutter web debug run

This commit is contained in:
Hamza Ayed
2026-10-04 15:53:08 +03:00
parent 435259e6c4
commit c31828b1ea
+1
View File
@@ -214,6 +214,7 @@
- [x] إصلاح بدء نافذة Windows Debug (2026-10-04): كان `main()` ينتظر تهيئة الإشعارات قبل `runApp()`، فيمكن أن تبقى نافذة Flutter مخفية إذا تعثر plugin الإشعارات. صار `runApp()` يسبق التهيئة وتعمل الإشعارات بالخلفية مع تسجيل الخطأ. بعد بناء 74.5 ثانية بدأت العملية PID 11484 بنافذة Windows فعلية بعنوان `Mithqal AI` ومقبض نافذة غير صفري، وكانت مستجيبة؛ أعاد `/health` على 8000 و8100 HTTP 200 مع Gemma4 E2B وSQLite والوكيل. اجتازت اختبارات Flutter السبعة وتحليل Flutter. التهيئة الفاشلة قد تعطل الإشعارات وحدها ولا توقف الواجهة.
- [x] اختبار قراءة مشروع فعلي عبر الوكيل (2026-10-04): أُنشئت جلسة API محلية مؤقتة، ثم استُخدم `/v1/agent/run` على مساحة `SovereignAI-Starter` مع الملف المحدد `start-api.ps1` ومهارة «شرح الكود». أعاد الوكيل `tool=local-llm` و`model=gemma4:e2b` واستشهد باسم الملف، وذكر قيمة `LOCAL_MODEL` الافتراضية الصحيحة؛ أُلغيت الجلسة بعد الطلب ولم تتغير ملفات المشروع.
- [x] اختبار حي لدورة تسجيل المشروع وقراءته على API 8000 (2026-10-04): أُنشئ مشروع تجريبي داخل `tmp/`، وسُجل عبر `/v1/agent/projects` (201)، وأظهر `/v1/agent/workspace/files` الملف `README.md`. قرأ وكيل Gemma 4 الملف المحدد بمهارة `code_explain` وأعاد رمز التحقق `WORKSPACE_SENTINEL_AR_582` حرفيًا خلال 25.3 ثانية. بعده أُلغي تسجيل المشروع، وانتهت جلسة المصادقة، وحُذف مجلد الاختبار؛ `git status` لا يعرض ملفات اختبار متبقية. هذا يثبت تكامل API والتخزين/القراءة فقط؛ لا يحل محل اختبار اختيار المجلد من نافذة Flutter.
- [x] تشغيل Flutter Web Debug من المصدر الحالي على `127.0.0.1:5301` بـ`flutter run -d web-server`: الصفحة ترد HTTP 200، والخادم ما زال يعمل؛ فُتحت الصفحة في لوحة Codex للمعاينة. حاولت أداة المتصفح فشلًا مرتين بمهلة قبل تفاعل DOM، لذا لم أختبر الأزرار أو تدفق المشروع بصريًا؛ هذا تحقق تشغيل للويب فقط ولا ينجز اختبار Windows ولا اختبار التفاعل.
## ترتيب التنفيذ القادم