# ⚡ DZQCOD

نظام إدارة الطلبات COD الأكثر تكاملاً لـ WooCommerce — من الطلب إلى التوصيل والمحاسبة، كل شيء في إضافة واحدة

46+إضافة
19 شركة شحن
15 حالة طلب
11 دولة عربية
14 قالب نموذج
12 ملف إضافة

## 📥 التثبيت

#### تحميل الملف

حمّل `dzqcod-v3.0.8-fixed.zip` من حسابك في productes.nibra.cloud

#### رفع الإضافة

من لوحة ووردبريس → إضافات → أضف جديد → رفع إضافة → اختر الملف ZIP → تثبيت

#### تفعيل الإضافة

اضغط "تفعيل" — ستظهر قائمة DZQCOD في الشريط الجانبي لووردبريس

#### إدخال الترخيص

اذهب لـ DZQCOD → الترخيص → أدخل مفتاح الترخيص → تفعيل

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

WordPress 5.8+ | WooCommerce 6.0+ | PHP 8.0+ | MySQL 5.7+

## 🔑 الترخيص

النظام يتصل بـ `productes.nibra.cloud` عبر NIBRA License API للتحقق من الترخيص.

#### كيف يعمل الترخيص؟

- عند إدخال المفتاح — يتصل بسيرفر WHMCS ويتحقق من الحالة
- إذا Active — يفعّل الخطة (PRO أو Enterprise) تلقائياً
- يكتشف الخطة من `productname` أو `productid` في WHMCS
- يمكن تخصيص ربط Product IDs من صفحة الترخيص
- تحقق يومي تلقائي — إذا انتهت الصلاحية تنزل الخطة لـ free
- لا يوجد تفعيل محلي — يجب تأكيد السيرفر

## 💎 الخطط والأسعار

🆓
مجاني
0 دج

- نموذج طلب سريع
- مركز اتصال
- 15 حالة طلب
- 58 ولاية + 1541 بلدية
- نقطة بيع POS
- طباعة A5/A4/حراري
- 2 قالب تصميم
- شركة شحن واحدة
- Chargily Pay

مثبت مسبقاً
⚡
PRO
4,900 دج/سنة

- كل ميزات المجاني +
- 19 شركة شحن
- واتساب + SMS آلي
- Meta CAPI + TikTok + Google
- 14 قالب تصميم
- A/B Testing
- مكافحة احتيال
- Upsell + Order Bump
- Smart Ops أتمتة
- 11 دولة عربية
- OTP تحقق

🛒 اشترِ PRO
🏢
ENTERPRISE
9,900 دج/سنة

- كل ميزات PRO +
- نظام محاسبي كامل
- AI Copilot (16 نوع)
- Canva Creative (مصمم)
- Workflows (أتمتة)
- Multi-Store
- CRM (HubSpot/Zoho)
- Email Marketing
- Cohort Analysis
- Form Heatmap
- Instagram Shop

🛒 اشترِ ENTERPRISE

## 📦 إدارة الطلبات FREE

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

### 15 حالة طلب

استقبال ← بانتظار الاتصال ← مؤكد ← جاهز للشحن ← مشحون ← قيد التوصيل ← تم التسليم ← مرتجع ← ملغى ← Callback ← مؤجل ← مكرر ← احتيال ← مدفوع جزئياً ← مسترجع

📊

#### لوحة تحكم

إحصائيات فورية مع فلترة

🔍

#### بحث وفلترة

حسب الحالة، التاريخ، الولاية

📤

#### تصدير CSV

تصدير كل الطلبات

🗑️

#### حذف

حذف فردي وجماعي

📝

#### ملاحظات

ملاحظات على كل طلب

🔄

#### تغيير جماعي

تغيير حالة عدة طلبات

## 📝 نموذج الطلب السريع FREE

يحل محل صفحة الدفع الافتراضية في WooCommerce. نموذج COD مخصص بالكامل مع RTL.

### مصمم النموذج

- 14 قالب تصميم — من بسيط إلى احترافي
- سحب وإفلات لترتيب الحقول
- تخصيص كامل: ألوان، خطوط، خلفيات، ظلال، حدود
- نوع التوصيل: منزل/مكتب — قابل للتعطيل والتخصيص من الإعدادات
- حقول مخصصة غير محدودة
- شريط اطلب الآن الثابت
- Popup Form نموذج منبثق

### الحقول

الاسم، اللقب، الهاتف، الولاية (58)، البلدية (1541)، العنوان، نوع التوصيل، الكمية، الملاحظات، + حقول مخصصة.

## 📞 مركز الاتصال FREE

- قائمة انتظار تلقائية للطلبات الجديدة
- تسجيل كل محاولة اتصال (النتيجة + الملاحظات)
- جدولة Callback مع تاريخ ووقت
- تاريخ المكالمات لكل طلب
- إحصائيات أداء الوكلاء

## 🖥️ نقطة البيع POS FREE

- بحث سريع بالباركود أو الاسم
- إنشاء طلب فوري
- طباعة وصل حراري فوري
- تطبيق الكوبونات والعروض
- لوحة ورشة (صيانة + خدمات)

## 🏷️ المنتجات FREE

- إدارة كاملة من داخل DZQCOD
- منتجات مخصصة: أبعاد، خيارات مدفوعة، رفع ملفات، حاسبة سعر
- حاسبة أرباح ROAS لكل منتج
- منتجات رقمية (تسليم تلقائي)

## 🖨️ الطباعة FREE

- وصولات A5 و A4
- طباعة حرارية (80mm/58mm)
- طباعة جماعية (دفعة)
- شعار المتجر + باركود
- طباعة بوليصة الشحن

## 🚚 شركات الشحن (19) PRO

الشركة | الدول | API | الخطة
--- | --- | --- | ---
Yalidine | 🇩🇿 | ✅ كامل | FREE
ZR Express | 🇩🇿 | ✅ كامل | FREE
EcoTrack | 🇩🇿 | ✅ كامل | FREE
NOEST Delivery | 🇩🇿 | ✅ كامل + Stop Desk | FREE
Maystro Delivery | 🇩🇿 | ✅ | PRO
Procolis | 🇩🇿 | ✅ | PRO
DHD Express | 🇩🇿 | ✅ | PRO
Guiddini | 🇩🇿 | ✅ | PRO
Connexlog | 🇩🇿 | ✅ | PRO

+ 10 شركات أخرى مع API: إنشاء شحنة، تتبع حي، طباعة بوليصة، تحديث تلقائي للحالة.

## 📈 التسويق والحملات PRO

📈

#### UTM Tracking

تتبع مصدر كل طلب — Facebook, Google, TikTok, Direct

📲

#### Meta CAPI

Facebook Conversions API — إرسال أحداث الشراء server-side

🎵

#### TikTok Events

تتبع تحويلات TikTok Pixel و Events API

🔍

#### Google Ads

إرسال تحويلات لـ Google Ads Conversion Tracking

💬

#### WhatsApp Auto

رسائل تلقائية لكل تغيير حالة — قوالب مخصصة

📱

#### SMS Auto

13 مزود SMS + رمز OTP للتحقق قبل الطلب

🔬

#### A/B Testing

اختبار نسخ مختلفة من النموذج — معدل تحويل مباشر

💥

#### Popup Form

نموذج منبثق مع توقيت وتريجر ذكي

## 🛡️ مكافحة الاحتيال PRO

- Fraud Score — نقاط خطورة تلقائية لكل طلب
- كشف ذكي: أرقام مكررة، عناوين مشبوهة، IP أجنبي
- قائمة سوداء: هاتف، IP، بريد — حظر تلقائي
- IP Geolocation: كشف الدولة الحقيقية
- Phone OTP: رمز تحقق SMS قبل الطلب

## 🤖 الأتمتة الذكية PRO

🧠

#### Smart Confirm

تأكيد تلقائي ذكي حسب سجل الزبون

🚚

#### Auto-Ship

إنشاء شحنة تلقائي بعد التأكيد

📨

#### Follow-up

تسلسلات متابعة: مراجعة + إعادة شراء

✈️

#### Telegram Bot

إشعارات + إدارة عبر تلجرام

## 🛍️ زيادة المبيعات PRO

🛍️

#### Upsell

منتجات مكمّلة لرفع متوسط السلة

⚡

#### Order Bump

منتج إضافي بخصم قبل الطلب

🔄

#### Abandoned Cart

استرجاع من لم يكمل — SMS + واتساب

🏆

#### Loyalty Points

نقاط ولاء — اطلب واكسب وفّر

🤝

#### Referral

إحالة + عمولة لكل طلب

🎁

#### عروض متقدمة

كوبونات + تسعير كمي + عروض ساخنة

## 🧾 النظام المحاسبي ENTERPRISE

نظام محاسبي كامل متوافق مع النظام المحاسبي الجزائري SCF/PCN — فواتير، ضرائب، سجل يومي، تقارير مالية.

### الفواتير

- 5 أنواع: فاتورة بيع (FA) | فاتورة شراء (FC) | إشعار دائن (AV) | شكلية (PF) | بون تسليم (BL)
- ترقيم تلقائي: `FA-2026-00001`
- بنود متعددة: البيان + الوحدة (8 أنواع) + الكمية + السعر + TVA% + المجموع
- بحث المنتجات من WooCommerce مع السعر 🔍
- المبلغ بالحروف: "توقفت هذه الفاتورة عند مبلغ: ثلاثة عشر ألف دينار جزائري"
- 🖨️ طباعة الفاتورة — ترويسة + زبون + بنود + مجاميع + توقيعات
- 📄 وصل تسليم — معلومات المتجر + المستلم + المنتجات (بدون أسعار) + خانة تاريخ فارغة

### الزبائن

- قاعدة بيانات مستقلة: الاسم، الهاتف، البريد، العنوان، الولاية، NIF، NIS، AI، RC
- بحث تلقائي عند كتابة اسم الزبون في الفاتورة (autocomplete)
- حفظ تلقائي عند حفظ أي فاتورة

### الضرائب الجزائرية

الضريبة | النسبة | الوصف
--- | --- | ---
TVA | 0% / 9% / 19% | الرسم على القيمة المضافة
TAP | 1% | الرسم على النشاط المهني
IRG | 5% | الضريبة على الدخل (COD)
الطابع | 50 دج | طابع جبائي لكل فاتورة

### G50 + التقارير

- تصريح G50 شهري تلقائي: TVA + TAP + IRG + الطابع
- ميزان المراجعة (Trial Balance)
- حساب الأرباح والخسائر (P&L)
- تصدير CSV

## 🤖 AI Copilot ENTERPRISE

محرك محتوى تسويقي ذكي — يعمل بدون API (40+ قالب) + مع OpenAI أو Anthropic Claude.

📢

#### 16 نوع محتوى

إعلان FB/Insta/TikTok، وصف منتج، SMS، واتساب، بريد، سوشيال، قصة، SEO، FAQ...

🎭

#### 9 أساليب كتابة

احترافي، ودي، عاجل، مرح، فاخر، عاطفي، علمي، استفزازي...

🧠

#### 6 Frameworks

AIDA, PAS, BAB, FAB, 4U, STAR

⚡

#### إنشاء جماعي

زر واحد = إعلان + SMS + واتساب

#### إعدادات API

في صفحة AI Copilot → قسم "إعدادات API" → اختر المزود (OpenAI أو Anthropic) → أدخل API Key → حفظ. بدون API يعمل بقوالب ذكية مخصصة للسوق الجزائري بالدارجة.

## 🎨 Canva Creative ENTERPRISE

مصمم إعلانات احترافي بـ HTML5 Canvas مع معاينة حية.

- 16 خلفية gradient — اختر بالنقر
- 5 قوالب: بانر 1200×628 | ستوري 1080×1920 | مربع 1080×1080 | غلاف FB 1640×624 | عريض 1920×1080
- جلب المنتج تلقائياً (صورة + سعر + سعر قديم مشطوب)
- 7 شارات: عرض خاص، الأكثر مبيعاً، جديد، حصري، محدود...
- ألوان النص + CTA قابلة للتخصيص
- 📥 تحميل PNG + 💾 حفظ في مكتبة الوسائط

## ⚡ Workflows ENTERPRISE

محرك أتمتة قوي — أنشئ قواعد تلقائية تشتغل على كل طلب.

المحفزات (11) | الإجراءات (10) | الشروط (7)
--- | --- | ---
طلب جديد، تأكيد، شحن، تسليم، مرتجع، إلغاء، دفع، احتيال، مخزون منخفض، زبون جديد، تقييم | واتساب، SMS، بريد، تغيير حالة، تعيين وكيل، ملاحظة، شحنة، وسم، Webhook، تأخير | المبلغ، الولاية، المنتج، عدد طلبات الزبون، وسيلة الدفع، شركة الشحن

## 🏢 إضافات Enterprise الأخرى

🏪

#### Multi-Store

متاجر متعددة — اسم، دومين، هاتف، ولاية، لون. تبديل بنقرة.

📊

#### Cohort Analysis

جدول Cohort حقيقي — عودة الزبائن شهرياً بنسب ملونة

🔥

#### Form Heatmap

تتبع تفاعل كل حقل في النموذج — وقت + مغادرات + أشرطة حرارية

📧

#### Email Marketing

Mailchimp + Brevo — إضافة تلقائية + مزامنة جماعية

🔗

#### CRM Integration

HubSpot — Contact + Deal تلقائي لكل طلب

📸

#### Instagram Shop

جلب منشورات + شورت كود `[dzqcod_instagram]`

📢

#### Ads Manager

10 أنواع إعلانات، 17 منطقة، استهداف ذكي، جدولة، تحليلات

## ⚙️ الإعدادات

- عامة: اسم المتجر، الدولة، العملة، الهاتف
- النموذج: تبويب كامل في المصمم — ألوان، خطوط، حقول
- الشحن: API Key + Webhook لكل شركة
- الواتساب: رقم + قوالب رسائل لكل حالة
- الترخيص: WHMCS Product ID mapping
- المحاسبة: NIF، NIS، AI، RC، TVA%، الطابع، اسم الشركة
- AI Copilot: OpenAI أو Anthropic API Key
- Email/CRM: Mailchimp/Brevo/HubSpot API Keys

## 🌍 الدول المدعومة (11)

الدولة | العملة | بادئة | TVA | الولايات
--- | --- | --- | --- | ---
🇩🇿 الجزائر | DZD (دج) | +213 | 19% | 58
🇹🇳 تونس | TND | +216 | 19% | 24
🇲🇦 المغرب | MAD | +212 | 20% | 12
🇱🇾 ليبيا | LYD | +218 | 0% | 22
🇪🇬 مصر | EGP | +20 | 14% | 27
🇸🇦 السعودية | SAR | +966 | 15% | 13
🇦🇪 الإمارات | AED | +971 | 5% | 7
🇮🇶 العراق | IQD | +964 | 0% | 18
🇯🇴 الأردن | JOD | +962 | 16% | 12

## 💾 قاعدة البيانات (20+ جدول)

الجدول | الوصف
--- | ---
`dz_wilayas` | 58 ولاية
`dz_communes` | 1541 بلدية
`dz_call_logs` | سجل المكالمات
`dz_fraud_scores` | نقاط الاحتيال
`dz_blacklist` | القائمة السوداء
`dz_shipping_labels` | بوليصات الشحن
`dz_addons` | الإضافات
`dz_audit_log` | سجل التدقيق
`dz_acc_invoices` | الفواتير
`dz_acc_inv_items` | بنود الفواتير
`dz_acc_expenses` | المصاريف
`dz_acc_journal` | السجل اليومي
`dz_acc_tax_returns` | التصريحات
`dz_acc_customers` | الزبائن
`dz_stores` | المتاجر
`dz_workflows` | سير العمل
`dz_heatmap` | تتبع النموذج

## 👨‍💻 للمطورين

### هيكل الملفات

    dzqcod/
    ├── dzqcod.php              # Main plugin (v3.0.8)
    ├── includes/
    │   ├── Core.php            # 2,070 lines — Logic, AJAX, License
    │   ├── Modules.php         # 841 lines — Addons, RBAC, Countries
    │   ├── Installer.php       # 432 lines — DB migrations
    │   ├── Shipping.php        # 772 lines — 19 providers API
    │   ├── SmartOps.php        # 783 lines — Auto-confirm/ship
    │   ├── SalesBoost.php      # 373 lines — Upsell, Order Bump
    │   ├── Integrations.php    # 521 lines — Sheets, Zapier
    │   └── TelegramBot.php     # 154 lines — Telegram (isolated)
    ├── addons/                 # 12 files, 2,888 lines
    │   ├── accounting-pro.php  # 524 lines
    │   ├── ads-manager.php     # 1,207 lines
    │   ├── ai-copilot.php      # 305 lines
    │   ├── canva.php           # 232 lines
    │   ├── workflows.php       # 98 lines
    │   └── ... (7 more)
    ├── templates/              # 27 admin pages
    └── docs/                   # This documentation

### Hooks

- `dzqcod_order_created($order_id, $order)` — بعد إنشاء طلب
- `dzqcod_admin_page_{slug}` — صفحة إدارية لإضافة
- `woocommerce_order_status_changed` — تغيير حالة

### إنشاء إضافة

أنشئ `addons/my-addon.php` → namespace `DZQCOD\Addons` → تحقق `Modules::is_on('slug')` → سجّل AJAX + admin page → `MyClass::init()`

## 🚀 ابدأ مع DZQCOD الآن!

حوّل متجرك إلى آلة مبيعات مع أقوى نظام COD

🛒 اشترِ الترخيص