مدیریت کلاب و اپلیکیشن

**پنل مدیریت → مدیریت کسب‌وکار → مدیریت کلاب → کلاب‌ها**

پیش‌نیاز

• حساب ادمین پلتفرم.

آشنایی

همه باشگاه‌های ثبت‌شده: نام، کد، وضعیت فعال/غیرفعال، تاریخ ایجاد. از اینجا کلاب جدید می‌سازید یا وارد جزئیات (۹ تب) می‌شوید.

گام‌به‌گام — کلاب جدید

1. کلاب‌ها → کلاب جدید.
2. ویزارد ۵ مرحله (جزئیات در ویزارد):
   • اطلاعات پایه (نام، کد)
   • برندینگ (لوگو، رنگ)
   • ادمین کلاب (نام کاربری، رمز)
   • تنظیمات (پیام خوش‌آمد، قوانین)
   • توکن اتصال بیرونی (اختیاری)
3. ایجاد کلاب.

گام‌به‌گام — جزئیات

1. روی ردیف کلیک → ۹ تب: نمای کلی، اپ، پذیرنده، مشتری، اصناف، بازاریاب، سرپرست، مدیر منطقه، سطوح.
2. ویرایش سریع از لیست یا toggle فعال/غیرفعال.

نکات

• کد کلاب یکتا و معمولاً حروف بزرگ (مثل MYCLUB).
• حذف کلاب با داده مالی — فقط با تأیید و هماهنگی.

پیش‌نیاز

• نام و کد باشگاه مشخص.

آشنایی

ClubWizard برای ایجاد و ویرایش — پنج مرحله پشت سر هم.

گام‌به‌گام

مرحله ۱ — اطلاعات پایه

• نام فارسی (الزامی)
• نام انگلیسی (اختیاری)
• کد کلاب (یکتا) — دکمه «تولید خودکار» از نام

مرحله ۲ — برندینگ

• لوگو، رنگ اصلی و ثانویه
• تلفن و ایمیل پشتیبانی، وب‌سایت
• پیش‌نمایش هدر با گرادیان رنگ

مرحله ۳ — ادمین کلاب

• نام کاربری ورود به پنل کلاب
• رمز (الزامی در ایجاد)
• نام و موبایل مدیر (اختیاری)

مرحله ۴ — تنظیمات

• پیام خوش‌آمد، لینk قوانین و حریم خصوصی
• امتیازدهی خرید (حداقل مبلغ، امتیاز)
• استفاده متقابل بین باشگاه‌ها (در صورت فعال بودن)

مرحله ۵ — اتصال بیرونی

• تولید توکن برای یکپارچه‌سازی (اختیاری — بعداً هم می‌شود)

ثبت نهایی: «ایجاد کلاب» / «ذخیره».

نکات

• در ویرایش، رمز خالی = تغییر نمی‌کند.
• ادمین کلاب همان مالک پنل باشگاه است.

**کلاب‌ها → مشاهده یک کلاب**

آشنایی

گام‌به‌گام (هر تب)

1. لیست + جستجو
2. افزودن (ویزارد مخصوص)
3. ویرایش / فعال / حذف
4. بروزرسانی

نکات

• تب ۲ بدون اتصال اپ → پرتال کار نمی‌کند.

**پنل مدیریت → مدیریت کسب‌وکار → مدیریت کلاب → کیف پول کلاب‌ها**

پیش‌نیاز

• کلاب و اپ متصل.

آشنایی

کیف‌های مالی باشگاه — موجودی، ارز، واریز/برداشت دستی (با مجوز).

گام‌به‌گام

1. کیف پول کلاب‌ها → لیست.
2. مشاهده موجودی و تراکنش.
3. عملیات مالی طبق مجوز ادمین.

نکات

• بدون Wallet App در تب اپ، کاربر پرتال کیف نمی‌بیند.

**پنل مدیریت → مدیریت کسب‌وکار → مدیریت کلاب → سطوح عضویت**

پیش‌نیاز

• کلاب موجود.

آشنایی

تعریف سطح (برنز، نقره، طلا…)، قیمت، تخفیف، مزایا — راهنمای کامل در سند «سطوح عضویت».

گام‌به‌گام (خلاصه)

1. سطح جدید → نام، رنگ، قیمت، مزایا.
2. ذخیره — در پنل کلاب و پرتال قابل خرید/اختصاص.

نکات

• سطح در تب ۹ جزئیات کلاب هم مدیریت می‌شود.

**پنل مدیریت → مدیریت کسب‌وکار → مدیریت کلاب → صندوق‌ها**

پیش‌نیاز

• قابلیت صندوق در پلتفرم.

آشنایی

صندوق گردان سراسری یا per-club — راهنمای کامل در سند «صندوق».

گام‌به‌گام (خلاصه)

1. تعریف صندوق، دوره، مبلغ.
2. اتصال به کلاب در صورت نیاز.

**پنل مدیریت → مدیریت کسب‌وکار → آپشن‌ها و پکیج‌ها → آپشن‌ها (قابلیت‌ها)**

پیش‌نیاز

• سوپرادمین یا مجوز کلاب.

آشنایی

آپشن = یک منو/قابلیت (رویداد، چت، اپلیکیشن‌ساز…). هر آپشن قیمت (رایگان، ماهانه، سالانه، یک‌بار) و دسته (پایه، مالی، بازاریابی…) دارد.

گام‌به‌گام

1. آپشن‌ها → افزودن.
2. کد یکتا (مثل events) — بعد از استفاده عوض نکنید.
3. نام فارسی/انگلیسی، توضیح، آیکون.
4. نوع قیمت، مبلغ، روز آزمایشی.
5. پایه (همیشه فعال) یا اختیاری.
6. فعال در فروشگاه → ذخیره.

نکات

• is_active: false → در فروشگاه کلاب دیده نمی‌شود.

**پنل مدیریت → مدیریت کسب‌وکار → آپشن‌ها و پکیج‌ها → پکیج‌ها**

پیش‌نیاز

• آپشن‌های تعریف‌شده.

آشنایی

پکیج = چند آپشن با یک قیمت و تخفیف نسبت به خرید تکی.

گام‌به‌گام

1. پکیج جدید → نام، قیمت ماهانه/سالانه/یک‌بار.
2. درصد تخفیف، ویژه (نمایش برجسته).
3. آپشن‌های داخل پکیج را تیک بزنید.
4. انتشار — در فروشگاه پنل کلاب.

نکات

• محدودیت max پذیرنده/مشتری (در صورت تعریف) را در توضیح پکیج بنویسید.

**پنل مدیریت → مدیریت کسب‌وکار → آپشن‌ها و پکیج‌ها → اشتراک‌ها و درخواست‌ها**

پیش‌نیاز

• کلاب درخواست خرید داده.

آشنایی

وقتی باشگاه آپشن یا پکیج می‌خرد (مخصوصاً پرداخت دستی)، درخواست در انتظار تأیید می‌ماند.

گام‌به‌گام

1. اشتراک‌ها → فیلتر وضعیت (فعال، در انتظار تأیید/پرداخت، منقضی، رد شده).
2. درخواست pending → تأیید → آپشن برای کلاب روشن می‌شود.
3. یا رد با دلیل.
4. تمدید/انقضا — تاریخ پایان را ببینید.

نکات

• بعد از تأیید، منوی جدید در پنل کلاب ظاهر می‌شود (refresh).

**پنل مدیریت → امور مالی → اپلیکیشن‌ها**

پیش‌نیاز

• کلاب ساخته شده.

آشنایی

هر Application یک برند/محصول در اکوسystem — به اپ کیف پول و پروژه اپلیکیشن‌ساز وصل می‌شود.

گام‌به‌گام

1. اپلیکیشن‌ها → افزودن (نام، کد، لوگو).
2. از اپلیکیشن‌های کیف پول یک Wallet App بسازید: واریز، برداشت، انتقال، کیف‌های مجاز.
3. در جزئیات کلاب → تب اپ → اتصال اپلیکیشن.
4. پروژه اپلیکیشن‌ساز برای همان اپ (با تیم فنی).

گام‌به‌گام — قطع اتصال

• قطع اتصال → پرتال و اپ کلاب کار نمی‌کند — با احتیاط.

نکات

• بدون اپ متصل پیام «پروژه تنظیم نشده» در پرتال.

**پنل کلاب → عملیات → اپلیکیشن و کیف پول**

پیش‌نیاز

• ادمین اپ را به کلاب وصل کرده.

آشنایی

چهار تب: اطلاعات (اپ و Wallet)، تنظیمات کیف (واریز/برداشت/انتقال/تبدیل، سقف)، کیف‌ها (لیست مجاز)، کاربران (جستجو موبایل → کیف و تراکنش).

گام‌به‌گام — راه‌اندازی اولیه

1. اگر بنر «تکمیل راه‌اندازی کیف» دیدید:
2. حداقل یک کیف مجاز انتخاب کنید.
3. واریز/برداشت را فعال کنید.
4. ذخیره — بخش‌های مالی پنل و پرتال باز می‌شوند.

گام‌به‌گام — کاربران کیف

1. تب کاربران → موبایل جستجو.
2. موجودی هر کیف، واریز/برداشت، آخرین فعالیت.
3. کلیک → تراکنش‌های کاربر.

نکات

• تغییر تنظیمات کیف نیاز به مجوز «اپلیکیشن» دارد.

**پنل کلاب → فروشگاه آپشن‌ها → فروشگاه آپشن‌ها**

پیش‌نیاز

• دسترسی خرید (مالک یا مجوز فروشگاه).

آشنایی

باشگاه اینجا قابلیت (آپشن) یا پکیج می‌خرد: رویداد، چت، اپلیکیشن‌ساز و…

گام‌به‌گام

1. فروشگاه آپشن‌ها.
2. بالای صفحه دوره پرداخت: یک‌بار، ماهانه، سالانه.
3. تب پکیج‌ها — جزئیات آپشن‌های داخل → درخواست خرید.
4. تب آپشن‌های تکی — دسته‌بندی؛ موارد فعال قابل خرید مجدد نیستند.
5. ثبت درخواست — اگر پرداخت دستی: «منتظر تأیید ادمین».
6. بعد از تأیید ادمین → منوی جدید در سایدبار.

نکات

• دوره آزمایشی در صورت تعریف روی کارت نمایش داده می‌شود.

**پنل کلاب → فروشگاه آپشن‌ها → اشتراک‌های من**

پیش‌نیاز

• حداقل یک درخواست خرید.

آشنایی

کارت‌های آماری: آپشن فعال/غیرفعال، اشتراک فعال، در انتظار. لیست آپشن‌های فعال با تاریخ انقضا و هشدار «X روز مانده». جزئیات اشتراک‌ها: نوع، وضعیت، مبلغ، تاریخ، روش پرداخت.

گام‌به‌گام — تمدید

1. نزدیک انقضا → فروشگاه آپشن‌ها.
2. همان آپشن/پکیج را دوباره درخواست دهید.
3. یا با ادمین تمدید دستی.

نکات

• فیلتر وضعیت در جدول جزئیات.

1. کد کلاب را به کارمندان برای login (در صورت تکراری بودن username) بدهید.
2. قبل از اعلام عمومی، مسیر خانه پرتال و کیف را خودتان تست کنید.
3. آپشن پایه را در ادمین is_base کنید تا همیشه فعال بماند.
4. برندینگ (لوگو، رنگ) در ویزارد → در پرتال و اپ یکسان دیده می‌شود.