1.9 KiB
1.9 KiB
ADDED Requirements
Requirement: 租户内采集协议单分页列表
系统 SHALL 向已认证管理端用户提供采集协议单分页查询接口，数据来源为 biz_collection_protocol。查询 SHALL 限定当前用户所属 tenant_no，且默认排除 del_flag=1。列表默认排序 SHALL 为 create_time DESC（若无自定义排序）。列表 SHALL 至少包含协议号展示字段、协议状态、创建时间等便于识别的列。
Scenario: 仅返回本租户数据
- WHEN 用户请求采集协议单分页列表且租户为 T
- THEN 响应中每条记录的
tenant_noSHALL 为 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 页面加载分页列表并可通过操作查看概要详情