12 · PLAN خطة التنفيذ

خطة التنفيذ: من التوثيق للإطلاق

التنفيذ ماشي على 9 مراحل (من 0 لـ 8)، كل مرحلة بتخلص بحاجة شغالة فعلاً على السيرفر التجريبي — مش ورق. الترتيب معمول عشان فريق الموقع يبدأ يشتغل على بيانات حقيقية بدري، والطلبات (قلب الشغل) تشتغل قبل البضاعة الداخلة ونقطة البيع. المدد تقديرية لمطور باك إند واحد، وبتتأكد بعد ردود الأسئلة العاجلة في صفحة 11.

≈ ٢٥ أسبوع (تقديري)9 مراحل + أسبوع توثيقسيرفر تجريبي من الأسبوع 3 بيانات حقيقية من الأسبوع 612 ملف توثيق قبل الكودنقل بيانات بتجربتين

الخطة في سطور

نفس الترتيب اللي بنمشي بيه في كل مشروع: الأساس ← الدخول ← الكتالوج ← الطلبات ← … ← التقوية والإطلاق — ومتظبط على شغل فلوكة.

≈ ٢٥

أسبوع تقديري للكل (بين 22 و26 حسب الردود)

أسابيع لحد أول نشر تجريبي فريق الموقع يشتغل عليه

١١

أسبوع لحد ما دورة الطلب كاملة تشتغل (من الموقع للتسليم والمرتجع)

٨٤

صفحة في اللوحة، كل واحدة بتتفعّل في مرحلتها

🧭

ليه الترتيب ده؟

الكتالوج والمخازن الأول عشان كل حاجة بعدها بتقرا منهم، وعشان نقل البيانات يحصل بدري. الطلبات بعدها مباشرة لأنها أكبر وجع دلوقتي وأكبر قيمة. البضاعة الداخلة والجملة والتسويق بعد ما الأساس ثابت.

🛍️

فريق الموقع مايستناش

من آخر الأسبوع 3: الدخول والإعدادات العامة. من آخر الأسبوع 6: الكتالوج ببيانات حقيقية. من نص المرحلة 2: السلة والطلب. كل ده بعقد مكتوب وopenapi.json قبل التنفيذ.

⚠️

«تقديري» يعني إيه

المدد مبنية على النطاق اللي في العرض ده والافتراضات اللي في صفحة 11. لو رد العميل غيّر حاجة كبيرة (محفظة، دفع إلكتروني، ربط شركات شحن) المدة بتتحدث في القسم 05.

الجدول الزمني (تقديري)

كل عمود = أسبوع. الخطوط الكاملة = شغل الباك إند، والمتقطعة = شغل موازي (نقل البيانات، تكامل فريق الموقع، تجربة العميل، التدريب). المعيّن = محطة تسليم.

الأسبوع ←

12345678910111213141516171819202122232425

التوثيق والموافقاتdocs 00–11

توثيق

0 · الأساس2 أسبوع

الأساس

1 · الكتالوج والمخازن3 أسابيع

الكتالوج والمخازن

2 · الطلبات5 أسابيع

الطلبات والتجهيز والشحن والمرتجعات

3 · البضاعة الداخلة3 أسابيع

الداخلة والجودة

4 · الجملة2 أسبوع

الجملة

5 · التسويق3 أسابيع

العروض والولاء والصور

6 · التقارير والمالية2 أسبوع

التقارير

7 · الفروع ونقطة البيع2 أسبوع

نقطة البيع

8 · التقوية والإطلاق2 أسبوع

الإطلاق

نقل البياناتموازي

تجربة 1

تجربة 2

نهائي

تكامل فريق الموقعموازي

دخول

كتالوج ← سلة ← طلب ← حسابي

جملة ← تسويق

تجربة العميلآخر كل مرحلة

✓

التدريبلكل دور

أوبريشن

كل الأدوار

محطات التسليم

تجريبي

كتالوج حقيقي

دورة الطلب

الجملة

التسويق

الإطلاق

على الموبايل الجدول بيتسحب أفقياً. التواريخ الفعلية بتتحدد من يوم الموافقة على العرض (أسبوع 1 = أسبوع الموافقة).

محطات التسليم

أ3أسبوع

السيرفر التجريبي شغالدخول، أدوار، إعدادات، لوحة فاضية بكل الصفحات، عقد الـ API الأول.

أ6أسبوع

كتالوج حقيقيمنتجات وأرصدة منقولة، API الكتالوج، التحويلات والباركود.

أ11أسبوع

دورة الطلب كاملةمن الموقع للواتساب للطباعة للتقفيل للتسليم للمرتجع.

أ16أسبوع

الجملةباب التجار، Prime/VIP، العلامة المائية، وضع الجملة.

أ19أسبوع

التسويقالعروض الخمسة، الكوبونات، النقاط، منتج الصور.

أ25أسبوع

الإطلاقنقل نهائي، إنتاج، تدريب، تشغيل حقيقي.

تعريف «خلصت» — لكل مرحلة

مفيش مرحلة بتتقال «خلصت» إلا لما الأربعة دول يتحققوا. ده نفس المعيار في كل شغلنا.

🧱بناء نضيفمن غير أي تحذير (warning)، والهجرات متطبقة على داتابيز فاضية من الصفر.

✅الاختبارات خضراوحدات + عقد API + معمارية — وكل قاعدة جديدة ليها اختبار.

👀فتحتها بنفسيكل صفحة اتفتحت فاتح وغامق، عربي وإنجليزي، على 1440 و768 و360.

🔁رحلة كاملةعلى داتابيز حقيقية على السيرفر التجريبي — مش بيانات وهمية.

ومعاهم

مفيش «واجهة وهمية»: أي زرار مش متبني مايظهرش أو بيقول بوضوح إنه «قريباً — مرحلة X». ماينفعش رسالة «تم» وهي ماعملتش حاجة. وكل مرحلة بتتنشر على التجريبي وبيتبعت معاها ملف تحديثات بالتاريخ لفريق الموقع.

المراحل بالتفصيل

لكل مرحلة: النطاق، التسليمات، معايير القبول (فوق تعريف «خلصت»)، اللي محتاجينه قبلها، وفريق الموقع يقدر يبدأ في إيه بعدها.

الأساس

الأسابيع 2–3 · أسبوعين تقديري

📦 النطاق

الحل بالطبقات الأربعة + الاختبارات.
الدخول: اللوحة (Cookie + تحقق بخطوتين)، الـ API (JWT + تجديد بتدوير).
الأدوار والصلاحيات بالمصفوفة (صفحة + زرار).
الإعدادات بمجموعات وحدود، والتكاملات مشفّرة بزرار اختبار.
سجل التعديلات، المحذوفات، قوايم الأسباب، 27 محافظة.
هيكل اللوحة: السايدبار كامل، الثيم، اللغتين، المكونات المشتركة، الجرس، PWA.
المهام الخلفية، اللحظي، /health، السجلات، app-config.
عربي وإنجليزي من الأساس: LocalizedText، ملفات الترجمة للوحة والأخطاء، Accept-Language للـ API، ولغة مفضلة لكل عميل.
أساس التطبيق: إصدارات وتحديث إجباري وصيانة لكل منصة، وجدول أجهزة FCM.

🎁 التسليمات

لوحة شغالة: دخول، مستخدمين، أدوار، إعدادات، تكاملات، سجل.
السيرفر التجريبي + ملف النشر والاسترجاع.
عقد الـ API نسخة 1: الدخول، app-config، القوايم.
مرجع أكواد الأخطاء.

✔️ معايير القبول

دور جديد من غير صلاحية «يلغي» ← الزرار مايظهرش والسيرفر يرفض لو اتبعت الطلب مباشرة.
تغيير أي إعداد بيظهر في السجل قبل/بعد.
التشغيل يرفض يقوم من غير المفاتيح السرية.
اختبار يفشّل البناء لو حقل سري ظهر في أي رد.

محتاجين قبلهاموافقة على العرض · مصفوفة الأدوار ممكن تتعدل بعدين (Q5)

فريق الموقع يبدأ فيالدخول والتسجيل، الإعدادات العامة، المحافظات وقوايم الاختيارات

الكتالوج والمخازن

الأسابيع 4–6 · 3 أسابيع تقديري

📦 النطاق

المنتجات والمتغيرات والأقسام والبراندات والصور (ضغط وWebP).
حالات المنتج: متكوّد ومنتظر ← اتاستلم ← منشور، الصورة الداخلية، ملاحظات الفريق والتذكيرات.
البادئات ونطاقات الأكواد المحجوزة والمقفولة.
الأسعار (تكلفة، جملة، قطاعي، عرض بتاريخ) وسجلها.
المخازن والأماكن، سجل الحركات الإلحاقي، الأرصدة والحجز.
التحويلات بالموافقة، الجرد والمراجعة، طباعة الباركود، الاستيراد.
نقل البيانات — التجربة الأولى، وتقرير «ناقص ترجمة» واستيراد Excel للترجمات (C16).

🎁 التسليمات

مجموعتي «المنتجات» و«المخازن» في اللوحة كاملين.
API الكتالوج: الأقسام، المنتجات بالفلاتر والبحث والترقيم، صفحة المنتج، المتغيرات والمتاح.
الكتالوج الحقيقي منقول على التجريبي.
شاشة طلب التحويل (الشاشة 5 في صفحة 10).

✔️ معايير القبول

الرصيد = مجموع الحركات (اختبار على آلاف الحركات).
تحويل بفرق ← حركة «عجز تحويل» بسبب ومين.
كود جوه نطاق مقفول ← يترفض.
سعر التكلفة مش موجود في أي رد للموقع.
ملصق بيتطبع ويتقري بالسكانر الحقيقي.

محتاجين قبلهابيانات النظام الحالي (Q14) · معنى «20Q» (Q1) · البراند التاني (Q10) · مقاس الملصق (Q9) · موافقة C1

فريق الموقع يبدأ فيربط الكتالوج كله (الأقسام، القوايم، الفلاتر، صفحة المنتج) على بيانات حقيقية

الطلبات والتجهيز والشحن

الأسابيع 7–11 · 5 أسابيع تقديري

📦 النطاق

السلة وحسابها في محرك الأسعار (القطاعي + الشحن + الصور لكل قطعة).
إنشاء الطلب من الموقع واللوحة («إضافة طلب»)، آلة الحالات كاملة.
الواتساب: القوالب، جدول التذكيرات، الطابور، استقبال الأزرار، البديل باللينك.
الاستثناءات واللمبة، التنبيهات، العاجل، الوسوم.
أقسام التجهيز الأربعة، الطباعة، محطة التقفيل بالأصوات.
دفعات التسليم وExcel ونموذج التوقيع، المطابقة.
المرتجعات بالفحص، المؤجل والمركون، العملاء، الشكاوى، شركات الشحن والمحافظات، صفحات المحتوى.

🎁 التسليمات

مجموعة «الطلبات» كاملة + الشاشات 1–4 من صفحة 10.
API: السلة، حسابها، الطلب، حسابي وطلباتي وتتبع الطلب، رفع الصور، المحتوى.
محطة التقفيل متجربة على أجهزة المخزن.
تدريب أول للأوبريشن.

✔️ معايير القبول

رحلة كاملة: طلب من الموقع ← رسالة ← «تأكيد» من الواتساب ← طباعة ← تقفيل (بخطأ متعمد بيترفض) ← دفعة ← Excel ← مطابقة ← استلام.
مرتجع جزئي يرجع المخزون بعد الفحص بس.
طلبين على آخر قطعة ← واحد بس يعدّي.
رد الزرار المتكرر من الواتساب يتنفذ مرة واحدة.
رد السكان < 200ms.

محتاجين قبلها«حلول» (Q17) · الأجهزة (Q9) · شركات الشحن (Q6) · الصور لكل قطعة (Q2) · التجميع (Q4 — افتراض) · الدفع (Q15) · موافقة C2 C3 C10

فريق الموقع يبدأ فيالسلة والدفع وإنشاء الطلب، حسابي وطلباتي، رفع الصور، صفحات المحتوى والتواصل

البضاعة الداخلة والجودة

الأسابيع 12–14 · 3 أسابيع تقديري

📦 النطاق

الموردين، أذون الشراء ومدفوعاتها قبل الوصول، التسوية.
الشحنات ومصاريفها، الاستلام بالدستة والوزن، العدّاد بالقطعة.
العينات للمصوّر، التسعير بعد العد وإعادة حساب التكلفة.
التوزيع على الجملة والقطاعي بالتحويل.
دفعات الفحص لكل براند، الفرز الأول والتاني، التالف ولجنته، الإعدام والإصلاح والخامات.

🎁 التسليمات

مجموعتي «البضاعة الداخلة» و«الجودة» في اللوحة.
تقرير أذون الشراء وتكلفة الشحنة.
صفحة مدفوعات الموردين.

✔️ معايير القبول

شحنة 3000 ج على 2950 قطعة بعد الجمرك ← تكلفة القطعة صح (لأربع أرقام عشرية).
إذن بيتسوّى على اللي وصل فعلاً والفرق يبان.
كل قطعة تالفة ليها كود وسطر ومين أضافها — ماتختفيش.
الفرز بيحرك المخزون للمخزن الصح.

محتاجين قبلهاموافقة C1 وC8 · ميتنج قصير مع مسؤول الاستلام عن شكل قايمة التعبئة

فريق الموقع يبدأ فيمفيش جديد (شغل داخلي) — المنتجات المنشورة بعد التسعير بتظهر لوحدها

الجملة

الأسابيع 15–16 · أسبوعين تقديري

📦 النطاق

فورم التاجر ومراجعته (قبول/رفض/مطلوب بيانات) وزرار الواتساب.
لينك الدخول على الواتساب، الشروط بإصداراتها، شاشات التعريف.
التجار، Prime والمنتجات المقفولة، مستويات VIP التلقائية.
أسعار الجملة وشرائحها وأقل كمية.
العلامة المائية برقم التاجر.
وضع الجملة (الأخضر) في إضافة طلب، وقسم الجملة في التجهيز.

🎁 التسليمات

مجموعة «العملاء والجملة» كاملة + الشاشة 6.
API التاجر: التقديم وحالته، الدخول، كتالوج الجملة، الصور المعلّمة، طلب الجملة.

✔️ معايير القبول

تاجر مش Prime يطلب منتج Prime بالرابط المباشر ← «مش موجود» (اختبار).
صورة الجملة اللي اتنزلت فيها رقم التاجر.
فاتورة الجملة بتقرا مخزن الجملة وأسعارها بس.
VIP بيتحسب لوحده بعد «تم الاستلام».

محتاجين قبلهاقرار C4 وC5 وC13 · الآجل (Q20) · أقل كمية والشرائح (Q23)

فريق الموقع يبدأ فيباب الجملة كامل: الفورم، الدخول، التعريف، كتالوج الجملة اللبني، العلامة العائمة

التسويق

الأسابيع 17–19 · 3 أسابيع تقديري

📦 النطاق

العروض الخمسة في محرك الأسعار (خد 2 هدية 1، التانية بالنص، أي 3 بسعر، هدية فوق مبلغ، طقم بسعر).
الكوبونات بكل حدودها.
نقاط الولاء: الكسب والمستويات والصرف والصلاحية.
باقات الصور.
البانرات، الرسالة الجماعية، SEO والتتبع.
(المحفظة لو العميل طلبها).

🎁 التسليمات

مجموعة «التسويق» + «رسالة جماعية».
API: العروض الشغالة، تطبيق الكوبون، النقاط، الباقات، البانرات.
جدول حالات اختبار للعروض مكتوب ومعتمد.

✔️ معايير القبول

كل حالة في جدول العروض بتطلع نفس الرقم في الموقع وفي «إضافة طلب».
النقاط بتتكسب عند الاستلام وتتلغي لو الطلب رجع.
كوبون بعدد استخدامات ← مايتعداش حتى مع ضغطتين في نفس اللحظة.

محتاجين قبلهاالتجميع (Q4) · النقاط (Q18) · المحفظة (Q3) · موافقة C6 C7 C15

فريق الموقع يبدأ فيالعروض على المنتجات والسلة، الكوبون، صفحة النقاط، البانرات، اختيار باقة الصور

التقارير والمالية المبسطة

الأسابيع 20–21 · أسبوعين تقديري

📦 النطاق

الرئيسية الإحصائية كاملة (8 مجموعات أرقام، 16 رسمة، القوايم الحية).
مركز التقارير (24 تقرير) بتصدير Excel وPDF.
المصاريف، الإيرادات الأخرى، التحصيل من الشحن، الملخص المالي.

🎁 التسليمات

الرئيسية والتقارير والمالية في اللوحة.
التصدير الكبير في الخلفية مع إشعار.

✔️ معايير القبول

كل رقم في الرئيسية = نفس الرقم في تقريره بنفس الفلتر.
المبيعات مطابقة لعينة محسوبة يدوي.
تقرير على 6 شهور بيانات في أقل من 2 ثانية.

محتاجين قبلهادرجة الحسابات (Q7)

فريق الموقع يبدأ فيمفيش جديد — وقت تقفيل وتلميع شغلهم

الفروع ونقطة البيع

الأسابيع 22–23 · أسبوعين تقديري

📦 النطاق

الفروع والبازارات (مخازن مؤقتة بتاريخ).
استلام الفرع وتسكينه والفائض.
البيع بالباركود، الورديات، مرتجع الفرع.
تخفيضات مدير الفرع بحد.

🎁 التسليمات

مجموعة «الفروع والبازارات».
إيصال بيع الفرع.

✔️ معايير القبول

بيع في البازار بيخصم من مخزن البازار بس.
قفل البازار ← الباقي يرجع بطلب تحويل.
التخفيض فوق الحد يترفض.

محتاجين قبلهانقطة البيع في الإطلاق الأول ولا بعده (Q8) · حد التخفيض (Q21)

فريق الموقع يبدأ في—

التقوية والإطلاق

الأسابيع 24–25 · أسبوعين تقديري

📦 النطاق

اختبار أداء وتحميل، مراجعة أمان وصلاحيات.
تجربة نقل تانية ثم النقل النهائي.
نشر الإنتاج، النسخ الاحتياطي اليومي، المراقبة.
تدريب كل الأدوار، تشغيل حقيقي ودعم أول أسبوعين.

🎁 التسليمات

نظام الإنتاج شغال ببيانات فلوكة.
تقرير اختبار حي، دليل نشر واسترجاع، دليل مختصر لكل دور.

✔️ معايير القبول

قايمة الإطلاق (القسم 11) كلها متعلّمة.
رحلة كاملة على الإنتاج بطلب حقيقي.
استرجاع نسخة احتياطية اتجرب فعلاً.

محتاجين قبلهامراجعة البيانات المنقولة من فلوكة (Q26) · يوم الإطلاق

فريق الموقعينقل الواجهة على الإنتاج في نفس اليوم

إيه اللي يقصّر الخطة أو يطوّلها

الـ 25 أسبوع مبنية على الافتراضات الحالية. دي القرارات اللي بتغيّر الرقم فعلاً.

القرار / الحدث	الأثر على المدة	ليه	السؤال
نقطة البيع بعد الإطلاق	− 2 أسبوع	المرحلة 7 تتأجل؛ المحل يكمل على طريقته لحد ما تتبني	Q8
إطلاق أول بعد المرحلة 5 (أونلاين + جملة) والتقارير بعده	الإطلاق في أ21 بدل أ25	التشغيل الحقيقي أبدري، والتقارير والفروع تيجي كتحديث	قرار إدارة
المحفظة مطلوبة	+ 1.5 أسبوع	سجل حركات فلوس، شحن، استرداد، مراجعة	Q3
بوابة دفع إلكتروني	+ 1 أسبوع	الربط، الـ callback، المطابقة، الاسترداد	Q15
ربط برمجي مع شركة شحن	+ 1 أسبوع لكل شركة	بدل ملفات Excel	Q6
«حلول» مابيدعمش الأزرار	± 0	البديل (لينك تأكيد) محسوب في المرحلة 2	Q17
بيانات النظام الحالي مش نضيفة أو اتأخرت	+ 1–2 أسبوع	تنضيف ومراجعة يدوية؛ وفريق الموقع يستنى	Q14
Prime باشتراك شهري مدفوع	+ 1 أسبوع	تجديد وتذكير ودفع	Q12
ردود الأسئلة العاجلة اتأخرت أكتر من أسبوعين	تأخير بنفس المدة تقريباً	بنكمل بالافتراضات، بس أي رد مختلف بيعيد شغل	صفحة 11

حزمة التوثيق — قبل أي سطر كود

12 ملف في فولدر التوثيق جوه المشروع ومتتبّعين مع الكود. العرض ده هو المسودة المصورة لأغلبهم، وبعد الموافقة بيتكتبوا نسخة نهائية.

#	الملف	الغرض	مسودته في العرض	الحالة
00	نظرة عامة	الأطراف، المصادر وأسبقيتها، القواعد الذهبية R1–R13، الهوية	01	جاهز
01	تحليل المتطلبات	كل متطلب بمصدره وتصنيفه (قاعدة/عرض/خطأ/افتراض) + جدول التعارضات والقرارات	02–06، 11	مسودة
02	المعمارية	الطبقات، الوحدات، الآليات الحساسة، الأمان، النشر	07	مسودة
03	تصميم الداتابيز	كل جدول بأعمدته وعلاقاته وفهارسه وقيوده	08	مسودة
04	دورة الطلب وقلب البيزنس	آلة الحالات، الحجز، اللمبة، حسابات المخزون والتكلفة والأسعار والعروض	02–04	مسودة
05	عقد الـ API	كل نقطة بطلبها وردها وأخطائها — لفريق الموقع — + `openapi.json`	07 (البادئات)	بعد الموافقة
06	لوحة الإدارة	الصفحات، الصلاحيات، التقارير، قواعد التصميم والحركة	09–10	مسودة
07	خطة التنفيذ	المراحل بمعايير القبول	12	مسودة
08	المرجع الداخلي	أنماط وكود مرجعي جاهز نعيد استخدامه — داخلي للفريق، مش جزء من التسليم للعميل	—	داخلي
09	الأسئلة المفتوحة	كل سؤال بجهته وافتراضه وأولويته — بيتحدث مع كل رد	11	مسودة
10	تحليل الموقع التجريبي	شاشة شاشة: إيه قاعدة، إيه شكل، إيه غلط + التصحيحات	05، 11	مسودة
11	مصفوفة التحكم من اللوحة	كل عنصر ديناميك: مكانه، الافتراضي، الحد الأدنى والأقصى	12 (القسم 12)	مسودة

📒 سجل القرارات

ملف بيتحدث مع كل قرار بالتاريخ: الاختيارات ← التكلفة ← التوصية ← بيفتح إيه.

🧭 دليل المشروع

ملخص المشروع والأوامر و«فخاخ وقعنا فيها» — في جذر المشروع، لأي حد يمسك الكود.

🚀 دليل النشر

خطوات النشر والرجوع والمتغيرات المطلوبة — من غير أي باسورد أو مفتاح في الملف.

تسليمات فريق الموقع

فريق الموقع لازم يشتغل من غير ما يسأل كل شوية. ده اللي بيوصلهم مننا، وإمتى.

التسليم	فيه إيه	إمتى
ملف عقد الـ API	كل نقطة: الطلب، الرد، الأخطاء، أمثلة بالعربي — بنفس ترتيب شاشات الموقع	نسخة لكل مرحلة قبل تنفيذها
`openapi.json` مُصدَّر	يتولد منه كود الواجهة أو يتستورد في أدوات التجربة	مع كل نشر تجريبي
مرجع أكواد الأخطاء	كل كود ثابت ومعناه ورسالته العربي، وإزاي الواجهة تتصرف — الواجهة تقرر على الكود مش على النص	المرحلة 0، وبيكبر مع كل مرحلة
رابط التجريبي بدري	نفس الـ API اللي هيتنشر، ومعاه صفحة توثيق الـ API (على التجريبي بس)	آخر الأسبوع 3
بيانات حقيقية على التجريبي	المنتجات والأقسام والصور المنقولة	آخر الأسبوع 6
حسابات تجريبية لكل نوع	عميل عادي، عميل VIP، تاجر تحت المراجعة، تاجر مقبول، تاجر Prime — بيانات الدخول بتتبعت منفصلة، مش في أي ملف	مع كل مرحلة بتضيف نوع
ملفات تحديثات بالتاريخ	`API-UPDATES-YYYY-MM-DD`: إيه اتضاف واتغير، والتغييرات اللي بتكسر حاجة في أوله	مع أي تغيير
ردود مترقّمة على أسئلتهم	كل سؤال من فريق الموقع ليه ملف رد برقم — مرجع للكل	طول المشروع
مجموعة طلبات جاهزة للتجربة	كل رحلة (تسجيل ← كتالوج ← سلة ← طلب) جاهزة تتجرب	مع المرحلة 2

القاعدة اللي بتحمي الطرفين

لو فريق الموقع بعت عقد مكتوب ← بيتنفذ حرفياً. غير كده: عقدنا هو المرجع، وأي تغيير فيه بيتبلّغ بملف تحديث قبل ما يتنشر. ومفيش منطق بيزنس في الواجهة (أسعار، عروض، صلاحيات، إخفاء Prime) — كله من الـ API.

نقل البيانات من النظام الحالي

فلوكة شغالة دلوقتي على نظام نقاط بيع جاهز مربوط بالمتجر القديم، وفيه بيانات حقيقية. النقل بتجربتين قبل النهائي، وكل تجربة بتقرير — عشان يوم الإطلاق مايبقاش مفاجأة. S5 Q14

الوصول للبياناتقبل المرحلة 1

نسخة من الداتابيز أو تصدير Excel من النظام الحالي لكل جدول، ونسخة من صور المنتجات. مين من فلوكة مسؤول (Q26).

أرقام مرجعيةأول يوم

نعد كل حاجة في المصدر: عدد المنتجات، المتغيرات، الأقسام، العملاء، ومجموع الرصيد لكل مخزن — دي اللي هنقارن بيها بعد النقل.

الربط (Mapping)الأسبوع 4

كل حقل قديم ← مكانه عندنا (الجدول تحت). اللي مالوش مكان بيتكتب ويتقرر عليه.

التنضيفالأسبوع 4–5

أكواد مكررة، منتجات من غير سعر، متغيرات من غير كود، أقسام مكررة، موبايلات بصيغ مختلفة (توحيد 01xxxxxxxxx)، صور ناقصة. كل مشكلة في ملف أخطاء بالصف.

التجربة الأولى على التجريبيالأسبوع 5–6

نقل كامل بأداة النقل (بتتعاد أي عدد مرات)، وتقرير: اتنقل كام، اترفض كام وليه.

مراجعة فلوكةالأسبوع 6–7

عينة 50 منتج عشوائي (الكود، الاسم، المتغيرات، الأسعار، الصور) + أرصدة كل مخزن مع مسؤوله. الملاحظات بتتصلح في الأداة مش يدوي.

التجربة التانيةالأسبوع 23

نقل كامل تاني على نسخة جديدة من البيانات، ونقيس الوقت اللي بياخده (عشان نعرف التجميد هياخد قد إيه).

الجرد الافتتاحيقبل الإطلاق بأيام

جرد فعلي لكل مخزن بالسكانر ← الأرصدة الافتتاحية = حركة «رصيد افتتاحي» لكل مخزن بمين وافق. ده أول سطر في سجل الحركات.

التجميد والنقل النهائييوم الإطلاق

النظام القديم يتقفل للتعديل ساعات، نقل الفروق (منتجات وعملاء جداد)، الأرصدة النهائية، مراجعة الأرقام المرجعية، فتح الجديد.

الطلبات القديمةبعد الإطلاق

أرشيف للقراءة بس: بتبان في صفحة العميل وفي البحث، وبتدخل التقارير كـ «تاريخي» بس. النظام القديم يفضل للقراءة شهر وبعدين يتقفل.

ربط البيانات

البيانات	من النظام الحالي	عندنا	ملاحظات
المنتجات	قائمة المنتجات	المنتجات	الكود يفضل زي ما هو؛ «منشور» لو كان ظاهر في المتجر
المتغيرات	المتغيرات	المتغيرات	كود لكل متغير — لو مفيش بيتولد من كود المنتج + لاحقة
التصنيفات	التصنيفات	الأقسام	توحيد المكرر، والاسم الإنجليزي لو موجود
العلامات التجارية	العلامات التجارية	البراندات	فلوكة + البراند التاني
الأسعار	سعر البيع + مجموعة أسعار البيع	قطاعي / جملة / تكلفة	سجل الأسعار بيبدأ من يوم النقل
الوحدات	الوحدات	القطعة (والدستة معامل)	المخزون عندنا بالقطعة دايماً
جهات الاتصال	جهات الاتصال	العملاء (والتجار لو متعلمين)	التاجر القديم يدخل «مقبول» من غير فورم جديد — لو العميل وافق
المخزون الافتتاحي	الأرصدة	حركة «رصيد افتتاحي» لكل مخزن	بعد الجرد الفعلي
الصور	المتجر القديم	صور المنتج	تحميل، ضغط، WebP
الطلبات	الطلبات	أرشيف للقراءة	مش بتدخل آلة الحالات
الضمانات، التصنيع، المصاريف القديمة	—	مش بتتنقل	إلا لو العميل طلب

التحقق بعد كل نقل

الأعداد = الأرقام المرجعية (أو الفرق متفسر في تقرير).
مجموع الرصيد لكل مخزن = المصدر.
مفيش كود مكرر، وكل متغير ليه كود.
50 منتج عشوائي: الاسم والسعر والمتغيرات والصور مطابقين.

كل الموبايلات بصيغة واحدة ومفيش عميل مكرر.
كل الصور بتفتح.
الموقع التجريبي بيعرض الكتالوج المنقول من غير أخطاء.
تقرير النقل متبعت ومعتمد من فلوكة.

استراتيجية الاختبار

الحسابات والحالات والمخزون ماينفعش تتكسر بتعديل جديد — عشان كده ليها اختبارات تلقائية بتشتغل مع كل بناء.

النوع	بيغطي إيه	إمتى
اختبارات وحدات	آلة حالات الطلب (كل نقلة مسموحة وممنوعة)، محرك الأسعار (جدول حالات للعروض والكوبونات والشرائح)، سجل المخزون والحجز، التكلفة بعد العد، VIP، النقاط	كل بناء
اختبارات عقد الـ API	شكل كل رد، أكواد الأخطاء وحالات HTTP، الترقيم، إخفاء Prime والتكلفة	كل بناء
اختبارات معمارية	حدود الطبقات، مفيش حقل سري في أي رد، كل إعداد متبذور، كل حدث ليه قالب رسالة	كل بناء
اختبارات التزامن	طلبين على آخر قطعة، رد واتساب مكرر، سكان مكرر، كوبون بآخر استخدام	كل مرحلة
رحلة كاملة يدوي	الرحلة الأساسية للمرحلة على داتابيز حقيقية على التجريبي	آخر كل مرحلة
الأجهزة	السكانر، طابعة الإيصال، طابعة الملصقات، تابلت المحطة، موبايل (التثبيت كتطبيق)	المرحلة 2 وقبل الإطلاق
الشكل	كل صفحة على 1440/1024/768/400/360، فاتح وغامق، عربي وإنجليزي	مع كل صفحة
تجربة العميل	فلوكة بأدوارها على التجريبي، وملاحظاتهم بتتسجل وتتصلح قبل المرحلة الجاية	آخر كل مرحلة
أداء وأمان	ذروة طلبات + 50 مستخدم لوحة، السكان < 200ms، الصلاحيات من السيرفر على كل زرار، حدود المعدل	المرحلة 8

البيئات والنشر

ثلاث بيئات منفصلة بداتابيز منفصلة. مفيش تعديل يدوي على أي داتابيز من غير سكريبت محفوظ.

البيئة	مين بيستخدمها	البيانات	النشر	ملاحظات
التطوير	المطور	تجريبية	—	مرسل واتساب وهمي بيكتب في السجل؛ نقاط التطوير والبذور شغالة هنا بس
التجريبي	فريق الموقع، فلوكة للتجربة	منقولة + حسابات تجريبية	مع كل جزء بيخلص (مرة أو أكتر في الأسبوع)	صفحة توثيق الـ API مفتوحة هنا بس؛ الواتساب على أرقام اختبار
الإنتاج	فلوكة فعلياً	حقيقية	بعد نجاح الرحلة على التجريبي	نسخ احتياطي يومي + تجربة استرجاع؛ توثيق الـ API مقفول؛ مراقبة الصحة والمزودين

1بناء + اختبارات

لازم خضرا ومن غير تحذيرات.

2نسخة احتياطية

من داتابيز البيئة قبل أي نشر.

3النشر

نشر مباشر للاستضافة، والهجرات بتتطبق عند التشغيل أو بسكريبت محفوظ.

4فحص بعد النشر

/health + فتح الصفحات الأساسية + طلب تجريبي.

5رجوع لو فيه مشكلة

النسخة اللي قبلها + استرجاع الداتابيز — الخطوات مكتوبة في دليل النشر.

إعدادات الاستضافة

WebSockets متفعّلة (للتحديث اللحظي)، الأسرار في متغيرات البيئة مش في الملفات، مفاتيح التشفير على القرص، ولوحة المهام الخلفية بكلمة سر من البيئة.

التدريب والإطلاق

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

الدور	المدة	المحتوى	إمتى
الأوبريشن (مجمّع، مقفّل، تسليم)	ساعتين + تجربة عملية	الأقسام، الطباعة، التجميع بالمكان، محطة التقفيل والأصوات، الاستثناء، دفعة التسليم	أ12 ثم أ24
خدمة العملاء والمودريشن	ساعتين	بانتظار التأكيد، اللمبة والحل، إضافة طلب (قطاعي وجملة)، المؤجل والمركون، الشكاوى	أ24
المخازن والاستلام والعدّاد والجودة	ساعتين	التحويلات بالتأكيد، الاستلام، العد، الفرز، التالف، الجرد بالمسدس	أ24
الجملة	ساعة	مراجعة طلبات التجار، Prime، الأسعار والشرائح	أ25
المالك والمحاسب	ساعتين	الرئيسية، التقارير، الأسعار، الإعدادات، الصلاحيات، السجل	أ25

مع كل تدريب: فيديو قصير لكل شاشة أساسية + ورقة مختصرة لكل دور (صفحة واحدة).

📋 قبل الإطلاق بأسبوع

التجربة التانية لنقل البيانات اتراجعت واتعتمدت.
الإنتاج اتنشر وفاضي، والنسخ الاحتياطي اتجرب.
مفاتيح التكاملات الحقيقية متسجلة وكل زرار «اختبار» أخضر.
القوالب والإعدادات والصلاحيات متراجعة مع فلوكة.
الأجهزة متركبة في أماكنها ومتجربة.
كل الأدوار اتدربت.

🚀 يوم الإطلاق

الجرد الافتتاحي خلص.
تجميد النظام القديم ونقل الفروق.
مراجعة الأرقام المرجعية.
فريق الموقع ينقل الواجهة للإنتاج.
طلب حقيقي أول رحلة كاملة لحد التسليم.
رسالة للعملاء (لو مطلوب).

🛟 أول أسبوعين

متابعة يومية للسجلات والتنبيهات.
قناة سريعة للمشاكل مع فلوكة.
تصليح الحرج في نفس اليوم.
مراجعة الأداء أول ذروة طلبات.
تقرير نهاية الأسبوعين.
قفل النظام القديم بعد شهر.

التحكم من اللوحة — ملخص المصفوفة

«أي رقم أو نص أو قايمة ممكن يتغير بقرار إداري ← من اللوحة» R9. كل عنصر ليه حد أدنى وأقصى وسجل تغيير. اللي مش ديناميك: المنطق نفسه (انتقالات الحالات وأكواد الصلاحيات) — بس نصوصه بتتعدل.

العنصر	المكان في اللوحة	الافتراضي
عدد رسائل التأكيد والفاصل بينها	الرسائل ← جدول التذكيرات	2 رسالة، كل 6 ساعات
بعد كام ساعة الطلب «محتاج مكالمة»	الرسائل ← جدول التذكيرات	24 ساعة
تذكير مؤجل الشحن قبل الميعاد	الرسائل ← جدول التذكيرات	3 أيام
ساعات الهدوء للرسائل	الرسائل ← جدول التذكيرات	11 م – 9 ص
الحد اليومي للرسائل وتكلفة الرسالة	الإعدادات ← التكاملات	حسب الباقة · 0.50 ج
نص كل رسالة وأزرارها (والزرار التالت)	الرسائل ← القوالب	زرارين: تأكيد / تعديل
مهلة «تحضير متأخر»	الإعدادات ← الطلبات	24 ساعة
مهلة «المركون»	الإعدادات ← الطلبات	7 أيام
فك حجز المركون تلقائياً بعد المهلة	الإعدادات ← الطلبات	متوقف (Q45)
طريقة توزيع مصاريف الشحنة على الأصناف	البضاعة الداخلة ← الشحنات	بالقيمة (Q42)
مهلة تأكيد التحويل قبل ما يطلع للأدمن	الإعدادات ← المخازن	12 ساعة
الوسوم اللونية (الشريط) ومعانيها	الإعدادات ← الوسوم اللونية	عادي / أصفر «زعلان»
قوايم الأسباب (إلغاء، رفض، مرتجع، تالف، استثناء، حل)	الإعدادات ← قوايم الأسباب	قوايم مبدئية
حدود VIP (عدد الطلبات لكل نجمة)	العملاء ← مستويات VIP	10 ← ⭐، 20 ← ⭐⭐
أسعار الجملة وشرائح الكمية	العملاء والجملة ← أسعار وشرائح الجملة	12 و120
أقل كمية للصنف في الجملة	الإعدادات ← الجملة	3 قطع
خصم مستوى التاجر (مقفول)	الإعدادات ← تشغيل المزايا	متوقف
مهلة مراجعة طلب التاجر (للتنبيه والنص)	الإعدادات ← الجملة	48 ساعة
شروط الجملة وإصدارها	العملاء والجملة ← شروط الجملة	الإصدار 1
صلاحية لينك دخول التاجر	الإعدادات ← الجملة	48 ساعة، مرة واحدة
كسب نقاط الولاء	التسويق ← نقاط الولاء	نقطة لكل 10 ج
مستويات صرف النقاط	التسويق ← نقاط الولاء	200 / 400 / 800 / 1500 (القيم محتاجة مراجعة — Q36)
حد «هدية فوق مبلغ» بيتحسب قبل/بعد العروض	التسويق ← العروض	بعد العروض (Q37)
صلاحية النقاط	التسويق ← نقاط الولاء	سنة
العروض الخمسة (النوع، النطاق، المدة)	التسويق ← العروض	—
تجميع العرض مع الكوبون	الإعدادات ← تشغيل المزايا	لأ (لحد قرار العميل)
الكوبونات وحدودها	التسويق ← الكوبونات	—
باقات الصور (العدد والسعر)	التسويق ← باقات الصور	3 +80 / 6 +130 / 10 +190
أسعار الشحن لكل محافظة والشحن المجاني	الشحن ← أسعار المحافظات	من النظام الحالي
مدة التوصيل ومدة الاسترجاع (نصوص)	المحتوى ← صفحات المحتوى	2–5 أيام · 14 يوم
مقاس الإيصال والملصق	الإعدادات ← الطابعات والملصقات	80 مم · 40×25 مم
أصوات اللوحة (تشغيل/نوع)	الإعدادات ← عامة + ملفي الشخصي	شغالة
هامش التسعير المقترح بعد العد	الإعدادات ← المخزون	من صاحب الشغل
حد «قرّب يخلص» و«راكد»	الإعدادات ← المخزون	5 قطع · 60 يوم
حد تخفيض مدير الفرع	الإعدادات ← الفروع	20%
مفاتيح التكاملات (واتساب، إيميل، تخزين الصور، SMS، الدفع)	الإعدادات ← التكاملات	فاضية + زرار اختبار
تشغيل/إيقاف المزايا (المحفظة، الزرار التالت، خصم المستوى، الدفع الإلكتروني)	الإعدادات ← تشغيل المزايا	متوقفة
وضع الصيانة ورسالته	الإعدادات ← عامة	متوقف
بيانات التواصل والسوشيال و«عن فلوكة» (EST. 2014)	المحتوى ← التواصل والسوشيال	من فلوكة
البانرات وشاشات التعريف والأسئلة الشائعة	المحتوى / التسويق	—
الأدوار والصلاحيات	الإعدادات ← الأدوار والصلاحيات	المصفوفة الافتراضية
SEO وأكواد التتبع	المحتوى ← SEO والتتبع	فاضي

والموقع بيقرا نفس الأرقام

أي عنصر بيظهر للعميل (أقل كمية، النقاط، الباقات، الشحن، النصوص) بيوصل للموقع من نقطة إعدادات عامة واحدة بقايمة سماح — المفتاح الجديد بيفضل مستخبي لحد ما حد يقرر يطلّعه.

مخاطر على الخطة

الحاجات اللي ممكن تأخر التسليم، وخطتنا لكل واحدة.

الخطر	الاحتمال	الأثر	التعامل
تأخير ردود الأسئلة العاجلة	متوسط	شغل يتعاد أو مرحلة تقف	افتراضات مكتوبة كإعدادات + رسالة واحدة مركزة + ميتنج بقرارات مكتوبة
تأخير الوصول لبيانات النظام الحالي	متوسط	فريق الموقع بيشتغل على بيانات وهمية	نطلبها من النهارده (Q14)، وبيانات الموقع التجريبي كبديل مؤقت
تداخل الشغل مع فريق الموقع	عالي لو مااتحسمش	نفس المنطق يتبني مرتين أو مايتبنيش	حدود مكتوبة (Q16) + عقد قبل كل مرحلة + ملفات تحديثات
مزود الواتساب مايدعمش الأزرار	متوسط	التأكيد التلقائي يقف	لينك تأكيد موقّع محسوب في الخطة
الأجهزة اتأخرت	متوسط	محطة التقفيل ماتتجربش	التحديد في أول أسبوعين + تجربة بأي سكانر USB مؤقت
طلبات جديدة في نص التنفيذ	عالي	المدة تطول	أي طلب جديد بيتسجل ويتحط في مرحلة بتكلفته، والموافقة قبل التنفيذ
القيود التفصيلية للأدوار اتأخرت	متوسط	صلاحيات غلط وقت الإطلاق	مصفوفة افتراضية قابلة للتعديل من اللوحة + مراجعة إجبارية قبل الإطلاق
بيانات قديمة مش نضيفة	عالي	المخزون يبدأ غلط	تجربتين نقل + جرد افتتاحي فعلي قبل الإطلاق
مطور واحد = نقطة فشل واحدة	منخفض	توقف لو غياب	توثيق كامل + دليل المشروع + كود بأنماط واضحة يقدر أي حد يكمله