73 lines
3.6 KiB
Markdown
73 lines
3.6 KiB
Markdown
## ADDED Requirements
|
|
|
|
### Requirement: 字典类型分页列表
|
|
系统 SHALL 提供字典类型分页列表查询接口，支持按关键词（dict_name 或 dict_type 模糊匹配）搜索，默认排序 order_num ASC, create_time DESC，严格按当前用户 tenant_no 过滤。
|
|
|
|
#### Scenario: 查询字典类型列表
|
|
- **WHEN** 用户请求 `GET /api/web/admin/dict-types`，携带 page=1, pageSize=10, keyword="bm"
|
|
- **THEN** 返回当前租户下 dict_name 或 dict_type 包含 "bm" 的字典类型列表，按 order_num 升序、create_time 降序
|
|
|
|
#### Scenario: 无关键词查询
|
|
- **WHEN** 用户请求字典类型列表，不传 keyword
|
|
- **THEN** 返回当前租户下所有字典类型，分页展示
|
|
|
|
### Requirement: 字典类型新增
|
|
系统 SHALL 提供字典类型新增接口，必须校验同一 tenant_no 下 dict_type 的唯一性（排除 del_flag=1），自动填充 tenant_no、create_by、create_dept_id。
|
|
|
|
#### Scenario: 新增字典类型成功
|
|
- **WHEN** 用户提交 dict_name="部门状态"、dict_type="bmzt"
|
|
- **THEN** 创建成功，返回新记录，dict_type 在当前租户内唯一
|
|
|
|
#### Scenario: dict_type 重复
|
|
- **WHEN** 用户提交已存在的 dict_type（且未被软删除）
|
|
- **THEN** 返回错误，提示"字典类型编码已存在"
|
|
|
|
### Requirement: 字典类型修改
|
|
系统 SHALL 提供字典类型修改接口，允许修改 dict_name、dict_type、order_num、remark、status。修改 dict_type 时 SHALL 校验新编码在同一 tenant_no 下的唯一性。
|
|
|
|
#### Scenario: 修改字典类型名称
|
|
- **WHEN** 用户修改 dict_name 从"旧名称"为"新名称"
|
|
- **THEN** 更新成功，update_by 自动设置为当前用户
|
|
|
|
### Requirement: 字典类型软删除
|
|
系统 SHALL 提供字典类型软删除接口，将 del_flag 设为 1。删除字典类型时 SHALL 同时软删除该类型下所有字典数据。
|
|
|
|
#### Scenario: 删除字典类型
|
|
- **WHEN** 用户删除一个字典类型
|
|
- **THEN** 该类型 del_flag=1，其下所有 dict_data 的 del_flag 也设为 1
|
|
|
|
### Requirement: 字典数据分页列表
|
|
系统 SHALL 提供字典数据分页列表查询接口，按 dict_type 过滤，支持按 dict_label 搜索，默认排序 order_num ASC, create_time DESC，严格按当前用户 tenant_no 过滤。
|
|
|
|
#### Scenario: 按字典类型查询数据
|
|
- **WHEN** 用户请求 `GET /api/web/admin/dict-data`，携带 dictType="bmzt"
|
|
- **THEN** 返回该类型下所有字典数据列表
|
|
|
|
### Requirement: 字典数据新增
|
|
系统 SHALL 提供字典数据新增接口，自动继承字典类型的 tenant_no，自动填充 create_by、create_dept_id。
|
|
|
|
#### Scenario: 新增字典数据
|
|
- **WHEN** 用户为 dict_type="bmzt" 新增 dict_label="正常"、dict_value="1"
|
|
- **THEN** 创建成功，tenant_no 与字典类型一致
|
|
|
|
### Requirement: 字典数据修改
|
|
系统 SHALL 提供字典数据修改接口，允许修改 dict_label、dict_value、order_num、remark。
|
|
|
|
#### Scenario: 修改字典数据
|
|
- **WHEN** 用户修改某条字典数据的 dict_label
|
|
- **THEN** 更新成功，update_by 自动设置
|
|
|
|
### Requirement: 字典数据软删除
|
|
系统 SHALL 提供字典数据软删除接口，将 del_flag 设为 1。
|
|
|
|
#### Scenario: 删除字典数据
|
|
- **WHEN** 用户删除一条字典数据
|
|
- **THEN** 该条数据 del_flag=1，不再出现在列表查询中
|
|
|
|
### Requirement: 字典数据下拉查询
|
|
系统 SHALL 提供按 dict_type 查询有效字典数据的轻量接口（不分页），用于其他模块的下拉选项。
|
|
|
|
#### Scenario: 下拉查询
|
|
- **WHEN** 前端请求 `GET /api/web/admin/dict-data/options?dictType=bmzt`
|
|
- **THEN** 返回该类型下所有有效字典数据的 label+value 列表，用于下拉选项渲染
|