# دليل المالك — يميّزا للأعمال

> **الجمهور:** صاحب المطعم/المقهى · المدير العام
> **صنف الجهاز:** ويب (Chrome/Edge على لابتوب أو iPad)
> **مدّة القراءة:** ~15 دقيقة · النسخة 1.0 · 2026-05-03

---

## 1. لوحة المالك على نظرة سريعة

عند الدخول من `https://yummaza.com/owner` ترى:

- **🟦 لوحة المعلومات (Dashboard)** — مبيعات اليوم + مقارنة بالأمس + أعلى صنف
- **📊 التحليلات** — تقارير عميقة (مبيعات، أرباح، عملاء، موظّفون)
- **📋 المنيو** — إدارة الفئات والأصناف والأسعار
- **👥 الموظّفون** — إضافة/تعديل/صلاحيّات + كشف الحضور
- **🏪 الفروع** — إضافة فرع جديد + ضبط ساعات العمل
- **💼 المحاسبة** — الفواتير + الضرائب + إقفال الفترات
- **🎁 الولاء** — برنامج النقاط + الفئات + العروض
- **⚙️ الإعدادات** — معلومات المتجر + الفواتير + التكاملات

---

## 2. لوحة المعلومات (Dashboard)

### 2.1 الأرقام السريعة (الجزء العلويّ)

| البطاقة | المعنى |
|---|---|
| **مبيعات اليوم** | إجماليّ المبيعات منذ منتصف الليل |
| **عدد الفواتير** | كم فاتورة اليوم |
| **متوسّط الفاتورة** | مبيعات/عدد |
| **النموّ** | مقارنة بنفس اليوم الأسبوع الماضي |

### 2.2 الرسوم البيانيّة

- **رسم خطّيّ:** المبيعات على مدار اليوم (24 ساعة) — يظهر ساعات الذروة
- **دونات:** نسبة كلّ قناة (Dine-in / Take-away / Delivery)
- **شريط:** أعلى 5 أصناف اليوم
- **خريطة:** توزيع طلبات التوصيل (Phase 18 — الحرارة)

### 2.3 التنبيهات الذكيّة (AI)

أعلى الشاشة قد ترى:
- **"⚠️ صنف لاتيه يحتاج 86 — المخزون 2 فقط"**
- **"💡 مبيعاتك انخفضت 20% الجمعة الماضية. السبب الأرجح: الطقس"**
- **"📈 صنف 'برغر سبايسي' هو نجم اليوم — 38% من المبيعات"**

---

## 3. إدارة المنيو

### 3.1 إنشاء فئة جديدة
1. **المنيو → الفئات → "+ فئة"**
2. أدخل:
   - الاسم (عربيّ + إنجليزيّ)
   - أيقونة (اختياري — اختر من المكتبة)
   - ترتيب العرض في POS
3. احفظ.

### 3.2 إضافة صنف
1. **المنيو → الأصناف → "+ صنف"**
2. أدخل:
   - **الاسم** (عربيّ/إنجليزيّ)
   - **الصورة** (1:1 مفضّل، أكبر من 800×800)
   - **السعر** + **التكلفة** (لحساب هامش الربح)
   - **الفئة**
   - **ETA المطبخ** (دقائق)
   - **ضريبة 15%** (مفعّلة افتراضيّاً)
3. **خيارات** (اختياريّ):
   - **مكوّنات الوصفة** — يربط الصنف بالمخزون
   - **خيارات** (modifiers) — حجم، إضافات، طريقة الطبخ
   - **متغيّرات** (variants) — صغير/وسط/كبير بأسعار مختلفة
4. **متاح في:** اختر الفروع (افتراضيّاً: كلّها)
5. احفظ.

### 3.3 تعديل سعر بسرعة
- **المنيو → الأصناف →** اضغط على السعر مباشرة → ادخل سعر جديد → Enter.
- التغيير يسري **فوراً** على كلّ نقاط البيع.

### 3.4 إخفاء/إظهار صنف
- **المنيو → الأصناف →** اضغط **مفتاح التشغيل** بجانب الصنف.
- Off = لا يظهر في POS لكن البيانات التاريخيّة محفوظة.

### 3.5 إيقاف صنف في فرع واحد فقط
- اضغط الصنف → **"التوفّر"** → اختر الفرع → عطّله.

### 3.6 4-Box Menu Engineering (تحليل المنيو)

شاشة قويّة تصنّف الأصناف في 4 مربّعات:

| المربّع | المعنى | الإجراء |
|---|---|---|
| 🟢 **النجوم** (مبيعات + هامش عاليان) | حافظ، ابرزها في الواجهة |
| 🟡 **خيول العمل** (مبيعات عالية، هامش منخفض) | ارفع السعر تدريجيّاً أو اخفض التكلفة |
| 🟠 **الأحجيات** (هامش عالي، مبيعات منخفضة) | روّج، أعد التسمية، ضعها بمكان أفضل |
| 🔴 **الكلاب** (الاثنان منخفضان) | احذفها — تأخذ مساحة |

افتح الشاشة من **التحليلات → 4-Box** → اختر المدّة (90 يوم افتراضيّاً).

---

## 4. الموظّفون والصلاحيّات

### 4.1 إضافة موظّف
1. **الموظّفون → "+ موظّف جديد"**
2. أدخل:
   - الاسم الكامل
   - الجوّال (يستخدمه للدخول)
   - البريد (اختياريّ)
   - **الدور** (cashier / chef / waiter / branch_manager / accountant)
   - الفروع المسموح بها
3. النظام يرسل **OTP عبر SMS** للموظّف لإنشاء كلمة مرور.

### 4.2 تعديل صلاحيّات
- اضغط الموظّف → **"الصلاحيّات"** → فعّل/عطّل لكلّ ميّزة.
- أمثلة شائعة:
  - **الكاشير لا يخصم بدون مدير:** عطّل "applyDiscount"
  - **الشيف لا يرى التقارير المالية:** عطّل "viewReports"

### 4.3 الورديات والحضور
- **الموظّفون → الحضور** → ترى من فتح ورديته اليوم + المدّة + المبيعات.
- يمكنك إقفال وردية موظّف يدويّاً لو نسي.

### 4.4 إنهاء خدمة موظّف
- اضغط الموظّف → **"إنهاء الخدمة"** → اختر التاريخ.
- بعد ذلك التاريخ، لا يستطيع الدخول، لكن السجلّات محفوظة.

---

## 5. الفروع

### 5.1 إنشاء فرع جديد (يحتاج باقة Professional أو أعلى)
1. **الفروع → "+ فرع جديد"**
2. أدخل:
   - الاسم
   - **العنوان الجغرافيّ** (اختر على الخريطة — مهمّ للتوصيل)
   - الجوّال
   - **ساعات العمل** (لكلّ يوم)
   - الرسوم الضريبيّة (افتراضيّاً 15%)
   - منطقة التوصيل (دائرة بالكيلومترات)
3. **انسخ من فرع موجود** أو ابدأ من الصفر:
   - المنيو + الأصناف + الإعدادات
4. احفظ.

### 5.2 إغلاق مؤقّت لفرع
- اضغط الفرع → **"إغلاق طارئ"** → سبب → مدّة.
- الـ POS يعطّل تلقائيّاً + الـ Marketplace يخفيه + التطبيق يبلّغ العملاء.

### 5.3 ساعات العمل الخاصّة
- **الفروع → الفرع → ساعات استثنائيّة:**
- مثال: العيد، رمضان، Black Friday → اضبط ساعات مختلفة لتاريخ معيّن.

---

## 6. الفواتير والضرائب

### 6.1 لوحة الفواتير
- **المحاسبة → الفواتير** → كلّ الفواتير الصادرة بترتيب زمنيّ
- **بحث:** برقم الفاتورة، اسم العميل، التاريخ، المبلغ
- **تصدير:** Excel / PDF / CSV لمراجعة المحاسب

### 6.2 ZATCA Phase 1 (مطبَّق)
- كلّ فاتورة تخرج برمز QR متوافق مع هيئة الزكاة.
- لا حاجة لإجراء يدويّ.

### 6.3 ZATCA Phase 2 (E-Invoicing — مطلوب الربط)
1. سجّل في **بوّابة فاتورة** [zatca.gov.sa/fatoora](https://zatca.gov.sa/fatoora)
2. اطلب **شهادة Onboarding** (Compliance CSID)
3. ارفعها في **الإعدادات → ZATCA → رفع الشهادة**
4. ابدأ **اختبار الفاتورة** من النظام → تأكّد من قبولها على بوّابة الزكاة
5. حوّل المتجر لوضع الإنتاج

### 6.4 إقفال الفترة المحاسبيّة
في نهاية كلّ شهر:
1. **المحاسبة → الإقفال → "بدء إقفال الشهر"**
2. النظام يعرض:
   - إجمالي المبيعات
   - الضرائب المستحقّة
   - الفواتير التي لم تُرسَل لـ ZATCA
   - أيّ مشاكل (فواتير منقوصة)
3. أصلح المشاكل → اضغط **"إقفال نهائيّ"**.
4. بعد الإقفال، لا يمكن تعديل أيّ فاتورة لذلك الشهر.

---

## 7. برنامج الولاء

### 7.1 تفعيل الولاء
1. **الولاء → "تفعيل البرنامج"**
2. اختر:
   - **اسم البرنامج** (مثلاً: نقاط القهوة)
   - **معدّل التحويل** (1 ريال = ؟ نقطة) — افتراضيّاً 1:1
   - **معدّل الاسترداد** (؟ نقطة = 1 ريال) — افتراضيّاً 100:1
3. حدّد الفئات (Tiers):
   - 🥉 **Bronze:** صفر-499 نقطة
   - 🥈 **Silver:** 500-1999 → 5% خصم
   - 🥇 **Gold:** 2000-4999 → 10% خصم
   - 💎 **Platinum:** 5000+ → 15% خصم + هديّة شهريّة

### 7.2 العروض الترويجيّة
- **الولاء → العروض → "+ عرض"**
- أمثلة:
  - **عرض ساعات الراحة:** 20% بين 2-5 عصراً
  - **اشتري واحد احصل واحد** على صنف معيّن
  - **توصيل مجّاني** فوق 100 ريال

### 7.3 إحصائيّات الولاء
- **الولاء → الإحصائيّات** → عدد الأعضاء، نقاط متراكمة، نقاط مستردّة، قيمة العمر للعضو.

---

## 8. التحليلات العميقة

### 8.1 تقرير المبيعات
- **التحليلات → المبيعات** → اختر فترة → اختر فروع → احصل على:
  - إجماليّ المبيعات
  - عدد الفواتير + متوسّط
  - حسب الفئة
  - حسب الكاشير
  - حسب القناة (Dine-in / Take-away / Delivery)
  - حسب طريقة الدفع

### 8.2 تقرير الأرباح (P&L)
- **التحليلات → الأرباح** →
  - الإيراد
  - تكلفة البضاعة المباعة (COGS)
  - **الهامش الإجماليّ**
  - الرواتب (يدويّ)
  - الإيجار (يدويّ)
  - **صافي الربح**

### 8.3 تقرير العملاء
- **التحليلات → العملاء** →
  - عدد العملاء الجدد
  - معدّل العودة
  - أعلى 10 عملاء قيمة
  - شرائح ذكيّة (نشطون، نائمون، مفقودون)

### 8.4 تقرير الموظّفين
- **التحليلات → الموظّفون** →
  - متوسّط فاتورة كاشير
  - سرعة المطبخ (شيف)
  - تقييمات العملاء (نادل)

---

## 9. المسوّدة والإعدادات

### 9.1 معلومات المتجر
- **الإعدادات → معلومات الشركة:**
  - اسم تجاريّ
  - **رقم ضريبيّ ZATCA**
  - السجل التجاريّ
  - شعار يظهر على الفواتير

### 9.2 الباقة والاشتراك
- **الإعدادات → الاشتراك:**
  - الباقة الحاليّة + الفترة + التجديد التلقائيّ
  - **ترقية / تخفيض** الباقة
  - **تحميل الفواتير** السابقة
  - **تحديث طريقة الدفع**

### 9.3 التكاملات
- **الإعدادات → التكاملات:**
  - **WhatsApp Business** — للإشعارات
  - **Google Maps** — للتوصيل
  - **MailChimp / Brevo** — للحملات الترويجيّة
  - **POS Hardware** — الطابعات والقارئات

### 9.4 النسخ الاحتياطيّ
- **الإعدادات → البيانات → "تصدير شامل"**
- يصلك ملفّ ZIP يحتوي JSON + CSV لكلّ بياناتك.
- يُنصَح بتنزيل نسخة شهريّة.

---

## 10. الفواتير الذكيّة وتنبيهات AI

النظام يرسل تنبيهات تلقائيّة عبر:
- **بريد:** ملخّص الأسبوع كلّ يوم اثنين
- **WhatsApp/SMS** (لو فعّلته):
  - "عملك انخفض اليوم 25% — راجع المبيعات"
  - "الكاشير X سجّل 3 خصومات كبيرة، راجع الورديّة"
  - "صنف Y نَفَد للمرّة الثالثة هذا الأسبوع"
- **داخل التطبيق:** الجرس أعلى الشاشة

تستطيع تخصيص نوع التنبيهات من **الإعدادات → التنبيهات**.

---

## 11. الأمان والوصول

### 11.1 المصادقة الثنائيّة
- **الإعدادات → الأمان → 2FA** → امسح QR من تطبيق Google Authenticator.
- بعد التفعيل، كلّ دخول يحتاج رمز 6 أرقام.

### 11.2 سجلّ الوصول
- **الإعدادات → الأمان → سجلّ النشاط**
- يعرض كلّ من دخل ومتى ومن أيّ جهاز.
- لو رأيت دخولاً مشبوهاً → اضغط **"إنهاء كلّ الجلسات"** فوراً.

### 11.3 IP محدَّد
- باقات Enterprise: قَيِّد الدخول بعنواين IP المتجر/المنزل.

---

## 12. أسئلة شائعة

**س: كم فرع يمكنني إضافته؟**
ج: حسب الباقة:
- Free: 1
- Starter: 1
- Professional: 5
- Enterprise: غير محدود

**س: هل أستطيع حذف فاتورة بالخطأ؟**
ج: لا — الفواتير لا تُحذَف. لكن تستطيع **إلغاءها** (Void) بسبب موثَّق. الفاتورة تبقى في السجلّ مع علامة "ملغاة".

**س: نسيت كلمة المرور؟**
ج: اضغط "نسيت كلمة المرور" في صفحة الدخول → يصلك رابط للبريد المسجَّل.

**س: هل يدعم النظام عملات غير الريال؟**
ج: حاليّاً يميّزا تركّز على السوق السعوديّ (SAR). دعم عملات أخرى قادم في Phase 19.

**س: هل بياناتي آمنة؟**
ج: نعم — مشفّرة (TLS 1.3 + Database encryption) + نسخ احتياطيّة يوميّة + امتثال لـ PDPL السعوديّ. اقرأ [سياسة الخصوصيّة](https://yummaza.com/legal/privacy.html).

**س: لو ألغيت الاشتراك، ماذا يحدث لبياناتي؟**
ج: تحصل على ملفّ تصدير شامل خلال 30 يوم. بعد ذلك، تُحذَف نهائيّاً.

---

## 13. التواصل

- **الدعم العام:** [support@yummaza.com](mailto:support@yummaza.com)
- **مشاكل الفواتير:** [billing@yummaza.com](mailto:billing@yummaza.com)
- **استشارات تجاريّة (Enterprise):** [success@yummaza.com](mailto:success@yummaza.com)
- **WhatsApp Business:** +966 50 0000 000

---

*يميّزا أداة قوية، لكنّها تحتاج 2-3 أسابيع لإتقانها. ابدأ بـ Dashboard + Menu + Reports — الباقي تكتشفه تدريجيّاً. لأيّ سؤال، نحن معك.*