📌 Study.ai System — Action Plan Updated

خطة تنفيذ Study.ai — النسخة التنفيذية المحدثة

تحديث شامل لخطة MVP الأصلية بعد إنجاز مراحل إضافية مهمة: موقع تعريفي، بوابة عميل Premium، نظام التسليم والمراجعات، الإشعارات، بيانات Demo احترافية، وActivity Timeline. مع تثبيت WhatsApp + AI Intake كمدخل رئيسي مؤجل لآخر التنفيذ.

آخر تحديث: 26 أبريل 2026 الحالة: V1 SaaS-ready تقريبًا النموذج: Managed Service / Broker Model AI-assisted وليس AI-autonomous WhatsApp + AI Intake: مؤجل لآخر التنفيذ

1) الملخص التنفيذي الحالي

Executive Snapshot

Core Backend

✅

Request → Quote → Order → Delivery شغال end-to-end.

Admin UI

✅

Dashboard + Requests + Pricing + Quotes + Orders + Governance.

Client Portal

✅

رحلة عميل كاملة مع عرض نهائي وتتبّع وتسليم ومراجعات.

Public Website

✅

Landing + Services + How It Works باللغتين.

الوضع الحالي للنظام

Intake

←

Request

←

Hidden Pricing

←

Final Offer

←

Order

←

Delivery

←

Revision / Approval

العميل يرى عرضًا نهائيًا واحدًا فقط، بينما يبقى التسعير الداخلي والموردون والتفاصيل التشغيلية مخفية.

2) الخطة الأصلية كما اعتمدناها

17 أسبوع / 425 ساعة تقريبًا

المرحلة	المدة الأصلية	الهدف	الحالة الحالية
Phase 1	10 أسابيع	Core Backend + Workflow	تم
Phase 2	3 أسابيع	Admin UI	تم
Phase 3	4 أسابيع	Client UI	تم + توسع

3) ما تم إنجازه فعليًا

Actual Completed Scope

Phase 1 — Core System Completed

تم بناء النظام الأساسي: Workflow engine، State Machine، Requests، Pricing Requests/Responses، Client Quotes، Orders، Deliveries، Localization، Swagger/OpenAPI، وطبقة Audit/RBAC الأساسية.

Phase 2 — Admin UI Completed

تم تنفيذ لوحة الإدارة: Dashboard، Requests List/Details، Orders List/Tracking، Pricing View، Quotes List/Details، Audit Logs، Localization Tools، Permissions/RBAC Overview، 404 Admin shell، وFinal Admin UI polish.

Phase 3 — Client Portal Completed

تم تنفيذ بوابة العميل: Dashboard، إنشاء طلب، My Requests، Request Details، Final Offer، Quote Accept/Reject، Order Tracking، Delivery Review، وربط كامل باللغتين.

Phase 4 — UX Transformation Completed

تحويل تجربة العميل من جداول وشاشات إدارية إلى رحلة عميل: Cards، Journey view، Next Action، Final Offer highlight، Order Tracking، Delivery Success.

Phase 5 — Public Website Integration Completed

تم إضافة موقع تعريفي عام: Home، Services، How It Works، لغة عربي/إنجليزي، CTA إلى بوابة العميل وإنشاء الطلب.

Phase 6/7 — SaaS Feel + Premium UI Completed

تحسين الشكل العام ليشبه SaaS حديث: Design tokens، Hero gradients، Trust strips، Cards، Microcopy، Motion، Quote decision page، وClient shell منفصل عن Admin.

Phase 8 — Delivery + Revisions Completed

تم تحويل التسليم من عرض فقط إلى مراجعة تفاعلية: ملفات، Feedback، طلب تعديل، اعتماد نهائي، Timeline للتعليقات، منع تكرار طلب التعديل من الواجهة.

Notifications + Activity Timeline Completed

تم إنشاء نظام إشعارات queued + database، bell dropdown، read/unread، anti-spam، transition-aware notifications، وتجميع Activity Timeline على مستوى الطلب.

4) المراحل الإضافية بعد الخطة الأصلية

Scope evolved بعد Phase 3

المرحلة	الهدف	النتيجة	الحالة
Phase 4	Client UX Transformation	تحويل البوابة إلى رحلة عميل guided journey	تم
Phase 5	Public Website + Integration	موقع تعريفي متصل ببوابة العميل	تم
Phase 6	Microcopy + Conversion	Next Action، رسائل إنسانية، CTA hierarchy	تم
Phase 7	Premium UI	Design system وواجهة أقرب لـ Stripe/Linear	تم
Phase 8	Delivery/Revisions System	Feedback، Revision Requests، Approval	تم
Phase 9	Notifications	In-app + Email queued notifications	تم
Phase 10	Activity Timeline	تجميع أحداث الطلب في Story واحدة	تم أوليًا

5) المعمارية الحالية للنظام

Current Architecture

Public Website

طبقة تسويقية/تعريفية مستقلة عن Admin، تعرض الخدمات وطريقة العمل وتوجه المستخدم إلى إنشاء طلب أو دخول بوابة العميل.

Client Portal

بوابة عميل Journey-based: إنشاء طلب، متابعة الحالة، مراجعة العرض النهائي، قبول/رفض، تتبع التنفيذ، مراجعة التسليم، طلب تعديل أو اعتماد.

Admin Panel

لوحة تشغيل وإدارة داخلية لمتابعة الطلبات والتسعير والعروض والأوامر والحوكمة والصلاحيات والسجلات.

Notification Layer

إشعارات transition-aware مع منع التكرار، وتفريق مصادر الأحداث: Observers للأحداث النظامية وControllers لأفعال العميل.

WhatsApp + AI Intake Layer

المدخل الرئيسي المستقبلي للنظام: استقبال العميل عبر WhatsApp، فهم الرسالة، استخراج البيانات، وفتح Draft Request للمراجعة البشرية. مؤجل عمدًا لآخر التنفيذ.

قاعدة سيادية: العميل لا يرى الموردين أو التسعير الداخلي أو الهامش. العميل يرى عرضًا نهائيًا واحدًا فقط: السعر، مدة التنفيذ، الشروط.

6) بيانات Demo وQA

Professional Seed Pack

سيناريوهات مغطاة في Seeder

Public ID	السيناريو	الغرض من الاختبار
`req_demo_new_no_quote`	طلب جديد بدون عرض	اختبار No Offer state
`req_demo_quote_sent`	عرض مرسل	اختبار قبول/رفض العرض
`qt_demo_sent`	عرض قابل للقبول	1,250 SAR + 4 أيام عمل
`ord_demo_in_progress`	أمر قيد التنفيذ	اختبار Order Tracking
`dlv_demo_awaiting_review`	تسليم بانتظار المراجعة	تعليق/طلب تعديل/اعتماد
`req_demo_completed`	طلب مكتمل	اعتماد نهائي وتاريخ كامل

أوامر QA الأساسية

php artisan migrate php artisan db:seed --class=StudyAiDemoSeeder php artisan view:clear php artisan cache:clear php artisan test php artisan l5-swagger:generate

7) WhatsApp + AI Intake Layer — مؤجل لآخر التنفيذ

Main Entry Point / Deferred Track

قرار تنفيذي: هذا الجزء هو المدخل الرئيسي المستقبلي للنظام، لكنه ليس ضمن التنفيذ الحالي. سيتم تعليقه كمرحلة أخيرة بعد استقرار الـ Core Workflow، بوابة العميل، التسليمات، الإشعارات، والـ QA.

مكانه الصحيح في رحلة النظام

WhatsApp / Website Form← AI Intake Assistant← Human Review← Draft Request← Workflow

الهدف أن يبدأ العميل من محادثة طبيعية، ثم يقوم AI بتحويلها إلى بيانات منظمة قابلة للمراجعة، وبعد اعتماد بشري تدخل الطلبات في نفس مسار النظام الحالي.

لماذا مؤجل؟

لأن WhatsApp + AI Intake يمكنه فتح Scope كبير جدًا: ربط مزود WhatsApp، إدارة Sessions، فهم نواقص الطلب، أمان البيانات، ورسائل Follow-up. لذلك الأفضل تنفيذه بعد إغلاق تجربة النظام الأساسية بالكامل.

المكوّن	الوصف	الحالة
WhatsApp Entry	استقبال رسائل العميل من WhatsApp Business / Provider API وربطها بالعميل أو Lead.	Deferred
AI Intake Assistant	تحليل رسالة العميل، تحديد نوع الخدمة، استخراج المتطلبات، وتلخيص الطلب عربي/إنجليزي.	Deferred
Missing Info Loop	سؤال العميل تلقائيًا عن النواقص: عدد الكلمات، الموعد، نوع الخدمة، الملفات، اللغة، متطلبات النشر.	Deferred
Draft Request	إنشاء طلب مبدئي غير نهائي ينتظر مراجعة بشرية قبل دخوله الـ workflow.	Deferred
Human Review Gate	مراجعة بشرية إلزامية قبل اعتماد الطلب أو التسعير أو إرسال أي عرض.	Deferred
Conversation Audit	حفظ ملخص المحادثة وقرارات التحويل والرسائل المهمة في سجل قابل للمراجعة.	Deferred

حدود AI السيادية: الذكاء الاصطناعي يساعد في الفهم والتنظيم وطلب النواقص وإنشاء Draft Request فقط. لا يحدد السعر النهائي، لا يعتمد التنفيذ، ولا يرسل عرضًا رسميًا بدون مراجعة بشرية.

8) ما تبقى قبل Production حقيقي

Production Gaps

البند	الأولوية	الوصف	الحالة
Auth حقيقي	عالية	استبدال demo customer بتسجيل دخول/تسجيل حساب وربط العملاء الحقيقيين.	Next
File Storage	عالية	استخدام S3 أو Storage production مع روابط آمنة للملفات والتسليمات.	Next
Queue Worker	عالية	تشغيل queue worker للإيميلات والإشعارات في بيئة الإنتاج.	Next
Email Domain	متوسطة	تهيئة SMTP/domain sender وtemplates للإيميلات.	Pending
Payment	متوسطة	Stripe أو بوابة دفع محلية بعد قبول العرض.	Pending
Premium Timeline	منخفضة	أيقونات وألوان وdiffForHumans للـ Activity Timeline.	Polish
WhatsApp + AI Intake	مرحلة أخيرة	مدخل النظام الرئيسي عبر WhatsApp مع AI assistant وHuman review gate.	Deferred to Last

9) ملاحظات الانتقال لجهاز جديد

Git + Local Setup

Git Status

آخر Push تم بنجاح إلى GitHub على branch master، وآخر commit ظاهر:

793144c → master

ملف References/Phase 1 Completion Checklist.docx غير متتبع ولا يؤثر على الكود.

تشغيل على جهاز جديد

git clone https://github.com/mhoter/study-ai-system.git cd study-ai-system/backend composer install cp .env.example .env php artisan key:generate php artisan migrate php artisan db:seed --class=StudyAiDemoSeeder

تنبيه: تأكد من ضبط QUEUE_CONNECTION=database وتشغيل queue worker في الإنتاج حتى تعمل الإيميلات والإشعارات بشكل غير متزامن.

10) Definition of Done المحدثة

V1 Closure Criteria

Functional

العميل يرسل طلب، يستلم عرضًا نهائيًا، يقبل، يتابع التنفيذ، يراجع التسليم، يطلب تعديل أو يعتمد.

Operational

الإدارة تتابع الطلبات والعروض والأوامر والسجلات والصلاحيات وتفهم حالة كل شيء.

Commercial

النظام يعرض نموذج Managed Service واضح قابل للبيع، وليس Marketplace.

Deferred Entry Layer

تم تثبيت WhatsApp + AI Intake كمدخل رئيسي مستقبلي للنظام، لكنه مؤجل إلى آخر التنفيذ حتى لا يفتح Scope جديد قبل استقرار الـ V1.