diet-web-ui/doc/user.md

# 用户部分

# 1. 检查UID的是否重复

> GET /api/user/check?uid=zzz

### 输出:
```
{
  "body": false, // true标识uid未被占用
  "code": 200,
  "desc": "成功",
  "success": true
}
```


# 2. 添加用户

> PUT /api/user

### 输入:
```
Content-Type:application/x-www-form-urlencoded
uid=ccc   // 必填, 用户ID, 不能重复
name=曹   // 必填, 用户姓名
password=BE56E057F20F883E // 必填, MD5加密后大写取后16位，示例原密码为123456
roleId=2 //角色编号,只能是自己单位的角色，必填，从角色列表选择一个
```

### 输出:
```
{
  "code": 200,
  "desc": "成功",
  "success": true
}
```

# 3. 删除用户

> DELETE /api/user

### 输入:
```
Content-Type:application/x-www-form-urlencoded
uid=ccc   // 必填，
```

### 输出:
```
{
  "code": 200,
  "desc": "成功",
  "success": true
}
```

# 4. 修改用户

> POST /api/user

### 输入:
```
Content-Type:application/x-www-form-urlencoded
uid=ccc   // 用户ID, 必填
name=曹   // 修改姓名
password=BE56E057F20F883E // 修改密码
roleId=2 //修改角色, 0-标识回收角色，其他-标识分配角色
```

### 输出:
```
{
  "code": 200,
  "desc": "成功",
  "success": true
}
```


# 5. 获取用户列表

> GET /api/user

### 输出:
```
{
  "body": [
    {
      "name": "业务端测试账号",
      "phone": "13919103409",
      "roleId": 2,
      "roleName": "超级管理员",
      "uid": "xxx",
      "time" 123412341234
    }
  ],
  "code": 200,
  "desc": "成功",
  "success": true
}
```


# 6. 获取当前用户所在端的权限项列表

> GET /api/role/item

### 输出:
```
{
  "body": [
    {
      "category": "基础权限",
      "id": 18,
      "itemName": "使用流程",
      "itemType": "业务端"
    },
    {
      "category": "基础权限",
      "id": 19,
      "itemName": "数据大屏-大屏显示",
      "itemType": "业务端"
    },
    {
      "category": "基础权限",
      "id": 20,
      "itemName": "数据大屏-大屏显示(LED)",
      "itemType": "业务端"
    },
    {
      "category": "配餐设置",
      "id": 21,
      "itemName": "配餐设置-查看",
      "itemType": "业务端"
    },
    {
      "category": "配餐设置",
      "id": 22,
      "itemName": "配餐设置-编辑",
      "itemType": "业务端"
    },
    {
      "category": "食材管理",
      "id": 23,
      "itemName": "食材列表-查看",
      "itemType": "业务端"
    },
    {
      "category": "食材管理",
      "id": 24,
      "itemName": "食材-常用/忌用",
      "itemType": "业务端"
    },
    {
      "category": "菜品管理",
      "id": 25,
      "itemName": "菜品列表-查看",
      "itemType": "业务端"
    },
    {
      "category": "菜品管理",
      "id": 26,
      "itemName": "菜品-新增/编辑/删除",
      "itemType": "业务端"
    },
    {
      "category": "食谱管理",
      "id": 27,
      "itemName": "食谱列表-查看",
      "itemType": "业务端"
    },
    {
      "category": "食谱管理",
      "id": 28,
      "itemName": "食谱-新增/编辑/删除",
      "itemType": "业务端"
    },
    {
      "category": "食谱管理",
      "id": 29,
      "itemName": "食谱审核记录-查看",
      "itemType": "业务端"
    },
    {
      "category": "基础信息管理",
      "id": 30,
      "itemName": "单位基础信息-查看",
      "itemType": "业务端"
    },
    {
      "category": "基础信息管理",
      "id": 31,
      "itemName": "单位基础信息-修改",
      "itemType": "业务端"
    },
    {
      "category": "系统设置",
      "id": 32,
      "itemName": "用户列表-查看",
      "itemType": "业务端"
    },
    {
      "category": "系统设置",
      "id": 33,
      "itemName": "用户-新增/编辑/删除",
      "itemType": "业务端"
    },
    {
      "category": "系统设置",
      "id": 34,
      "itemName": "角色权限-查看/新增/编辑/删除",
      "itemType": "业务端"
    }
  ],
  "code": 200,
  "desc": "成功",
  "success": true
}
```

# 7. 添加角色

> PUT /api/role

### 输入:
```
Content-Type:application/x-www-form-urlencoded
roleName=ccc    // 必填, 角色名称
items=1,2,3   // 赋予的权限项
```

### 输出:
```
{
  "code": 200,
  "desc": "成功",
  "success": true
}
```

# 8. 删除角色

> DELETE /api/role

### 输入:
```
Content-Type:application/x-www-form-urlencoded
roleId=1   // 必填
```

### 输出:
```
{
  "code": 200,
  "desc": "成功",
  "success": true
}
```

# 9. 修改角色

> POST /api/role

### 输入:
```
Content-Type:application/x-www-form-urlencoded
roleId=1        // 必填
roleName=ccc    // 角色名称
items=1,2,3     // 赋予的权限项
```

### 输出:
```
{
  "code": 200,
  "desc": "成功",
  "success": true
}
```


# 10. 获取角色列表

> GET /api/role

### 输出:
```
{
  "body": [
    {
      "id": 2,
      "roleItems": [18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34],
      "roleName": "超级管理员",
      "roleType": "系统",
      "vender": 1
    }
  ],
  "code": 200,
  "desc": "成功",
  "success": true
}
```