chore: add documentation comments and stylecop rules

src/Api/TakeoutSaaS.MiniApi/Controllers/FilesController.cs

@@ -19,8 +19,6 @@ namespace TakeoutSaaS.MiniApi.Controllers;
 [Route("api/mini/v{version:apiVersion}/files")]
 public sealed class FilesController(IFileStorageService fileStorageService) : BaseApiController
 {
-    private readonly IFileStorageService _fileStorageService = fileStorageService;
-
     /// <summary>
     /// 上传图片或文件。
     /// </summary>
@@ -30,23 +28,28 @@ public sealed class FilesController(IFileStorageService fileStorageService) : Ba
     [ProducesResponseType(typeof(ApiResponse<FileUploadResponse>), StatusCodes.Status400BadRequest)]
     public async Task<ApiResponse<FileUploadResponse>> Upload([FromForm] IFormFile? file, [FromForm] string? type, CancellationToken cancellationToken)
     {
+        // 1. 校验文件有效性
         if (file == null || file.Length == 0)
         {
             return ApiResponse<FileUploadResponse>.Error(ErrorCodes.BadRequest, "文件不能为空");
         }
 
+        // 2. 解析上传类型
         if (!UploadFileTypeParser.TryParse(type, out var uploadType))
         {
             return ApiResponse<FileUploadResponse>.Error(ErrorCodes.BadRequest, "上传类型不合法");
         }
 
+        // 3. 提取请求来源
         var origin = Request.Headers["Origin"].FirstOrDefault() ?? Request.Headers["Referer"].FirstOrDefault();
         await using var stream = file.OpenReadStream();
 
-        var result = await _fileStorageService.UploadAsync(
+        // 4. 调用存储服务执行上传
+        var result = await fileStorageService.UploadAsync(
             new UploadFileRequest(uploadType, stream, file.FileName, file.ContentType ?? string.Empty, file.Length, origin),
             cancellationToken);
 
+        // 5. 返回上传结果
         return ApiResponse<FileUploadResponse>.Ok(result);
     }
 }