مدیریت پلتفرم

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

پیش‌نیاز

• حساب ادمین با دسترسی «اشخاص».

آشنایی

شخص حقیقی یعنی یک انسان (مشتری، بازاریاب، مدیر…) به‌عنوان هویت پایه در سیستم. بعداً به مشتری باشگاه، کیف پول یا نقش‌های دیگر وصل می‌شود.

گام‌به‌گام

1. اشخاص حقیقی را باز کنید.
2. با جستجو (نام، موبایل، کد ملی) پیدا کنید.
3. افزودن → ویزارد چندمرحله‌ای:
   • ملیت (ایرانی / غیرایرانی)
   • نام، نام خانوادگی، نام پدر، جنسیت
   • کد ملی یا گذرنامه
   • موبایل
4. ذخیره.
5. برای ویرایش روی ردیف کلیک کنید — برخی فیلدها بعد از تأیید هویت قفل می‌شوند.

نکات

• قبل از حذف، ببینید به مشتری یا کیف وصل نیست.
• موبایل معمولاً شناسه اصلی contact است.

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

پیش‌نیاز

• دسترسی اشخاص.

آشنایی

شخص حقوقی = شرکت، سازمان یا پذیرنده حقوقی با شناسه ملی، شماره ثبت و نماینده.

گام‌به‌گام

1. اشخاص حقوقی → افزودن.
2. نام رسمی و تجاری، شناسه ملی، کد اقتصادی، شماره ثبت.
3. آدرس و تلفن.
4. نماینده حقوقی — انتخاب از اشخاص حقیقی.
5. ذخیره؛ بعداً به پذیرنده وصل کنید.

نکات

• پذیرنده حقوقی باید اینجا یا در ویزارد پذیرنده ثبت شود.

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

پیش‌نیاز

• اشخاص ثبت‌شده.

آشنایی

نقش‌های سیستمی برای اشخاص (مشتری، پذیرنده، بازاریاب…) — جدا از نقش ادمین پنل مدیریت.

گام‌به‌گام

1. لیست نقش‌ها را ببینید.
2. نقش جدید: نام فارسی، کد یکتا، توضیح.
3. از صفحه شخص حقیقی/حقوقی، نقش را به شخص بدهید.

نکات

• این بخش با «مدیریت ادمین‌ها» (پایین) اشتباه گرفته نشود.

**پنل مدیریت → تنظیمات → اطلاعات پایه → مکان‌ها**

پیش‌نیاز

• دسترسی تنظیمات.

آشنایی

استان و شهر برای فرم‌های آدرس پذیرنده و مشتری.

گام‌به‌گام

1. مکان‌ها → لیست استان‌ها.
2. روی استان → شهرهای زیرمجموعه.
3. افزودن استان یا شهر (نام فارسی/انگلیسی، والد برای شهر).
4. غیرفعال — در dropdown فرم‌ها نمایش داده نمی‌شود.

نکات

• قبل از راه‌اندازی پذیرندگان، استان‌های پرکاربرد را کامل کنید.

**پنل مدیریت → تنظیمات → اطلاعات پایه → بانک‌ها**

پیش‌نیاز

• دسترسی تنظیمات.

آشنایی

فهرست بانک‌های ایرانی برای شبا، تسویه و برداشت.

گام‌به‌گام

1. بانک‌ها → لیست (کد، نام، لوگو).
2. افزودن یا ویرایش.
3. غیرفعال — در انتخاب جدید نیست؛ تراکنش‌های قدیمی می‌مانند.

نکات

• کد بانک با استاندارد شبا همخوان باشد.

**پنل مدیریت → تنظیمات → اطلاعات پایه → مدیریت مدارک**

پیش‌نیاز

• فرآیند احراز هویت پذیرنده/مشتری.

آشنایی

انواع مدرک (کارت ملی، روزنامه رسمی، مجوز کسب…) — اجباری/اختیاری، حجم و فرمت فایل.

گام‌به‌گام

1. مدیریت مدارک → لیست انواع.
2. نوع جدید: نام، کد، طرف (حقیقی/حقوقی)، حداکثر حجم، فرمت (jpg, pdf…).
3. مدارک آپلودشده را از بخش پذیرنده/مشتری تأیید یا رد کنید.

نکات

• نوع مدرک غیرفعال → در درخواست جدید نیست.

**پنل مدیریت → تنظیمات → تنظیمات سیستم**

پیش‌نیاز

• دسترسی تنظیمات (معمولاً سوپرادمین).

آشنایی

پارامترهای سراسری پلتفرم: عمومی، پیامک، درگاه پرداخت، ایمیل و… — به‌صورت کلید و مقدار.

گام‌به‌گام

1. تنظیمات سیستم → گروه‌ها را باز کنید.
2. مقدار را ویرایش → ذخیره.
3. برخی تغییرات نیاز به ری‌استارت سرویس روی سرور دارد (با تیم فنی).

نکات

• رمز درگاه و کلید پیامک را هرگز در Git نگذارید.
• تغییر درگاه را ساعات کم‌ترافیک انجام دهید.

**پنل مدیریت → تنظیمات → مدیریت ادمین‌ها**

پیش‌نیاز

• سوپرادمین یا مجوز مدیریت ادمین.

آشنایی

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

گام‌به‌گام — ادمین جدید

1. مدیریت ادمین‌ها.
2. افزودن: نام کاربری، رمز، نقش ادمین.
3. ذخیره.

گام‌به‌گام — ویرایش نقش

1. نقش را ویرایش.
2. ماژول‌ها را تیک بزنید: اشخاص، کلاب، کیف پول، گزارش، …
3. ذخیره — ادمین‌های همان نقش فوراً affected می‌شوند.

گام‌به‌گام — غیرفعال

• ادمین غیرفعال → login نمی‌کند.

نکات

• حساب سوپرادمین را محدود به افراد ضروری نگه دارید.
• بعد از تغییر نقش، session قدیمی را logout کنید.

**پنل مدیریت → گزارشات → گزارشات → گزارش فروش**

پیش‌نیاز

• داده سفارش در سیستم.

آشنایی

خلاصه فروش در بازه زمانی — کل مبلغ، تعداد سفارش، تفکیک باشگاه/پذیرنده.

گام‌به‌گام

1. گزارش فروش.
2. تاریخ شروع و پایان (شمسی).
3. فیلتر باشگاه، پذیرنده یا صنف (اختیاری).
4. جدول و نمودار را بخوانید.
5. خروجی Excel/CSV در صورت وجود دکمه.

نکات

• قبل از جلسه مالی بازه را با تقویm کسب‌وکار هماهنگ کنید.

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

پیش‌نیاز

• تراکنش کیف پول.

آشنایی

فیلتر بر نوع (واریز، برداشت، انتقال…)، ارز/کیف، موبایل، وضعیت.

گام‌به‌گام

1. فیلترها را تنظیم کنید.
2. جدول: تاریخ، مبلغ، نوع، مبدأ/مقصد.
3. کلیک روی ردیف → جزئیات (شناسه پیگیری، توضیح).

نکات

• برای شکایت کاربر، با موبایل و تاریخ جستجو کنید.

**پنل مدیریت → گزارشات → گزارشات → گزارش کاربران**

پیش‌نیاز

• مشتریان ثبت‌شده.

آشنایی

آمار ثبت‌نام، فعالیت، سطح عضویت، دارا/بدون کیف.

گام‌به‌گام

1. بازه ثبت‌نام، باشگاه، وضعیت.
2. شاخص‌ها: کاربر جدید، فعال ماهانه، توزیع سطح.
3. خروجی لیست — با رعایت حریم خصوصی.

نکات

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

**پنل مدیریت → گزارشات → لاگ‌ها → لاگ API**

پیش‌نیاز

• دسترسی گزارش/فنی.

آشنایی

تاریخچه درخواست‌ها به سرور — برای وقتی کلاب یا اپ «خطا» گزارش می‌کند. رمز و توکن ماسک شده‌اند.

گام‌به‌گام

1. لاگ API.
2. فیلتر: مسیر، نوع درخواست، کد خطا، بازه، IP.
3. جزئیات یک ردیف → زمان پاسخ، کاربر.

نکات

• خطای ۵۰۰ تکراری → به تیم فنی escalate کنید.

**پنل مدیریت → گزارشات → لاگ‌ها → لاگ سیستم**

پیش‌نیاز

• دسترسی فنی.

آشنایی

رویدادهای داخلی سرور: خطا، هشدار، job پس‌زمینه.

گام‌به‌گام

1. لاگ سیستم.
2. فیلتر سطح: اطلاع، هشدار، خطا، بحرانی.
3. برای خطا، متن خطا و جزئیات را بخوانید.

نکات

• لاگ قدیمی archive می‌شود — نگهداری بلندمدت خارج از پنل.

**پنل مدیریت → توسعه‌دهندگان → ابزارهای پیشرفته → فرم‌ساز**

پیش‌نیاز

• مجوز ابزار توسعه (معمولاً سوپرادمین).

آشنایی

ساخت فرم‌های سراسری و ذخیره پاسخ — سطح پلتفرم (متفاوت از فرم اپلیکیشن‌ساز کلاب).

گام‌به‌گام

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

نکات

• فقط تیم فنی باید فرم سراسری بسازد.

**پنل مدیریت → توسعه‌دهندگان → ابزارهای پیشرفته → Query Builder**

پیش‌نیاز

• سوپرادمین؛ دانش SQL.

آشنایی

گزارش ad-hoc با نوشتن کوئری خواندن — فقط SELECT (نه حذف/تغییر داده).

گام‌به‌گام

1. کوئری بنویسید.
2. اجرا → جدول نتیجه (محدود تعداد سطر).
3. ذخیره قالب برای دفعات بعد.

نکات

• هشدار امنیتی: دسترسی به داده حساس — فقط افراد مجاز.

**پنل مدیریت → توسعه‌دهندگان → ابزارهای پیشرفته → جداول پویا**

پیش‌نیاز

• پروژه سفارشی با نیاز جدول اضافه.

آشنایی

تعریف جدول سفارشی در پایگاه داده بدون migration دستی (پروژه‌های خاص).

گام‌به‌گام

1. جدول جدید → نام، ستون‌ها (نوع، اجباری، پیش‌فرض).
2. سیستم جدول را می‌سازد.
3. از کنترلرها UI بگیرید.

نکات

• با تیم توسعه هماهنگ کنید — روی production با احتیاط.

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

پیش‌نیاز

• جدول (معمول یا پویا) موجود.

آشنایی

تولید خودکار لیست/فرم برای یک جدول — CRUD بدون کدنویسی UI.

گام‌به‌گام

1. کنترلرها → جدول را انتخاب کنید.
2. ستون‌های لیست، فیلدهای فرم، فیلترها.
3. تولید → صفحه مدیریت در پنل + دسترسی سرور.

نکات

• قبل از deploy روی prod، در محیط تست امتحان کنید.

گام‌به‌گام

1. اشتراک‌ها و درخواست‌ها — تأیید pending (در بخش مدیریت کلاب).
2. پشتیبانی پلتفرم — تیکت ارجاع‌شده.
3. درخواست‌های برداشت — تأیید مالی.
4. لاگ API — خطای تکراری.
5. اعلان‌ها — کمپین زمان‌بندی‌شده.

1. سوپرادمین محدود.
2. Query Builder و کنترلرها محدود در production.
3. لاگ API بدون نمایش رمز کامل.
4. تغییر درگاه در ساعات آرام.
5. پس از تغییر نقش، logout اجباری.