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

Q28: Added informational/warning alerts to 6 BO pages:
G8: PackageCRUD — price change impact warning
G9: ClubFeatures — feature matrix explanation
G10: ManualPayments — package price matching warning
G11: Commission Dashboard+Payouts — independent pool info
G13: ClubMembers — package filter guidance
---
 src/BackOffice/Pages/Club/ClubFeaturesPage.razor   | 5 +++++
 src/BackOffice/Pages/Club/ClubMembers.razor        | 5 +++++
 src/BackOffice/Pages/Commission/Dashboard.razor    | 5 +++++
 src/BackOffice/Pages/Commission/UserPayouts.razor  | 5 +++++
 src/BackOffice/Pages/Package/PackageMainPage.razor | 4 ++++
 src/BackOffice/Pages/Payment/ManualPayments.razor  | 6 ++++++
 6 files changed, 30 insertions(+)

diff --git a/src/BackOffice/Pages/Club/ClubFeaturesPage.razor b/src/BackOffice/Pages/Club/ClubFeaturesPage.razor
index 366561f..79fac50 100644
--- a/src/BackOffice/Pages/Club/ClubFeaturesPage.razor
+++ b/src/BackOffice/Pages/Club/ClubFeaturesPage.razor
@@ -11,6 +11,11 @@
 <div>
     <MudText Typo="Typo.h5" Class="mb-3">فیچرهای باشگاه</MudText>
 
+    @* ── G9: راهنمای ماتریس فیچر (Q28) ── *@
+    <MudAlert Severity="Severity.Info" Variant="Variant.Text" Dense="true" Class="mb-3" Icon="@Icons.Material.Filled.Info">
+        فیچرهای تیک‌خورده برای خریداران این پکیج فعال می‌شود. تغییر فیچرها روی کاربران فعلی بلافاصله اعمال می‌شود.
+    </MudAlert>
+
     <MudTabs Elevation="0" Rounded="true" Border="true" ApplyEffectsToContainer="true"
              PanelClass="pt-4" @bind-ActivePanelIndex="_activeTab">
 
diff --git a/src/BackOffice/Pages/Club/ClubMembers.razor b/src/BackOffice/Pages/Club/ClubMembers.razor
index f57385c..da3e8f6 100644
--- a/src/BackOffice/Pages/Club/ClubMembers.razor
+++ b/src/BackOffice/Pages/Club/ClubMembers.razor
@@ -9,6 +9,11 @@
 <div>
     <MudText Typo="Typo.h4" Class="mb-4">مدیریت اعضای باشگاه</MudText>
 
+    @* ── G13: راهنمای اعضای باشگاه (Q28) ── *@
+    <MudAlert Severity="Severity.Info" Variant="Variant.Text" Dense="true" Class="mb-3" Icon="@Icons.Material.Filled.Info">
+        فیلتر بر اساس آخرین پکیج خریداری‌شده اعمال می‌شود. هر کاربر می‌تواند چندین دوره پکیج داشته باشد.
+    </MudAlert>
+
     <MudDataGrid T="ClubMembershipModel" 
                  ServerData="@(new Func<GridState<ClubMembershipModel>, Task<GridData<ClubMembershipModel>>>(ServerReload))"
                  Hover="true" 
diff --git a/src/BackOffice/Pages/Commission/Dashboard.razor b/src/BackOffice/Pages/Commission/Dashboard.razor
index 207ed29..f1f446b 100644
--- a/src/BackOffice/Pages/Commission/Dashboard.razor
+++ b/src/BackOffice/Pages/Commission/Dashboard.razor
@@ -8,6 +8,11 @@
 <div>
     <MudText Typo="Typo.h4" Class="mb-4">داشبورد کمیسیون</MudText>
 
+    @* ── G11: راهنمای کمیسیون (Q28) ── *@
+    <MudAlert Severity="Severity.Info" Variant="Variant.Text" Dense="true" Class="mb-3" Icon="@Icons.Material.Filled.Info">
+        هر پکیج Pool پورسانت مستقل دارد. مبالغ ActivationFee به Pool پکیج مربوطه واریز می‌شود.
+    </MudAlert>
+
     @if (_isLoading)
     {
         <MudProgressCircular Color="Color.Primary" Indeterminate="true" />
diff --git a/src/BackOffice/Pages/Commission/UserPayouts.razor b/src/BackOffice/Pages/Commission/UserPayouts.razor
index bc65251..2d3349e 100644
--- a/src/BackOffice/Pages/Commission/UserPayouts.razor
+++ b/src/BackOffice/Pages/Commission/UserPayouts.razor
@@ -9,6 +9,11 @@
 <div>
     <MudText Typo="Typo.h4" Class="mb-4"> پرداخت های کاربران</MudText>
 
+    @* ── G11b: راهنمای پرداخت‌ها (Q28) ── *@
+    <MudAlert Severity="Severity.Info" Variant="Variant.Text" Dense="true" Class="mb-3" Icon="@Icons.Material.Filled.Info">
+        پاداش‌ها بر اساس هر پکیج جداگانه محاسبه می‌شود. ستون «پکیج» نشان‌دهنده پکیج منبع پاداش است.
+    </MudAlert>
+
     <MudDataGrid T="UserCommissionPayoutModel" 
                  ServerData="@(new Func<GridState<UserCommissionPayoutModel>, Task<GridData<UserCommissionPayoutModel>>>(ServerReload))"
                  Hover="true" 
diff --git a/src/BackOffice/Pages/Package/PackageMainPage.razor b/src/BackOffice/Pages/Package/PackageMainPage.razor
index f026081..c2c42f1 100644
--- a/src/BackOffice/Pages/Package/PackageMainPage.razor
+++ b/src/BackOffice/Pages/Package/PackageMainPage.razor
@@ -12,6 +12,10 @@
         </MudItem>
     </Filters>
     <Content>
+        @* ── G8: راهنمای مدیریت پکیج (Q28) ── *@
+        <MudAlert Severity="Severity.Warning" Variant="Variant.Text" Dense="true" Class="mb-3" Icon="@Icons.Material.Filled.Warning">
+            تغییر قیمت روی کاربران فعلی اثر ندارد — فقط خریدهای جدید. هر پکیج Pool پورسانت مستقل دارد.
+        </MudAlert>
         <MudDataGrid T="DataModel" ServerData="@(new Func<GridState<DataModel>, Task<GridData<DataModel>>>(ServerReload))"
                      Hover="true" @ref="_gridData" Height="calc(100vh - 240px)">
             <ColGroup>
diff --git a/src/BackOffice/Pages/Payment/ManualPayments.razor b/src/BackOffice/Pages/Payment/ManualPayments.razor
index 774d45b..67b9f75 100644
--- a/src/BackOffice/Pages/Payment/ManualPayments.razor
+++ b/src/BackOffice/Pages/Payment/ManualPayments.razor
@@ -6,6 +6,12 @@
 
 <BasePageComponent @ref="_basePage" OnSubmitClick="OnFilterSubmit" OnClearFilterClick="OnFilterCleared">
     <Filters>
+        @* ── G10: هشدار پرداخت دستی (Q28) ── *@
+        <MudItem xs="12">
+            <MudAlert Severity="Severity.Warning" Variant="Variant.Text" Dense="true" Icon="@Icons.Material.Filled.Warning">
+                مبلغ پرداخت باید مطابق قیمت پکیج انتخابی باشد. پکیج‌های مختلف قیمت متفاوتی دارند.
+            </MudAlert>
+        </MudItem>
         <MudItem xs="12" sm="6" md="3">
             <UserAutoComplete Label="جستجوی کاربر" @bind-SelectedUserId="_userIdFilter" />
         </MudItem>