# PDA GP12 检查接口说明

> 模块：`MesProductGp12Controller`  
> 服务地址示例：`http://127.0.0.1:8980`  
> 返回格式：`submit` 为 JeeSite `renderResult`；`pdaCheckItems`、`pdaQueryBySn` 为 `CommonResp`（`result` / `message` / `data`）  
> 说明：后台在「工件类型」中维护 GP12 检查项。员工用 PDA 扫工件码后，按该工件类型展示检查项并提交。

---

## 后台维护

1. 打开 **工件类型管理**
2. 对应类型操作列点击 **GP12检查项**
3. 新增检查项：名称、输入类型（选择框/输入框）、排序、最小值/最大值（输入框时）

检查项表：`mes_product_gp12_check`，通过 `cate_sn` 关联 `mes_product_cate.sn`。

---

## 1. 按工件码查询工件信息

##### 请求URL
- ` /js/a/mes/mesProductRecord/pdaQueryBySn `

##### 请求方式
- POST

##### 参数

|参数名|必选|类型|说明|
|:----|:---|:-----|-----|
|sn|是|string|工件码|

##### 返回字段说明

|字段路径|类型|中文说明|
|:----|:-----|-----|
|data.sn|string|工件码|
|data.cate|string|原字段，工件 cate 去掉末尾 2 位|
|data.cateSn|string|工件完整类型编号（`mes_product.cate`）|
|data.title|string|工件名称|
|data.oprno|string|固定 `GP12`|

---

## 2. 查询 GP12 检查项

扫码后调用本接口，展示该工件类型下已启用的检查项。

##### 请求URL
- ` /js/a/mes/mesProductGp12/pdaCheckItems `

##### 请求方式
- POST / GET

##### 参数

|参数名|必选|类型|说明|
|:----|:---|:-----|-----|
|sn|是|string|工件码，优先用此参数匹配检查项|
|cateSn|否|string|工件类型编号，无工件码时可用|

##### 参数示例
```
curl --location --request POST "http://127.0.0.1:8980/js/a/mes/mesProductGp12/pdaCheckItems?sn=工件码"
```

##### 返回示例

```
{
    "result": "true",
    "message": "成功",
    "data": {
        "sn": "工件码",
        "cateSn": "HEVXT",
        "oprno": "GP12",
        "title": "工件名称",
        "cate": "HEVXT",
        "needImage": true,
        "remarkRequired": false,
        "list": [
            {
                "id": "检查项ID",
                "title": "外观检查",
                "cateSn": "HEVXT",
                "input": "1",
                "inputName": "选择框",
                "minValue": null,
                "maxValue": null,
                "sort": 1,
                "needImage": true
            },
            {
                "id": "检查项ID2",
                "title": "尺寸",
                "cateSn": "HEVXT",
                "input": "2",
                "inputName": "输入框",
                "minValue": "1.000",
                "maxValue": "2.000",
                "sort": 2
            }
        ]
    }
}
```

##### 返回字段说明

|字段路径|类型|中文说明|
|:----|:-----|-----|
|data.list[].id|string|检查项ID，提交时回传|
|data.list[].title|string|检查项名称|
|data.list[].input|string|`1` 选择框，`2` 输入框|
|data.list[].minValue / maxValue|string|输入框上下限，选择框可为空|
|data.list[].needImage|boolean|该项必须上传照片|
|data.needImage|boolean|每一项都必须上传照片|
|data.remarkRequired|boolean|`false`，备注选填|

---

## 3. 提交 GP12 检查

原接口不变：无检查项模板时，仍只提交 sn / oprno / lineSn / 照片。

该工件类型已维护检查项时，必须带 `checkList`，提交全部检查项，且**每一项必须上传照片**。备注为选填。

##### 请求URL
- ` /js/a/mes/mesProductGp12/submit `

##### 请求方式
- POST

##### 参数

|参数名|必选|类型|说明|
|:----|:---|:-----|-----|
|sn|是|string|工件码|
|oprno|是|string|工位号，一般为 GP12|
|lineSn|是|string|产线编号|
|remark|否|string|备注，选填|
|ucode|否|string|PDA 账号，写入创建人|
|mesProductGp12_image|否|string|整单照片文件ID，先调 `/js/a/file/upload`|
|checkList|按模板|string|JSON 数组，见下|

##### checkList 单项

|参数名|必选|类型|说明|
|:----|:---|:-----|-----|
|id / checkId|是|string|检查项ID，来自接口 2|
|content|是|string|选择框：`true`/`false`；输入框：数值|
|mesProductGp12Items_image / image|是|string|该项照片文件ID，多个用逗号分隔|

##### 参数示例
```
curl --location --request POST "http://127.0.0.1:8980/js/a/mes/mesProductGp12/submit" ^
  --form "sn=工件码" ^
  --form "oprno=GP12" ^
  --form "lineSn=HEVXT" ^
  --form "ucode=zhangsan" ^
  --form "remark=选填备注" ^
  --form "checkList=[{\"id\":\"检查项ID\",\"content\":\"true\",\"image\":\"文件ID1\"},{\"id\":\"检查项ID2\",\"content\":\"1.5\",\"image\":\"文件ID2\"}]"
```

##### 说明

- 同一工件码已有 GP12 记录时，仍返回「该记录已存在」
- 有检查项时，整单 `result` 由各项汇总：全部 OK 为 OK，否则 NG
- 选择框：`true` / `1` / `OK` / `是` / `合格` 为 OK
- 输入框：在最小~最大值范围内为 OK
- **每一项都必须先上传照片**，缺一张即整单失败，返回「请为每一项上传照片」
- 照片上传与点检相同：先 `POST /js/a/file/upload`，`bizType=mesProductGp12Items_image`，`uploadType=image`，再把文件 ID 写入检查项
- 备注为选填，写入 GP12 记录的 `remark`