System_Management/openspec/specs/frontend/AD/user/spec.md

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