For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (
- [ ]) syntax for tracking.
Goal: 用全新的「套餐=独立商品」模型替换现有 combo(SKU级)与 bundle(product级)两套机制:套餐商品自带 SKU 售价/库存、内容清单(子商品 SKU×数量)按套餐 SKU 挂载、购物车结算命中套餐且套餐价<子商品总和时提示「一键替换为套餐」,否则按原价。
Architecture: 后端新增 product_combo_items 表(迁移437)+ ProductComboItem 实体/Mapper;新增纯计算 ComboOfferCalculator(覆盖检测+节省额>0 规则)与购物车替换接口;删除旧 combo/bundle 实体、定价计算器与全部扣子商品库存逻辑(迁移438/439 删旧表)。前端 cfc-web 管理端重写套餐内容编辑、移除 SKU 编辑器组合模式;cfc-frontend 消费端购物车以「一键替换」提示替代自动优惠。
Tech Stack: cfc-backend(Spring Boot 2.7.18 / MyBatis-Plus / MySQL 8.0.34 / JUnit)、cfc-web(Vue2 + Element UI + jest)、cfc-frontend(uni-app + jest)。代码位于远程 /app/cfc(monorepo,git 分支 cfclub),本地 /root/cfc 为空壳。所有编辑经 ssh 至远程执行(本会话已验证 workflow:本地 write 文件 → scp → 远程应用)。
Spec: docs/superpowers/specs/2026-10-31-bundle-redesign-design.md
product_sku_combo_items、product_bundle_items 均 0 数据——旧表可安全 DROP(幂等迁移)。DatabaseInitializer.runMigrations() 幂等模式,同步 schema.sql。mvn compile/npm run build 可通过。Files:
cfc-backend/src/main/java/com/etotem/cfc/config/DatabaseInitializer.java(新增 migrate437)cfc-backend/src/main/resources/schema.sqlcfc-backend/src/main/java/com/etotem/cfc/entity/ProductComboItem.javacfc-backend/src/main/java/com/etotem/cfc/mapper/ProductComboItemMapper.javaInterfaces:
Produces: ProductComboItem(字段:Long id、Long comboSkuId、Long childProductId、Long childSkuId、Integer quantity、Date createdAt,@TableName("product_combo_items"));ProductComboItemMapper extends BaseMapper<ProductComboItem>;表 product_combo_items(UK (combo_sku_id, child_sku_id))。
[ ] Step 1: 写实体与 Mapper
ProductComboItem.java 字段与上表一致(MyBatis-Plus 注解风格参照 ProductSkuComboItem.java 删除前的写法);ProductComboItemMapper.java 空接口继承 BaseMapper<ProductComboItem>。
[ ] Step 2: 在 DatabaseInitializer 新增 migrate437
jdbcTemplate.execute("CREATE TABLE IF NOT EXISTS `product_combo_items` ("
+ "`id` BIGINT NOT NULL AUTO_INCREMENT, "
+ "`combo_sku_id` BIGINT NOT NULL COMMENT '套餐SKU id(内容挂SKU级)', "
+ "`child_product_id` BIGINT NOT NULL, "
+ "`child_sku_id` BIGINT NOT NULL COMMENT '子商品SKU(精确到规格)', "
+ "`quantity` INT NOT NULL DEFAULT 1, "
+ "`created_at` DATETIME DEFAULT CURRENT_TIMESTAMP, "
+ "PRIMARY KEY (`id`), "
+ "UNIQUE KEY `uk_combo_sku_child` (`combo_sku_id`, `child_sku_id`)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4");
在迁移入口(runMigrations 中)注册调用,与现有迁移同样的 try/catch + log 幂等模式。
[ ] Step 3: schema.sql 同步 product_combo_items 建表语句
[ ] Step 4: 编译验证
Run: cd /app/cfc/cfc-backend && mvn -q compile
Expected: BUILD SUCCESS
[ ] Step 5: Commit
cd /app/cfc && git add cfc-backend/src && git commit -m "feat(backend): 新增套餐内容表 product_combo_items(迁移437)与实体/Mapper"
Files:
cfc-backend/src/main/java/com/etotem/cfc/service/ComboService.javacfc-backend/src/main/java/com/etotem/cfc/controller/admin/AdminInventoryController.java(新增 POST /api/admin/inventory/combo/items、POST /api/admin/inventory/combo/items/list)cfc-backend/src/test/java/.../ComboServiceTest.java(放实际测试目录)Interfaces:
ProductComboItemMapper、ProductSku 实体与 product_skus 查询。Produces: ComboService.saveComboItems(Long comboSkuId, List<ComboItemInput> items)、ComboService.listComboItems(Long comboSkuId);ComboItemInput = {Long childProductId, Long childSkuId, Integer quantity}。
[ ] Step 1: 写失败测试 ComboServiceTest
用 mock 的 ProductComboItemMapper/ProductSkuMapper(复用项目现有单测 mock 风格,参照 ProductSkuComboServiceTest 删除前的写法)断言:
saveComboItems 先删后插:对同一 comboSkuId 先 delete 再逐条 insert;quantity == null || quantity <= 0 → 抛 IllegalArgumentException;childSkuId == null → 抛 IllegalArgumentException(SKU 级必填);comboSkuId 对应 SKU 不存在 → 抛 IllegalArgumentException;listComboItems 按 comboSkuId 查询并回填 childProductName/childProductImage/childSkuSpecs(按 child_product_id+child_sku_id 联查 product_skus/products,mock 返回值)。
[ ] Step 2: 运行确认失败
Run: mvn test -Dtest=ComboServiceTest
Expected: FAIL(ComboService 不存在/方法未定义)
ComboService先校验:comboSkuId 非空且 product_skus 存在;逐条校验 childSkuId != null、quantity > 0、child_sku_id 存在且属于 child_product_id。通过后 delete 旧行 + 批量 insert。listComboItems 回填展示字段。
POST /api/admin/inventory/combo/items(body: {comboSkuId, items:[]})、POST /api/admin/inventory/combo/items/list(body: {comboSkuId}),返回 Result。沿用现有 ParamUtils/Result 风格。
ProductService.detail:当商品 product_type='bundle' 时,按该商品 SKU 列表调 ComboService.listComboItems 附带 comboItems 清单(含子商品名/图/规格/数量)到详情响应,供消费端「内含清单」展示。
Run: mvn test -Dtest=ComboServiceTest
Expected: PASS
Run: mvn -q compile
Expected: BUILD SUCCESS
Commit: feat(backend): 套餐内容保存/列表接口(combo/items)含子SKU校验与详情清单挂载
Files:
cfc-backend/src/main/java/com/etotem/cfc/entity/ProductSkuComboItem.java、mapper/ProductSkuComboItemMapper.java、ProductSkuComboServiceTest、ProductOrderComboStockTest(如存在)entity/ProductSku.java(删 comboItems 字段)、service/ProductSkuService.java(删 combo 方法)、service/CartService.java(删 combo 摘要)、service/ProductOrderService.java(删 combo 行处理/deductComboStock/restockComboOrder 及其调用)、controller/product/ProductController.java(删 detail 中 comboItems 组装)、controller/admin/AdminProductPickerController.java(删 combo 相关)、config/DatabaseInitializer.java(新增 migrate438 drop product_sku_combo_items)Interfaces:
Produces: 无残留 SKU 级 combo 引用(mvn compile 通过);旧表被 DROP。
[ ] Step 1: 删除 combo 实体/Mapper/旧测试
git rm 上述 Delete 文件。
按编译错误逐个清除:ProductSku.comboItems、ProductSkuService 的 fillComboItems/validateComboItems/saveComboItems/buildComboSummary/hasComboItems、CartService specDesc 组合摘要、ProductOrderService combo 行特殊处理与 deductComboStock/restockComboOrder(含第 1082/1380/1830/2050 行附近调用)、ProductController.detail comboItems 组装、AdminProductPickerController combo 引用。
migrate438 删旧表DROP TABLE IF EXISTS product_sku_combo_items,注册进 runMigrations(幂等)。
Run: cd /app/cfc/cfc-backend && mvn -q compile
Expected: BUILD SUCCESS(无 combo 残留引用)
Commit: refactor(backend): 移除SKU级组合机制(实体/库存扣减回补/迁移438删表)
Files:
pricing/BundlePricingCalculator.java、pricing/BundleDef.java、pricing/BundleChild.java、pricing/BundleHit.java、pricing/BundleDiscountResult.java、pricing/BundlePricingService.java、entity/ProductBundleItem.java、mapper/ProductBundleItemMapper.java(保留 pricing/LineItem.java 供 Task 5 复用)dto/CartListResultDTO.java(删 bundlePromo,后续 Task 5 加 comboOffer)、dto/CartItemDTO.java(删 bundleMatch/bundleInfo 相关)、service/CartService.java(删 attachBundleMatches/computeBundlePromo/toBundlePromo/buildBundleInfo 及 import)、service/ProductOrderService.java(删 checkBundleStock 3 处调用与 bundleDiscount 应用)、service/InventoryService.java(删 saveBundleItems/listBundleItems/checkBundleStock 及 bundle 详情组装)、controller/admin/AdminInventoryController.java(删 /bundle/items、/bundle/items/list、/bundle/check-stock 端点)、controller/MarketController.java/controller/PackagePaymentController.java(删 bundle 引用)、config/DatabaseInitializer.java(新增 migrate439 drop product_bundle_items)Interfaces:
Produces: 无 bundle 残留(mvn compile 通过);pricing/LineItem 保留。
[ ] Step 1: 删除 bundle 实体/定价包/旧端点
按上表 git rm/删除文件与控制器端点。
按编译错误逐个清除:CartService/ProductOrderService/InventoryService/控制器/DTO 中所有 bundle 引用(checkBundleStock、bundleDiscount、bundlePromo、bundleMatch、bundleInfo、BundlePricingService 注入等)。
migrate439 删旧表DROP TABLE IF EXISTS product_bundle_items,注册进 runMigrations。
Run: cd /app/cfc/cfc-backend && mvn -q compile
Expected: BUILD SUCCESS
Commit: refactor(backend): 移除旧bundle自动计价机制(定价计算器/库存联动/迁移439删表),保留LineItem
Files:
cfc-backend/src/main/java/com/etotem/cfc/pricing/ComboOfferDef.java、pricing/ComboOfferResult.java、pricing/ComboOfferCalculator.javacfc-backend/src/test/java/.../ComboOfferCalculatorTest.javacfc-backend/src/main/java/com/etotem/cfc/service/ComboOfferService.java(装载定义 + 购物车接入)service/CartService.java(新增 computeComboOffer/replaceCartWithCombo,移除 Task 4 后残留的 bundle 引用)、controller/cart/CartController.java(新增 POST /api/cart/combo-offer 与 POST /api/cart/replace-combo)cfc-backend/src/test/java/.../CartReplaceComboTest.javaInterfaces:
ProductComboItemMapper、Task 4 保留的 pricing/LineItem。ComboOfferDef{Long comboSkuId, String comboName, Integer comboPrice, List<ComboChild> children};ComboChild{Long childProductId, Long childSkuId, Integer quantity};ComboOfferResult{boolean active, Long comboSkuId, String comboName, int groups, int originalTotal, int comboPrice, int saving};ComboOfferCalculator.compute(List<LineItem> lines, List<ComboOfferDef> defs) -> ComboOfferResult;CartService.computeComboOffer(Long userId, List<Long> checkedCartItemIds) -> ComboOfferResult;CartService.replaceCartWithCombo(Long userId, List<Long> checkedCartItemIds, Long comboSkuId);POST /api/cart/combo-offer {checkedCartItemIds:Long[]} -> Result<ComboOfferResult>;POST /api/cart/replace-combo {checkedCartItemIds:Long[], comboSkuId} -> Result<Void>。勾选态感知:购物车行无服务端 checked 字段(勾选是前端本地态,见 cart.vue
item.checked),而 offer 必须按勾选结算子集判定——因此检测以独立端点combo-offer承载:前端把勾选记录 id(CartItemDTO.id=购物车主键)传给后端,后端按该子集重算(服务端权威),不再烘焙进CartListResultDTO。
ComboOfferCalculatorTest(纯计算,覆盖 Review Focus 1/2/3/7)断言(lines 用 (productId, skuId, quantity, unitPrice 分) 构造):
saving=5000(原价16000-套餐15000),groups=1;active=false(原价结算,Review Focus 1);active=false(Review Focus 2);groups=2,originalTotal=32000,套餐价 15000×2 → saving=10000,原价=16000×2(Review Focus 3);Run: mvn test -Dtest=ComboOfferCalculatorTest
Expected: FAIL(类不存在)
ComboOfferCalculator签名:public ComboOfferResult compute(List<LineItem> lines, List<ComboOfferDef> defs)。算法:按 (productId, skuId) 聚合 lines 为池;对每个 def 计算可覆盖组数 groups = min over children(floor(haveQty/needQty))(haveQty 严格按 child_sku_id 匹配,缺失即 0);originalTotal = sum(组内 child 实际消耗数量 × 对应 line 单价 × groups);saving = originalTotal - comboPrice×groups;saving > 0 且 groups > 0 才候选;取 saving 最大(同额取 defs 先出现);返回单条 offer(多套餐只报最优一个,符合设计)。同一套餐重复(comboSkuId 相同)只报一次。
Run: mvn test -Dtest=ComboOfferCalculatorTest
Expected: PASS(6 项全绿)
ComboOfferService 装载与购物车接入ComboOfferService.computeForLines(List<LineItem> lines):查询 product_combo_items 按 combo_sku_id 聚合 → 取套餐 SKU(product_skus.price/label)组装 ComboOfferDef(脏行跳过)→ 调 Calculator。CartService.computeComboOffer(userId, checkedCartItemIds):按 id 加载购物车记录(仅限该 userId,越权 id 忽略/报错)→ 构建 lines(按 (productId, skuId) 聚合、单位分单价)→ 调 computeForLines。getCartList 不再返回任何套餐 offer(列表与勾选态解耦,避免「按全车算的优惠」误导)。
CartReplaceComboTest(服务层,mock mapper,Review Focus 4/5)断言 CartService.computeComboOffer(userId, checkedCartItemIds) 仅按勾选记录计算(未勾选行不参与、saving>0 才 active);replaceCartWithCombo(userId, checkedCartItemIds, comboSkuId):
(productId, skuId) 重算组数(忽略前端传入组数)——购物车 A×4+B×2 传 99 份 → 只替换 2 组;CartController POST /api/cart/replace-combo 与 CartService.replaceCartWithCombo事务(@Transactional):后端重算组数 → 逐行扣减购物车子商品数量(不足则整体失败回滚)→ 删除数量为 0 的行 → upsert 套餐 SKU 行(存在则加数量)。
Run: mvn test -Dtest=CartReplaceComboTest
Expected: PASS(5 项全绿)
Run: cd /app/cfc/cfc-backend && mvn test -Dmaven.test.skip=false 2>&1 | tail -20
Expected: 全绿(旧 combo/bundle 测试已删,其余回归通过)
Commit: feat(backend): 购物车套餐offer检测(勾选子集/节省额>0)与一键替换接口
Files:
service/ProductOrderService.java(确认套餐商品走普通 SKU 下单路径;清理 Task 4 后遗留的 bundle/combo 分支)cfc-backend/src/test/java/.../ComboOrderStockTest.javaInterfaces:
Produces: 套餐商品(product_type='bundle')下单按普通商品:校验套餐 SKU 库存 → 支付扣减 → 取消/失败回补,均只作用于套餐 SKU。
[ ] Step 1: 写失败测试 ComboOrderStockTest
断言(mock):
product_skus.stock;Run: mvn test -Dtest=ComboOrderStockTest
Expected: FAIL
确保 ProductOrderService 对 product_type='bundle' 无特殊库存分支(走普通 SKU 流);删除任何残留 checkBundleStock/子商品扣减。
Run: mvn test -Dtest=ComboOrderStockTest → PASS;mvn -q compile → SUCCESS
Commit: feat(backend): 套餐下单仅扣套餐SKU库存(校验/扣减/回补)
Files:
cfc-web/src/api/admin.js(saveBundleItems/getBundleItems → saveComboItems/listComboItems 调用新端点)cfc-web/src/views/admin/ProductEdit.vue(bundle 区块改为「套餐内容编辑」:选子商品 SKU 规格 + 数量;产品当前 SKU id 作 comboSkuId)cfc-web/src/views/admin/components/ProductSkuEditor.vue(移除「商品组合」模式:radio 只留「规格变体」,删 comboItems/ProductPicker 组合块相关逻辑与样式)cfc-web/src/__tests__/components/ProductSkuEditor.mode.test.js(既有 mode 测试追加断言:radio 仅有「规格变体」一项)Interfaces:
Consumes: Task 2 后端端点 POST /api/admin/inventory/combo/items、/combo/items/list。
[ ] Step 1: 写失败测试(ProductSkuEditor 无组合模式)
沿用既有 src/__tests__/components/ProductSkuEditor.mode.test.js,追加断言:挂载后打开对话框,.el-radio-button 文本不含「商品组合」且不含「关联商品」,仅含「规格变体」。运行确认 FAIL(当前仍有组合)。
saveComboItems(comboSkuId, items) → POST /api/admin/inventory/combo/items;listComboItems(comboSkuId) → POST /api/admin/inventory/combo/items/list。
删除「商品组合」radio-button、combo 模板块、comboItems/openProductPicker/组合保存分支、相关样式(保留「规格变体」)。ProductPicker 组件保留(Task 7 套餐内容编辑复用其子商品/SKU 选择能力)。
productType==='bundle' 时:加载套餐 SKU 列表(getProductSkuList),取首个/指定 SKU 的 id 作 comboSkuId;「套餐内容编辑」用 ProductPicker 多选子商品 SKU + 数量;保存调 saveComboItems(list[0].id, items),加载调 listComboItems。
Run: cd /app/cfc/cfc-web && npx jest
Expected: 全绿(既有 90 → 更新后全过,含新断言)
Run: npm run build
Expected: DONE Build complete
Commit: feat(admin): 套餐内容编辑改挂商品级、SKU编辑器移除组合模式
Files:
cfc-frontend/utils/bundle-pricing.js(重写为 comboOffer 展示辅助:comboOfferOf(offer)/formatComboOfferText(offer) 纯展示,删除自动扣减逻辑)cfc-frontend/pages/shop/cart/cart.vue(删「已享套餐价」自动区块与 applyBundleDiscount 扣减;勾选态变化→防抖调 /api/cart/combo-offer 取勾选子集 offer;有 offer 时提示「这 N 件组成套餐「XX」,套餐价 ¥Y(省 ¥Z)」+「一键替换为套餐」按钮 → replace-combo → 刷新购物车)cfc-frontend/pages/shop/checkout/checkout.vue(移除 bundlePromo 自动优惠处理)cfc-frontend/pages/discover-detail/product-detail/product-detail.vue(套餐商品详情展示「内含清单」:用详情接口 comboItems 渲染子商品名/规格/数量)cfc-frontend/utils/api.js(新增 queryComboOffer、replaceCartWithCombo)cfc-frontend/__tests__/utils/bundle-pricing.test.js(适配 comboOffer)Interfaces:
Consumes: Task 5 的 POST /api/cart/combo-offer(勾选子集 offer)与 POST /api/cart/replace-combo;Task 2 详情接口的 comboItems 清单。
[ ] Step 1: 写失败测试(bundle-pricing → comboOffer 辅助)
改写 __tests__/utils/bundle-pricing.test.js:comboOfferOf({active:true,...}) 返回 offer;active=false/缺失 返回 null;总价不再被自动扣减(纯展示)。运行确认 FAIL(旧逻辑仍在)。
utils/api.js 加 queryComboOffer(payload)(POST /cart/combo-offer)与 replaceCartWithCombo(payload)(POST /cart/replace-combo);utils/bundle-pricing.js 重写为 comboOffer 展示辅助。
删自动优惠区块与扣减;勾选态变化(checked 集合变更)时防抖调 queryComboOffer({checkedCartItemIds})(ids 取勾选行 item.id,空集不调);返回 active 时渲染提示「这 N 件可换成套餐「XX」(省 ¥Z)」+「一键替换为套餐」按钮 → replaceCartWithCombo({checkedCartItemIds, comboSkuId}) → 成功后刷新购物车列表与勾选态(替换后重查 offer 应为 inactive)。
[ ] Step 4: checkout.vue 移除 bundlePromo 处理
[ ] Step 5: 运行测试 + 构建 + Commit
Run: cd /app/cfc/cfc-frontend && npx jest(如项目脚本)→ 全绿;npm run build(或项目构建脚本)→ 成功
Commit: feat(consumer): 购物车套餐「一键替换为套餐」提示(替代自动优惠)
Files:
Interfaces:
Consumes: Task 1-8 全部产物。
[ ] Step 1: 后端全量回归
Run: cd /app/cfc/cfc-backend && mvn test 2>&1 | tail -20
Expected: 全绿;mvn clean package -Dmaven.test.skip=true -Dmaven.compile.fork=true 打包成功。
Run: cd /app/cfc/cfc-web && npx jest && npm run build;cd /app/cfc/cfc-frontend && npx jest && npm run build(按项目实际脚本)
Expected: 全绿 + 构建成功。
按 AGENTS.md:git 状态确认干净 → 备份 /app/pro/cfc → 后端 cp jar + systemctl restart cfc-backend → 前端 cfc-web/dist rsync 至 /app/pro/cfc/frontend/ → 消费端 cfc-frontend 构建产物按本项目部署方式(如 miniprogram/H5)部署 → 验证健康端点与页面。
后端 systemctl status active;curl POST /api/cart/list 200 且无 bundlePromo/bundleMatch;curl POST /api/cart/combo-offer(空 ids)返回正常结构;日志无 ERROR。管理端商品编辑套餐商品可见「套餐内容编辑」。数据库核对 product_combo_items 表存在、旧表已删。
提交部署相关变更(版本号冲突取远程),推送 cfclub,更新台账 .superpowers/sdd/…。
| 关注点 | 测试归属 |
|---|---|
| 套餐价≥总和→取原价 | Task 5.1 用例2 |
| 覆盖不足→无offer | Task 5.1 用例3 |
| 超量→替换N份余量保留 | Task 5.1 用例4 + Task 5.6 用例3 |
| 套餐已加购不重复提示 | Task 5 检测去重(计算器单 def 唯一 + 服务去重) |
| 替换防篡改 | Task 5.6 用例1/5 |
| 子SKU失效 | Task 2 保存校验 + Task 5.1 用例6 |
| 多套餐取最大 | Task 5.1 用例5 |