|
|
409a68d60b
|
feat: OpenAPI 契约对齐与框架优化
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 5m45s
主要变更：
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 |
|
|
|
1da680a790
|
重构: 店铺套餐分配系统从加价模式改为返佣模式
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 5m18s
主要变更：
- 重构分配模型：从加价模式（pricing_mode/pricing_value）改为返佣模式（base_commission + tier_commission）
- 删除独立的 my_package 接口，统一到 /api/admin/packages（通过数据权限自动过滤）
- 新增批量分配和批量调价功能，支持事务和性能优化
- 新增配置版本管理，订单创建时锁定返佣配置
- 新增成本价历史记录，支持审计和纠纷处理
- 新增统计缓存系统（Redis + 异步任务），优化梯度返佣计算性能
- 删除冗余的梯度佣金独立 CRUD 接口（合并到分配配置中）
- 归档 3 个已完成的 OpenSpec changes 并同步 8 个新 capabilities 到 main specs
技术细节：
- 数据库迁移：000026_refactor_shop_package_allocation
- 新增 Store：AllocationConfigStore, PriceHistoryStore, CommissionStatsStore
- 新增 Service：BatchAllocationService, BatchPricingService, CommissionStatsService
- 新增异步任务：统计更新、定时同步、周期归档
- 测试覆盖：批量操作集成测试、梯度佣金 CRUD 清理验证
影响：
- API 变更：删除 4 个梯度 CRUD 接口（POST/GET/PUT/DELETE /:id/tiers）
- API 新增：批量分配、批量调价接口
- 数据模型：重构 shop_series_allocation 表结构
- 性能优化：批量操作使用 CreateInBatches，统计使用 Redis 缓存
相关文档：
- openspec/changes/archive/2026-01-28-refactor-shop-package-allocation/
- openspec/specs/agent-available-packages/
- openspec/specs/allocation-config-versioning/
- 等 8 个新 capability specs
|
2026-01-28 17:11:55 +08:00 |
|
|
|
79c061b6fa
|
feat: 实现套餐管理模块，包含套餐系列、双状态管理、废弃模型清理
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 5m24s
- 新增套餐系列管理 (CRUD + 状态切换)
- 新增套餐管理 (CRUD + 启用/禁用 + 上架/下架双状态)
- 清理 8 个废弃分佣模型及对应数据库表
- Package 模型新增建议成本价、建议售价、上架状态字段
- 完整的 Store/Service/Handler 三层实现
- 包含单元测试和集成测试
- 归档 add-package-module change
- 新增多个 OpenSpec changes (订单支付、店铺套餐分配、一次性分佣、卡设备系列绑定)
|
2026-01-27 19:55:47 +08:00 |
|
|
|
30a0717316
|
补充 PackageService 的 Update 和 Delete 测试
- 添加 TestPackageService_Update：更新成功、更新不存在的套餐
- 添加 TestPackageService_Delete：删除成功、删除不存在的套餐
- 测试覆盖率从 47.2% 提升到 66.9%
|
2026-01-27 19:38:05 +08:00 |
|
|
|
e2e6a64ba4
|
创建 PackageService 单元测试（覆盖双状态逻辑）
- 创建 internal/service/package/service_test.go 文件
- 测试 Create 方法：创建成功、编码重复失败、系列不存在失败
- 测试 UpdateStatus 方法：禁用时自动强制下架、启用时保持原上架状态
- 测试 UpdateShelfStatus 方法：启用状态可上架、禁用状态不能上架、下架成功
- 测试 Get 方法：获取成功、不存在返回错误
- 测试 List 方法：列表查询、按类型过滤、按状态过滤
- 使用 testutils.NewTestTransaction 创建测试事务
- 使用 middleware.SetUserContext 设置用户上下文
- 使用唯一的 PackageCode（基于时间戳）
- 重点覆盖双状态逻辑的测试
|
2026-01-27 19:37:08 +08:00 |
|
