feat(club): update club reports and navigation with new customer package insights

- Updated ReportLabels.cs to refine purchase method labels for clarity. - Enhanced ClubHub.razor by adding a new tab for customer package reports and adjusting tab indices. - Modified ClubPackagePurchasesReport.razor to reflect updated purchase method options. - Updated NavMenu.razor to include a link to the new customer packages report. - Bumped Foursat.CMSMicroservice.Protobuf version to 0.0.208 for compatibility with recent changes.
feat(export): enhance CSV and Excel export functionality across multiple pages
2026-08-08 21:59:30 +03:30 · 2026-08-08 21:43:54 +03:30
13 changed files with 598 additions and 90 deletions
@@ -1,3 +1,4 @@
 # Docs moved to totalDoc

 See [totalDoc/INDEX.md](../../totalDoc/INDEX.md) for all documentation.
+ 
@@ -143,7 +143,7 @@
        <ProjectReference Include="../../../CMS/src/CMSMicroservice.Protobuf/CMSMicroservice.Protobuf.csproj" />
    </ItemGroup>
    <ItemGroup Condition="!Exists('../../../CMS/src/CMSMicroservice.Protobuf/CMSMicroservice.Protobuf.csproj')">
-        <PackageReference Include="Foursat.CMSMicroservice.Protobuf" Version="0.0.207" />
+        <PackageReference Include="Foursat.CMSMicroservice.Protobuf" Version="0.0.208" />
    </ItemGroup>
    
    <!-- ============================================================ -->
@@ -1,31 +1,35 @@
 using System.Globalization;
+using System.Net;
 using System.Text;

 namespace BackOffice.Common.Utilities;

 /// <summary>
-/// خروجی CSV سازگار با Excel (UTF-8 BOM + sep=, + اعداد بدون جداکننده هزارگان).
+/// خروجی سازگار با Excel فارسی:
+/// - XML Spreadsheet (.xls) برای ستون‌بندی مطمئن + متن فارسی
+/// - CSV با جداکننده ; به‌عنوان جایگزین سبک
 /// </summary>
 public static class CsvExportHelper
 {
-    public const char Separator = ',';
+    /// <summary>جداکننده پیش‌فرض ویندوز فارسی برای CSV.</summary>
+    public const char Separator = ';';

    public static string Escape(string? value)
    {
        if (string.IsNullOrEmpty(value))
            return string.Empty;

-        if (value.Contains(Separator) || value.Contains('"') || value.Contains('\n') || value.Contains('\r'))
-            return $"\"{value.Replace("\"", "\"\"")}\"";
-
-        return value;
+        // همیشه quote تا Excel فارسی ستون را نشکند
+        return $"\"{value.Replace("\"", "\"\"")}\"";
    }

    public static string Cell(object? value) => value switch
    {
-        null => string.Empty,
+        null => Escape(string.Empty),
        string s => Escape(s),
        bool b => b ? "1" : "0",
+        byte or sbyte or short or ushort or int or uint or long or ulong or float or double or decimal
+            => Convert.ToString(value, CultureInfo.InvariantCulture) ?? "0",
        IFormattable f => Escape(f.ToString(null, CultureInfo.InvariantCulture) ?? string.Empty),
        _ => Escape(Convert.ToString(value, CultureInfo.InvariantCulture))
    };
@@ -47,11 +51,95 @@ public static class CsvExportHelper
        return "—";
    }

-    public static string ToBase64(StringBuilder bodyWithoutSepHint)
+    public static string ToBase64(StringBuilder body)
    {
-        // Excel در لوکال فارسی با این خط، جداکننده کاما را درست تشخیص می‌دهد
-        var content = "sep=," + Environment.NewLine + bodyWithoutSepHint;
-        var bytes = Encoding.UTF8.GetPreamble().Concat(Encoding.UTF8.GetBytes(content)).ToArray();
+        // CRLF صریح — Excel روی ویندوز با \n لینوکس گاهی به‌هم می‌ریزد
+        var text = body.ToString().Replace("\r\n", "\n").Replace("\r", "\n").Replace("\n", "\r\n");
+        var bytes = Encoding.UTF8.GetPreamble().Concat(Encoding.UTF8.GetBytes(text)).ToArray();
        return Convert.ToBase64String(bytes);
    }
+
+    /// <summary>
+    /// خروجی SpreadsheetML که Excel به‌صورت ستون‌ستون و با UTF-8 درست باز می‌کند.
+    /// فایل را با پسوند .xls ذخیره کنید.
+    /// </summary>
+    public static string ToExcelXmlBase64(string sheetName, IReadOnlyList<string> headers, IEnumerable<object?[]> rows)
+    {
+        var sb = new StringBuilder();
+        sb.AppendLine(@"<?xml version=""1.0"" encoding=""UTF-8""?>");
+        sb.AppendLine(@"<?mso-application progid=""Excel.Sheet""?>");
+        sb.AppendLine(@"<Workbook xmlns=""urn:schemas-microsoft-com:office:spreadsheet""");
+        sb.AppendLine(@" xmlns:o=""urn:schemas-microsoft-com:office:office""");
+        sb.AppendLine(@" xmlns:x=""urn:schemas-microsoft-com:office:excel""");
+        sb.AppendLine(@" xmlns:ss=""urn:schemas-microsoft-com:office:spreadsheet""");
+        sb.AppendLine(@" xmlns:html=""http://www.w3.org/TR/REC-html40"">");
+        sb.AppendLine(@"<Styles>");
+        sb.AppendLine(@"<Style ss:ID=""Header""><Font ss:Bold=""1""/></Style>");
+        sb.AppendLine(@"<Style ss:ID=""Text""><NumberFormat ss:Format=""@""/></Style>");
+        sb.AppendLine(@"</Styles>");
+        sb.Append("<Worksheet ss:Name=\"").Append(XmlEscape(sheetName)).AppendLine("\">");
+        sb.AppendLine("<Table>");
+
+        sb.AppendLine("<Row>");
+        foreach (var header in headers)
+        {
+            sb.Append("<Cell ss:StyleID=\"Header\"><Data ss:Type=\"String\">")
+              .Append(XmlEscape(header))
+              .AppendLine("</Data></Cell>");
+        }
+        sb.AppendLine("</Row>");
+
+        foreach (var row in rows)
+        {
+            sb.AppendLine("<Row>");
+            foreach (var cell in row)
+                AppendExcelCell(sb, cell);
+            sb.AppendLine("</Row>");
+        }
+
+        sb.AppendLine("</Table>");
+        sb.AppendLine("</Worksheet>");
+        sb.AppendLine("</Workbook>");
+
+        var bytes = Encoding.UTF8.GetPreamble().Concat(Encoding.UTF8.GetBytes(sb.ToString())).ToArray();
+        return Convert.ToBase64String(bytes);
+    }
+
+    private static void AppendExcelCell(StringBuilder sb, object? value)
+    {
+        switch (value)
+        {
+            case null:
+                sb.AppendLine(@"<Cell ss:StyleID=""Text""><Data ss:Type=""String""></Data></Cell>");
+                break;
+            case string s:
+                sb.Append(@"<Cell ss:StyleID=""Text""><Data ss:Type=""String"">")
+                  .Append(XmlEscape(s))
+                  .AppendLine("</Data></Cell>");
+                break;
+            case bool b:
+                sb.Append(@"<Cell><Data ss:Type=""Boolean"">")
+                  .Append(b ? "1" : "0")
+                  .AppendLine("</Data></Cell>");
+                break;
+            case byte or sbyte or short or ushort or int or uint or long or ulong:
+                sb.Append(@"<Cell><Data ss:Type=""Number"">")
+                  .Append(Convert.ToString(value, CultureInfo.InvariantCulture))
+                  .AppendLine("</Data></Cell>");
+                break;
+            case float or double or decimal:
+                sb.Append(@"<Cell><Data ss:Type=""Number"">")
+                  .Append(Convert.ToString(value, CultureInfo.InvariantCulture))
+                  .AppendLine("</Data></Cell>");
+                break;
+            default:
+                sb.Append(@"<Cell ss:StyleID=""Text""><Data ss:Type=""String"">")
+                  .Append(XmlEscape(Convert.ToString(value, CultureInfo.InvariantCulture)))
+                  .AppendLine("</Data></Cell>");
+                break;
+        }
+    }
+
+    private static string XmlEscape(string? value) =>
+        WebUtility.HtmlEncode(value ?? string.Empty);
 }
@@ -42,8 +42,9 @@ public static class ReportLabels

    public static string GetPurchaseMethodLabel(int method) => method switch
    {
-        1 => "وام دایا",
-        2 => "خرید مستقیم",
+        1 => "دایا",
+        2 => "درگاه",
+        3 => "دستی",
        _ => "نامشخص"
    };

@@ -1,6 +1,7 @@
@page "/club"
@page "/club/members"
@page "/club/purchases"
+@page "/club/customer-packages"
@page "/club/cycles"
@page "/club/history"
@page "/club/statistics"
@@ -18,6 +19,9 @@
        <MudTabPanel Text="گزارش خرید پکیج" Icon="@Icons.Material.Filled.ShoppingBag">
            <ClubPackagePurchasesReport />
        </MudTabPanel>
+        <MudTabPanel Text="گزارش مشتریان پکیج" Icon="@Icons.Material.Filled.PeopleAlt">
+            <CustomerPackagePurchasesReport />
+        </MudTabPanel>
        <MudTabPanel Text="گزارش دوره‌ها" Icon="@Icons.Material.Filled.Loop">
            <ClubCyclesReport />
        </MudTabPanel>
@@ -39,9 +43,10 @@
        _activeTab = uri switch
        {
            "club/purchases" => 1,
-            "club/cycles" => 2,
-            "club/history" => 3,
-            "club/statistics" => 4,
+            "club/customer-packages" => 2,
+            "club/cycles" => 3,
+            "club/history" => 4,
+            "club/statistics" => 5,
            _ => 0
        };
    }
@@ -17,8 +17,9 @@
        <MudItem xs="12" sm="6" md="3">
            <MudSelect T="int?" Clearable="true" Label="روش خرید" Variant="Variant.Outlined"
                       Margin="Margin.Dense" @bind-Value="_purchaseMethod">
-                <MudSelectItem T="int?" Value="1">وام دایا</MudSelectItem>
-                <MudSelectItem T="int?" Value="2">خرید مستقیم</MudSelectItem>
+                <MudSelectItem T="int?" Value="1">دایا</MudSelectItem>
+                <MudSelectItem T="int?" Value="3">دستی</MudSelectItem>
+                <MudSelectItem T="int?" Value="2">درگاه</MudSelectItem>
            </MudSelect>
        </MudItem>
        <MudItem xs="12" sm="6" md="4">
@@ -0,0 +1,105 @@
+@using CMSMicroservice.Protobuf.Protos.UserPackagePurchase
+@using Google.Protobuf.WellKnownTypes
+@using DateTimeConverterCL
+
+@inject UserPackagePurchaseContract.UserPackagePurchaseContractClient PurchaseClient
+
+<MudDialog>
+    <TitleContent>
+        <MudText Typo="Typo.h6">
+            جزئیات خرید پکیج — @UserName
+        </MudText>
+    </TitleContent>
+    <DialogContent>
+        @if (_loading)
+        {
+            <MudProgressLinear Indeterminate="true" Color="Color.Primary" Class="my-4" />
+        }
+        else if (_items.Count == 0)
+        {
+            <MudAlert Severity="Severity.Info" Dense="true">خریدی برای این کاربر یافت نشد.</MudAlert>
+        }
+        else
+        {
+            <MudTable Items="_items" Dense="true" Hover="true" Breakpoint="Breakpoint.Sm">
+                <HeaderContent>
+                    <MudTh>شناسه</MudTh>
+                    <MudTh>پکیج</MudTh>
+                    <MudTh>روش</MudTh>
+                    <MudTh>مبلغ (ریال)</MudTh>
+                    <MudTh>تاریخ خرید</MudTh>
+                </HeaderContent>
+                <RowTemplate>
+                    <MudTd DataLabel="شناسه">@context.Id</MudTd>
+                    <MudTd DataLabel="پکیج">@context.PackageName</MudTd>
+                    <MudTd DataLabel="روش">
+                        <MudChip T="string" Size="Size.Small" Variant="Variant.Outlined"
+                                 Color="@GetMethodColor(context.PurchaseMethod)">
+                            @ReportLabels.GetPurchaseMethodLabel(context.PurchaseMethod)
+                        </MudChip>
+                    </MudTd>
+                    <MudTd DataLabel="مبلغ">@context.Amount.ToString("N0")</MudTd>
+                    <MudTd DataLabel="تاریخ">
+                        @(context.PurchasedAt != null
+                            ? context.PurchasedAt.ToDateTime().ToLocalTime().MiladiToJalaliWithTime()
+                            : "-")
+                    </MudTd>
+                </RowTemplate>
+            </MudTable>
+        }
+    </DialogContent>
+    <DialogActions>
+        <MudButton OnClick="Close" Variant="Variant.Text">بستن</MudButton>
+    </DialogActions>
+</MudDialog>
+
+@code {
+    [CascadingParameter] IMudDialogInstance MudDialog { get; set; } = null!;
+    [Parameter] public long UserId { get; set; }
+    [Parameter] public string UserName { get; set; } = string.Empty;
+
+    private bool _loading = true;
+    private List<UserPackagePurchaseModel> _items = new();
+
+    protected override async Task OnInitializedAsync()
+    {
+        try
+        {
+            var result = await PurchaseClient.GetAllUserPackagePurchaseByFilterAsync(
+                new GetAllUserPackagePurchaseByFilterRequest
+                {
+                    PaginationState = new CMSMicroservice.Protobuf.Protos.PaginationState
+                    {
+                        PageNumber = 1,
+                        PageSize = 500
+                    },
+                    Filter = new GetAllUserPackagePurchaseByFilterFilter
+                    {
+                        UserId = UserId
+                    }
+                });
+
+            _items = result?.Models?
+                .OrderBy(x => x.PurchasedAt?.ToDateTime() ?? DateTime.MinValue)
+                .ToList() ?? new();
+        }
+        catch (Exception ex)
+        {
+            Snackbar.Add($"خطا در بارگذاری جزئیات: {ex.Message}", Severity.Error);
+        }
+        finally
+        {
+            _loading = false;
+        }
+    }
+
+    private static Color GetMethodColor(int method) => method switch
+    {
+        1 => Color.Info,      // دایا
+        2 => Color.Primary,   // درگاه
+        3 => Color.Secondary, // دستی
+        _ => Color.Default
+    };
+
+    private void Close() => MudDialog.Close();
+}
@@ -0,0 +1,294 @@
+@using System.Text
+@using BackOffice.Common.BaseComponents
+@using BackOffice.Common.Utilities
+@using BackOffice.Pages.AutoComplete
+@using BackOffice.Pages.Club.Reports.Components
+@using CMSMicroservice.Protobuf.Protos.UserPackagePurchase
+@using Google.Protobuf.WellKnownTypes
+@using DateTimeConverterCL
+@using Microsoft.JSInterop
+
+@inject UserPackagePurchaseContract.UserPackagePurchaseContractClient PurchaseClient
+@inject IDialogService DialogService
+@inject IJSRuntime JsRuntime
+
+<MudAlert Severity="Severity.Info" Variant="Variant.Text" Dense="true" Class="mb-3">
+    گزارش تجمیعی مشتریان — اولین/آخرین پکیج، تفکیک دایا / دستی / درگاه. خروجی Excel مطابق فیلتر فعال است.
+</MudAlert>
+
+<BasePageComponent @ref="_basePage" OnSubmitClick="OnFilterSubmit" OnClearFilterClick="OnFilterCleared">
+    <Filters>
+        <MudItem xs="12" sm="6" md="3">
+            <UserAutoComplete Label="کاربر" @bind-SelectedUserId="_userId" />
+        </MudItem>
+        <MudItem xs="12" sm="6" md="3">
+            <MudSelect T="int?" Clearable="true" Label="روش خرید" Variant="Variant.Outlined"
+                       Margin="Margin.Dense" @bind-Value="_purchaseMethod">
+                <MudSelectItem T="int?" Value="1">دایا</MudSelectItem>
+                <MudSelectItem T="int?" Value="3">دستی</MudSelectItem>
+                <MudSelectItem T="int?" Value="2">درگاه</MudSelectItem>
+            </MudSelect>
+        </MudItem>
+        <MudItem xs="12" sm="6" md="4">
+            <DateRangePicker @bind-From="_fromDate" @bind-To="_toDate" Label="بازه خرید" />
+        </MudItem>
+    </Filters>
+    <Content>
+        <MudStack Row="true" Justify="Justify.FlexEnd" Class="mb-3">
+            <MudButton Variant="Variant.Outlined" Color="Color.Success"
+                       StartIcon="@Icons.Material.Filled.FileDownload"
+                       OnClick="ExportToExcel" Disabled="_exporting">
+                خروجی Excel
+            </MudButton>
+        </MudStack>
+
+        <MudDataGrid @ref="_grid" T="CustomerPackagePurchaseRollupModel" ServerData="LoadData" ReadOnly="true"
+                     Hover="true" Dense="true" Height="calc(100vh - 420px)">
+            <Columns>
+                <TemplateColumn Title="مشتری">
+                    <CellTemplate>
+                        <MudStack Spacing="0">
+                            <MudText Typo="Typo.body2">@context.Item.UserName</MudText>
+                            <MudText Typo="Typo.caption" Color="Color.Secondary">@context.Item.UserMobile</MudText>
+                        </MudStack>
+                    </CellTemplate>
+                </TemplateColumn>
+                <TemplateColumn Title="اولین پکیج">
+                    <CellTemplate>
+                        <MudStack Spacing="0">
+                            <MudText Typo="Typo.body2">@context.Item.FirstPackageName</MudText>
+                            <MudText Typo="Typo.caption">@context.Item.FirstAmount.ToString("N0") ریال</MudText>
+                            <MudText Typo="Typo.caption" Color="Color.Secondary">
+                                @(context.Item.FirstPurchasedAt?.ToDateTime().ToLocalTime().MiladiToJalaliWithTime() ?? "-")
+                            </MudText>
+                        </MudStack>
+                    </CellTemplate>
+                </TemplateColumn>
+                <TemplateColumn Title="آخرین پکیج">
+                    <CellTemplate>
+                        <MudStack Spacing="0">
+                            <MudText Typo="Typo.body2">@context.Item.LastPackageName</MudText>
+                            <MudText Typo="Typo.caption">@context.Item.LastAmount.ToString("N0") ریال</MudText>
+                            <MudText Typo="Typo.caption" Color="Color.Secondary">
+                                @(context.Item.LastPurchasedAt?.ToDateTime().ToLocalTime().MiladiToJalaliWithTime() ?? "-")
+                            </MudText>
+                            <MudChip T="string" Size="Size.Small" Class="mt-1" Variant="Variant.Filled"
+                                     Color="@GetMethodColor(context.Item.LastPurchaseMethod)">
+                                @ReportLabels.GetPurchaseMethodLabel(context.Item.LastPurchaseMethod)
+                            </MudChip>
+                        </MudStack>
+                    </CellTemplate>
+                </TemplateColumn>
+                <TemplateColumn Title="تعداد / جمع">
+                    <CellTemplate>
+                        <MudStack Spacing="0">
+                            <MudText>@context.Item.PurchaseCount خرید</MudText>
+                            <MudText Typo="Typo.caption">@context.Item.TotalAmount.ToString("N0") ریال</MudText>
+                        </MudStack>
+                    </CellTemplate>
+                </TemplateColumn>
+                <TemplateColumn Title="دایا">
+                    <CellTemplate>
+                        <MudText Typo="Typo.caption">@context.Item.DayaCount عدد</MudText>
+                        <MudText Typo="Typo.caption">@context.Item.DayaAmount.ToString("N0")</MudText>
+                    </CellTemplate>
+                </TemplateColumn>
+                <TemplateColumn Title="دستی">
+                    <CellTemplate>
+                        <MudText Typo="Typo.caption">@context.Item.ManualCount عدد</MudText>
+                        <MudText Typo="Typo.caption">@context.Item.ManualAmount.ToString("N0")</MudText>
+                    </CellTemplate>
+                </TemplateColumn>
+                <TemplateColumn Title="درگاه">
+                    <CellTemplate>
+                        <MudText Typo="Typo.caption">@context.Item.GatewayCount عدد</MudText>
+                        <MudText Typo="Typo.caption">@context.Item.GatewayAmount.ToString("N0")</MudText>
+                    </CellTemplate>
+                </TemplateColumn>
+                <TemplateColumn Title="عملیات">
+                    <CellTemplate>
+                        <MudButton Size="Size.Small" Variant="Variant.Outlined" Color="Color.Primary"
+                                   OnClick="() => OpenDetails(context.Item)">
+                            جزئیات
+                        </MudButton>
+                    </CellTemplate>
+                </TemplateColumn>
+            </Columns>
+            <NoRecordsContent>
+                <MudAlert Severity="Severity.Info" Dense="true" Variant="Variant.Text" Class="my-4">موردی یافت نشد.</MudAlert>
+            </NoRecordsContent>
+            <PagerContent>
+                <MudDataGridPager T="CustomerPackagePurchaseRollupModel" PageSizeOptions="@(new int[] { 20, 50, 100 })"
+                                  InfoFormat="سطر {first_item} تا {last_item} از {all_items}"
+                                  RowsPerPageString="تعداد در صفحه" />
+            </PagerContent>
+        </MudDataGrid>
+    </Content>
+</BasePageComponent>
+
+@code {
+    private BasePageComponent? _basePage;
+    private MudDataGrid<CustomerPackagePurchaseRollupModel>? _grid;
+    private long? _userId;
+    private int? _purchaseMethod;
+    private DateTime? _fromDate, _toDate;
+    private bool _exporting;
+
+    private GetCustomerPackagePurchaseRollupFilter BuildFilter()
+    {
+        var filter = new GetCustomerPackagePurchaseRollupFilter();
+        if (_userId is > 0)
+            filter.UserId = _userId;
+        if (_purchaseMethod.HasValue)
+            filter.PurchaseMethod = _purchaseMethod.Value;
+        if (_fromDate.HasValue)
+            filter.PurchasedFrom = Timestamp.FromDateTime(DateTime.SpecifyKind(_fromDate.Value.Date, DateTimeKind.Utc));
+        if (_toDate.HasValue)
+            filter.PurchasedTo = Timestamp.FromDateTime(DateTime.SpecifyKind(_toDate.Value.Date.AddDays(1).AddTicks(-1), DateTimeKind.Utc));
+        return filter;
+    }
+
+    private async Task<GridData<CustomerPackagePurchaseRollupModel>> LoadData(GridState<CustomerPackagePurchaseRollupModel> state)
+    {
+        try
+        {
+            var result = await PurchaseClient.GetCustomerPackagePurchaseRollupAsync(
+                new GetCustomerPackagePurchaseRollupRequest
+                {
+                    PaginationState = new CMSMicroservice.Protobuf.Protos.PaginationState
+                    {
+                        PageNumber = state.Page + 1,
+                        PageSize = state.PageSize
+                    },
+                    Filter = BuildFilter()
+                });
+
+            return new GridData<CustomerPackagePurchaseRollupModel>
+            {
+                Items = result?.Models?.ToList() ?? new(),
+                TotalItems = (int)(result?.MetaData?.TotalCount ?? 0)
+            };
+        }
+        catch (Exception ex)
+        {
+            Snackbar.Add($"خطا: {ex.Message}", Severity.Error);
+            return new GridData<CustomerPackagePurchaseRollupModel>();
+        }
+    }
+
+    private async Task OnFilterSubmit()
+    {
+        if (_grid != null) await _grid.ReloadServerData();
+    }
+
+    private async Task OnFilterCleared()
+    {
+        _userId = null;
+        _purchaseMethod = null;
+        _fromDate = _toDate = null;
+        if (_grid != null) await _grid.ReloadServerData();
+    }
+
+    private async Task OpenDetails(CustomerPackagePurchaseRollupModel row)
+    {
+        var parameters = new DialogParameters
+        {
+            { nameof(CustomerPackagePurchaseDetailsDialog.UserId), row.UserId },
+            { nameof(CustomerPackagePurchaseDetailsDialog.UserName), row.UserName }
+        };
+        var options = new DialogOptions { MaxWidth = MaxWidth.Medium, FullWidth = true, CloseButton = true };
+        await DialogService.ShowAsync<CustomerPackagePurchaseDetailsDialog>("جزئیات خرید پکیج", parameters, options);
+    }
+
+    private async Task ExportToExcel()
+    {
+        _exporting = true;
+        try
+        {
+            var filter = BuildFilter();
+            var all = new List<CustomerPackagePurchaseRollupModel>();
+            const int pageSize = 500;
+            var page = 1;
+            long totalCount;
+
+            do
+            {
+                var result = await PurchaseClient.GetCustomerPackagePurchaseRollupAsync(
+                    new GetCustomerPackagePurchaseRollupRequest
+                    {
+                        PaginationState = new CMSMicroservice.Protobuf.Protos.PaginationState
+                        {
+                            PageNumber = page,
+                            PageSize = pageSize
+                        },
+                        Filter = filter
+                    });
+
+                var batch = result?.Models?.ToList() ?? new();
+                all.AddRange(batch);
+                totalCount = result?.MetaData?.TotalCount ?? 0;
+                page++;
+            } while (all.Count < totalCount && page <= 50);
+
+            if (all.Count == 0)
+            {
+                Snackbar.Add("داده‌ای برای خروجی با فیلتر فعلی وجود ندارد.", Severity.Info);
+                return;
+            }
+
+            var headers = new[]
+            {
+                "شناسه کاربر", "نام مشتری", "موبایل",
+                "اولین پکیج", "مبلغ اولین", "تاریخ اولین",
+                "آخرین پکیج", "مبلغ آخرین", "تاریخ آخرین", "روش آخرین",
+                "تعداد خرید", "جمع مبلغ",
+                "تعداد دایا", "مبلغ دایا",
+                "تعداد دستی", "مبلغ دستی",
+                "تعداد درگاه", "مبلغ درگاه"
+            };
+
+            var rows = all.Select(o => new object?[]
+            {
+                o.UserId,
+                o.UserName,
+                o.UserMobile,
+                o.FirstPackageName,
+                o.FirstAmount,
+                o.FirstPurchasedAt?.ToDateTime().ToLocalTime().MiladiToJalaliWithTime() ?? "-",
+                o.LastPackageName,
+                o.LastAmount,
+                o.LastPurchasedAt?.ToDateTime().ToLocalTime().MiladiToJalaliWithTime() ?? "-",
+                ReportLabels.GetPurchaseMethodLabel(o.LastPurchaseMethod),
+                o.PurchaseCount,
+                o.TotalAmount,
+                o.DayaCount,
+                o.DayaAmount,
+                o.ManualCount,
+                o.ManualAmount,
+                o.GatewayCount,
+                o.GatewayAmount
+            });
+
+            var filename = $"customer-packages-{DateTime.Now:yyyyMMddHHmmss}.xls";
+            await JsRuntime.InvokeVoidAsync("jsSaveAsFile", filename,
+                CsvExportHelper.ToExcelXmlBase64("مشتریان پکیج", headers, rows));
+            Snackbar.Add($"خروجی Excel آماده شد ({all.Count} مشتری).", Severity.Success);
+        }
+        catch (Exception ex)
+        {
+            Snackbar.Add($"خطا در خروجی Excel: {ex.Message}", Severity.Error);
+        }
+        finally
+        {
+            _exporting = false;
+        }
+    }
+
+    private static Color GetMethodColor(int method) => method switch
+    {
+        1 => Color.Info,
+        2 => Color.Primary,
+        3 => Color.Secondary,
+        _ => Color.Default
+    };
+}
@@ -245,31 +245,32 @@ public partial class DiscountOrdersMainPage

        try
        {
-            var sb = new StringBuilder();
-            sb.AppendLine(CsvExportHelper.Row(
-                "شناسه", "نام مشتری", "موبایل", "مبلغ کل", "کیف پول اعتباری", "پرداخت درگاه",
-                "تعداد آیتم", "وضعیت پرداخت", "وضعیت ارسال", "تاریخ پرداخت", "تاریخ ثبت", "آدرس"));
-
-            foreach (var o in _orders)
+            var headers = new[]
            {
-                sb.AppendLine(CsvExportHelper.Row(
-                    o.Id,
-                    CsvExportHelper.CustomerName(o.UserFullName, o.UserMobile, o.UserId),
-                    o.UserMobile,
-                    o.TotalPrice,
-                    o.DiscountBalanceUsed,
-                    o.GatewayAmount,
-                    o.ItemsCount,
-                    GetPaymentStatusText(o.PaymentStatusValue),
-                    GetStatusText(o.Status),
-                    o.PaymentDate?.MiladiToJalaliWithTime() ?? "-",
-                    o.Created?.MiladiToJalaliWithTime() ?? "-",
-                    o.ShippingAddress ?? "-"));
-            }
+                "شناسه", "نام مشتری", "موبایل", "مبلغ کل", "کیف پول اعتباری", "پرداخت درگاه",
+                "تعداد آیتم", "وضعیت پرداخت", "وضعیت ارسال", "تاریخ پرداخت", "تاریخ ثبت", "آدرس"
+            };

-            var filename = $"discount-orders-{DateTime.Now:yyyyMMddHHmmss}.csv";
-            await JsRuntime.InvokeVoidAsync("jsSaveAsFile", filename, CsvExportHelper.ToBase64(sb));
-            Snackbar.Add("خروجی Excel (CSV) آماده شد.", Severity.Success);
+            var rows = _orders.Select(o => new object?[]
+            {
+                o.Id,
+                CsvExportHelper.CustomerName(o.UserFullName, o.UserMobile, o.UserId),
+                o.UserMobile ?? "",
+                o.TotalPrice,
+                o.DiscountBalanceUsed,
+                o.GatewayAmount,
+                o.ItemsCount,
+                GetPaymentStatusText(o.PaymentStatusValue),
+                GetStatusText(o.Status),
+                o.PaymentDate?.MiladiToJalaliWithTime() ?? "-",
+                o.Created?.MiladiToJalaliWithTime() ?? "-",
+                o.ShippingAddress ?? "-"
+            });
+
+            var filename = $"discount-orders-{DateTime.Now:yyyyMMddHHmmss}.xls";
+            await JsRuntime.InvokeVoidAsync("jsSaveAsFile", filename,
+                CsvExportHelper.ToExcelXmlBase64("سفارش‌های اعتباری", headers, rows));
+            Snackbar.Add("خروجی Excel آماده شد.", Severity.Success);
        }
        catch (Exception ex)
        {
@@ -530,26 +530,31 @@
            return;
        }

-        var sb = new StringBuilder();
-        sb.AppendLine(CsvExportHelper.Row(
-            "شناسه", "نام مشتری", "موبایل", "تاریخ ثبت", "تعداد آیتم", "مبلغ نهایی", "تخفیف", "وضعیت"));
-
-        foreach (var o in _orders.Where(o => o.Created.HasValue).OrderBy(o => o.Created))
+        var headers = new[]
        {
-            sb.AppendLine(CsvExportHelper.Row(
+            "شناسه", "نام مشتری", "موبایل", "تاریخ ثبت", "تعداد آیتم", "مبلغ نهایی", "تخفیف", "وضعیت"
+        };
+
+        var rows = _orders
+            .OrderBy(o => o.Created ?? o.PaymentDate ?? DateTime.MaxValue)
+            .Select(o => new object?[]
+            {
                o.Id,
                CsvExportHelper.CustomerName(o.UserFullName, o.UserMobile, o.UserId),
-                o.UserMobile,
-                o.Created?.MiladiToJalaliWithTime() ?? "-",
+                o.UserMobile ?? "",
+                o.Created?.MiladiToJalaliWithTime()
+                    ?? o.PaymentDate?.MiladiToJalaliWithTime()
+                    ?? "-",
                o.ItemsCount,
                o.GatewayAmount,
                o.DiscountBalanceUsed,
-                GetStatusText(o.Status)));
-        }
+                GetStatusText(o.Status)
+            });

-        var filename = $"discount-sales-{DateTime.Now:yyyyMMddHHmmss}.csv";
-        await JsRuntime.InvokeVoidAsync("jsSaveAsFile", filename, CsvExportHelper.ToBase64(sb));
-        Snackbar.Add("خروجی Excel (CSV) آماده شد.", Severity.Success);
+        var filename = $"discount-sales-{DateTime.Now:yyyyMMddHHmmss}.xls";
+        await JsRuntime.InvokeVoidAsync("jsSaveAsFile", filename,
+            CsvExportHelper.ToExcelXmlBase64("گزارش فروش اعتباری", headers, rows));
+        Snackbar.Add("خروجی Excel آماده شد.", Severity.Success);
    }

    private async Task ExportToPdf()
@@ -244,25 +244,26 @@ public partial class OrderSalesReports
            return;
        }

-        var sb = new StringBuilder();
-        sb.AppendLine(CsvExportHelper.Row(
-            "شناسه", "کاربر", "نام مشتری", "مبلغ", "وضعیت پرداخت", "وضعیت ارسال", "تاریخ پرداخت"));
-
-        foreach (var o in _orders)
+        var headers = new[]
        {
-            sb.AppendLine(CsvExportHelper.Row(
-                o.Id,
-                o.UserId,
-                CsvExportHelper.CustomerName(o.UserFullName, userId: o.UserId),
-                o.Amount,
-                o.PaymentStatus == PaymentStatus.Success ? "پرداخت شده" : "پرداخت نشده",
-                GetDeliveryStatusText(o.DeliveryStatus.GetHashCode()),
-                o.PaymentDate != null ? o.PaymentDate.ToDateTime().MiladiToJalaliWithTime() : "-"));
-        }
+            "شناسه", "کاربر", "نام مشتری", "مبلغ", "وضعیت پرداخت", "وضعیت ارسال", "تاریخ پرداخت"
+        };

-        var filename = $"store-sales-{DateTime.Now:yyyyMMddHHmmss}.csv";
-        await JsRuntime.InvokeVoidAsync("jsSaveAsFile", filename, CsvExportHelper.ToBase64(sb));
-        Snackbar.Add("خروجی Excel (CSV) آماده شد.", Severity.Success);
+        var rows = _orders.Select(o => new object?[]
+        {
+            o.Id,
+            o.UserId,
+            CsvExportHelper.CustomerName(o.UserFullName, userId: o.UserId),
+            o.Amount,
+            o.PaymentStatus == PaymentStatus.Success ? "پرداخت شده" : "پرداخت نشده",
+            GetDeliveryStatusText(o.DeliveryStatus.GetHashCode()),
+            o.PaymentDate != null ? o.PaymentDate.ToDateTime().MiladiToJalaliWithTime() : "-"
+        });
+
+        var filename = $"store-sales-{DateTime.Now:yyyyMMddHHmmss}.xls";
+        await JsRuntime.InvokeVoidAsync("jsSaveAsFile", filename,
+            CsvExportHelper.ToExcelXmlBase64("گزارش فروش", headers, rows));
+        Snackbar.Add("خروجی Excel آماده شد.", Severity.Success);
    }

    protected async Task ExportToPdf()
@@ -329,26 +329,27 @@ public partial class UserOrderMainPage
                return;
            }

-            var sb = new StringBuilder();
-            sb.AppendLine(CsvExportHelper.Row(
-                "شناسه", "کاربر", "نام مشتری", "مبلغ", "وضعیت پرداخت", "وضعیت ارسال", "روش پرداخت", "تاریخ پرداخت"));
-
-            foreach (var o in result.Models)
+            var headers = new[]
            {
-                sb.AppendLine(CsvExportHelper.Row(
-                    o.Id,
-                    o.UserId,
-                    CsvExportHelper.CustomerName(o.UserFullName, userId: o.UserId),
-                    o.Amount,
-                    GetPaymentStatusText(o.PaymentStatus.GetHashCode()),
-                    GetDeliveryStatusText(o.DeliveryStatus.GetHashCode()),
-                    GetPaymentMethodText(o.PaymentMethod.GetHashCode()),
-                    o.PaymentDate?.ToDateTime().ToLocalTime().MiladiToJalaliWithTime() ?? "-"));
-            }
+                "شناسه", "کاربر", "نام مشتری", "مبلغ", "وضعیت پرداخت", "وضعیت ارسال", "روش پرداخت", "تاریخ پرداخت"
+            };

-            var filename = $"user-orders-{DateTime.Now:yyyyMMddHHmmss}.csv";
-            await JsRuntime.InvokeVoidAsync("jsSaveAsFile", filename, CsvExportHelper.ToBase64(sb));
-            Snackbar.Add("خروجی Excel (CSV) آماده شد.", Severity.Success);
+            var rows = result.Models.Select(o => new object?[]
+            {
+                o.Id,
+                o.UserId,
+                CsvExportHelper.CustomerName(o.UserFullName, userId: o.UserId),
+                o.Amount,
+                GetPaymentStatusText(o.PaymentStatus.GetHashCode()),
+                GetDeliveryStatusText(o.DeliveryStatus.GetHashCode()),
+                GetPaymentMethodText(o.PaymentMethod.GetHashCode()),
+                o.PaymentDate?.ToDateTime().ToLocalTime().MiladiToJalaliWithTime() ?? "-"
+            });
+
+            var filename = $"user-orders-{DateTime.Now:yyyyMMddHHmmss}.xls";
+            await JsRuntime.InvokeVoidAsync("jsSaveAsFile", filename,
+                CsvExportHelper.ToExcelXmlBase64("سفارش‌ها", headers, rows));
+            Snackbar.Add("خروجی Excel آماده شد.", Severity.Success);
        }
        catch (Exception ex)
        {
@@ -77,6 +77,11 @@
                    Icon="@Icons.Material.Filled.Groups">
            اعضا و گزارش‌ها
        </MudNavLink>
+        <MudNavLink Match="NavLinkMatch.Prefix"
+                    Href="/club/customer-packages"
+                    Icon="@Icons.Material.Filled.PeopleAlt">
+            گزارش مشتریان پکیج
+        </MudNavLink>
        <MudNavLink Match="NavLinkMatch.Prefix"
                    Href="/club/features"
                    Icon="@Icons.Material.Filled.Star">