huang
409a68d60b
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 5m45s
feat: OpenAPI 契约对齐与框架优化
主要变更：
1. OpenAPI 文档契约对齐
- 统一错误响应字段名为 msg（非 message）
- 规范 envelope 响应结构（code, msg, data, timestamp）
- 个人客户路由纳入文档体系（使用 Register 机制）
- 新增 BuildDocHandlers() 统一管理 handler 构造
- 确保文档生成的幂等性
2. Service 层错误处理统一
- 全面替换 fmt.Errorf 为 errors.New/Wrap
- 统一错误码使用规范
- Handler 层参数校验不泄露底层细节
- 新增错误码验证集成测试
3. 代码质量提升
- 删除未使用的 Task handler 和路由
- 新增代码规范检查脚本（check-service-errors.sh）
- 新增注释路径一致性检查（check-comment-paths.sh）
- 更新 API 文档生成指南
4. OpenSpec 归档
- 归档 openapi-contract-alignment 变更（63 tasks）
- 归档 service-error-unify-core 变更
- 归档 service-error-unify-support 变更
- 归档 code-cleanup-docs-update 变更
- 归档 handler-validation-security 变更
- 同步 delta specs 到主规范文件
影响范围：
- pkg/openapi: 新增 handlers.go，优化 generator.go
- internal/service/*: 48 个 service 文件错误处理统一
- internal/handler/admin: 优化参数校验错误提示
- internal/routes: 个人客户路由改造，删除 task 路由
- scripts: 新增 3 个代码检查脚本
- docs: 更新 OpenAPI 文档（15750+ 行）
- openspec/specs: 同步 3 个主规范文件
破坏性变更：无
向后兼容：是
2026-01-30 11:40:36 +08:00
..
2025-11-13 13:40:19 +08:00
2026-01-30 11:40:36 +08:00
2025-11-18 16:44:06 +08:00
2026-01-26 10:28:29 +08:00
2026-01-09 18:02:46 +08:00
2026-01-13 16:52:37 +08:00
2026-01-20 15:10:11 +08:00
2026-01-29 16:00:18 +08:00
2026-01-26 10:28:29 +08:00
2026-01-29 13:18:49 +08:00
2026-01-29 16:33:53 +08:00
2026-01-12 16:01:53 +08:00
2026-01-26 10:28:29 +08:00
2026-01-28 22:12:15 +08:00
2026-01-26 15:07:03 +08:00
2026-01-12 16:01:53 +08:00
2026-01-10 15:08:11 +08:00
2026-01-15 18:15:17 +08:00
2026-01-28 10:45:16 +08:00
2025-12-15 11:32:33 +08:00
2026-01-09 12:25:50 +08:00
2026-01-10 11:42:38 +08:00
2025-12-15 11:32:33 +08:00
2026-01-21 18:20:44 +08:00
2026-01-30 11:40:36 +08:00
2026-01-30 11:40:36 +08:00
2026-01-20 15:10:11 +08:00
2026-01-15 18:15:17 +08:00
2026-01-30 11:40:36 +08:00
2026-01-15 18:15:17 +08:00
2026-01-26 10:28:29 +08:00
2026-01-20 15:10:11 +08:00
2026-01-10 11:42:38 +08:00
2026-01-20 11:33:26 +08:00
2026-01-20 15:10:11 +08:00
2026-01-26 10:28:29 +08:00
2026-01-15 18:15:17 +08:00
2025-11-11 16:53:05 +08:00
2026-01-16 18:15:32 +08:00
2026-01-22 18:27:42 +08:00
2025-11-11 16:53:05 +08:00
2026-01-30 11:40:36 +08:00
2025-11-11 16:53:05 +08:00
2026-01-09 12:25:50 +08:00