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

ADDED Requirements

Requirement: 租户内采集协议单分页列表

系统 SHALL 向已认证管理端用户提供采集协议单分页查询接口，数据来源为 biz_collection_protocol。查询 SHALL 限定当前用户所属 tenant_no，且默认排除 del_flag=1。列表默认排序 SHALL 为 create_time DESC（若无自定义排序）。列表 SHALL 至少包含协议号展示字段、协议状态、创建时间等便于识别的列。

Scenario: 仅返回本租户数据

• WHEN 用户请求采集协议单分页列表且租户为 T
• THEN 响应中每条记录的 tenant_no SHALL 为 T，且不包含已软删除行

Requirement: 采集协议单概要详情

系统 SHALL 提供按主键查询单条采集协议单的接口，返回 biz_collection_protocol 业务字段及公共字段。系统 SHOULD 在同响应或次级结构中附带同一协议单关联的缴费主表 biz_protocol_payment 概要（若存在），用于详情页展示缴费模式与金额类信息。

Scenario: 详情命中未删除记录

• WHEN 请求详情且 id 对应当租户下未删除协议单
• THEN 系统返回该协议单数据；若存在缴费主表记录则一并返回概要

Scenario: 跨租户或已删除拒绝

• WHEN 请求详情 id 不属于当前租户或记录已软删除
• THEN 系统返回 404 或与项目一致的业务错误，且不泄漏其他租户数据

Requirement: Web 采集协议单列表与概要详情页

Web 管理端 SHALL 提供采集协议单列表页（筛选、工具栏、表格、分页），对齐 web-admin 标准列表模板与 Fresh Mint 规范。SHALL 支持打开概要详情（抽屉或弹窗），展示主表及缴费概要；第一版不要求录入全部子表字段。

Scenario: 用户打开列表页

• WHEN 用户进入「采集协议单」菜单路由
• THEN 页面加载分页列表并可通过操作查看概要详情