Files
huang 1da680a790
All checks were successful
构建并部署到测试环境(无 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

1.6 KiB
Raw Permalink Blame History

Capability: 店铺套餐批量调价

Purpose

本 capability 定义代理如何批量调整指定店铺和系列的套餐成本价,支持固定金额和百分比加价,使用事务确保原子性,并记录调价历史。

Requirements

Requirement: 批量调整套餐成本价

系统 SHALL 允许代理批量调整指定店铺和系列的所有套餐成本价。调整 MUST 支持固定金额加价和百分比加价两种模式。

Scenario: 批量应用百分比加价

  • WHEN 代理对店铺10的系列5下的所有套餐应用5%加价
  • THEN 系统计算每个套餐的新成本价 = 当前成本价 × 1.05,并批量更新

Scenario: 批量应用固定金额加价

  • WHEN 代理对店铺10的系列5下的所有套餐应用500分5元固定加价
  • THEN 系统计算每个套餐的新成本价 = 当前成本价 + 500并批量更新

Scenario: 批量调价时记录历史

  • WHEN 批量调整15个套餐的成本价
  • THEN 系统创建15条成本价历史记录

Scenario: 批量调价使用事务

  • WHEN 批量调整100个套餐成本价时第50个套餐更新失败
  • THEN 系统回滚所有已更新的成本价,返回错误信息

Scenario: 不指定系列时调整店铺所有套餐

  • WHEN 代理对店铺10应用5%加价,不指定系列
  • THEN 系统调整该店铺所有已分配套餐的成本价

Scenario: 验证新成本价不低于上级成本价

  • WHEN 批量调价后,某个套餐的新成本价低于上级成本价
  • THEN 系统返回错误 "成本价不能低于上级成本价"