اپلیکیشن‌ساز

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

همچنین اپراتور اپ کیف پول می‌تواند از پنل اپ (/app-builder) همان ابزار را ببیند — رابط تقریباً یکسان است.

پیش‌نیاز

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

آشنایی با صفحه

صفحه سه ناحیه دارد:

بالای شبیه‌ساز: Onboarding، لاگین/مهمان، پیش‌نمایش تمام‌صفحه، بروزرسانی. نقطه نارنجی روی تب یعنی تغییرات ذخیره‌نشده دارید.

نکات

• نتیجه در پرتال وب و اپ Flutter یکسان رندر می‌شود (برخی ویجت‌های خیلی پیشرفته فقط در یکی از آن‌ها ممکن است ساده‌تر نمایش داده شوند).
• قبل از عوض کردن صفحه یا تب، در صورت تغییر ذخیره‌نشده، سیستم تأیید می‌گیرد.

**اپلیکیشن‌ساز → تب سکشن‌ها → انتخاب یک سکشن → پنل راست**

هر سکشن — فارغ از نوع — این فیلدهای پایه را دارد:

فیلدهای عمومی

گام‌به‌گام — افزودن سکشن

1. تب سکشن‌ها را باز کنید.
2. در پنل راست صفحه فعلی را ببینید (مثلاً home).
3. افزودن سکشن را بزنید.
4. در مودال، جستجو کنید یا با دسته (تصویر، متن، کیف پول، …) فیلتر کنید.
5. نوع ویجت را انتخاب کنید.
6. در تنظیمات سکشن و تنظیمات محتوا فیلدها را پر کنید.
7. در صورت نیاز اکشن کلیک را تنظیم کنید.
8. ذخیره تغییرات (پایین پنل).

گام‌به‌گام — مرتب‌سازی و حذف

1. در لیست سکشن‌های راست با درگ ترتیب را عوض کنید.
2. روی سکشن در شبیه‌ساز کلیک کنید تا انتخاب شود.
3. حذف سکشن → بعد از ذخیره از سرور هم حذف می‌شود.

در مودال افزودن سکشن حدود ۱۸ نوع؛ در ویرایشگر پیشرفته حدود ۳۰ نوع در دسترس است. جدول زیر همه انواع رایج را با کاربرد و تنظیمات مهم توضیح می‌دهد.

تصاویر

نکته: روی اسلایدر هر تصویر می‌تواند به صفحه، فرم، سرویس یا لینک خارجی برود — مثلاً اسلاید اول «فروشگاه»، دوم «تماس با ما».

متن

لیست و گرید

اندازه آیتم در لیست: کوچک ≈ یک‌سوم عرض، متوسط ≈ دو‌سوم، بزرگ = تمام عرض — برای میانبرهای «دسترسی سریع» افقی مفید است.

مدیا

کیف پول

پیش‌نیاز: کاربر واردشده باشد؛ برای مهمان معمولاً چیزی نشان نمی‌دهد.

فرم

داده و آمار

اکشن و تماس

سیستم

**هر جا «اکشن کلیک» می‌بینید:** روی سکشن، روی هر اسلاید، روی هر آیتم لیست، روی دکمه

اکشن تعیین می‌کند وقتی کاربر لمس/کلیک کرد چه اتفاقی بیفتد. در پنل از ActionSelector (انتخابگر اکشن) استفاده می‌شود و به گروه‌های زیر تقسیم است:

۱. ناوبری داخلی

۲. لینک خارجی

نکته: لینک‌های http غیرامن ممکن است در اپ مسدود شوند — از https استفاده کنید.

۳. ارتباطات

۴. ابزارها

صفحات نیتیو اپ (برای «صفحه نیتیو»)

این صفحات توسط سیستم ساخته شده‌اند و با سکشن قابل طراحی نیستند — فقط می‌توانید به آن‌ها لینک دهید:

مثال‌های عملی اکشن

اسلایدر خانه:

• اسلاید ۱ → صفحه داینامیک promo-summer
• اسلاید ۲ → سرویس «ثبت درخواست»
• اسلاید ۳ → لینک وب https://example.com

دسترسی سریع:

• آیکون «کیف پول» → صفحه نیتیو wallet
• آیکون «پشتیبانی» → تماس تلفنی 021-xxxx
• آیکون «قوانین» → صفحه داینامیک terms

بنر اعلان:

• «تا ۳۰٪ تخفیف» → صفحه shop (نیتیو)
• دکمه بستن → بدون اکشن

اطلاعات تماس:

• ردیف تلفن → تماس
• ردیف ایمیل → ایمیل
• ردیف آدرس → لینک نقشه (Google Maps)

نکات اکشن

• اکشن روی آیتم (لیست/اسلایدر) اولویت دارد؛ اگر آیتم اکشن نداشت ممکن است اکشن کل سکشن اعمال شود.
• صفحه داینامیک پیش‌نویس در اکشن «صفحه داینامیک» دیده نمی‌شود — ابتدا انتشار کنید.
• سرویس باید در تب سرویس‌ها برای این پروژه فعال باشد.

**اپلیکیشن‌ساز → آیکون صفحات**

انواع صفحه

چیدمان (Layout)

گام‌به‌گام — صفحه جدید

1. صفحه جدید.
2. عنوان صفحه (فارسی) و کد (یکتا، انگلیسی، مثلاً about-us) — کد بعداً در اکشن‌ها استفاده می‌شود.
3. مسیر (slug) — برای URL پرتال.
4. نوع صفحه و چیدمان.
5. در صورت نیاز: عنوان AppBar، نوع پس‌زمینه (رنگ/تصویر).
6. سوئیچ‌ها: صفحه اصلی (فقط یک صفحه)، فقط برای کاربر واردشده، نمایش AppBar.
7. ذخیره — وضعیت اولیه: پیش‌نویس.

انتشار و منوی دراور

1. در لیست صفحات، روی انتشار صفحه بزنید → وضعیت منتشر شده.
2. برای صفحات داینامیک: نمایش در دراور پورتال — لینک در منوی همبرگری پرتال ظاهر می‌شود.
3. صفحات نیتیو ثابت (کیف پول، تنظیمات، …) همیشه در منو هستند؛ نیازی به دراور دستی ندارند.

ویرایش سکشن‌های یک صفحه

1. در لیست ویرایش سکشن‌ها → پرش به تب سکشن‌ها با همان صفحه.

نکات

• صفحه خانه (home) را حذف نکنید.
• صفحات آرشیو برای کاربر نمایش داده نمی‌شوند.
• عنوان انگلیسی (titleEn) برای نسخه EN اپ (در صورت پشتیبانی) مفید است.

**اپلیکیشن‌ساز → آیکون تم**

آشنایی

تم رنگ، فونت و لوگو کل اپ را برای حالت روشن و تاریک جداگانه تنظیم می‌کند.

گروه‌های رنگ

• برند: اصلی، ثانویه، تاکید
• سطوح: پس‌زمینه، کارت، border
• متن: اصلی، ثانویه، کم‌رنگ
• وضعیت: موفقیت، هشدار، خطا

تایپوگرافی و اندازه

• فونت فارسی / انگلیسی
• اندازه فونت پایه
• گوشه کارت‌ها، ارتفاع دکمه، ارتفاع فیلد ورودی

فایل‌ها

• لوگو (روشن و تاریک)
• تصویر اسپلش (صفحه باز شدن اپ)

رفتار

• حالت پیش‌فرض تم: سیستم / روشن / تاریک
• نمایش دکمه تغییر تم در پرتال

گام‌به‌گام

1. تب تم → سوییچ روشن/تاریک روی شبیه‌ساز.
2. رنگ‌ها را با Color Picker تنظیم کنید.
3. لوگو و اسپلش آپلود کنید.
4. ذخیره تم — بازنشانی فقط تغییرات ذخیره‌نشده را برمی‌گرداند.

**اپلیکیشن‌ساز → آیکون فرم‌ها**

سه زیربخش: فرم‌ها، فلوها، ارسال‌ها.

انواع فیلد فرم

برای هر فیلد: برچسب، placeholder، الزامی، حداقل/حداکثر، پیام خطا.

رفتار بعد از ارسال

فلو (فرم چندمرحله‌ای)

1. فلو جدید → کد و عنوان.
2. مراحل را اضافه کنید — هر مرحله یک فرم موجود.
3. در سکشن form_flow همان فلو را انتخاب کنید.

ارسال‌ها

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

گام‌به‌گام — فرم در صفحه

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

**اپلیکیشن‌ساز → آیکون سرویس‌ها**

آشنایی

سرویس‌های تعریف‌شده در پنل کلاب → سرویس‌ها اینجا به پروژه اپ وصل می‌شوند. فقط سرویس‌های فعال در گرید سرویس و اکشن «سرویس» دیده می‌شوند.

قیمت‌گذاری در اپ

• قیمت ثابت — مبلغ مشخص
• حاشیه سود — درصد روی قیمت پایه

همچنین عنوان نمایشی و آیکون اختصاصی برای اپ.

گام‌به‌گام

1. گروه سرویس بسازید (مثلاً «درخواست‌ها»).
2. از کاتالوگ، سرویس را اضافه و فعال کنید.
3. قیمت و ترتیب را تنظیم کنید.
4. در service_grid یا quick_actions → سرویس تست کنید.

تب پایین (Bottom Navigation)

آیتم‌های تب پایین (خانه، باشگاه، میزکار، …) از bootstrap اپ لود می‌شوند — ترکیب صفحات نیتیو و داینامیک با layout: tab.

در پنل کلاب فعلاً ویرایشگر گرافیکی تب پایین نداریم؛ تغییرات پیشرفته از ادمین پلتفرم / API انجام می‌شود. برای راهنمای پرتال به سند ناوبری پرتال کاربر مراجعه کنید.

منوی دراور (همبرگری)

• صفحات داینامیک منتشرشده با گزینه نمایش در دراور اینجا ظاهر می‌شوند.
• صفحات ثابت سیستم (کیف پول، تنظیمات، …) همیشه در منو هستند.

Onboarding (معرفی اولیه)

اسلایدهای اول ورود به اپ (خوش‌آمد، معرفی امکانات). دکمه Onboarding روی شبیه‌ساز پیش‌نمایش می‌دهد. ویرایش اسلایدها از API/admin — در UI کلاب محدود است.

**وسط صفحه اپلیکیشن‌ساز**

دکمه‌های بالای شبیه‌ساز

پیش‌نمایش واقعی

1. پیش‌نمایش را بزنید.
2. بین تب‌ها و دراور حرکت کنید.
3. با موبایل و OTP وارد شوید.
4. فرم بفرستید، سرویس باز کنید، لینک‌ها را امتحان کنید.
5. بستن → بازگشت به ویرایش.

نکات

• در پیش‌نمایش ویرایش سکشن نیست.
• بعد از هر ذخیره، بروزرسانی بزنید تا شبیه‌ساز هم‌خوان شود.

1. تم — رنگ برند، لوگو، فونت
2. صفحه خانه — اسلایدر + دسترسی سریع + کیف پول (در صورت نیاز)
3. صفحات فرعی — درباره ما، FAQ، تماس
4. فرم‌ها — نظرسنجی، درخواست
5. سرویس‌ها — فعال‌سازی و گروه‌بندی
6. انتشار همه صفحات داینامیک
7. دراور — صفحات مهم را به منو اضافه کنید
8. پیش‌نمایش با login واقعی
9. تست روی موبایل واقعی (PWA یا اپ)

• سکشن = بلوک UI روی صفحه؛ اکشن = رفتار کلیک.
• ۵ تب اصلی: سکشن، تم، صفحه، فرم، سرویس.
• انتشار صفحه شرط نمایش در پرتال است.
• اکشن‌ها: نیتیو، داینامیک، فرم، فلو، سرویس، URL، تماس، پیامک، ایمیل، share، copy، toast، نیتیو دستگاه.
• جزئیات ناوبری ثابت اپ در راهنمای ناوبری پرتال کاربر (user-portal-navigation).