refactor: 后端代码质量优化 - 复用公共库、使用标准库、类型安全错误判断
## 高优先级修复 - stats_service_impl: 使用 strings.SplitN 替代错误的索引分割 - provider_handler: 使用 errors.Is(err, gorm.ErrDuplicatedKey) 替代字符串匹配 - client: 重写 isNetworkError 使用 errors.As/Is 类型安全判断 - proxy_handler: 使用 encoding/json 标准库解析 JSON(extractModelName、isStreamRequest) ## 中优先级修复 - stats_handler: 添加 parseDateParam 辅助函数消除重复日期解析 - pkg/errors: 新增 ErrRequestCreate/Send/ResponseRead 错误类型和 WithCause 方法 - client: 使用结构化错误替代 fmt.Errorf - ConversionEngine: logger 依赖注入,替换所有 zap.L() 调用 ## 低优先级修复 - encoder: 删除 joinStrings,使用 strings.Join - adapter: 删除 modelInfoRegex 正则,使用 isModelInfoPath 字符串函数 ## 文档更新 - README.md: 添加公共库使用指南和编码规范章节 - specs: 同步 delta specs 到 main specs(error-handling、structured-logging、request-validation) ## 归档 - openspec/changes/archive/2026-04-20-refactor-backend-code-quality/
This commit is contained in:
@@ -20,6 +20,13 @@
|
||||
- **THEN** SHALL 支持嵌套字段
|
||||
- **THEN** SHALL 自动包含时间戳和日志级别
|
||||
|
||||
#### Scenario: 日志注入
|
||||
|
||||
- **WHEN** 创建需要记录日志的组件
|
||||
- **THEN** SHALL 通过构造函数注入 *zap.Logger
|
||||
- **THEN** SHALL 允许 logger 参数为 nil,此时使用全局 logger zap.L()
|
||||
- **THEN** SHALL NOT 直接使用全局 logger zap.L()(除非在构造函数默认值中)
|
||||
|
||||
### Requirement: 支持日志滚动
|
||||
|
||||
系统 SHALL 支持日志文件滚动,使用 lumberjack。
|
||||
@@ -122,3 +129,20 @@
|
||||
- **WHEN** 创建日志文件
|
||||
- **THEN** SHALL 使用 `nex-YYYY-MM-DD.log` 格式命名
|
||||
- **THEN** SHALL 按日期创建新文件
|
||||
|
||||
### Requirement: ConversionEngine 日志注入
|
||||
|
||||
ConversionEngine SHALL 通过依赖注入获取 logger。
|
||||
|
||||
#### Scenario: ConversionEngine 构造函数
|
||||
|
||||
- **WHEN** 创建 ConversionEngine 实例
|
||||
- **THEN** 构造函数 SHALL 接受 *zap.Logger 参数
|
||||
- **THEN** 参数为 nil 时 SHALL 使用 zap.L() 作为默认值
|
||||
- **THEN** SHALL 将 logger 存储在结构体字段中
|
||||
|
||||
#### Scenario: ConversionEngine 日志使用
|
||||
|
||||
- **WHEN** ConversionEngine 记录日志
|
||||
- **THEN** SHALL 使用注入的 logger 字段
|
||||
- **THEN** SHALL NOT 直接调用 zap.L()
|
||||
|
||||
Reference in New Issue
Block a user