补贴增加充值方式调整方案
国信项目 · 2026-10-19 · 口径确认版 v1.3 · 已授权并完成实现，尚未部署
统一字段名称为“充值方式”，选项为“现金”“单位补贴”，不改名为“来源”。该字段仅作记录，不是系统现金账户充值；无论选择哪种充值方式，最终都进入补贴余额，不增加现金余额。
1. 已确认的口径
| 场景 | 充值方式 | 余额与业务处理 |
|---|---|---|
| 手动新增补贴 | 默认“现金”，可改为“单位补贴” | 两者均进入补贴账户，保持原审核、终审与到账流程 |
| 批量导入补贴 | 固定“单位补贴”，不开放切换 | 服务端固定写入，不由前端或Excel决定 |
| 自动规则发放 | 新增批次默认“单位补贴” | 只记录充值方式，不改变规则金额、发放时间和审核逻辑 |
| 消费与退款 | 沿用原补贴链路 | 不因充值方式为现金，就变成现金支付或现金账户退款 |
- “单位补点”按本次已确认的“单位补贴”统一文案。
- 本次不是开放现金账户充值，不生成现金充值订单，不改变现金管理和现金充值统计。
- 现有补贴余额、有效期、扣款顺序和退款分摊口径均保持原样。
2. 手动新增补贴如何调整
在“账户管理 → 补贴管理 → 补贴发放新增 → 新增补贴”弹窗中，将“充值方式”放在“补贴金额”下方、“有效期”上方。
| 字段 | 展示与规则 |
|---|---|
| 充值方式 | 必填；两个等宽分段单选“现金”“单位补贴”，沿用系统选中态 |
| 默认值 | 默认选中“现金”，需要时可改为“单位补贴”；该口径已由用户确认 |
| 其余字段 | 部门、人员、金额、有效期、备注沿用原交互和校验 |
一次手动新增仍是一份发放批次；同批次选中的人员共用一种充值方式，不支持同一批次内混合两种充值方式。
按用户最新确认，弹窗不再展示原“充值方式仅作记录……”说明文字；只优化选项间距和选中态，字段名称、默认现金和数值1/2的提交参数均不变。
创建后在详情、审核、终审时只读展示充值方式。审核前发现误选，可按原有驳回后重新发起的流程处理；本期不新增已到账记录的直接修改充值方式功能。
3. 批量导入如何调整
- 继续使用现有“批量导入补贴”弹窗，在备注上方只读展示“充值方式：单位补贴”。
- Excel模板不新增充值方式列，原模板保持兼容；每行金额和有效期仍按原规则读取。
- 服务端强制记为“单位补贴”。即使请求中伪造“现金”参数，也不能改变批量导入的充值方式。
- 不改变现有文件校验、申请生成、审核或终审逻辑。这里是补贴充值导入，不是消费机补单导入，不混用补单条数规则。
4. 充值方式与现有操作来源分开保存
目前“规则名称”列中的“手动补贴”“批量导入”来自发放批次名称，现有source字段表示录入方式：手动、自动规则、导入。它不能替代本次充值方式。
建议在补贴批次表subsidy_log增加一个独立字段recharge_method，业务名称和界面名称统一为“充值方式”。表单、列表、详情、导出列头及未来如增加的筛选均使用这个名称，不另命名为“来源”或“资金来源”。
| 字段值（建议） | 显示名称 | 使用范围 |
|---|---|---|
| 0 | 历史未标注 | 新字段上线前的记录、缺少关联批次的历史到账记录 |
| 1 | 现金 | 新手动补贴的默认充值方式，也可由操作人显式选择 |
| 2 | 单位补贴 | 手动改选单位补贴、批量导入固定充值方式、自动规则新增批次的默认充值方式 |
- 保留原source、name、rule_id，不把“手动补贴”改名为“现金”，避免丢失原来的操作来源。
- 采用批次级存储：现有待发明细和到账记录已通过log_id关联批次，可复用该关系读取充值方式。
- 最小实现不在AI到账表复制同一字段，不修改跨库资金写入链路，也不新增一套现金余额或资金流水。
- 数据库新增字段默认0，避免旧记录被自动归类。新创建的手动补贴前后端统一默认现金，缺少参数的旧手动调用也按现金记录；仅影响新增记录，不回填历史。明确传入的非法枚举值必须拒绝，不能把非法值静默当成现金。
- 自动规则生成的新增批次默认记为单位补贴，该口径已由用户确认；只记录充值方式，不改变规则金额、发放时间或原审核逻辑。
5. 展示和导出范围
必要展示
- 补贴发放新增、审核、终审三个列表及批次详情增加“充值方式”。建议列表放在“规则名称”后，方便同时识别原操作来源和新增充值方式。
- 现有状态、备注、审核人、终审人等字段保留，原金额和人数合计不变。
查询对账与导出展示
本期按已确认的最小范围处理：增加属性的录入、保存、列表/详情展示和对应导出，不额外改造查询或资金业务。
| 页面/文件 | 本期调整 |
|---|---|
| 补贴管理三个列表 | 增加充值方式列，原筛选条件不变 |
| 统计报表 → 充值补贴统计 → 补贴统计 | 增加充值方式列；金额仍按原money+used_money计算，原筛选条件不变 |
| 补贴统计异步XLSX导出 | 与列表使用相同批次记录和查询条件，增加充值方式列；总合计随同条件变化 |
| 人员档案 → 补贴记录 | 展示对应批次充值方式，便于核对个人补贴的充值方式 |
| 人员档案统一导出 | 只在补贴记录Sheet增加充值方式，消费和退款Sheet保持原样 |
- 原查询结果继续包含历史未标注、现金、单位补贴，不因新增充值方式字段而减少原有总金额。
- 本期不默认增加充值方式筛选；如后续需要，另行确认，并保证分页、合计和导出使用相同条件。
- 缺少批次关联时显示“历史未标注”，不报错、不虚构充值方式。
- 充值方式为“现金”的补贴仍在补贴报表中对账，不能再次算入现金账户充值统计，避免重复计算。
6. 历史记录处理
- 旧系统没有保存充值方式，不能根据“手动补贴”、操作人、备注或金额猜测充值方式。
- 本期建议全部保留为“历史未标注”，不自动批量刷成现金或单位补贴。
- 历史自动规则、批量导入是否统一归类为单位补贴，如需补录，应另行确认范围、证据和回滚方式后处理，不与功能上线混在一起。
7. 资金链路与兼容边界
手动选择现金 → 保存“充值方式：现金” → 原审核/终审 → 增加补贴余额；现金账户始终不因这笔补贴而变化。
- 不改变消费机刷脸、刷卡、定额、自定义消费和H5外卖的扣款方法。
- 不改变补贴优先级、有效期、余额计算、退款方式、提现或账户归属。
- 消费使用这笔补贴时，订单仍按现有“补贴支付”展示，不改成“现金支付”。
- 现有负数补贴调整是否可用，沿用原系统规则；本次不因充值方式选择现金自动生成退现或现金退款。
- 充值方式记录不是确认收款的支付凭证，不新增在线收款、支付网关或现金交接流程。
8. 验收标准与测试矩阵
下表是拟执行的验收，不是已经通过的测试结果。
| 编号 | 场景 | 预期 |
|---|---|---|
| AC-01 | 手动补贴100元，充值方式为现金 | 新增弹窗默认现金；终审前余额不变；终审通过后补贴余额增加100元，现金余额不变，充值方式显示现金 |
| AC-02 | 手动单位补贴100元 | 保持原入账流程，补贴余额增加100元，现金余额不变，充值方式显示单位补贴 |
| AC-03 | 批量导入及伪造现金参数 | 全批固定单位补贴；原文件及金额/有效期校验保持 |
| AC-04 | 审核或终审驳回 | 充值方式可查看，补贴和现金余额均不因驳回申请而增加 |
| AC-05 | 历史记录或缺少批次 | 显示历史未标注；原记录、金额和合计保留 |
| AC-06 | 列表、原查询/合计、异步导出及个人补贴Sheet | 字段名均为“充值方式”，相同记录的充值方式一致，原查询条件和合计口径不变；不影响消费/退款Sheet |
| AC-07 | 既有消费和退款回归 | 充值方式为现金不改变实际扣款/退款账户和原资金分摊 |
| AC-08 | 非法充值方式或旧调用缺字段 | 明确传入非法值则拒绝；新增手动缺省现金、导入固定单位补贴、自动规则新增批次默认单位补贴；历史仍未标注 |
实施时应在授权的测试环境验证真实提交、数据库保存、审核/终审、余额和导出；不以字段单测替代资金链路验收，未经授权不写客户生产资金数据。
9. 实施与发布建议
- 已确认手动默认现金、自动规则默认单位补贴；按第5节的属性展示/导出范围实施，不默认新增筛选。用户已于2026-10-19授权开发，正式SQL版本确认为v2.0.45。
- 按确认版本准备批次表新增字段SQL；先完成测试库迁移，再更新后台写入/读取与前端。
- 补齐字段枚举、旧调用、历史记录、权限和报表/导出测试；确认只新增分类信息，没有改变金额与资金操作。
- 按正式任务提交代码并关联云效；测试通过后按项目发布流程上线。
- 回滚优先回退应用对新字段的读写，保留数据列和已记录的充值方式；不通过删除字段或重刷充值方式丢弃有效数据。
方案评审阶段仅形成文档；2026-10-19用户授权后已在store/guoxin_develop完成本地代码和隔离验证。没有执行共享开发库或客户库SQL、创建云效任务或部署系统；本机MySQL独立临时库仅用于SQL验证，已清理。
10. 当前证据与评审状态
- 已确认：新字段统一叫“充值方式”，不改名为“来源”；现金仅作记录、不涉及现金账户充值；手动新增默认现金、可改单位补贴；两种充值方式均进入补贴余额；批量导入固定单位补贴、不开放切换；自动规则新增批次默认单位补贴。
- 本期范围：增加充值方式属性及查询对账位置的展示和导出，其他沿原补贴逻辑；新增筛选不默认纳入。不再将已确认默认项列为“待审核建议”。
- 已核对当前store/guoxin_develop源码：Subsidy服务的submit/import/updateStatus、补贴管理页面、SubsidyReport列表/异步导出及StaffTransaction补贴记录，确认可以复用批次log_id关系。
- 页面依据为用户提供的补贴管理截图和当前表单源码；本文没有用历史图片冒充新系统截图，也没有声称已完成可点击原型或界面验收。
- Use Case ID：UC-SUBSIDY-026 v1.3，DoR：READY。已取得开发授权并完成实现；发布前仍需按顺序迁移字段、部署并完成集成环境验收。云效父需求VWCG-1462、开发VWCG-1463、测试VWCG-1464；证据见work_store/VWCG-1462-subsidy-recharge-method/。
- 主流程M1手动选择充值方式、M2导入固定单位补贴、M3批次固化与只读审核、M4原终审入账、M5按充值方式对账。分支A1历史未标注、A2旧调用兼容；异常/恢复E1非法枚举拒绝、E2原审核驳回后重提、E3关联缺失按未知展示。对应AC-01~08。