راهنمای انواع متن‌ها و بَج‌ها در این پروتوتایپ

در این پروتوتایپ چند نوع متن و بَج می‌بینید. لطفاً قبل از پیاده‌سازی، تفاوت آن‌ها را بادقت متوجه شوید — بعضی‌ها باید در UI پیاده‌سازی شوند و بعضی‌ها فقط برای فهم بهتر تیم توسعه‌دهنده هستند.

این متن‌ها در UI پیاده‌سازی می‌شوند و به کاربر نمایش داده می‌شوند
مثال: از ساعت ۰۰:۰۰ این تاریخ، کمپین قابل استفاده می‌شود.
متن راهنما (helper) — دقیقاً همین متن با همین کلمات باید زیر فیلد در پنل ادمین به اپراتور نمایش داده شود. جزء UI است.
مثال: عنوان کمپین *
ستاره قرمز کنار عنوان فیلد (*) — نشانه‌ی فیلد اجباری است. اگر کاربر این فیلدها را خالی بگذارد، فرم را نمی‌تواند ذخیره کند. در UI نمایش داده می‌شود.
مثال: در کمپین «با محدودیت شماره تلفن و سانس»، سقف بودجه‌ی کلی قابل تعریف نیست.
پیام informational زرد (💡) — در سکشن «مدیریت بودجه» برای نوع ۳ باید به‌جای فیلد ورودی نمایش داده شود. جزء UI است. متن نهایی و استایل بصری آن با تیم طراحی نهایی می‌شود.
این بَج‌ها در UI پیاده‌سازی نمی‌شوند — صرفاً برای فهم بهتر تیم توسعه‌دهنده از انتظار ما هستند

این بَج‌های رنگی کوچک که کنار عنوان فیلدها می‌بینید هیچ‌کدام نباید در پنل نمایش داده شوند. صرفاً این‌جا آمده‌اند تا با یک نگاه به فرم بفهمید هر فیلد چه وضعیتی نسبت به فرم فعلی دارد:

بدون تغییر نام
نام فیلد در نسخه‌ی جدید عوض نشده — همان نام فعلی است. این‌جا آمده تا فراموش نشود که این فیلد هم بازبینی شده و آگاهانه بدون تغییر مانده.
قبلاً: نام قدیمی
ارجاع به نام قدیمی فیلد در فرم فعلی. کمک می‌کند توسعه‌دهنده بفهمد این فیلد جدید از کدام فیلد قدیمی مشتق شده. نام قدیمی نباید در UI نمایش داده شود.
STORY-020 پنل ادمین › پشتیبانی › کمپین تخفیف › ایجاد کمپین جدید

اصلاح عناوین و راهنمای فیلدها + سکشن‌بندی جدید فرم ایجاد کمپین تخفیف

پنج سکشن جدید مبتنی بر ذهنیت اپراتور، نام‌های شفاف، و helper text زیر هر فیلد.

۱ اطلاعات پایه کمپین

این کمپین کیست؟ (هویت، اعتبار، منبع پرداخت)

نامی توصیفی برای شناسایی کمپین در فهرست کمپین‌ها. این عنوان فقط برای اپراتور قابل مشاهده است.
در حالت «کیف پول قرارداد»، هزینه‌ی تخفیف از کیف قرارداد کسر می‌شود؛ همان کیفی که درآمد فروش به آن واریز می‌شود.
نوع کمپین تعیین می‌کند چه فیلدهایی در سکشن‌های «قوانین تخفیف»، «شرایط استفاده» و «مدیریت بودجه» نمایش داده شوند.
در حالت غیرفعال، نه بَج تخفیف روی سانس نمایش داده می‌شود و نه کدهای کمپین کار می‌کنند.
اگر فعال شود، کاربر باید کد تخفیف را در سبد وارد کند تا تخفیف اعمال شود.
از ساعت ۰۰:۰۰ این تاریخ، کمپین قابل استفاده می‌شود.
بعد از پایان این تاریخ، کمپین دیگر قابل استفاده نیست و اگر کاربر کد آن را وارد کند، تخفیفی اعمال نمی‌شود.

۲ قوانین تخفیف

تخفیف چه می‌دهد و چه قاعده‌ای دارد؟

عددی اعشاری بین ۰ تا ۱ (مثلاً ۰٫۲ یعنی ۲۰٪). این درصد روی جمع قیمت سبد خرید کاربر اعمال می‌شود.
بیش از این مقدار تخفیف داده نمی‌شود، حتی اگر درصد تخفیف عددی بزرگ‌تر تولید کند.
هر کاربر حداکثر این تعداد بار می‌تواند در سبدهای مجزا از این کمپین استفاده کند.
عددی اعشاری بین ۰ تا ۱ (مثلاً ۰٫۲ یعنی ۲۰٪). این درصد روی جمع قیمت سبد خرید کاربر اعمال می‌شود. در این نوع، بَج تخفیف روی سانس نمایش داده نمی‌شود و فقط در مرحله‌ی پرداخت دیده می‌شود.
اگر تعداد بلیت در سبد بیش از این عدد باشد، کل خرید با کد تخفیف بلاک می‌شود.
معیار شمارش، کاربران منحصر به فردی است که در آن سانس از کمپین استفاده کرده‌اند. اگر به این سقف برسد، به کاربر منحصر به فرد بعدی تخفیف تخصیص داده نخواهد شد.
هر کاربر در یک سانس مشخص حداکثر این تعداد بار می‌تواند با تخفیف خرید کند.

۳ شرایط استفاده

اگر این شرط‌ها برقرار باشد، تخفیف اعمال می‌شود.

این کمپین فقط روی اولین خرید موفق هر کاربر اعمال می‌شود.
کاربر باید حداقل این تعداد بلیت در سبد داشته باشد تا تخفیف اعمال شود.
جمع سبد کاربر باید حداقل به این مبلغ برسد تا تخفیف اعمال شود.
اگر فایل آپلودشده ساختار نادرست داشته باشد، سانس‌هایی که در محدوده اعمال تخفیف هستند دچار مشکل شده و غیرقابل خرید می‌شوند.

۴ محدوده اعمال

تخفیف روی چه محتوایی و در چه زمانی فعال است؟

اگر هیچ سینمایی انتخاب نشود، کمپین روی همه‌ی سینماها اعمال می‌شود.
اگر هیچ فیلمی انتخاب نشود، کمپین روی همه‌ی فیلم‌ها اعمال می‌شود.
اگر سالن انتخاب شود، تخفیف روی همه‌ی سانس‌های آن سالن اعمال می‌شود.
انتخاب سانس‌های خاص برای اعمال تخفیف.
روزها و ساعت فعالیت کمپین قبلاً: سکشن جدا «ساعت فعالیت کمپین در روز»
اگر هیچ روزی انتخاب نشود، کمپین در همه‌ی روزهای هفته فعال است. در روزهای انتخاب‌شده، از «زمان شروع» تا «زمان پایان» کمپین فعال است؛ اگر خالی بمانند، از ۰۰:۰۰ تا ۲۳:۵۹ فعال خواهد بود.
روز هفته زمان شروع زمان پایان

۵ مدیریت بودجه

کمپین در مجموع چقدر بودجه دارد و کِی تمام می‌شود؟

حداکثر دفعاتی که کل کمپین (روی همه‌ی کاربران) قابل استفاده است. وقتی به این سقف برسد، کاربر در زمان ثبت کد تخفیف با خطا روبرو می‌شود.
💡 در کمپین «با محدودیت شماره تلفن و سانس»، سقف بودجه‌ی کلی قابل تعریف نیست. حد و حدود مصرف تخفیف از طریق دو سازوکار دیگر کنترل می‌شود: (۱) فهرست شماره تلفن‌های مجاز (در سکشن «شرایط استفاده»)، و (۲) سقف کاربران و خرید در هر سانس (در سکشن «قوانین تخفیف»).