chore: add documentation comments and stylecop rules

src/Api/TakeoutSaaS.AdminApi/Controllers/TenantNotificationsController.cs

@@ -27,8 +27,13 @@ public sealed class TenantNotificationsController(IMediator mediator) : BaseApiC
     [ProducesResponseType(typeof(ApiResponse<PagedResult<TenantNotificationDto>>), StatusCodes.Status200OK)]
     public async Task<ApiResponse<PagedResult<TenantNotificationDto>>> Search(long tenantId, [FromQuery] SearchTenantNotificationsQuery query, CancellationToken cancellationToken)
     {
+        // 1. 绑定租户标识
         query = query with { TenantId = tenantId };
+
+        // 2. 查询通知列表
         var result = await mediator.Send(query, cancellationToken);
+
+        // 3. 返回分页结果
         return ApiResponse<PagedResult<TenantNotificationDto>>.Ok(result);
     }
 
@@ -41,7 +46,10 @@ public sealed class TenantNotificationsController(IMediator mediator) : BaseApiC
     [ProducesResponseType(typeof(ApiResponse<TenantNotificationDto>), StatusCodes.Status404NotFound)]
     public async Task<ApiResponse<TenantNotificationDto>> MarkRead(long tenantId, long notificationId, CancellationToken cancellationToken)
     {
+        // 1. 标记通知为已读
         var result = await mediator.Send(new MarkTenantNotificationReadCommand { TenantId = tenantId, NotificationId = notificationId }, cancellationToken);
+
+        // 2. 返回结果或 404
         return result is null
             ? ApiResponse<TenantNotificationDto>.Error(StatusCodes.Status404NotFound, "通知不存在")
             : ApiResponse<TenantNotificationDto>.Ok(result);