6.2 KiB
6.2 KiB
高考版开关与全局定价收口说明
1. 目标
价格配置统一收口到超级管理后台 订单和财务 -> 全局定价，并在该页面支持三档切换：
- 个人版
- 企业版
- 高考版
三档价格独立维护、互不覆盖；高考版管理页与企业端页面不再作为价格主入口。
2. 主操作入口
- 登录超级管理员后台。
- 进入
订单和财务页面（路由：/superadmin/commerce）。 - 点击
全局定价页签。 - 在全局定价页进行“个人版/企业版/高考版”切换并保存。
3. 页面交互要求（全局定价页）
3.1 切换控件
- 定价范围使用单选切换按钮（与现有风格一致）。
- 选项固定为：
个人版、企业版、高考版。 - 切换时立即加载对应档位价格数据，不自动保存当前改动。
3.2 价格字段
个人版与企业版展示以下字段（元/次）：
- MBTI
- DISC
- PDP
- 人脸
- SBTI
高考版展示以下字段（元/次）：
- MBTI
- DISC
- PDP
- 人脸
- SBTI
- 高考报告（仅高考版可配置）
仅企业版额外展示：
- 最低充值金额（元）
- 最低充值金额仅允许超管在全局定价中设置
3.3 保存行为
- 保存按钮统一为
保存定价。 - 仅保存当前档位数据，不影响其他档位。
- 保存成功后给出成功提示，失败时提示错误原因。
3.4 其他页面行为约束
- 高考版管理页：仅保留“价格说明”或“去全局定价配置”按钮，不提供价格编辑控件。
- 企业端页面：不提供全局价格编辑能力，仅展示生效价格（可选）或说明文案。
- 任意价格修改都必须在
订单和财务 -> 全局定价完成。 - 权限约束：仅高考版具备“高考报告”能力，个人版与企业版无高考权限。
- 权限约束：
minRecharge仅超管可改，企业端及其他角色不可改。
3.5 小程序版本切换规则（新增）
- 小程序侧需支持 3 种版本能力：
个人版、企业版、高考版。 - 当某企业仅配置了 2 种版本时，继续沿用当前默认规则（不弹选择框，按现有逻辑直达）。
- 当某企业配置了 3 种版本时，用户首次进入相关入口先弹出“版本选择框”，由用户选择本次使用版本。
- 弹框样式要求：上下左右居中（蒙层 + 居中 modal），优先展示三个版本按钮，支持取消/关闭。
- 用户选定后进入对应流程；可按产品策略决定是否记忆最近一次选择（默认建议记忆）。
小程序弹框文案建议
- 标题：
请选择使用版本 - 副标题：
你可在个人版、企业版、高考版之间切换 - 按钮：
个人版/企业版/高考版 - 次按钮：
取消
4. 数据口径与存储约定（最终）
4.1 三档映射
- 个人版：
pricing(type=personal) - 企业版：
pricing(type=enterprise, enterpriseId=NULL)（企业默认全局定价） - 高考版：
pricing(type=gaokao)
不采用 type=enterprise + scope=gaokao 的混合方案，避免统计与维护复杂度上升。
4.2 字段默认值
未配置时按 0 回填，避免前端出现 null：
- 个人版/企业版：
face,mbti,disc,pdp,sbti - 高考版：
face,mbti,disc,pdp,sbti,gaokao minRecharge（仅企业版，且仅超管可配置）
5. API 需求（待开发）
5.1 已有接口（继续使用）
- 开关配置：
GET /api/v1/superadmin/gaokao/configPOST /api/v1/superadmin/gaokao/config
- 定价配置：
GET /api/v1/superadmin/pricing?type=...PUT /api/v1/superadmin/pricing
5.2 新增能力（必须）
pricing 接口需要支持 type=gaokao 的读取与保存。
小程序配置接口需返回“当前企业可用版本集合”（用于判断是否弹版本选择框）。
5.3 页面与接口职责边界
superadmin/commerce（全局定价页）负责调用pricing接口进行读写。superadmin/gaokao（高考版管理页）不直接写价格，可仅跳转到全局定价页。- 企业端接口与页面不写全局定价，避免口径分叉。
5.4 请求体示例
企业版示例：
{
"type": "enterprise",
"config": {
"face": 9.9,
"mbti": 19.9,
"disc": 19.9,
"pdp": 19.9,
"sbti": 19.9,
"minRecharge": 100
}
}
高考版示例：
{
"type": "gaokao",
"config": {
"face": 9.9,
"mbti": 19.9,
"disc": 19.9,
"pdp": 19.9,
"sbti": 19.9,
"gaokao": 39.9
}
}
6. 验收标准
订单和财务 -> 全局定价页面可切换个人版/企业版/高考版三个档位。- 每个档位都能独立读取并回显对应价格。
- 修改并保存任一档位，不会影响其他两个档位。
- 企业版可单独维护
minRecharge，高考版与个人版不显示该字段。 - 刷新页面后，三档价格与保存前一致。
- 高考版定价的存储与读取均走
pricing(type=gaokao)。 - 高考版管理页与企业端页面无价格编辑入口（仅说明/跳转）。
- 小程序在“三种版本都可用”时，先显示居中版本选择弹框；仅两种时沿用当前默认直达规则。
- 仅高考版可配置与使用“高考报告”；个人版与企业版无高考权限且不展示高考字段。
minRecharge仅超管可配置；企业端与其他角色不可编辑该字段。
7. 测试建议
- 在
订单和财务 -> 全局定价依次切到三档，各改一个不同价格后分别保存。 - 回切确认数据未串档。
- 重新登录后台再次核对三档回显。
- 在小程序下单流程抽测：
- 个人版/企业版：无高考入口与高考报告购买能力。
- 高考版：高考报告价格命中正确。
- 检查高考版管理页与企业端页面，确认无价格编辑入口。
- 验证
minRecharge权限：- 超管可在全局定价页修改并保存。
- 企业端及其他角色看不到或不可编辑该字段。
- 分别验证小程序企业场景：
- 可用版本=2：不弹框，按当前逻辑进入。
- 可用版本=3：弹出居中版本选择框，三按钮可正常跳转。
8. 备注
本文档是需求规格稿，先用于评审与排期；你确认后再按本文档开始开发。