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",

View File

@@ -105,11 +105,11 @@ public sealed class TenantsController(IMediator mediator) : BaseApiController
return ApiResponse<object>.Error(StatusCodes.Status400BadRequest, "路由 tenantId 与请求体 tenantId 不一致");
}
// 2. (空行后) 绑定租户标识并执行更新(若不存在或冲突则抛出业务异常,由全局异常处理转换为 404/409
// 2. 绑定租户标识并执行更新(若不存在或冲突则抛出业务异常,由全局异常处理转换为 404/409
var command = body with { TenantId = tenantId };
await mediator.Send(command, cancellationToken);
// 3. (空行后) 返回成功结果
// 3. 返回成功结果
return ApiResponse<object>.Ok(null);
}
@@ -377,7 +377,7 @@ public sealed class TenantsController(IMediator mediator) : BaseApiController
// 1. 生成一次性令牌
var token = await mediator.Send(new CreateTenantAdminResetLinkTokenCommand { TenantId = tenantId }, cancellationToken);
// 2. (空行后) 解析前端来源(优先 Origin避免拼成 AdminApi 域名)
// 2. 解析前端来源(优先 Origin避免拼成 AdminApi 域名)
var origin = Request.Headers.Origin.ToString();
if (string.IsNullOrWhiteSpace(origin))
{
@@ -387,7 +387,7 @@ public sealed class TenantsController(IMediator mediator) : BaseApiController
origin = origin.TrimEnd('/');
var resetUrl = $"{origin}/#/auth/reset-password?token={Uri.EscapeDataString(token)}";
// 3. (空行后) 返回链接
// 3. 返回链接
return ApiResponse<string>.Ok(data: resetUrl);
}
@@ -430,10 +430,10 @@ public sealed class TenantsController(IMediator mediator) : BaseApiController
// 1. 绑定租户标识
query = query with { TenantId = tenantId };
// 2. (空行后) 查询配额使用历史
// 2. 查询配额使用历史
var result = await mediator.Send(query, cancellationToken);
// 3. (空行后) 返回分页结果
// 3. 返回分页结果
return ApiResponse<PagedResult<QuotaUsageHistoryDto>>.Ok(result);
}
}

View File

@@ -109,10 +109,10 @@ public sealed class UsersController(IMediator mediator) : BaseApiController
command = command with { UserId = userId };
}
// 2. (空行后) 执行更新
// 2. 执行更新
var result = await mediator.Send(command, cancellationToken);
// 3. (空行后) 返回结果或 404
// 3. 返回结果或 404
return result == null
? ApiResponse<UserDetailDto>.Error(ErrorCodes.NotFound, "用户不存在")
: ApiResponse<UserDetailDto>.Ok(result);
@@ -169,10 +169,10 @@ public sealed class UsersController(IMediator mediator) : BaseApiController
command = command with { UserId = userId };
}
// 2. (空行后) 执行状态变更
// 2. 执行状态变更
var result = await mediator.Send(command, cancellationToken);
// 3. (空行后) 返回结果或 404
// 3. 返回结果或 404
return result
? ApiResponse.Success()
: ApiResponse<object>.Error(ErrorCodes.NotFound, "用户不存在");