2.7 KiB
2.7 KiB
移动端协议单:优惠价 → 合同 → 协议总金额联动 — 设计说明
日期: 2026-10-13
状态: 已确认(P2-B)
范围: mobile-oa-h5 细胞存储协议新增/编辑;对齐 Web SamplePaymentPanel + ProtocolFormDialog 金额联动
前置: P1 缴费面板、P2-A 客户检索
1. 目标
- 样本优惠价(
sample.price)变更时,按 Web 规则同步对应样本的contractAmount(及趸交应缴重建)。 - 协议总金额在未手改偏离时,跟随各样本合同合计;手改后停止跟随,直到再次与合计一致。
- 表单展示样本合同合计与不一致提示(保存前已有校验,编辑过程也可见)。
2. 决策摘要
| 项 | 决策 |
|---|---|
| 优惠价→合同 | 移植 Web applyPreferentialPriceToPayment:有已确认转账(yjf)不改;首次对齐仅补空合同;已跟踪且价变则强制覆盖 |
| 趸交 / 分期 | dj:改合同后 rebuildSampleSchedules;fq/fgd:只改合同,不自动改各期金额 |
| 协议总金额跟随 | protocolTotalFollowSamples:默认 true;用户编辑后若与合计差 >0.015 则 false;合计变化时若 follow 则写回总金额 |
| UI | 协议信息区:protocolTotalAmount 可编;只读展示「样本合同合计」+ mismatch hint |
| 非目标 | 意向金;v1 整单缴费;Web 改动 |
3. 实现要点
3.1 纯函数(protocol-sample-payment.js)
- 导出
applyPreferentialPriceToPayment(pay, sample, force, { rebuild })(或拆成可测纯函数 + panel 内 rebuild 回调)。 - 已有
shouldReplaceContractWithPreferentialPrice/parsePreferentialPrice/sumSampleContractAmounts/protocolTotalMismatchHint复用。 - 新增
shouldFollowProtocolTotal(total, sampleSum)、nextProtocolTotalFromSamples(follow, sampleSum)。
3.2 ProtocolSamplePaymentPanel
- 扩展
sampleswatch:维护lastPreferentialByCode;对已有支付行调用applyPreferentialPriceToPayment。 - 对齐 Web 的 same 比较,避免无意义 emit。
3.3 MarketModuleForm
- 细胞存储:watch
sumSampleContractAmounts(samplePayments)→ 若 follow 则更新protocolTotalAmount。 protocolTotalAmount字段变更时更新 follow 标志。- UI:在缴费面板上方或协议区展示合计与 hint(可用 computed + 简单文案块)。
4. 测试
- 纯函数:空合同补价;手填合同不因首次对齐被盖;force 时覆盖;yjf 锁定不改;follow 开关。
- Panel/契约:samples price 变化触发合同更新(可通过导出函数单测覆盖主逻辑)。
5. 非目标
- 意向金(下一项)。
- 列表卡片金额字段扩展。