zkxw/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-receipt-confirm/spec.md

ADDED Requirements

Requirement: 收款确认待办列表

系统 SHALL 提供分页列表接口，仅返回 biz_protocol_payment_detail 中 pay_status = jfqrz（缴费确认中）且当前租户、del_flag=0 的明细。列表 SHALL 携带关联协议单标识信息（至少协议单 ID 或协议号展示字段）以便财务核对。

Scenario: 列表不含其他状态

• WHEN 请求收款确认列表
• THEN 每条明细的 pay_status SHALL 为 jfqrz

Requirement: 收款确认动作

系统 SHALL 提供确认接口，针对单条缴费明细主键：若当前行 pay_status 为 jfqrz，SHALL 将其更新为 yjf（已缴费），并可写入财务确认附件字段（若请求体提供）。若当前行不是 jfqrz，SHALL 拒绝并返回业务错误。若已为 yjf，SHALL 拒绝重复确认（幂等错误语义）。

Scenario: 正常确认

• WHEN 对 jfqrz 明细调用确认接口
• THEN 该明细 pay_status 变为 yjf

Scenario: 非法状态拒绝

• WHEN 对非 jfqrz 明细调用确认接口
• THEN 系统拒绝且不修改数据

Requirement: Web 收款确认页

Web 管理端 SHALL 提供「收款确认（财务）」列表页，对齐标准列表模板；SHALL 提供确认操作（弹窗上传附件/备注若需要）。页面 SHALL 仅展示待财务确认的明细。

Scenario: 财务完成确认

• WHEN 用户在列表中对一条待确认记录提交确认
• THEN 调用后端确认接口成功后该行从待办列表消失或状态更新为已缴费