# 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** 该用户下次请求按新角色聚合权限

### Requirement: 账号锁定
系统 SHALL 支持管理员锁定用户（可附原因）；锁定后该用户无法登录，且其全部活跃会话被吊销。

#### Scenario: 锁定用户
- **WHEN** 管理员锁定某用户
- **THEN** 系统记录锁定时间与原因，吊销该用户全部会话，该用户后续登录被拒绝

### Requirement: 账号解锁
系统 SHALL 支持管理员解锁用户；解锁后清空锁定时间与原因，并清除该用户的登录失败计数。

#### Scenario: 解锁用户
- **WHEN** 管理员解锁某锁定用户
- **THEN** 系统清空锁定状态与登录失败计数，该用户恢复登录能力（若 status 为启用）