fix:修复注释错误
This commit is contained in:
@@ -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",
|
||||
|
||||
@@ -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);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -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, "用户不存在");
|
||||
|
||||
Reference in New Issue
Block a user