# User Management Specification

## Purpose

定义用户管理页面的行为：按条件分页查询用户列表，支持新增、编辑、删除与重置密码，并展示用户状态。

## Requirements

### Requirement: 用户分页查询
系统 SHALL 在用户管理页按「用户名/昵称/手机/状态」条件分页查询用户列表，展示用户名、昵称、邮箱、手机、状态、所属组织与创建时间。

#### Scenario: 条件查询
- **WHEN** 用户输入用户名/昵称/手机或选择状态并点击查询
- **THEN** 表格按条件过滤并展示分页结果

#### Scenario: 分页
- **WHEN** 用户切换页码或每页条数
- **THEN** 表格展示对应页数据

### Requirement: 新增用户
系统 SHALL 支持新增用户：填写用户名、昵称、邮箱、手机、状态、所属组织与初始密码。

#### Scenario: 新增
- **WHEN** 用户点击新增并填写必填项（用户名、密码）后提交
- **THEN** 系统新增该用户并刷新列表

### Requirement: 编辑用户
系统 SHALL 支持编辑用户基本信息（昵称/邮箱/手机/状态/组织），用户名不可改。

#### Scenario: 编辑
- **WHEN** 用户编辑某用户并提交
- **THEN** 系统更新该用户并刷新列表

### Requirement: 重置密码
系统 SHALL 支持对某用户重置密码（填写新密码）。

#### Scenario: 重置密码
- **WHEN** 用户对某用户执行重置密码并填写新密码
- **THEN** 系统更新该用户密码

### Requirement: 删除用户
系统 SHALL 支持删除用户，删除前需确认。

#### Scenario: 删除确认
- **WHEN** 用户点击删除并确认
- **THEN** 系统删除该用户并刷新列表

### Requirement: 状态展示
用户状态 SHALL 以标签形式区分展示：启用 / 停用 / 锁定。

#### Scenario: 状态标签
- **WHEN** 列表展示用户
- **THEN** 状态以不同颜色的标签区分（启用=成功色、停用=信息色、锁定=危险色）

### Requirement: 字段对齐后端
占位用户数据 SHALL 采用后端 `user` 实体字段（`id/tenantCode/username/nickname/email/phone/status/orgCode/createdAt` 等），不自造字段名。

#### Scenario: 后续接后端
- **WHEN** 占位数据替换为后端用户接口
- **THEN** 页面无需改动数据结构即可直接渲染

### Requirement: 锁定/解锁操作
用户管理页 SHALL 支持对用户执行锁定（可填原因）与解锁操作；锁定/解锁后刷新列表并提示结果。

#### Scenario: 锁定用户
- **WHEN** 管理员对某启用用户执行锁定并（可选）填写原因
- **THEN** 系统锁定该用户并刷新列表，状态显示为锁定

#### Scenario: 解锁用户
- **WHEN** 管理员对某锁定用户执行解锁
- **THEN** 系统解锁该用户并刷新列表

### Requirement: 创建用户指定强制改密
新增用户表单 SHALL 提供「首登强制改密」配置项（默认勾选）；提交时将其作为 mustChangePassword 传入。

#### Scenario: 默认强制改密
- **WHEN** 管理员新增用户保持「首登强制改密」勾选并提交
- **THEN** 创建的该用户 mustChangePassword=true

#### Scenario: 关闭强制改密
- **WHEN** 管理员新增用户取消勾选「首登强制改密」
- **THEN** 创建的该用户 mustChangePassword=false