From 944b7f2c80269514724b116c84db77edd78d5a65 Mon Sep 17 00:00:00 2001
From: zzh <1368735060@qq.com>
Date: Fri, 24 Jul 2026 11:25:15 +0800
Subject: [PATCH] fix: restore UTF-8 Chinese summaries for marketing swagger
 names

Replace corrupted ??? XML comments in commission/referral admin APIs so OMS-Marketing operation names render correctly.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 .../Marketing/MarketingCommissionAdminService.cs   | 14 +++++++-------
 .../Marketing/MarketingPortalReferralService.cs    |  2 +-
 .../Marketing/MarketingReferralAdminService.cs     |  8 ++++----
 3 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/src/Oms.Application/Services/Marketing/MarketingCommissionAdminService.cs b/src/Oms.Application/Services/Marketing/MarketingCommissionAdminService.cs
index 362dcb1..f10077e 100644
--- a/src/Oms.Application/Services/Marketing/MarketingCommissionAdminService.cs
+++ b/src/Oms.Application/Services/Marketing/MarketingCommissionAdminService.cs
@@ -16,7 +16,7 @@ using Oms.Domain.MarketingAggregate.Repositories;
 namespace Oms.Application.Services.Marketing;
 
 /// <summary>
-/// ????????? API??????
+/// 分成明细与提现审核 API（管理端）。
 /// </summary>
 [ApiExplorerSettings(GroupName = "OMS-Marketing")]
 public class MarketingCommissionAdminService : ApplicationService
@@ -37,7 +37,7 @@ public class MarketingCommissionAdminService : ApplicationService
         LazyServiceProvider.GetRequiredService<CommissionBalanceMutator>();
 
     /// <summary>
-    /// ?????????
+    /// 分页查询分成明细。
     /// </summary>
     [HttpPost("/marketing/commission-detail/list")]
     public async Task<OmsPageResult<CommissionDetailOutput>> GetDetailListAsync(CommissionDetailListInput input)
@@ -59,7 +59,7 @@ public class MarketingCommissionAdminService : ApplicationService
     }
 
     /// <summary>
-    /// ?????????
+    /// 人工调整佣金余额。
     /// </summary>
     [HttpPost("/marketing/commission-detail/adjust")]
     public async Task AdjustAsync(CommissionAdjustInput input)
@@ -95,7 +95,7 @@ public class MarketingCommissionAdminService : ApplicationService
     }
 
     /// <summary>
-    /// ?????????
+    /// 分页查询提现申请。
     /// </summary>
     [HttpPost("/marketing/commission-withdraw/list")]
     public async Task<OmsPageResult<CommissionWithdrawOutput>> GetWithdrawListAsync(CommissionWithdrawListInput input)
@@ -131,12 +131,12 @@ public class MarketingCommissionAdminService : ApplicationService
         }
 
         var customer = await CustomerRepository.GetByCustomerCodeAsync(code)
-                       ?? throw new BusinessException($"???? {code} ???");
+                       ?? throw new BusinessException(`"客户编号 {code} 不存在`");
         input.CustomerId = customer.ParentCustomerId ?? customer.Id;
     }
 
     /// <summary>
-    /// ?????????
+    /// 审核通过提现申请。
     /// </summary>
     [HttpPost("/marketing/commission-withdraw/approve")]
     public async Task ApproveWithdrawAsync(CommissionWithdrawApproveInput input)
@@ -169,7 +169,7 @@ public class MarketingCommissionAdminService : ApplicationService
     }
 
     /// <summary>
-    /// ???????
+    /// 驳回提现申请。
     /// </summary>
     [HttpPost("/marketing/commission-withdraw/reject")]
     public async Task RejectWithdrawAsync(CommissionWithdrawRejectInput input)
diff --git a/src/Oms.Application/Services/Marketing/MarketingPortalReferralService.cs b/src/Oms.Application/Services/Marketing/MarketingPortalReferralService.cs
index 4dfda12..16cb88d 100644
--- a/src/Oms.Application/Services/Marketing/MarketingPortalReferralService.cs
+++ b/src/Oms.Application/Services/Marketing/MarketingPortalReferralService.cs
@@ -148,7 +148,7 @@ public class MarketingPortalReferralService : ApplicationService
             Valid = true,
             InviterCustomerCode = inviter.CustomerCode,
             InviterNameMasked = MarketingPortalSessionHelper.MaskName(inviter.CustomerName),
-            Message = "?????"
+            Message = "邀请码有效"
         };
     }
 }
diff --git a/src/Oms.Application/Services/Marketing/MarketingReferralAdminService.cs b/src/Oms.Application/Services/Marketing/MarketingReferralAdminService.cs
index a813031..cd5699c 100644
--- a/src/Oms.Application/Services/Marketing/MarketingReferralAdminService.cs
+++ b/src/Oms.Application/Services/Marketing/MarketingReferralAdminService.cs
@@ -16,7 +16,7 @@ using Oms.Domain.MarketingAggregate.Repositories;
 namespace Oms.Application.Services.Marketing;
 
 /// <summary>
-/// ?????? API??????
+/// 引荐关系管理 API（管理端）。
 /// </summary>
 [ApiExplorerSettings(GroupName = "OMS-Marketing")]
 public class MarketingReferralAdminService : ApplicationService
@@ -31,7 +31,7 @@ public class MarketingReferralAdminService : ApplicationService
         LazyServiceProvider.GetRequiredService<IMarketingAuditLogRepository>();
 
     /// <summary>
-    /// ????????????
+    /// 分页查询全部引荐人汇总。
     /// </summary>
     [HttpPost("/marketing/referral/referrer-list")]
     public async Task<OmsPageResult<ReferralReferrerOutput>> GetReferrerListAsync(ReferralReferrerListInput input)
@@ -72,7 +72,7 @@ public class MarketingReferralAdminService : ApplicationService
     }
 
     /// <summary>
-    /// ???????????????
+    /// 查询指定引荐人的一级下级列表。
     /// </summary>
     [HttpPost("/marketing/referral/tree")]
     public async Task<OmsPageResult<ReferralTreeNodeOutput>> GetTreeAsync(ReferralTreeInput input)
@@ -95,7 +95,7 @@ public class MarketingReferralAdminService : ApplicationService
     }
 
     /// <summary>
-    /// ???????????????????????
+    /// 人工改绑引荐关系（仅影响新订单，须填写原因）。
     /// </summary>
     [HttpPost("/marketing/referral/rebind")]
     public async Task RebindAsync(ReferralRebindInput input)