# 柜台收费缴费后连续预存设计

## 背景与问题

单客户柜台收费完成后，页面会保留刚缴纳的账单作为“收讫”展示行。当前实现同时将这些账单标记为 `displayChargeState: 'settled'` 并继续保留在 `selectedChargeRows` 中。

无欠费预存模式要求页面不存在 `settled` 展示行，因此缴费完成后收费按钮被禁用，用户无法在同一客户、同一页面中继续办理预存。

## 目标

- 单客户普通账单缴费成功后，可以立即继续办理预存。
- 已缴账单继续显示“收讫”，用于核对和查看账单详情。
- 已缴账单不得再次进入收费提交数据。
- 缴费完成后清空上一次实收金额，避免误将账单金额作为预存金额再次提交。
- 集收号收费逻辑保持不变。

## 方案

### 已缴账单展示状态

单客户普通账单收费成功后：

1. 保留账单展示行；
2. `payState` 和 `payStateName` 继续表示“收讫”；
3. 将 `displayChargeState` 设为 `history`，表示该行仅供回看，不再阻塞后续操作；
4. `displayChargeType` 保持 `bill`，详情继续使用普通账单详情链路。

### 选中状态与金额

- 收费成功后将 `selectedChargeRows` 清空。
- 调用现有金额同步逻辑后，`actualAmount` 清空。
- 已缴展示行因 `payState === 1` 继续保持不可勾选，不能再次加入收费数据。

### 预存模式

后台刷新后不存在待缴账单，且历史展示行不计入 `hasSettledChargeDisplay`，因此 `noArrearsTopupMode` 自动成立。收费按钮重新可用，用户输入新的实收金额后，提交路径调用预存接口而不是账单收费接口。

### 集收号边界

集收号收费完成后的展示和按钮限制不调整。集收号模式仍不支持缴费后直接多缴或预存，避免改变现有批量收费约束。

## 异常与安全约束

- 如果收费成功后的账单刷新失败，沿用现有异常提示，不把失败状态误切换成预存模式。
- 历史收讫行必须不可选择、不可删除，但可以查看详情和打印。
- 连续预存提交时，支付载荷中不得包含刚缴纳账单的 ID。
- 页面切换客户或关闭客户时，继续沿用现有状态清理逻辑。

## 测试与验收

新增前端 `node:test` 契约测试，先验证失败再实施：

1. 单客户普通账单收费成功后，收讫展示行使用 `history` 状态；
2. 收费成功后 `selectedChargeRows` 被清空；
3. 历史收讫行仍保持 `payState: 1`、`payStateName: '收讫'` 和 `displayChargeType: 'bill'`；
4. 历史收讫行不阻塞 `noArrearsTopupMode`；
5. 连续操作时进入 `submitCounterTopup` 路径，不重复调用 `submitCashCharge`；
6. 集收号收费成功后的现有处理保持不变。

验证运行相关 `node:test`、柜台收费现有测试和前端构建；按用户要求不运行 `vue-tsc`。