diet/doc/menu/dish.md

# 1. 查询食谱菜品列表

> GET /api/menu/dish

### 输入:
```text
menuId=1   // 食谱编号
```

### 输出:
~~~json
{
  "body": [
    {
      "day": 1,
      "dish": 1,
      "id": 1,
      "ingredient": [
        {
          "isMain": true,
          "key": "011101",
          "value": {
            "轻体力": 500,
            "重体力": 300
          }
        },
        {
          "isMain": false,
          "key": "2101001",
          "value": {
            "轻体力": 500,
            "重体力": 300
          }
        }
      ],
      "marks": "主食",
      "meal": "早餐",
      "menu": 1,
      "name": "番茄炒蛋",
      "vender": 1
    },
    {
      "day": 1,
      "dish": 2,
      "id": 3,
      "ingredient": [
        {
          "isMain": true,
          "key": "011101",
          "value": {
            "轻体力": 500,
            "重体力": 300
          }
        }
      ],
      "marks": "主食",
      "meal": "早餐",
      "menu": 1,
      "name": "番茄炒鸡蛋",
      "vender": 1
    }
  ],
  "code": 200,
  "desc": "成功",
  "success": true
}
~~~

# 2. 查询今日带量菜品(大屏显示)

> GET /api/menu/dish

### 输出:
~~~json
{
  "body": [
    {
      "day": 1,
      "dish": 1,
      "id": 1,
      "ingredient": [
        {
          "isMain": true,
          "key": "011101",
          "value": {
            "轻体力": 500,
            "重体力": 300
          }
        },
        {
          "isMain": false,
          "key": "2101001",
          "value": {
            "轻体力": 500,
            "重体力": 300
          }
        }
      ],
      "marks": "主食",
      "meal": "早餐",
      "menu": 1,
      "name": "番茄炒蛋",
      "vender": 1
    },
    {
      "day": 1,
      "dish": 2,
      "id": 3,
      "ingredient": [
        {
          "isMain": true,
          "key": "011101",
          "value": {
            "轻体力": 500,
            "重体力": 300
          }
        }
      ],
      "marks": "主食",
      "meal": "早餐",
      "menu": 1,
      "name": "番茄炒鸡蛋",
      "vender": 1
    }
  ],
  "code": 200,
  "desc": "成功",
  "success": true
}
~~~

# 3. 向食谱添加菜品


> PUT /api/menu/dish

### 输入:
```text
menuId=1        // 食谱编号
dishId=1        // 菜品ID
day=1           // 属于那一天
meal=早餐        // 属于那个餐次
mark=打标        // 支持打和菜品上不一样的标
ingredient=[{"isMain":true,"key":"011101","value":{"轻体力":500,"重体力":300}}]
                // 菜品成分, Map<人群, List<(食材,用量,是否主料)>>
```

### 输出:
~~~json
{
  "body": 1, // 食谱菜品的编号
  "code": 200,
  "desc": "成功",
  "success": true
}
~~~

# 4. 修改食谱菜品


> POST /api/menu/dish

### 输入:
```text
menuId=1        // 食谱编号
menuDishId=1    // 食谱上的菜品ID
mark=打标        // 支持打和菜品上不一样的标
ingredient=[{"isMain":true,"key":"011101","value":{"轻体力":500,"重体力":300}}]
                // 菜品成分
```

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

# 5. 删除食谱上的菜品


> DELETE /api/menu/dish

### 输入:
```text
menuId=1        // 食谱ID
menuDishId=1    // 食谱上的菜品编号, 传了删这个菜品, 不传则清空这个食谱上的所有菜品
```

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

# 6. 批量向食谱添加菜品


> PUT /api/menu/dish/batch

### 输入:
```json
{
    "menuIds" : [1,2,3],
    "dishes" : [
        {
            "dish": 1,
            "day" : 1,
            "meal": "早餐",
            "mark": "主食",
            "items" : [{
                "key" : "011101",
                "isMain": true,
                "value" : {
                    "重体力": 13.56,
                    "轻体力": 13.56
                }
            }]
        }
    ]
}
```

### 输出:
~~~json
{
  "body": [
     1,2,3
  ],
  "code": 200,
  "desc": "成功",
  "success": true
}
~~~

# 7. 导出食谱


> GET /api/menu/dish/export

### 输入:
```text
id=1 // 食谱ID
```

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

# 8. 食谱分析


> GET /api/menu/dish/analysis

### 输入:
```text
id=1      // 食谱ID, 必填
day=3     // 那一天, 默认当天 
crow=xxx  //人群,默认第一个人群
```

### 输出:
~~~json
{
  "body": {
    "day": 5,
    "crow": "10",
    "meals": [
      "早餐"
    ],
    "types": {
      "蛋类": 5,
      "鱼虾类": 2,
      "调味品": 1
    },
    "ingredient": [
      {
        "nutrition": "膳食纤维/g",
        "virtual": 0,
        "standard": "1~2",
        "ul": "-",
        "overload": -1,
        "conclusion": "不足"
      },
      {
        "nutrition": "钙/mg",
        "virtual": 2,
        "standard": "-",
        "ul": "-",
        "overload": "-",
        "conclusion": "-"
      },
      {
        "nutrition": "维生素B1/mg",
        "virtual": 1,
        "standard": "-",
        "ul": "-",
        "overload": "-",
        "conclusion": "-"
      },
      {
        "nutrition": "碳水化合物/g",
        "virtual": 0.1,
        "standard": "-",
        "ul": "-",
        "overload": "-",
        "conclusion": "-"
      },
      {
        "nutrition": "蛋白质/g",
        "virtual": 0.1,
        "standard": "-",
        "ul": "-",
        "overload": "-",
        "conclusion": "-"
      },
      {
        "nutrition": "维生素B2/mg",
        "virtual": 2,
        "standard": "-",
        "ul": "-",
        "overload": "-",
        "conclusion": "-"
      },
      {
        "nutrition": "脂肪/g",
        "virtual": 0.0,
        "standard": "-",
        "ul": "-",
        "overload": "-",
        "conclusion": "-"
      },
      {
        "nutrition": "铁/mg",
        "virtual": 0.1,
        "standard": "-",
        "ul": "-",
        "overload": "-",
        "conclusion": "-"
      },
      {
        "nutrition": "维生素A/μgRAE",
        "virtual": 4,
        "standard": "-",
        "ul": "-",
        "overload": "-",
        "conclusion": "-"
      },
      {
        "nutrition": "能量kcal/kcal",
        "virtual": 0.79,
        "standard": "-",
        "ul": "-",
        "overload": "-",
        "conclusion": "-"
      }
    ]
  },
  "code": 200,
  "desc": "成功",
  "success": true
}
~~~


# 9. 食谱分析

> GET /api/menu/dish/analysis/energy

### 输入:
```text
id=1      // 食谱ID, 必填
day=3     // 那一天, 默认当天 
crow=xxx  //人群,默认第一个人群
```

### 输出:
~~~json
{
  "body": {
    "day": 5,
    "crow": "10",
    "meals": [
      "早餐"
    ],
    "energy": [
      {
        "name": "蛋白质/总能量",
        "standard": "10~20",
        "value": 10.0,
        "conclusion": "合适"
      },
      {
        "name": "脂肪/总能量",
        "standard": "20~30",
        "value": 0.0,
        "conclusion": "略低"
      },
      {
        "name": "碳水化合物/总能量",
        "standard": "50~60",
        "value": 10.0,
        "conclusion": "略低"
      }
    ]
  },
  "code": 200,
  "desc": "成功",
  "success": true
}
~~~

# 10. 食谱分析

> GET /api/menu/dish/analysis/types

### 输入:
```text
id=1      // 食谱ID, 必填
crow=xxx  //人群,默认第一个人群
```

### 输出:
~~~json
{
  "body": {
    "dayRule": [
      [
        {
          "day": 1,
          "name": "蛋类",
          "standard": 0,
          "supplied": 5,
          "lack": 0
        },
        {
          "day": 1,
          "name": "鱼虾类",
          "standard": 0,
          "supplied": 2,
          "lack": 0
        },
        {
          "day": 1,
          "name": "调味品",
          "standard": 0,
          "supplied": 1,
          "lack": 0
        }
      ],
      [
        {
          "day": 2,
          "name": "蛋类",
          "standard": 0,
          "supplied": 5,
          "lack": 0
        },
        {
          "day": 2,
          "name": "鱼虾类",
          "standard": 0,
          "supplied": 2,
          "lack": 0
        },
        {
          "day": 2,
          "name": "调味品",
          "standard": 0,
          "supplied": 1,
          "lack": 0
        }
      ],
      [
        {
          "day": 3,
          "name": "蛋类",
          "standard": 0,
          "supplied": 5,
          "lack": 0
        },
        {
          "day": 3,
          "name": "鱼虾类",
          "standard": 0,
          "supplied": 2,
          "lack": 0
        },
        {
          "day": 3,
          "name": "调味品",
          "standard": 0,
          "supplied": 1,
          "lack": 0
        }
      ],
      [
        {
          "day": 4,
          "name": "鱼虾类",
          "standard": 0,
          "supplied": 2,
          "lack": 0
        },
        {
          "day": 4,
          "name": "蛋类",
          "standard": 0,
          "supplied": 5,
          "lack": 0
        },
        {
          "day": 4,
          "name": "调味品",
          "standard": 0,
          "supplied": 1,
          "lack": 0
        }
      ],
      [
        {
          "day": 5,
          "name": "鱼虾类",
          "standard": 0,
          "supplied": 2,
          "lack": 0
        },
        {
          "day": 5,
          "name": "蛋类",
          "standard": 0,
          "supplied": 5,
          "lack": 0
        },
        {
          "day": 5,
          "name": "调味品",
          "standard": 0,
          "supplied": 1,
          "lack": 0
        }
      ],
      [
        {
          "day": 6,
          "name": "鱼虾类",
          "standard": 0,
          "supplied": 2,
          "lack": 0
        },
        {
          "day": 6,
          "name": "蛋类",
          "standard": 0,
          "supplied": 5,
          "lack": 0
        },
        {
          "day": 6,
          "name": "调味品",
          "standard": 0,
          "supplied": 1,
          "lack": 0
        }
      ],
      [
        {
          "day": 7,
          "name": "鱼虾类",
          "standard": 0,
          "supplied": 2,
          "lack": 0
        },
        {
          "day": 7,
          "name": "蛋类",
          "standard": 0,
          "supplied": 5,
          "lack": 0
        },
        {
          "day": 7,
          "name": "调味品",
          "standard": 0,
          "supplied": 1,
          "lack": 0
        }
      ]
    ],
    "weekRule": [
      {
        "name": "蛋类",
        "standard": 0,
        "supplied": 35,
        "lack": 0
      },
      {
        "name": "鱼虾类",
        "standard": 0,
        "supplied": 14,
        "lack": 0
      },
      {
        "name": "调味品",
        "standard": 0,
        "supplied": 7,
        "lack": 0
      }
    ]
  },
  "code": 200,
  "desc": "成功",
  "success": true
}
~~~