fix:修复注释错误

This commit is contained in:
2026-01-04 21:22:26 +08:00
parent a427b0f22a
commit 398c716734
69 changed files with 353 additions and 318 deletions

View File

@@ -173,10 +173,10 @@ public sealed class BillingsController(IMediator mediator) : BaseApiController
// 1. 绑定账单标识
command = command with { BillingId = id };
// 2. (空行后) 一键确认收款(含:写入 VerifiedBy/VerifiedAt并同步更新账单已收金额/状态)
// 2. 一键确认收款(含:写入 VerifiedBy/VerifiedAt并同步更新账单已收金额/状态)
var result = await mediator.Send(command, cancellationToken);
// 3. (空行后) 返回结果
// 3. 返回结果
return ApiResponse<PaymentRecordDto>.Ok(result);
}
@@ -196,10 +196,10 @@ public sealed class BillingsController(IMediator mediator) : BaseApiController
// 1. 绑定支付记录标识
command = command with { PaymentId = paymentId };
// 2. (空行后) 审核支付记录
// 2. 审核支付记录
var result = await mediator.Send(command, cancellationToken);
// 3. (空行后) 返回审核结果
// 3. 返回审核结果
return ApiResponse<PaymentRecordDto>.Ok(result);
}
@@ -236,18 +236,18 @@ public sealed class BillingsController(IMediator mediator) : BaseApiController
// 1. 执行导出
var bytes = await mediator.Send(query, cancellationToken);
// 2. (空行后) 解析格式并生成文件名
// 2. 解析格式并生成文件名
var extension = ResolveExportFileExtension(query.Format);
var fileName = $"billings_{DateTime.UtcNow:yyyyMMdd_HHmmss}.{extension}";
// 3. (空行后) 显式写入 Content-Disposition确保浏览器以附件形式下载
// 3. 显式写入 Content-Disposition确保浏览器以附件形式下载
Response.Headers[HeaderNames.ContentDisposition] = new ContentDispositionHeaderValue("attachment")
{
FileName = fileName,
FileNameStar = fileName
}.ToString();
// 4. (空行后) 返回二进制流(统一 octet-stream避免被默认 JSON Produces 影响)
// 4. 返回二进制流(统一 octet-stream避免被默认 JSON Produces 影响)
return File(bytes, "application/octet-stream");
}
@@ -292,7 +292,7 @@ public sealed class BillingsController(IMediator mediator) : BaseApiController
// 1. 归一化导出格式
var normalized = (format ?? string.Empty).Trim();
// 2. (空行后) 映射扩展名
// 2. 映射扩展名
return normalized.ToUpperInvariant() switch
{
"PDF" => "pdf",