# MesQaDingtalkController 接口文档

## 接口概述
- **基础路径**: `/MesQaDingtalk`
- **功能**: MES QA 钉钉消息推送控制器
- **描述**: 用于发送不同类型的质量检验消息到钉钉
- **跨域设置**: 支持跨域请求（CORS）

## 通用请求体格式 (QaMsgDto)

| 字段名 | 类型 | 必填 | 描述 |
|--------|------|------|------|
| id | Long | 是 | 检验记录ID |
| lineName | String | 是 | 线体名称 |
| workshopName | String | 是 | 车间名称 |
| qaType | String | 是 | QA类型 (首件首检完成/巡检检验完成/入库检检验完成) |

## 1. 统一QA消息发送接口

### 请求信息
- **请求方法**: `POST`
- **请求路径**: `/MesQaDingtalk/sendQaMsg`
- **功能描述**: 根据 `qaType` 值统一发送不同类型的QA消息

### 请求参数
- **参数类型**: RequestBody
- **参数名称**: dto
- **参数格式**: JSON
- **参数内容**: QaMsgDto对象

### 响应信息
- **响应格式**: JSON
- **成功响应**:
```json
{
  "code": 200,
  "message": "操作成功",
  "data": null
}
```

- **失败响应**:
```json
{
  "code": 500,
  "message": "错误信息",
  "data": null
}
```

### 业务逻辑
- 当 `qaType` 为 "首件首检完成" 时，调用 `sendQaMsgSJ` 方法
- 当 `qaType` 为 "巡检检验完成" 时，调用 `sendQaMsgXJ` 方法
- 当 `qaType` 为 "入库检检验完成" 时，调用 `sendQaMsgRKJ` 方法
- 对于未知类型，返回错误信息

## 2. 首件检验消息发送接口

### 请求信息
- **请求方法**: `POST`
- **请求路径**: `/MesQaDingtalk/sendQaMsgSJ`
- **功能描述**: 发送首件检验消息

### 请求参数
- **参数类型**: RequestBody
- **参数名称**: dto
- **参数格式**: JSON
- **参数内容**: QaMsgDto对象

### 响应信息
- **响应格式**: JSON
- **成功响应**:
```json
{
  "code": 200,
  "message": "操作成功",
  "data": null
}
```

- **失败响应**:
```json
{
  "code": 500,
  "message": "首件检验消息发送失败: 具体错误信息",
  "data": null
}
```

## 3. 巡检消息发送接口

### 请求信息
- **请求方法**: `POST`
- **请求路径**: `/MesQaDingtalk/sendQaMsgXJ`
- **功能描述**: 发送巡检消息

### 请求参数
- **参数类型**: RequestBody
- **参数名称**: dto
- **参数格式**: JSON
- **参数内容**: QaMsgDto对象

### 响应信息
- **响应格式**: JSON
- **成功响应**:
```json
{
  "code": 200,
  "message": "操作成功",
  "data": null
}
```

- **失败响应**:
```json
{
  "code": 500,
  "message": "巡检消息发送失败: 具体错误信息",
  "data": null
}
```

## 4. 入库检消息发送接口

### 请求信息
- **请求方法**: `POST`
- **请求路径**: `/MesQaDingtalk/sendQaMsgRKJ`
- **功能描述**: 发送入库检消息

### 请求参数
- **参数类型**: RequestBody
- **参数名称**: dto
- **参数格式**: JSON
- **参数内容**: QaMsgDto对象

### 响应信息
- **响应格式**: JSON
- **成功响应**:
```json
{
  "code": 200,
  "message": "操作成功",
  "data": null
}
```

- **失败响应**:
```json
{
  "code": 500,
  "message": "入库检消息发送失败: 具体错误信息",
  "data": null
}
```