Files
zkxw/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-protocol-audit/spec.md
T
2026-05-17 08:36:37 +08:00

1.8 KiB

ADDED Requirements

Requirement: 审核记录写入且不修改协议单状态

系统 SHALL 支持对指定采集协议单提交审核结果,持久化到 biz_protocol_audit,字段包含审核状态(shtg 审核通过、shth 审核退回)、审核备注、审核人(当前用户)及关联协议单 ID。系统 SHALL NOT 因审核提交而修改 biz_collection_protocol.protocol_status 或协议单其他状态字段。

Scenario: 提交审核成功写入一行

  • WHEN 审核人对某协议单提交合法审核结果
  • THEN 系统插入一条 biz_protocol_audit 记录且协议单主表状态字段保持不变

Requirement: 同一协议单多条审核历史

系统 SHALL 允许同一 collection_protocol_id 存在多条审核记录(按时间保留历史),SHALL NOT 以唯一约束强制单行覆盖。

Scenario: 同一协议单两次审核

  • WHEN 同一协议单先后两次提交审核
  • THEN 系统存在两条审核记录且均可被列表查询到

Requirement: 审核列表查询

系统 SHALL 提供审核记录分页列表接口,限定当前租户未删除数据,并支持按关键字(如协议号关联合理性由实现约定)、审核状态筛选。默认排序 SHALL 符合项目列表约定。

Scenario: 列表仅含本租户审核

  • WHEN 请求审核列表
  • THEN 返回记录均属当前租户且 del_flag=0

Requirement: Web 采集协议单审核页

Web 管理端 SHALL 提供「采集协议单审核」页面,包含列表与审核操作入口(通过/退回及备注);弹窗表单 SHALL 符合 label-position="top" 与 CRUD 弹窗规范。

Scenario: 用户完成一次审核提交

  • WHEN 用户填写审核结论并提交
  • THEN 系统调用审核接口成功后刷新列表或局部更新