feat: redesign competitive position experience

This commit is contained in:
2026-08-22 18:45:18 +08:00
parent 2f856db441
commit 2d6519a7bb
11 changed files with 455 additions and 86 deletions

View File

@@ -78,7 +78,7 @@ Technical route names are proposed for planning only; final route contracts rema
| Failed-session detail | پرداخت‌های ناموفق | Review observed failure stages without invented causes | From failure card; CSV eligible |
| Retried-session detail | پرداخت‌های تکرارشده | Review attempt history and eventual recovery | From retry card; CSV eligible |
| Fees | کارمزد و درآمد | Understand real merchant fee amount and paid fee rate in Rial | From navigation/overview; no attempt-grain fee multiplication |
| Peer comparison | مقایسه با هم‌گروه‌ها | Compare approved metrics with eligible same-category merchants | Aggregate-only; never links to peer rows or peer export |
| Competitive position | جایگاه رقابتی | Compare approved metrics with eligible same-category businesses | Aggregate-only; never links to peer rows or peer export |
| Metric quality | کیفیت داده و شاخص‌ها | Understand definitions, periods, freshness, coverage, suppression, and limitations | From navigation and definition/provenance links |
| Account/session | حساب کاربری | Confirm current merchant identity, switch theme, or log out | No roles/profile editing in MVP |
@@ -88,7 +88,7 @@ Desktop navigation order from top to bottom:
1. Product mark and label.
2. Merchant identity block: merchant display name plus non-interactive account context.
3. Primary analysis links: پیشخوان، عملکرد پرداخت، کارمزد و درآمد، مقایسه با هم‌گروه‌ها.
3. Primary analysis links: پیشخوان، عملکرد پرداخت، کارمزد و درآمد، جایگاه رقابتی.
4. Trust link: کیفیت داده و شاخص‌ها.
5. Bottom utility group: theme control, account, logout.
@@ -125,7 +125,7 @@ Wireframes show reading hierarchy, not pixel-perfect styling. In each diagram, t
│ [بازه و مبنای مقایسه] [خلاصه صفحه]│ ● پیشخوان │
│ │ عملکرد پرداخت │
│ ┌────────┬────────┬────────┬────────┐ │ کارمزد و درآمد │
│ │ KPI ۴ │ KPI ۳ │ KPI ۲ │ KPI ۱ │ ← ترتیب خواندن RTL │ مقایسه هم‌گروه‌ها │
│ │ KPI ۴ │ KPI ۳ │ KPI ۲ │ KPI ۱ │ ← ترتیب خواندن RTL │ جایگاه رقابتی │
│ └────────┴────────┴────────┴────────┘ │ │
│ │ کیفیت داده و شاخص‌ها│
│ ┌───────────────────────────────────┬───────────────────────┐ │ │
@@ -366,7 +366,7 @@ The primary chart is a period trend for fee amount with an optional explicit swi
The product calls the value «کارمزد واقعی بازرگان» or «کارمزد پرداخت‌های بانکی», never obfuscated, estimated, or attempt-based. A fee rate with a zero paid amount is undefined, not `۰٪`.
### 9.6 Peer comparison / مقایسه با هم‌گروه‌ها
### 9.6 Competitive position / جایگاه رقابتی
#### Eligibility preface
@@ -382,13 +382,13 @@ The page explains that comparison uses other eligible merchants in the active me
6. Direction note when lower is better for processing time or paid fee rate.
7. Definition and suppression policy link.
Recommended plot: a compact benchmark range/bar with two direct markers, «شما» and «میانه هم‌گروه‌ها», plus a textual percentile. It is not a distribution of individual peers and must not imply unseen individual ranks.
Recommended plot: a ranked competitive-position board with a compact benchmark rail, two direct markers, «شما» and «میانه گروه مقایسه», plus a textual percentile. Cards are ordered from highest to lowest percentile with stable metric-id tie ordering. It is not a distribution of individual peers and must not imply unseen individual ranks.
#### Suppressed state
If there are fewer than 10 other eligible merchants or fewer than 1,000 combined peer sessions, replace peer values and plot with:
«برای نمایش مقایسه قابل‌اعتماد، داده هم‌گروه‌های کافی در این بازه وجود ندارد. آمار خود شما همچنان کامل نمایش داده می‌شود.»
«برای نمایش مقایسه قابل‌اعتماد، داده کسب‌وکارهای مشابه در این بازه کافی نیست. آمار خود شما همچنان کامل نمایش داده می‌شود.»
Do not reveal which threshold failed, a near-threshold count that could aid differencing, or any peer identity/value. Merchant-owned sections remain visible.
@@ -509,7 +509,7 @@ Chart rules:
| `InBank` | رسیده به درگاه بانکی | ردشده توسط بانک |
| Undefined rate | نرخ قابل محاسبه نیست | `۰٪` |
| No rows | داده‌ای در این بازه وجود ندارد | System failure |
| Peer suppression | داده هم‌گروه کافی نیست | Merchant underperformance |
| Peer suppression | داده گروه مقایسه کافی نیست | Merchant underperformance |
## 12. Persian RTL content and formatting
@@ -580,7 +580,7 @@ Selecting «دریافت CSV» opens an inline panel or dialog with:
- Applied approved filters and sort-independent export scope.
- Known result count or a statement that the server will determine it.
- Money unit: Rial.
- Data notice: «فایل فقط شامل ردیف‌ها و فیلدهای مجاز همین نمای جزئیات است و اطلاعات پرداخت‌کننده یا هم‌گروه‌ها را ندارد.»
- Data notice: «فایل فقط شامل ردیف‌ها و فیلدهای مجاز همین نمای جزئیات است و اطلاعات پرداخت‌کننده یا کسب‌وکارهای مشابه را ندارد.»
- Primary action «ساخت فایل CSV» and cancel action.
This is a scope confirmation, not a destructive confirmation. Focus returns to the export trigger when dismissed.