From 474d364a2531ace1795d79143ceb488e50ebc88d Mon Sep 17 00:00:00 2001
From: masoodafar-web <masoud.afarin.moghaddam@outlook.com>
Date: Fri, 27 Feb 2026 05:40:04 +0330
Subject: [PATCH] feat(Q28): UI Guidance alerts across FrontOffice (G1-G7)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Q28: Added informational/warning alerts to 7 FO pages:
G1: Packages — package system explanation
G2: Checkout — package benefits summary
G3: MyPackages — cycle completion guidance
G4: MagicWallet — per-package settings warning
G5: Commission — independent pool explanation
G6: Membership — single-sign contract info
G7: ActivationSection — estimated cost note
---
 src/FrontOffice.Main/Pages/Checkout.razor                  | 5 +++++
 .../Pages/Club/Components/ActivationSection.razor          | 7 ++++++-
 src/FrontOffice.Main/Pages/Club/MembershipPage.razor       | 5 +++++
 .../Pages/Commission/CommissionDashboardPage.razor         | 5 +++++
 src/FrontOffice.Main/Pages/Package/MyPackages.razor        | 5 +++++
 src/FrontOffice.Main/Pages/Package/Packages.razor          | 5 +++++
 src/FrontOffice.Main/Pages/Profile/MagicWallet.razor       | 5 +++++
 7 files changed, 36 insertions(+), 1 deletion(-)

diff --git a/src/FrontOffice.Main/Pages/Checkout.razor b/src/FrontOffice.Main/Pages/Checkout.razor
index 036390a..79173be 100644
--- a/src/FrontOffice.Main/Pages/Checkout.razor
+++ b/src/FrontOffice.Main/Pages/Checkout.razor
@@ -27,6 +27,11 @@
                 <MudPaper Elevation="2" Class="pa-4 rounded-lg">
                     <MudText Typo="Typo.h5" Class="mb-4">جزئیات پکیج</MudText>
 
+                    @* ── G2: توضیح خرید پکیج (Q28) ── *@
+                    <MudAlert Severity="Severity.Info" Variant="Variant.Text" Dense="true" Class="mb-3">
+                        با خرید این پکیج، سقف پاداش هفتگی، ضریب کیف‌پول جادویی و دسترسی به فیچرهای اختصاصی برای شما فعال می‌شود.
+                    </MudAlert>
+
                     @if (_selectedPackage != null)
                     {
                         <MudCard>
diff --git a/src/FrontOffice.Main/Pages/Club/Components/ActivationSection.razor b/src/FrontOffice.Main/Pages/Club/Components/ActivationSection.razor
index f25c29c..f103b89 100644
--- a/src/FrontOffice.Main/Pages/Club/Components/ActivationSection.razor
+++ b/src/FrontOffice.Main/Pages/Club/Components/ActivationSection.razor
@@ -3,7 +3,12 @@
 
 <MudPaper Elevation="2" Class="pa-4 rounded-lg">
     <MudText Typo="Typo.h6" Class="mb-3">فعال‌سازی یا تمدید عضویت</MudText>
-    
+
+    @* ── G7: راهنمای هزینه فعال‌سازی (Q28) ── *@
+    <MudAlert Severity="Severity.Info" Variant="Variant.Text" Dense="true" Class="mb-3" Icon="@Icons.Material.Filled.Info">
+        هزینه تخمینی بر اساس پکیج انتخابی محاسبه می‌شود. هر پکیج قیمت و شرایط فعال‌سازی متفاوتی دارد.
+    </MudAlert>
+
     <MudForm @ref="_form" @bind-IsValid="_formIsValid">
         <MudGrid Spacing="2">
             <MudItem xs="12" sm="6">
diff --git a/src/FrontOffice.Main/Pages/Club/MembershipPage.razor b/src/FrontOffice.Main/Pages/Club/MembershipPage.razor
index f551432..7cc4835 100644
--- a/src/FrontOffice.Main/Pages/Club/MembershipPage.razor
+++ b/src/FrontOffice.Main/Pages/Club/MembershipPage.razor
@@ -9,6 +9,11 @@
     <MudStack Spacing="3">
         <PageHeader Title="عضویت باشگاه مشتریان" BackHref="@RouteConstants.Profile.Index" />
 
+        @* ── G6: راهنمای قرارداد باشگاه (Q28) ── *@
+        <MudAlert Severity="Severity.Info" Variant="Variant.Text" Dense="true" Icon="@Icons.Material.Filled.Gavel">
+            قرارداد باشگاه مشتریان فقط یک‌بار امضا می‌شود و با هر بار خرید پکیج جدید نیازی به امضای مجدد نیست.
+        </MudAlert>
+
         @if (_isLoading)
         {
             <LoadingState Message="در حال دریافت اطلاعات عضویت..." />
diff --git a/src/FrontOffice.Main/Pages/Commission/CommissionDashboardPage.razor b/src/FrontOffice.Main/Pages/Commission/CommissionDashboardPage.razor
index 555fc50..a590a8f 100644
--- a/src/FrontOffice.Main/Pages/Commission/CommissionDashboardPage.razor
+++ b/src/FrontOffice.Main/Pages/Commission/CommissionDashboardPage.razor
@@ -10,6 +10,11 @@
     <MudStack Spacing="3">
         <PageHeader Title="پاداش‌های من" BackHref="@RouteConstants.Profile.Index" />
 
+        @* ── G5: توضیح محاسبه پاداش (Q28) ── *@
+        <MudAlert Severity="Severity.Info" Variant="Variant.Text" Dense="true" Icon="@Icons.Material.Filled.Info">
+            پاداش هفتگی بر اساس هر پکیج جداگانه محاسبه می‌شود. هر پکیج Pool پورسانت مستقل دارد و Carryover بر اساس پکیج زیرمجموعه‌هاست.
+        </MudAlert>
+
         <!-- فیلترها -->
         <MudPaper Elevation="2" Class="pa-3 rounded-lg">
             <MudGrid Spacing="2">
diff --git a/src/FrontOffice.Main/Pages/Package/MyPackages.razor b/src/FrontOffice.Main/Pages/Package/MyPackages.razor
index 8aba2d6..cefeb60 100644
--- a/src/FrontOffice.Main/Pages/Package/MyPackages.razor
+++ b/src/FrontOffice.Main/Pages/Package/MyPackages.razor
@@ -34,6 +34,11 @@
     }
     else
     {
+        @* ── G3: راهنمای پکیج‌های من (Q28) ── *@
+        <MudAlert Severity="Severity.Info" Variant="Variant.Text" Dense="true" Class="mb-2" Icon="@Icons.Material.Filled.Info">
+            بعد از تکمیل چرخه کیف‌پول جادویی، می‌توانید مجدداً پکیج خریداری کرده و دور جدیدی را آغاز کنید.
+        </MudAlert>
+
         <MudGrid Spacing="4">
 
             @* Re-Purchase / Cycle Progress Section *@
diff --git a/src/FrontOffice.Main/Pages/Package/Packages.razor b/src/FrontOffice.Main/Pages/Package/Packages.razor
index 5b5aee0..3f769b6 100644
--- a/src/FrontOffice.Main/Pages/Package/Packages.razor
+++ b/src/FrontOffice.Main/Pages/Package/Packages.razor
@@ -5,6 +5,11 @@
 <MudContainer MaxWidth="MaxWidth.Large" Class="py-8">
     <PageHeader Title="پکیج‌های سرمایه‌گذاری" BackHref="@RouteConstants.Profile.Index" />
 
+    @* ── G1: راهنمای سیستم پکیج‌بیس (Q28) ── *@
+    <MudAlert Severity="Severity.Info" Variant="Variant.Text" Dense="true" Class="mb-4" Icon="@Icons.Material.Filled.Info">
+        هر پکیج ویژگی‌ها و مزایای منحصربه‌فردی دارد. با انتخاب پکیج مناسب، از سقف پاداش و ضریب کیف‌پول جادویی متفاوتی بهره‌مند می‌شوید.
+    </MudAlert>
+
     @if (_isLoading)
     {
         <MudStack AlignItems="AlignItems.Center" Class="py-16">
diff --git a/src/FrontOffice.Main/Pages/Profile/MagicWallet.razor b/src/FrontOffice.Main/Pages/Profile/MagicWallet.razor
index 1400932..5bc59b7 100644
--- a/src/FrontOffice.Main/Pages/Profile/MagicWallet.razor
+++ b/src/FrontOffice.Main/Pages/Profile/MagicWallet.razor
@@ -36,6 +36,11 @@
         {
             @* ═══ حالت جادویی فعال ═══ *@
 
+            @* ── G4: هشدار تنظیمات پکیج‌بیس (Q28) ── *@
+            <MudAlert Severity="Severity.Warning" Variant="Variant.Text" Dense="true" Icon="@Icons.Material.Filled.Warning">
+                سقف واریز و ضریب اعتبار کیف‌پول جادویی بر اساس پکیج شما تنظیم شده است. پکیج‌های بالاتر سقف و ضریب بیشتری دارند.
+            </MudAlert>
+
             @* ─── وضعیت و پیشرفت ─── *@
             <MudPaper Elevation="2" Class="pa-5 rounded-xl" Style="background: linear-gradient(135deg, #7c3aed 0%, #a855f7 100%); color: white;">
                 <MudStack Spacing="2">