المشروع عبارة عن منصة عضوية وتجربة يومية ذكية

# 📋 وثيقة المواصفات التقنية ونطاق العمل (RFP)

## مشروع: Smart Membership & Convenience Platform (MVP)

⸻

### 1. مقدمة عن المشروع

المشروع عبارة عن منصة عضوية وتجربة يومية ذكية (**Smart Membership & Convenience Platform**) تهدف إلى بناء علاقة مباشرة ومستدامة مع العملاء عبر:

* الطلب السريع

* الرصيد والمكافآت

* العضوية الرقمية

* العروض الحصرية

* وتجربة يومية سلسة قليلة الاحتكاك

**الهدف من المرحلة الأولى (MVP):**

إطلاق تطبيق ويب تقدمي (PWA) يعمل تحت نطاق سعودي مخصص (سيتم تزويد المطور به بعد توقيع الاتفاقية):

YourDomain.sa

مع التركيز الكامل في المرحلة التشغيلية على:

* قطاع الأطعمة والمطابخ الذكية (**Brand Station**)

* قطاع المارت والتموين الذكي (**Brand Mart**)

مع توفير صفحات تعريفية لباقي خدمات المنصة تمهيداً للتوسع المستقبلي.

⸻

### 2. فلسفة المشروع

المشروع ليس متجراً إلكترونياً تقليدياً، بل هو:

**Membership & Convenience Ecosystem**

**الهدف:**

* امتلاك العلاقة المباشرة مع العميل

* زيادة تكرار الشراء

* بناء نظام Rewards & Balance داخلي

* تقليل الاعتماد على تطبيقات التوصيل الخارجية تدريجياً

* وبناء Habit Loop يومي للعميل

⸻

### 3. البنية التقنية المقترحة (Tech Stack)

**Frontend**

* Glide Apps (PWA Responsive Web App)

**Database**

* Supabase أو Airtable

**Automation & Integrations**

* Make.com أو Zapier

**POS Integration**

* Foodics API

**Payment Gateway**

* Tap Payments أو Moyasar (يدعم: Apple Pay, Mada, Visa / Mastercard)

**Membership Pass System**

* PassKit (Apple Wallet & Google Wallet)

**WhatsApp Automation**

* ManyChat أو WhatsApp Business API

⸻

### 4. هندسة الأقسام داخل التطبيق

#### أولاً: الأقسام التشغيلية الكاملة (Operational Tabs)

تشمل: (التصفح، الطلب، الدفع، المكافآت، والربط الكامل مع نظام نقاط البيع فوديكس).

**1. Brand Station**

قسم طلب الوجبات الطازجة من المطابخ السحابية والمتوفرة في الموقع، ويشمل:

* تصفح المنيو والتصنيفات

* خيارات التخصيص للمنتجات (Modifiers)

* سلة المشتريات والـ Checkout

* إعادة الطلب السريع (Quick Reorder)

* الدفع عبر محفظة الرصيد الداخلية أو Apple Pay مباشرة

**2. Brand Mart**

متجر تمويني ذكي لشراء السناكس، المشروبات، والمنتجات اليومية اللحظية، ويشمل:

* التصفح السريع للمنتجات

* السلة والـ Checkout

* الدفع السلس وإعادة الطلب السريع

#### ثانياً: الأقسام التعريفية فقط (Informational Tabs)

هذه الأقسام ستكون تعريفية وتسويقية (محتوى وصور ثابتة) بدون أي عمليات تشغيلية أو دفع أو حجوزات أونلاين في المرحلة الأولى.

**3. Service A (Wash)**

صفحة تعريفية تتضمن: وصف الخدمة، الصور، أوقات العمل، وزر اتصال مباشر أو تحويل للواتساب.

**4. Service B (Work)**

صفحة تعريفية تتضمن: صور مساحة العمل المشتركة، أسعار الباقات الثابتة، أوقات العمل، ووسائل التواصل.

**5. Service C (Locker)**

صفحة تعريفية تتضمن: شرح الخدمة، آلية استخدام الخزائن الذكية، الصور، وأوقات العمل.

⸻

### 5. الميزات الأساسية المطلوبة (MVP Features)

**أولاً: نظام الدخول والتسجيل (OTP Authentication)**

* تسجيل العميل برقم الجوال عبر OTP Verification وإنشاء عضوية رقمية تلقائية له في قاعدة البيانات.

**ثانياً: وضع الزائر (Guest Browsing Mode)**

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

**ثالثاً: نظام الرصيد والمكافآت (Internal Balance)**

* نظام Store Credit داخلي يسمح بشحن الرصيد، الحصول على رصيد إضافي (Bonus Balance)، واستخدام هذا الرصيد حصرياً داخل قطاعي الـ Station والـ Mart.

* *أمثلة على حملات الشحن المرجوة:* (اشحن 100 ريال ← احصل على 15 ريال Bonus) / (اشحن 300 ريال ← احصل على 60 ريال Bonus).

**رابعاً: الدفع والشحن**

* ربط بوابة الدفع (Tap أو Moyasar) لدعم مدى و Apple Pay، وتحديث الرصيد التلقائي في التطبيق عبر Webhooks و Make.com مباشرة بعد نجاح الدفع.

**خامساً: نظام الطلبات (Ordering System)**

* يشمل السلة، الـ Checkout، سجل الطلبات السابقة، وميزة إعادة الطلب السريع (Quick Reorder) بضغطة زر.

**سادساً: التكامل مع فوديكس (Foodics Integration)**

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

**سابعاً: نظام العضوية والـ QR**

* توليد معرف رقمي وكود QR فريد لكل عميل مسجل (QR Membership ID) يظهر في ملفه الشخصي لتمكين الكاشير من مسحه وتسجيل الزيارات أو احتساب المكافآت يدوياً إن لزم الأمر.

**ثامناً: Apple Wallet & Google Wallet**

* توفير زر "Add to Apple Wallet" لإنشاء بطاقة عضوية (Membership Pass) داخل محفظة الجوال الرسمية عبر PassKit، مع ميزة التحديث التلقائي للرصيد والنقاط المكتوبة على البطاقة عند أي عملية شحن أو شراء.

**تاسعاً: نظام المكافآت والعروض (Rewards Engine)**

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

**عاشراً: الإشعارات وأتمتة الواتساب**

* دعم الـ Push Notifications داخل تطبيق الويب، وربطه مع أتمتة الواتساب لإرسال رسائل تأكيد الشحن، فواتير الطلبات، والحملات التسويقية لتنشيط العملاء.

**حادي عشر: سجل العمليات (Transaction Logs)**

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

⸻

### 6. تجربة المستخدم المطلوبة (UX Goals)

* الأولوية القصوى هي: السرعة، البساطة، وتقليل خطوات الطلب (تجربة Mobile-first كاملة).

* الصفحة الرئيسية يجب أن تكون ديناميكية؛ تعرض (الرصيد الحالي، العروض, الأكثر طلباً، وزر سريع لشحن الرصيد وإعادة الطلب)، وليست مجرد قائمة بأقسام ثابتة.

⸻

### 7. متطلبات التوسع المستقبلي (Scalability)

* يجب تصميم قاعدة البيانات وهيكلية النظام بطريقة مرنة وقابلة للتوسع (Scalable Architecture)، بحيث يمكن مستقبلاً تحويل الأقسام التعريفية (Wash, Work, Locker) إلى خدمات تشغيلية كاملة (حجوزات، دفع، وتكاملات متطورة) دون الحاجة لإعادة بناء المنصة أو قاعدة البيانات من الصفر.

⸻

### 8. لوحة التحكم المطلوبة (Admin Panel)

* لوحة تحكم سحابية لإدارة: العملاء، الأرصدة والـ Bonus، العروض، الطلبات، الحملات التسويقية، الإشعارات الفورية، وتعديل المحتوى النصي والصور للأقسام التعريفية.

⸻

### 9. المخرجات المطلوبة من المطور (Deliverables)

1. تطبيق ويب PWA كامل وعصري عبر منصة Glide.

2. ربط النطاق الرسمي بنجاح وتأمين شهادة الـ SSL.

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

4. ربط الـ API بالكامل مع نظام فوديكس الفعلي.

5. إعداد وهندسة سيناريوهات الربط على Make.com.

6. إعداد وتوليد نظام بطاقات Apple Wallet & Google Wallet.

7. ضبط وتفعيل نظام الـ QR والـ Rewards Engine.

8. إعداد وتفعيل إشعارات الويب وبوت الواتساب المؤتمت.

9. تسليم لوحة التحكم السحابية بكامل الصلاحيات.

⸻

### 10. ملاحظات مهمة للمطور

* المشروع عبارة عن الحد الأدنى من المنتج (MVP) وليس نسخة Enterprise نهائية.

* التركيز على السرعة، الأمان، وسهولة الاستخدام.

* يجب بناء هندسة البيانات بطريقة تسمح مستقبلاً بالانتقال إلى Native App أو Backend مخصص عند نمو المشروع دون فقدان بيانات العملاء أو سجلاتهم المالية.

⸻

### 11. الهدف النهائي للمشروع

بناء منظومة عضوية يومية متكاملة تزيد من ولاء العميل والقيمة طويلة المدى (LTV)، وترتبط بعاداته اليومية، مع تقليل الاعتماد على منصات الطرف الثالث الخارجية وتوفير بيانات دقيقة (First-party Data) تقود قرارات التوسع المستقبلي بثبات.

"ملاحظة حاسمة للإدارة والمطورين: المشروع المطلوب لا يحتاج إلى برمجة خاصة من الصفر (No Custom Coding)، بل سيتم بناؤه بالكامل باستخدام أدوات الـ No-Code المتقدمة وتحديداً منصة Glide Apps وأداة Make.com لربط الـ APIs جاهزة، وهو ما يختصر وقت التجهيز إلى أيام قليلة فقط، ولذلك تم تحديد الميزانية لتناسب مهارة الـ No-Code وليس البرمجة التقليدية."