chore: 优化代码注释

src/Core/TakeoutSaaS.Shared.Abstractions/Entities/IAuditableEntity.cs

@@ -1,11 +1,18 @@
 namespace TakeoutSaaS.Shared.Abstractions.Entities;
 
 /// <summary>
-/// 审计字段接口
+/// 审计字段接口：提供创建时间和更新时间字段。
 /// </summary>
 public interface IAuditableEntity
 {
+    /// <summary>
+    /// 创建时间（UTC）。
+    /// </summary>
     DateTime CreatedAt { get; set; }
+
+    /// <summary>
+    /// 更新时间（UTC），未更新时为 null。
+    /// </summary>
     DateTime? UpdatedAt { get; set; }
 }
 

src/Core/TakeoutSaaS.Shared.Abstractions/Exceptions/BusinessException.cs

@@ -1,5 +1,3 @@
-using System;
-
 namespace TakeoutSaaS.Shared.Abstractions.Exceptions;
 
 /// <summary>

src/Core/TakeoutSaaS.Shared.Abstractions/Results/ApiResponse.cs

@@ -1,4 +1,3 @@
-using System;
 using System.Diagnostics;
 using TakeoutSaaS.Shared.Abstractions.Diagnostics;
 
@@ -8,7 +7,7 @@ namespace TakeoutSaaS.Shared.Abstractions.Results;
 /// 统一的 API 返回结果包装。
 /// </summary>
 /// <typeparam name="T">数据载荷类型</typeparam>
-public sealed record class ApiResponse<T>
+public sealed record ApiResponse<T>
 {
     /// <summary>
     /// 是否成功。
@@ -97,7 +96,7 @@ public sealed record class ApiResponse<T>
     {
         if (!string.IsNullOrWhiteSpace(TraceContext.TraceId))
         {
-            return TraceContext.TraceId!;
+            return TraceContext.TraceId;
         }
 
         return Activity.Current?.Id ?? Guid.NewGuid().ToString("N");

src/Core/TakeoutSaaS.Shared.Abstractions/Tenancy/ITenantProvider.cs

@@ -1,7 +1,14 @@
 namespace TakeoutSaaS.Shared.Abstractions.Tenancy;
 
+/// <summary>
+/// 租户提供者接口：用于获取当前请求的租户标识。
+/// </summary>
 public interface ITenantProvider
 {
+    /// <summary>
+    /// 获取当前请求的租户 ID。
+    /// </summary>
+    /// <returns>租户 ID，如果未设置则返回 Guid.Empty</returns>
     Guid GetCurrentTenantId();
 }