36 lines
1.3 KiB
Markdown
36 lines
1.3 KiB
Markdown
# Users Specification
|
|
|
|
## Purpose
|
|
|
|
定义用户域的行为：分页查询（含数据权限过滤）、新增/编辑/删除（软删回收唯一键）、重置密码、分配角色，以及会话吊销。
|
|
|
|
## Requirements
|
|
|
|
### Requirement: 用户分页查询
|
|
系统 SHALL 支持按用户名/昵称/手机/状态分页查询用户；查询按数据权限过滤（仅本人/本部门/本部门及以下/自定义）。
|
|
|
|
#### Scenario: 部门管理员查看用户
|
|
- **WHEN** 数据权限为「本部门」的管理员查询用户列表
|
|
- **THEN** 仅返回本部门用户
|
|
|
|
### Requirement: 用户增删改
|
|
系统 SHALL 支持新增/编辑用户；删除为软删并回收用户名唯一键（可重建同名）。
|
|
|
|
#### Scenario: 软删重建
|
|
- **WHEN** 删除某用户后再创建同名用户
|
|
- **THEN** 创建成功
|
|
|
|
### Requirement: 重置密码
|
|
系统 SHALL 支持管理员重置用户密码；重置后吊销该用户所有会话（旧 token 失效）。
|
|
|
|
#### Scenario: 重置后踢下线
|
|
- **WHEN** 管理员重置某用户密码
|
|
- **THEN** 该用户旧 access/refresh token 立即失效
|
|
|
|
### Requirement: 分配角色
|
|
系统 SHALL 支持为用户分配角色（整体替换），分配后清该用户权限缓存。
|
|
|
|
#### Scenario: 分配角色
|
|
- **WHEN** 管理员为用户分配角色
|
|
- **THEN** 该用户下次请求按新角色聚合权限
|