نقل وبرمجة موقع lovable

نظام إدارة منتجات + مبيعات + طلبات + QR + كوبونات + نظام عملاء

1. فكرة النظام

نظام متكامل لإدارة:

- المنتجات

- QR Codes

- المخزون

- المبيعات داخل الكشك

- الطلبات من الموقع الإلكتروني

- العملاء (برقم الهاتف)

- الكوبونات والخصومات

- نظام نقاط مستقبلي

2. مبدأ أساسي (مهم جدًا)

QR Code هو معرف (ID) فقط وليس المنتج نفسه.

- كل QR يمثل قطعة واحدة

- يمكن ربط عدة QR لنفس المنتج

- كل QR يمر بحالات (Lifecycle)

3. حالات QR

- new → جديد

- assigned → مربوط بمنتج

- sold → تم بيعه

- returned → تم إرجاعه

- inactive → ملغي

4. نظام المستخدمين (Users & Roles)

Admin:

- تحكم كامل

Seller:

- بيع المنتجات

- إرجاع المنتجات

- عرض المنتجات

### Inventory:

- إضافة منتجات

- ربط QR

- إدارة المخزون

5. تتبع العمليات (Audit Log)

# Activity Logs Table:

- id

- user_id

- action:

- create_product

- sell_product

- return_product

- add_stock

- update_price

- target_type (product, qr, order)

- target_id

- details (JSON)

- created_at

6. قاعدة البيانات

QR Codes

- id

- status

- product_id (nullable)

Products

- id

- name

- description

- buy_price

- sell_price

- image

- category_id

---

# Inventory

- product_id

- quantity

---

### Sales

- id

- qr_id

- product_id

- sell_price

- sold_by (user_id)

- created_at

---

# Returns

- id

- qr_id

- product_id

- returned_by (user_id)

- reason (optional)

- created_at

## 7. إرجاع المنتج (Reverse Flow)

### السيناريو:

1. Scan QR

2. إذا الحالة = sold:

- يظهر خيار: "إرجاع المنتج"

# عند تأكيد الإرجاع:

SYSTEM:

- تغيير حالة QR → returned

- زيادة المخزون +1

- تسجيل العملية في جدول Returns

- تسجيلها في Activity Log

8. نظام العملاء (Customers)

كل رقم هاتف = حساب

Customers Table:

- id

- name (optional)

- phone (unique)

- total_orders

- total_spent

- points

## 9. نظام الطلبات (Orders)

### Orders:

- id

- customer_id

- phone

- location

- status (pending, confirmed, shipped, delivered, cancelled)

- total_price

- discount_value

- final_price

- created_at

---

### Order Items:

- id

- order_id

- product_id

- quantity

- price

---

## 10. الموقع الإلكتروني (Customer Website)

### عرض المنتجات:

- يتم جلبها من الداشبورد مباشرة

### عملية الطلب:

- الاسم

- رقم الهاتف

- الموقع

- الدفع عند الاستلام (COD)

---

## 11. نظام الكوبونات (Coupons)

### Coupons Table:

- id

- code

- type (percentage / fixed)

- value

- max_uses

- used_count

- max_uses_per_user

- expires_at

- is_active

---

### Coupon Usage:

- id

- coupon_id

- customer_id

- order_id

---

## 12. تطبيق الكوبون

SYSTEM يتحقق من:

- الكوبون فعال

- غير منتهي

- لم يتجاوز الحد

- المستخدم لم يتجاوز استخدامه

ثم يتم تطبيق الخصم

---

## 13. نظام النقاط (أساس مستقبلي)

- إضافة نقاط عند الشراء

- مثال:

- كل مبلغ معين = نقاط

يمكن لاحقًا:

- استبدال نقاط

- مكافآت

- مهام

---

## 14. إشعارات واتساب

### للزبون:

- تفاصيل الطلب

- السعر

- المنتجات

### للإدارة / البائع:

- تفاصيل الطلب

- رقم الزبون

- الموقع

---

## 15. Flow البيع داخل الكشك

1. Scan QR

2. عرض المنتج

3. تعديل السعر (ضمن حدود)

4. تأكيد البيع

SYSTEM:

- خصم من المخزون

- تغيير QR إلى sold

- تسجيل العملية

- تسجيل البائع

---

## 16. Flow الإرجاع

scan QR

IF status = sold:

show "Return Product"

ON confirm:

status → returned

inventory +1

save return

---

## 17. Flow الطلب من الموقع

User selects products

→ submit order

SYSTEM:

- create order

- save order items

- reduce stock

- send WhatsApp to customer

- send WhatsApp to admin

---

## 18. لوحة التحكم (Dashboard)

### إدارة:

- المنتجات

- QR Codes

- الطلبات

- العملاء

- الكوبونات

---

### الإحصائيات:

- إجمالي المبيعات

- الأرباح

- أفضل المنتجات

- أفضل البائعين

- أفضل العملاء

---

## 19. ميزات إضافية

- حد أدنى وأعلى لسعر البيع

- سجل كامل لكل العمليات

- تتبع:

- من باع

- من رجّع

- من عدل

---

## 20. متطلبات تقنية

- UUID أو NanoID لتوليد IDs

- منع التكرار

- API سريع

- تكامل WhatsApp API

- تصميم Mobile First

---

## 21. الهدف النهائي

بناء نظام متكامل يجمع بين:

- البيع داخل الكشك (QR)

- البيع أونلاين (Website)

مع قابلية التوسع مستقبلاً (نقاط، مكافآت، نظام ولا

https://zaytun-point.lova...

وهذا لمثال