From 84ac31158cf32b2395655ad142792065bb8b2a75 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=B4=BA=E7=88=B1=E6=B3=BD?= <heaize404@163.com>
Date: Mon, 1 Dec 2025 13:31:28 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E9=BD=90=E6=A0=B8=E5=BF=83?=
 =?UTF-8?q?=E6=9E=9A=E4=B8=BE=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../Deliveries/Enums/DeliveryProvider.cs      | 23 ++++++++++++++++
 .../Deliveries/Enums/DeliveryStatus.cs        | 27 +++++++++++++++++++
 .../Merchants/Enums/MerchantStatus.cs         | 15 +++++++++++
 .../Orders/Enums/DeliveryType.cs              | 11 ++++++++
 .../Orders/Enums/OrderChannel.cs              | 23 ++++++++++++++++
 .../Orders/Enums/OrderStatus.cs               | 23 ++++++++++++++++
 .../Payments/Enums/PaymentMethod.cs           | 23 ++++++++++++++++
 .../Payments/Enums/PaymentStatus.cs           | 19 +++++++++++++
 .../Products/Enums/ProductStatus.cs           | 15 +++++++++++
 .../Queues/Enums/QueueStatus.cs               | 19 +++++++++++++
 .../Reservations/Enums/ReservationStatus.cs   | 19 +++++++++++++
 11 files changed, 217 insertions(+)

diff --git a/src/Domain/TakeoutSaaS.Domain/Deliveries/Enums/DeliveryProvider.cs b/src/Domain/TakeoutSaaS.Domain/Deliveries/Enums/DeliveryProvider.cs
index 70cff85..7957eb7 100644
--- a/src/Domain/TakeoutSaaS.Domain/Deliveries/Enums/DeliveryProvider.cs
+++ b/src/Domain/TakeoutSaaS.Domain/Deliveries/Enums/DeliveryProvider.cs
@@ -5,10 +5,33 @@ namespace TakeoutSaaS.Domain.Deliveries.Enums;
 /// </summary>
 public enum DeliveryProvider
 {
+    /// <summary>
+    /// 自建配送团队。
+    /// </summary>
     InHouse = 0,
+
+    /// <summary>
+    /// 达达。
+    /// </summary>
     Dada = 1,
+
+    /// <summary>
+    /// 闪送。
+    /// </summary>
     FlashEx = 2,
+
+    /// <summary>
+    /// 美团配送。
+    /// </summary>
     Meituan = 3,
+
+    /// <summary>
+    /// 饿了么配送。
+    /// </summary>
     Eleme = 4,
+
+    /// <summary>
+    /// 顺丰同城。
+    /// </summary>
     Shunfeng = 5
 }
diff --git a/src/Domain/TakeoutSaaS.Domain/Deliveries/Enums/DeliveryStatus.cs b/src/Domain/TakeoutSaaS.Domain/Deliveries/Enums/DeliveryStatus.cs
index 7f6aaef..1d2ae38 100644
--- a/src/Domain/TakeoutSaaS.Domain/Deliveries/Enums/DeliveryStatus.cs
+++ b/src/Domain/TakeoutSaaS.Domain/Deliveries/Enums/DeliveryStatus.cs
@@ -5,11 +5,38 @@ namespace TakeoutSaaS.Domain.Deliveries.Enums;
 /// </summary>
 public enum DeliveryStatus
 {
+    /// <summary>
+    /// 待接单。
+    /// </summary>
     Pending = 0,
+
+    /// <summary>
+    /// 骑手已接单。
+    /// </summary>
     Accepted = 1,
+
+    /// <summary>
+    /// 正在取餐。
+    /// </summary>
     PickingUp = 2,
+
+    /// <summary>
+    /// 配送途中。
+    /// </summary>
     Delivering = 3,
+
+    /// <summary>
+    /// 已送达完成。
+    /// </summary>
     Completed = 4,
+
+    /// <summary>
+    /// 被取消。
+    /// </summary>
     Cancelled = 5,
+
+    /// <summary>
+    /// 配送失败。
+    /// </summary>
     Failed = 6
 }
diff --git a/src/Domain/TakeoutSaaS.Domain/Merchants/Enums/MerchantStatus.cs b/src/Domain/TakeoutSaaS.Domain/Merchants/Enums/MerchantStatus.cs
index 6ed8097..820e8cd 100644
--- a/src/Domain/TakeoutSaaS.Domain/Merchants/Enums/MerchantStatus.cs
+++ b/src/Domain/TakeoutSaaS.Domain/Merchants/Enums/MerchantStatus.cs
@@ -5,8 +5,23 @@ namespace TakeoutSaaS.Domain.Merchants.Enums;
 /// </summary>
 public enum MerchantStatus
 {
+    /// <summary>
+    /// 等待审核。
+    /// </summary>
     Pending = 0,
+
+    /// <summary>
+    /// 审核通过，可运营。
+    /// </summary>
     Approved = 1,
+
+    /// <summary>
+    /// 审核未通过。
+    /// </summary>
     Rejected = 2,
+
+    /// <summary>
+    /// 因违规或欠费被冻结。
+    /// </summary>
     Frozen = 3
 }
diff --git a/src/Domain/TakeoutSaaS.Domain/Orders/Enums/DeliveryType.cs b/src/Domain/TakeoutSaaS.Domain/Orders/Enums/DeliveryType.cs
index 4a7249f..799365b 100644
--- a/src/Domain/TakeoutSaaS.Domain/Orders/Enums/DeliveryType.cs
+++ b/src/Domain/TakeoutSaaS.Domain/Orders/Enums/DeliveryType.cs
@@ -5,7 +5,18 @@ namespace TakeoutSaaS.Domain.Orders.Enums;
 /// </summary>
 public enum DeliveryType
 {
+    /// <summary>
+    /// 堂食。
+    /// </summary>
     DineIn = 0,
+
+    /// <summary>
+    /// 门店自提。
+    /// </summary>
     Pickup = 1,
+
+    /// <summary>
+    /// 同城配送。
+    /// </summary>
     Delivery = 2
 }
diff --git a/src/Domain/TakeoutSaaS.Domain/Orders/Enums/OrderChannel.cs b/src/Domain/TakeoutSaaS.Domain/Orders/Enums/OrderChannel.cs
index 6908ac6..e7a1306 100644
--- a/src/Domain/TakeoutSaaS.Domain/Orders/Enums/OrderChannel.cs
+++ b/src/Domain/TakeoutSaaS.Domain/Orders/Enums/OrderChannel.cs
@@ -5,10 +5,33 @@ namespace TakeoutSaaS.Domain.Orders.Enums;
 /// </summary>
 public enum OrderChannel
 {
+    /// <summary>
+    /// 未知渠道。
+    /// </summary>
     Unknown = 0,
+
+    /// <summary>
+    /// 小程序下单。
+    /// </summary>
     MiniProgram = 1,
+
+    /// <summary>
+    /// 扫码点餐。
+    /// </summary>
     ScanToOrder = 2,
+
+    /// <summary>
+    /// 员工操作台。
+    /// </summary>
     StaffConsole = 3,
+
+    /// <summary>
+    /// 电话预约。
+    /// </summary>
     PhoneReservation = 4,
+
+    /// <summary>
+    /// 第三方配送渠道。
+    /// </summary>
     ThirdPartyDelivery = 5
 }
diff --git a/src/Domain/TakeoutSaaS.Domain/Orders/Enums/OrderStatus.cs b/src/Domain/TakeoutSaaS.Domain/Orders/Enums/OrderStatus.cs
index 4132e46..347d61f 100644
--- a/src/Domain/TakeoutSaaS.Domain/Orders/Enums/OrderStatus.cs
+++ b/src/Domain/TakeoutSaaS.Domain/Orders/Enums/OrderStatus.cs
@@ -5,10 +5,33 @@ namespace TakeoutSaaS.Domain.Orders.Enums;
 /// </summary>
 public enum OrderStatus
 {
+    /// <summary>
+    /// 待付款。
+    /// </summary>
     PendingPayment = 0,
+
+    /// <summary>
+    /// 已付款待制作。
+    /// </summary>
     AwaitingPreparation = 1,
+
+    /// <summary>
+    /// 制作/履约中。
+    /// </summary>
     InProgress = 2,
+
+    /// <summary>
+    /// 可取餐/可自提。
+    /// </summary>
     Ready = 3,
+
+    /// <summary>
+    /// 已完成。
+    /// </summary>
     Completed = 4,
+
+    /// <summary>
+    /// 已取消。
+    /// </summary>
     Cancelled = 5
 }
diff --git a/src/Domain/TakeoutSaaS.Domain/Payments/Enums/PaymentMethod.cs b/src/Domain/TakeoutSaaS.Domain/Payments/Enums/PaymentMethod.cs
index 2453be2..7aa7807 100644
--- a/src/Domain/TakeoutSaaS.Domain/Payments/Enums/PaymentMethod.cs
+++ b/src/Domain/TakeoutSaaS.Domain/Payments/Enums/PaymentMethod.cs
@@ -5,10 +5,33 @@ namespace TakeoutSaaS.Domain.Payments.Enums;
 /// </summary>
 public enum PaymentMethod
 {
+    /// <summary>
+    /// 未知或待确定方式。
+    /// </summary>
     Unknown = 0,
+
+    /// <summary>
+    /// 微信支付。
+    /// </summary>
     WeChatPay = 1,
+
+    /// <summary>
+    /// 支付宝。
+    /// </summary>
     Alipay = 2,
+
+    /// <summary>
+    /// 现金。
+    /// </summary>
     Cash = 3,
+
+    /// <summary>
+    /// 刷卡（POS）。
+    /// </summary>
     Card = 4,
+
+    /// <summary>
+    /// 余额或储值账户。
+    /// </summary>
     Balance = 5
 }
diff --git a/src/Domain/TakeoutSaaS.Domain/Payments/Enums/PaymentStatus.cs b/src/Domain/TakeoutSaaS.Domain/Payments/Enums/PaymentStatus.cs
index 6b5912a..550e1ee 100644
--- a/src/Domain/TakeoutSaaS.Domain/Payments/Enums/PaymentStatus.cs
+++ b/src/Domain/TakeoutSaaS.Domain/Payments/Enums/PaymentStatus.cs
@@ -5,9 +5,28 @@ namespace TakeoutSaaS.Domain.Payments.Enums;
 /// </summary>
 public enum PaymentStatus
 {
+    /// <summary>
+    /// 未支付。
+    /// </summary>
     Unpaid = 0,
+
+    /// <summary>
+    /// 支付处理中。
+    /// </summary>
     Paying = 1,
+
+    /// <summary>
+    /// 支付成功。
+    /// </summary>
     Paid = 2,
+
+    /// <summary>
+    /// 支付失败。
+    /// </summary>
     Failed = 3,
+
+    /// <summary>
+    /// 已退款。
+    /// </summary>
     Refunded = 4
 }
diff --git a/src/Domain/TakeoutSaaS.Domain/Products/Enums/ProductStatus.cs b/src/Domain/TakeoutSaaS.Domain/Products/Enums/ProductStatus.cs
index 8678fcc..916679b 100644
--- a/src/Domain/TakeoutSaaS.Domain/Products/Enums/ProductStatus.cs
+++ b/src/Domain/TakeoutSaaS.Domain/Products/Enums/ProductStatus.cs
@@ -5,8 +5,23 @@ namespace TakeoutSaaS.Domain.Products.Enums;
 /// </summary>
 public enum ProductStatus
 {
+    /// <summary>
+    /// 草稿，尚未上架。
+    /// </summary>
     Draft = 0,
+
+    /// <summary>
+    /// 已上架售卖中。
+    /// </summary>
     OnSale = 1,
+
+    /// <summary>
+    /// 临时下架。
+    /// </summary>
     OffShelf = 2,
+
+    /// <summary>
+    /// 归档不再使用。
+    /// </summary>
     Archived = 3
 }
diff --git a/src/Domain/TakeoutSaaS.Domain/Queues/Enums/QueueStatus.cs b/src/Domain/TakeoutSaaS.Domain/Queues/Enums/QueueStatus.cs
index f217a70..8149725 100644
--- a/src/Domain/TakeoutSaaS.Domain/Queues/Enums/QueueStatus.cs
+++ b/src/Domain/TakeoutSaaS.Domain/Queues/Enums/QueueStatus.cs
@@ -5,9 +5,28 @@ namespace TakeoutSaaS.Domain.Queues.Enums;
 /// </summary>
 public enum QueueStatus
 {
+    /// <summary>
+    /// 正在排队等待。
+    /// </summary>
     Waiting = 0,
+
+    /// <summary>
+    /// 已叫号。
+    /// </summary>
     Calling = 1,
+
+    /// <summary>
+    /// 完成入座或取餐。
+    /// </summary>
     Completed = 2,
+
+    /// <summary>
+    /// 用户主动取消。
+    /// </summary>
     Cancelled = 3,
+
+    /// <summary>
+    /// 过号未到。
+    /// </summary>
     Expired = 4
 }
diff --git a/src/Domain/TakeoutSaaS.Domain/Reservations/Enums/ReservationStatus.cs b/src/Domain/TakeoutSaaS.Domain/Reservations/Enums/ReservationStatus.cs
index 2bf53a3..024bcfb 100644
--- a/src/Domain/TakeoutSaaS.Domain/Reservations/Enums/ReservationStatus.cs
+++ b/src/Domain/TakeoutSaaS.Domain/Reservations/Enums/ReservationStatus.cs
@@ -5,9 +5,28 @@ namespace TakeoutSaaS.Domain.Reservations.Enums;
 /// </summary>
 public enum ReservationStatus
 {
+    /// <summary>
+    /// 已提交待确认。
+    /// </summary>
     Pending = 0,
+
+    /// <summary>
+    /// 预约已确认。
+    /// </summary>
     Confirmed = 1,
+
+    /// <summary>
+    /// 客户已到店签到。
+    /// </summary>
     CheckedIn = 2,
+
+    /// <summary>
+    /// 已取消。
+    /// </summary>
     Cancelled = 3,
+
+    /// <summary>
+    /// 未到店被标记为爽约。
+    /// </summary>
     NoShow = 4
 }