پیاده سازی کلاینت gRPC استعلام لحظه ای Stationها
- موقعیت مکانی
- قزوین
- نوع همکاری
- پروژه
- حقوق
- ۴۰۰۰۰۰۰ تا ۹۰۰۰۰۰۰ تومان
مهارت های موردنیاز
- برنامه نویسی
- کدنویسی
- بازی سازی
- بازی های موبایلی
- طراح بازی ویدیویی
- برنامه نویسی یونیتی
- برنامه نویسی وب
- unity
- unity3d
پیادهسازی کلاینت gRPC استعلام لحظهای Stationها (سکه و امتیاز) با استخراج امن هویت از نشست، Timeout و Cache
۱. شرح مسئله و هدف معماری (Problem Statement & Objective)
طبق بخشهای ۴، ۵، ۸، ۹، ۱۰ و ۱۱ سند، صرفِ حضور ۱۰٬۰۰۰ کاربر در ملک هیچ ترافیکی به سمت میکروسرویس ایجاد نمیکند. تنها زمانی که کاربر در محیط Unity به دستگاه «موجودی سکه» یا «Station امتیاز و سطح» مراجعه میکند:
کلاینت Unity از سرور Gameplay درخواست نمایش اطلاعات آن Station را میکند.
سرور Gameplay شناسه کاربر را از نشست فعال و معتبر خودش استخراج میکند (و هرگز به userId ارسالی از کلاینت Unity اعتماد نمیکند - بخش ۵ و ۱۰).
سرور Gameplay با استفاده از اعتبار سرویس خودش (بدون نیاز به تیکت ورود جدید) یک درخواست کوتاه gRPC Unary روی Channel قابلاستفاده مجدد به میکروسرویس میفرستد و فقط فیلدهای مجاز همان Station را میگیرد.
در صورت عدم پاسخگویی میکروسرویس، درخواست پس از Timeout مشخص پایان یافته و پیام قابلفهمی مانند «اطلاعات فعلاً در دسترس نیست» یا داده کششده معتبر نمایش داده میشود.
۲. الزامات امنیتی و پایداری (Security & Resilience Requirements)
جلوگیری از سوءاستفاده تغییر شناسه (Anti-IDOR - بخش ۱۰): اگر کلاینت Unity در بسته ارسالی خود user_id = 99 بفرستد ولی نشست فعال متعلق به user_id = 25 باشد، Gameplay باید درخواست را صرفاً برای user_id = 25 (یا رد درخواست مشکوک) پردازش کند تا هیچ کاربری نتواند موجودی سکه شخص دیگری را بخواند.
مدیریت Timeout و عدم انتظار بینهایت (بخش ۵ و ۹): هر درخواست gRPC Unary به میکروسرویس باید دارای Deadline / Timeout صریح (مثلاً 1500ms تا 2000ms) باشد.
سیاست Cache و Rate Limit سمت Gameplay (بخش ۵ و ۱۱):
جلوگیری از Spam کلیک روی Station توسط یک کاربر (Coalescing / Per-User Cooldown).
نگهداری اختیاری کش کوتاهمدت (مثلاً با برچسب زمان) که در صورت دریافت رویداد تغییر از میکروسرویس (GS-04) بلافاصله بهروز میشود و در مواقع قطعی موقت میکروسرویس میتواند با نشانگر «آخرین داده ذخیرهشده» نمایش داده شود.
۳. الزامات پیادهسازی (Implementation Tasks)
پیادهسازی Handler درخواستهای کلاینت Unity برای Station: CoinBalance و Station: ScoreAndLevel.
استخراج اجباری user_id و property_id از شیء GameplaySession سمت سرور.
پیادهسازی کلاینت MicroserviceAccountQueryService روی یک gRPC Channel مشترک و پایدار (Channel Pooling) با احراز هویت سرویس Gameplay.
تنظیم Timeout، Concurrency Limit (کنترل همزمانی هنگام درخواست همزمان ۱۰۰+ کاربر طبق بخش ۱۱) و Circuit Breaker.
پیادهسازی پاسخ Fallback استاندارد به Unity در صورت Timeout میکروسرویس تا Station پیام «اطلاعات فعلاً در دسترس نیست» را بدون قفل شدن محیط بازی نمایش دهد.
۴. معیارهای پذیرش (Acceptance Criteria)
حضور کاربران در ملک بدون باز کردن Station، دقیقاً 0 درخواست gRPC به سمت میکروسرویس ارسال میکند.
با کلیک کاربر ۲۵ روی دستگاه سکه، مقدار دقیق برگشتی از میکروسرویس (مثلاً ۱۸۰ سکه) در Unity نمایش داده میشود.
تلاش کلاینت دستکاریشده Unity برای خواندن سکه کاربر دیگر، توسط Gameplay مسدود شده و فقط اطلاعات صاحب نشست خوانده میشود.
در صورت خاموش بودن میکروسرویس، درخواست Gameplay پس از اتمام Timeout خاتمه یافته و Station در Unity پیام «اطلاعات فعلاً در دسترس نیست» را نمایش میدهد.
۱. شرح مسئله و هدف معماری (Problem Statement & Objective)
طبق بخشهای ۴، ۵، ۸، ۹، ۱۰ و ۱۱ سند، صرفِ حضور ۱۰٬۰۰۰ کاربر در ملک هیچ ترافیکی به سمت میکروسرویس ایجاد نمیکند. تنها زمانی که کاربر در محیط Unity به دستگاه «موجودی سکه» یا «Station امتیاز و سطح» مراجعه میکند:
کلاینت Unity از سرور Gameplay درخواست نمایش اطلاعات آن Station را میکند.
سرور Gameplay شناسه کاربر را از نشست فعال و معتبر خودش استخراج میکند (و هرگز به userId ارسالی از کلاینت Unity اعتماد نمیکند - بخش ۵ و ۱۰).
سرور Gameplay با استفاده از اعتبار سرویس خودش (بدون نیاز به تیکت ورود جدید) یک درخواست کوتاه gRPC Unary روی Channel قابلاستفاده مجدد به میکروسرویس میفرستد و فقط فیلدهای مجاز همان Station را میگیرد.
در صورت عدم پاسخگویی میکروسرویس، درخواست پس از Timeout مشخص پایان یافته و پیام قابلفهمی مانند «اطلاعات فعلاً در دسترس نیست» یا داده کششده معتبر نمایش داده میشود.
۲. الزامات امنیتی و پایداری (Security & Resilience Requirements)
جلوگیری از سوءاستفاده تغییر شناسه (Anti-IDOR - بخش ۱۰): اگر کلاینت Unity در بسته ارسالی خود user_id = 99 بفرستد ولی نشست فعال متعلق به user_id = 25 باشد، Gameplay باید درخواست را صرفاً برای user_id = 25 (یا رد درخواست مشکوک) پردازش کند تا هیچ کاربری نتواند موجودی سکه شخص دیگری را بخواند.
مدیریت Timeout و عدم انتظار بینهایت (بخش ۵ و ۹): هر درخواست gRPC Unary به میکروسرویس باید دارای Deadline / Timeout صریح (مثلاً 1500ms تا 2000ms) باشد.
سیاست Cache و Rate Limit سمت Gameplay (بخش ۵ و ۱۱):
جلوگیری از Spam کلیک روی Station توسط یک کاربر (Coalescing / Per-User Cooldown).
نگهداری اختیاری کش کوتاهمدت (مثلاً با برچسب زمان) که در صورت دریافت رویداد تغییر از میکروسرویس (GS-04) بلافاصله بهروز میشود و در مواقع قطعی موقت میکروسرویس میتواند با نشانگر «آخرین داده ذخیرهشده» نمایش داده شود.
۳. الزامات پیادهسازی (Implementation Tasks)
پیادهسازی Handler درخواستهای کلاینت Unity برای Station: CoinBalance و Station: ScoreAndLevel.
استخراج اجباری user_id و property_id از شیء GameplaySession سمت سرور.
پیادهسازی کلاینت MicroserviceAccountQueryService روی یک gRPC Channel مشترک و پایدار (Channel Pooling) با احراز هویت سرویس Gameplay.
تنظیم Timeout، Concurrency Limit (کنترل همزمانی هنگام درخواست همزمان ۱۰۰+ کاربر طبق بخش ۱۱) و Circuit Breaker.
پیادهسازی پاسخ Fallback استاندارد به Unity در صورت Timeout میکروسرویس تا Station پیام «اطلاعات فعلاً در دسترس نیست» را بدون قفل شدن محیط بازی نمایش دهد.
۴. معیارهای پذیرش (Acceptance Criteria)
حضور کاربران در ملک بدون باز کردن Station، دقیقاً 0 درخواست gRPC به سمت میکروسرویس ارسال میکند.
با کلیک کاربر ۲۵ روی دستگاه سکه، مقدار دقیق برگشتی از میکروسرویس (مثلاً ۱۸۰ سکه) در Unity نمایش داده میشود.
تلاش کلاینت دستکاریشده Unity برای خواندن سکه کاربر دیگر، توسط Gameplay مسدود شده و فقط اطلاعات صاحب نشست خوانده میشود.
در صورت خاموش بودن میکروسرویس، درخواست Gameplay پس از اتمام Timeout خاتمه یافته و Station در Unity پیام «اطلاعات فعلاً در دسترس نیست» را نمایش میدهد.


