فعال‌سازی کلاس آنلاین — runbook ادمین
اختصاص service_id از بات تلگرام یا پنل، تمدید/ارتقا، استرداد، پلن‌ها و تنظیمات، ظرفیت‌ها و مصرف حساب اسکای‌روم
۱. وقتی سفارش تازه می‌رسد
Section titled “۱. وقتی سفارش تازه می‌رسد”- بعد از پرداخت موفق زیبال، پیام «🛒 خرید جدید کلاس آنلاین» در بات تلگرام @braino_admin_bot می‌رسد. پیام شامل مالک، پلن، نوع (جدید/تمدید/ارتقا) و شماره‌ی سفارش است و فقط به chat_idهای مجاز فرستاده می‌شود.
- همین صف در پنل ادمین هم هست: کلاس آنلاین ← سفارش‌ها ← «در انتظار فعال‌سازی». عدد کنار منو تعداد سفارش‌های منتظر است.
- سفارشی که بیش از «یادآوری سفارش معطل» (پیش‌فرض ۴ ساعت) منتظر بماند، دوباره به تلگرام فرستاده می‌شود.
۲. اختصاص service_id (سفارش جدید)
Section titled “۲. اختصاص service_id (سفارش جدید)”- در پنل اسکای‌روم برینو یک سرویس با ظرفیت دقیقاً برابر پلن بساز.
- در تلگرام «🔑 اختصاص service_id» را بزن و عدد را در پاسخ بفرست، یا در پنل ادمین «اختصاص» را بزن و عدد را وارد کن (ارقام فارسی هم پذیرفته می‌شود).
- برینو با getServices روی کلید برینو بررسی می‌کند که سرویس وجود داشته باشد، فعال باشد، user_limit آن با پلن برابر باشد و به مالک دیگری اختصاص نیافته باشد. اگر یکی برقرار نباشد، پیام دلیل نمایش داده می‌شود و هیچ تغییری ثبت نمی‌شود.
- با موفقیت، ظرفیت مالک فعال می‌شود، به خریدار اعلان می‌رود و اقدام در لاگ ادمین ثبت می‌شود (
telegram:<chat_id>یا ایمیل شما).
۳. تمدید و ارتقا
Section titled “۳. تمدید و ارتقا”- در سفارش‌های تمدید و ارتقا service_id فعلی نمایش داده می‌شود. ابتدا همان سرویس را در پنل اسکای‌روم تمدید کن، یا برای ارتقا ظرفیتش را بالا ببر.
- بعد «تأیید» را بزن. دکمه‌ی «همان سرویس فعلی» شناسه را پیش‌پر می‌کند. برینو مدت و ظرفیت تازه را بررسی می‌کند؛ اگر هنوز تمدید نشده باشد، خطای «تمدید نشده» می‌گیری.
۴. استرداد
Section titled “۴. استرداد”- «استرداد» فقط وضعیت سفارش را عوض می‌کند و یادداشت (دلیل) اجباری است.
- برگشت پول را دستی در پنل زیبال با کد پیگیری سفارش انجام بده.
۵. پلن‌ها و تنظیمات
Section titled “۵. پلن‌ها و تنظیمات”- پلن‌ها: عنوان، ظرفیت هم‌زمان (باید با user_limit سرویس‌های اسکای‌روم برابر باشد)، مدت (۳۱ روز یا کمتر یعنی ماهانه و ارتقاپذیر)، قیمت، سهمیه‌ی فایل جلسه، مخاطب (مدرسه/معلم/هر دو) و فعال بودن برای فروش.
- تنظیمات: زمان اعلام‌شده‌ی فعال‌سازی (پیش‌فرض ۲۴ ساعت)، یادآوری سفارش معطل (۴ ساعت)، و سهمیه‌ی فایل جلسه برای کلید خود (BYO، پیش‌فرض ۱۰۲۴ مگ).
۶. ظرفیت‌ها و مصرف حساب اسکای‌روم
Section titled “۶. ظرفیت‌ها و مصرف حساب اسکای‌روم”تب کلاس آنلاین ← ظرفیت‌ها همه‌ی ظرفیت‌های مدرسه‌ها و معلم‌ها را یک‌جا نشان می‌دهد؛ چه خریده‌شده از برینو، چه با کلید خود (BYO).
- کارت «حساب اسکای‌روم برینو»: «درخواست API این دقیقه» یعنی چند درخواست از کلید برینو در همین دقیقه رفته است، از سقف امن ۴۰۰ (سقف رسمی حساب اسکای‌روم ۵۰۰). «کارهای انبوه» (پیش‌تولید لینک‌ها و به‌روزرسانی ظرفیت‌ها) حداکثر ۲۸۰ از این سهم را برمی‌دارند تا ورود به جلسه همیشه جا داشته باشد. کارت هر ۱۵ ثانیه تازه می‌شود.
- نزدیک شدن مداوم به ۴۰۰ یعنی بار زیاد است: ورودها کمی صبر می‌کنند و کارهای انبوه به دور بعد می‌روند. اگر پیام «کلید اسکای‌روم برینو روی Worker ست نشده است» دیدی، secret
SKYROOM_API_KEYرا روی Worker بررسی کن. - فایل جلسه‌ی ظرفیت‌های managed: جمع فضای فایل جلسه‌ها در برابر جمع سهمیه‌ی پلن‌ها. این عدد از حساب‌داری فایل خود برینو است (فایل‌ها نزد برینو نگه‌داری می‌شوند، نه داخل اتاق اسکای‌روم).
- جدول ظرفیت‌ها: مالک (مدرسه یا معلم؛ نشان «تست» برای داده‌ی آزمایشی)، نوع («خرید از برینو» یا «کلید خود») و پلن، service_id، ظرفیت هم‌زمان، تاریخ پایان و زمان آخرین بررسی، فایل مصرفی، و وضعیت. ظرفیتی که نزدیک‌تر به انقضاست بالاتر می‌آید.
- وضعیت: در ۷ روز آخر «n روز مانده» نمایش داده می‌شود. «منقضی» یعنی تاریخ پایان گذشته است، حتی اگر اسکای‌روم هنوز به‌روز نشده باشد؛ اتاق‌ها حفظ شده‌اند و با تمدید دوباره کار می‌کنند. «نامعتبر» با دلیل می‌آید: کلید نامعتبر، وب‌سرویس غیرفعال، یا بی سرویس فعال (معمولاً مشکل کلید BYO خود مالک است).
- با دکمه‌های بالای جدول بر اساس وضعیت (عدد هر دکمه تعداد کل همان وضعیت است) و نوع ظرفیت فیلتر کن. کلید API ظرفیت‌های BYO هرگز در پنل نمایش داده نمی‌شود.