充值赠送账户 MVP PRD

版本：V1.2 日期：2026-07-16 产品线：智慧餐厅 / 智慧营养健康餐厅 涉及端：PC 后台、微信小程序、消费机端 状态：评审稿

0. 文档说明

0.1 一句话概述

本需求在现有个人账户、餐补账户基础上，新增“赠送账户”，支持现金充值按规则赠送金额，并在充值、消费、订单、余额、流水、提现等资金链路中完整区分实付金额、赠送金额、到账金额和赠送支付金额。

0.2 最新变更

0.3 交付物

1. 背景

当前系统已有个人账户和餐补账户，支持现金充值、消费、订单查询、退款、提现等资金链路。现在需要在当前系统及功能下增加“现金充值赠送金额”能力：用户现金充值时可按后台规则获得赠送金额，赠送金额进入独立赠送账户，可用于消费，但不能提现。

本需求按新增 MVP 处理。当前系统没有正式上线的赠送规则、赠送账户和赠送消费字段；如本地分支存在相关开发痕迹，仅作为页面承载和代码位置参考，不作为已具备能力判断。

本版核心模块架构：

2. 目标

1. 在账户管理下新增“账户设置”，包含现金充值设置和消费顺序设置。
2. 支持配置现金充值赠送规则，MVP 只做满额固定赠送。
3. 充值时清楚区分实付金额、赠送金额、到账金额。
4. 新增赠送账户，与个人账户、餐补账户并列。
5. 消费时支持按后台配置的账户支付顺序扣款。
6. 所有相关消费订单、支付过程、支付成功页展示赠送支付金额。
7. 充值订单、充值记录、充值统计、导出中区分实付金额、赠送金额、到账金额。
8. 赠送金额不能提现，且防止“充值拿赠送后立即提现本金，只消费赠送金额”的套利。
9. 手机端余额、账户流水、PC 人员余额等所有余额入口补充赠送余额信息。

3. 范围

3.1 本期做

3.2 本期不做

• 不做比例赠送，只做固定金额赠送。
• 不做优惠券、积分、会员等级。
• 不做赠送金额有效期、过期清零。
• 不做按人员、部门、餐厅、档口配置赠送规则。
• 不做按人员、部门、餐厅、餐次差异化支付顺序。
• 不开放赠送账户手动转入个人账户。
• 不开放人工直接编辑赠送余额。

4. 用户与场景

5. 核心口径

5.1 账户口径

赠送账户有效期规则：

• 本期赠送余额不设置有效期。
• 赠送余额默认永久有效。
• 本期不做过期提醒、过期冻结、过期清零。
• 后续如要增加有效期，需作为独立需求重新设计规则、提示、流水和清零审计。

个人账户需要进一步区分：

5.2 充值金额口径

示例：充值 100，命中满 100 送 20。

5.3 防套利口径

问题路径：

充值拿赠送 -> 立即提现本金 -> 只消费赠送余额 -> 再充值再提现

控制规则：

计算口径：

可提现金额 = 普通可提现本金 - 已提现/已退金额
不可提现金额 = 餐补账户 + 赠送账户 + 活动充值本金

6. 业务规则

6.1 现金充值设置规则

现金充值设置位于：

账户管理 / 账户设置 / 现金充值设置

配置字段：

匹配规则：

1. 仅启用规则参与匹配。
2. 实付金额大于等于满额金额。
3. 适用端匹配当前充值来源。
4. 支付方式匹配当前支付方式。
5. 多条命中时，优先取满额金额最高；满额相同取赠送金额最高；仍相同取最新创建规则。
6. 未命中规则时赠送金额为 0，到账金额等于实付金额。

6.2 消费顺序设置

消费顺序设置位于：

账户管理 / 账户设置 / 消费顺序设置

可配置账户：

• 餐补账户
• 赠送账户
• 个人账户

默认顺序建议：

餐补账户 -> 赠送账户 -> 个人账户

配置规则：

保存确认文案：

调整账户支付顺序后，仅影响新订单，历史订单不重算。确认保存？

6.3 消费扣款规则

消费支付时，后端按当前有效消费顺序设置依次扣款。

订单必须记录：

• 现金支付金额
• 餐补支付金额
• 赠送支付金额
• 使用的扣款顺序版本或快照

示例：订单金额 28，支付顺序为餐补 -> 赠送 -> 个人。

订单记录：

实付金额 28，现金支付 0，餐补支付 20，赠送支付 8

6.4 退款规则

退款按原支付来源回退：

退款页面和订单详情需展示：

• 现金退款金额
• 餐补退款金额
• 赠送退款金额

赠送支付退款不能进入个人账户，也不能转为现金退款。

7. 信息架构与页面需求

7.1 PC：账户设置

7.1.1 入口

新增入口：

账户管理 / 账户设置

与以下模块并列：

• 补贴管理
• 现金管理
• 账户设置

账户设置下包含：

1. 现金充值设置
2. 消费顺序设置

7.1.2 现金充值设置

用途：

• 维护现金充值赠送规则。
• 固定充值金额字段口径：实付金额、赠送金额、到账金额。
• PC 端和小程序端充值时字段名固定为“赠送金额”，不因未命中规则而隐藏或改名；未命中规则时显示 赠送金额 0.00。
• 供 PC 现金充值和小程序充值读取，不直接完成充值入账。

列表字段：

表单字段：

7.1.3 消费顺序设置

配置字段：

展示建议：

• 采用 PC 后台常规表单交互，不采用拖拽或卡片式排序。
• 表单包含“第一顺位、第二顺位、第三顺位”三个下拉框。
• 每个下拉框选项均为餐补账户、赠送账户、个人账户。
• 默认展示当前生效顺序。
• 下拉变更后实时刷新“当前预览”，如餐补账户 -> 赠送账户 -> 个人账户。
• 页面展示“仅影响新订单”的说明。
• 保存后写入操作日志。

页面交付要求：

• 消费顺序设置必须作为独立页面交付，路径为账户管理 / 账户设置 / 消费顺序设置。
• 页面包含当前启用顺序、三顺位下拉配置区、当前预览、保存校验区、保存确认提示、恢复默认、操作日志。
• 保存校验必须提示三个账户全部参与、账户不可重复、生效范围为新订单。
• 如果三个下拉框存在重复账户，保存按钮不可用，并提示“三个顺位必须选择不同账户，且餐补账户、赠送账户、个人账户必须全部出现”。
• 顶部快捷“保存消费顺序”和页面内“保存”必须走同一套校验逻辑，不能绕过校验。
• “恢复默认”点击后恢复为餐补账户 -> 赠送账户 -> 个人账户。
• 操作日志记录操作时间、操作人、调整前顺序、调整后顺序、影响范围。

7.2 PC：现金管理 / 现金充值

本地落点：

• 路由：/accountManagement/cashManagement/rechargeList
• 页面：zhctproject/store/public/static/src/view/accountManagement/cashManagement/rechargeList.vue
• 组件：zhctproject/store/public/static/src/components/rechargeTable.vue

职责：

• 执行现金充值。
• 按账户设置中的现金充值设置匹配赠送规则。
• 展示并保存实付金额、赠送金额、到账金额。
• 不承载配置入口。

新增充值弹窗字段：

交互：

• 输入实付金额或切换支付方式后，实时刷新赠送金额和到账金额。
• 始终显示字段名“赠送金额”；赠送金额为 0 时显示赠送金额 0.00，并提示“未命中赠送规则”。
• 命中规则时显示规则名称，如“满100送20”。

充值订单列表新增/调整字段：

充值订单详情必须展示：

• 实付金额
• 赠送金额
• 到账金额
• 活动充值本金
• 命中赠送规则名称
• 是否进入可提现金额

充值订单导出必须包含：

充值单编号 / 姓名 / 部门 / 充值类型 / 实付金额 / 赠送金额 / 到账金额 / 活动充值本金 / 可提现本金 / 操作人 / 操作时间

充值统计需区分：

• 实收金额合计 = 实付金额合计
• 赠送金额合计
• 到账金额合计 = 实付金额合计 + 赠送金额合计
• 活动充值本金合计

7.3 PC：消费订单

本地落点：

• 页面：zhctproject/store/public/static/src/view/order/consume/index.vue
• 表格：zhctproject/store/public/static/src/view/order/customTable.vue

金额列顺序：

订单金额 / 优惠金额 / 服务金额 / 实付金额 / 现金支付 / 餐补支付 / 赠送支付 / 退款金额

新增要求：

• 列表增加“赠送支付”。
• 统计卡增加“赠送支付合计”。
• 导出增加“赠送支付”。
• 订单详情增加“赠送支付”。
• 退款相关页面增加“赠送退款”。
• 老订单赠送支付默认 0.00。

7.4 PC：人员管理资产展示

本地落点：

• 人员列表：zhctproject/store/public/static/src/view/staff/staffList.vue
• 人员详情：zhctproject/store/public/static/src/view/staff/lookStaff.vue
• 人员编辑：zhctproject/store/public/static/src/view/staff/editStaff.vue
• 组织人员列表：zhctproject/store/public/static/src/view/integratedManagement/organization.vue

当前系统已有余额相关展示：

列表列建议：

现金余额 / 补贴余额 / 赠送余额 / 可提现金额

若人员列表当前只有“当前余额”，则本期最小改动为：

• “当前余额”改名为“个人余额”或“现金余额”。
• 旁边新增“赠送余额”列。
• 如接口可返回餐补余额，则同步展示“餐补余额”；否则标记为接口补充项。
• 导出人员列表时同步增加“赠送余额”列，避免页面和导出口径不一致。
• 人员编辑页如展示赠送余额，必须为只读；赠送余额只能通过充值赠送、消费、退款等账户流水变动。

人员资产页文案：

赠送余额为充值活动赠送金额，可消费，不可提现。

7.5 小程序：我的余额

本地落点：zhctproject/ai_app/settlement/payment/balance.vue

展示：

• 个人账户余额
• 餐补账户余额
• 赠送账户余额
• 可提现金额入口说明

推荐展示结构：

文案：

赠送账户余额可消费，不可提现。

小程序钱包首页 zhctproject/ai_app/pages/wallet/index.vue 当前只展示“账户余额(元)”，需同步改为三账户展示，或入口跳转至统一“我的余额”页，避免两个余额入口口径不一致。

7.6 小程序：账户流水

本地落点：

• 余额流水：zhctproject/ai_app/pages/wallet/balance/log.vue
• 充值记录：zhctproject/ai_app/pages/wallet/recharge/order.vue

账户流水必须增加赠送相关信息。

流水列表字段：

赠送流水展示规则：

推荐文案：

[赠送账户] 充值赠送入账 +20.00
[赠送账户] 消费扣款 -8.00
[赠送账户] 赠送退款入账 +8.00

流水详情需展示：

• 来源单号
• 场景
• 账户类型
• 变动前余额
• 变动金额
• 变动后余额
• 是否可提现：赠送账户固定显示“不可提现”

7.7 小程序：充值

本地落点：zhctproject/ai_app/settlement/payment/recharge.vue

页面展示：

• 顶部账户余额面板从个人、餐补扩展为个人、餐补、赠送。
• 输入充值金额后展示：

- 实付金额 - 赠送金额 - 到账金额

• 支付按钮金额必须按实付金额展示。
• 赠送金额进入赠送账户，可消费，不可提现。

充值记录 zhctproject/ai_app/pages/wallet/recharge/order.vue 需展示：

• 实付金额
• 赠送金额
• 到账金额
• 命中规则名称
• 到账时间

7.8 小程序：手机点餐支付

本地落点：zhctproject/ai_app/settlement/ordering/cashier/index.vue

支付过程页展示：

• 订单金额
• 预计现金支付
• 预计餐补支付
• 预计赠送支付
• 当前扣款顺序

支付成功页或跳转后的订单详情展示：

• 实际现金支付
• 实际餐补支付
• 实际赠送支付
• 支付后个人余额、餐补余额、赠送余额

实际扣款拆分必须以后端返回为准，前端预估仅用于支付过程展示。

7.9 小程序：扫码/机端支付

本地落点：zhctproject/ai_app/settlement/payment/scanPay.vue

支付过程弹窗展示：

• 本次付款金额
• 预计现金支付
• 预计餐补支付
• 预计赠送支付
• 当前扣款顺序

支付成功弹窗展示：

• 实际现金支付
• 实际餐补支付
• 实际赠送支付
• 支付后赠送账户余额

7.10 小程序：订单详情

本地落点：zhctproject/ai_app/settlement/orderDetails/index.vue

价格汇总区增加：

退款订单需展示赠送退款金额。

7.11 小程序：提现

本地落点：zhctproject/ai_app/settlement/payment/cash.vue

展示：

• 保持当前“可提现金额(元)”顶部大金额。
• 增加不可提现说明：

- 可提现金额仅包含个人账户中符合提现条件的普通本金。 - 餐补账户、赠送账户、活动充值本金不可提现。

文案：

餐补账户、赠送账户、活动充值本金不可提现。

如存在赠送余额，展示：

赠送账户余额 ¥xx 可消费，不可提现。

如存在活动充值本金，展示：

活动充值本金 ¥xx 可消费，不可提现。

7.12 消费机端

范围：

• 点餐消费
• 定额消费
• 自由金额消费
• 机端支付成功页

支付过程展示：

• 应付金额
• 预计现金支付
• 预计餐补支付
• 预计赠送支付
• 当前扣款顺序

支付成功展示：

• 实际现金支付
• 实际餐补支付
• 实际赠送支付
• 如当前机端支持余额展示，则同步展示支付后个人账户、餐补账户、赠送账户余额。

8. 数据与接口

8.1 数据字段建议

8.2 接口影响

8.3 幂等与一致性

9. 权限与日志

10. 异常与兼容

11. 验收标准

12. 全局余额相关页面排查清单

本次需求不只改充值页。凡是展示“余额、账户、提现、退款、资金流水”的位置，都要检查是否需要增加赠送余额或赠送支付口径。

排查原则：

• 页面展示“余额”时，必须说明是现金/个人余额、餐补余额、赠送余额，不能再用一个总余额覆盖三账户。
• 页面展示“可提现”时，必须排除餐补账户、赠送账户、活动充值本金。
• 页面展示“实收/收款/充值金额”时，必须区分实付金额和到账金额。
• 页面展示“消费/退款”时，必须区分现金支付、餐补支付、赠送支付。

13. 发布与灰度

建议发布顺序：

1. 数据库和后端账户字段上线。
2. 账户设置上线，默认消费顺序为餐补 -> 赠送 -> 个人。
3. PC 现金充值三金额上线。
4. 小程序充值、余额、流水上线。
5. 消费支付扣款拆分上线。
6. 订单、退款、导出、统计字段上线。
7. 人员列表、人员详情、组织人员列表余额展示上线。

灰度建议：

• 先在测试商户或内部食堂启用现金充值设置。
• 老订单赠送金额默认 0，确保查询、导出、统计不报错。
• 灰度期间重点监控充值入账、消费扣款、退款回退、提现金额。

14. 风险与待确认