用户与组织接口

用户与组织接口用于管理用户、部门和角色。

用户接口

查询用户列表

GET /api/v1/users

参数

参数	类型	说明
page	int	页码
size	int	每页数量
name	string	用户名称（模糊匹配）
departmentId	string	部门ID

响应

{
  "success": true,
  "data": {
    "content": [
      {
        "id": "user001",
        "username": "zhangsan",
        "name": "张三",
        "email": "zhangsan@example.com",
        "departmentId": "dept001",
        "status": "active"
      }
    ]
  }
}

获取用户详情

GET /api/v1/users/{userId}

创建用户

POST /api/v1/users
Content-Type: application/json

{
  "username": "zhangsan",
  "password": "password",
  "name": "张三",
  "email": "zhangsan@example.com",
  "departmentId": "dept001"
}

更新用户

PUT /api/v1/users/{userId}
Content-Type: application/json

{
  "name": "张三（更新）",
  "email": "zhangsan.new@example.com"
}

删除用户

DELETE /api/v1/users/{userId}

重置密码

POST /api/v1/users/{userId}/reset-password
Content-Type: application/json

{
  "password": "new-password"
}

部门接口

查询部门列表

GET /api/v1/departments

获取部门详情

GET /api/v1/departments/{departmentId}

创建部门

POST /api/v1/departments
Content-Type: application/json

{
  "name": "研发部",
  "code": "rd",
  "parentId": null,
  "description": "研发部门"
}

更新部门

PUT /api/v1/departments/{departmentId}
Content-Type: application/json

{
  "name": "研发部（更新）"
}

删除部门

DELETE /api/v1/departments/{departmentId}

角色接口

查询角色列表

GET /api/v1/roles

创建角色

POST /api/v1/roles
Content-Type: application/json

{
  "name": "管理员",
  "code": "admin",
  "permissions": ["form:manage", "flow:manage", "user:manage"]
}

分配角色给用户

POST /api/v1/users/{userId}/roles
Content-Type: application/json

["admin", "user"]

获取用户角色

GET /api/v1/users/{userId}/roles