جزئیات شغل

پیاده‌سازی RPC اضطراری TerminateUserSession جهت قطع آنی دسترسی کاربر مسدودشده در ملک با خاصیت تکرارپذیری ایمن ( manager of backend )

تجربه: 3

سن: 18 الی 30

محدوده حقوق و دستمزد: قابل مذاکره

جای خالی: 1

طبیعت شغلی : پیمانی

تاریخ ارسال : 2026.11.14

آخرین تاریخ : 2027.01.20

۱. شرح مسئله و هدف معماری (Problem Statement & Objective)

طبق بخش‌های ۷، ۹ و ۱۰ سند، اگر حساب کاربری (مثلاً کاربر ۲۵ که هم‌اکنون داخل ملک ۴۱۲ حضور دارد) در میکروسرویس غیرفعال یا مسدود شود و یا مجوز مشخصی از او گرفته شود، میکروسرویس مستقیماً از طریق gRPC Unary متد TerminateUserSession را در Gameplay فراخوانی می‌کند.
سرور Gameplay باید بلافاصله نشست فعال کاربر را پیدا کرده، سیاست خروج و قطع دسترسی را اجرا کند و نتیجه را به میکروسرویس گزارش دهد. همچنین طبق شرط مهم بخش ۷ و ۹، این دستور حیاتی باید تکرارپذیر اما بدون اثر دوباره (Idempotent) باشد و هنگام تلاش مجدد کاربر برای ورود نیز وضعیت معتبر دسترسی بررسی گردد.

۲. مشخصات فنی (Technical Specification)

  • قطع فوری نشست (Immediate Session Termination):
    • جستجوی نشست‌های فعال user_id در تمام Roomها و Instanceهای Gameplay.
    • ارسال کد بسته شدن نشست به کلاینت Unity WebGL، بستن اتصال شبکه (WSS)، حذف کاربر از Room ملک ۴۱۲ و باطل کردن توکن نشست بازی (GameplaySession) و هرگونه launch_code مصرف‌نشده آن کاربر.
  • رفتار Idempotent در برابر تکرار درخواست (بخش ۷ و ۹):
    • اگر درخواست پایان نشست با همان event_id دو بار برسد (مثلاً به علت Timeout پاسخ اول در شبکه)، اجرای بار دوم نباید خطا یا وضعیت نامعتبر تولید کند؛ بلکه باید پاسخ موفق (processed: true, session_state: ALREADY_OFFLINE) برگرداند.
    • اگر کاربر در لحظه دریافت دستور اصلاً آنلاین نباشد، Gameplay وضعیت عدم دسترسی/ابطال را ثبت کرده و پاسخ مناسب (processed: true, session_state: ALREADY_OFFLINE) را اعلام می‌کند.
  • جلوگیری از ورود مجدد غیرمجاز (بخش ۷):
    • ثبت وضعیت ابطال دسترسی کاربر در لیست سیاه/کش امنیتی Gameplay تا اگر کاربر با یک launch_code یا نشست در حال اتصال تلاش کرد وارد شود، دسترسی او رد شود.

۳. الزامات پیاده‌سازی (Implementation Tasks)

  • پیاده‌سازی متد TerminateUserSession در سرور gRPC Gameplay با بالاترین سطح اولویت پردازش.
    پیاده‌سازی مکانیزم Pub/Sub داخلی (مثلاً Redis Pub/Sub بین Instanceهای Gameplay) تا اگر کاربر روی هر Instance دیگری از سرور بازی متصل است، نشست او در کسری از ثانیه قطع شود.
    ابطال تمامی GameplaySessionها و launch_codeهای فعال مرتبط با user_id.
    ذخیره event_id دستور ابطال و وضعیت مسدودی کاربر جهت تضمین Idempotency در برابر Retryهای Outbox میکروسرویس.
    نوشتن تست‌های سناریوی واقعی: (الف) کاربر آنلاین در ملک ۴۱۲ مسدود می‌شود ⬅ قطع فوری؛ (ب) کاربر آفلاین مسدود می‌شود ⬅ پاسخ موفق ALREADY_OFFLINE؛ (ج) تکرار همان درخواست ⬅ پاسخ موفق بدون خطا.

۴. معیارهای پذیرش (Acceptance Criteria)

  • با فراخوانی TerminateUserSession برای کاربر آنلاین در ملک ۴۱۲، اتصال کلاینت Unity WebGL در کمتر از ۱ ثانیه قطع شده و کاربر از Room خارج می‌شود.
    فراخوانی مجدد متد با همان event_id یا برای کاربری که از قبل آفلاین است، بدون پرتاب Exception، پاسخ موفق با وضعیت ALREADY_OFFLINE برمی‌گرداند.
    کاربر مسدودشده پس از قطع نشست، امکان استفاده مجدد از نشست قبلی یا ادامه حضور در ملک را ندارد.

    جهت مطالعه کامل تسک در گیتهاب از لینک زیر اقدام نمایید
    https://github.com/iranpsc/Metaverse-Rang-World-3D-Multiverse-Server/issues/9
مشخصات کار تعریف شده

عنوان شغلی: پیاده‌سازی RPC اضطراری TerminateUserSession جهت قطع آنی دسترسی کاربر مسدودشده در ملک با خاصیت تکرارپذیری ایمن

تعیین: manager of backend

تجربه: 3

سن: 18 الی 30

محدوده حقوق و دستمزد: قابل مذاکره

جای خالی: 1

طبیعت شغلی : پیمانی

تاریخ ارسال : 2026.11.14

آخرین تاریخ : 2027.01.20

اکنون درخواست دهید