提交
This commit is contained in:
1 parent
246ad2228e
commit
8e2dd8b9f0
186 files changed
+38821
-2571
No files matched your search
+33
@@ -0,0 +1,33 @@
|
||||
## 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** 页面加载分页列表并可通过操作查看概要详情
|
||||
+33
@@ -0,0 +1,33 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 分期预警数据范围
|
||||
|
||||
系统 SHALL 仅统计满足以下条件的 `biz_protocol_payment_detail` 行:当前租户、`del_flag=0`、`pay_status = dfj`(待缴费)、`installment_no` 非空(分期明细)。系统 SHALL NOT 将 `pay_status = jfqrz` 或其他状态纳入本列表。
|
||||
|
||||
#### Scenario: 待缴费过滤
|
||||
|
||||
- **WHEN** 请求分期预警列表
|
||||
- **THEN** 返回行均满足 `dfj` 且存在分期期序号
|
||||
|
||||
### Requirement: 预警与逾期判定
|
||||
|
||||
系统 SHALL 使用服务器当前日期与 `installment_due_date`(存储为 `YYYYMMDD` 字符串)比较。对每一行 SHALL 可判定:
|
||||
|
||||
- **逾期**:应缴日早于当天;
|
||||
- **预警**:应缴日在当天或未来 15 天(含)内,且未逾期。
|
||||
|
||||
系统 SHALL 支持按「预警 / 逾期 / 全部」类筛选参数过滤(具体 query 名称以实现为准,须在前后端一致)。
|
||||
|
||||
#### Scenario: 超出 15 天未到期不标为预警
|
||||
|
||||
- **WHEN** 某分期应缴日晚于今天起算第 16 天
|
||||
- **THEN** 该行在仅查「预警」类结果中 SHALL NOT 出现(「全部」是否出现由产品约定;默认实现可仍列出但标签非预警)
|
||||
|
||||
### Requirement: Web 分期缴费预警页
|
||||
|
||||
Web 管理端 SHALL 提供「分期缴费用户预警」列表页,展示应缴日、预警/逾期标签、关联协议单标识等;对齐标准列表模板与 Fresh Mint 规范。
|
||||
|
||||
#### Scenario: 用户查看逾期列表
|
||||
|
||||
- **WHEN** 用户选择逾期筛选并加载列表
|
||||
- **THEN** 展示的行均为应缴日早于今天的待缴费分期明细
|
||||
+37
@@ -0,0 +1,37 @@
|
||||
## 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** 系统调用审核接口成功后刷新列表或局部更新
|
||||
+33
@@ -0,0 +1,33 @@
|
||||
## 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** 调用后端确认接口成功后该行从待办列表消失或状态更新为已缴费
|
||||
+28
@@ -0,0 +1,28 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 退费确认待办列表
|
||||
|
||||
系统 SHALL 提供分页列表接口,仅返回 `biz_protocol_payment_detail` 中 `pay_status = tfqrz`(退费确认中)且当前租户、`del_flag=0` 的明细。
|
||||
|
||||
#### Scenario: 列表不含非退费确认中状态
|
||||
|
||||
- **WHEN** 请求退费确认列表
|
||||
- **THEN** 每条明细的 `pay_status` SHALL 为 `tfqrz`
|
||||
|
||||
### Requirement: 退费确认动作
|
||||
|
||||
系统 SHALL 提供确认接口,针对单条缴费明细主键:若当前行 `pay_status` 为 `tfqrz`,SHALL 将其更新为 `ytf`(已退费)。若当前行不是 `tfqrz`,SHALL 拒绝。若已为 `ytf`,SHALL 拒绝重复确认。本变更 SHALL NOT 实现「发起退费」或向 `tfqrz` 推进状态的业务接口。
|
||||
|
||||
#### Scenario: 正常确认退费
|
||||
|
||||
- **WHEN** 对 `tfqrz` 明细调用退费确认接口
|
||||
- **THEN** 该明细 `pay_status` 变为 `ytf`
|
||||
|
||||
### Requirement: Web 退费确认页
|
||||
|
||||
Web 管理端 SHALL 提供「退费确认(财务)」列表页与确认操作,对齐标准列表与弹窗规范。
|
||||
|
||||
#### Scenario: 财务完成退费确认
|
||||
|
||||
- **WHEN** 用户对一条退费确认中记录提交确认
|
||||
- **THEN** 调用接口成功后该行不再出现在退费待办列表(或显示为已退费)
|
||||
Reference in new issue
Block a user