جزئیات شغل

پیاده‌سازی سرویس gRPC دریافت رویدادهای تغییر حساب از میکروسرویس، تضمین Idempotency و بروزرسانی آنی Station در Unity ( manager of backend )

تجربه: 3

سن: 18 الی 30

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

جای خالی: 1

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

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

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

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

طبق بخش‌های ۶، ۸ و ۹ سند، زمانی که اطلاعات کاربر در میکروسرویس تغییر می‌کند (مثلاً سکه کاربر ۲۵ از ۱۸۰ به ۲۱۰ تغییر می‌یابد)، میکروسرویس بدون منتظر ماندن برای درخواست Gameplay، خودش یک درخواست gRPC Unary (PublishAccountEvent) به سرویس دریافت رویداد در Gameplay ارسال می‌کند.
سرور Gameplay باید هویت میکروسرویس، شناسه کاربر، نسخه اطلاعات و مجوز نوع رویداد را بررسی کند، از اعمال تکراری رویداد جلوگیری نماید، پاسخ تأیید دقیق (RECEIVED | RECORDED | APPLIED) به میکروسرویس بدهد و اگر کاربر داخل ملک حضور دارد، مقدار جدید را به Station مربوطه در Unity ارسال کند.

۲. مشخصات فنی و کنترل نسخه داده (Technical Specification)

  • جلوگیری از اثر تکراری و رعایت ترتیب نسخه (بخش ۶ و ۹):
    • بررسی event_id در مخزن Idempotency: اگر میکروسرویس به علت قطعی شبکه یک رویداد را دوبار بفرستد، Gameplay با شناسایی event_id تکراری از اجرای دوباره اثر رویداد جلوگیری کرده و پاسخ موفق برمی‌گرداند.
    • بررسی data_version (نسخه اطلاعات): اگر نسخه داده دریافتی قدیمی‌تر از نسخه ثبت‌شده فعلی در Gameplay باشد، مقدار قدیمی جایگزین مقدار جدیدتر نمی‌شود.
  • شفافیت معنایی پاسخ تأیید (نکته انتهایی بخش ۶):
    • تأیید gRPC به تنهایی به معنی نمایش قطعی در Unity نیست؛ بنابراین فیلد ack_status در پاسخ به میکروسرویس به صورت دقیق مشخص می‌کند که آیا پیام:
      • APPLIED: به نشست فعال کاربر در ملک ارسال و اعمال شده است،
      • RECORDED: در کش/وضعیت سرور Gameplay ثبت شده است (مثلاً کاربر در حال بارگذاری است)،
      • یا RECEIVED: دریافت و ثبت شده اما کاربر در حال حاضر داخل هیچ ملکی آنلاین نیست.

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

  • پیاده‌سازی متد PublishAccountEvent در سرور gRPC Gameplay با بررسی اعتبارنامه سرویس میکروسرویس.
    پیاده‌سازی لایه Deduplication و کنترل نسخه (event_id و data_version) در Redis/حافظه سرور.
    به‌روزرسانی کش داخلی اطلاعات کاربر در Gameplay (در صورت فعال بودن کش GS-03).
    مسیریابی رویداد به Room و نشست فعال کاربر (user_id) و ارسال بسته بلادرنگ (WebSocket/WebTransport) به کلاینت Unity جهت به‌روزرسانی نمایشگر Station (مثلاً تغییر عدد سکه از ۱۸۰ به ۲۱۰).
    بازگرداندن پاسخ دقیق AccountEventResponse همراه با ack_status به میکروسرویس.

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

  • وقتی کاربر ۲۵ داخل ملک ۴۱۲ است و میکروسرویس رویداد تغییر سکه به ۲۱۰ را می‌فرستد، عدد نمایش‌داده‌شده روی Station در Unity بدون نیاز به بستن و باز کردن مجدد Station به ۲۱۰ تغییر می‌کند و پاسخ APPLIED به میکروسرویس برمی‌گردد.
    ارسال مجدد همان رویداد با همان event_id هیچ اثر مضاعفی ایجاد نمی‌کند و پاسخ موفق برمی‌گرداند.
    ارسال یک رویداد قدیمی با data_version پایین‌تر، داده جدیدتر موجود در Gameplay را بازنویسی نمی‌کند.

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

عنوان شغلی: پیاده‌سازی سرویس gRPC دریافت رویدادهای تغییر حساب از میکروسرویس، تضمین Idempotency و بروزرسانی آنی Station در Unity

تعیین: manager of backend

تجربه: 3

سن: 18 الی 30

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

جای خالی: 1

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

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

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

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