infini-keen

byعمر قلبي اليافعي

انشئ لي هذا المتجر الوصف في الملف

Home
Home

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirements Document for infini-keen

Page 1 of 93

1. Introduction

MVPمواصفات—لبعوس

سوق

»لبعوس

سوق«متجر

مواصفات

MVPالتجريبية

النسخة

وثيقة

.الي

الم

النظام

و،التشغيل،الطلبات،البيانات،دارة

الإ،تاحفصلا،رجتملا

شكل:للمبرمج

مرجع

.تدريجيًا

تنفيذها

وسيتم

بعد

Page 2 of 93

تُبرمج

لم

جزاء

الأ

بعض.المشروع

تصميم

في

عليه

تفاق

اممت الا

تصف

الوثيقة

سوق

يخدم

محلي

إلكتروني

متجر»لبعوس

سوق«

.محمية

.هدايا،مفروشات،تجميل

مستحضرات،نسائية

Page 3 of 93

MVPمواصفات—لبعوس

سوق

العروض

و

المنتجات

لبعوس

لسوق

الة

البق

من

مستحقًا

يبقى

المبلغ

لكن،دفع

العميل

أن

يسجل،الة

في

دفع

إذا

.فعليًا

Page 4 of 93

تحويله

اممت-هليصحت

اممت=ةلا

البق

مستحق

.السيولة

وتزيد

الية

م

حركة

تسجل

الفعلي

التحويل

وصول

الوثيقة

إعداد

وقت

المشروع

حةلا29.

.المواصفات

مستوى

Page 5 of 93

على

عليه

تفاق

مت الا

الي

الم

النظام

و

العمليات

MVPمواصفات—لبعوس

إنشاء المتجر الموصوف في الملف المرفق «مواصفات_متجر_سوق_لبعوس_MVP.pdf». اسم المشروع المختار هو «infini-keen».

Page 6 of 93

2. System Overview

البيع

اختبار:الهدف

MVP.في

الطلب

قناة

وواتساب،العرض

واجهة

هو

المتجر

.الهاتف

من

ستخدام

للا

ومناسبMobile Firstالتصميم

للحقيقة

واحد

.متجاوب

ويب

متجر

Page 7 of 93

المطلوب

؛MVPفي

مستقلAndroidتطبيق

نحتاج

لا:حظة

ملا

المتجر

صفحات4.

.المختارة

متجر

مستقل

تطبيق

متكامل

إلكتروني

في

التوسع

التنفيذ

ترتيب26.

.ساسي

الأ

البيانات

Page 8 of 93

هيكل.27

.الخمس

وصفحاته

المتجر

سوق

صة

لا

الخ30.

مدير

صفحة

مع،الطلبات

ال

ستقب

واتساب

ويستخدم،فئات

أربع

يعرض،للهاتف

واحترافي

بسيط

<!-- planning-notes:v1:start -->
Page 9 of 93

Planning notes

Planning resolved these page and owner names itself instead of stopping. Review them before building.

Name changes

Page 10 of 93
  • Home: The document does not contain this page name; it was offered only as a suggestion
  • Category: The document does not contain this page name; it was offered only as a suggestion
  • Product Details: The document does not contain this page name; it was offered only as a suggestion
  • Pre-orders: The document does not contain this page name; it was offered only as a suggestion
  • How to Order: The document does not contain this page name; it was offered only as a suggestion
  • Admin: The document does not contain this page name; it was offered only as a suggestion
  • Category page: The document does not contain this page name; it was offered only as a suggestion
  • Product details: The document does not contain this page name; it was offered only as a suggestion
  • How to order: The document does not contain this page name; it was offered only as a suggestion
  • Offers: The document does not contain this page name; it was offered only as a suggestion
  • Manager page: The document does not contain this page name; it was offered only as a suggestion
  • Dashboard: The document does not contain this page name; it was offered only as a suggestion
  • Products & offers: The document does not contain this page name; it was offered only as a suggestion
<!-- planning-notes:v1:end -->
Page 11 of 93

3. Functional Requirements

هذه

MVPمواصفات—لبعوس

سوق

الأىلو

النسخة

هدف1.

الطلبات

ويستقبل،المشاركة

لات

المح

من

مختارة

منتجات

يعرض.يافع

في

لبعوس

مدير

صفحة

من

Page 12 of 93

إدارتها

تتم

ثم،واتساب

عبرMVPفي

مصدر

مبدأ2.

.مستقلة

كبيانات

تُدخل

ولا

صلية

الأ

البيانات

من

تُحسب

المؤشرات

و

التقارير.واحدة

مرة

تُحفظ

الحركة

Page 13 of 93

و

الطلب

المنتج

.توزيع

لات

بسج

تربط

ثم،واحدة

مرة

تسجل

كشوف

أو

طلبات

عدة

تغطي

التي

الية

الم

الحركة

.رقام

الأ

Page 14 of 93

وتعارض

البيانات

تكرار

منع

يجب

التصميم

و

الهوية3.

العنصر

صفحات4.

Homeالرئيسية4.1

.الهوية

و

الشعار

المنتجات

و

قسام

الأ

».الخاصة

العروض«قسم

.وواتساب

Page 15 of 93

المسبقة

الطلبات

الطلب

لطريقة

واضحة

روابط

.المدير

من

للتعديل

قابلة

السياسات

و

النصوص

Categoryالقسم

صفحة4.2

.القسم

منتجات

عرض

MVPمواصفات—لبعوس

سوق

.ةلمعلا،رعسلا،الامس،ةدحاو

Page 16 of 93

رئيسية

صورة:المنتج

بطاقة

.الخصم

نسبة،العرض

سعر،صلي

الأ

السعر:العرض

عند

.المنتج

تفاصيل

إلى

ال

الاقتن

Product Detailsالمنتج

تفاصيل4.3

.للمنتج

حقيقية

صور

.الحاجة

عند

Page 17 of 93

بصورها

مرتبطة

خيارات/ألوان

.الرئيسية

الصورة

يغير

اللون

اختيار

.واتساب

الة

رس

ضمن

المختار

الخيار/اللون

ال

إرس

.للعميل

الربح

هامش

أو

المورد

Page 18 of 93

الداخلية

التكلفة

تظهر

لا

Pre-ordersالمسبقة

الطلبات4.4

.مسبقًا

توفيرًا

تحتاج

التي

للمنتجات

مستقل

قسم

.معروفة

تكون

عندما

المتوقعة

التوفير

مدة

توضيح

.الدفع

Page 19 of 93

و

التعديل

لغاء

والإ

المسبق

الطلب

شروط

عرض

.حقة

لا

كدفعة

يفصل

؛

نفس

في

العادية

المنتجات

يعطل

لا

المتأخر

المسبق

Page 20 of 93

الطلب

How to Orderتطلب

كيف4.5

.الخيارات

و

الكمية

المنتج

اختيار.1

.واتساب

عبر

الطلب

ال

إرس.2

.لبعوس

سوق

موظف

من

التوفر

و

السعر

مراجعة.3

Page 21 of 93

.موافقته

على

الحصول

تغيير

توفر

عدم

بأي

العميل

بإلاغ.4

.التسليم

خطة

حسب

وتجميعها

المنتجات

تجهيز.5

.الطلب

غإلاق

حتى

الدفع

و

التسليم

Page 22 of 93

تسجيل.6

الخاصة

العروض5.

.مخصصة

وصفحة

الرئيسية

في

مستقل

قسم

.العرض

ونوع،النهاية

و

البداية،العرض

سعر،المنتج

يحتوي

العرض

.الحاجة

عند

اختيارية

حظة

مولا

Page 23 of 93

محدودة

كمية

.المنتج

حذف

دون

العرض

إيقاف

.يهتنم،فقوتم،طشن:الات

الح

.الطلب

داخل

يحفظ

الطلب

وقت

البيع

وسعر،محفوظان

MVPمواصفات—لبعوس

سوق

وسعر،محفوظان

العرض

وسعر

Page 24 of 93

صلي

الأ

السعر

MVPمواصفات—لبعوس

سوق

MVPمواصفات—لبعوس

سوق

.تلقائيًا

يحسبان

الخصم

ومبلغ

الخصم

نسبة

واتساب

عبر

و،واتساب

يرسل

الطلب6.

.دارة

الإ

صفحة

Page 25 of 93

في

الطلب

ينشئ

الموظف

العميل.معقد

ويب

طلب

نظام

أو

دفع

سلة

نحتاج

لاMVPفي

.الخيارات/لوان

والأ

الكميات

و

المنتجات

تشمل

الة

الرس

Page 26 of 93

.تلقائيًا

يولد

الطلب

رقم

.حقًا

لا

المنتج

سعر

تغير

إذا

يتغير

ولا

تاريخية

كنسخة

يحفظ

إنشائه

وقت

الطلب

سعر

.حملات

عدة

Page 27 of 93

من

منتجات

يحتوي

قد

الطلب

المنتج

بيانات7.

الحقل

الوصف

رمز.تلقائيًا

ويتولد

فريد

الامس.ليمعلل

ظاهر

اسم

مسقلا.اياده/تاشورفم/ليمجت/ملاسب

المورد/المحل.داخلي

بيان

الوصف.للعميل

ظاهر

وصف

Page 28 of 93

الصور.الحاجة

عند

الخيارات

وصور

حقيقية

صور

العملة

و

السعرSAR.أو+ YERالبيع

سعر

الخيارات.الحاجة

عند

وغيرها،درجة،مقاس،لون

التوفر.المنتج

توفر

حةلا

الداخلية

التكلفة.فقط

للحسابات

النوع.مسبق

طلب

Page 29 of 93

أو

عادي

التواريخ.وتحديث

إنشاء

الموظف.المنتج

عدل

أضاف

من

.المنتج

لنفس

العملتان

تعرض

لا.العرض

في

مدير

حساب

البداية

في.حقيقي

دخول

بتسجيل

ومحمية

Page 30 of 93

منفصلة

صفحة

التحكم

لوحة8.1

لوحة8.1

.الة

الح

حسب

الطلبات

عدد

.رصدة

لات والأ

التحصي

و

المبيعات

ملخص

.منفصلًا

عملة

لكل

الصندوق

رصيد

Page 31 of 93

.الات

البق

مستحقات

.نيدروملا/لات

المح

مستحقات

.صلية

لات الأ

السج

إلى

رقام

الأ

من

ال

الاقتن

إمكانية

إدارة8.2

.الخيارات

وإدارة

الصور

ورفع

Page 32 of 93

المنتجات

وإخفاء

وتعديل

إضافة

.المنتج

ونوع

التوفر

و

العملة

السعر

تعديل

.داخليًا

التكلفة

حفظ

.العروض

وإيقاف

وتعديل

إنشاء

الطلبات

إدارة8.3

.واتساب

Page 33 of 93

من

طلب

إنشاء

.الاتسلام

نقطة/القرية،الهاتف،العميل

اسم

.التوصيل

ورسوم

الخصم

و

سعار

والأ

الخيارات

الكميات

المنتجات

.تلقائيًا

الموظف

التاريخ

و

.واتساب

عبر

Page 34 of 93

الطلب

ال

استقب.7

.دارة

الطلب

رقم

.المحل

حسبSubordersإلى

داخليًا

تقسيم

دورة9.

الإ

في

الطلب

إنشاء.8

.التوفر

و

السعر

من

التحقق.9

.العميل

Page 35 of 93

موافقة

ثم

انتظار/ال

استبد/حذف:التوفر

عدم

عند.10

.لات

تفاصيل

ال

إرس.11

.لام

است

كشف

وتسجيل

فعليًا

المنتجات

لام

است.12

.التسليم

دفعة

للمح

Page 36 of 93

المنتجات

تفاصيل

ال

إرس.11

.لام

است

كشف

وتسجيل

فعليًا

لام

است.12

تجهيز.13

.التشغيلي

النموذج

وفق

الة

قبلا/الاتسلام

نقطة

إلى

التسليم.14

.الفعلي

Page 37 of 93

التحصيل

و

الدفع

تسجيل.15

.الإغلاق

شروط

ال

اكتم

عند

الطلب

غإلاق.16

لات

المح

متعددة

الطلبات10.

.للعميل

واحد

رئيسي

طلب

.محل

لكل

Page 38 of 93

داخليًا

منفصلSuborder

.التسليم

و

التجميع

قبل

العادية

المنتجات

ال

اكتم

تنتظر

الطلبات

.العادية

تعطل

ولا

حقة

لا

كدفعة

تفصل

المتأخرة

Page 39 of 93

المسبقة

حةلا

لها

تسليم

دفعة

الطلبات/الهدايا

MVPمواصفات—لبعوس

سوق

.مستقلة

توصيل

ورسوم

كل

الطلب

حالات11.

الة

الح

المعنى

Completed

.المطلوبة

التسليم

دفعات

Page 40 of 93

وجميع

المنتجات

جميع

العميل

استلم

In Progress

.بعد

يكتمل

لم

الطلب

Canceled

.منتجات

تسليم

يتم

ولم

ألغي

Partially Completed

.آخر

جزء

وبقي

جزءًا

Page 41 of 93

استلم

.الطلب

تأكيد

لمجرد

مدفوعًا

العميل

يعتبر

لا.التسليم

حةلا

عن

مستقلة

الدفع

Delivery Batchesالتسليم

دفعات12.

.التسليم

تاريخ+الرئيسي

الطلب+تلقائي

معرف

.الدفعة

في

الكميات

Page 42 of 93

و

المنتجات

.ملغى،التسليم

تم،جاهز،تجهيز:الة

الح

.الفعلية

التوصيل

تكلفة+المحصلة

رسوم

.حظات

ملا

.الفعلية

التكلفة-المحصلة

الرسوم=التوصيل

نتيجة

.الفعلي

التسليم

بعد

إلا

كمسلّمة

الدفعة

Page 43 of 93

تسجل

لا

الي

الم

النظام13.

.المنتج

تكلفة

عن

البيع

سعر

فصل

.داخليًا

المنتج

هامش/نتيجة

حساب

.التوصيل

المحصلة

التوصيل

رسوم

الأوم لا

يعكس

Page 44 of 93

الصندوق

.مباشر

ارتباط

هناك

يكون

عندما

الطلب

برقم

ب

مرتبطة

حركة

كل

Cashboxالصندوق14.

.الية

الم

للحركات

موحد

سجل

.العملة

حسب

منفصلة

Page 45 of 93

رصدة

الأ

.الفعلية

المدفوعات-الفعلية

المقبوضات+البداية

رصيد=الرصيد

.الحركة

منفذ،حظات

ملا،تابثإ،طبر،فرط،عفد

طريقة،عملة،مبلغ،نوع،اتجاه،تاريخ،رقم:الحركة

MVPمواصفات—لبعوس

سوق

.أخرى

أو،بنكي

تحويل،نقد:الية

الح

الدفع

طرق

التحصيل

الات و

البق15.

Page 46 of 93

.الفعلي

التحويل

حتى

عند

.التوزيع

مع

واحدة

مرة

ويسجل،طلبات

عدة

يغطي

قد

واحد

تحويل

الموردين

لات و

المح

حسابات16.

.فعليًا

الم

الحركة

Page 47 of 93

.كشوف

أو

طلبات

بعدة

الحركة

يربطMovement Allocation

.المبلغ

و،معرفه،السجل

نوع،الحركة

رقم،تلقائي

رقم

توزيع

لكل

.السجل

نفس

على

التوزيع

تكرار

ويمنع،الحركة

يتجاوز

Page 48 of 93

لا

التوزيعات

مجموع

المبيعات

و

الطلبات

تقرير18.

.المرتجعات/الخصومات-المكتملة

في

البيع

أسعار=المنتجات

مبيعات

صافي

.المحفوظة

التكلفة

بيانات

من

المنتجات

تكلفة

.الفعلية

التكلفة-المحصلة

Page 49 of 93

الرسوم=التوصيل

صافي

.التوصيل

.تكرار

دون،الطلب

ب

مرتبطة

واحدة

الية

م

كحركة

يسجل

النقدي

العميل

رد

لات

العم20.

.البداية

منSARوYERدعم

.عملة

لها

Page 50 of 93

حركة

كل

.العملة

حسب

منفصلة

رصدة

الأ

عرض

.مباشرة

لات

العم

تجمع

لا

.العملية

وقت

المستخدم

الصرف

بسعر

يسجل

لات

العم

Page 51 of 93

بين

التحويل

.مؤجلة

المعقدة

تقييم

إعادة

.الحركة

قبل

الأ نام

قواعد

اختبار

MVPمواصفات—لبعوس

سوق

المعتمدة

التقارير23.

.العملة

حسب

الحركات

و

الرصيد:الصندوق.17

.المتبقي

Page 52 of 93

التحويل

و

ليصحتلا:الات

البق

مستحقات.18

.المتبقي

المدفوع

ملتسملا:لات

المح

حسابات.19

.الطلب

ونتيجة

التوصيل

و

التكلفة

و

المبيعات:الطلبات

ملخص.20

.يدويًا

يدخل

ولا

Page 53 of 93

صلية

الأ

البيانات

من

يحسب

تقرير

كل.21

حملات/تائف

أربع

الواسع

التوسع

للطلب

واتساب

دفع

محمية

مدير

صفحة

مع

كاملة

أتمتة

واتساب

Page 54 of 93

من

يدوية

طلبات

الكامل

ب

آلية

ويب

التقارير

و

ساسي

الأ

تُحسم

لم

نقاط25.

.التسليم

دفعات

تعدد

عند

الدقيقة

التوصيل

رسوم

Page 55 of 93

سياسة

.لغاء

والإ

المدة

و

التكلفة

الدفع

واجهة.28

.العروض

و

المنتجات

إدارة.29

MVPمواصفات—لبعوس

سوق

Suborders.و

الطلبات

إدارة.30

.التسليم

ودفعات

الاتسلام

كشوف.31

Page 56 of 93

.التوزيعات

و

الية

الم

الحركات.32

.التقارير.33

.المفروشات

و

ملالاسب

من

منتجات

يطلب

عميل.35

.محل

لكلSuborderو

واحد

رئيسي

طلب

ينشأ.36

.التوفر

و

Page 57 of 93

سعار

الأ

تُراجع.37

.الفعلي

الاتسلام

عند

الاتسلام

كشوف

تسجل.38

.التسليم

عند

وتُسجل

تسليم

دفعة

تنشأ.39

.الة

البق

من

مستحقًا

المبلغ

يصبح،الة

Page 58 of 93

في

العميل

دفع

إذا.40

.الطلبات

على

وتوزع

واحدة

حركة

تسجل،الة

إذا.40

البق

تحويل

عند.41

.الكشوف

على

وتوزع

واحدة

حركة

تسجل،المحل

دفع

Page 59 of 93

عند.42

تاريخية

كلقطات

حفظها

يجب

الطلب

وقت

المورد

و

التكلفة

البيع

سعر:التاريخ

.صلية

لات الأ

السج

إلى

تتبعه

يمكن

أن

يجب

التحكم

Page 60 of 93

لوحة

في

رقم

كل:التقارير

.الهاتف

من

ستخدام

للا

قابلة

تكون

الطلبات

و

العروض

المنتجات

دارة

لإ

محمية

.صلية

لات الأ

السج

من

Page 61 of 93

تنتج

التقارير

؛

يدويًا

4. User Personas

RoleResponsibilitiesAccess
Store Manager (المدير)Manages products (add, edit, save internal cost), creates, edits and deactivates offers, and manages orders, including orders created from WhatsApp.Protected, separate admin dashboard page; real login with a manager account created at setup, authenticated via Firebase Authentication.
Employee (الموظف)Creates orders in the dashboard, including orders received via WhatsApp, capturing customer name, phone and village/delivery point; edits products and creates or updates order dates (normal or pre-order).Firebase Authentication account for staff, signing in to the protected dashboard.
Customer (العميل)Browses the four categories and the dedicated "Offers" section, selects a product with quantity and options, and places the order via WhatsApp using the clear "How to Order" links.Public storefront; no account required.

Journeys

  • Customer: open the store → browse categories or offers → choose product, quantity and options → follow the WhatsApp order link → order sent to the store's WhatsApp.
  • Employee: log in → open the orders page → create an order (customer name, phone, village/delivery point) or update dates → edit product details as needed.
  • Manager: log in to the dashboard → manage products (including internal cost) and offers (create, edit, deactivate) → manage orders, including orders created from WhatsApp.

Pre-orders remain available and are not disabled by the manager; the pre-order path is presented alongside the normal order path.

5. Core User Flows

Page 62 of 93

5.1 تصفح المنتجات والوصول إلى الطلب

الممثل: العميل. المُشغِّل: فتح المتجر على الهاتف.

  1. يستعرض العميل الصفحة الرئيسية (الشعار والهوية، الأقسام، قسم «العروض الخاصة»، وروابط واضحة لطريقة الطلب وواتساب).
  2. ينتقل إلى صفحة القسم لعرض منتجاته، ثم إلى تفاصيل المنتج.
  3. في التفاصيل: صور حقيقية، وألوان/خيارات مرتبطة بصورها عند الحاجة؛ اختيار اللون يغيّر الصورة الرئيسية.
  4. يطّلع على روابط الطلب المسبق وواتساب المتاحة من المدير. النتيجة: وصول العميل إلى قناة الطلب المناسبة. الاستمرار: يبدأ الطلب عبر واتساب (تدفق 2).

5.2 الطلب عبر واتساب

الممثلون: العميل، الموظف، المدير. المُشغِّل: رغبة العميل في الشراء.

  1. يختار العميل المنتج والكمية والخيارات.
  2. يرسل الطلب عبر واتساب؛ يُستقبل الطلب ويُدار عبر صفحة المدير.
  3. ينشئ الموظف الطلب في صفحة الإدارة (بيانات العميل: الهاتف، القرية/نقطة الاستلام)؛ يُولَّد رقم الطلب تلقائيًا.
  4. يتحقق الموظف من السعر والتوفر، ثم ينتظر موافقة العميل.
  5. عند عدم التوفر: استبدال أو حذف، مع إبلاغ العميل بأي عدم توفر.
  6. يُرسل تفاصيل المنتجات إلى المحل، ويُسجَّل الاستلام الفعلي.
  7. تُجهَّز المنتجات وتُجمَّع حسب خطة التسليم، وتُسلَّم إلى نقطة الاستلام/القبلة وفق النموذج التشغيلي.
  8. يُسجَّل التسليم الفعلي، ويُحصَّل الدفع، ويُغلق الطلب عند اكتماله. النتيجة: طلب مُنفَّذ ومسجَّل. الاستمرار: تُدرج المنتجات في دفعة تسليم (تدفق 5).
Page 63 of 93

5.3 الطلب المسبق للمنتجات غير المتوفرة

الممثلون: العميل، الموظف. المُشغِّل: منتج يحتاج فترة توفير.

  1. يصل العميل إلى قسم مستقل للمنتجات التي تحتاج وقتًا، مع توضيح مدة التوفير المتوقعة عندما تكون معروفة.
  2. يُسجَّل الطلب المسبق دون تعطيل الطلب المتأخر.
  3. تُفصل الطلبات المتأخرة كدفعة لاحقة لها تسليم مستقل، ولا تُعطّل المنتجات العادية. النتيجة: طلب مسبق متتبَّع منفصلًا. الاستمرار: يتبع دورة الطلب العادية عند التوفر.

5.4 إدارة العروض الخاصة

الممثل: المدير. المُشغِّل: رغبة في عرض ترويجي.

  1. ينشئ المدير عرضًا (المنتج، سعر العرض، تاريخ البداية والنهاية، نوع العرض) في قسم مستقل بالصفحة الرئيسية وصفحة مخصصة.
  2. يضبط كمية محدودة أو اختيارية عند الحاجة.
  3. يعرض السعر الأصلي وسعر العرض ونسبة الخصم على بطاقة المنتج.
  4. يوقف العرض دون حذف المنتج؛ الحالات: نشط، موقوف، منتهٍ. النتيجة: عرض ظاهر ومُدار. الاستمرار: ينتهي تلقائيًا أو يوقفه المدير.
Page 64 of 93

5.5 دفعات التسليم والتحصيل

الممثلون: الموظف، المدير. المُشغِّل: تجميع طلبات جاهزة للتسليم.

  1. تُنشأ دفعة تسليم بتاريخ تسليم مرتبط بالطلب الرئيسي.
  2. تُسجَّل الدفعة كمسلَّمة فقط بعد التسليم الفعلي.
  3. تُسجَّل كشوف الاستلام عند التسليم؛ ويصبح المبلغ المتبقي مستحقًا من القبلة.
  4. تُحسب نتيجة التوصيل = الرسوم المحصلة − التكلفة الفعلية.
  5. عند دفع العميل: تُسجَّل حركة واحدة وتُوزَّع على الطلبات. النتيجة: دفعة مسلَّمة ومبالغ مستحقة موثّقة. الاستمرار: تُغلق الطلبات المكتملة.

5.6 الطلبات متعددة المحلات

الممثلون: العميل، الموظف. المُشغِّل: طلب يشمل منتجات من أكثر من محل.

  1. يُنشأ طلب رئيسي واحد للعميل.
  2. يُقسَّم داخليًا إلى Suborders، واحد لكل محل.
  3. تنتظر الطلبات العادية اكتمال التجميع والتسليم دون أن تُعطّل الطلبات المتأخرة. النتيجة: طلب رئيسي موحّد مع تتبع داخلي لكل محل. الاستمرار: يتبع كل Suborder دورة التسليم والتحصيل.
Page 65 of 93

5.7 إدارة لوحة التحكم

الممثل: المدير. المُشغِّل: دخول لوحة التحكم.

  1. يسجّل المدير الدخول بحساب حقيقي في صفحة منفصلة ومحمية.
  2. يدير المنتجات (إضافة، تعديل، إخفاء، رفع الصور وإدارة الخيارات) ويحفظ التكلفة داخليًا.
  3. ينشئ ويعدّل ويوقف العروض.
  4. يدير الطلبات وSuborders ودفعات التسليم والاستلام.
  5. يصل إلى السجلات الأصلية من الأرقام، وتُنتج التقارير من السجلات (كل رقم قابل للتتبع من الهاتف). النتيجة: إدارة كاملة للمتجر. الاستمرار: تعود العمليات إلى تدفقات الطلب والتسليم.

6. Visuals Colors and Theme

[Design proposal; unspecified choices are defaults.]

Page 66 of 93

6.1 Visuals, Colours and Theme

infini-keen is a phone-first Arabic storefront for a local gift, furniture and women's cosmetics market. The visual system is built on the user's approved palette and a quiet, warm, professional tone.

RoleTokenHex
Page ground (warm ivory)--bg#F5F1E8
Raised surface--surface#FFFDF7
Body text (charcoal)--text#2B2B2B
Primary (dark green)--primary#234B43
Accent (quiet gold)--accent#C69B55
Muted text / rules--muted#7A756B

Ivory #F5F1E8 covers most of every page. Dark green #234B43 fills solid bands and the WhatsApp order button. Gold #C69B55 is reserved for prices, original prices and 1px hairline rules — never for large fills.

Typography. Headings use Amiri at light weight for Arabic headlines; body copy uses IBM Plex Sans Arabic. Modular scale 1.25 — 44 / 34 / 26 / 18 / 16px, with a 34px mobile headline and 72px desktop headline. Small caps labels carry wide tracking.

Shape and spacing. Square, thin-rule forms. 4px radii on buttons only. 1px gold hairline dividers between sections. No shadows. Single centred column with wide side margins; product cards in a calm 2-column grid on phone and 4-column grid on desktop.

Imagery. Still-life product photos on plain ivory grounds, soft natural light, one object per frame.

Page 67 of 93

Accessibility. Headlines, wordmarks, labels, numbers, card text and controls stay whole inside the viewport and their container at 375px, 768px and 1280px, wrapping or scaling via clamp() with its mobile size. Imagery and decoration may bleed or crop; readable text and controls never do.

المعتمد

الدافئ

العاجي#F5F1E8

الداكن

خضر

الأ#234B43

الهادئ

الذهبي#C69B55

الفحمي#2B2B2B

Page 68 of 93

7. Signature Design Concept

[Design proposal; unspecified choices are defaults.]

Muse: Kenya Hara — quiet emptiness. The store reads as calm trust: warm ivory paper, generous empty margins, and one object per frame. The look is simple, warm, professional and clean, matching the approved brief.

Signature moves

  1. An oversized Amiri headline in three stacked lines with wide empty margins around it.
  2. A full-width dark green bar at the bottom of the hero holding the WhatsApp order action.
  3. Thin gold hairline rules divide sections and present price and original price as label pairs.
  4. Product cards show one still-life photo; a tap swaps the photo to the selected colour option.

Public entry composition. The first screen is mostly empty ivory. A small wordmark sits top right. One large product still life sits left of centre at 60% width. Under it, the headline runs in three short Amiri lines — «سوق لبعوس: هدايا ومفروشات وتجميل» — with the subline «منتجات مختارة بأسعار واضحة، والطلب يتم عبر واتساب.» and the full-width dark green bar carrying «اطلب عبر واتساب». This recomposes only accepted hero content and the accepted WhatsApp order action.

Avoid. No gradient blobs, no glass panels, no blue or indigo accents on white, no drop shadows, no hover-lift cards, no dense dashboard chrome on store pages.

سلوب

Page 69 of 93

الأ

وبسيط

راقٍ

،احترافي،دافئ،نظيف

8. Interaction Model & Motion Direction

[Design proposal; unspecified choices are defaults.]

Interaction Model: Static (direction) Motion Tempo: still Hero Dimensionality: flat

Page 70 of 93

8.1 Landing Hero Motion Brief

Focal subject. The single still-life product photograph, left of centre at 60% width, on empty ivory.

Thesis. Input: the shopper lands on the entry page. Transformation: the composed first frame settles — ivory ground, wordmark top right, still life, three Amiri headline lines, subline, and the dark green order bar. Outcome: the shopper reads the offer and reaches the WhatsApp order action without distraction.

Motion vocabulary. Slow 400ms fades on section entry only. No bounce, no particles, no parallax, no scroll-linked depth.

Composed first frame. Ivory field; wordmark top right; still life left of centre; three stacked Amiri lines beneath; subline; full-width dark green bar at the bottom with «اطلب عبر واتساب».

Product interaction. On product cards, a tap swaps the still-life photo to the selected colour option — a discrete state change, not an animation flourish.

Reduced-motion state. With prefers-reduced-motion, section fades are removed and all content appears in its final position; the tap-to-swap photo remains a direct state change. No element covers readable text or controls at any viewport.

Page 71 of 93

9. Non-Functional Requirements

ولوية

الأMobile First

.البيانات

لحمايةFirestore Security Rules

.للعميل

تظهر

لا

الحسابات

و

المورد

التكلفة

بيانات

.الإطلاق

Mobile Firstويب

.الإطلاق

قبل

السيناريوهات

اختبار.34

Page 72 of 93

أساسي

اختبار

سيناريو27.

.التقارير

في

قيمة

أي

تتضاعف

ألا

يجب.43

يجب

أيضًا

دارة

الإ

واجهة:ال

الجو

.الداخلية

التشغيلية

البيانات

أو

الحسابات

Page 73 of 93

التكلفة

للعميل

تعرض

لا:الخصوصية

التقارير

أرقام

ندخل

ولا

البيانات

نكرر

لا:»للحقيقة

.الفعلية

النتائج

على

بناءًالتوسع

ثم،الواقع

أرض

ختبار

للا

Page 74 of 93

10. Tech Stack

عملة

بنفس

يكون

أن

يجب

التوزيع

Firebase / Firestoreبنية21.

Collectionستخدام

الا

products

.التجارية

المعلومات

و

الصور

المنتجات

orders

.الرئيسي

الطلب

suborders

Page 75 of 93

.المحل

حسب

تقسيم

shops

.نودروملا/لات

المح

customers

.التشغيلية

لاء

العم

بيانات

delivery_batches

.التسليم

دفعات

receipt_slips

.المنتجات

لام

است

كشوف

financial_movements

.الفعلية

Page 76 of 93

الية

الم

الحركات

الحركة

توزيع

promotions

.الخاصة

العروض

settings

.المتجر

وإعدادات

السياسات

و

النصوص

والأ نام22. Firebase

.المنظمة

للبياناتFirestore

.للصورFirebase Storage

.الموظفين/للمديرFirebase Authentication

Page 77 of 93

الأ

متعدد

متقدم

حيات

صلا

نظام

Firebase: Firestore/Storage/Authمعقدة

خارجية

لات

تكام

العروض

و

المنتجات

إدارة

المح

Firebase.بمشروعWeb Appربط.22

Cloud Firestore — Standard edition.إنشاء.23

.للمديرAuthentication .24

.للصورStorage .25

.واختبارهاSecurity Rules .26

و

Page 78 of 93

للمتجر

العام

التصميم

Web.وتطبيقFirebaseمشروع

إنشاء

تم

Cloud Firestore.إعداد

بدأ

Page 79 of 93

11. Assumptions and Constraints

بأربع

البداية

.التوسع

قبل

التحصيل

وخارجهMVPداخل24.

MVPداخلMVPخارج/مؤجل

الي

الم

النظام

متقدمة

محاسبةERP/

كتجربة

المسبق

الطلب

المورد

اختبار

قبل

كبير

Page 80 of 93

توسع

المبرمج

يفترضها

لا—نهائيًا

و

الجودة

المصدر

اختبار

على

تعتمد

النهائية

المسبق

الطلب

شروط

.مؤجلة

الموظفين

حيات

صلا

تفاصيل

MVP.ضمن

ليس

Page 81 of 93

لكتروني

الإ

.ستبيان

المساعد

للمبرمج

تعليمات28.

.ال

الاقتن

قبل

مرحلة

كل

واختبار،تدريجيًا

المشروع

تنفيذ:ولوية

الأ

.المنتج

تعديل

عند

القديمة

الطلبات

تتغير

Page 82 of 93

لا

حتى

.مبرمجة

الوظائف

كل

أن

على

دليلًا

وليست

مرجعية

مواصفات

الوثيقة

هذه

.اعتماده

قبل

واضحًا

يكون

أن

يجب

المواصفات

على

Page 83 of 93

جديد

تغيير

أي

ويب

متجرMVPفي

المطلوب

واحد

مصدر«هي

وتشغيلية

تقنية

قاعدة

أهم.ساسية

الأ

الحسابات

و

التسليم

التوريد

قابلة

صغيرة

نسخة

بناء

Page 84 of 93

بل،البداية

من

ضخمة

منصة

ليس

الهدف

Page 85 of 93

12. Glossary

ملاسب:حملات/تائف

و

التسليم

التجميع

التوريد

الطلبات

الحقيقي

أصلية

تشغيلية

معلومة

كل

.أصلية

لات

كسج

تسجل

العرض

و

التسليم

ودفعة

Page 86 of 93

الاتسلام

وكشف

الية

الم

أو

واحدة

بيع

عملة

منتج

لكل:العملة

قاعدة

Adminالمدير

صفحة8.

.حقًا

لا

حيات

صولا

موظفين

إضافة

قابلية

مع،واحد

Page 87 of 93

فصل

.المشروع

ربح

صافي

عن

العامة

المصاريف

قبل

الطلب

نتيجة

فصل

.فعليًا

خرجت

أو

دخلت

التي

المستلمة

المنتجات

قيمة

تسجيل

.لام

Page 88 of 93

است

عملية

لكل

واحد

كشف

.حظات

ملالا،ديكأتلا

إثبات،الي

الإمج،ةدحولا

سعر،الكميات،صناف

الأ،ملتسملا، Suborder،لحم،خيرات،مقر:فشكلا

.الموثق

الفعلي

الاتسلام

بعد

إلا

المورد

حساب

في

يدخل

لا

Page 89 of 93

المنتج

.الاتسلام

كشوف

على

توزيع+فعلية

الية

م

حركة=للمحل

الدفع

.المدفوع-المستلم

قيمة=المحل

رصيد

الية

الم

التوزيعات

و

الحركات17.

.واحدة

مرة

تسجل

الفعلية

Page 90 of 93

نتيجة

صافي+المنتجات

تكلفة-المنتجات

مبيعات

صافي=العامة

المصاريف

قبل

الطلب

نتيجة

.به

مباشرة

مرتبطة

تكن

لم

إذا

بطلب

تربط

ولا

المشروع

ربح

صافي

Page 91 of 93

في

تدخل

العامة

المصاريف

.مكتملة

كمبيعات

تعامل

منفصلة

تظهر

المكتملة

غير

الطلبات

MVPمواصفات—لبعوس

سوق

المرتجعات

و

العامة

المصاريف19.

.حظات

ملا/ببس،تابثإ،ةقيرط،ةلمع،غلبم،عون،خيرات،ةكرح

رقم:العام

Page 92 of 93

المصروف

.الطلب

داخل

يسجل

الخصم

movement_allocations

.كشوف/طلبات

على

دوار

الا

نتائج

من

تلقائيًا

وليس،الفعلي

الطلب

اختبار

بعد

قسام

الأ

Page 93 of 93
Live
Home design preview
Home: Open storefront on phone
Category: Browse category products
Product Details: View real product photos
Product Details: Select colour option
Product Details: Choose quantity and options
Offers: Browse dedicated offers section
Product Details: View offer price and discount
Pre-orders: Browse pre-order products
Pre-orders: Check expected availability period
How to Order: Follow WhatsApp order link
How to Order: Send order via WhatsApp
Live
Home design preview
Home: Open storefront on phone
Category: Browse category products
Product Details: View real product photos
Product Details: Select colour option
Product Details: Choose quantity and options
Offers: Browse dedicated offers section
Product Details: View offer price and discount
Pre-orders: Browse pre-order products
Pre-orders: Check expected availability period
How to Order: Follow WhatsApp order link
How to Order: Send order via WhatsApp