junhong_cmp_fiber/docs/package-price-fallback-and-platform-gift-policy/最终验收清单.md

套餐价格回退与平台赠送策略最终验收清单

1. 价格回退

• 普通可售套餐未配置建议售价时，后台详情返回 suggested_retail_price=null 且 price_config_status=0
• 普通可售套餐未配置建议售价时，C 端可购列表展示成本价
• 平台后台创建普通订单时，订单明细使用生效价
• 自动购包命中未配置价格套餐时，订单明细使用生效价

2. 赠送拦截

• 普通可售套餐显式填写 0 时被拒绝
• 赠送套餐显式填写 0 时允许保存
• 赠送套餐不出现在 C 端可购列表
• H5 / 客户端下单赠送套餐被拒绝
• 自动购包命中赠送套餐时被拒绝

3. 平台发放

• 平台后台可通过创建订单发放赠送套餐
• 赠送订单不要求线下支付凭证
• 赠送加油包在无主套餐时发放失败
• 赠送订单不会进入代理代购/佣金计算语义

4. 代理授权与分配

• 代理系列授权创建时无法加入赠送套餐
• 系列授权详情列表不展示赠送套餐
• 批量分配不会把赠送套餐分配给下级代理
• 代理侧套餐列表不会看到赠送套餐

5. 历史迁移

• tb_package 已回填 price_config_status 与 is_gift
• tb_shop_package_allocation 已回填 retail_price_config_status
• tb_order_item / tb_package_usage 已回填赠送快照与价格状态快照
• tb_package_price_review_queue 中仅保留需要人工复核的记录

6. 最终检查

• 相关 Go 文件 lsp_diagnostics 无错误
• make migrate-version 为 139
• go run cmd/gendocs/main.go 执行成功
• go build ./... 执行成功