sara-dashboards/bug_cancel_page.md

3.6 KiB
Raw Permalink Blame History

باگ محاسبه و نمایش آنی جریمه کنسلی و اصلاح متن در صفحه لغو رزرو بازیکن

آدرس صفحه: https://ekeepa.co/user/game-cancel/2149633299
بخش: تجربه و اتاق فرار (لغو رزرو سمت کاربر)
اولویت: High / UI-UX & Backend


۱. صورت مسئله و شرح دوگانه باگ

در صفحه لغو رزرو تجربه (/user/game-cancel/:reserveId):

  1. عدم نمایش مبلغ جریمه و بازگشتی در لود اولیه صفحه:

    • وضعیت فعلی: کاربر وقتی وارد صفحه می‌شود، در کارت «مبلغ جریمه کنسلی»، هیچ عددی نمایش داده نمی‌شود و کادر خالی است. مبلغ جریمه یا مبلغ قابل استرداد فقط زمانی محاسبه و نمایش داده می‌شود که کاربر دکمه نهایی «لغو رزرو» را کلیک کند!
    • وضعیت مطلوب: به محض ورود به صفحه (On Mount)، سیستم باید بر اساس زمان جاری و زمان مانده تا سانس، مبلغ جریمه و مبلغ قابل بازگشت به کیف پول را محاسبه کند و بلافاصله به کاربر نمایش دهد تا کاربر قبل از کلیک روی لغو، از جریمه و عدد بازگشتی مطلع شود.
  2. اشتباه در متن زیرعنوان کارت جریمه (Terminology Bug):

    • متن فعلی: «مبلغ قابل کسر از حساب برگزارکننده»
    • متن اصلاح‌شده: «مبلغ قابل کسر از حساب خریدار (کاربر)»
    • دلیل: در صفحه لغو رزرو سمت کاربر، خریدار در حال لغو است و جریمه از وجه پرداختی کاربر کسر می‌شود؛ انتساب آن به «برگزارکننده» موجب سردرگمی کاربر می‌شود.

۲. وظایف تفکیک‌شده تیم فنی

الف) سمت فرانت‌اند (مرتضی صادقی)

  • فراخوانی اندپوینت پیش‌نمایش کنسلی (preview-cancel یا مشابه) در هوک useEffect به محض بارگذاری صفحه با reserveId.
  • رندر بلافاصله‌ی مبالغ در کارت جریمه (مبلغ پرداختی اولیه، درصد جریمه، مبلغ کسر شده، مبلغ قابل استرداد به کیف پول).
  • اصلاح متن ساب‌تایتل کارت جریمه از مبلغ قابل کسر از حساب برگزارکننده به مبلغ قابل کسر از حساب خریدار.
  • نمایش لودینگ اسکلتون شفاف تا زمان دریافت پاسخ از سرور.

ب) سمت بک‌اند (آرمین زاهدی)

  • پیاده‌سازی یا اصلاح اندپوینت GET /v2/site/reservations/:id/cancel-preview جهت بازگرداندن مقادیر زیر قبل از تایید نهایی:
    • total_paid_amount: کل مبلغ پرداختی
    • penalty_percentage: درصد جریمه بر اساس قوانین بازه زمانی
    • penalty_amount: مبلغ جریمه به ریال/تومان
    • refund_amount: مبلغ قابل استرداد به کیف پول کاربر

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

  • به محض باز شدن صفحه https://ekeepa.co/user/game-cancel/:id، کاربر بدون فشردن دکمه لغو، مبلغ جریمه و مبلغ عودت وجه را مشاهده کند.
  • عبارت «برگزارکننده» در این کارت به «خریدار» تغییر کرده باشد.