From 2e65ea4ee7094e35695c006126e2899d1c512bee Mon Sep 17 00:00:00 2001 From: xiaolipro <2357729423@qq.com> Date: Fri, 17 Apr 2026 11:09:01 +0800 Subject: [PATCH] =?UTF-8?q?feat=EF=BC=9Aremarks?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- SimpleAdmin.sln | 1 + .../Dtos/Channels/AutoTriggerListInput.cs | 4 +- .../Dtos/Channels/AutoTriggerOutput.cs | 30 +++ .../Dtos/Channels/AutoTriggerSaveInput.cs | 14 +- .../Dtos/Channels/ChannelPriceDetailInput.cs | 12 +- .../Dtos/Channels/ChannelPriceDetailOutput.cs | 21 +++ .../Dtos/Channels/ChannelPriceFactorInput.cs | 10 +- .../Dtos/Channels/ChannelPriceFactorOutput.cs | 18 ++ .../Dtos/Channels/KpiAreaInfoListInput.cs | 2 +- .../Dtos/Channels/KpiAreaInfoOutput.cs | 33 ++++ .../Dtos/Channels/KpiAreaInfoSaveInput.cs | 10 +- .../Dtos/Channels/KpiAreaListInput.cs | 6 +- .../Dtos/Channels/KpiAreaOutput.cs | 24 +++ .../Dtos/Channels/KpiAreaSaveInput.cs | 10 +- .../Dtos/Channels/LabelTemplateSaveInput.cs | 8 +- .../Dtos/Channels/LabelTemplateSaveOutput.cs | 21 +++ .../Channels/SalesProductAllocationOutput.cs | 12 ++ .../SalesProductAllocationProviderInput.cs | 14 +- .../SalesProductAllocationProviderOutput.cs | 33 ++++ .../SalesProductAllocationSaveInput.cs | 8 +- .../Dtos/Channels/SalesProductDetailOutput.cs | 60 ++++++ .../Dtos/Channels/SalesProductListInput.cs | 6 +- .../Dtos/Channels/SalesProductListOutput.cs | 51 +++++ .../Channels/SalesProductPriceListOutput.cs | 45 +++++ .../Channels/SalesProductPriceSaveAllInput.cs | 6 +- .../Channels/SalesProductPriceSaveInput.cs | 16 +- .../Dtos/Channels/SalesProductPublishInput.cs | 6 +- .../Channels/SalesProductPublishListInput.cs | 2 +- .../SalesProductPublishRecordOutput.cs | 33 ++++ .../Channels/SalesProductRollbackInput.cs | 6 +- .../Dtos/Channels/SalesProductSaveInput.cs | 6 +- .../Channels/ServiceChannelDetailOutput.cs | 51 +++++ .../Dtos/Channels/ServiceChannelListInput.cs | 8 +- .../Dtos/Channels/ServiceChannelListOutput.cs | 42 +++++ .../Channels/ServiceChannelPriceListOutput.cs | 45 +++++ .../ServiceChannelPriceSaveAllInput.cs | 6 +- .../Channels/ServiceChannelPriceSaveInput.cs | 20 +- .../Channels/ServiceChannelPublishInput.cs | 6 +- .../ServiceChannelPublishListInput.cs | 2 +- .../ServiceChannelPublishRecordOutput.cs | 33 ++++ .../Channels/ServiceChannelRollbackInput.cs | 6 +- .../Dtos/Channels/ServiceChannelSaveInput.cs | 14 +- .../Channels/WeightRoundingInfoListInput.cs | 4 +- .../Dtos/Channels/WeightRoundingInfoOutput.cs | 30 +++ .../Channels/WeightRoundingInfoSaveInput.cs | 16 +- .../Dtos/Channels/WeightRoundingListInput.cs | 2 +- .../Dtos/Channels/WeightRoundingOutput.cs | 18 ++ .../Dtos/Channels/WeightRoundingSaveInput.cs | 6 +- .../Dtos/Channels/WeightRuleInfoListInput.cs | 4 +- .../Dtos/Channels/WeightRuleInfoOutput.cs | 27 +++ .../Dtos/Channels/WeightRuleInfoSaveInput.cs | 12 +- .../Dtos/Channels/WeightRuleListInput.cs | 2 +- .../Dtos/Channels/WeightRuleOutput.cs | 18 ++ .../Dtos/Channels/WeightRuleSaveInput.cs | 4 +- .../Dtos/Customers/CreateCustomerInput.cs | 30 +++ .../Dtos/Customers/CustomerOutput.cs | 66 +++++++ .../Dtos/Customers/CustomerPaginatedInput.cs | 24 +++ .../Dtos/Customers/CustomerPaginatedOutput.cs | 57 ++++++ .../Customers/ResetCustomerPasswordInput.cs | 9 + .../Dtos/Customers/UpdateCustomerInput.cs | 27 +++ .../Operations/CreateInboundRecordInput.cs | 27 +++ .../Operations/CreateOutboundRecordInput.cs | 9 + .../Dtos/Operations/InboundRecordOutput.cs | 48 +++++ .../Dtos/Operations/LabelPrintRecordOutput.cs | 39 ++++ .../Operations/LabelTemplateDropdownOutput.cs | 21 +++ .../Dtos/Operations/OutboundRecordOutput.cs | 27 +++ .../Dtos/Operations/PrintLabelInput.cs | 15 ++ .../Dtos/Orders/OrderActionInput.cs | 9 + .../Dtos/Orders/OrderExportInput.cs | 8 +- .../Dtos/Orders/OrderExportOutput.cs | 9 + .../Dtos/Orders/OrderItemOutput.cs | 78 ++++++++ .../Dtos/Orders/OrderOutput.cs | 90 +++++++++ .../Dtos/Orders/OrderPaginatedInput.cs | 10 +- .../Dtos/Orders/OrderPaginatedOutput.cs | 72 +++++++ .../Dtos/Orders/OrderParcelCreateInput.cs | 78 ++++++++ .../Dtos/Orders/OrderParcelCreateOutput.cs | 15 ++ .../Dtos/Orders/OrderParcelItemInput.cs | 81 ++++++++ .../Dtos/Orders/OrderParcelReceiverInput.cs | 60 ++++++ .../Dtos/Orders/OrderParcelSenderInput.cs | 42 +++++ .../Dtos/Orders/OrderPriceCheckInput.cs | 30 +++ .../Dtos/Orders/OrderPriceCheckOutput.cs | 39 ++++ .../Dtos/Orders/OrderPrintOutput.cs | 6 + .../Dtos/Orders/OrderReceiverOutput.cs | 60 ++++++ .../Dtos/Orders/OrderSenderOutput.cs | 42 +++++ .../Dtos/Orders/OrderTaskDetailOutput.cs | 33 ++++ .../Dtos/Orders/OrderTaskFailOutput.cs | 18 ++ .../Dtos/Orders/OrderTaskListInput.cs | 15 ++ .../Dtos/Orders/OrderTaskOutput.cs | 24 +++ .../Dtos/Orders/OrderTemplateListInput.cs | 15 ++ .../Dtos/Orders/OrderTemplateOutput.cs | 24 +++ .../Dtos/Orders/OrderUploadInput.cs | 9 + .../Dtos/Orders/OrderUploadOutput.cs | 6 + .../Dtos/Orders/OrderWeightOutput.cs | 27 +++ .../Dtos/Recharge/ApproveRechargeInput.cs | 9 + .../Dtos/Recharge/RechargeExportInput.cs | 8 +- .../Dtos/Recharge/RechargeRecordOutput.cs | 33 ++++ .../Recharge/RechargeRecordPaginatedInput.cs | 10 +- .../Recharge/RechargeRecordPaginatedOutput.cs | 54 ++++++ .../Dtos/Recharge/RejectRechargeInput.cs | 9 + .../Dtos/Recharge/SubmitRechargeInput.cs | 18 ++ src/Oms.Application/Dtos/Shared/IdInput.cs | 6 + .../Dtos/Shared/OmsItemsResult.cs | 6 + .../Dtos/Shared/OmsPageResult.cs | 9 + .../Dtos/Shared/ToggleStatusInput.cs | 6 +- .../Dtos/System/CreateWarehouseInput.cs | 27 +++ .../Dtos/System/UpdateWarehouseInput.cs | 30 +++ .../Dtos/System/WarehouseOutput.cs | 42 +++++ .../Dtos/System/WarehousePaginatedInput.cs | 15 ++ .../Dtos/System/WarehousePaginatedOutput.cs | 39 ++++ src/Oms.Application/Oms.Application.csproj | 1 + .../Services/Channels/AutoTriggerService.cs | 44 ++++- .../Services/Channels/KpiAreaService.cs | 80 +++++++- .../Services/Channels/LabelTemplateService.cs | 10 +- .../Services/Channels/SalesProductService.cs | 162 +++++++++++++++- .../Channels/ServiceChannelService.cs | 152 +++++++++++++-- .../Channels/WeightRoundingService.cs | 80 +++++++- .../Services/Channels/WeightRuleService.cs | 68 ++++++- .../Services/Customers/CustomerService.cs | 66 +++++++ .../Operations/InboundRecordService.cs | 23 +++ .../Services/Operations/LabelPrintService.cs | 34 ++++ .../Operations/OutboundRecordService.cs | 23 +++ .../Services/Orders/OrderService.cs | 177 +++++++++++++++++- .../Services/Recharge/RechargeService.cs | 54 +++++- .../Services/System/WarehouseService.cs | 55 ++++++ .../Properties/launchSettings.json | 11 ++ 125 files changed, 3353 insertions(+), 211 deletions(-) diff --git a/SimpleAdmin.sln b/SimpleAdmin.sln index e236122..9dbeb5a 100644 --- a/SimpleAdmin.sln +++ b/SimpleAdmin.sln @@ -12,6 +12,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "items", "items", "{BE5132AD 开发复刻说明.md = 开发复刻说明.md oms表结构与接口设计2026040802.md = oms表结构与接口设计2026040802.md .gitignore = .gitignore + .dockerignore = .dockerignore EndProjectSection EndProject Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SimpleAdmin.Api", "src\SimpleAdmin.Api\SimpleAdmin.Api.csproj", "{229ED167-9ECC-4736-8DFB-522EEA8FF680}" diff --git a/src/Oms.Application/Dtos/Channels/AutoTriggerListInput.cs b/src/Oms.Application/Dtos/Channels/AutoTriggerListInput.cs index f75085f..8a2b5c3 100644 --- a/src/Oms.Application/Dtos/Channels/AutoTriggerListInput.cs +++ b/src/Oms.Application/Dtos/Channels/AutoTriggerListInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Channels; /// -/// 自动触发分页查询入参。 +/// 自动触发规则列表查询入参。 /// public class AutoTriggerListInput { @@ -16,7 +16,7 @@ public class AutoTriggerListInput public int PageSize { get; set; } /// - /// 触发操作类型。 + /// 操作类型。 /// public string? Operation { get; set; } diff --git a/src/Oms.Application/Dtos/Channels/AutoTriggerOutput.cs b/src/Oms.Application/Dtos/Channels/AutoTriggerOutput.cs index c9aefb6..322f074 100644 --- a/src/Oms.Application/Dtos/Channels/AutoTriggerOutput.cs +++ b/src/Oms.Application/Dtos/Channels/AutoTriggerOutput.cs @@ -1,22 +1,52 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 自动触发规则出参。 +/// public class AutoTriggerOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 状态。 + /// public byte Status { get; set; } + /// + /// 操作类型。 + /// public string? Operation { get; set; } + /// + /// 触发时机。 + /// public string? TriggerTiming { get; set; } + /// + /// 触发条件。 + /// public string? TriggerCondition { get; set; } + /// + /// 提示信息。 + /// public string? PromptMessage { get; set; } + /// + /// 通知对象。 + /// public string? Notifier { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/AutoTriggerSaveInput.cs b/src/Oms.Application/Dtos/Channels/AutoTriggerSaveInput.cs index a88050f..12d7e9f 100644 --- a/src/Oms.Application/Dtos/Channels/AutoTriggerSaveInput.cs +++ b/src/Oms.Application/Dtos/Channels/AutoTriggerSaveInput.cs @@ -3,22 +3,22 @@ using Oms.Domain.Shared.Enums; namespace Oms.Application.Dtos.Channels; /// -/// 自动触发保存入参。 +/// 自动触发规则保存入参。 /// public class AutoTriggerSaveInput { /// - /// 自动触发主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } /// - /// 启用状态。 + /// 状态。 /// public EnableStatus Status { get; set; } /// - /// 触发操作类型。 + /// 操作类型。 /// public string? Operation { get; set; } @@ -28,17 +28,17 @@ public class AutoTriggerSaveInput public string? TriggerTiming { get; set; } /// - /// 触发表达式。 + /// 触发条件。 /// public string? TriggerCondition { get; set; } /// - /// 提示文案。 + /// 提示信息。 /// public string? PromptMessage { get; set; } /// - /// 通知人或通知目标。 + /// 通知对象。 /// public string? Notifier { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/ChannelPriceDetailInput.cs b/src/Oms.Application/Dtos/Channels/ChannelPriceDetailInput.cs index e6e0e3f..1500494 100644 --- a/src/Oms.Application/Dtos/Channels/ChannelPriceDetailInput.cs +++ b/src/Oms.Application/Dtos/Channels/ChannelPriceDetailInput.cs @@ -1,32 +1,32 @@ namespace Oms.Application.Dtos.Channels; /// -/// 价格明细保存入参。 +/// 渠道价格详情入参。 /// public class ChannelPriceDetailInput { /// - /// 明细主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } /// - /// 计费因子值组合，按文档原样接收 JSON 对象。 + /// 因子取值 JSON。 /// public object? FactorValuesJson { get; set; } /// - /// 计算方式，例如单价、首重+续重等。 + /// 计算公式。 /// public string CalculationFormula { get; set; } = string.Empty; /// - /// 计算结果值。 + /// 计算结果。 /// public decimal? CalculatedValue { get; set; } /// - /// 客户组差异化价格 JSON。 + /// 客户分组取值集合。 /// public object? CustomerGroupValues { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/ChannelPriceDetailOutput.cs b/src/Oms.Application/Dtos/Channels/ChannelPriceDetailOutput.cs index c359177..7076006 100644 --- a/src/Oms.Application/Dtos/Channels/ChannelPriceDetailOutput.cs +++ b/src/Oms.Application/Dtos/Channels/ChannelPriceDetailOutput.cs @@ -1,16 +1,37 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 渠道价格详情出参。 +/// public class ChannelPriceDetailOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 价格项主键。 + /// public long PriceId { get; set; } + /// + /// 因子取值 JSON。 + /// public object? FactorValuesJson { get; set; } + /// + /// 计算公式。 + /// public string CalculationFormula { get; set; } = string.Empty; + /// + /// 计算结果。 + /// public decimal? CalculatedValue { get; set; } + /// + /// 客户分组取值集合。 + /// public object? CustomerGroupValues { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/ChannelPriceFactorInput.cs b/src/Oms.Application/Dtos/Channels/ChannelPriceFactorInput.cs index 286f8d9..668c5dd 100644 --- a/src/Oms.Application/Dtos/Channels/ChannelPriceFactorInput.cs +++ b/src/Oms.Application/Dtos/Channels/ChannelPriceFactorInput.cs @@ -1,27 +1,27 @@ namespace Oms.Application.Dtos.Channels; /// -/// 价格计费因子保存入参。 +/// 渠道价格Factor入参。 /// public class ChannelPriceFactorInput { /// - /// 因子主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } /// - /// 排序号。 + /// 序号。 /// public int SerialNumber { get; set; } /// - /// 因子名称，例如分区、重量、货物类型。 + /// 计费因子。 /// public string Factor { get; set; } = string.Empty; /// - /// 因子可选值列表。 + /// 因子取值集合。 /// public List FactorValues { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/Channels/ChannelPriceFactorOutput.cs b/src/Oms.Application/Dtos/Channels/ChannelPriceFactorOutput.cs index 68c5c94..b42c34b 100644 --- a/src/Oms.Application/Dtos/Channels/ChannelPriceFactorOutput.cs +++ b/src/Oms.Application/Dtos/Channels/ChannelPriceFactorOutput.cs @@ -1,14 +1,32 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 渠道价格Factor出参。 +/// public class ChannelPriceFactorOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 价格项主键。 + /// public long PriceId { get; set; } + /// + /// 序号。 + /// public int SerialNumber { get; set; } + /// + /// 计费因子。 + /// public string Factor { get; set; } = string.Empty; + /// + /// 因子取值集合。 + /// public List FactorValues { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/Channels/KpiAreaInfoListInput.cs b/src/Oms.Application/Dtos/Channels/KpiAreaInfoListInput.cs index a95697b..d59530f 100644 --- a/src/Oms.Application/Dtos/Channels/KpiAreaInfoListInput.cs +++ b/src/Oms.Application/Dtos/Channels/KpiAreaInfoListInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Channels; /// -/// KPI 分区明细分页查询入参。 +/// KPI分区明细列表查询入参。 /// public class KpiAreaInfoListInput { diff --git a/src/Oms.Application/Dtos/Channels/KpiAreaInfoOutput.cs b/src/Oms.Application/Dtos/Channels/KpiAreaInfoOutput.cs index f8cf876..f3e5cfd 100644 --- a/src/Oms.Application/Dtos/Channels/KpiAreaInfoOutput.cs +++ b/src/Oms.Application/Dtos/Channels/KpiAreaInfoOutput.cs @@ -1,24 +1,57 @@ namespace Oms.Application.Dtos.Channels; +/// +/// KPI分区明细出参。 +/// public class KpiAreaInfoOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 分区主键。 + /// public long AreaId { get; set; } + /// + /// 国家/地区代码。 + /// public string? CountryCode { get; set; } + /// + /// 国家/地区名称。 + /// public string? CountryName { get; set; } + /// + /// 省份。 + /// public string? Province { get; set; } + /// + /// 城市。 + /// public string? City { get; set; } + /// + /// 起始邮编。 + /// public string? LeftPostcode { get; set; } + /// + /// 结束邮编。 + /// public string? RightPostcode { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/KpiAreaInfoSaveInput.cs b/src/Oms.Application/Dtos/Channels/KpiAreaInfoSaveInput.cs index 8cbfbfb..f7ff228 100644 --- a/src/Oms.Application/Dtos/Channels/KpiAreaInfoSaveInput.cs +++ b/src/Oms.Application/Dtos/Channels/KpiAreaInfoSaveInput.cs @@ -1,12 +1,12 @@ namespace Oms.Application.Dtos.Channels; /// -/// KPI 分区明细保存入参。 +/// KPI分区明细保存入参。 /// public class KpiAreaInfoSaveInput { /// - /// 分区明细主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } @@ -16,17 +16,17 @@ public class KpiAreaInfoSaveInput public long AreaId { get; set; } /// - /// 国家二字码。 + /// 国家/地区代码。 /// public string? CountryCode { get; set; } /// - /// 国家名称。 + /// 国家/地区名称。 /// public string? CountryName { get; set; } /// - /// 省/州。 + /// 省份。 /// public string? Province { get; set; } diff --git a/src/Oms.Application/Dtos/Channels/KpiAreaListInput.cs b/src/Oms.Application/Dtos/Channels/KpiAreaListInput.cs index bb6736d..96d861a 100644 --- a/src/Oms.Application/Dtos/Channels/KpiAreaListInput.cs +++ b/src/Oms.Application/Dtos/Channels/KpiAreaListInput.cs @@ -1,17 +1,17 @@ namespace Oms.Application.Dtos.Channels; /// -/// KPI 分区分页查询入参。 +/// KPI分区列表查询入参。 /// public class KpiAreaListInput { /// - /// 分区应用标识，例如 blacklist、remote、warning。 + /// 应用标识。 /// public string? AppKey { get; set; } /// - /// 分区类型编码。 + /// 分区类型。 /// public string? AreaType { get; set; } diff --git a/src/Oms.Application/Dtos/Channels/KpiAreaOutput.cs b/src/Oms.Application/Dtos/Channels/KpiAreaOutput.cs index bb8ac21..970bf05 100644 --- a/src/Oms.Application/Dtos/Channels/KpiAreaOutput.cs +++ b/src/Oms.Application/Dtos/Channels/KpiAreaOutput.cs @@ -1,18 +1,42 @@ namespace Oms.Application.Dtos.Channels; +/// +/// KPI分区出参。 +/// public class KpiAreaOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 应用标识。 + /// public string AppKey { get; set; } = string.Empty; + /// + /// 分区类型。 + /// public string AreaType { get; set; } = string.Empty; + /// + /// 名称。 + /// public string Name { get; set; } = string.Empty; + /// + /// 系统名称。 + /// public string? SystemName { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/KpiAreaSaveInput.cs b/src/Oms.Application/Dtos/Channels/KpiAreaSaveInput.cs index 139b329..083faa9 100644 --- a/src/Oms.Application/Dtos/Channels/KpiAreaSaveInput.cs +++ b/src/Oms.Application/Dtos/Channels/KpiAreaSaveInput.cs @@ -1,27 +1,27 @@ namespace Oms.Application.Dtos.Channels; /// -/// KPI 分区保存入参。 +/// KPI分区保存入参。 /// public class KpiAreaSaveInput { /// - /// 分区主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } /// - /// 分区应用标识。 + /// 应用标识。 /// public string AppKey { get; set; } = string.Empty; /// - /// 分区类型编码。 + /// 分区类型。 /// public string AreaType { get; set; } = string.Empty; /// - /// 分区名称。 + /// 名称。 /// public string Name { get; set; } = string.Empty; diff --git a/src/Oms.Application/Dtos/Channels/LabelTemplateSaveInput.cs b/src/Oms.Application/Dtos/Channels/LabelTemplateSaveInput.cs index a2bcd66..244faa0 100644 --- a/src/Oms.Application/Dtos/Channels/LabelTemplateSaveInput.cs +++ b/src/Oms.Application/Dtos/Channels/LabelTemplateSaveInput.cs @@ -6,22 +6,22 @@ namespace Oms.Application.Dtos.Channels; public class LabelTemplateSaveInput { /// - /// 模板主键，传 0 表示新增。 + /// 主键。 /// public long Id { get; set; } /// - /// 模板名称。 + /// 名称。 /// public string Name { get; set; } = string.Empty; /// - /// 模板类型，例如 lastMile、customer、inbound。 + /// 模板类型。 /// public string? TemplateType { get; set; } /// - /// vg-print 导出的模板 JSON。 + /// 模板 JSON。 /// public object? TemplateJson { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/LabelTemplateSaveOutput.cs b/src/Oms.Application/Dtos/Channels/LabelTemplateSaveOutput.cs index ab5851d..79f1248 100644 --- a/src/Oms.Application/Dtos/Channels/LabelTemplateSaveOutput.cs +++ b/src/Oms.Application/Dtos/Channels/LabelTemplateSaveOutput.cs @@ -1,16 +1,37 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 标签模板保存结果出参。 +/// public class LabelTemplateSaveOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 名称。 + /// public string Name { get; set; } = string.Empty; + /// + /// 模板类型。 + /// public string? TemplateType { get; set; } + /// + /// 模板 JSON。 + /// public object? TemplateJson { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductAllocationOutput.cs b/src/Oms.Application/Dtos/Channels/SalesProductAllocationOutput.cs index e047a48..b1cb9f0 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductAllocationOutput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductAllocationOutput.cs @@ -1,10 +1,22 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 销售产品分配出参。 +/// public class SalesProductAllocationOutput { + /// + /// 销售产品主键。 + /// public long SalesProductId { get; set; } + /// + /// 方案编码。 + /// public string Scheme { get; set; } = string.Empty; + /// + /// 供应商集合。 + /// public List Providers { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductAllocationProviderInput.cs b/src/Oms.Application/Dtos/Channels/SalesProductAllocationProviderInput.cs index cf80bae..7ff5426 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductAllocationProviderInput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductAllocationProviderInput.cs @@ -1,37 +1,37 @@ namespace Oms.Application.Dtos.Channels; /// -/// 销售产品排货服务商保存入参。 +/// 销售产品分配供应商入参。 /// public class SalesProductAllocationProviderInput { /// - /// 服务商配置主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } /// - /// 排序号。 + /// 序号。 /// public int SerialNumber { get; set; } /// - /// 服务商名称。 + /// 供应商名称。 /// public string ProviderName { get; set; } = string.Empty; /// - /// 关联的服务渠道主键。 + /// 服务渠道主键。 /// public long? ServiceChannelId { get; set; } /// - /// 权重。 + /// 重量。 /// public int Weight { get; set; } /// - /// 指定客户主键列表。 + /// 客户主键集合。 /// public List CustomerIds { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductAllocationProviderOutput.cs b/src/Oms.Application/Dtos/Channels/SalesProductAllocationProviderOutput.cs index 28c7c56..90b3e5b 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductAllocationProviderOutput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductAllocationProviderOutput.cs @@ -1,24 +1,57 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 销售产品分配供应商出参。 +/// public class SalesProductAllocationProviderOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 销售产品主键。 + /// public long SalesProductId { get; set; } + /// + /// 序号。 + /// public int SerialNumber { get; set; } + /// + /// 供应商名称。 + /// public string ProviderName { get; set; } = string.Empty; + /// + /// 服务渠道主键。 + /// public long? ServiceChannelId { get; set; } + /// + /// 服务渠道名称。 + /// public string? ServiceChannelName { get; set; } + /// + /// 重量。 + /// public int Weight { get; set; } + /// + /// 客户主键集合。 + /// public List CustomerIds { get; set; } = []; + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductAllocationSaveInput.cs b/src/Oms.Application/Dtos/Channels/SalesProductAllocationSaveInput.cs index fd4d648..42e94e6 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductAllocationSaveInput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductAllocationSaveInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Channels; /// -/// 销售产品排货方案保存入参。 +/// 销售产品分配保存入参。 /// public class SalesProductAllocationSaveInput { @@ -11,17 +11,17 @@ public class SalesProductAllocationSaveInput public long SalesProductId { get; set; } /// - /// 是否保存后立即发布。 + /// 是否发布。 /// public bool Publish { get; set; } /// - /// 排货方案编码。 + /// 方案编码。 /// public string Scheme { get; set; } = string.Empty; /// - /// 服务商列表。 + /// 供应商集合。 /// public List Providers { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductDetailOutput.cs b/src/Oms.Application/Dtos/Channels/SalesProductDetailOutput.cs index 41e902b..0fd4435 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductDetailOutput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductDetailOutput.cs @@ -1,42 +1,102 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 销售产品详情出参。 +/// public class SalesProductDetailOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 产品编码。 + /// public string ProductCode { get; set; } = string.Empty; + /// + /// 产品名称。 + /// public string ProductName { get; set; } = string.Empty; + /// + /// 产品分组。 + /// public string? ProductGroup { get; set; } + /// + /// 最小时效。 + /// public int? MinTimeliness { get; set; } + /// + /// 最大时效。 + /// public int? MaxTimeliness { get; set; } + /// + /// 客户面单类型。 + /// public string? CustomerWaybill { get; set; } + /// + /// 黑名单分区主键。 + /// public long? BlacklistAreaId { get; set; } + /// + /// 偏远分区主键。 + /// public long? RemoteAreaId { get; set; } + /// + /// 计重规则主键。 + /// public long? WeightRuleId { get; set; } + /// + /// 计重进位规则主键。 + /// public long? WeightRoundingId { get; set; } + /// + /// 产品描述。 + /// public string? ProductDescription { get; set; } + /// + /// 预入库脚本。 + /// public string? PreStorageScript { get; set; } + /// + /// 是否启用。 + /// public byte IsActive { get; set; } + /// + /// 方案编码。 + /// public string Scheme { get; set; } = string.Empty; + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 创建人。 + /// public string? CreateBy { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } + /// + /// 更新人。 + /// public string? UpdateBy { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductListInput.cs b/src/Oms.Application/Dtos/Channels/SalesProductListInput.cs index 13ada57..ecb2bff 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductListInput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductListInput.cs @@ -3,7 +3,7 @@ using Oms.Domain.Shared.Enums; namespace Oms.Application.Dtos.Channels; /// -/// 销售产品分页查询入参。 +/// 销售产品列表查询入参。 /// public class SalesProductListInput { @@ -23,12 +23,12 @@ public class SalesProductListInput public string? ProductGroup { get; set; } /// - /// 关键字，匹配产品编码或产品名称。 + /// 关键词。 /// public string? Keyword { get; set; } /// - /// 启用状态。 + /// 是否启用。 /// public EnableStatus? IsActive { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductListOutput.cs b/src/Oms.Application/Dtos/Channels/SalesProductListOutput.cs index 8f89ca4..a994dc4 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductListOutput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductListOutput.cs @@ -1,36 +1,87 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 销售产品List出参。 +/// public class SalesProductListOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 产品编码。 + /// public string ProductCode { get; set; } = string.Empty; + /// + /// 产品名称。 + /// public string ProductName { get; set; } = string.Empty; + /// + /// 产品分组。 + /// public string? ProductGroup { get; set; } + /// + /// 最小时效。 + /// public int? MinTimeliness { get; set; } + /// + /// 最大时效。 + /// public int? MaxTimeliness { get; set; } + /// + /// 客户面单类型。 + /// public string? CustomerWaybill { get; set; } + /// + /// 黑名单分区主键。 + /// public long? BlacklistAreaId { get; set; } + /// + /// 偏远分区主键。 + /// public long? RemoteAreaId { get; set; } + /// + /// 计重规则主键。 + /// public long? WeightRuleId { get; set; } + /// + /// 计重进位规则主键。 + /// public long? WeightRoundingId { get; set; } + /// + /// 产品描述。 + /// public string? ProductDescription { get; set; } + /// + /// 是否启用。 + /// public byte IsActive { get; set; } + /// + /// 方案编码。 + /// public string Scheme { get; set; } = string.Empty; + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductPriceListOutput.cs b/src/Oms.Application/Dtos/Channels/SalesProductPriceListOutput.cs index 449294a..d1c2927 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductPriceListOutput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductPriceListOutput.cs @@ -1,32 +1,77 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 销售产品价格List出参。 +/// public class SalesProductPriceListOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 销售产品主键。 + /// public long SalesProductId { get; set; } + /// + /// 序号。 + /// public int SerialNumber { get; set; } + /// + /// 状态。 + /// public byte Status { get; set; } + /// + /// 价格项名称。 + /// public string PriceName { get; set; } = string.Empty; + /// + /// 费用项目。 + /// public string CostItem { get; set; } = string.Empty; + /// + /// 计费单位。 + /// public string CostUnit { get; set; } = string.Empty; + /// + /// 币种。 + /// public string Currency { get; set; } = string.Empty; + /// + /// 计费时机。 + /// public string? ChargingTime { get; set; } + /// + /// 计费条件。 + /// public string? ChargingCondition { get; set; } + /// + /// 价格因子集合。 + /// public List Factors { get; set; } = []; + /// + /// 价格明细集合。 + /// public List Details { get; set; } = []; + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductPriceSaveAllInput.cs b/src/Oms.Application/Dtos/Channels/SalesProductPriceSaveAllInput.cs index 22a4484..699e1be 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductPriceSaveAllInput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductPriceSaveAllInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Channels; /// -/// 销售产品价格批量保存入参。 +/// 销售产品价格项批量保存入参。 /// public class SalesProductPriceSaveAllInput { @@ -11,12 +11,12 @@ public class SalesProductPriceSaveAllInput public long SalesProductId { get; set; } /// - /// 是否保存后立即发布。 + /// 是否发布。 /// public bool Publish { get; set; } /// - /// 价格项列表。 + /// 价格项集合。 /// public List Prices { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductPriceSaveInput.cs b/src/Oms.Application/Dtos/Channels/SalesProductPriceSaveInput.cs index 1a819a9..c208ca6 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductPriceSaveInput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductPriceSaveInput.cs @@ -8,7 +8,7 @@ namespace Oms.Application.Dtos.Channels; public class SalesProductPriceSaveInput { /// - /// 价格项主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } @@ -18,12 +18,12 @@ public class SalesProductPriceSaveInput public long SalesProductId { get; set; } /// - /// 排序号。 + /// 序号。 /// public int SerialNumber { get; set; } /// - /// 价格项状态。 + /// 状态。 /// public EnableStatus Status { get; set; } @@ -33,7 +33,7 @@ public class SalesProductPriceSaveInput public string PriceName { get; set; } = string.Empty; /// - /// 费用项编码。 + /// 费用项目。 /// public string CostItem { get; set; } = string.Empty; @@ -48,22 +48,22 @@ public class SalesProductPriceSaveInput public string Currency { get; set; } = string.Empty; /// - /// 收费时机。 + /// 计费时机。 /// public string? ChargingTime { get; set; } /// - /// 收费条件。 + /// 计费条件。 /// public string? ChargingCondition { get; set; } /// - /// 计费因子定义。 + /// 价格因子集合。 /// public List Factors { get; set; } = []; /// - /// 价格明细行。 + /// 价格明细集合。 /// public List Details { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductPublishInput.cs b/src/Oms.Application/Dtos/Channels/SalesProductPublishInput.cs index afe14fd..bd8b934 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductPublishInput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductPublishInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Channels; /// -/// 销售产品配置发布入参。 +/// 销售产品发布入参。 /// public class SalesProductPublishInput { @@ -11,12 +11,12 @@ public class SalesProductPublishInput public long SalesProductId { get; set; } /// - /// 发布类型，支持 price 或 rules。 + /// 操作类型。 /// public string OperatorType { get; set; } = string.Empty; /// - /// 发布说明。 + /// 描述。 /// public string? Description { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductPublishListInput.cs b/src/Oms.Application/Dtos/Channels/SalesProductPublishListInput.cs index b8910b9..612e95e 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductPublishListInput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductPublishListInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Channels; /// -/// 销售产品发布记录分页查询入参。 +/// 销售产品发布列表查询入参。 /// public class SalesProductPublishListInput { diff --git a/src/Oms.Application/Dtos/Channels/SalesProductPublishRecordOutput.cs b/src/Oms.Application/Dtos/Channels/SalesProductPublishRecordOutput.cs index 90ca365..62831d5 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductPublishRecordOutput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductPublishRecordOutput.cs @@ -1,24 +1,57 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 销售产品发布记录出参。 +/// public class SalesProductPublishRecordOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 销售产品主键。 + /// public long SalesProductId { get; set; } + /// + /// 版本号。 + /// public string Version { get; set; } = string.Empty; + /// + /// 操作类型。 + /// public string OperatorType { get; set; } = string.Empty; + /// + /// 状态。 + /// public string Status { get; set; } = string.Empty; + /// + /// 发布人。 + /// public string PublishUser { get; set; } = string.Empty; + /// + /// 发布时间。 + /// public DateTime PublishTime { get; set; } + /// + /// 描述。 + /// public string? Description { get; set; } + /// + /// 内容。 + /// public object? Content { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductRollbackInput.cs b/src/Oms.Application/Dtos/Channels/SalesProductRollbackInput.cs index 27c82d2..e4172ef 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductRollbackInput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductRollbackInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Channels; /// -/// 销售产品配置回滚入参。 +/// 销售产品回滚入参。 /// public class SalesProductRollbackInput { @@ -11,12 +11,12 @@ public class SalesProductRollbackInput public long SalesProductId { get; set; } /// - /// 发布记录主键。 + /// 记录主键。 /// public long RecordId { get; set; } /// - /// 回滚类型，支持 price 或 rules。 + /// 操作类型。 /// public string OperatorType { get; set; } = string.Empty; } diff --git a/src/Oms.Application/Dtos/Channels/SalesProductSaveInput.cs b/src/Oms.Application/Dtos/Channels/SalesProductSaveInput.cs index b1a0dce..c64ec9f 100644 --- a/src/Oms.Application/Dtos/Channels/SalesProductSaveInput.cs +++ b/src/Oms.Application/Dtos/Channels/SalesProductSaveInput.cs @@ -8,7 +8,7 @@ namespace Oms.Application.Dtos.Channels; public class SalesProductSaveInput { /// - /// 产品主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } @@ -58,7 +58,7 @@ public class SalesProductSaveInput public long? WeightRuleId { get; set; } /// - /// 计重进位主键。 + /// 计重进位规则主键。 /// public long? WeightRoundingId { get; set; } @@ -78,7 +78,7 @@ public class SalesProductSaveInput public EnableStatus IsActive { get; set; } /// - /// 排货方案编码。 + /// 方案编码。 /// public string Scheme { get; set; } = string.Empty; } diff --git a/src/Oms.Application/Dtos/Channels/ServiceChannelDetailOutput.cs b/src/Oms.Application/Dtos/Channels/ServiceChannelDetailOutput.cs index 4619643..f69a71f 100644 --- a/src/Oms.Application/Dtos/Channels/ServiceChannelDetailOutput.cs +++ b/src/Oms.Application/Dtos/Channels/ServiceChannelDetailOutput.cs @@ -1,36 +1,87 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 服务渠道详情出参。 +/// public class ServiceChannelDetailOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 分组主键。 + /// public long? GroupId { get; set; } + /// + /// 分组名称。 + /// public string? GroupName { get; set; } + /// + /// 渠道编码。 + /// public string ChannelCode { get; set; } = string.Empty; + /// + /// 渠道名称。 + /// public string ChannelName { get; set; } = string.Empty; + /// + /// 最小时间。 + /// public int? MinTime { get; set; } + /// + /// 最大时间。 + /// public int? MaxTime { get; set; } + /// + /// 预报类型。 + /// public string? ForecastType { get; set; } + /// + /// 预报编码。 + /// public string? ForecastCode { get; set; } + /// + /// 描述。 + /// public string? Description { get; set; } + /// + /// 预处理脚本。 + /// public string? PreScript { get; set; } + /// + /// 是否启用。 + /// public byte IsActive { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 创建人。 + /// public string? CreateBy { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } + /// + /// 更新人。 + /// public string? UpdateBy { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/ServiceChannelListInput.cs b/src/Oms.Application/Dtos/Channels/ServiceChannelListInput.cs index 58f1e5f..5d0270f 100644 --- a/src/Oms.Application/Dtos/Channels/ServiceChannelListInput.cs +++ b/src/Oms.Application/Dtos/Channels/ServiceChannelListInput.cs @@ -3,7 +3,7 @@ using Oms.Domain.Shared.Enums; namespace Oms.Application.Dtos.Channels; /// -/// 服务渠道分页查询入参。 +/// 服务渠道列表查询入参。 /// public class ServiceChannelListInput { @@ -18,17 +18,17 @@ public class ServiceChannelListInput public int PageSize { get; set; } /// - /// 渠道组主键。 + /// 分组主键。 /// public long? GroupId { get; set; } /// - /// 关键字，匹配渠道编码或名称。 + /// 关键词。 /// public string? Keyword { get; set; } /// - /// 启用状态。 + /// 是否启用。 /// public EnableStatus? IsActive { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/ServiceChannelListOutput.cs b/src/Oms.Application/Dtos/Channels/ServiceChannelListOutput.cs index 47ad0ca..b210199 100644 --- a/src/Oms.Application/Dtos/Channels/ServiceChannelListOutput.cs +++ b/src/Oms.Application/Dtos/Channels/ServiceChannelListOutput.cs @@ -1,30 +1,72 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 服务渠道List出参。 +/// public class ServiceChannelListOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 分组主键。 + /// public long? GroupId { get; set; } + /// + /// 分组名称。 + /// public string? GroupName { get; set; } + /// + /// 渠道编码。 + /// public string ChannelCode { get; set; } = string.Empty; + /// + /// 渠道名称。 + /// public string ChannelName { get; set; } = string.Empty; + /// + /// 最小时间。 + /// public int? MinTime { get; set; } + /// + /// 最大时间。 + /// public int? MaxTime { get; set; } + /// + /// 预报类型。 + /// public string? ForecastType { get; set; } + /// + /// 预报编码。 + /// public string? ForecastCode { get; set; } + /// + /// 描述。 + /// public string? Description { get; set; } + /// + /// 是否启用。 + /// public byte IsActive { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/ServiceChannelPriceListOutput.cs b/src/Oms.Application/Dtos/Channels/ServiceChannelPriceListOutput.cs index 731fc27..d399f14 100644 --- a/src/Oms.Application/Dtos/Channels/ServiceChannelPriceListOutput.cs +++ b/src/Oms.Application/Dtos/Channels/ServiceChannelPriceListOutput.cs @@ -1,32 +1,77 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 服务渠道价格List出参。 +/// public class ServiceChannelPriceListOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 服务渠道主键。 + /// public long ServiceChannelId { get; set; } + /// + /// 序号。 + /// public int SerialNumber { get; set; } + /// + /// 状态。 + /// public byte Status { get; set; } + /// + /// 价格项名称。 + /// public string PriceName { get; set; } = string.Empty; + /// + /// 费用项目。 + /// public string CostItem { get; set; } = string.Empty; + /// + /// 计费单位。 + /// public string CostUnit { get; set; } = string.Empty; + /// + /// 币种。 + /// public string Currency { get; set; } = string.Empty; + /// + /// 计费时机。 + /// public string? ChargingTime { get; set; } + /// + /// 计费条件。 + /// public string? ChargingCondition { get; set; } + /// + /// 价格因子集合。 + /// public List Factors { get; set; } = []; + /// + /// 价格明细集合。 + /// public List Details { get; set; } = []; + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/ServiceChannelPriceSaveAllInput.cs b/src/Oms.Application/Dtos/Channels/ServiceChannelPriceSaveAllInput.cs index c98988a..b58cb08 100644 --- a/src/Oms.Application/Dtos/Channels/ServiceChannelPriceSaveAllInput.cs +++ b/src/Oms.Application/Dtos/Channels/ServiceChannelPriceSaveAllInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Channels; /// -/// 服务渠道买价批量保存入参。 +/// 服务渠道价格项批量保存入参。 /// public class ServiceChannelPriceSaveAllInput { @@ -11,12 +11,12 @@ public class ServiceChannelPriceSaveAllInput public long ServiceChannelId { get; set; } /// - /// 是否保存后立即发布。 + /// 是否发布。 /// public bool Publish { get; set; } /// - /// 买价项列表。 + /// 价格项集合。 /// public List Prices { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/Channels/ServiceChannelPriceSaveInput.cs b/src/Oms.Application/Dtos/Channels/ServiceChannelPriceSaveInput.cs index db701c4..110a366 100644 --- a/src/Oms.Application/Dtos/Channels/ServiceChannelPriceSaveInput.cs +++ b/src/Oms.Application/Dtos/Channels/ServiceChannelPriceSaveInput.cs @@ -3,12 +3,12 @@ using Oms.Domain.Shared.Enums; namespace Oms.Application.Dtos.Channels; /// -/// 服务渠道买价项保存入参。 +/// 服务渠道价格项保存入参。 /// public class ServiceChannelPriceSaveInput { /// - /// 买价项主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } @@ -18,22 +18,22 @@ public class ServiceChannelPriceSaveInput public long ServiceChannelId { get; set; } /// - /// 排序号。 + /// 序号。 /// public int SerialNumber { get; set; } /// - /// 买价项状态。 + /// 状态。 /// public EnableStatus Status { get; set; } /// - /// 买价项名称。 + /// 价格项名称。 /// public string PriceName { get; set; } = string.Empty; /// - /// 费用项编码。 + /// 费用项目。 /// public string CostItem { get; set; } = string.Empty; @@ -48,22 +48,22 @@ public class ServiceChannelPriceSaveInput public string Currency { get; set; } = string.Empty; /// - /// 收费时机。 + /// 计费时机。 /// public string? ChargingTime { get; set; } /// - /// 收费条件。 + /// 计费条件。 /// public string? ChargingCondition { get; set; } /// - /// 计费因子定义。 + /// 价格因子集合。 /// public List Factors { get; set; } = []; /// - /// 价格明细行。 + /// 价格明细集合。 /// public List Details { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/Channels/ServiceChannelPublishInput.cs b/src/Oms.Application/Dtos/Channels/ServiceChannelPublishInput.cs index 0108cd5..8377568 100644 --- a/src/Oms.Application/Dtos/Channels/ServiceChannelPublishInput.cs +++ b/src/Oms.Application/Dtos/Channels/ServiceChannelPublishInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Channels; /// -/// 服务渠道配置发布入参。 +/// 服务渠道发布入参。 /// public class ServiceChannelPublishInput { @@ -11,12 +11,12 @@ public class ServiceChannelPublishInput public long ServiceChannelId { get; set; } /// - /// 发布类型，支持 price 或 rules。 + /// 操作类型。 /// public string OperatorType { get; set; } = string.Empty; /// - /// 发布说明。 + /// 描述。 /// public string? Description { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/ServiceChannelPublishListInput.cs b/src/Oms.Application/Dtos/Channels/ServiceChannelPublishListInput.cs index 499e3e3..b66a695 100644 --- a/src/Oms.Application/Dtos/Channels/ServiceChannelPublishListInput.cs +++ b/src/Oms.Application/Dtos/Channels/ServiceChannelPublishListInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Channels; /// -/// 服务渠道发布记录分页查询入参。 +/// 服务渠道发布列表查询入参。 /// public class ServiceChannelPublishListInput { diff --git a/src/Oms.Application/Dtos/Channels/ServiceChannelPublishRecordOutput.cs b/src/Oms.Application/Dtos/Channels/ServiceChannelPublishRecordOutput.cs index 31582e4..dde0085 100644 --- a/src/Oms.Application/Dtos/Channels/ServiceChannelPublishRecordOutput.cs +++ b/src/Oms.Application/Dtos/Channels/ServiceChannelPublishRecordOutput.cs @@ -1,24 +1,57 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 服务渠道发布记录出参。 +/// public class ServiceChannelPublishRecordOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 服务渠道主键。 + /// public long ServiceChannelId { get; set; } + /// + /// 版本号。 + /// public string Version { get; set; } = string.Empty; + /// + /// 操作类型。 + /// public string OperatorType { get; set; } = string.Empty; + /// + /// 状态。 + /// public string Status { get; set; } = string.Empty; + /// + /// 发布人。 + /// public string PublishUser { get; set; } = string.Empty; + /// + /// 发布时间。 + /// public DateTime PublishTime { get; set; } + /// + /// 描述。 + /// public string? Description { get; set; } + /// + /// 内容。 + /// public object? Content { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/ServiceChannelRollbackInput.cs b/src/Oms.Application/Dtos/Channels/ServiceChannelRollbackInput.cs index 9044d48..5235af3 100644 --- a/src/Oms.Application/Dtos/Channels/ServiceChannelRollbackInput.cs +++ b/src/Oms.Application/Dtos/Channels/ServiceChannelRollbackInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Channels; /// -/// 服务渠道配置回滚入参。 +/// 服务渠道回滚入参。 /// public class ServiceChannelRollbackInput { @@ -11,12 +11,12 @@ public class ServiceChannelRollbackInput public long ServiceChannelId { get; set; } /// - /// 发布记录主键。 + /// 记录主键。 /// public long RecordId { get; set; } /// - /// 回滚类型，支持 price 或 rules。 + /// 操作类型。 /// public string OperatorType { get; set; } = string.Empty; } diff --git a/src/Oms.Application/Dtos/Channels/ServiceChannelSaveInput.cs b/src/Oms.Application/Dtos/Channels/ServiceChannelSaveInput.cs index 49cbe69..de93abb 100644 --- a/src/Oms.Application/Dtos/Channels/ServiceChannelSaveInput.cs +++ b/src/Oms.Application/Dtos/Channels/ServiceChannelSaveInput.cs @@ -8,12 +8,12 @@ namespace Oms.Application.Dtos.Channels; public class ServiceChannelSaveInput { /// - /// 渠道主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } /// - /// 渠道组主键。 + /// 分组主键。 /// public long? GroupId { get; set; } @@ -28,27 +28,27 @@ public class ServiceChannelSaveInput public string ChannelName { get; set; } = string.Empty; /// - /// 最小时效。 + /// 最小时间。 /// public int? MinTime { get; set; } /// - /// 最大时效。 + /// 最大时间。 /// public int? MaxTime { get; set; } /// - /// 预报单号类型。 + /// 预报类型。 /// public string? ForecastType { get; set; } /// - /// 预报编码或表达式。 + /// 预报编码。 /// public string? ForecastCode { get; set; } /// - /// 渠道描述。 + /// 描述。 /// public string? Description { get; set; } diff --git a/src/Oms.Application/Dtos/Channels/WeightRoundingInfoListInput.cs b/src/Oms.Application/Dtos/Channels/WeightRoundingInfoListInput.cs index 7e39486..ec6ddbb 100644 --- a/src/Oms.Application/Dtos/Channels/WeightRoundingInfoListInput.cs +++ b/src/Oms.Application/Dtos/Channels/WeightRoundingInfoListInput.cs @@ -1,12 +1,12 @@ namespace Oms.Application.Dtos.Channels; /// -/// 计重进位明细分页查询入参。 +/// 计重进位规则明细列表查询入参。 /// public class WeightRoundingInfoListInput { /// - /// 计重进位主键。 + /// 进位主键。 /// public long RoundingId { get; set; } diff --git a/src/Oms.Application/Dtos/Channels/WeightRoundingInfoOutput.cs b/src/Oms.Application/Dtos/Channels/WeightRoundingInfoOutput.cs index 9a2bb7e..e41370b 100644 --- a/src/Oms.Application/Dtos/Channels/WeightRoundingInfoOutput.cs +++ b/src/Oms.Application/Dtos/Channels/WeightRoundingInfoOutput.cs @@ -1,22 +1,52 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 计重进位规则明细出参。 +/// public class WeightRoundingInfoOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 进位主键。 + /// public long RoundingId { get; set; } + /// + /// 起始值。 + /// public decimal StartValue { get; set; } + /// + /// 结束值。 + /// public decimal EndValue { get; set; } + /// + /// 是否公开。 + /// public string? Public { get; set; } + /// + /// 客户分组一。 + /// public string? CustomerGroup1 { get; set; } + /// + /// 客户分组二。 + /// public string? CustomerGroup2 { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/WeightRoundingInfoSaveInput.cs b/src/Oms.Application/Dtos/Channels/WeightRoundingInfoSaveInput.cs index 85f86d7..3babb9b 100644 --- a/src/Oms.Application/Dtos/Channels/WeightRoundingInfoSaveInput.cs +++ b/src/Oms.Application/Dtos/Channels/WeightRoundingInfoSaveInput.cs @@ -1,42 +1,42 @@ namespace Oms.Application.Dtos.Channels; /// -/// 计重进位明细保存入参。 +/// 计重进位规则明细保存入参。 /// public class WeightRoundingInfoSaveInput { /// - /// 明细主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } /// - /// 计重进位主键。 + /// 进位主键。 /// public long RoundingId { get; set; } /// - /// 起始重量。 + /// 起始值。 /// public decimal StartValue { get; set; } /// - /// 结束重量。 + /// 结束值。 /// public decimal EndValue { get; set; } /// - /// 公共进位值。 + /// 是否公开。 /// public string? Public { get; set; } /// - /// 客户组 1 进位值。 + /// 客户分组一。 /// public string? CustomerGroup1 { get; set; } /// - /// 客户组 2 进位值。 + /// 客户分组二。 /// public string? CustomerGroup2 { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/WeightRoundingListInput.cs b/src/Oms.Application/Dtos/Channels/WeightRoundingListInput.cs index 3e7c682..d990ce0 100644 --- a/src/Oms.Application/Dtos/Channels/WeightRoundingListInput.cs +++ b/src/Oms.Application/Dtos/Channels/WeightRoundingListInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Channels; /// -/// 计重进位分页查询入参。 +/// 计重进位规则列表查询入参。 /// public class WeightRoundingListInput { diff --git a/src/Oms.Application/Dtos/Channels/WeightRoundingOutput.cs b/src/Oms.Application/Dtos/Channels/WeightRoundingOutput.cs index 436dd23..78b9e64 100644 --- a/src/Oms.Application/Dtos/Channels/WeightRoundingOutput.cs +++ b/src/Oms.Application/Dtos/Channels/WeightRoundingOutput.cs @@ -1,14 +1,32 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 计重进位规则出参。 +/// public class WeightRoundingOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 应用标识。 + /// public string AppKey { get; set; } = string.Empty; + /// + /// 名称。 + /// public string Name { get; set; } = string.Empty; + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/WeightRoundingSaveInput.cs b/src/Oms.Application/Dtos/Channels/WeightRoundingSaveInput.cs index 2ff0ca6..da08bb1 100644 --- a/src/Oms.Application/Dtos/Channels/WeightRoundingSaveInput.cs +++ b/src/Oms.Application/Dtos/Channels/WeightRoundingSaveInput.cs @@ -1,12 +1,12 @@ namespace Oms.Application.Dtos.Channels; /// -/// 计重进位保存入参。 +/// 计重进位规则保存入参。 /// public class WeightRoundingSaveInput { /// - /// 计重进位主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } @@ -16,7 +16,7 @@ public class WeightRoundingSaveInput public string AppKey { get; set; } = string.Empty; /// - /// 规则名称。 + /// 名称。 /// public string Name { get; set; } = string.Empty; } diff --git a/src/Oms.Application/Dtos/Channels/WeightRuleInfoListInput.cs b/src/Oms.Application/Dtos/Channels/WeightRuleInfoListInput.cs index 7b7d492..a85a934 100644 --- a/src/Oms.Application/Dtos/Channels/WeightRuleInfoListInput.cs +++ b/src/Oms.Application/Dtos/Channels/WeightRuleInfoListInput.cs @@ -1,12 +1,12 @@ namespace Oms.Application.Dtos.Channels; /// -/// 计重规则明细分页查询入参。 +/// 计重规则明细列表查询入参。 /// public class WeightRuleInfoListInput { /// - /// 计重规则主键。 + /// 规则主键。 /// public long RuleId { get; set; } diff --git a/src/Oms.Application/Dtos/Channels/WeightRuleInfoOutput.cs b/src/Oms.Application/Dtos/Channels/WeightRuleInfoOutput.cs index 34c2f2b..ae7d832 100644 --- a/src/Oms.Application/Dtos/Channels/WeightRuleInfoOutput.cs +++ b/src/Oms.Application/Dtos/Channels/WeightRuleInfoOutput.cs @@ -1,20 +1,47 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 计重规则明细出参。 +/// public class WeightRuleInfoOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 规则主键。 + /// public long RuleId { get; set; } + /// + /// Client。 + /// public string Client { get; set; } = string.Empty; + /// + /// Condition。 + /// public string Condition { get; set; } = string.Empty; + /// + /// 计费重量。 + /// public string BillableWeight { get; set; } = string.Empty; + /// + /// 体积系数。 + /// public string VolumetricFactor { get; set; } = string.Empty; + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/WeightRuleInfoSaveInput.cs b/src/Oms.Application/Dtos/Channels/WeightRuleInfoSaveInput.cs index a42e437..3595800 100644 --- a/src/Oms.Application/Dtos/Channels/WeightRuleInfoSaveInput.cs +++ b/src/Oms.Application/Dtos/Channels/WeightRuleInfoSaveInput.cs @@ -6,32 +6,32 @@ namespace Oms.Application.Dtos.Channels; public class WeightRuleInfoSaveInput { /// - /// 明细主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } /// - /// 计重规则主键。 + /// 规则主键。 /// public long RuleId { get; set; } /// - /// 客户范围，例如公共、客户组1。 + /// Client。 /// public string Client { get; set; } = string.Empty; /// - /// 条件表达式。 + /// Condition。 /// public string Condition { get; set; } = string.Empty; /// - /// 计费重取值表达式。 + /// 计费重量。 /// public string BillableWeight { get; set; } = string.Empty; /// - /// 材积系数。 + /// 体积系数。 /// public string VolumetricFactor { get; set; } = string.Empty; } diff --git a/src/Oms.Application/Dtos/Channels/WeightRuleListInput.cs b/src/Oms.Application/Dtos/Channels/WeightRuleListInput.cs index 8c121a6..38b5317 100644 --- a/src/Oms.Application/Dtos/Channels/WeightRuleListInput.cs +++ b/src/Oms.Application/Dtos/Channels/WeightRuleListInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Channels; /// -/// 计重规则分页查询入参。 +/// 计重规则列表查询入参。 /// public class WeightRuleListInput { diff --git a/src/Oms.Application/Dtos/Channels/WeightRuleOutput.cs b/src/Oms.Application/Dtos/Channels/WeightRuleOutput.cs index e8a083f..9e3df2f 100644 --- a/src/Oms.Application/Dtos/Channels/WeightRuleOutput.cs +++ b/src/Oms.Application/Dtos/Channels/WeightRuleOutput.cs @@ -1,14 +1,32 @@ namespace Oms.Application.Dtos.Channels; +/// +/// 计重规则出参。 +/// public class WeightRuleOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 应用标识。 + /// public string AppKey { get; set; } = string.Empty; + /// + /// 名称。 + /// public string Name { get; set; } = string.Empty; + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Channels/WeightRuleSaveInput.cs b/src/Oms.Application/Dtos/Channels/WeightRuleSaveInput.cs index 509fc45..5c93275 100644 --- a/src/Oms.Application/Dtos/Channels/WeightRuleSaveInput.cs +++ b/src/Oms.Application/Dtos/Channels/WeightRuleSaveInput.cs @@ -6,7 +6,7 @@ namespace Oms.Application.Dtos.Channels; public class WeightRuleSaveInput { /// - /// 计重规则主键，新增时可不传。 + /// 主键。 /// public long? Id { get; set; } @@ -16,7 +16,7 @@ public class WeightRuleSaveInput public string AppKey { get; set; } = string.Empty; /// - /// 规则名称。 + /// 名称。 /// public string Name { get; set; } = string.Empty; } diff --git a/src/Oms.Application/Dtos/Customers/CreateCustomerInput.cs b/src/Oms.Application/Dtos/Customers/CreateCustomerInput.cs index 3b327c9..30ef744 100644 --- a/src/Oms.Application/Dtos/Customers/CreateCustomerInput.cs +++ b/src/Oms.Application/Dtos/Customers/CreateCustomerInput.cs @@ -3,33 +3,63 @@ using Oms.Domain.CustomersAggregate.Enums; namespace Oms.Application.Dtos.Customers; +/// +/// 创建客户入参。 +/// public class CreateCustomerInput { [Required] [StringLength(16)] + /// + /// 手机号。 + /// public string Phone { get; set; } = string.Empty; [EmailAddress] [StringLength(64)] + /// + /// 邮箱。 + /// public string? Email { get; set; } [Required] [StringLength(64)] + /// + /// 密码。 + /// public string Password { get; set; } = string.Empty; [Range(typeof(decimal), "0", "999999999999")] + /// + /// 总额度。 + /// public decimal TotalQuota { get; set; } + /// + /// 状态。 + /// public CustomerStatus Status { get; set; } = CustomerStatus.Normal; [StringLength(512)] + /// + /// 备注。 + /// public string? Remark { get; set; } [StringLength(32)] + /// + /// 销售人员。 + /// public string? Salesman { get; set; } [StringLength(32)] + /// + /// 客服人员。 + /// public string? CustomerService { get; set; } + /// + /// 客户分组。 + /// public CustomerGroup? CustomerGroup { get; set; } } diff --git a/src/Oms.Application/Dtos/Customers/CustomerOutput.cs b/src/Oms.Application/Dtos/Customers/CustomerOutput.cs index 6a8483d..0daed14 100644 --- a/src/Oms.Application/Dtos/Customers/CustomerOutput.cs +++ b/src/Oms.Application/Dtos/Customers/CustomerOutput.cs @@ -2,47 +2,113 @@ using Oms.Domain.CustomersAggregate.Enums; namespace Oms.Application.Dtos.Customers; +/// +/// 客户出参。 +/// public class CustomerOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 客户编码。 + /// public string CustomerCode { get; set; } = string.Empty; + /// + /// WechatAvatar。 + /// public string? WechatAvatar { get; set; } + /// + /// WechatNickname。 + /// public string? WechatNickname { get; set; } + /// + /// 邮箱。 + /// public string? Email { get; set; } + /// + /// 手机号。 + /// public string Phone { get; set; } = string.Empty; + /// + /// 余额。 + /// public decimal Balance { get; set; } + /// + /// 总额度。 + /// public decimal TotalQuota { get; set; } + /// + /// 已用额度。 + /// public decimal UsedQuota { get; set; } + /// + /// 状态。 + /// public CustomerStatus Status { get; set; } + /// + /// 备注。 + /// public string? Remark { get; set; } + /// + /// 销售人员。 + /// public string? Salesman { get; set; } + /// + /// 客服人员。 + /// public string? CustomerService { get; set; } + /// + /// 客户分组。 + /// public CustomerGroup? CustomerGroup { get; set; } + /// + /// 角色。 + /// public string? Role { get; set; } + /// + /// 最后登录 IP。 + /// public string? LastLoginIp { get; set; } + /// + /// 最后登录时间。 + /// public DateTime? LastLoginTime { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 创建人。 + /// public string? CreateBy { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } + /// + /// 更新人。 + /// public string? UpdateBy { get; set; } } diff --git a/src/Oms.Application/Dtos/Customers/CustomerPaginatedInput.cs b/src/Oms.Application/Dtos/Customers/CustomerPaginatedInput.cs index 3f6b8b8..938c1b8 100644 --- a/src/Oms.Application/Dtos/Customers/CustomerPaginatedInput.cs +++ b/src/Oms.Application/Dtos/Customers/CustomerPaginatedInput.cs @@ -2,19 +2,43 @@ using Oms.Domain.CustomersAggregate.Enums; namespace Oms.Application.Dtos.Customers; +/// +/// 客户分页查询入参。 +/// public class CustomerPaginatedInput { + /// + /// 页码，从 1 开始。 + /// public int Page { get; set; } = 1; + /// + /// 每页条数。 + /// public int PageSize { get; set; } = 20; + /// + /// 关键词。 + /// public string? Keyword { get; set; } + /// + /// 状态。 + /// public CustomerStatus? Status { get; set; } + /// + /// 客户分组。 + /// public CustomerGroup? CustomerGroup { get; set; } + /// + /// 销售人员。 + /// public string? Salesman { get; set; } + /// + /// 客服人员。 + /// public string? CustomerService { get; set; } } diff --git a/src/Oms.Application/Dtos/Customers/CustomerPaginatedOutput.cs b/src/Oms.Application/Dtos/Customers/CustomerPaginatedOutput.cs index 9ed0168..9b914b6 100644 --- a/src/Oms.Application/Dtos/Customers/CustomerPaginatedOutput.cs +++ b/src/Oms.Application/Dtos/Customers/CustomerPaginatedOutput.cs @@ -2,41 +2,98 @@ using Oms.Domain.CustomersAggregate.Enums; namespace Oms.Application.Dtos.Customers; +/// +/// 客户分页列表项出参。 +/// public class CustomerPaginatedOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 客户编码。 + /// public string CustomerCode { get; set; } = string.Empty; + /// + /// WechatAvatar。 + /// public string? WechatAvatar { get; set; } + /// + /// WechatNickname。 + /// public string? WechatNickname { get; set; } + /// + /// 邮箱。 + /// public string? Email { get; set; } + /// + /// 手机号。 + /// public string Phone { get; set; } = string.Empty; + /// + /// 余额。 + /// public decimal Balance { get; set; } + /// + /// 总额度。 + /// public decimal TotalQuota { get; set; } + /// + /// 已用额度。 + /// public decimal UsedQuota { get; set; } + /// + /// 状态。 + /// public CustomerStatus Status { get; set; } + /// + /// 备注。 + /// public string? Remark { get; set; } + /// + /// 销售人员。 + /// public string? Salesman { get; set; } + /// + /// 客服人员。 + /// public string? CustomerService { get; set; } + /// + /// 客户分组。 + /// public CustomerGroup? CustomerGroup { get; set; } + /// + /// 最后登录 IP。 + /// public string? LastLoginIp { get; set; } + /// + /// 最后登录时间。 + /// public DateTime? LastLoginTime { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Customers/ResetCustomerPasswordInput.cs b/src/Oms.Application/Dtos/Customers/ResetCustomerPasswordInput.cs index e8ef209..9665e4b 100644 --- a/src/Oms.Application/Dtos/Customers/ResetCustomerPasswordInput.cs +++ b/src/Oms.Application/Dtos/Customers/ResetCustomerPasswordInput.cs @@ -2,12 +2,21 @@ using System.ComponentModel.DataAnnotations; namespace Oms.Application.Dtos.Customers; +/// +/// 重置客户密码入参。 +/// public class ResetCustomerPasswordInput { [Required] + /// + /// 主键。 + /// public long Id { get; set; } [Required] [StringLength(64)] + /// + /// 新密码。 + /// public string NewPassword { get; set; } = string.Empty; } diff --git a/src/Oms.Application/Dtos/Customers/UpdateCustomerInput.cs b/src/Oms.Application/Dtos/Customers/UpdateCustomerInput.cs index 533ccdb..5a0cab0 100644 --- a/src/Oms.Application/Dtos/Customers/UpdateCustomerInput.cs +++ b/src/Oms.Application/Dtos/Customers/UpdateCustomerInput.cs @@ -3,28 +3,55 @@ using Oms.Domain.CustomersAggregate.Enums; namespace Oms.Application.Dtos.Customers; +/// +/// 更新客户入参。 +/// public class UpdateCustomerInput { [Required] + /// + /// 主键。 + /// public long Id { get; set; } [EmailAddress] [StringLength(64)] + /// + /// 邮箱。 + /// public string? Email { get; set; } [Range(typeof(decimal), "0", "999999999999")] + /// + /// 总额度。 + /// public decimal TotalQuota { get; set; } + /// + /// 状态。 + /// public CustomerStatus Status { get; set; } = CustomerStatus.Normal; [StringLength(512)] + /// + /// 备注。 + /// public string? Remark { get; set; } [StringLength(32)] + /// + /// 销售人员。 + /// public string? Salesman { get; set; } [StringLength(32)] + /// + /// 客服人员。 + /// public string? CustomerService { get; set; } + /// + /// 客户分组。 + /// public CustomerGroup? CustomerGroup { get; set; } } diff --git a/src/Oms.Application/Dtos/Operations/CreateInboundRecordInput.cs b/src/Oms.Application/Dtos/Operations/CreateInboundRecordInput.cs index d80dce3..ce67596 100644 --- a/src/Oms.Application/Dtos/Operations/CreateInboundRecordInput.cs +++ b/src/Oms.Application/Dtos/Operations/CreateInboundRecordInput.cs @@ -2,24 +2,51 @@ using System.ComponentModel.DataAnnotations; namespace Oms.Application.Dtos.Operations; +/// +/// 创建入库记录入参。 +/// public class CreateInboundRecordInput { [Required] [StringLength(64)] + /// + /// 运单号。 + /// public string WaybillNo { get; set; } = string.Empty; + /// + /// 重量。 + /// public decimal? Weight { get; set; } + /// + /// 长度。 + /// public decimal? Length { get; set; } + /// + /// 宽度。 + /// public decimal? Width { get; set; } + /// + /// 高度。 + /// public decimal? Height { get; set; } + /// + /// 销售产品主键。 + /// public long? SalesProductId { get; set; } [StringLength(8)] + /// + /// 目的国家/地区。 + /// public string? DestinationCountry { get; set; } + /// + /// 仓库主键。 + /// public long? WarehouseId { get; set; } } diff --git a/src/Oms.Application/Dtos/Operations/CreateOutboundRecordInput.cs b/src/Oms.Application/Dtos/Operations/CreateOutboundRecordInput.cs index f5111df..8fa4ae0 100644 --- a/src/Oms.Application/Dtos/Operations/CreateOutboundRecordInput.cs +++ b/src/Oms.Application/Dtos/Operations/CreateOutboundRecordInput.cs @@ -2,11 +2,20 @@ using System.ComponentModel.DataAnnotations; namespace Oms.Application.Dtos.Operations; +/// +/// 创建出库记录入参。 +/// public class CreateOutboundRecordInput { [Required] [StringLength(64)] + /// + /// 运单号。 + /// public string WaybillNo { get; set; } = string.Empty; + /// + /// 仓库主键。 + /// public long? WarehouseId { get; set; } } diff --git a/src/Oms.Application/Dtos/Operations/InboundRecordOutput.cs b/src/Oms.Application/Dtos/Operations/InboundRecordOutput.cs index 603f5f2..f0ffcd2 100644 --- a/src/Oms.Application/Dtos/Operations/InboundRecordOutput.cs +++ b/src/Oms.Application/Dtos/Operations/InboundRecordOutput.cs @@ -1,34 +1,82 @@ namespace Oms.Application.Dtos.Operations; +/// +/// 入库记录出参。 +/// public class InboundRecordOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 运单号。 + /// public string WaybillNo { get; set; } = string.Empty; + /// + /// 重量。 + /// public decimal? Weight { get; set; } + /// + /// 长度。 + /// public decimal? Length { get; set; } + /// + /// 宽度。 + /// public decimal? Width { get; set; } + /// + /// 高度。 + /// public decimal? Height { get; set; } + /// + /// 销售产品主键。 + /// public long? SalesProductId { get; set; } + /// + /// 销售产品名称。 + /// public string? SalesProductName { get; set; } + /// + /// 目的国家/地区。 + /// public string? DestinationCountry { get; set; } + /// + /// 仓库主键。 + /// public long? WarehouseId { get; set; } + /// + /// 仓库名称。 + /// public string? WarehouseName { get; set; } + /// + /// 操作时间。 + /// public DateTime OperateTime { get; set; } + /// + /// 操作人主键。 + /// public long? OperatorId { get; set; } + /// + /// 操作人名称。 + /// public string? OperatorName { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Operations/LabelPrintRecordOutput.cs b/src/Oms.Application/Dtos/Operations/LabelPrintRecordOutput.cs index 56b1fea..859e5ef 100644 --- a/src/Oms.Application/Dtos/Operations/LabelPrintRecordOutput.cs +++ b/src/Oms.Application/Dtos/Operations/LabelPrintRecordOutput.cs @@ -2,29 +2,68 @@ using Oms.Domain.Shared.Enums; namespace Oms.Application.Dtos.Operations; +/// +/// 面单打印记录出参。 +/// public class LabelPrintRecordOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 运单号。 + /// public string WaybillNo { get; set; } = string.Empty; + /// + /// 客户订单号。 + /// public string? CustomerOrderNo { get; set; } + /// + /// 追踪号。 + /// public string? TrackingNo { get; set; } + /// + /// 其他号码。 + /// public string? OtherNumber { get; set; } + /// + /// 标签模板主键。 + /// public long? LabelTemplateId { get; set; } + /// + /// 标签模板名称。 + /// public string? LabelTemplateName { get; set; } + /// + /// 打印是否成功。 + /// public EnableStatus PrintSuccess { get; set; } + /// + /// 打印时间。 + /// public DateTime PrintTime { get; set; } + /// + /// 操作人主键。 + /// public long? OperatorId { get; set; } + /// + /// 操作人名称。 + /// public string? OperatorName { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Operations/LabelTemplateDropdownOutput.cs b/src/Oms.Application/Dtos/Operations/LabelTemplateDropdownOutput.cs index ecbf7b9..711ae64 100644 --- a/src/Oms.Application/Dtos/Operations/LabelTemplateDropdownOutput.cs +++ b/src/Oms.Application/Dtos/Operations/LabelTemplateDropdownOutput.cs @@ -1,16 +1,37 @@ namespace Oms.Application.Dtos.Operations; +/// +/// 标签模板出参。 +/// public class LabelTemplateDropdownOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 名称。 + /// public string Name { get; set; } = string.Empty; + /// + /// 模板类型。 + /// public string? TemplateType { get; set; } + /// + /// 模板 JSON。 + /// public object? TemplateJson { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Operations/OutboundRecordOutput.cs b/src/Oms.Application/Dtos/Operations/OutboundRecordOutput.cs index c2120c3..5520ee1 100644 --- a/src/Oms.Application/Dtos/Operations/OutboundRecordOutput.cs +++ b/src/Oms.Application/Dtos/Operations/OutboundRecordOutput.cs @@ -1,20 +1,47 @@ namespace Oms.Application.Dtos.Operations; +/// +/// 出库记录出参。 +/// public class OutboundRecordOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 运单号。 + /// public string WaybillNo { get; set; } = string.Empty; + /// + /// 仓库主键。 + /// public long? WarehouseId { get; set; } + /// + /// 仓库名称。 + /// public string? WarehouseName { get; set; } + /// + /// 操作时间。 + /// public DateTime OperateTime { get; set; } + /// + /// 操作人主键。 + /// public long? OperatorId { get; set; } + /// + /// 操作人名称。 + /// public string? OperatorName { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Operations/PrintLabelInput.cs b/src/Oms.Application/Dtos/Operations/PrintLabelInput.cs index 77f8f78..7fb7a5e 100644 --- a/src/Oms.Application/Dtos/Operations/PrintLabelInput.cs +++ b/src/Oms.Application/Dtos/Operations/PrintLabelInput.cs @@ -2,17 +2,32 @@ using System.ComponentModel.DataAnnotations; namespace Oms.Application.Dtos.Operations; +/// +/// 面单打印入参。 +/// public class PrintLabelInput { [Required] [StringLength(64)] + /// + /// 单号值。 + /// public string Number { get; set; } = string.Empty; [StringLength(64)] + /// + /// 单号类型。 + /// public string? NumberType { get; set; } [StringLength(64)] + /// + /// 模板类型。 + /// public string? TemplateType { get; set; } + /// + /// 标签模板主键。 + /// public long? LabelTemplateId { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderActionInput.cs b/src/Oms.Application/Dtos/Orders/OrderActionInput.cs index 1fadace..56f48bf 100644 --- a/src/Oms.Application/Dtos/Orders/OrderActionInput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderActionInput.cs @@ -2,11 +2,20 @@ using System.ComponentModel.DataAnnotations; namespace Oms.Application.Dtos.Orders; +/// +/// 订单入参。 +/// public class OrderActionInput { [Required] + /// + /// 主键。 + /// public long Id { get; set; } [StringLength(64)] + /// + /// 请求标识。 + /// public string? RequestId { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderExportInput.cs b/src/Oms.Application/Dtos/Orders/OrderExportInput.cs index 8264eb0..bbd95e8 100644 --- a/src/Oms.Application/Dtos/Orders/OrderExportInput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderExportInput.cs @@ -6,22 +6,22 @@ namespace Oms.Application.Dtos.Orders; public class OrderExportInput { /// - /// 订单状态，传 all 或空值时表示不过滤。 + /// 状态。 /// public string? Status { get; set; } /// - /// 关键词，可匹配运单号、客户单号、跟踪号。 + /// 关键词。 /// public string? Keyword { get; set; } /// - /// 创建时间起始值。 + /// 创建TimeStart。 /// public DateTime? CreateTimeStart { get; set; } /// - /// 创建时间结束值。 + /// 创建TimeEnd。 /// public DateTime? CreateTimeEnd { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderExportOutput.cs b/src/Oms.Application/Dtos/Orders/OrderExportOutput.cs index 44368ef..98e92ce 100644 --- a/src/Oms.Application/Dtos/Orders/OrderExportOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderExportOutput.cs @@ -1,8 +1,17 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单导出结果出参。 +/// public class OrderExportOutput { + /// + /// 下载地址。 + /// public string DownloadUrl { get; set; } = string.Empty; + /// + /// 过期时间。 + /// public DateTime ExpireAt { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderItemOutput.cs b/src/Oms.Application/Dtos/Orders/OrderItemOutput.cs index fcbecf2..6b4c374 100644 --- a/src/Oms.Application/Dtos/Orders/OrderItemOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderItemOutput.cs @@ -1,54 +1,132 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单内件出参。 +/// public class OrderItemOutput { + /// + /// 中文名称。 + /// public string? CnName { get; set; } + /// + /// 英文名称。 + /// public string? EnName { get; set; } + /// + /// SKU。 + /// public string? Sku { get; set; } + /// + /// 单位。 + /// public string? Unit { get; set; } + /// + /// 单价。 + /// public decimal? UnitPrice { get; set; } + /// + /// 单件重量。 + /// public decimal? UnitWeight { get; set; } + /// + /// 数量。 + /// public int? Quantity { get; set; } + /// + /// 金额。 + /// public decimal? Amount { get; set; } + /// + /// 重量。 + /// public decimal? Weight { get; set; } + /// + /// HS 编码。 + /// public string? HsCode { get; set; } + /// + /// SKU 图片。 + /// public string? SkuImage { get; set; } + /// + /// 品类。 + /// public string? Category { get; set; } + /// + /// 品牌。 + /// public string? Brand { get; set; } + /// + /// 品牌类型。 + /// public string? BrandType { get; set; } + /// + /// 是否带磁。 + /// public bool IsMagnetic { get; set; } + /// + /// 配货方式。 + /// public string? Distribution { get; set; } + /// + /// 材质。 + /// public string? Material { get; set; } + /// + /// 英文材质。 + /// public string? EnMaterial { get; set; } + /// + /// 用途。 + /// public string? Purpose { get; set; } + /// + /// 属性集合。 + /// public string? Attributes { get; set; } + /// + /// 原产国。 + /// public string? OriginCountry { get; set; } + /// + /// 销售链接。 + /// public string? SalesLink { get; set; } + /// + /// 型号。 + /// public string? Model { get; set; } + /// + /// 规格。 + /// public string? Specifications { get; set; } + /// + /// 备注说明。 + /// public string? Comment { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderOutput.cs b/src/Oms.Application/Dtos/Orders/OrderOutput.cs index d089b68..786d118 100644 --- a/src/Oms.Application/Dtos/Orders/OrderOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderOutput.cs @@ -1,62 +1,152 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单出参。 +/// public class OrderOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 客户单号。 + /// public string? ClientNo { get; set; } + /// + /// 跟踪号。 + /// public string? TrackNo { get; set; } + /// + /// 服务单号。 + /// public string ServiceNo { get; set; } = string.Empty; + /// + /// 产品编码。 + /// public string? ProductCode { get; set; } + /// + /// 渠道编码。 + /// public string? ChannelCode { get; set; } + /// + /// 货物属性。 + /// public string? CargoAttribute { get; set; } + /// + /// 仓库主键。 + /// public long? WarehouseId { get; set; } + /// + /// 仓库名称。 + /// public string? Warehouse { get; set; } + /// + /// 客户主键。 + /// public long? CustomerId { get; set; } + /// + /// 是否 COD。 + /// public bool IsCod { get; set; } + /// + /// COD 币种。 + /// public string? CodCurrency { get; set; } + /// + /// COD 金额。 + /// public decimal? CodSum { get; set; } + /// + /// 订单状态名称。 + /// public string? OrderStatus { get; set; } + /// + /// 状态。 + /// public string Status { get; set; } = string.Empty; + /// + /// 收货时间。 + /// public DateTime? ReceiveTime { get; set; } + /// + /// 发货时间。 + /// public DateTime? ShipTime { get; set; } + /// + /// 支付时间。 + /// public DateTime? PayTime { get; set; } + /// + /// 签收时间。 + /// public DateTime? SignTime { get; set; } + /// + /// 是否拦截。 + /// public bool IsIntercept { get; set; } + /// + /// 是否偏远。 + /// public bool IsRemote { get; set; } + /// + /// 创建时间。 + /// public DateTime? CreateTime { get; set; } + /// + /// 创建人。 + /// public string? CreateBy { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } + /// + /// 更新人。 + /// public string? UpdateBy { get; set; } + /// + /// 寄件人信息。 + /// public OrderSenderOutput? Sender { get; set; } + /// + /// 收件人信息。 + /// public OrderReceiverOutput? Receiver { get; set; } + /// + /// 订单内件集合。 + /// public List Items { get; set; } = []; + /// + /// 重量明细集合。 + /// public List WeightList { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/Orders/OrderPaginatedInput.cs b/src/Oms.Application/Dtos/Orders/OrderPaginatedInput.cs index 4aacae7..45f6c35 100644 --- a/src/Oms.Application/Dtos/Orders/OrderPaginatedInput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderPaginatedInput.cs @@ -1,7 +1,7 @@ namespace Oms.Application.Dtos.Orders; /// -/// 订单列表分页查询入参。 +/// 订单分页查询入参。 /// public class OrderPaginatedInput { @@ -16,22 +16,22 @@ public class OrderPaginatedInput public int PageSize { get; set; } = 20; /// - /// 订单状态，传 all 或空值时表示不过滤。 + /// 状态。 /// public string? Status { get; set; } /// - /// 关键词，可匹配运单号、客户单号、跟踪号。 + /// 关键词。 /// public string? Keyword { get; set; } /// - /// 创建时间起始值。 + /// 创建TimeStart。 /// public DateTime? CreateTimeStart { get; set; } /// - /// 创建时间结束值。 + /// 创建TimeEnd。 /// public DateTime? CreateTimeEnd { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderPaginatedOutput.cs b/src/Oms.Application/Dtos/Orders/OrderPaginatedOutput.cs index 568d0f7..b172bbd 100644 --- a/src/Oms.Application/Dtos/Orders/OrderPaginatedOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderPaginatedOutput.cs @@ -1,50 +1,122 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单分页列表项出参。 +/// public class OrderPaginatedOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 服务单号。 + /// public string ServiceNo { get; set; } = string.Empty; + /// + /// 客户单号。 + /// public string? ClientNo { get; set; } + /// + /// 跟踪号。 + /// public string? TrackNo { get; set; } + /// + /// 产品编码。 + /// public string? ProductCode { get; set; } + /// + /// 渠道编码。 + /// public string? ChannelCode { get; set; } + /// + /// 收件国家/地区。 + /// public string? ConsigneeCountry { get; set; } + /// + /// 货物属性。 + /// public string? CargoAttribute { get; set; } + /// + /// 订单状态名称。 + /// public string OrderStatus { get; set; } = string.Empty; + /// + /// 仓库主键。 + /// public long? WarehouseId { get; set; } + /// + /// 仓库名称。 + /// public string? WarehouseName { get; set; } + /// + /// 客户主键。 + /// public long? CustomerId { get; set; } + /// + /// 收货时间。 + /// public DateTime? ReceiveTime { get; set; } + /// + /// 发货时间。 + /// public DateTime? ShipTime { get; set; } + /// + /// 支付时间。 + /// public DateTime? PayTime { get; set; } + /// + /// 签收时间。 + /// public DateTime? SignTime { get; set; } + /// + /// 是否 COD。 + /// public byte IsCod { get; set; } + /// + /// COD 币种。 + /// public string? CodCurrency { get; set; } + /// + /// COD 金额。 + /// public decimal? CodSum { get; set; } + /// + /// 是否拦截。 + /// public byte IsIntercept { get; set; } + /// + /// 是否偏远。 + /// public byte IsRemote { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderParcelCreateInput.cs b/src/Oms.Application/Dtos/Orders/OrderParcelCreateInput.cs index 4f874e2..2c1b17c 100644 --- a/src/Oms.Application/Dtos/Orders/OrderParcelCreateInput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderParcelCreateInput.cs @@ -1,54 +1,132 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单包裹入参。 +/// public class OrderParcelCreateInput { + /// + /// 请求标识。 + /// public string? RequestId { get; set; } + /// + /// 客户单号。 + /// public string? ClientNo { get; set; } + /// + /// 跟踪号。 + /// public string? TrackNo { get; set; } + /// + /// 服务单号。 + /// public string? ServiceNo { get; set; } + /// + /// 产品编码。 + /// public string? ProductCode { get; set; } + /// + /// 渠道编码。 + /// public string? ChannelCode { get; set; } + /// + /// 货物属性。 + /// public string? CargoAttribute { get; set; } + /// + /// 仓库主键。 + /// public long? WarehouseId { get; set; } + /// + /// 客户主键。 + /// public long? CustomerId { get; set; } + /// + /// 长度。 + /// public decimal? Length { get; set; } + /// + /// 宽度。 + /// public decimal? Width { get; set; } + /// + /// 高度。 + /// public decimal? Height { get; set; } + /// + /// 实际重量。 + /// public decimal? ActualWeight { get; set; } + /// + /// 体积重量。 + /// public decimal? VolumetricWeight { get; set; } + /// + /// 计费重量。 + /// public decimal? ChargeableWeight { get; set; } + /// + /// 体积。 + /// public decimal? Cubic { get; set; } + /// + /// 是否 COD。 + /// public bool IsCod { get; set; } + /// + /// COD 币种。 + /// public string? CodCurrency { get; set; } + /// + /// COD 金额。 + /// public decimal? CodSum { get; set; } + /// + /// 申报币种。 + /// public string? DeclaredCurrency { get; set; } + /// + /// 申报金额。 + /// public decimal? DeclaredSum { get; set; } + /// + /// 数量。 + /// public int? Quantity { get; set; } + /// + /// 收件人信息。 + /// public OrderParcelReceiverInput? Receiver { get; set; } + /// + /// 寄件人信息。 + /// public OrderParcelSenderInput? Sender { get; set; } + /// + /// 包裹内件集合。 + /// public List Items { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/Orders/OrderParcelCreateOutput.cs b/src/Oms.Application/Dtos/Orders/OrderParcelCreateOutput.cs index 8ef3244..eaf77b5 100644 --- a/src/Oms.Application/Dtos/Orders/OrderParcelCreateOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderParcelCreateOutput.cs @@ -1,12 +1,27 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单包裹创建结果出参。 +/// public class OrderParcelCreateOutput { + /// + /// 客户单号。 + /// public string? ClientNo { get; set; } + /// + /// 服务单号。 + /// public string? ServiceNo { get; set; } + /// + /// 跟踪号。 + /// public string? TrackNo { get; set; } + /// + /// 面单地址。 + /// public string LabelUrl { get; set; } = string.Empty; } diff --git a/src/Oms.Application/Dtos/Orders/OrderParcelItemInput.cs b/src/Oms.Application/Dtos/Orders/OrderParcelItemInput.cs index ae5ab09..e108084 100644 --- a/src/Oms.Application/Dtos/Orders/OrderParcelItemInput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderParcelItemInput.cs @@ -1,56 +1,137 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单包裹内件入参。 +/// public class OrderParcelItemInput { + /// + /// 中文名称。 + /// public string? CnName { get; set; } + /// + /// 英文名称。 + /// public string? EnName { get; set; } + /// + /// SKU。 + /// public string? Sku { get; set; } + /// + /// 单位。 + /// public string? Unit { get; set; } + /// + /// 单价。 + /// public decimal? UnitPrice { get; set; } + /// + /// 单件重量。 + /// public decimal? UnitWeight { get; set; } + /// + /// 数量。 + /// public int? Quantity { get; set; } + /// + /// 金额。 + /// public decimal? Amount { get; set; } + /// + /// 重量。 + /// public decimal? Weight { get; set; } + /// + /// 进口 HS 编码。 + /// public string? ImHsCode { get; set; } + /// + /// 出口 HS 编码。 + /// public string? ExHsCode { get; set; } + /// + /// SKU 图片。 + /// public string? SkuImage { get; set; } + /// + /// 品类。 + /// public string? Category { get; set; } + /// + /// 品牌。 + /// public string? Brand { get; set; } + /// + /// 品牌类型。 + /// public string? BrandType { get; set; } + /// + /// 是否带磁。 + /// public bool IsMagnetic { get; set; } + /// + /// 配货方式。 + /// public string? Distribution { get; set; } + /// + /// 材质。 + /// public string? Material { get; set; } + /// + /// 英文材质。 + /// public string? EnMaterial { get; set; } + /// + /// 用途。 + /// public string? Purpose { get; set; } + /// + /// 属性集合。 + /// public string? Attributes { get; set; } + /// + /// 原产国。 + /// public string? OriginCountry { get; set; } + /// + /// 销售链接。 + /// public string? SalesLink { get; set; } + /// + /// 型号。 + /// public string? Model { get; set; } + /// + /// 规格。 + /// public string? Specifications { get; set; } + /// + /// 备注说明。 + /// public string? Comment { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderParcelReceiverInput.cs b/src/Oms.Application/Dtos/Orders/OrderParcelReceiverInput.cs index 334843d..d44ea5c 100644 --- a/src/Oms.Application/Dtos/Orders/OrderParcelReceiverInput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderParcelReceiverInput.cs @@ -1,42 +1,102 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单包裹收件人入参。 +/// public class OrderParcelReceiverInput { + /// + /// 收件人姓名。 + /// public string? RecipientsName { get; set; } + /// + /// 公司名称。 + /// public string? CompanyName { get; set; } + /// + /// 手机号。 + /// public string? Phone { get; set; } + /// + /// 固定电话。 + /// public string? TelePhone { get; set; } + /// + /// 邮箱。 + /// public string? Email { get; set; } + /// + /// 国家/地区代码。 + /// public int? CountryCode { get; set; } + /// + /// 省份。 + /// public string? Province { get; set; } + /// + /// 城市。 + /// public string? City { get; set; } + /// + /// 门牌号。 + /// public string? StreetNumber { get; set; } + /// + /// 地址第一行。 + /// public string? StreetAddress1 { get; set; } + /// + /// 地址第二行。 + /// public string? StreetAddress2 { get; set; } + /// + /// 地址第三行。 + /// public string? StreetAddress3 { get; set; } + /// + /// 邮编。 + /// public string? ZipCode { get; set; } + /// + /// 税号类型。 + /// public int? TaxType { get; set; } + /// + /// 税号。 + /// public string? TaxNo { get; set; } + /// + /// 证件类型。 + /// public int? CertificateType { get; set; } + /// + /// 证件号码。 + /// public string? CertificateNo { get; set; } + /// + /// EORI 编号。 + /// public string? Eori { get; set; } + /// + /// VAT 编号。 + /// public string? Vat { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderParcelSenderInput.cs b/src/Oms.Application/Dtos/Orders/OrderParcelSenderInput.cs index 29b4db2..afc7ec8 100644 --- a/src/Oms.Application/Dtos/Orders/OrderParcelSenderInput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderParcelSenderInput.cs @@ -1,30 +1,72 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单包裹寄件人入参。 +/// public class OrderParcelSenderInput { + /// + /// 寄件人姓名。 + /// public string? SenderName { get; set; } + /// + /// 公司。 + /// public string? Company { get; set; } + /// + /// 手机号。 + /// public string? Phone { get; set; } + /// + /// 固定电话。 + /// public string? TelePhone { get; set; } + /// + /// 邮箱。 + /// public string? Email { get; set; } + /// + /// 国家/地区代码。 + /// public int? CountryCode { get; set; } + /// + /// 省份。 + /// public string? Province { get; set; } + /// + /// 城市。 + /// public string? City { get; set; } + /// + /// 邮编。 + /// public string? ZipCode { get; set; } + /// + /// 地址第一行。 + /// public string? StreetAddress1 { get; set; } + /// + /// 地址第二行。 + /// public string? StreetAddress2 { get; set; } + /// + /// 地址第三行。 + /// public string? StreetAddress3 { get; set; } + /// + /// 门牌号。 + /// public string? HouseNumber { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderPriceCheckInput.cs b/src/Oms.Application/Dtos/Orders/OrderPriceCheckInput.cs index 7b1c469..3cfacda 100644 --- a/src/Oms.Application/Dtos/Orders/OrderPriceCheckInput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderPriceCheckInput.cs @@ -1,22 +1,52 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单入参。 +/// public class OrderPriceCheckInput { + /// + /// 目的国家/地区。 + /// public string DestinationCountry { get; set; } = string.Empty; + /// + /// 运输方式。 + /// public string? ShippingMethod { get; set; } + /// + /// 货物重量。 + /// public decimal? CargoWeight { get; set; } + /// + /// 长度。 + /// public decimal? Length { get; set; } + /// + /// 宽度。 + /// public decimal? Width { get; set; } + /// + /// 高度。 + /// public decimal? Height { get; set; } + /// + /// 货物类型。 + /// public string? CargoType { get; set; } + /// + /// 目的省份。 + /// public string? DestinationProvince { get; set; } + /// + /// 邮编。 + /// public string? PostalCode { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderPriceCheckOutput.cs b/src/Oms.Application/Dtos/Orders/OrderPriceCheckOutput.cs index 8aeb339..81eb87f 100644 --- a/src/Oms.Application/Dtos/Orders/OrderPriceCheckOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderPriceCheckOutput.cs @@ -1,28 +1,67 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单运费试算结果出参。 +/// public class OrderPriceCheckOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 运输方式。 + /// public string ShippingMethod { get; set; } = string.Empty; + /// + /// 仓库名称。 + /// public string? Warehouse { get; set; } + /// + /// 派送时效。 + /// public string DeliveryTime { get; set; } = string.Empty; + /// + /// 体积重量。 + /// public decimal? VolumetricWeight { get; set; } + /// + /// 计费重量。 + /// public decimal? ChargeableWeight { get; set; } + /// + /// 成本公式。 + /// public string CostFormula { get; set; } = string.Empty; + /// + /// 运费。 + /// public decimal Freight { get; set; } + /// + /// 其他费用。 + /// public decimal OtherFees { get; set; } + /// + /// 总成本。 + /// public decimal TotalCost { get; set; } + /// + /// 最大派送天数。 + /// public int? MaxDeliveryDays { get; set; } + /// + /// 总成本数值。 + /// public decimal TotalCostNum { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderPrintOutput.cs b/src/Oms.Application/Dtos/Orders/OrderPrintOutput.cs index 062e359..268c93f 100644 --- a/src/Oms.Application/Dtos/Orders/OrderPrintOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderPrintOutput.cs @@ -1,6 +1,12 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单打印出参。 +/// public class OrderPrintOutput { + /// + /// 打印地址。 + /// public string PrintUrl { get; set; } = string.Empty; } diff --git a/src/Oms.Application/Dtos/Orders/OrderReceiverOutput.cs b/src/Oms.Application/Dtos/Orders/OrderReceiverOutput.cs index 97b12ae..f5eb79a 100644 --- a/src/Oms.Application/Dtos/Orders/OrderReceiverOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderReceiverOutput.cs @@ -1,42 +1,102 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单收件人出参。 +/// public class OrderReceiverOutput { + /// + /// 收件人姓名。 + /// public string? RecipientsName { get; set; } + /// + /// 公司名称。 + /// public string? CompanyName { get; set; } + /// + /// 手机号。 + /// public string? Phone { get; set; } + /// + /// 固定电话。 + /// public string? TelePhone { get; set; } + /// + /// 邮箱。 + /// public string? Email { get; set; } + /// + /// 国家/地区代码。 + /// public int? CountryCode { get; set; } + /// + /// 省份。 + /// public string? Province { get; set; } + /// + /// 城市。 + /// public string? City { get; set; } + /// + /// 门牌号。 + /// public string? StreetNumber { get; set; } + /// + /// 地址第一行。 + /// public string? StreetAddress1 { get; set; } + /// + /// 地址第二行。 + /// public string? StreetAddress2 { get; set; } + /// + /// 地址第三行。 + /// public string? StreetAddress3 { get; set; } + /// + /// 邮编。 + /// public string? ZipCode { get; set; } + /// + /// 税号类型。 + /// public int? TaxType { get; set; } + /// + /// 税号。 + /// public string? TaxNo { get; set; } + /// + /// 证件类型。 + /// public int? CertificateType { get; set; } + /// + /// 证件号码。 + /// public string? CertificateNo { get; set; } + /// + /// EORI 编号。 + /// public string? Eori { get; set; } + /// + /// VAT 编号。 + /// public string? Vat { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderSenderOutput.cs b/src/Oms.Application/Dtos/Orders/OrderSenderOutput.cs index 5e9e10f..fe7fbc9 100644 --- a/src/Oms.Application/Dtos/Orders/OrderSenderOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderSenderOutput.cs @@ -1,30 +1,72 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单寄件人出参。 +/// public class OrderSenderOutput { + /// + /// 寄件人姓名。 + /// public string? SenderName { get; set; } + /// + /// 公司。 + /// public string? Company { get; set; } + /// + /// 手机号。 + /// public string? Phone { get; set; } + /// + /// 固定电话。 + /// public string? TelePhone { get; set; } + /// + /// 邮箱。 + /// public string? Email { get; set; } + /// + /// 国家/地区代码。 + /// public int? CountryCode { get; set; } + /// + /// 省份。 + /// public string? Province { get; set; } + /// + /// 城市。 + /// public string? City { get; set; } + /// + /// 邮编。 + /// public string? ZipCode { get; set; } + /// + /// 地址第一行。 + /// public string? StreetAddress1 { get; set; } + /// + /// 地址第二行。 + /// public string? StreetAddress2 { get; set; } + /// + /// 地址第三行。 + /// public string? StreetAddress3 { get; set; } + /// + /// 门牌号。 + /// public string? HouseNumber { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderTaskDetailOutput.cs b/src/Oms.Application/Dtos/Orders/OrderTaskDetailOutput.cs index 4660c99..a717acc 100644 --- a/src/Oms.Application/Dtos/Orders/OrderTaskDetailOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderTaskDetailOutput.cs @@ -1,24 +1,57 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单任务详情出参。 +/// public class OrderTaskDetailOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 任务名称。 + /// public string TaskName { get; set; } = string.Empty; + /// + /// 数量。 + /// public int? Quantity { get; set; } + /// + /// 成功数量。 + /// public int? SuccessCount { get; set; } + /// + /// 失败数量。 + /// public int? FailCount { get; set; } + /// + /// 状态。 + /// public string Status { get; set; } = string.Empty; + /// + /// 模板主键。 + /// public long? TemplateId { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } + /// + /// 失败明细集合。 + /// public List FailList { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/Orders/OrderTaskFailOutput.cs b/src/Oms.Application/Dtos/Orders/OrderTaskFailOutput.cs index 5bd6bbe..dc7eeb0 100644 --- a/src/Oms.Application/Dtos/Orders/OrderTaskFailOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderTaskFailOutput.cs @@ -1,14 +1,32 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单任务失败项出参。 +/// public class OrderTaskFailOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 任务主键。 + /// public long TaskId { get; set; } + /// + /// 行号。 + /// public int RowNumber { get; set; } + /// + /// 失败原因。 + /// public string Reason { get; set; } = string.Empty; + /// + /// 原始数据 JSON。 + /// public object? RawDataJson { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderTaskListInput.cs b/src/Oms.Application/Dtos/Orders/OrderTaskListInput.cs index c1abbe6..4024b9d 100644 --- a/src/Oms.Application/Dtos/Orders/OrderTaskListInput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderTaskListInput.cs @@ -1,12 +1,27 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单任务列表查询入参。 +/// public class OrderTaskListInput { + /// + /// 页码，从 1 开始。 + /// public int Page { get; set; } = 1; + /// + /// 每页条数。 + /// public int PageSize { get; set; } = 20; + /// + /// 状态。 + /// public string? Status { get; set; } + /// + /// 关键词。 + /// public string? Keyword { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderTaskOutput.cs b/src/Oms.Application/Dtos/Orders/OrderTaskOutput.cs index 4d4a0fd..04cebb0 100644 --- a/src/Oms.Application/Dtos/Orders/OrderTaskOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderTaskOutput.cs @@ -1,18 +1,42 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单任务出参。 +/// public class OrderTaskOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 任务名称。 + /// public string TaskName { get; set; } = string.Empty; + /// + /// 数量。 + /// public int? Quantity { get; set; } + /// + /// 状态。 + /// public string Status { get; set; } = string.Empty; + /// + /// 模板主键。 + /// public long? TemplateId { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderTemplateListInput.cs b/src/Oms.Application/Dtos/Orders/OrderTemplateListInput.cs index 5546752..061f318 100644 --- a/src/Oms.Application/Dtos/Orders/OrderTemplateListInput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderTemplateListInput.cs @@ -1,12 +1,27 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单模板列表查询入参。 +/// public class OrderTemplateListInput { + /// + /// 页码，从 1 开始。 + /// public int Page { get; set; } = 1; + /// + /// 每页条数。 + /// public int PageSize { get; set; } = 20; + /// + /// 类型。 + /// public string? Type { get; set; } + /// + /// 关键词。 + /// public string? Keyword { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderTemplateOutput.cs b/src/Oms.Application/Dtos/Orders/OrderTemplateOutput.cs index 9bf63ca..f4e659a 100644 --- a/src/Oms.Application/Dtos/Orders/OrderTemplateOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderTemplateOutput.cs @@ -1,18 +1,42 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单模板出参。 +/// public class OrderTemplateOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 名称。 + /// public string Name { get; set; } = string.Empty; + /// + /// 类型。 + /// public string Type { get; set; } = string.Empty; + /// + /// 模板标识。 + /// public string? TemplateKey { get; set; } + /// + /// 客户主键。 + /// public long? CustomerId { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderUploadInput.cs b/src/Oms.Application/Dtos/Orders/OrderUploadInput.cs index 1ad630a..67f70db 100644 --- a/src/Oms.Application/Dtos/Orders/OrderUploadInput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderUploadInput.cs @@ -2,9 +2,18 @@ using Microsoft.AspNetCore.Http; namespace Oms.Application.Dtos.Orders; +/// +/// 订单入参。 +/// public class OrderUploadInput { + /// + /// 上传文件。 + /// public IFormFile File { get; set; } = null!; + /// + /// 模板主键。 + /// public long TemplateId { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderUploadOutput.cs b/src/Oms.Application/Dtos/Orders/OrderUploadOutput.cs index 46951df..483879a 100644 --- a/src/Oms.Application/Dtos/Orders/OrderUploadOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderUploadOutput.cs @@ -1,6 +1,12 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单结果出参。 +/// public class OrderUploadOutput { + /// + /// 任务主键。 + /// public long TaskId { get; set; } } diff --git a/src/Oms.Application/Dtos/Orders/OrderWeightOutput.cs b/src/Oms.Application/Dtos/Orders/OrderWeightOutput.cs index 7fb171e..a39d132 100644 --- a/src/Oms.Application/Dtos/Orders/OrderWeightOutput.cs +++ b/src/Oms.Application/Dtos/Orders/OrderWeightOutput.cs @@ -1,20 +1,47 @@ namespace Oms.Application.Dtos.Orders; +/// +/// 订单重量明细出参。 +/// public class OrderWeightOutput { + /// + /// 类型。 + /// public string Type { get; set; } = string.Empty; + /// + /// 长度。 + /// public decimal? Length { get; set; } + /// + /// 宽度。 + /// public decimal? Width { get; set; } + /// + /// 高度。 + /// public decimal? Height { get; set; } + /// + /// 实际重量。 + /// public decimal? ActualWeight { get; set; } + /// + /// 体积重量。 + /// public decimal? VolumetricWeight { get; set; } + /// + /// 计费重量。 + /// public decimal? ChargeableWeight { get; set; } + /// + /// 体积。 + /// public decimal? Cubic { get; set; } } diff --git a/src/Oms.Application/Dtos/Recharge/ApproveRechargeInput.cs b/src/Oms.Application/Dtos/Recharge/ApproveRechargeInput.cs index ea8bbc5..7b524c2 100644 --- a/src/Oms.Application/Dtos/Recharge/ApproveRechargeInput.cs +++ b/src/Oms.Application/Dtos/Recharge/ApproveRechargeInput.cs @@ -2,11 +2,20 @@ using System.ComponentModel.DataAnnotations; namespace Oms.Application.Dtos.Recharge; +/// +/// 充值审核通过入参。 +/// public class ApproveRechargeInput { [Required] + /// + /// 主键。 + /// public long Id { get; set; } [StringLength(512)] + /// + /// 备注。 + /// public string? Remark { get; set; } } diff --git a/src/Oms.Application/Dtos/Recharge/RechargeExportInput.cs b/src/Oms.Application/Dtos/Recharge/RechargeExportInput.cs index b4815ea..a626af7 100644 --- a/src/Oms.Application/Dtos/Recharge/RechargeExportInput.cs +++ b/src/Oms.Application/Dtos/Recharge/RechargeExportInput.cs @@ -1,22 +1,22 @@ namespace Oms.Application.Dtos.Recharge; /// -/// 充值记录导出入参。 +/// 充值导出入参。 /// public class RechargeExportInput { /// - /// 客户 ID，空值表示不过滤。 + /// 客户主键。 /// public long? CustomerId { get; set; } /// - /// 充值时间起始值。 + /// 开始时间。 /// public DateTime? StartTime { get; set; } /// - /// 充值时间结束值。 + /// 结束时间。 /// public DateTime? EndTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Recharge/RechargeRecordOutput.cs b/src/Oms.Application/Dtos/Recharge/RechargeRecordOutput.cs index fe9f738..a7ea65f 100644 --- a/src/Oms.Application/Dtos/Recharge/RechargeRecordOutput.cs +++ b/src/Oms.Application/Dtos/Recharge/RechargeRecordOutput.cs @@ -2,25 +2,58 @@ using Oms.Domain.RechargeAggregate.Enums; namespace Oms.Application.Dtos.Recharge; +/// +/// 充值记录出参。 +/// public class RechargeRecordOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 序号。 + /// public string SerialNumber { get; set; } = string.Empty; + /// + /// 客户主键。 + /// public long CustomerId { get; set; } + /// + /// 充值金额。 + /// public decimal RechargeAmount { get; set; } + /// + /// 支付方式。 + /// public PayType PayType { get; set; } + /// + /// 充值截图。 + /// public string? RechargeScreenshot { get; set; } + /// + /// 充值状态。 + /// public RechargeStatus RechargeStatus { get; set; } + /// + /// 备注。 + /// public string? Remark { get; set; } + /// + /// 充值时间。 + /// public DateTime RechargeTime { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Recharge/RechargeRecordPaginatedInput.cs b/src/Oms.Application/Dtos/Recharge/RechargeRecordPaginatedInput.cs index 27041e0..fc63818 100644 --- a/src/Oms.Application/Dtos/Recharge/RechargeRecordPaginatedInput.cs +++ b/src/Oms.Application/Dtos/Recharge/RechargeRecordPaginatedInput.cs @@ -18,27 +18,27 @@ public class RechargeRecordPaginatedInput public int PageSize { get; set; } = 20; /// - /// 客户 ID，空值表示不过滤。 + /// 客户主键。 /// public long? CustomerId { get; set; } /// - /// 充值流水号，支持模糊匹配。 + /// 序号。 /// public string? SerialNumber { get; set; } /// - /// 充值审核状态，空值表示不过滤。 + /// 充值状态。 /// public RechargeStatus? RechargeStatus { get; set; } /// - /// 充值时间起始值。 + /// 开始时间。 /// public DateTime? StartTime { get; set; } /// - /// 充值时间结束值。 + /// 结束时间。 /// public DateTime? EndTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Recharge/RechargeRecordPaginatedOutput.cs b/src/Oms.Application/Dtos/Recharge/RechargeRecordPaginatedOutput.cs index e1166cb..f3ce85a 100644 --- a/src/Oms.Application/Dtos/Recharge/RechargeRecordPaginatedOutput.cs +++ b/src/Oms.Application/Dtos/Recharge/RechargeRecordPaginatedOutput.cs @@ -2,39 +2,93 @@ using Oms.Domain.RechargeAggregate.Enums; namespace Oms.Application.Dtos.Recharge; +/// +/// 充值记录分页列表项出参。 +/// public class RechargeRecordPaginatedOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 客户主键。 + /// public long CustomerId { get; set; } + /// + /// 客户编码。 + /// public string? CustomerCode { get; set; } + /// + /// 客户手机号。 + /// public string? CustomerPhone { get; set; } + /// + /// 序号。 + /// public string SerialNumber { get; set; } = string.Empty; + /// + /// 充值时间。 + /// public DateTime RechargeTime { get; set; } + /// + /// 支付方式。 + /// public PayType PayType { get; set; } + /// + /// 支付方式名称。 + /// public string PayTypeName { get; set; } = string.Empty; + /// + /// 充值金额。 + /// public decimal RechargeAmount { get; set; } + /// + /// 充值截图。 + /// public string? RechargeScreenshot { get; set; } + /// + /// 充值状态。 + /// public RechargeStatus RechargeStatus { get; set; } + /// + /// 充值状态名称。 + /// public string RechargeStatusName { get; set; } = string.Empty; + /// + /// 备注。 + /// public string? Remark { get; set; } + /// + /// 审核时间。 + /// public DateTime? AuditTime { get; set; } + /// + /// 审核人。 + /// public string? AuditBy { get; set; } + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Dtos/Recharge/RejectRechargeInput.cs b/src/Oms.Application/Dtos/Recharge/RejectRechargeInput.cs index 141be5d..818a193 100644 --- a/src/Oms.Application/Dtos/Recharge/RejectRechargeInput.cs +++ b/src/Oms.Application/Dtos/Recharge/RejectRechargeInput.cs @@ -2,11 +2,20 @@ using System.ComponentModel.DataAnnotations; namespace Oms.Application.Dtos.Recharge; +/// +/// 充值审核驳回入参。 +/// public class RejectRechargeInput { [Required] + /// + /// 主键。 + /// public long Id { get; set; } [StringLength(512)] + /// + /// 备注。 + /// public string? Remark { get; set; } } diff --git a/src/Oms.Application/Dtos/Recharge/SubmitRechargeInput.cs b/src/Oms.Application/Dtos/Recharge/SubmitRechargeInput.cs index 5b2016d..2fa0e2f 100644 --- a/src/Oms.Application/Dtos/Recharge/SubmitRechargeInput.cs +++ b/src/Oms.Application/Dtos/Recharge/SubmitRechargeInput.cs @@ -3,19 +3,37 @@ using Oms.Domain.RechargeAggregate.Enums; namespace Oms.Application.Dtos.Recharge; +/// +/// 充值提交入参。 +/// public class SubmitRechargeInput { + /// + /// 客户主键。 + /// public long? CustomerId { get; set; } [Range(typeof(decimal), "0.01", "999999999999")] + /// + /// 充值金额。 + /// public decimal RechargeAmount { get; set; } [Required] + /// + /// 支付方式。 + /// public PayType PayType { get; set; } [StringLength(255)] + /// + /// 充值截图。 + /// public string? RechargeScreenshot { get; set; } [StringLength(512)] + /// + /// 备注。 + /// public string? Remark { get; set; } } diff --git a/src/Oms.Application/Dtos/Shared/IdInput.cs b/src/Oms.Application/Dtos/Shared/IdInput.cs index 44efb27..a2809c3 100644 --- a/src/Oms.Application/Dtos/Shared/IdInput.cs +++ b/src/Oms.Application/Dtos/Shared/IdInput.cs @@ -2,8 +2,14 @@ using System.ComponentModel.DataAnnotations; namespace Oms.Application.Dtos.Shared; +/// +/// 按主键操作的通用入参。 +/// public class IdInput { [Required] + /// + /// 主键。 + /// public long Id { get; set; } } diff --git a/src/Oms.Application/Dtos/Shared/OmsItemsResult.cs b/src/Oms.Application/Dtos/Shared/OmsItemsResult.cs index 16e082c..171ee5e 100644 --- a/src/Oms.Application/Dtos/Shared/OmsItemsResult.cs +++ b/src/Oms.Application/Dtos/Shared/OmsItemsResult.cs @@ -1,6 +1,12 @@ namespace Oms.Application.Dtos.Shared; +/// +/// 列表结果通用返回体。 +/// public class OmsItemsResult { + /// + /// 列表数据集合。 + /// public List Items { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/Shared/OmsPageResult.cs b/src/Oms.Application/Dtos/Shared/OmsPageResult.cs index f4f5819..5d7ca37 100644 --- a/src/Oms.Application/Dtos/Shared/OmsPageResult.cs +++ b/src/Oms.Application/Dtos/Shared/OmsPageResult.cs @@ -1,8 +1,17 @@ namespace Oms.Application.Dtos.Shared; +/// +/// 分页结果通用返回体。 +/// public class OmsPageResult { + /// + /// 分页数据集合。 + /// public List Items { get; set; } = []; + /// + /// 总记录数。 + /// public long Total { get; set; } } diff --git a/src/Oms.Application/Dtos/Shared/ToggleStatusInput.cs b/src/Oms.Application/Dtos/Shared/ToggleStatusInput.cs index 7301585..2ef0ce2 100644 --- a/src/Oms.Application/Dtos/Shared/ToggleStatusInput.cs +++ b/src/Oms.Application/Dtos/Shared/ToggleStatusInput.cs @@ -3,17 +3,17 @@ using Oms.Domain.Shared.Enums; namespace Oms.Application.Dtos.Shared; /// -/// 通用状态切换入参。 +/// 切换状态的通用入参。 /// public class ToggleStatusInput { /// - /// 目标主键。 + /// 主键。 /// public long Id { get; set; } /// - /// 目标状态值。 + /// 状态。 /// public EnableStatus Status { get; set; } } diff --git a/src/Oms.Application/Dtos/System/CreateWarehouseInput.cs b/src/Oms.Application/Dtos/System/CreateWarehouseInput.cs index 38a278a..421cb86 100644 --- a/src/Oms.Application/Dtos/System/CreateWarehouseInput.cs +++ b/src/Oms.Application/Dtos/System/CreateWarehouseInput.cs @@ -2,29 +2,56 @@ using System.ComponentModel.DataAnnotations; namespace Oms.Application.Dtos.System; +/// +/// 创建仓库入参。 +/// public class CreateWarehouseInput { [Required] [StringLength(128)] + /// + /// 仓库名称。 + /// public string WarehouseName { get; set; } = string.Empty; [Required] [StringLength(32)] + /// + /// 仓库类型编码。 + /// public string WarehouseType { get; set; } = string.Empty; [StringLength(64)] + /// + /// 收件人。 + /// public string? Recipient { get; set; } [StringLength(32)] + /// + /// 联系电话。 + /// public string? ContactPhone { get; set; } + /// + /// 发货地址。 + /// public string? ShippingAddress { get; set; } [StringLength(32)] + /// + /// 客服手机号。 + /// public string? ServicePhone { get; set; } [StringLength(64)] + /// + /// 客服微信号。 + /// public string? ServiceWechat { get; set; } + /// + /// 客服微信附件集合。 + /// public List ServiceWechatFiles { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/System/UpdateWarehouseInput.cs b/src/Oms.Application/Dtos/System/UpdateWarehouseInput.cs index c9eef4b..0c6d8ff 100644 --- a/src/Oms.Application/Dtos/System/UpdateWarehouseInput.cs +++ b/src/Oms.Application/Dtos/System/UpdateWarehouseInput.cs @@ -2,32 +2,62 @@ using System.ComponentModel.DataAnnotations; namespace Oms.Application.Dtos.System; +/// +/// 更新仓库入参。 +/// public class UpdateWarehouseInput { [Required] + /// + /// 主键。 + /// public long Id { get; set; } [Required] [StringLength(128)] + /// + /// 仓库名称。 + /// public string WarehouseName { get; set; } = string.Empty; [Required] [StringLength(32)] + /// + /// 仓库类型编码。 + /// public string WarehouseType { get; set; } = string.Empty; [StringLength(64)] + /// + /// 收件人。 + /// public string? Recipient { get; set; } [StringLength(32)] + /// + /// 联系电话。 + /// public string? ContactPhone { get; set; } + /// + /// 发货地址。 + /// public string? ShippingAddress { get; set; } [StringLength(32)] + /// + /// 客服手机号。 + /// public string? ServicePhone { get; set; } [StringLength(64)] + /// + /// 客服微信号。 + /// public string? ServiceWechat { get; set; } + /// + /// 客服微信附件集合。 + /// public List ServiceWechatFiles { get; set; } = []; } diff --git a/src/Oms.Application/Dtos/System/WarehouseOutput.cs b/src/Oms.Application/Dtos/System/WarehouseOutput.cs index 1ab436b..8b88ca3 100644 --- a/src/Oms.Application/Dtos/System/WarehouseOutput.cs +++ b/src/Oms.Application/Dtos/System/WarehouseOutput.cs @@ -1,30 +1,72 @@ namespace Oms.Application.Dtos.System; +/// +/// 仓库出参。 +/// public class WarehouseOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 仓库名称。 + /// public string WarehouseName { get; set; } = string.Empty; + /// + /// 仓库类型编码。 + /// public string WarehouseType { get; set; } = string.Empty; + /// + /// 收件人。 + /// public string? Recipient { get; set; } + /// + /// 联系电话。 + /// public string? ContactPhone { get; set; } + /// + /// 发货地址。 + /// public string? ShippingAddress { get; set; } + /// + /// 客服手机号。 + /// public string? ServicePhone { get; set; } + /// + /// 客服微信号。 + /// public string? ServiceWechat { get; set; } + /// + /// 客服微信附件集合。 + /// public List ServiceWechatFiles { get; set; } = []; + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 创建人。 + /// public string? CreateBy { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } + /// + /// 更新人。 + /// public string? UpdateBy { get; set; } } diff --git a/src/Oms.Application/Dtos/System/WarehousePaginatedInput.cs b/src/Oms.Application/Dtos/System/WarehousePaginatedInput.cs index bd5a769..2f34376 100644 --- a/src/Oms.Application/Dtos/System/WarehousePaginatedInput.cs +++ b/src/Oms.Application/Dtos/System/WarehousePaginatedInput.cs @@ -1,12 +1,27 @@ namespace Oms.Application.Dtos.System; +/// +/// 仓库分页查询入参。 +/// public class WarehousePaginatedInput { + /// + /// 页码，从 1 开始。 + /// public int Page { get; set; } = 1; + /// + /// 每页条数。 + /// public int PageSize { get; set; } = 20; + /// + /// 仓库类型编码。 + /// public string? WarehouseType { get; set; } + /// + /// 关键词。 + /// public string? Keyword { get; set; } } diff --git a/src/Oms.Application/Dtos/System/WarehousePaginatedOutput.cs b/src/Oms.Application/Dtos/System/WarehousePaginatedOutput.cs index 9174879..2b09e46 100644 --- a/src/Oms.Application/Dtos/System/WarehousePaginatedOutput.cs +++ b/src/Oms.Application/Dtos/System/WarehousePaginatedOutput.cs @@ -1,28 +1,67 @@ namespace Oms.Application.Dtos.System; +/// +/// 仓库分页列表项出参。 +/// public class WarehousePaginatedOutput { + /// + /// 主键。 + /// public long Id { get; set; } + /// + /// 仓库名称。 + /// public string WarehouseName { get; set; } = string.Empty; + /// + /// 仓库类型编码。 + /// public string WarehouseType { get; set; } = string.Empty; + /// + /// 仓库类型名称。 + /// public string WarehouseTypeName { get; set; } = string.Empty; + /// + /// 收件人。 + /// public string? Recipient { get; set; } + /// + /// 联系电话。 + /// public string? ContactPhone { get; set; } + /// + /// 发货地址。 + /// public string? ShippingAddress { get; set; } + /// + /// 客服手机号。 + /// public string? ServicePhone { get; set; } + /// + /// 客服微信号。 + /// public string? ServiceWechat { get; set; } + /// + /// 客服微信附件集合。 + /// public List ServiceWechatFiles { get; set; } = []; + /// + /// 创建时间。 + /// public DateTime CreateTime { get; set; } + /// + /// 更新时间。 + /// public DateTime? UpdateTime { get; set; } } diff --git a/src/Oms.Application/Oms.Application.csproj b/src/Oms.Application/Oms.Application.csproj index d0a2128..04e5b7f 100644 --- a/src/Oms.Application/Oms.Application.csproj +++ b/src/Oms.Application/Oms.Application.csproj @@ -4,6 +4,7 @@ net8.0 enable enable + True diff --git a/src/Oms.Application/Services/Channels/AutoTriggerService.cs b/src/Oms.Application/Services/Channels/AutoTriggerService.cs index be318f6..5de70ff 100644 --- a/src/Oms.Application/Services/Channels/AutoTriggerService.cs +++ b/src/Oms.Application/Services/Channels/AutoTriggerService.cs @@ -15,8 +15,16 @@ public class AutoTriggerService : ApplicationService private IAutoTriggerRepository AutoTriggerRepository => LazyServiceProvider.GetRequiredService(); /// - /// 获取自动触发分页列表。 + /// 查询自动触发规则列表。 /// + /// 入参：自动触发规则列表查询条件。 + /// 自动触发规则分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/channel/auto-trigger/list")] public async Task> GetListAsync([FromQuery] AutoTriggerListInput input) { @@ -36,6 +44,14 @@ public class AutoTriggerService : ApplicationService /// /// 新增自动触发规则。 /// + /// 入参：自动触发规则保存参数。 + /// 无返回体，仅完成新增自动触发规则。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/channel/auto-trigger/create")] public async Task CreateAsync(AutoTriggerSaveInput input) { @@ -58,6 +74,14 @@ public class AutoTriggerService : ApplicationService /// /// 更新自动触发规则。 /// + /// 入参：自动触发规则保存参数。 + /// 无返回体，仅完成更新自动触发规则。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/auto-trigger/update")] public async Task UpdateAsync(AutoTriggerSaveInput input) { @@ -76,6 +100,14 @@ public class AutoTriggerService : ApplicationService /// /// 删除自动触发规则。 /// + /// 入参：目标主键。 + /// 无返回体，仅完成删除自动触发规则。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/channel/auto-trigger/delete")] public async Task DeleteAsync(IdInput input) { @@ -87,8 +119,16 @@ public class AutoTriggerService : ApplicationService } /// - /// 切换自动触发启用状态。 + /// 切换自动触发规则状态。 /// + /// 入参：目标主键和状态值。 + /// 无返回体，仅完成切换自动触发规则状态。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 更新启停状态。 + /// 3. 保存状态变更结果。 + /// [HttpPost("/channel/auto-trigger/toggleStatus")] public async Task ToggleStatusAsync(ToggleStatusInput input) { diff --git a/src/Oms.Application/Services/Channels/KpiAreaService.cs b/src/Oms.Application/Services/Channels/KpiAreaService.cs index 5ec9598..27f3550 100644 --- a/src/Oms.Application/Services/Channels/KpiAreaService.cs +++ b/src/Oms.Application/Services/Channels/KpiAreaService.cs @@ -15,8 +15,16 @@ public class KpiAreaService : ApplicationService private IKpiAreaRepository KpiAreaRepository => LazyServiceProvider.GetRequiredService(); /// - /// 获取 KPI 分区分页列表。 + /// 查询KPI分区列表。 /// + /// 入参：KPI分区列表查询条件。 + /// KPI分区分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpPost("/channel/kpi-area/list")] public async Task> GetListAsync(KpiAreaListInput input) { @@ -37,8 +45,16 @@ public class KpiAreaService : ApplicationService } /// - /// 新增 KPI 分区。 + /// 新增KPI分区。 /// + /// 入参：KPI分区保存参数。 + /// 无返回体，仅完成新增KPI分区。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/channel/kpi-area/create")] public async Task CreateAsync(KpiAreaSaveInput input) { @@ -58,8 +74,16 @@ public class KpiAreaService : ApplicationService } /// - /// 更新 KPI 分区。 + /// 更新KPI分区。 /// + /// 入参：KPI分区保存参数。 + /// 无返回体，仅完成更新KPI分区。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/kpi-area/update")] public async Task UpdateAsync(KpiAreaSaveInput input) { @@ -75,8 +99,16 @@ public class KpiAreaService : ApplicationService } /// - /// 删除 KPI 分区。 + /// 删除KPI分区。 /// + /// 入参：目标主键。 + /// 无返回体，仅完成删除KPI分区。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/channel/kpi-area/delete")] public async Task DeleteAsync(IdInput input) { @@ -88,8 +120,16 @@ public class KpiAreaService : ApplicationService } /// - /// 获取 KPI 分区明细分页列表。 + /// 查询KPI分区明细列表。 /// + /// 入参：KPI分区明细列表查询条件。 + /// KPI分区明细分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpPost("/channel/kpi-area/info/list")] public async Task> GetInfoListAsync(KpiAreaInfoListInput input) { @@ -106,8 +146,16 @@ public class KpiAreaService : ApplicationService } /// - /// 新增 KPI 分区明细。 + /// 新增KPI分区明细。 /// + /// 入参：KPI分区明细保存参数。 + /// 无返回体，仅完成新增KPI分区明细。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/channel/kpi-area/info/add")] public async Task AddInfoAsync(KpiAreaInfoSaveInput input) { @@ -129,8 +177,16 @@ public class KpiAreaService : ApplicationService } /// - /// 更新 KPI 分区明细。 + /// 更新KPI分区明细。 /// + /// 入参：KPI分区明细保存参数。 + /// 无返回体，仅完成更新KPI分区明细。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/kpi-area/info/update")] public async Task UpdateInfoAsync(KpiAreaInfoSaveInput input) { @@ -149,8 +205,16 @@ public class KpiAreaService : ApplicationService } /// - /// 删除 KPI 分区明细。 + /// 删除KPI分区明细。 /// + /// 入参：目标主键。 + /// 无返回体，仅完成删除KPI分区明细。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/channel/kpi-area/info/delete")] public async Task DeleteInfoAsync(IdInput input) { diff --git a/src/Oms.Application/Services/Channels/LabelTemplateService.cs b/src/Oms.Application/Services/Channels/LabelTemplateService.cs index cbf5a8d..29d1ada 100644 --- a/src/Oms.Application/Services/Channels/LabelTemplateService.cs +++ b/src/Oms.Application/Services/Channels/LabelTemplateService.cs @@ -13,8 +13,16 @@ public class LabelTemplateService : ApplicationService private ILabelTemplateRepository LabelTemplateRepository => LazyServiceProvider.GetRequiredService(); /// - /// 新增或更新标签模板。 + /// 保存标签模板。 /// + /// 入参：标签模板保存参数。 + /// 标签模板保存结果。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/label-template/save")] public async Task SaveAsync(LabelTemplateSaveInput input) { diff --git a/src/Oms.Application/Services/Channels/SalesProductService.cs b/src/Oms.Application/Services/Channels/SalesProductService.cs index 7189e35..37633d8 100644 --- a/src/Oms.Application/Services/Channels/SalesProductService.cs +++ b/src/Oms.Application/Services/Channels/SalesProductService.cs @@ -19,8 +19,16 @@ public partial class SalesProductService : ApplicationService private IServiceChannelRepository ServiceChannelRepository => LazyServiceProvider.GetRequiredService(); /// - /// 获取销售产品分页列表。 + /// 查询销售产品列表。 /// + /// 入参：销售产品列表查询条件。 + /// 销售产品分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/channel/sales-product/list")] public async Task> GetListAsync([FromQuery] SalesProductListInput input) { @@ -41,8 +49,16 @@ public partial class SalesProductService : ApplicationService } /// - /// 获取销售产品详情。 + /// 查询销售产品详情。 /// + /// 入参：目标主键。 + /// 销售产品详情。 + /// + /// 核心业务逻辑： + /// 1. 根据标识查询目标对象。 + /// 2. 目标不存在时抛出业务异常。 + /// 3. 映射并返回详情结果。 + /// [HttpGet("/channel/sales-product/detail")] public async Task GetDetailAsync([FromQuery] long id) { @@ -53,6 +69,14 @@ public partial class SalesProductService : ApplicationService /// /// 新增销售产品。 /// + /// 入参：销售产品保存参数。 + /// 无返回体，仅完成新增销售产品。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/channel/sales-product/create")] public async Task CreateAsync(SalesProductSaveInput input) { @@ -70,6 +94,14 @@ public partial class SalesProductService : ApplicationService /// /// 更新销售产品。 /// + /// 入参：销售产品保存参数。 + /// 无返回体，仅完成更新销售产品。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/sales-product/update")] public async Task UpdateAsync(SalesProductSaveInput input) { @@ -84,6 +116,14 @@ public partial class SalesProductService : ApplicationService /// /// 删除销售产品。 /// + /// 入参：目标主键。 + /// 无返回体，仅完成删除销售产品。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/channel/sales-product/delete")] public async Task DeleteAsync(IdInput input) { @@ -97,6 +137,14 @@ public partial class SalesProductService : ApplicationService /// /// 保存销售产品配置。 /// + /// 入参：销售产品保存参数。 + /// 无返回体，仅完成保存销售产品配置。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/sales-product/config/save")] public async Task SaveConfigAsync(SalesProductSaveInput input) { @@ -109,8 +157,16 @@ public partial class SalesProductService : ApplicationService } /// - /// 获取销售产品价格项列表。 + /// 查询销售产品价格项列表。 /// + /// 入参：销售产品主键。 + /// 销售产品价格项列表结果。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/channel/sales-product/price/list")] public async Task> GetPriceListAsync([FromQuery] long salesProductId) { @@ -124,6 +180,14 @@ public partial class SalesProductService : ApplicationService /// /// 新增销售产品价格项。 /// + /// 入参：销售产品价格项保存参数。 + /// 无返回体，仅完成新增销售产品价格项。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/channel/sales-product/price/create")] public async Task CreatePriceAsync(SalesProductPriceSaveInput input) { @@ -153,6 +217,14 @@ public partial class SalesProductService : ApplicationService /// /// 更新销售产品价格项。 /// + /// 入参：销售产品价格项保存参数。 + /// 无返回体，仅完成更新销售产品价格项。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/sales-product/price/update")] public async Task UpdatePriceAsync(SalesProductPriceSaveInput input) { @@ -181,6 +253,14 @@ public partial class SalesProductService : ApplicationService /// /// 删除销售产品价格项。 /// + /// 入参：目标主键。 + /// 无返回体，仅完成删除销售产品价格项。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/channel/sales-product/price/delete")] public async Task DeletePriceAsync(IdInput input) { @@ -191,6 +271,14 @@ public partial class SalesProductService : ApplicationService /// /// 切换销售产品价格项状态。 /// + /// 入参：目标主键和状态值。 + /// 无返回体，仅完成切换销售产品价格项状态。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 更新启停状态。 + /// 3. 保存状态变更结果。 + /// [HttpPost("/channel/sales-product/price/toggleStatus")] public async Task TogglePriceStatusAsync(ToggleStatusInput input) { @@ -201,6 +289,14 @@ public partial class SalesProductService : ApplicationService /// /// 批量保存销售产品价格项。 /// + /// 入参：销售产品价格项批量保存参数。 + /// 无返回体，仅完成批量保存销售产品价格项。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/sales-product/price/save")] public async Task SavePriceAsync(SalesProductPriceSaveAllInput input) { @@ -244,8 +340,16 @@ public partial class SalesProductService : ApplicationService } /// - /// 获取销售产品排货规则。 + /// 查询销售产品分配配置。 /// + /// 入参：销售产品主键。 + /// 销售产品分配配置。 + /// + /// 核心业务逻辑： + /// 1. 根据标识查询目标对象。 + /// 2. 目标不存在时抛出业务异常。 + /// 3. 映射并返回详情结果。 + /// [HttpGet("/channel/sales-product/allocation/get")] public Task GetAllocationAsync([FromQuery] long salesProductId) { @@ -253,8 +357,16 @@ public partial class SalesProductService : ApplicationService } /// - /// 保存销售产品排货规则。 + /// 保存销售产品分配配置。 /// + /// 入参：销售产品分配配置保存参数。 + /// 无返回体，仅完成保存销售产品分配配置。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/sales-product/allocation/save")] public async Task SaveAllocationAsync(SalesProductAllocationSaveInput input) { @@ -287,8 +399,16 @@ public partial class SalesProductService : ApplicationService } /// - /// 获取销售产品价格发布记录。 + /// 查询销售产品发布价格列表。 /// + /// 入参：销售产品发布列表查询条件。 + /// 销售产品发布价格分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/channel/sales-product/publish/price/list")] public Task> GetPricePublishListAsync([FromQuery] SalesProductPublishListInput input) { @@ -296,8 +416,16 @@ public partial class SalesProductService : ApplicationService } /// - /// 获取销售产品规则发布记录。 + /// 查询销售产品发布规则列表。 /// + /// 入参：销售产品发布列表查询条件。 + /// 销售产品发布规则分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/channel/sales-product/publish/rules/list")] public Task> GetRulesPublishListAsync([FromQuery] SalesProductPublishListInput input) { @@ -305,8 +433,16 @@ public partial class SalesProductService : ApplicationService } /// - /// 发布当前销售产品配置。 + /// 执行销售产品发布。 /// + /// 入参：销售产品发布参数。 + /// 无返回体，仅完成销售产品发布处理。 + /// + /// 核心业务逻辑： + /// 1. 校验目标对象和发布前提条件。 + /// 2. 生成、切换或回退发布版本数据。 + /// 3. 保存发布结果并返回处理信息。 + /// [HttpPost("/channel/sales-product/publish")] public async Task PublishAsync(SalesProductPublishInput input) { @@ -314,8 +450,16 @@ public partial class SalesProductService : ApplicationService } /// - /// 按发布记录回滚销售产品配置。 + /// 回滚销售产品发布版本。 /// + /// 入参：销售产品发布回滚参数。 + /// 无返回体，仅完成回滚销售产品发布版本。 + /// + /// 核心业务逻辑： + /// 1. 校验目标对象和发布前提条件。 + /// 2. 生成、切换或回退发布版本数据。 + /// 3. 保存发布结果并返回处理信息。 + /// [HttpPost("/channel/sales-product/publish/rollback")] public Task RollbackAsync(SalesProductRollbackInput input) { diff --git a/src/Oms.Application/Services/Channels/ServiceChannelService.cs b/src/Oms.Application/Services/Channels/ServiceChannelService.cs index 46bdf3d..47cc745 100644 --- a/src/Oms.Application/Services/Channels/ServiceChannelService.cs +++ b/src/Oms.Application/Services/Channels/ServiceChannelService.cs @@ -18,8 +18,16 @@ public partial class ServiceChannelService : ApplicationService private IServiceChannelRepository ServiceChannelRepository => LazyServiceProvider.GetRequiredService(); /// - /// 获取服务渠道分页列表。 + /// 查询服务渠道列表。 /// + /// 入参：服务渠道列表查询条件。 + /// 服务渠道分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/channel/service-channel/list")] public async Task> GetListAsync([FromQuery] ServiceChannelListInput input) { @@ -41,8 +49,16 @@ public partial class ServiceChannelService : ApplicationService } /// - /// 获取服务渠道详情。 + /// 查询服务渠道详情。 /// + /// 入参：目标主键。 + /// 服务渠道详情。 + /// + /// 核心业务逻辑： + /// 1. 根据标识查询目标对象。 + /// 2. 目标不存在时抛出业务异常。 + /// 3. 映射并返回详情结果。 + /// [HttpGet("/channel/service-channel/detail")] public async Task GetDetailAsync([FromQuery] long id) { @@ -53,6 +69,14 @@ public partial class ServiceChannelService : ApplicationService /// /// 新增服务渠道。 /// + /// 入参：服务渠道保存参数。 + /// 无返回体，仅完成新增服务渠道。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/channel/service-channel/create")] public async Task CreateAsync(ServiceChannelSaveInput input) { @@ -70,6 +94,14 @@ public partial class ServiceChannelService : ApplicationService /// /// 更新服务渠道。 /// + /// 入参：服务渠道保存参数。 + /// 无返回体，仅完成更新服务渠道。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/service-channel/update")] public async Task UpdateAsync(ServiceChannelSaveInput input) { @@ -84,6 +116,14 @@ public partial class ServiceChannelService : ApplicationService /// /// 删除服务渠道。 /// + /// 入参：目标主键。 + /// 无返回体，仅完成删除服务渠道。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/channel/service-channel/delete")] public async Task DeleteAsync(IdInput input) { @@ -97,6 +137,14 @@ public partial class ServiceChannelService : ApplicationService /// /// 保存服务渠道配置。 /// + /// 入参：服务渠道保存参数。 + /// 无返回体，仅完成保存服务渠道配置。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/service-channel/config/save")] public async Task SaveConfigAsync(ServiceChannelSaveInput input) { @@ -109,8 +157,16 @@ public partial class ServiceChannelService : ApplicationService } /// - /// 获取服务渠道买价项列表。 + /// 查询服务渠道价格项列表。 /// + /// 入参：serviceChannelId。 + /// 服务渠道价格项列表结果。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/channel/service-channel/price/list")] public async Task> GetPriceListAsync([FromQuery] long serviceChannelId) { @@ -122,8 +178,16 @@ public partial class ServiceChannelService : ApplicationService } /// - /// 新增服务渠道买价项。 + /// 新增服务渠道价格项。 /// + /// 入参：服务渠道价格项保存参数。 + /// 无返回体，仅完成新增服务渠道价格项。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/channel/service-channel/price/create")] public async Task CreatePriceAsync(ServiceChannelPriceSaveInput input) { @@ -151,8 +215,16 @@ public partial class ServiceChannelService : ApplicationService } /// - /// 更新服务渠道买价项。 + /// 更新服务渠道价格项。 /// + /// 入参：服务渠道价格项保存参数。 + /// 无返回体，仅完成更新服务渠道价格项。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/service-channel/price/update")] public async Task UpdatePriceAsync(ServiceChannelPriceSaveInput input) { @@ -179,8 +251,16 @@ public partial class ServiceChannelService : ApplicationService } /// - /// 删除服务渠道买价项。 + /// 删除服务渠道价格项。 /// + /// 入参：目标主键。 + /// 无返回体，仅完成删除服务渠道价格项。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/channel/service-channel/price/delete")] public async Task DeletePriceAsync(IdInput input) { @@ -189,8 +269,16 @@ public partial class ServiceChannelService : ApplicationService } /// - /// 切换服务渠道买价项状态。 + /// 切换服务渠道价格项状态。 /// + /// 入参：目标主键和状态值。 + /// 无返回体，仅完成切换服务渠道价格项状态。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 更新启停状态。 + /// 3. 保存状态变更结果。 + /// [HttpPost("/channel/service-channel/price/toggleStatus")] public async Task TogglePriceStatusAsync(ToggleStatusInput input) { @@ -199,8 +287,16 @@ public partial class ServiceChannelService : ApplicationService } /// - /// 批量保存服务渠道买价项。 + /// 批量保存服务渠道价格项。 /// + /// 入参：服务渠道价格项批量保存参数。 + /// 无返回体，仅完成批量保存服务渠道价格项。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/service-channel/price/save")] public async Task SavePriceAsync(ServiceChannelPriceSaveAllInput input) { @@ -244,8 +340,16 @@ public partial class ServiceChannelService : ApplicationService } /// - /// 获取服务渠道价格发布记录。 + /// 查询服务渠道发布价格列表。 /// + /// 入参：服务渠道发布列表查询条件。 + /// 服务渠道发布价格分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/channel/service-channel/publish/price/list")] public Task> GetPricePublishListAsync([FromQuery] ServiceChannelPublishListInput input) { @@ -253,8 +357,16 @@ public partial class ServiceChannelService : ApplicationService } /// - /// 获取服务渠道规则发布记录。 + /// 查询服务渠道发布规则列表。 /// + /// 入参：服务渠道发布列表查询条件。 + /// 服务渠道发布规则分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/channel/service-channel/publish/rules/list")] public Task> GetRulesPublishListAsync([FromQuery] ServiceChannelPublishListInput input) { @@ -262,8 +374,16 @@ public partial class ServiceChannelService : ApplicationService } /// - /// 发布当前服务渠道配置。 + /// 执行服务渠道发布。 /// + /// 入参：服务渠道发布参数。 + /// 无返回体，仅完成服务渠道发布处理。 + /// + /// 核心业务逻辑： + /// 1. 校验目标对象和发布前提条件。 + /// 2. 生成、切换或回退发布版本数据。 + /// 3. 保存发布结果并返回处理信息。 + /// [HttpPost("/channel/service-channel/publish")] public async Task PublishAsync(ServiceChannelPublishInput input) { @@ -271,8 +391,16 @@ public partial class ServiceChannelService : ApplicationService } /// - /// 按发布记录回滚服务渠道配置。 + /// 回滚服务渠道发布版本。 /// + /// 入参：服务渠道发布回滚参数。 + /// 无返回体，仅完成回滚服务渠道发布版本。 + /// + /// 核心业务逻辑： + /// 1. 校验目标对象和发布前提条件。 + /// 2. 生成、切换或回退发布版本数据。 + /// 3. 保存发布结果并返回处理信息。 + /// [HttpPost("/channel/service-channel/publish/rollback")] public Task RollbackAsync(ServiceChannelRollbackInput input) { diff --git a/src/Oms.Application/Services/Channels/WeightRoundingService.cs b/src/Oms.Application/Services/Channels/WeightRoundingService.cs index a5d89e8..ad4e521 100644 --- a/src/Oms.Application/Services/Channels/WeightRoundingService.cs +++ b/src/Oms.Application/Services/Channels/WeightRoundingService.cs @@ -15,8 +15,16 @@ public class WeightRoundingService : ApplicationService private IWeightRoundingRepository WeightRoundingRepository => LazyServiceProvider.GetRequiredService(); /// - /// 获取计重进位分页列表。 + /// 查询计重进位规则列表。 /// + /// 入参：计重进位规则列表查询条件。 + /// 计重进位规则分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpPost("/channel/weight-rounding/list")] public async Task> GetListAsync(WeightRoundingListInput input) { @@ -37,8 +45,16 @@ public class WeightRoundingService : ApplicationService } /// - /// 新增计重进位。 + /// 新增计重进位规则。 /// + /// 入参：计重进位规则保存参数。 + /// 无返回体，仅完成新增计重进位规则。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/channel/weight-rounding/create")] public async Task CreateAsync(WeightRoundingSaveInput input) { @@ -54,8 +70,16 @@ public class WeightRoundingService : ApplicationService } /// - /// 更新计重进位。 + /// 更新计重进位规则。 /// + /// 入参：计重进位规则保存参数。 + /// 无返回体，仅完成更新计重进位规则。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/weight-rounding/update")] public async Task UpdateAsync(WeightRoundingSaveInput input) { @@ -69,8 +93,16 @@ public class WeightRoundingService : ApplicationService } /// - /// 删除计重进位。 + /// 删除计重进位规则。 /// + /// 入参：目标主键。 + /// 无返回体，仅完成删除计重进位规则。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/channel/weight-rounding/delete")] public async Task DeleteAsync(IdInput input) { @@ -82,8 +114,16 @@ public class WeightRoundingService : ApplicationService } /// - /// 获取计重进位明细分页列表。 + /// 查询计重进位规则明细列表。 /// + /// 入参：计重进位规则明细列表查询条件。 + /// 计重进位规则明细分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpPost("/channel/weight-rounding/info/list")] public async Task> GetInfoListAsync(WeightRoundingInfoListInput input) { @@ -100,8 +140,16 @@ public class WeightRoundingService : ApplicationService } /// - /// 新增计重进位明细。 + /// 新增计重进位规则明细。 /// + /// 入参：计重进位规则明细保存参数。 + /// 无返回体，仅完成新增计重进位规则明细。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/channel/weight-rounding/info/add")] public async Task AddInfoAsync(WeightRoundingInfoSaveInput input) { @@ -121,8 +169,16 @@ public class WeightRoundingService : ApplicationService } /// - /// 更新计重进位明细。 + /// 更新计重进位规则明细。 /// + /// 入参：计重进位规则明细保存参数。 + /// 无返回体，仅完成更新计重进位规则明细。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/weight-rounding/info/update")] public async Task UpdateInfoAsync(WeightRoundingInfoSaveInput input) { @@ -140,8 +196,16 @@ public class WeightRoundingService : ApplicationService } /// - /// 删除计重进位明细。 + /// 删除计重进位规则明细。 /// + /// 入参：目标主键。 + /// 无返回体，仅完成删除计重进位规则明细。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/channel/weight-rounding/info/delete")] public async Task DeleteInfoAsync(IdInput input) { diff --git a/src/Oms.Application/Services/Channels/WeightRuleService.cs b/src/Oms.Application/Services/Channels/WeightRuleService.cs index 417bbe1..39a770b 100644 --- a/src/Oms.Application/Services/Channels/WeightRuleService.cs +++ b/src/Oms.Application/Services/Channels/WeightRuleService.cs @@ -15,8 +15,16 @@ public class WeightRuleService : ApplicationService private IWeightRuleRepository WeightRuleRepository => LazyServiceProvider.GetRequiredService(); /// - /// 获取计重规则分页列表。 + /// 查询计重规则列表。 /// + /// 入参：计重规则列表查询条件。 + /// 计重规则分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpPost("/channel/weight-rule/list")] public async Task> GetListAsync(WeightRuleListInput input) { @@ -39,6 +47,14 @@ public class WeightRuleService : ApplicationService /// /// 新增计重规则。 /// + /// 入参：计重规则保存参数。 + /// 无返回体，仅完成新增计重规则。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/channel/weight-rule/create")] public async Task CreateAsync(WeightRuleSaveInput input) { @@ -56,6 +72,14 @@ public class WeightRuleService : ApplicationService /// /// 更新计重规则。 /// + /// 入参：计重规则保存参数。 + /// 无返回体，仅完成更新计重规则。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/weight-rule/update")] public async Task UpdateAsync(WeightRuleSaveInput input) { @@ -71,6 +95,14 @@ public class WeightRuleService : ApplicationService /// /// 删除计重规则。 /// + /// 入参：目标主键。 + /// 无返回体，仅完成删除计重规则。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/channel/weight-rule/delete")] public async Task DeleteAsync(IdInput input) { @@ -82,8 +114,16 @@ public class WeightRuleService : ApplicationService } /// - /// 获取计重规则明细分页列表。 + /// 查询计重规则明细列表。 /// + /// 入参：计重规则明细列表查询条件。 + /// 计重规则明细分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpPost("/channel/weight-rule/info/list")] public async Task> GetInfoListAsync(WeightRuleInfoListInput input) { @@ -102,6 +142,14 @@ public class WeightRuleService : ApplicationService /// /// 新增计重规则明细。 /// + /// 入参：计重规则明细保存参数。 + /// 无返回体，仅完成新增计重规则明细。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/channel/weight-rule/info/add")] public async Task AddInfoAsync(WeightRuleInfoSaveInput input) { @@ -122,6 +170,14 @@ public class WeightRuleService : ApplicationService /// /// 更新计重规则明细。 /// + /// 入参：计重规则明细保存参数。 + /// 无返回体，仅完成更新计重规则明细。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/channel/weight-rule/info/update")] public async Task UpdateInfoAsync(WeightRuleInfoSaveInput input) { @@ -140,6 +196,14 @@ public class WeightRuleService : ApplicationService /// /// 删除计重规则明细。 /// + /// 入参：目标主键。 + /// 无返回体，仅完成删除计重规则明细。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/channel/weight-rule/info/delete")] public async Task DeleteInfoAsync(IdInput input) { diff --git a/src/Oms.Application/Services/Customers/CustomerService.cs b/src/Oms.Application/Services/Customers/CustomerService.cs index 40fa9aa..b5fb73c 100644 --- a/src/Oms.Application/Services/Customers/CustomerService.cs +++ b/src/Oms.Application/Services/Customers/CustomerService.cs @@ -14,6 +14,17 @@ public class CustomerService : ApplicationService { private ICustomerRepository CustomerRepository => LazyServiceProvider.GetRequiredService(); + /// + /// 查询客户列表。 + /// + /// 入参：客户分页查询条件。 + /// 客户分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/customer/list")] public async Task> GetPaginatedListAsync([FromQuery] CustomerPaginatedInput input) { @@ -37,6 +48,17 @@ public class CustomerService : ApplicationService }; } + /// + /// 查询客户详情。 + /// + /// 入参：目标主键。 + /// 客户详情。 + /// + /// 核心业务逻辑： + /// 1. 根据标识查询目标对象。 + /// 2. 目标不存在时抛出业务异常。 + /// 3. 映射并返回详情结果。 + /// [HttpGet("/customer/get")] public async Task GetByIdAsync([FromQuery] long id) { @@ -48,6 +70,17 @@ public class CustomerService : ApplicationService return output; } + /// + /// 新增客户。 + /// + /// 入参：客户创建参数。 + /// 无返回体，仅完成新增客户。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/customer/create")] public async Task CreateAsync(CreateCustomerInput input) { @@ -90,6 +123,17 @@ public class CustomerService : ApplicationService await CustomerRepository.InsertAsync(entity); } + /// + /// 更新客户。 + /// + /// 入参：客户更新参数。 + /// 无返回体，仅完成更新客户。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/customer/update")] public async Task UpdateAsync(UpdateCustomerInput input) { @@ -117,6 +161,17 @@ public class CustomerService : ApplicationService await CustomerRepository.UpdateAsync(entity); } + /// + /// 删除客户。 + /// + /// 入参：目标主键。 + /// 无返回体，仅完成删除客户。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/customer/delete")] public async Task DeleteAsync(IdInput input) { @@ -127,6 +182,17 @@ public class CustomerService : ApplicationService await CustomerRepository.UpdateAsync(entity); } + /// + /// 重置客户密码。 + /// + /// 入参：客户密码重置参数。 + /// 无返回体，仅完成重置客户密码。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象及当前状态。 + /// 2. 执行业务状态流转或敏感字段更新。 + /// 3. 写入审计字段并保存结果。 + /// [HttpPost("/customer/reset-password")] public async Task ResetPasswordAsync(ResetCustomerPasswordInput input) { diff --git a/src/Oms.Application/Services/Operations/InboundRecordService.cs b/src/Oms.Application/Services/Operations/InboundRecordService.cs index 4d2df0a..0467491 100644 --- a/src/Oms.Application/Services/Operations/InboundRecordService.cs +++ b/src/Oms.Application/Services/Operations/InboundRecordService.cs @@ -16,6 +16,17 @@ public class InboundRecordService : ApplicationService private ISalesProductRepository SalesProductRepository => LazyServiceProvider.GetRequiredService(); private IWarehouseAddressRepository WarehouseAddressRepository => LazyServiceProvider.GetRequiredService(); + /// + /// 新增入库记录。 + /// + /// 入参：入库记录创建参数。 + /// 入库记录结果。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/operation/inbound/create")] public async Task CreateAsync(CreateInboundRecordInput input) { @@ -42,6 +53,18 @@ public class InboundRecordService : ApplicationService return ObjectMapper.Map(savedEntity); } + /// + /// 查询最近入库记录列表。 + /// + /// 入参：返回记录条数上限。 + /// 入参：warehouseId。 + /// 入库记录列表结果。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/operation/inbound/recent-list")] public async Task> GetRecentListAsync([FromQuery] int limit = 20, [FromQuery] long? warehouseId = null) { diff --git a/src/Oms.Application/Services/Operations/LabelPrintService.cs b/src/Oms.Application/Services/Operations/LabelPrintService.cs index 4711685..352d588 100644 --- a/src/Oms.Application/Services/Operations/LabelPrintService.cs +++ b/src/Oms.Application/Services/Operations/LabelPrintService.cs @@ -16,6 +16,17 @@ public class LabelPrintService : ApplicationService private ILabelPrintRecordRepository LabelPrintRecordRepository => LazyServiceProvider.GetRequiredService(); private ILabelTemplateRepository LabelTemplateRepository => LazyServiceProvider.GetRequiredService(); + /// + /// 执行面单打印。 + /// + /// 入参：面单打印参数。 + /// 面单打印记录。 + /// + /// 核心业务逻辑： + /// 1. 校验模板、目标单据等前置依赖数据。 + /// 2. 执行打印逻辑并记录打印结果。 + /// 3. 返回打印结果信息。 + /// [HttpPost("/operation/print-label/print")] public async Task PrintAsync(PrintLabelInput input) { @@ -81,6 +92,18 @@ public class LabelPrintService : ApplicationService return output; } + /// + /// 查询最近面单打印记录列表。 + /// + /// 入参：返回记录条数上限。 + /// 入参：标签模板主键，可选。 + /// 面单打印记录列表结果。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/operation/print-label/recent-list")] public async Task> GetRecentListAsync([FromQuery] int limit = 20, [FromQuery] long? labelTemplateId = null) { @@ -111,6 +134,17 @@ public class LabelPrintService : ApplicationService return new OmsItemsResult { Items = items }; } + /// + /// 查询标签模板列表。 + /// + /// 入参：模板类型，可选。 + /// 标签模板列表结果。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/operation/print-label/template-list")] public async Task> GetTemplateDropdownListAsync([FromQuery] string? templateType = null) { diff --git a/src/Oms.Application/Services/Operations/OutboundRecordService.cs b/src/Oms.Application/Services/Operations/OutboundRecordService.cs index 3915434..3e60f4c 100644 --- a/src/Oms.Application/Services/Operations/OutboundRecordService.cs +++ b/src/Oms.Application/Services/Operations/OutboundRecordService.cs @@ -14,6 +14,17 @@ public class OutboundRecordService : ApplicationService private IOutboundRecordRepository OutboundRecordRepository => LazyServiceProvider.GetRequiredService(); private IWarehouseAddressRepository WarehouseAddressRepository => LazyServiceProvider.GetRequiredService(); + /// + /// 新增出库记录。 + /// + /// 入参：出库记录创建参数。 + /// 出库记录结果。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/operation/outbound/create")] public async Task CreateAsync(CreateOutboundRecordInput input) { @@ -34,6 +45,18 @@ public class OutboundRecordService : ApplicationService return ObjectMapper.Map(savedEntity); } + /// + /// 查询最近出库记录列表。 + /// + /// 入参：返回记录条数上限。 + /// 入参：warehouseId。 + /// 出库记录列表结果。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/operation/outbound/recent-list")] public async Task> GetRecentListAsync([FromQuery] int limit = 20, [FromQuery] long? warehouseId = null) { diff --git a/src/Oms.Application/Services/Orders/OrderService.cs b/src/Oms.Application/Services/Orders/OrderService.cs index 63ee798..5e29b90 100644 --- a/src/Oms.Application/Services/Orders/OrderService.cs +++ b/src/Oms.Application/Services/Orders/OrderService.cs @@ -26,15 +26,15 @@ public partial class OrderService : ApplicationService private IWebHostEnvironment WebHostEnvironment => LazyServiceProvider.GetRequiredService(); /// - /// 分页查询订单列表。 + /// 查询订单列表。 /// - /// 入参：分页信息、订单状态、关键词、创建时间起止。 - /// 出参：订单分页结果，包含当前页订单集合和总记录数。 + /// 入参：订单分页查询条件。 + /// 订单分页结果，包含列表数据和总记录数。 /// /// 核心业务逻辑： - /// 1. 统一归一化页码和页大小； - /// 2. 根据状态、关键词、创建时间区间构造筛选表达式； - /// 3. 查询分页数据后补齐订单展示所需的映射字段。 + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 /// [HttpPost("/order/list")] public async Task> GetPaginatedListAsync(OrderPaginatedInput input) @@ -51,6 +51,17 @@ public partial class OrderService : ApplicationService return new OmsPageResult { Items = await MapOrderOutputsAsync(orders), Total = total }; } + /// + /// 查询订单详情。 + /// + /// 入参：目标主键。 + /// 订单详情。 + /// + /// 核心业务逻辑： + /// 1. 根据标识查询目标对象。 + /// 2. 目标不存在时抛出业务异常。 + /// 3. 映射并返回详情结果。 + /// [HttpGet("/order/detail")] public async Task GetDetailAsync([FromQuery] long id) { @@ -58,6 +69,17 @@ public partial class OrderService : ApplicationService return (await MapOrderOutputsAsync([order])).First(); } + /// + /// 执行订单支付。 + /// + /// 入参：订单操作参数。 + /// 无返回体，仅完成订单支付处理。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象及当前状态。 + /// 2. 执行业务状态流转或敏感字段更新。 + /// 3. 写入审计字段并保存结果。 + /// [HttpPost("/order/pay")] public async Task PayAsync(OrderActionInput input) { @@ -67,6 +89,17 @@ public partial class OrderService : ApplicationService await UpdateOrderAsync(order); } + /// + /// 执行订单预报。 + /// + /// 入参：订单操作参数。 + /// 无返回体，仅完成订单预报处理。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象及当前状态。 + /// 2. 执行业务状态流转或敏感字段更新。 + /// 3. 写入审计字段并保存结果。 + /// [HttpPost("/order/pre-declare")] public async Task PreDeclareAsync(OrderActionInput input) { @@ -75,6 +108,17 @@ public partial class OrderService : ApplicationService await UpdateOrderAsync(order); } + /// + /// 执行订单拦截。 + /// + /// 入参：订单操作参数。 + /// 无返回体，仅完成订单拦截处理。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象及当前状态。 + /// 2. 执行业务状态流转或敏感字段更新。 + /// 3. 写入审计字段并保存结果。 + /// [HttpPost("/order/intercept")] public async Task InterceptAsync(OrderActionInput input) { @@ -83,6 +127,17 @@ public partial class OrderService : ApplicationService await UpdateOrderAsync(order); } + /// + /// 取消订单拦截。 + /// + /// 入参：订单操作参数。 + /// 无返回体，仅完成取消订单拦截。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象及当前状态。 + /// 2. 执行业务状态流转或敏感字段更新。 + /// 3. 写入审计字段并保存结果。 + /// [HttpPost("/order/cancel-intercept")] public async Task CancelInterceptAsync(OrderActionInput input) { @@ -91,6 +146,17 @@ public partial class OrderService : ApplicationService await UpdateOrderAsync(order); } + /// + /// 删除订单。 + /// + /// 入参：订单操作参数。 + /// 无返回体，仅完成删除订单。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/order/delete")] public async Task DeleteAsync(OrderActionInput input) { @@ -100,6 +166,17 @@ public partial class OrderService : ApplicationService await UpdateOrderAsync(order); } + /// + /// 打印订单。 + /// + /// 入参：订单操作参数。 + /// 订单打印结果。 + /// + /// 核心业务逻辑： + /// 1. 校验模板、目标单据等前置依赖数据。 + /// 2. 执行打印逻辑并记录打印结果。 + /// 3. 返回打印结果信息。 + /// [HttpPost("/order/print")] public async Task PrintAsync(OrderActionInput input) { @@ -109,12 +186,15 @@ public partial class OrderService : ApplicationService } /// - /// 导出订单列表。 + /// 导出订单。 /// - /// 入参：订单状态、关键词、创建时间起止。 - /// 出参：导出文件下载地址及失效时间。 + /// 入参：订单导出筛选条件。 + /// 订单导出结果。 /// - /// 核心业务逻辑：先清理过期文件，再按筛选条件查询订单，最后生成 Excel 并返回下载信息。 + /// 核心业务逻辑： + /// 1. 根据筛选条件查询待导出数据或定位模板资源。 + /// 2. 生成文件内容或组装下载响应。 + /// 3. 以文件形式返回结果。 /// [HttpPost("/order/export")] public async Task ExportAsync(OrderExportInput input) @@ -134,6 +214,17 @@ public partial class OrderService : ApplicationService }; } + /// + /// 执行订单运费试算。 + /// + /// 入参：订单运费试算参数。 + /// 订单运费试算列表结果。 + /// + /// 核心业务逻辑： + /// 1. 根据试算参数构造报价请求。 + /// 2. 汇总费用、时效等试算结果。 + /// 3. 按接口约定返回结果列表。 + /// [HttpPost("/order/price-check")] public async Task> PriceCheckAsync(OrderPriceCheckInput input) { @@ -141,6 +232,17 @@ public partial class OrderService : ApplicationService return new OmsItemsResult { Items = items }; } + /// + /// 查询订单模板列表。 + /// + /// 入参：订单模板列表查询条件。 + /// 订单模板分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/order/template/list")] public async Task> GetTemplateListAsync([FromQuery] OrderTemplateListInput input) { @@ -148,30 +250,85 @@ public partial class OrderService : ApplicationService return items; } + /// + /// 下载订单模板文件。 + /// + /// 入参：模板主键。 + /// 文件流响应。 + /// + /// 核心业务逻辑： + /// 1. 根据筛选条件查询待导出数据或定位模板资源。 + /// 2. 生成文件内容或组装下载响应。 + /// 3. 以文件形式返回结果。 + /// [HttpGet("/order/template/download")] public async Task DownloadTemplateAsync([FromQuery] long templateId) { return await BuildTemplateDownloadAsync(templateId); } + /// + /// 导入订单文件。 + /// + /// 入参：订单导入参数。 + /// 订单导入结果。 + /// + /// 核心业务逻辑： + /// 1. 校验上传文件及导入参数。 + /// 2. 解析文件内容并执行导入流程。 + /// 3. 汇总成功失败结果后返回。 + /// [HttpPost("/order/upload")] public async Task UploadAsync([FromForm] OrderUploadInput input) { return await ImportOrdersAsync(input); } + /// + /// 查询订单任务列表。 + /// + /// 入参：订单任务列表查询条件。 + /// 订单任务分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/order/task/list")] public async Task> GetTaskListAsync([FromQuery] OrderTaskListInput input) { return await GetTaskOutputsAsync(input); } + /// + /// 查询订单任务详情。 + /// + /// 入参：任务主键。 + /// 订单任务详情。 + /// + /// 核心业务逻辑： + /// 1. 根据标识查询目标对象。 + /// 2. 目标不存在时抛出业务异常。 + /// 3. 映射并返回详情结果。 + /// [HttpGet("/order/task/detail")] public async Task GetTaskDetailAsync([FromQuery] long taskId) { return await GetTaskDetailCoreAsync(taskId); } + /// + /// 创建订单包裹。 + /// + /// 入参：订单包裹创建参数。 + /// 订单包裹创建结果。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/order/parcel/create")] public async Task CreateParcelAsync(OrderParcelCreateInput input) { diff --git a/src/Oms.Application/Services/Recharge/RechargeService.cs b/src/Oms.Application/Services/Recharge/RechargeService.cs index 75a458b..8cd5a6d 100644 --- a/src/Oms.Application/Services/Recharge/RechargeService.cs +++ b/src/Oms.Application/Services/Recharge/RechargeService.cs @@ -18,6 +18,17 @@ public class RechargeService : ApplicationService private IRechargeRecordRepository RechargeRecordRepository => LazyServiceProvider.GetRequiredService(); private ICustomerRepository CustomerRepository => LazyServiceProvider.GetRequiredService(); + /// + /// 提交充值申请。 + /// + /// 入参：充值提交参数。 + /// 充值记录结果。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/recharge/recharge/submit")] public async Task SubmitAsync(SubmitRechargeInput input) { @@ -54,6 +65,17 @@ public class RechargeService : ApplicationService return ObjectMapper.Map(savedEntity); } + /// + /// 审核通过充值记录。 + /// + /// 入参：充值审核通过参数。 + /// 无返回体，仅完成审核通过充值记录。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象及当前状态。 + /// 2. 执行业务状态流转或敏感字段更新。 + /// 3. 写入审计字段并保存结果。 + /// [HttpPost("/recharge/recharge-record/approve")] public async Task ApproveAsync(ApproveRechargeInput input) { @@ -87,6 +109,17 @@ public class RechargeService : ApplicationService await CustomerRepository.UpdateAsync(customer); } + /// + /// 驳回充值记录。 + /// + /// 入参：充值审核驳回参数。 + /// 无返回体，仅完成驳回充值记录。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象及当前状态。 + /// 2. 执行业务状态流转或敏感字段更新。 + /// 3. 写入审计字段并保存结果。 + /// [HttpPost("/recharge/recharge-record/reject")] public async Task RejectAsync(RejectRechargeInput input) { @@ -107,15 +140,15 @@ public class RechargeService : ApplicationService } /// - /// 分页查询充值记录列表。 + /// 查询充值记录列表。 /// - /// 入参：分页信息、客户、充值流水号、审核状态、充值时间区间。 - /// 出参：充值记录分页结果，包含列表数据和总记录数。 + /// 入参：充值记录分页查询条件。 + /// 充值记录分页结果，包含列表数据和总记录数。 /// /// 核心业务逻辑： - /// 1. 先根据筛选条件查询充值记录； - /// 2. 再批量补齐客户编码和手机号等展示字段； - /// 3. 最后返回前端可直接渲染的分页结果。 + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 /// [HttpGet("/recharge/recharge-record/list")] public async Task> GetPaginatedListAsync([FromQuery] RechargeRecordPaginatedInput input) @@ -164,10 +197,13 @@ public class RechargeService : ApplicationService /// /// 导出充值记录。 /// - /// 入参：客户和充值时间区间。 - /// 出参：Excel 文件内容。 + /// 入参：充值记录导出筛选条件。 + /// 文件流响应。 /// - /// 核心业务逻辑：根据导出条件查询充值记录，补齐客户展示字段后直接生成 Excel 文件流。 + /// 核心业务逻辑： + /// 1. 根据筛选条件查询待导出数据或定位模板资源。 + /// 2. 生成文件内容或组装下载响应。 + /// 3. 以文件形式返回结果。 /// [HttpGet("/recharge/export")] public async Task ExportAsync([FromQuery] RechargeExportInput input) diff --git a/src/Oms.Application/Services/System/WarehouseService.cs b/src/Oms.Application/Services/System/WarehouseService.cs index 590f2b7..49f15ab 100644 --- a/src/Oms.Application/Services/System/WarehouseService.cs +++ b/src/Oms.Application/Services/System/WarehouseService.cs @@ -15,6 +15,17 @@ public class WarehouseService : ApplicationService { private IWarehouseAddressRepository WarehouseAddressRepository => LazyServiceProvider.GetRequiredService(); + /// + /// 查询仓库列表。 + /// + /// 入参：仓库分页查询条件。 + /// 仓库分页结果，包含列表数据和总记录数。 + /// + /// 核心业务逻辑： + /// 1. 根据查询条件构造筛选规则。 + /// 2. 查询目标数据并补齐关联展示字段。 + /// 3. 按接口约定返回列表结果。 + /// [HttpGet("/system/warehouse/list")] public async Task> GetPaginatedListAsync([FromQuery] WarehousePaginatedInput input) { @@ -44,6 +55,17 @@ public class WarehouseService : ApplicationService }; } + /// + /// 查询仓库详情。 + /// + /// 入参：目标主键。 + /// 仓库详情。 + /// + /// 核心业务逻辑： + /// 1. 根据标识查询目标对象。 + /// 2. 目标不存在时抛出业务异常。 + /// 3. 映射并返回详情结果。 + /// [HttpGet("/system/warehouse/detail")] public async Task GetByIdAsync([FromQuery] long id) { @@ -55,6 +77,17 @@ public class WarehouseService : ApplicationService return output; } + /// + /// 新增仓库。 + /// + /// 入参：仓库创建参数。 + /// 无返回体，仅完成新增仓库。 + /// + /// 核心业务逻辑： + /// 1. 校验入参与关联对象、唯一性等前置条件。 + /// 2. 组装目标实体及相关明细数据。 + /// 3. 写入审计字段并持久化结果。 + /// [HttpPost("/system/warehouse/create")] public async Task CreateAsync(CreateWarehouseInput input) { @@ -82,6 +115,17 @@ public class WarehouseService : ApplicationService await WarehouseAddressRepository.InsertAsync(entity); } + /// + /// 更新仓库。 + /// + /// 入参：仓库更新参数。 + /// 无返回体，仅完成更新仓库。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 按入参更新主体数据和关联配置。 + /// 3. 写入更新审计字段并保存结果。 + /// [HttpPost("/system/warehouse/update")] public async Task UpdateAsync(UpdateWarehouseInput input) { @@ -106,6 +150,17 @@ public class WarehouseService : ApplicationService await WarehouseAddressRepository.UpdateAsync(entity); } + /// + /// 删除仓库。 + /// + /// 入参：目标主键。 + /// 无返回体，仅完成删除仓库。 + /// + /// 核心业务逻辑： + /// 1. 查询并校验目标对象。 + /// 2. 执行软删除或删除关联明细。 + /// 3. 持久化删除结果。 + /// [HttpPost("/system/warehouse/delete")] public async Task DeleteAsync(IdInput input) { diff --git a/src/SimpleAdmin.Api/Properties/launchSettings.json b/src/SimpleAdmin.Api/Properties/launchSettings.json index cf2b1c9..63a8b9b 100644 --- a/src/SimpleAdmin.Api/Properties/launchSettings.json +++ b/src/SimpleAdmin.Api/Properties/launchSettings.json @@ -10,6 +10,17 @@ "environmentVariables": { "ASPNETCORE_ENVIRONMENT": "Development" } + }, + "staging": { + "commandName": "Project", + "dotnetRunMessages": true, + "launchBrowser": false, + "launchUrl": "", + "applicationUrl": "http://localhost:5281", + "environmentVariables": { + "ASPNETCORE_ENVIRONMENT": "Staging", + "ASPNETCORE_PATHBASE": "/admin" + } } } }