admin/apps/wisdom-legacy/openApi/system/addUser.openapi.json

{
  "openapi": "3.1.0",
  "info": {
    "title": "系统管理",
    "description": "系统管理—相关接口文档",
    "version": "1.0-SNAPSHOT"
  },
  "paths": {
    "/user": {
      "post": {
        "tags": ["用户管理API"],
        "summary": "新增用户",
        "operationId": "add",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SysUser"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/AjaxResult"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "SysUser": {
        "type": "object",
        "properties": {
          "createIdBy": {
            "type": "integer",
            "format": "int64"
          },
          "createBy": {
            "type": "string"
          },
          "createTime": {
            "type": "string",
            "format": "date-time"
          },
          "updateIdBy": {
            "type": "integer",
            "format": "int64"
          },
          "updateBy": {
            "type": "string"
          },
          "updateTime": {
            "type": "string",
            "format": "date-time"
          },
          "remark": {
            "type": "string"
          },
          "params": {
            "type": "object",
            "additionalProperties": {}
          },
          "userId": {
            "type": "integer",
            "format": "int64",
            "description": "用户ID"
          },
          "deptId": {
            "type": "integer",
            "format": "int64",
            "description": "部门ID"
          },
          "userName": {
            "type": "string",
            "description": "用户账号",
            "maxLength": 30,
            "minLength": 0
          },
          "nickName": {
            "type": "string",
            "description": "用户昵称",
            "maxLength": 30,
            "minLength": 0
          },
          "userType": {
            "type": "string",
            "description": "用户类型（00系统用户）"
          },
          "email": {
            "type": "string",
            "format": "email",
            "description": "用户邮箱",
            "maxLength": 50,
            "minLength": 0
          },
          "phonenumber": {
            "type": "string",
            "description": "手机号码",
            "maxLength": 11,
            "minLength": 0
          },
          "jobnumber": {
            "type": "string",
            "description": "工号",
            "maxLength": 50,
            "minLength": 0
          },
          "sex": {
            "type": "string",
            "description": "用户性别，0=男,1=女,2=未知"
          },
          "avatar": {
            "type": "string",
            "description": "用户头像"
          },
          "appletImg": {
            "type": "string",
            "description": "小程序码"
          },
          "password": {
            "type": "string",
            "description": "密码"
          },
          "status": {
            "type": "string",
            "description": "帐号状态（0正常 1停用）"
          },
          "delFlag": {
            "type": "string",
            "description": "删除标志（0代表存在 2代表删除）"
          },
          "loginIp": {
            "type": "string",
            "description": "最后登录IP"
          },
          "loginDate": {
            "type": "string",
            "format": "date-time",
            "description": "最后登录时间"
          },
          "dept": {
            "$ref": "#/components/schemas/DeptInfo",
            "description": "部门对象"
          },
          "roles": {
            "type": "array",
            "description": "角色对象",
            "items": {
              "$ref": "#/components/schemas/SysRole"
            }
          },
          "roleIds": {
            "type": "array",
            "description": "角色组",
            "items": {
              "type": "integer",
              "format": "int64"
            }
          },
          "roleId": {
            "type": "integer",
            "format": "int64",
            "description": "角色ID"
          }
        },
        "required": ["userName"]
      },
      "DeptInfo": {
        "type": "object",
        "properties": {
          "deptId": {
            "type": "integer",
            "format": "int64",
            "description": "部门ID"
          },
          "parentId": {
            "type": "integer",
            "format": "int64",
            "description": "父部门ID"
          },
          "ancestors": {
            "type": "string",
            "description": "祖级列表"
          },
          "deptName": {
            "type": "string",
            "description": "部门名称",
            "maxLength": 30,
            "minLength": 0
          },
          "deptFullPathName": {
            "type": "string",
            "description": "部门名称（包含祖部门）"
          },
          "orderNum": {
            "type": "integer",
            "format": "int32",
            "description": "显示顺序"
          },
          "leader": {
            "type": "string",
            "description": "负责人"
          },
          "phone": {
            "type": "string",
            "description": "联系电话",
            "maxLength": 11,
            "minLength": 0
          },
          "email": {
            "type": "string",
            "format": "email",
            "description": "邮箱",
            "maxLength": 50,
            "minLength": 0
          },
          "status": {
            "type": "string",
            "description": "状态标志（详见字典：系统开关）",
            "minLength": 1,
            "pattern": "^[01]$"
          },
          "delFlag": {
            "type": "string",
            "description": "删除标志（详见字典：删除标志）"
          },
          "createIdBy": {
            "type": "integer",
            "format": "int64",
            "description": "创建者ID"
          },
          "createBy": {
            "type": "string",
            "description": "创建者"
          },
          "createTime": {
            "type": "string",
            "format": "date-time",
            "description": "创建时间"
          },
          "updateIdBy": {
            "type": "integer",
            "format": "int64",
            "description": "更新者ID"
          },
          "updateBy": {
            "type": "string",
            "description": "更新者"
          },
          "updateTime": {
            "type": "string",
            "format": "date-time",
            "description": "更新时间"
          },
          "remark": {
            "type": "string",
            "description": "备注"
          },
          "parentName": {
            "type": "string",
            "description": "父部门名称"
          },
          "children": {
            "type": "array",
            "description": "子部门",
            "items": {
              "$ref": "#/components/schemas/DeptInfo"
            }
          }
        },
        "required": ["deptName", "orderNum", "parentId", "status"]
      },
      "SysRole": {
        "type": "object",
        "description": "角色对象",
        "properties": {
          "createIdBy": {
            "type": "integer",
            "format": "int64"
          },
          "createBy": {
            "type": "string"
          },
          "createTime": {
            "type": "string",
            "format": "date-time"
          },
          "updateIdBy": {
            "type": "integer",
            "format": "int64"
          },
          "updateBy": {
            "type": "string"
          },
          "updateTime": {
            "type": "string",
            "format": "date-time"
          },
          "remark": {
            "type": "string"
          },
          "params": {
            "type": "object",
            "additionalProperties": {}
          },
          "roleId": {
            "type": "integer",
            "format": "int64",
            "description": "角色ID"
          },
          "roleName": {
            "type": "string",
            "description": "角色名称",
            "maxLength": 30,
            "minLength": 0
          },
          "roleKey": {
            "type": "string",
            "description": "角色权限",
            "maxLength": 100,
            "minLength": 0
          },
          "roleSort": {
            "type": "integer",
            "format": "int32",
            "description": "角色排序"
          },
          "dataScope": {
            "type": "string",
            "description": "数据范围（1：所有数据权限；2：自定义数据权限；3：本部门数据权限；4：本部门及以下数据权限；5：仅本人数据权限）"
          },
          "menuCheckStrictly": {
            "type": "boolean",
            "description": "菜单树选择项是否关联显示（ 0：父子不互相关联显示 1：父子互相关联显示）"
          },
          "deptCheckStrictly": {
            "type": "boolean",
            "description": "部门树选择项是否关联显示（0：父子不互相关联显示 1：父子互相关联显示 ）"
          },
          "status": {
            "type": "string",
            "description": "角色状态（0正常 1停用）"
          },
          "delFlag": {
            "type": "string",
            "description": "删除标志（0代表存在 2代表删除）"
          },
          "flag": {
            "type": "boolean",
            "description": "用户是否存在此角色标识 默认不存在"
          },
          "menuIds": {
            "type": "array",
            "description": "菜单组",
            "items": {
              "type": "integer",
              "format": "int64"
            }
          },
          "deptIds": {
            "type": "array",
            "description": "部门组（数据权限）",
            "items": {
              "type": "integer",
              "format": "int64"
            }
          },
          "permissions": {
            "type": "array",
            "description": "角色菜单权限",
            "items": {
              "type": "string"
            },
            "uniqueItems": true
          }
        },
        "required": ["roleName"]
      },
      "AjaxResult": {
        "type": "object",
        "description": "接口返回对象",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32",
            "description": "状态码"
          },
          "msg": {
            "type": "string",
            "description": "提示语"
          },
          "data": {
            "description": "数据对象"
          }
        }
      }
    }
  }
}