انبار Wireless (POP سایت) — راهنمای ادمین شرکت

← بازگشت به راهنما

انبار Wireless (POP سایت) — راهنمای ادمین شرکت



| فیلد | مقدار |
|------|--------|
| **نسخه** | 1.2 |
| **آخرین بروزرسانی** | 2026-08-03 |
| **ماژول** | Inventory (Wireless POP) |
| **مخاطب** | ادمین شرکت (Tenant `/panel`) |

---

هدف



پوشش جغرافیایی سرویس وایرلس: هر **POP سایت** یک **موقعیت روی نقشه** و **شعاع پوشش** دارد. مشتری/ریسلر هنگام خرید روی نقشه نقطه انتخاب می‌کند؛ سیستم همان لحظه چک می‌کند نقطه داخل شعاع حداقل یک POP فعال باشد.

---

منو



مسیر: `/panel` → **انبار** → **Wireless**

| زیرمنو | توضیح |
|--------|--------|
| **POP سایت‌ها** | ساخت/ویرایش تکی، ایمپورت Excel، نمونه فایل |
| **نقشه پاپ سایت** | نمایش همه POPها با آیکون آنتن و دایره پوشش |

| فیلد | توضیح |
|------|--------|
| نام / کلید | هویت POP |
| موقعیت | انتخاب از روی نقشه — نمایش به شکل `(27.19182, 56.350749)` |
| شعاع (متر) | مثلاً `2000` = ۲ کیلومتر |
| فعال | فقط POPهای فعال در چک پوشش شرکت می‌کنند |

Lat/Lng جداگانه در فرم تکی نیست؛ با کلیک یا کشیدن نشانگر روی نقشه تنظیم می‌شود.

ایمپورت Excel



مسیر: **POP سایت‌ها** → **ایمپورت Excel** (یا دانلود **نمونه Excel**)

| ستون | الزامی | توضیح |
|------|--------|--------|
| `name` / نام | بله | نام POP |
| `latitude` / عرض | بله | مثلاً `35.708904` |
| `longitude` / طول | بله | مثلاً `51.408758` |
| `slug` / کلید | خیر | اگر خالی باشد از نام ساخته می‌شود |
| `radius_meters` / شعاع | خیر | پیش‌فرض فرم ایمپورت (مثلاً ۲۰۰۰ متر) |
| `is_active` / فعال | خیر | `1`/`0` یا فعال/غیرفعال |
| `notes` / یادداشت | خیر | |

گزینه **به‌روزرسانی POPهای موجود** روی همان `slug` مختصات و شعاع را عوض می‌کند.

---

اتصال به محصول (از طریق افزونه)



  • محصول اصلی با `service_type = Wireless`

  • **افزونه مستقل** بسازید:

  • - اتصال به انبار = **پوشش وایرلس (POP سایت)**
    - فیلد سفارشی نوع **نقشه (map.ir)** — ترجیحاً اجباری
  • افزونه را به محصول وصل کنید؛ در صورت نیاز تیک **اجباری**

  • تنظیمات map.ir در `/panel` → تنظیمات → اتصال نقشه


  • ---

    جریان خرید



  • مشتری/ریسلر محصول (+ افزونه اجباری) را می‌خرد

  • روی نقشه نقطه را انتخاب می‌کند

  • **همان لحظه** پوشش چک می‌شود:

  • - خارج از محدوده → پیام قرمز زیر نقشه؛ دکمه ثبت سفارش کار نمی‌کند
    - داخل محدوده → پیام سبز با نام POP نزدیک؛ اجازه ادامه خرید
  • سمت سرور هم هنگام ثبت سفارش دوباره چک می‌شود

  • نزدیک‌ترین POP پوشش‌دهنده در فیلدهای سفارشی آیتم افزونه ذخیره می‌شود (`wireless_pop_site_name`)

  • خود فیلد نقشه به‌صورت JSON ذخیره می‌شود: `{ lat, lng, address }` — در جزئیات سفارش **آدرس + مختصات** نمایش داده می‌شود (نیازی به فیلد مخفی جدا نیست)


  • ---

    مرتبط



  • [product-addons.md](product-addons.md) — افزونه اجباری + فیلد نقشه

  • [tenant-panel.md](tenant-panel.md)

  • [mapir-settings.md](mapir-settings.md) — API Key نقشه برای فرم انتخاب نقطه

  • کلاس‌ها: `WirelessCoverageService`, `WirelessOrderService`, `WirelessPopImportService`