部门选择与账户信息接口文档

1. 文档说明

本文档描述部门选择与账户信息相关接口的新增和改造内容，仅包含本次需求涉及变更的接口。

2. 接口列表

接口路径	方法	格式	说明	变更类型
/auth/login	POST	JSON	用户登录	改造
/auth/user-info	GET	-	获取当前登录用户信息	改造
/auth/select-dept	POST	JSON	选择部门	新增
/auth/switch-dept	POST	JSON	切换部门	新增
/auth/dept-list	GET	-	获取用户部门列表	新增
/auth/account-info	GET	-	获取用户账户信息	新增
/auth/update-info	POST	JSON	修改用户账户信息	新增

3. 接口详细设计

3.1 用户登录（改造）

接口路径：POST /auth/login

请求格式：RAW(JSON)

是否认证：否

请求参数：无变化

响应参数变更：

字段名	类型	说明	变更
avatarKey	String	头像存储Key	新增
needSelectDept	Boolean	是否需要选择部门	新增
currentDeptId	Long	当前部门ID	新增
currentDeptName	String	当前部门名称	新增

响应示例：

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": 1,
    "username": "admin",
    "nickName": "管理员",
    "phone": "13800138000",
    "email": "admin@example.com",
    "avatarKey": "avatar/1.png",
    "tenantType": 0,
    "tenantId": 1,
    "lastLoginTime": "2026-04-28 10:00:00",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "needSelectDept": true,
    "currentDeptId": null,
    "currentDeptName": null
  }
}

3.2 获取当前登录用户信息（改造）

接口路径：GET /auth/user-info

请求格式：无

是否认证：是

请求参数：无

响应参数变更：同登录接口

响应示例：

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": 1,
    "username": "admin",
    "nickName": "管理员",
    "phone": "13800138000",
    "email": "admin@example.com",
    "avatarKey": "avatar/1.png",
    "tenantType": 0,
    "tenantId": 1,
    "lastLoginTime": "2026-04-28 10:00:00",
    "token": null,
    "needSelectDept": false,
    "currentDeptId": 10,
    "currentDeptName": "技术部"
  }
}

3.3 选择部门（新增）

接口路径：POST /auth/select-dept

请求格式：RAW(JSON)

是否认证：是

使用场景：登录后 needSelectDept 为 true 时需要选择部门

请求参数：

字段名	类型	必填	说明
deptId	Long	是	部门ID

请求示例：

{
  "deptId": 10
}

响应参数：

字段名	类型	说明
deptId	Long	部门ID
deptName	String	部门名称

响应示例：

{
  "code": 200,
  "msg": "success",
  "data": {
    "deptId": 10,
    "deptName": "技术部"
  }
}

3.4 切换部门（新增）

接口路径：POST /auth/switch-dept

请求格式：RAW(JSON)

是否认证：是

使用场景：用户在系统右上角点击切换部门时调用

请求参数：

字段名	类型	必填	说明
deptId	Long	是	部门ID

请求示例：

{
  "deptId": 20
}

响应参数：

字段名	类型	说明
deptId	Long	部门ID
deptName	String	部门名称

响应示例：

{
  "code": 200,
  "msg": "success",
  "data": {
    "deptId": 20,
    "deptName": "运营部"
  }
}

3.5 获取用户部门列表（新增）

接口路径：GET /auth/dept-list

请求格式：无

是否认证：是

使用场景：前端需要展示部门列表时调用（登录后选择部门弹窗、切换部门弹窗）

请求参数：无

响应参数：

字段名	类型	说明
currentDeptId	Long	当前部门ID
currentDeptName	String	当前部门名称
deptList	List	用户所属部门列表

deptList 元素结构：

字段名	类型	说明
id	Long	部门ID
name	String	部门名称

响应示例：

{
  "code": 200,
  "msg": "success",
  "data": {
    "currentDeptId": 10,
    "currentDeptName": "技术部",
    "deptList": [
      {
        "id": 10,
        "name": "技术部"
      },
      {
        "id": 20,
        "name": "运营部"
      },
      {
        "id": 30,
        "name": "市场部"
      }
    ]
  }
}

3.6 获取用户账户信息（新增）

接口路径：GET /auth/account-info

请求格式：无

是否认证：是

使用场景：用户点击右上角头像查看账户信息

请求参数：无

响应参数：

字段名	类型	说明
id	Long	用户ID
username	String	账号（不可修改）
nickName	String	姓名
avatarKey	String	头像存储Key（不可修改）
email	String	电子邮箱
phone	String	手机号码
deptNames	String	所属部门名称，多个用顿号分隔（不可修改）
roleNames	String	角色名称，多个用逗号分隔（不可修改）
status	Integer	状态(0:禁用、1:启用)
createTime	String	创建时间
lastLoginTime	String	最后登录时间

响应示例：

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": 1,
    "username": "admin",
    "nickName": "管理员",
    "avatarKey": "avatar/1.png",
    "email": "admin@example.com",
    "phone": "13800138000",
    "deptNames": "技术部、运营部",
    "roleNames": "超级管理员,系统管理员",
    "status": 1,
    "createTime": "2026-01-01 00:00:00",
    "lastLoginTime": "2026-04-28 10:00:00"
  }
}

3.7 修改用户账户信息（新增）

接口路径：POST /auth/update-info

请求格式：RAW(JSON)

是否认证：是

请求参数：

字段名	类型	必填	说明
nickName	String	是	姓名（最长20字符，仅支持中文和英文）
email	String	否	电子邮箱（最长50字符）
phone	String	是	手机号码（11位，格式校验）

请求示例：

{
  "nickName": "新姓名",
  "email": "newemail@example.com",
  "phone": "13900139000"
}

响应示例：

{
  "code": 200,
  "msg": "success",
  "data": null
}

4. 错误码说明

错误信息	说明
请选择部门	部门ID为空
您不属于该部门，无法选择	用户不在所选部门中
姓名不能为空	姓名为空
姓名长度不能超过20位	姓名超长
手机号不能为空	手机号为空
手机号格式不正确	手机号格式错误
邮箱长度不能超过50位	邮箱超长
邮箱格式不正确	邮箱格式错误

部门选择与账户信息接口文档

1. 文档说明#

2. 接口列表#

3. 接口详细设计#

3.1 用户登录（改造）#

3.2 获取当前登录用户信息（改造）#

3.3 选择部门（新增）#

3.4 切换部门（新增）#

3.5 获取用户部门列表（新增）#

3.6 获取用户账户信息（新增）#

3.7 修改用户账户信息（新增）#

4. 错误码说明#

1. 文档说明

2. 接口列表

3. 接口详细设计

3.1 用户登录（改造）

3.2 获取当前登录用户信息（改造）

3.3 选择部门（新增）

3.4 切换部门（新增）

3.5 获取用户部门列表（新增）

3.6 获取用户账户信息（新增）

3.7 修改用户账户信息（新增）

4. 错误码说明