اتصال رایان‌استریم به کلاس‌آموز یا LMS
LMS مالک کاربر و دوره می‌ماند و رایان‌استریم با API اتاق میسازد، ورود امن می‌دهد و رخدادها را برمی‌گرداند.
گام‌به‌گام
- در محیط سرور LMS یک اعتبار API محدود بسازید.
- هنگام ساخت کلاس، اتاق متناظر را از API ایجاد و شناسه را ذخیره کنید.
- برای هر ورود، بلیت یا SSO کوتاه‌عمر از سمت سرور بگیرید.
- پایان جلسه و گزارش‌های لازم را با وب‌هوک دریافت و تطبیق دهید.
چه داده‌ای را همگام کنیم
حداقل دادهٔ لازم سه چیز است: کاربر (با شناسهٔ یکتا)، ثبتنام در دوره، و جلسهٔ زمان‌بندی‌شده. هر دادهٔ اضافه‌ای که همگام شود، سطح خطا و نگهداری را بالا می‌برد.
نمره و پیشرفت را فقط اگر واقعاً در هر دو سیستم استفاده می‌شود همگام کنید. در غیر این صورت یکی را منبع حقیقت اعلام کنید و دیگری را فقط نمایش بدهید.
برای هر داده یک جهت حرکت مشخص کنید و در مستندات بنویسید. جدولی با ستون‌های داده، منبع، جهت و تناوب، بیشتر اختلاف‌های آینده را جلوگیری می‌کند.
- کاربر، ثبتنام و جلسه: حداقل لازم
- برای هر داده یک جهت مشخص
- نمره را فقط در یک سیستم نگه دارید
خطاهای همگامسازی و رفع آن‌ها
رایج‌ترین خطا، ساخت کاربر تکراری به‌دلیل تفاوت ایمیل یا فاصلهٔ اضافه در شناسه است. دومین خطا، جلسهٔ بدون مدرس است که به‌دلیل ترتیب اجرای اشتباه رخ می‌دهد. سومین خطا، ثبتنام بدون دسترسی است؛ کاربر در دوره هست اما نمی‌تواند وارد جلسه شود.
برای هر سه، یک گزارش روزانهٔ تطبیق بسازید که تعداد کاربران بدون جلسه، جلسات بدون مدرس و ثبت‌نام‌های بدون دسترسی را نشان دهد. همین گزارش، بیشتر خرابی‌ها را قبل از شکایت کاربر پیدا می‌کند.
- شناسهٔ یکتا با نرمال‌سازی فاصله
- ساخت مدرس قبل از جلسه
- گزارش روزانهٔ تطبیق
آزمون پذیرش پس از اتصال
پس از اتصال، یک آزمون پذیرش پنج‌مرحله‌ای اجرا کنید: ساخت کاربر آزمایشی در LMS، ثبتنام در دوره، ساخت جلسه، ورود به کلاس با همان حساب، و مشاهدهٔ گزارش حضور در LMS.
هر مرحله را جدا ثبت کنید تا در صورت خطا بدانید کدام لایه شکسته است. آزمون را قبل از شروع ترم انجام دهید، نه در هفتهٔ اول کلاس.
در پایان، یک کاربر آزمایشی را حذف کنید و بررسی کنید که حذف در هر دو سیستم اعمال می‌شود. حذف ناقص، منبع خطاهای گزارش‌های آینده است.
مالکیت داده پس از اتصال
پس از اتصال، مشخص کنید دادهٔ کدام سیستم مرجع است. کاربر، ثبتنام، جلسه، حضور و نمره هر کدام باید یک مرجع داشته باشند. اگر دو مرجع باشد، اختلاف دیر یا زود ظاهر می‌شود.
برای خروجی گرفتن، فرمت و بازهٔ نگهداری را تعیین کنید. اگر روزی بخواهید سیستم را عوض کنید، همین خروجی تعیین می‌کند که مهاجرت یک هفته طول بکشد یا یک ماه.
دسترسی به داده را نقش‌محور کنید. گزارش حضور و نمره نباید برای همهٔ نقش‌ها باز باشد؛ این هم مسئلهٔ حریم خصوصی است و هم مسئلهٔ اعتماد.
زمان‌بندی همگامسازی
همگامسازی کاربر و ثبتنام را در ساعات کم‌ترافیک اجرا کنید و جلسات را رویدادمحور بسازید. اجرای سنگین هم‌زمان با شروع کلاس، تأخیر ایجاد می‌کند.
برای هر همگامسازی، یک بازهٔ زمانی و یک حد تلاش مجدد تعیین کنید. تلاش بی‌پایان، صف را قفل می‌کند و خطا را پنهان میسازد.
نتیجهٔ هر اجرا را در یک گزارش کوتاه ثبت کنید: تعداد رکورد، تعداد خطا و مدت اجرا. تغییر ناگهانی این سه عدد، هشدار زودهنگام است.
خطاهای رایج
- فراخوانی API محرمانه از مرورگر
- ساخت حساب تکراری برای هر سامانه
- اعتماد به وب‌هوک بدون امضا و تکرارپذیری
چک‌لیست بررسی
- تنظیمات در اتاق آزمایشی ذخیره و بازبینی شده است
- دسترسی نقش مدرس و شرکت‌کننده جداگانه آزموده شده است
- یک مسیر جایگزین برای اینترنت یا دستگاه ضعیف تعریف شده است
- نتیجه جلسه برای بهبود اجرای بعد ثبت می‌شود
پرسش‌های متداول
همگامسازی هر چند وقت اجرا شود؟
کاربر و ثبتنام روزانه یا ساعتی کافی است؛ جلسات بهتر است رویدادمحور و بلافاصله ساخته شوند.
اگر دو سیستم هر دو کاربر بسازند؟
یکی را منبع اعلام کنید و دیگری را فقط مصرفکننده. ساخت دوطرفه بدون قاعده، همیشه کاربر تکراری میسازد.