sara-dashboards/bug_cancel_page.md

43 lines
3.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# باگ محاسبه و نمایش آنی جریمه کنسلی و اصلاح متن در صفحه لغو رزرو بازیکن
**آدرس صفحه:** `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`، کاربر بدون فشردن دکمه لغو، مبلغ جریمه و مبلغ عودت وجه را مشاهده کند.
- عبارت «برگزارکننده» در این کارت به «خریدار» تغییر کرده باشد.