sara-dashboards/cancel_bug.html

184 lines
8.6 KiB
HTML
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.

<!DOCTYPE html>
<html lang="fa" dir="rtl">
<head>
<meta charset="UTF-8">
<style>
@font-face {
font-family: 'IRANSans';
src: url('file:///home/hermeswebui/.hermes/skills/design/rtl-persian-design-system/assets/fonts/IRANSansWeb.ttf') format('truetype');
font-weight: normal;
}
@font-face {
font-family: 'IRANSans';
src: url('file:///home/hermeswebui/.hermes/skills/design/rtl-persian-design-system/assets/fonts/IRANSansWeb_Bold.ttf') format('truetype');
font-weight: bold;
}
@page {
size: A4;
margin: 15mm 15mm 15mm 15mm;
}
body {
font-family: 'IRANSans', sans-serif;
font-size: 11pt;
line-height: 1.6;
color: #0f172a;
margin: 0;
padding: 0;
}
.header-bar {
border-bottom: 2px solid #6366f1;
padding-bottom: 8px;
margin-bottom: 15px;
display: flex;
justify-content: space-between;
align-items: center;
}
.brand {
font-size: 10pt;
color: #64748b;
}
.doc-title {
font-size: 14pt;
font-weight: bold;
color: #0f172a;
margin-top: 5px;
margin-bottom: 8px;
}
.meta-box {
background-color: #f8fafc;
border: 1px solid #e2e8f0;
border-radius: 6px;
padding: 8px 12px;
font-size: 9pt;
color: #334155;
margin-bottom: 18px;
}
.meta-item {
margin-bottom: 3px;
}
.meta-item:last-child {
margin-bottom: 0;
}
.section-title {
font-size: 11.5pt;
font-weight: bold;
color: #4338ca;
margin-top: 15px;
margin-bottom: 8px;
border-right: 3px solid #6366f1;
padding-right: 8px;
}
p {
margin-top: 0;
margin-bottom: 10px;
text-align: justify;
}
table {
width: 100%;
border-collapse: collapse;
margin-top: 10px;
margin-bottom: 15px;
font-size: 9.5pt;
}
th, td {
border: 1px solid #cbd5e1;
padding: 8px 10px;
text-align: right;
vertical-align: top;
}
th {
background-color: #f1f5f9;
font-weight: bold;
color: #0f172a;
}
ul {
margin-top: 0;
margin-bottom: 10px;
padding-right: 20px;
}
li {
margin-bottom: 6px;
}
.footer {
position: fixed;
bottom: 0;
left: 0;
right: 0;
border-top: 1px solid #e2e8f0;
padding-top: 5px;
font-size: 8pt;
color: #94a3b8;
display: flex;
justify-content: space-between;
}
code {
font-family: monospace;
direction: ltr;
display: inline-block;
background: #e2e8f0;
padding: 1px 5px;
border-radius: 4px;
font-size: 9pt;
}
</style>
</head>
<body>
<div class="header-bar">
<span class="brand">سامانه رزرواسیون اکیپا (Ekeepa) — گزارش فنی و رفع باگ</span>
</div>
<div class="doc-title">گزارش باگ: عدم نمایش مبالغ جریمه و اصلاح اصطلاح در صفحه لغو رزرو بازیکن</div>
<div class="meta-box">
<div class="meta-item"><strong>آدرس صفحه هدف:</strong> <span style="direction: ltr; display: inline-block;">https://ekeepa.co/user/game-cancel/2149633299</span></div>
<div class="meta-item"><strong>شناسه رزرو نمونه:</strong> ۲۱۴۹۶۳۳۲۹۹ &nbsp;|&nbsp; <strong>اولویت:</strong> بالا (High) &nbsp;|&nbsp; <strong>تاریخ:</strong> ۲۷ مهر ۱۴۰۵</div>
</div>
<div class="section-title">۱. شرح مشکل و تحلیل باگ دوگانه</div>
<p>
<strong>الف) عدم محاسبه و نمایش جریمه در بارگذاری اولیه صفحه:</strong> در حال حاضر وقتی کاربر به صفحه لغو رزرو وارد می‌شود، کادر «مبلغ جریمه کنسلی» کاملاً خالی است و هیچ عددی به عنوان مبلغ کسر شده یا وجه استردادی به کیف‌پول نمایش داده نمی‌شود. کاربر تنها پس از کلیک روی دکمه نهایی لغو رزرو، با مبلغ مواجه می‌گردد که مغایر اصول تجربه کاربری (UX) بوده و ریسک کنسلی‌های ناخواسته و تماس‌های پشتیبانی را به شدت افزایش می‌دهد. مبالغ باید در لحظه لود (On Mount) متناسب با بازه زمانی محاسبه شده و نمایش داده شوند.
</p>
<p>
<strong>ب) استفاده از اصطلاح اشتباه در ساب‌تایتل کارت جریمه:</strong> در کارت جریمه فعلی عبارت «مبلغ قابل کسر از حساب برگزارکننده» درج شده است. از آنجا که این صفحه برای لغو رزرو توسط کاربر خریدار است، کسر وجه از حساب بازیکن (خریدار) صورت می‌گیرد؛ لذا این اصطلاح باید به «مبلغ قابل کسر از حساب خریدار» اصلاح شود تا هرگونه سوءتفاهم برطرف گردد.
</p>
<div class="section-title">۲. وظایف تفکیک‌شده تیم فنی (فرانت‌اند و بک‌اند)</div>
<table>
<thead>
<tr>
<th style="width: 25%;">بخش مسئول</th>
<th style="width: 75%;">اقدامات و نیازمندی‌های اجرایی</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>فرانت‌اند</strong><br/>(مرتضی صادقی)</td>
<td>
۱. فراخوانی اندپوینت پیش‌نمایش کنسلی بلافاصله پس از بارگذاری صفحه در <code>useEffect</code> بر اساس شناسه رزرو.<br/>
۲. رندر آنی مبالغ در کارت جریمه شامل کل پرداختی، مبلغ جریمه کسر شده و وجه عودت داده شده به کیف‌پول.<br/>
۳. اصلاح متن زیرعنوان کارت از «برگزارکننده» به «خریدار» (مبلغ قابل کسر از حساب خریدار).<br/>
۴. نمایش وضعیت لودینگ اسکلتون شفاف تا زمان دریافت پاسخ داده‌ها از سرور.
</td>
</tr>
<tr>
<td><strong>بک‌اند</strong><br/>(آرمین زاهدی)</td>
<td>
۱. ایجاد یا بازبینی اندپوینت <code>GET /v2/site/reservations/:id/cancel-preview</code> جهت بازگرداندن داده‌های پیش‌نمایش.<br/>
۲. محاسبه دقیق درصد و مبلغ جریمه بر اساس فاصله زمانی تا شروع سانس و عودت فیلدهای:<br/>
&nbsp;&nbsp;&nbsp;<code>total_paid_amount</code>, <code>penalty_percentage</code>, <code>penalty_amount</code>, <code>refund_amount</code><br/>
۳. اطمینان از همخوانی کامل محاسبات پیش‌نمایش با تراکنش استرداد نهایی به کیف‌پول کاربر.
</td>
</tr>
</tbody>
</table>
<div class="section-title">۳. معیارهای پذیرش نهایی (Acceptance Criteria)</div>
<ul>
<li>در بدو ورود کاربر به صفحه لغو، پیش از هرگونه کلیک روی دکمه لغو، جزئیات جریمه و مبلغ استردادی کیف‌پول واضح دیده شود.</li>
<li>واژه «برگزارکننده» در کارت جریمه به «خریدار» تغییر یافته باشد.</li>
<li>محاسبات ریالی و درصدی کاملاً منطبق با جدول قوانین مصوب تجربه انجام گردد (ساعت اول و بالای ۷۲ ساعت رایگان، ۲۴ تا ۷۲ ساعت ۱۰٪ کل سانس، زیر ۲۴ ساعت ۱۰۰٪ کل سانس).</li>
</ul>
</body>
</html>