سی‌روم (CRoom) اکوسیستم کلاس آنلاین، وبینار و زیرساخت آموزشی
🎓 مستندات رسمی و راهنمای جامع اتصال

معرفی کامل محصول سی‌روم و راهنمای گام‌به‌گام اتصال و تست

سی‌روم یک زیرساخت مدرن، مقیاس‌پذیر و پایدار وب‌کنفرانس ایرانی با پروتکل WebRTC و معماری ابری است که از طریق API اختصاصی و افزونه‌های رسمی با سامانه‌های دانشگاهی مودل (Moodle)، وردپرس (WordPress) و مرورگر کروم یکپارچه می‌شود.

< 150 ms
تأخیر انتقال صوت و تصویر (Ultra-low Latency)
1,000,000+
معماری مقیاس‌پذیر کاربران همزمان (Distributed SFU)
نیم‌بها
ترافیک مصرفی سرورهای داخل کشور (شبکه ملی اطلاعات)
Full API
همگام‌سازی لحظه‌ای با پنل و ایجاد اتاق بدون نیاز به مداخله دستی

💡 سی‌روم (CRoom) چیست و چه مساله‌ای را حل می‌کند؟

سی‌روم یک پلتفرم جامع کلاس آنلاین و وب‌کنفرانس سازمانی و دانشگاهی است که به عنوان جایگزینی بومی، سریع‌تر و ارزان‌تر برای سامانه‌های بیگ‌بلو‌باتن (BigBlueButton)، ادوبی کانکت (Adobe Connect) و اسکای‌روم طراحی شده است. این سیستم به مدرسان، دانشگاه‌ها، مدارس و کسب‌وکارها اجازه می‌دهد بدون نیاز به نصب نرم‌افزار جانبی و تنها از طریق مرورگر، جلسات تعاملی چند ده‌هزار نفره را با حداکثر کیفیت برگزار نمایند.

🚀
بدون نیاز به نصب نرم‌افزار
کاربران (استاد و دانشجو) صرفاً با کلیک روی لینک اختصاصی، مستقیماً از طریق هر مرورگری روی موبایل، تبلت یا لپ‌تاپ وارد کلاس می‌شوند.
⚡
همگام‌سازی خودکار و دوطرفه API
هر کلاسی که در مودل یا وردپرس ساخته شود، همان لحظه در پنل رسمی سی‌روم ایجاد و ظرفیت، نقش‌ها و تنظیمات ضبط آن همگام می‌گردد.
🎙️
کیفیت صدای شفاف و بدون اکو
مجهز به سیستم حذف نویز هوشمند بر پایه هوش مصنوعی و کدک صوتی پیشرفته Opus برای انتقال صدای فوق‌العاده با کمترین پهنای باند.
📹
ضبط ابری خودکار (Cloud Recording)
جلسات به صورت خودکار با فرمت سبک MP4 در سرور ضبط شده و بلافاصله پس از اتمام جلسه، لینک دانلود و پخش در مودل و وردپرس قرار می‌گیرد.
🔒
امنیت بالا و رمزنگاری E2EE
انتقال صوت، تصویر و چت رمزنگاری‌شده با گواهی SSL و توکن‌های نشست یکتا که مانع ورود کاربران ناشناس به جلسه می‌شود.
📊
حضور و غیاب هوشمند
ثبت دقیق ساعت دقیق ورود و خروج هر دانشجو و استاد، مدت زمان حضور در کلاس و لاگ اختصاصی در سیستم نمره‌دهی مودل.

⚖️ جدول مقایسه سی‌روم با سایر پلتفرم‌ها

ویژگی / شاخص سی‌روم (CRoom) BigBlueButton Adobe Connect Skyroom
ترافیک اینترنت مصرفی نیم‌بها داخلی (سرور ایران) بین‌الملل (بسته به هاست) بین‌الملل / تمام‌بها نیم‌بها داخلی
نیاز به نصب برنامه روی گوشی/سیستم خیر (۱۰۰٪ تحت وب) خیر (تحت وب) بله (نیاز به اپلیکیشن) خیر (تحت وب)
افزونه رسمی مودل ۴ به بالا بله (نصب با ۱ کلیک) بله نیاز به سرور واسط پیچیده محدود
یکپارچگی خودکار با ووکامرس بله (ساخت کلاس پس از خرید) خیر (نیاز به افزونه جانبی) خیر محدود
ضبط ابری با لینک مستقیم دانلود MP4 بله (خودکار و ابری) نیاز به پردازش سنگین سرور نیاز به تبدیل دستی هزینه مازاد سرور
همگام‌سازی خودکار کلاس با پنل کاربری بله (با وب‌هوک و API) پایه پایه نیاز به تنظیم دستی

🎓 راهنمای گام‌به‌گام اتصال و استفاده در سامانه مودل (Moodle LMS)

ماژول دانشگاهی mod_croom به اساتید و مدیران سیستم‌های یادگیری الکترونیکی اجازه می‌دهد تا تنها با ۲ کلیک، کلاس‌های آنلاین را به عنوان یک سرفصل درسی در مودل تعریف نمایند.

۱

دانلود و نصب افزونه در مودل

فایل فشرده croom-moodle.zip را دانلود کرده و به یکی از دو روش زیر نصب نمایید:

  • از طریق پیشخوان مودل: مدیریت سایت > افزونه‌ها > نصب افزونه‌ها > بارگذاری فایل زیپ و کلیک روی دکمه «ادامه و ارتقای پایگاه داده».
  • از طریق FTP/هاست: پوشه افزونه را مستقیماً در مسیر moodle/mod/croom استخراج کنید.
۲

ثبت کلید توکن API سی‌روم در تنظیمات مودل

به مسیر زیر در پیشخوان مودل بروید:

مدیریت سایت > افزونه‌ها > ماژول‌های فعالیت > کلاس آنلاین سی‌روم (CRoom Settings)

فیلدهای زیر را مقداردهی نمایید:

  • کلید API سی‌روم (CRoom API Key): توکنی که از پنل سی‌روم کپی کرده‌اید را در این کادر قرار دهید (مثال: cr_live_token_xxxxxx).
  • آدرس سرویس‌دهنده API: پیش‌فرض روی https://api.croom.ir قرار دارد.
  • آدرس هاب مانیتورینگ: روی https://croom.shop4bit.ir تنظیم کنید.
✅
نکته تایید اشتراک: از آنجا که اشتراک اکانت شما توسط مدیریت سی‌روم تایید شده است، به محض ذخیره توکن، وضعیت اتصال سبز شده و بدون هیچ خطای لایسنس یا اشتراکی فعال می‌شود.
۳

ایجاد یک کلاس آنلاین جدید در یک درس

به عنوان استاد یا مدیر وارد درس مورد نظر در مودل شوید:

  1. دکمه «فعال کردن حالت ویرایش (Turn editing on)» را بزنید.
  2. روی گزینه «افزودن یک فعالیت یا منبع» کلیک کنید.
  3. آیکون «کلاس آنلاین سی‌روم (CRoom)» را انتخاب کنید.
  4. عنوان کلاس (مثلاً: کلاس جبرانی ریاضی مهندسی - جلسه اول) را وارد کنید.
  5. تاریخ و ساعت شروع و پایان، و فعال بودن ضبط خودکار را انتخاب کرده و روی «ذخیره و نمایش» کلیک نمایید.
۴

نحوه ورود استاد و دانشجو به کلاس

وقتی کاربر روی فعالیت کلیک می‌کند، سیستم به صورت کاملاً خودکار نقش کاربر در مودل را شناسایی می‌کند:

  • اگر کاربر استاد (Teacher / Editing Teacher) باشد: سیستم درخواست join_as_moderator را به API فرستاده و لینک ورود با دسترسی‌های کامل مدیریت کلاس (روشن کردن وبکم، میکروفون، اشتراک صفحه و تخته) را باز می‌کند.
  • اگر کاربر دانشجو (Student) باشد: سیستم درخواست join_as_guest را فرستاده و دانشجو بدون نیاز به رمز عبور مستقیم در محیط کلاس قرار می‌گیرد.

🔌 راهنمای گام‌به‌گام اتصال و استفاده در وردپرس و ووکامرس

افزونه وردپرس سی‌روم (croom-wordpress) قابلیت‌های برگزاری وبینار، کلاس‌های خصوصی و ایجاد لینک کلاس بلافاصله پس از پرداخت سفارش ووکامرس را فراهم می‌آورد.

۱

نصب و فعال‌سازی افزونه وردپرس

در پیشخوان وردپرس وارد منوی افزونه‌ها > افزودن افزونه > بارگذاری افزونه شده و فایل croom-wordpress.zip را آپلود و فعال نمایید.

۲

تنظیم توکن و تست اتصال

از منوی سمت راست پیشخوان، به بخش سی‌روم > تنظیمات بروید:

پیشخوان وردپرس > منوی «سی‌روم» > تنظیمات اصلی API
  • کلید API اختصاصی خود را وارد کرده و روی دکمه «بررسی و ذخیره اتصال» کلیک نمایید.
  • یک چراغ سبز با عنوان «اتصال به سرور سی‌روم با موفقیت برقرار شد» نمایان می‌شود.
۳

اتصال محصول ووکامرس به کلاس آنلاین

هنگام ایجاد یا ویرایش یک محصول در ووکامرس:

  1. نوع محصول را دانلودی / مجازی یا دوره انتخاب کنید.
  2. در تب «تنظیمات کلاس سی‌روم»، گزینه «ایجاد خودکار کلاس برای خریدار» را تیک بزنید.
  3. به محض اینکه خریدار هزینه سفارش را پرداخت کرد، در پنل کاربری خریدار (تب سفارشات یا پنل دوره‌ها) لینک اختصاصی ورود به کلاس آنلاین همراه با پیامک/ایمیل ارسال می‌شود.
۴

شورت‌کدهای کاربردی در صفحات سایت

[croom_classes] // نمایش جدول کلاس‌های کاربر جاری به همراه دکمه ورود
[croom_recordings room_id="1234"] // نمایش آرشیو ویدیوهای ضبط‌شده جلسه

🌐 افزونه مرورگر گوگل کروم (Chrome Extension Manifest V3)

افزونه کروم سی‌روم به اساتید و برگزارکنندگان وبینار اجازه می‌دهد بدون نیاز به باز کردن سایت یا لاگین‌های مکرر، مستقیماً از نوار ابزار مرورگر کلاس بسازند یا وارد جلسات فعال شوند.

۱

نصب افزونه به صورت Developer Mode در مرورگر کروم

  1. فایل croom-chrome.zip را دانلود و آن را از حالت فشرده در یک پوشه خارج کنید.
  2. در نوار آدرس مرورگر کروم عبارت chrome://extensions را وارد کنید.
  3. گزینه Developer mode در گوشه بالا سمت راست را فعال نمایید.
  4. روی دکمه Load unpacked کلیک کرده و پوشه خارج‌شده را انتخاب نمایید.
  5. آیکون سی‌روم در نوار ابزار مرورگر نمایان می‌گردد.
۲

ویژگی‌های افزونه کروم

  • نمایش لحظه‌ای تعداد کلاس‌های فعال و دانشجویان آنلاین.
  • امکان ساخت فوری اتاق (Instant Room) تنها با تعیین نام و ۱ کلیک.
  • تولید خودکار لینک کوتاه دعوت جهت ارسال در تلگرام، واتس‌اپ و ایتا.
  • نوتیفیکیشن ۵ دقیقه قبل از شروع کلاس برای یادآوری به مدرس.

🎯 سناریوی آزمون و راستی‌آزمایی کارفرما (بر مبنای پیام صوتی مدیریت)

🎙️
خلاصه خواسته کارفرما در ویس: «اشتراک شما تایید شده، یعنی الان هم از طریق پنل و هم از طریق API می‌تونی وارد کلاس بشی بدون ارور. در تستمون روی ساده‌ترین حالت می‌خوایم چک کنیم: ۱- یه کلاس ایجاد بشه و در پنل رسمی سی‌روم هم همگام بشه ۲- بتونن با زدن دکمه بدون ارور وارد کلاس بشن.»

چک‌لیست تست ۴ مرحله‌ای (گام‌به‌گام و سریع):

۱

آزمون گام اول: بررسی توکن و تایید عدم خطای لایسنس/اشتراک

هنگامی که توکن در تنظیمات مودل (یا وردپرس) ذخیره می‌شود، ماژول یک درخواست صحت‌سنجی به api.croom.ir می‌فرستد.

  • نتیجه مورد انتظار: دریافت کد وضعیت HTTP 200 و بازگشت نام اکانت تاییدشده بدون هیچ خطای اشتراک (Subscription Expired / Inactive).
  • روش تست سریع از خط فرمان:
    curl -s -H "Authorization: Bearer YOUR_TOKEN" https://api.croom.ir/api/v1/panel/user/info
۲

آزمون گام دوم: ایجاد کلاس از مودل/وردپرس و مشاهده همزمان در پنل سی‌روم

وقتی در مودل فعالیت «کلاس آنلاین سی‌روم» را با نام فرضی تست کلاس آنلاین حسام می‌سازید:

  1. مودل درخواست POST /api/v1/panel/user/room/store را به API ارسال می‌کند.
  2. اتاق فوراً با یک room_uid یکتا ساخته می‌شود.
  3. راستی‌آزمایی: وارد پنل وب سی‌روم (یا panel.croom.ir) شوید؛ دقیقاً همان کلاس با همان نام در لیست کلاس‌های شما ظاهر شده است!
۳

آزمون گام سوم: ورود به کلاس با کلیک دکمه بدون ارور

در صفحه درس مودل، روی دکمه آبی‌رنگ «🚀 ورود به کلاس آنلاین سی‌روم» کلیک نمایید:

  • مودل با درخواست POST /api/v1/client/join/room/moderator لینک نشست مستقیم را دریافت می‌کند.
  • صفحه کلاس در تب جدید باز شده و مستقیماً وارد محیط وبینار (صفحه دوربین، میکروفون و تخته) می‌شوید.
  • نکته بسیار مهم: هیچ اروری مبنی بر عدم دسترسی یا اشتراک نباید داده شود و وضعیت اتصال سبز است.
۴

آزمون گام چهارم: ورود کاربر دوم (دانشجو) بدون نیاز به لاگین

لینک مهمان را در یک پنجره ناشناس (Incognito) یا در مرورگر موبایل باز کنید:

  • کاربر با وارد کردن نام خود (مثلاً: «علی محمدی - دانشجو») مستقیماً وارد همان جلسه می‌شود.
  • استاد در لیست کاربران کلاس حضور دانشجو را مشاهده کرده و ارتباط دوطرفه صوتی و تصویری برقرار می‌گردد.

🏗️ سنجش تاب‌آوری و استاندارد ۱ میلیون کاربر همزمان (1M Concurrent Scale)

یکی از اصول بنیادین مهندسی سیستم، تضمین عدم کرش و پاسخ‌گویی بدون تاخیر در مقیاس‌های دانشگاهی و کشوری است. ساختار پیاده‌سازی‌شده بر مبنای استانداردهای زیر بهینه‌سازی شده است:

🛡️
سیستم کشینگ هوشمند توکن (Transient Cache)
برای جلوگیری از ارسال میلیون‌ها درخواست احراز هویت به سرور مرکزی، توکن‌ها و وضعیت اتاق‌ها در حافظه کش محلی با TTL ۶۰ ثانیه نگهداری می‌شوند.
⚡
ارتباط ناهمگام غیرانسدادی (Non-blocking I/O)
تمام پینگ‌ها و تله‌متری‌ها با Timeout حداکثر ۳ ثانیه اجرا شده تا حتی در صورت کندی شبکه، صفحه وب درس در مودل و وردپرس بلافاصله برای کاربر لود شود.
🌐
کلاسترینگ مدیاسرورها (Distributed SFU)
استفاده از جریان‌های وب‌آرتی‌سی توزیع‌شده که هر سرور تا ۲۰۰۰ جریان صوتی/تصویری را مدیریت کرده و با لودبالانسر بدون افت کیفیت اسکیل می‌شود.
📊
اتصالات پایدار و بهینه‌سازی B-Tree Index
ثبت لاگ‌ها و آمار به صورت دسته‌ای (Batch Persist هر ۳۰ ثانیه) بدون ایجاد بار و قفل روی پایگاه داده.