restaurant/DishMatch
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(food-prepare): 增加食材信息录入卡及相关接口支持

Browse Source 
- 新增手动录入食材信息的UI布局，包含食材名称搜索、主辅材选择及用量输入
- 整合采样模式下的食材搜索弹窗，支持食材模糊查询与净材种类选择
- 新增相关网络接口调用，实现食材搜索、菜品搜索、菜品构成查询及采样历史等功能
- 优化食材列表展示，支持采样历史审核状态和熟重显示，增加颜色区分
- 修改PrepareFoodActivity，采样模式启用手动新增食材功能，包含添加、重置操作
- 调整Adapter和ViewModel，兼容新接口数据模型，支持分页加载和状态回调
- 修正接口路径和网络请求地址，统一使用nutrition/neglect路径前缀
- 删除冗余代码和未使用的旧接口代码，简化搜索逻辑及界面响应机制
This commit is contained in:
mazengfei
2026-09-10 13:41:35 +08:00
parent 45543295e3
commit 6d3c5490a4
20 changed files with 1755 additions and 299 deletions
Download Patch File Download Diff File Expand all files Collapse all files
配比秤-制作菜品-API文档.md
+75 -98
View File
@@ -15,20 +15,19 @@
## 业务背景
配比秤是一款独立于现有组配秤（`/neglect` 路径）的新硬件设备，部署在食堂后厨。第一期实现"按单烹制"功能：厨师在配比秤终端上查看当日烹饪任务 → 查看菜品食材构成 → 提交食材实际用量并触发组配完成 → 开始烹制 → 烹饪完成后提交熟重和调料用量。
配比秤是一款独立于现有组配秤（`/neglect` 路径）的新硬件设备，部署在食堂后厨。第一期实现"按单烹制"功能：厨师在配比秤终端上查看当日烹饪任务 → 查看菜品食材构成 → 提交主辅材实际用量+熟重+调料用量，一次性完成烹制。
### 核心流程
```
当日烹饪任务列表 → 查看菜品食材构成 → 去制作（提交主辅材实际用量） → 烹饪完成（提交熟重 + 调料用量）
当日烹饪任务列表 → 查看菜品食材构成 → 烹饪完成（提交主辅材用量 + 熟重 + 调料）
```
### 烹制状态枚举
| 状态码 | 状态名 | 说明 |
|:------:|--------|------|
| 0 | 待烹制 | 初始状态，可进行"去制作"操作 |
| 1 | 烹制中 | 已提交制作，可进行"烹饪完成"操作 |
| 0 | 待烹制 | 初始状态，可进行"烹饪完成"操作 |
| 2 | 已完成 | 烹制结束，不可再操作 |
| 3 | 异常 | 异常状态 |
@@ -46,17 +45,17 @@
| 序号 | 接口 | 路径 | 用途 |
|:----:|------|------|------|
| 一 | 当日烹饪任务列表（按餐次分组） | `POST /neglect/ratio-scale/cook-orders/page` | 按餐次分组返回今日需烹制的菜品列表 |
| 一 | 当日烹饪任务列表（按餐次分组） | `POST /neglect/ratio-scale/cook-orders/list` | 按餐次分组返回今日需烹制的菜品列表 |
| 二 | 菜品食材构成 | `GET /neglect/ratio-scale/cook-orders/{cookOrderId}/composition` | 查看菜品的主材和辅材清单（含标准用量） |
| 三 | 去制作 | `POST /neglect/ratio-scale/cook-orders/submit` | 提交主辅材实际用量，完善组配并开始烹制 |
| 四 | 烹饪完成 | `POST /neglect/ratio-scale/cook-orders/finish` | 提交熟重和调料用量，计算生熟比 |
| 三 | 烹饪完成 | `POST /neglect/ratio-scale/cook-orders/complete` | 提交主辅材用量+熟重+调料，一次完成烹制 |
| 四 | 调料模糊搜索 | `POST /neglect/ratio-scale/seasoning-search` | 模糊搜索调料（糖蜜饯+油脂+调味品三大类） |
---
## 一、当日烹饪任务列表（按餐次分组）
```
POST /neglect/ratio-scale/cook-orders/page
POST /neglect/ratio-scale/cook-orders/list
Content-Type: application/json
X-DEVICE-CODE: <设备编码>
X-DEVICE-TOKEN: <设备登录Token>
@@ -70,9 +69,7 @@ X-DEVICE-TOKEN: <设备登录Token>
{
"date": "2026-07-29", // 选填 — 计划日期 yyyy-MM-dd，默认当天
"mealType": 2, // 选填 — 餐次筛选: 1=早餐 / 2=午餐 / 3=晚餐 / 4=加餐
"keyword": "红烧肉", // 选填 — 菜品名称模糊搜索
"pageNum": 1, // 选填 — 保留字段，当前不使用
"pageSize": 20 // 选填 — 保留字段，当前不使用
"keyword": "红烧肉" // 选填 — 菜品名称模糊搜索
}
```
@@ -203,16 +200,16 @@ X-DEVICE-TOKEN: <设备登录Token>
---
## 三、去制作：提交食材实际用量并开始烹制
## 三、烹饪完成：提交主辅材用量+熟重+调料
```
POST /neglect/ratio-scale/cook-orders/submit
POST /neglect/ratio-scale/cook-orders/complete
Content-Type: application/json
X-DEVICE-CODE: <设备编码>
X-DEVICE-TOKEN: <设备登录Token>
```
厨师在秤上完成主辅材称重后，提交各食材的实际用量。后端自动完成：组配任务完善 → 组配完成 → 烹制单状态切换为"烹制中" → 烹制食材明细更新。
厨师在秤上完成称重后一次性提交全部数据，后端自动完成：组配任务完善 → 组配完成 → 计算生重生熟比 → 保存调料 → 烹制单置为已完成。
**该接口为事务性操作（`@Transactional`），所有步骤在同一事务中执行，任意步骤失败则全部回滚。**
@@ -221,7 +218,7 @@ X-DEVICE-TOKEN: <设备登录Token>
```json
{
"cookOrderId": 10001, // 必填 — 烹制单id
"items": [ // 必填 — 食材实际用量列表，至少1条
"items": [ // 必填 — 主辅材实际用量列表，至少1条
{
"materId": 20001, // 必填 — 食材id
"actualQty": 520.5 // 必填 — 实际用量(g)
@@ -230,6 +227,13 @@ X-DEVICE-TOKEN: <设备登录Token>
"materId": 20002,
"actualQty": 310.0
}
],
"cookedWeight": 3.200, // 必填 — 熟重(kg)
"seasonings": [ // 选填 — 调料用量列表
{
"materId": 30001, // 必填 — 调料食材id
"actualQty": 15.0 // 必填 — 实际用量(g)
}
]
}
```
@@ -249,22 +253,26 @@ X-DEVICE-TOKEN: <设备登录Token>
```
1. 校验烹制单状态 = 0（待烹制），否则报错
2. 通过内供申领单关联餐品净菜包：
链路: nut_prod_cook_order.food_id → nut_sup_internal_supply(food_id + canteen_id + clean_type=2)
链路: nut_prod_cook_order(food_id + canteen_id + meal_type) → nut_prod_clean_order(food_id + canteen_id + meal_type + clean_type=2)
→ clean_order_id → nut_sup_internal_supply(clean_order_id + clean_type=2)
→ batch_no → nut_sup_meal_package → nut_sup_meal_pkg_ingredient → trace_code
餐次匹配：通过 nut_prod_clean_order.meal_type 过滤，确保同菜不同餐次不会串单
3. 解析各食材的溯源码（materId → traceCode 映射）
4. 完善组配任务明细（按 materCode 匹配 comboTaskItem，更新 actualQty + traceCode）
5. 完成组配任务（comboStatus=2，记录完成时间）
6. 计算生重（Σ actualQty / 1000，g→kg，保留3位小数）
7. 从设备Token获取厨师信息（chef + chefId）
8. 更新烹制单：
- cookStatus → 1（烹制中）
- cookStart → 当前时间
- rawWeight → 生重(kg)
- chef / chefId → 登录厨师
- needPortions / cookedPortions → 份数
9. 更新烹制食材明细（cook_ingredient）：
- 已有明细 → 更新 actualQty + traceCode
- 无已有明细 → 按 foodComposition 自动创建兜底记录
8. 更新烹制食材明细（主辅材 actualQty + traceCode，无已有明细时兜底创建）
9. 保存调料用量（ingredientClass=3）
10. 计算生熟比 = 熟重 / 生重（保留3位小数，HALF_UP，生重>0且熟重≠null时才计算）
11. 更新烹制单：
- cookStatus → 2（已完成）
- cookStart / cookEnd → 当前时间
- rawWeight → 生重(kg)
- cookedWeight → 熟重(kg)
- rawCookedRatio → 生熟比
- chef / chefId → 登录厨师
- needPortions / cookedPortions → 份数
```
### 份数计算优先级
@@ -278,7 +286,7 @@ X-DEVICE-TOKEN: <设备登录Token>
| 场景 | 错误信息 |
|------|---------|
| 烹制单不存在 | `烹制单不存在` |
| 当前状态不是"待烹制" | `当前状态不允许此操作，仅待烹制状态可提交制作` |
| 当前状态不是"待烹制" | `当前状态不允许此操作，仅待烹制状态可提交` |
| 烹制单未关联组配任务（comboNo 为空） | `烹制单未关联组配任务，无法开始烹制` |
| 组配任务不存在 | `组配任务不存在，comboNo=xxx` |
@@ -286,47 +294,36 @@ X-DEVICE-TOKEN: <设备登录Token>
| 表名 | 操作 | 说明 |
|------|:--:|------|
| `nut_prod_cook_order` | 查询 + 更新 | 校验状态，更新为烹制中 |
| `nut_sup_internal_supply` | 查询 | 通过 foodId + canteenId + cleanType=2 关联，获取 batchNo 和 quantity |
| `nut_prod_cook_order` | 查询 + 更新 | 校验状态，更新为已完成 |
| `nut_prod_clean_order` | 查询 | 通过 foodId + canteenId + mealType + cleanType=2 匹配净菜订单，获取 clean_order_id 用于内供申领单的餐次过滤 |
| `nut_sup_internal_supply` | 查询 | 通过 clean_order_id + cleanType=2 关联，获取 batchNo 和 quantity |
| `nut_sup_meal_package` | 查询 | 通过 batchNo 查餐品净菜包 |
| `nut_sup_meal_pkg_ingredient` | 查询 | 获取各食材的溯源码 |
| `nut_prod_combo_task` | 查询 + 更新 | 完善组配状态为已完成 |
| `nut_prod_combo_task_item` | 查询 + 更新 | 更新 actualQty + traceCode |
| `nut_prod_cook_ingredient` | 查询 + 新增/更新 | 更新实际用量，不存在时兜底创建 |
| `nut_prod_cook_ingredient` | 查询 + 新增/更新 | 更新主辅材实际用量 + 保存调料用量 |
| `nut_mater_base` | 查询 | 获取食材编码和名称 |
| `nut_food_composition` | 查询 | 兜底创建 cook_ingredient 时获取食材分类等信息 |
---
## 四、烹饪完成：提交熟重和调料用量
## 四、调料模糊搜索
```
POST /neglect/ratio-scale/cook-orders/finish
POST /neglect/ratio-scale/seasoning-search
Content-Type: application/json
X-DEVICE-CODE: <设备编码>
X-DEVICE-TOKEN: <设备登录Token>
```
烹饪结束后，厨师在秤上称量熟重，并提交调料用量。后端自动计算生熟比。
**该接口为事务性操作（`@Transactional`）。**
搜索调料食材库，数据源 `nut_mater_base` 一级分类为 18(糖蜜饯)、19(油脂)、20(调味品) 的食材。
### 请求体
```json
{
"cookOrderId": 10001, // 必填 — 烹制单id
"cookedWeight": 3.200, // 必填 — 熟重(kg)
"seasonings": [ // 选填 — 调料用量列表
{
"materId": 30001, // 必填 — 调料食材id
"actualQty": 15.0 // 必填 — 实际用量(g)
},
{
"materId": 30002,
"actualQty": 8.5
}
]
"keyword": "酱油", // 选填 — 模糊匹配食材名称和别名
"pageNum": 1, // 必填 — 页码
"pageSize": 20 // 必填 — 每页条数
}
```
@@ -336,47 +333,28 @@ X-DEVICE-TOKEN: <设备登录Token>
{
"code": "200",
"msg": "操作成功",
"data": null
"data": [
{
"id": "30001",
"materName": "酱油",
"materCode": "19192004",
"alias": "生抽",
"canteenId": "2"
}
],
"total": 1
}
```
### 处理流程
### 字段说明
```
1. 校验烹制单状态 = 1（烹制中），否则报错
2. 如有调料：保存到 nut_prod_cook_ingredient
- 已在 cook_ingredient 中的调料（ingredientClass=3） → 更新 actualQty
- 新调料 → 新增记录（ingredientClass=3 调料）
3. 计算生熟比 = cookedWeight / rawWeight（保留3位小数，HALF_UP）
4. 更新烹制单：
- cookStatus → 2（已完成）
- cookedWeight → 熟重(kg)
- rawCookedRatio → 生熟比
- cookEnd → 当前时间
```
### 生熟比计算
```
生熟比 = 熟重(kg) / 生重(kg)
精度: 3位小数, HALF_UP
条件: 生重 > 0 且熟重 != null 时才计算，否则生熟比为 null
```
### 异常场景
| 场景 | 错误信息 |
|------|---------|
| 烹制单不存在 | `烹制单不存在` |
| 当前状态不是"烹制中" | `当前状态不允许此操作，仅烹制中状态可完成烹制` |
### 涉及数据表
| 表名 | 操作 | 说明 |
|------|:--:|------|
| `nut_prod_cook_order` | 查询 + 更新 | 校验状态，更新为已完成，记录熟重和生熟比 |
| `nut_prod_cook_ingredient` | 查询 + 新增/更新 | 保存调料用量（ingredientClass=3） |
| `nut_mater_base` | 查询 | 获取调料食材编码和名称 |
| 字段 | 类型 | 说明 |
|------|------|------|
| id | Long → String | 食材id |
| materName | String | 食材名称 |
| materCode | String | 食材编码 |
| alias | String | 别名 |
| canteenId | Long → String | 归属食堂id |
---
@@ -389,13 +367,17 @@ nut_prod_cook_order (烹制单)
│ │
│ └── mater_id ──→ nut_mater_base (食材库: 编码、名称、分类)
│
├── canteen_id + food_id ──→ nut_sup_internal_supply (内供申领单)
│ │
│ ├── batch_no ──→ nut_sup_meal_package (餐品净菜包)
│ │ │
│ │ └── nut_sup_meal_pkg_ingredient (溯源码)
│ │
│ └── quantity ──→ 份数
├── food_id + canteen_id + meal_type ──→ nut_prod_clean_order (净菜订单, clean_type=2)
│ │
│ └── id = clean_order_id
│
├── clean_order_id ──→ nut_sup_internal_supply (内供申领单, 按 clean_order_id + clean_type=2 匹配)
│ │
│ ├── batch_no ──→ nut_sup_meal_package (餐品净菜包)
│ │ │
│ │ └── nut_sup_meal_pkg_ingredient (溯源码)
│ │
│ └── quantity ──→ 份数
│
├── combo_no ──→ nut_prod_combo_task (组配任务)
│ │
@@ -424,20 +406,15 @@ nut_prod_cook_order (烹制单)
│ │──→ nut_mater_base (食材名称)
│ ← 食材清单(含标准用量) │←────────────────────│
│ │ │
│ 3. POST /cook-orders/submit │
│ 3. POST /cook-orders/complete │
│─────────────────────→│ │
│ │──→ 校验状态=待烹制 │
│ │──→ 匹配净菜订单(餐次过滤) │
│ │──→ 关联internal_supply │
│ │──→ 解析溯源码 │
│ │──→ 完善+完成组配任务 │
│ │──→ 计算生重 │
│ │──→ 更新烹制单=烹制中 │
│ │──→ 更新食材明细 │
│ ← 操作成功 │←──── 事务提交 ──────│
│ │ │
│ 4. POST /cook-orders/finish │
│─────────────────────→│ │
│ │──→ 校验状态=烹制中 │
│ │──→ 保存调料用量 │
│ │──→ 计算生熟比 │
│ │──→ 更新烹制单=已完成 │