╔═══════════════════════════════════════════════════════════════════════════════╗
║                                                                               ║
║                    🚀 نظام التسويق الاحترافي المتقدم 🚀                      ║
║                        دليل الاستخدام المصور                                 ║
║                                                                               ║
╚═══════════════════════════════════════════════════════════════════════════════╝


┌─────────────────────────────────────────────────────────────────────────────┐
│                          📂 هيكل المشروع                                    │
└─────────────────────────────────────────────────────────────────────────────┘

search/
│
├── 📄 START_HERE.txt                ← ابدأ من هنا!
├── 📄 QUICK_START.md                ← دليل البدء السريع
├── 📄 INSTALL_AR.md                 ← دليل التثبيت
├── 📄 FEATURES_AR.md                ← شرح المميزات
├── 📄 PROJECT_SUMMARY.md            ← ملخص المشروع
│
├── 🔧 CORE FILES (الملفات الأساسية)
│   ├── app.py                       ← التطبيق الرئيسي
│   ├── config.py                    ← الإعدادات
│   ├── database.py                  ← قاعدة البيانات
│   ├── google_maps_scraper.py       ← استخراج البيانات
│   ├── ai_integration.py            ← الذكاء الاصطناعي
│   └── whatsapp_integration.py      ← إرسال WhatsApp
│
├── 🎨 FRONTEND (الواجهة)
│   ├── templates/
│   │   └── index.html               ← الصفحة الرئيسية
│   └── static/
│       ├── style.css                ← التصميم
│       └── script.js                ← البرمجة
│
├── ⚙️  SETUP (الإعداد)
│   ├── requirements.txt             ← المكتبات المطلوبة
│   ├── .env                         ← المفاتيح (موجود)
│   ├── setup_env.py                 ← إنشاء .env
│   └── .gitignore                   ← حماية الملفات
│
├── 🚀 RUN SCRIPTS (التشغيل)
│   ├── run.bat                      ← تشغيل Windows
│   ├── start.ps1                    ← تشغيل PowerShell
│   └── test_system.py               ← اختبار النظام
│
└── 📚 DOCUMENTATION (التوثيق)
    ├── README.md                    ← التوثيق الكامل
    └── VISUAL_GUIDE.txt             ← هذا الملف


┌─────────────────────────────────────────────────────────────────────────────┐
│                      🎯 كيفية الاستخدام (خطوة بخطوة)                       │
└─────────────────────────────────────────────────────────────────────────────┘

📍 الخطوة 1: التشغيل
═════════════════════
┌──────────────────────────┐
│  اضغط دبل كليك على:     │
│  ► run.bat               │
└──────────────────────────┘
        ↓
┌──────────────────────────┐
│  سيفتح المتصفح على:     │
│  http://localhost:5000   │
└──────────────────────────┘


📍 الخطوة 2: البحث
═══════════════════

┌────────────────────────────────────────┐
│  🔍 البحث عن الأعمال                  │
│  ────────────────────────              │
│  نوع العمل:   [مطاعم...............]  │
│  الموقع:      [الرياض.............]  │
│                                        │
│       [🔍 بدء البحث]                  │
└────────────────────────────────────────┘
        ↓
┌────────────────────────────────────────┐
│  ⏳ جارٍ البحث...                     │
│  [████████████░░░░░░] 70%             │
└────────────────────────────────────────┘
        ↓
┌────────────────────────────────────────┐
│  ✅ النتائج: 45 عمل تجاري            │
│  ────────────────────────              │
│  ☑ مطعم الواحة                        │
│     📍 الرياض - حي الملز               │
│     📞 +966 11 123 4567               │
│     ⭐ 4.5 (120 تقييم)               │
│  ────────────────────────              │
│  ☑ مطعم الفخامة                       │
│     📍 الرياض - حي العليا              │
│     📞 +966 11 234 5678               │
│     ⭐ 4.8 (85 تقييم)                │
└────────────────────────────────────────┘


📍 الخطوة 3: التخصيص بالذكاء الاصطناعي
═══════════════════════════════════════

┌────────────────────────────────────────┐
│  ✓ تم تحديد 15 عمل تجاري             │
│                                        │
│  [🤖 توليد رسائل بالذكاء الاصطناعي] │
└────────────────────────────────────────┘
        ↓
┌────────────────────────────────────────┐
│  🤖 مولد الرسائل الذكي                │
│  ────────────────────────              │
│  المحرك: [ChatGPT ▼]                  │
│                                        │
│  قالب الرسالة:                        │
│  ┌──────────────────────────────────┐ │
│  │ مرحباً {name} 👋                 │ │
│  │                                  │ │
│  │ نحن نقدم حلول تسويقية متقدمة... │ │
│  │ لمساعدة {category} على النمو... │ │
│  │                                  │ │
│  │ هل أنت مهتم؟ 🚀                 │ │
│  └──────────────────────────────────┘ │
│                                        │
│  [✨ توليد الرسائل]                   │
└────────────────────────────────────────┘
        ↓
┌────────────────────────────────────────┐
│  ✅ تم توليد 15 رسالة بنجاح           │
│                                        │
│  معاينة:                              │
│  ────────────────────────              │
│  📱 رسالة إلى: مطعم الواحة            │
│  ┌──────────────────────────────────┐ │
│  │ مرحباً مطعم الواحة 👋            │ │
│  │                                  │ │
│  │ نحن نقدم حلول تسويقية متقدمة    │ │
│  │ مصممة خصيصاً للمطاعم...         │ │
│  │                                  │ │
│  │ ✨ خدماتنا تشمل:                │ │
│  │ • إدارة التواصل الاجتماعي       │ │
│  │ • التصوير الاحترافي             │ │
│  │ • الإعلانات الممولة              │ │
│  │                                  │ │
│  │ هل أنت مهتم؟ 🚀                 │ │
│  └──────────────────────────────────┘ │
└────────────────────────────────────────┘


📍 الخطوة 4: إرسال WhatsApp
═══════════════════════════

┌────────────────────────────────────────┐
│  [📱 إرسال عبر الواتساب]              │
└────────────────────────────────────────┘
        ↓
┌────────────────────────────────────────┐
│  ⏳ جارٍ إرسال 15 رسالة...            │
│                                        │
│  [████████████████░░] 80%             │
│                                        │
│  ✅ مرسل: 12                          │
│  ⏳ قيد الإرسال: 2                    │
│  ❌ فشل: 1                            │
└────────────────────────────────────────┘
        ↓
┌────────────────────────────────────────┐
│  🎉 تم الإرسال بنجاح!                 │
│  ────────────────────────              │
│  ✅ نجح: 14 رسالة                     │
│  ❌ فشل: 1 رسالة                      │
│  📊 معدل النجاح: 93.3%                │
└────────────────────────────────────────┘


┌─────────────────────────────────────────────────────────────────────────────┐
│                        📊 لوحة التحكم - الإحصائيات                         │
└─────────────────────────────────────────────────────────────────────────────┘

┌──────────────┬──────────────┬──────────────┬──────────────┐
│   🏢 245     │   📢 12      │   📨 1,234   │   ✅ 94.5%   │
│ إجمالي       │ الحملات      │ رسائل        │ معدل         │
│ الأعمال      │ النشطة       │ مرسلة        │ النجاح       │
└──────────────┴──────────────┴──────────────┴──────────────┘


┌─────────────────────────────────────────────────────────────────────────────┐
│                            🔑 المفاتيح المضافة                              │
└─────────────────────────────────────────────────────────────────────────────┘

✅ DeepSeek API       : sk-8503c62d8ee5481aaf15e729674deb14
✅ OpenAI API        : sk-proj-5qNhw... (مضاف)
✅ Google Maps API   : AIzaSyAYGuFwowyd5OZ-ZTkw1MQMqpHdKturxS8

📝 ملاحظة: جميع المفاتيح تم إضافتها تلقائياً في ملف .env


┌─────────────────────────────────────────────────────────────────────────────┐
│                          ⚙️  APIs المتاحة                                   │
└─────────────────────────────────────────────────────────────────────────────┘

🔍 البحث:
   POST   /api/search              ← البحث عن أعمال
   GET    /api/businesses          ← جلب الأعمال المحفوظة

🤖 الذكاء الاصطناعي:
   POST   /api/ai/generate-message ← توليد رسالة واحدة
   POST   /api/ai/customize-bulk   ← تخصيص رسائل متعددة

📱 WhatsApp:
   POST   /api/whatsapp/send       ← إرسال رسالة واحدة
   POST   /api/whatsapp/send-bulk  ← إرسال رسائل متعددة

📊 الحملات:
   GET    /api/campaigns           ← جلب الحملات
   POST   /api/campaigns           ← إنشاء حملة

📈 الإحصائيات:
   GET    /api/stats               ← إحصائيات النظام


┌─────────────────────────────────────────────────────────────────────────────┐
│                      🎯 نصائح للحصول على أفضل النتائج                      │
└─────────────────────────────────────────────────────────────────────────────┘

💡 البحث:
   • كن محدداً: "مطاعم برجر" أفضل من "مطاعم"
   • جرب مناطق مختلفة
   • راجع التقييمات قبل الإرسال

💡 الرسائل:
   • خصص كل رسالة باسم العمل
   • اجعلها قصيرة ومباشرة (3-4 أسطر)
   • أضف emoji بذكاء 👋 ✨ 🚀
   • اختتم بسؤال أو دعوة للتواصل

💡 التوقيت:
   • أفضل وقت: 10 صباحاً - 2 ظهراً
   • تجنب: أوقات الذروة والعطلات
   • انتظر 3 أيام قبل المتابعة

💡 المتابعة:
   • راقب الإحصائيات يومياً
   • حلّل معدل النجاح
   • حسّن رسائلك بناءً على النتائج
   • احتفظ بسجل للردود


┌─────────────────────────────────────────────────────────────────────────────┐
│                          ⚠️  ملاحظات مهمة جداً                             │
└─────────────────────────────────────────────────────────────────────────────┘

🔒 الأمان:
   • لا تشارك ملف .env مع أحد
   • لا تنشر المفاتيح على الإنترنت
   • غيّر SECRET_KEY في الإنتاج

💰 التكاليف:
   • Google Maps: $0-50/شهر
   • AI (DeepSeek): $5-30/شهر
   • WhatsApp: $15-500/شهر
   • راقب استخدامك لتجنب مفاجآت

⚖️  القانون:
   • التزم بقوانين التسويق في بلدك
   • لا ترسل spam
   • احترم خصوصية المستلمين
   • احتفظ بسجل للموافقات


┌─────────────────────────────────────────────────────────────────────────────┐
│                         🆘 حل المشاكل السريع                                │
└─────────────────────────────────────────────────────────────────────────────┘

❌ "Python not found"
   → ثبّت Python من python.org وأضفه إلى PATH

❌ "Module not found"
   → شغّل: pip install -r requirements.txt

❌ "API Key Error"
   → تحقق من ملف .env وصحة المفاتيح

❌ "Port 5000 in use"
   → غيّر المنفذ في app.py إلى 8080

❌ "Database error"
   → شغّل: python database.py

✅ للتشخيص الشامل:
   → شغّل: python test_system.py


┌─────────────────────────────────────────────────────────────────────────────┐
│                          📚 مصادر إضافية                                    │
└─────────────────────────────────────────────────────────────────────────────┘

📖 START_HERE.txt        ← ابدأ من هنا
📖 QUICK_START.md        ← دليل سريع (5 دقائق)
📖 INSTALL_AR.md         ← تثبيت مفصل
📖 FEATURES_AR.md        ← شرح كل ميزة
📖 PROJECT_SUMMARY.md    ← ملخص شامل
📖 README.md             ← توثيق كامل


╔═══════════════════════════════════════════════════════════════════════════════╗
║                                                                               ║
║                          🎉 مبروك! أنت جاهز الآن 🎉                          ║
║                                                                               ║
║                     ابدأ رحلتك في التسويق الاحترافي                         ║
║                                                                               ║
║                  🚀 run.bat ← اضغط دبل كليك وابدأ!                          ║
║                                                                               ║
╚═══════════════════════════════════════════════════════════════════════════════╝



