توسعه بک اند تخصیص Room

موقعیت مکانی
قزوین
نوع همکاری
پروژه
حقوق
۴۰۰۰۰۰۰ تا ۹۰۰۰۰۰۰ تومان

مهارت های موردنیاز

  • برنامه نویسی
  • برنامه نویسی یونیتی
  • unity
  • backend
  • برنامه نویسی وب
  • کدنویسی
  • برنامه نویس بک اند
  • بک اند
  • backend development
  • سرور
تخصیص Room ملک، تولید launch_url و launch_code یک‌بارمصرف و مدیریت اتصال نشست Unity WebGL داخل iframe



۱. شرح مسئله و هدف معماری (Problem Statement & Objective)
طبق بخش‌های ۳، ۳-الف و ۳-ب سند، پس از تأیید تیکت ورود در Gameplay:

سرور Gameplay برای کاربر ۲۵ و ملک ۴۱۲، ورود مجاز و Room مقصد را آماده و مشخص می‌کند (جزئیات محیط سه‌بعدی نزد Gameplay باقی می‌ماند و نیازی به انتقال کل محیط سه‌بعدی به میکروسرویس نیست).
در پاسخ همان درخواست gRPC Unary، فیلدهای accepted = true، launch_url (آدرس صفحه اجرای نسخه مشترک Unity WebGL)، launch_code (مجوز کوتاه‌مدت و یک‌بارمصرف برای شروع نشست بازی؛ جایگزین تیکت اولیه) و request_id را به میکروسرویس برمی‌گرداند.
وقتی React صفحه launch_url را داخل iframe باز می‌کند، همه کاربران یک بیلد مشترک Unity WebGL را بارگذاری می‌کنند؛ سپس کلاینت Unity با ارائه launch_code به Gameplay متصل می‌شود و Gameplay بر اساس نشست معتبر تشخیص می‌دهد که باید محیط ملک ۴۱۲ را برای کاربر ۲۵ بارگذاری کند.
۲. مشخصات فنی و امنیتی (Technical Specification)
جداسازی تیکت اولیه از لینک iframe (نکته امنیتی بخش ۳-ب):
تیکت اولیه بین دو سرور مصرف شده است.
سرور Gameplay یک launch_code (توکن تصادفی یک‌بارمصرف با TTL کوتاه مثلاً ۳۰ تا ۶۰ ثانیه) تولید می‌کند که در Redis/Memory به (user_id=25, property_id=412, room_id) متصل است.
آدرس WebGL به تنهایی مجوز ورود نیست؛ کلاینت Unity پس از بالا آمدن در iframe، هنگام برقراری اتصال (WSS / HTTPS)، launch_code را تحویل می‌دهد و یک نشست فعال بازی (Gameplay Session) دریافت می‌کند.
استقلال عمر نشست از تیکت ۶۰ ثانیه‌ای (بخش ۳):
مهلت ۶۰ ثانیه فقط برای پذیرفته شدن ورود اولیه است، نه برای مدت اقامت کاربر در ملک. پس از برقراری نشست Gameplay، ادامه حضور کاربر و قواعد قطع و وصل مجدد تابع چرخه نشست Gameplay است.
الزامات زیرساختی WebGL در iframe (بخش ۳-ب):
تنظیم هدرهای امنیتی وب‌سرور میزبان بیلد WebGL: تنظیم Content-Security-Policy: frame-ancestors https:// تا فقط سایت میکروسرویس اجازه قرار دادن بازی در iframe را داشته باشد.
فعال‌سازی کامل HTTPS برای بارگذاری فایل‌های فشرده WebGL (.wasm, .data, .framework.js با Content-Encoding: br/gzip) و WSS برای ارتباط بلادرنگ کلاینت Unity با سرور Gameplay.
۳. الزامات پیاده‌سازی (Implementation Tasks)
پیاده‌سازی منطق تخصیص یا ایجاد Room برای ملک مقصد (property_id) در پاسخ به ورود موفق کاربر.
تولید launch_code یک‌بارمصرف و ساخت launch_url در پاسخ RequestPropertyEntry به همراه بازگرداندن دقیق request_id.
پیاده‌سازی Handshake اتصال کلاینت Unity WebGL به سرور Gameplay: مصرف launch_code، ایجاد GameplaySession مقید به (user_id, property_id, room_id) و ارسال دستور بارگذاری محیط ملک مربوطه (مثلاً ملک ۴۱۲) به Unity.
پیکربندی هدرهای CSP frame-ancestors و CORS روی سرور ارائه‌دهنده Unity WebGL جهت اجرا داخل iframe دامنه میکروسرویس.
مدیریت خاتمه تمیز نشست (Session Cleanup) هنگام خروج کاربر از ملک یا بسته شدن Modal در React (بخش ۱۲ - گام ۰۸).
۴. معیارهای پذیرش (Acceptance Criteria)
کلاینت Unity WebGL از یک آدرس Build مشترک بارگذاری می‌شود اما پس از اتصال به Gameplay، دقیقاً محیط ملک تأییدشده (property_id = 412) را برای کاربر 25 بارگذاری می‌کند.
باز کردن مستقیم launch_url بدون launch_code معتبر و مصرف‌نشده، اجازه ورود به هیچ ملکی را نمی‌دهد.
پس از برقراری نشست در ثانیه ۲۰، کاربر می‌تواند ساعت‌ها در ملک بماند و انقضای تیکت اولیه ۶۰ ثانیه‌ای باعث قطع نشست فعال او نمی‌شود.