========================================
  Google Maps Scraper Pro v2.0
  سیستم پیشرفته استخراج اطلاعات از گوگل مپ
========================================

🎯 ویژگی‌های نسخه 2.0:
------------------------
✅ بدون نیاز به باز کردن تب مزاحم (تب در پس‌زمینه کار می‌کند)
✅ نوتیفیکیشن پیشرفته برای اطلاع از وضعیت
✅ Progress Bar زنده و دقیق
✅ قابلیت Pause/Resume در حین استخراج
✅ فیلتر هوشمند تکراری‌ها (بر اساس شماره تلفن)
✅ ارسال داده به صورت Batch برای سرعت بیشتر
✅ UI زیبا و کاربرپسند با فونت Vazirmatn FD
✅ نمایش آمار دقیق: کل، استخراج شده، رد شده
✅ کنترل کامل از طریق Popup یا Context Menu
✅ Badge روی آیکون برای نمایش تعداد
✅ سرعت بالاتر (زمان انتظار کاهش یافته)

📥 نصب:
--------
1. Chrome را باز کنید
2. به آدرس chrome://extensions بروید
3. Developer mode را فعال کنید (گوشه بالا سمت راست)
4. روی "Load unpacked" کلیک کنید
5. این پوشه را انتخاب کنید

⚙️ تنظیمات اولیه:
------------------
توجه: قبل از استفاده، فایل background.js را باز کنید
و خط 1 را بررسی کنید:

const BASE = "http://localhost/wa/google_map_data";

اگر آدرس پروژه شما متفاوت است، تغییر دهید.

🚀 نحوه استفاده:
-----------------
1. وارد پنل وب شوید: http://localhost/wa/google_map_data
2. تگ جستجو را وارد کنید (مثال: نانوایی)
3. محدوده جغرافیایی را انتخاب کنید (اختیاری)
4. روی "دریافت داده" کلیک کنید
5. Extension به صورت خودکار شروع به کار می‌کند
6. برای مشاهده پیشرفت، روی آیکون Extension کلیک کنید

🎮 کنترل در حین استخراج:
---------------------------
روش 1: از طریق Popup
  - روی آیکون Extension کلیک کنید
  - دکمه‌های Pause/Resume/Stop را استفاده کنید

روش 2: از طریق Context Menu
  - کلیک راست در هر جای صفحه
  - "Pause Scraping" یا "Resume Scraping" را انتخاب کنید

📊 نمایش پیشرفت:
------------------
- Badge روی آیکون: تعداد استخراج شده فعلی
- Popup: اطلاعات کامل (درصد، کل، استخراج شده، رد شده)
- Notification: اطلاع‌رسانی شروع و پایان

🔧 تنظیمات پیشرفته:
--------------------
در فایل background.js می‌توانید این موارد را تغییر دهید:

- BATCH_SIZE (خط 258): تعداد رکوردهای هر دسته (پیش‌فرض: 10)
- maxScrolls (خط 180): حداکثر تعداد اسکرول (پیش‌فرض: 15)
- زمان انتظار (خط 258): 2000ms = 2 ثانیه
- فاصله polling (خط 548): 5000ms = 5 ثانیه

⚠️ نکات مهم:
-------------
1. تب گوگل مپ را دستی نبندید (Extension خودش می‌بندد)
2. در حین استخراج، مرورگر را نبندید
3. اگر استخراج متوقف شد، از دکمه "Resume" استفاده کنید
4. برای لغو کامل، از دکمه "Stop" استفاده کنید
5. شماره‌های تکراری به صورت خودکار فیلتر می‌شوند

📁 فایل‌های پروژه:
-------------------
- manifest.json: تنظیمات Extension
- background.js: منطق اصلی استخراج
- popup.html: رابط کاربری
- popup.js: کنترل UI
- icon*.png: آیکون‌ها (باید اضافه شوند)

🎨 آیکون‌ها:
-------------
برای نمایش صحیح، 3 سایز آیکون نیاز است:
- icon16.png (16x16 پیکسل)
- icon48.png (48x48 پیکسل)
- icon128.png (128x128 پیکسل)

می‌توانید از هر نرم‌افزار طراحی استفاده کنید یا
از emoji 📍 به صورت تصویر ذخیره کنید.

🐛 عیب‌یابی:
-------------
مشکل: Extension کار نمی‌کند
حل: Developer Tools > Console را باز کنید و خطاها را بررسی کنید

مشکل: تب گوگل مپ باز نمی‌شود
حل: آدرس BASE در background.js را بررسی کنید

مشکل: داده‌ها ذخیره نمی‌شوند
حل: اطمینان حاصل کنید سرور PHP در حال اجرا است

مشکل: استخراج خیلی کند است
حل: زمان انتظار در background.js را کاهش دهید

🔄 بروزرسانی:
--------------
1. فایل‌های جدید را دانلود کنید
2. Extension را از chrome://extensions حذف کنید
3. مجدداً نصب کنید (Load unpacked)

📞 پشتیبانی:
-------------
برای راهنمایی بیشتر:
- سایت: http://localhost/wa/google_map_data
- ویدیو آموزشی: در پنل وب موجود است

========================================
ساخته شده با ❤️ برای بهبود کسب‌وکار شما
نسخه 2.0 - بهینه‌سازی شده و حرفه‌ای
========================================
