جزئیات شغل

پیاده‌سازی الگوی Transactional Outbox و کلاینت gRPC اعلان تغییر موجودی و دستور اضطراری بستن نشست کاربر ( manager of backend )

تجربه: 4

سن: 18 الی 30

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

جای خالی: 1

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

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

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

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

طبق بخش‌های ۶، ۷، ۸ و ۹ سند، ارتباط بین دو سرور دوطرفه است و میکروسرویس نیز در دو سناریوی کلیدی خودش آغازگر ارتباط gRPC Unary به سمت Gameplay است:

  1. اعلان تغییر اطلاعات حساب (بخش ۶): وقتی موجودی سکه کاربر ۲۵ در میکروسرویس تغییر می‌کند (مثلاً از ۱۸۰ به ۲۱۰ سکه) یا امتیاز/سطح او ارتقا می‌یابد، میکروسرویس رویداد را به Gameplay می‌فرستد تا Station داخل Unity به‌روز شود.
  2. دستور حساس پایان نشست کاربر (بخش ۷): وقتی حساب کاربر در میکروسرویس غیرفعال/مسدود می‌شود یا مجوز او لغو می‌گردد، میکروسرویس نباید منتظر بماند تا Gameplay بعداً متوجه شود؛ بلکه باید مستقیماً با gRPC Unary دستور «پایان نشست» (TerminateUserSession) را به Gameplay بفرستد.

چالش قطع ارتباط (بخش ۷ و ۹): اگر در لحظه وقوع رویداد (مثلاً مسدود شدن کاربر ۲۵ یا تغییر مهم امتیاز)، سرور Gameplay به مدت ۲۰ ثانیه قطع باشد، میکروسرویس نباید فقط یک بار ارسال کند و آن را فراموش کند. رویداد باید با همان شناسه یکتا (event_id) و نسخه داده (data_version) در یک Outbox پایدار نگهداری شود و پس از بازگشت Gameplay با تأخیر کنترل‌شده (Backoff) مجدداً ارسال گردد تا تأیید معتبر دریافت شود.

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

  • جدول/مخزن integration_outbox_events:
    • فیلدها: event_id (UUID/ULID PK), user_id, event_type (COIN_UPDATED | SCORE_UPDATED | TERMINATE_SESSION), data_version, payload_json, status (PENDING | PROCESSING | COMPLETED | DEAD_LETTER), retry_count, next_retry_at, last_error, ack_status, created_at, updated_at.
  • تراکنش اتمیک (Transactional Guarantee): ثبت تغییر موجودی یا انسداد حساب کاربر در دیتابیس میکروسرویس و درج رکورد در جدول integration_outbox_events باید در یک تراکنش واحد دیتابیس انجام شوند.
  • ارسال فوری + Worker بازپخش (Immediate Dispatch + Retry Worker):
    • بلافاصله پس از Commit، ارسال gRPC Unary با Timeout مشخص تلاش می‌شود.
    • در صورت خطا یا Timeout (مثلاً قطع ۲۰ ثانیه‌ای Gameplay در بخش ۹)، وضعیت رویداد در Outbox پایدار باقی می‌ماند و Worker پس‌زمینه با الگوریتم Exponential Backoff + Jitter همان پیام را با همان event_id و data_version اولیه بازپخش می‌کند.

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

  • ایجاد Migration و مدل دیتابیس برای جدول پایدار integration_outbox_events.
    اتصال سرویس‌های داخلی تغییر موجودی سکه، تغییر امتیاز/سطح، و مسدودسازی/غیرفعال‌سازی حساب کاربر به تولیدکننده رویداد Outbox.
    پیاده‌سازی کلاینت gRPC برای متدهای PublishAccountEvent و TerminateUserSession با احراز هویت سرویس میکروسرویس (بدون استفاده از تیکت ورود ۶۰ ثانیه‌ای طبق بخش ۶).
    پیاده‌سازی پردازشگر پاسخ EventAckStatus (RECEIVED, RECORDED, APPLIED) و TerminateSessionResponse (TERMINATED, ALREADY_OFFLINE) جهت تغییر وضعیت رکورد Outbox به COMPLETED.
    پیاده‌سازی مکانیزم همگام‌سازی مجدد در صورت بازگشت از قطعی طولانی.

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

  • با تغییر سکه کاربر از ۱۸۰ به ۲۱۰ در میکروسرویس، درخواست PublishAccountEvent بلافاصله به Gameplay ارسال شده و پس از دریافت تأیید، وضعیت رویداد در Outbox به COMPLETED تغییر می‌کند.
    در سناریوی تست قطع ۲۰ ثانیه‌ای Gameplay (بخش ۹)، دستور TerminateUserSession در اولین تلاش به Timeout می‌خورد، در Outbox باقی می‌ماند، و پس از بالا آمدن مجدد Gameplay با همان event_id ارسال و تکمیل می‌شود.

    اگر پاسخ Gameplay در شبکه قطع شود و میکروسرویس همان رویداد را بار دوم ارسال کند، هیچ خطا یا وضعیت نامعتبری ایجاد نمی‌شود.


    لینک مطالعه تسک در گیتهاب:
    https://github.com/iranpsc/Metaverse-Rang-Microservice/issues/187

    مشخصات کار تعریف شده

    عنوان شغلی: پیاده‌سازی الگوی Transactional Outbox و کلاینت gRPC اعلان تغییر موجودی و دستور اضطراری بستن نشست کاربر

    تعیین: manager of backend

    تجربه: 4

    سن: 18 الی 30

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

    جای خالی: 1

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

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

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

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