质检qms模块通用模块版本只关注qc_inspection_item、qc_inspection_item_category、qc_inspection_main、qc_inspection_main_file_relation、qc_inspection_result、qc_inspection_template、qc_template_item、qc_unqualified_record、qc_unqualified_review！

**QMS质检模块** - 仅关注以下核心数据表：
- `qc_inspection_item` - 检验项目
- `qc_inspection_item_category` - 检验项目分类
- `qc_inspection_main` - 检验单主表
- `qc_inspection_main_file_relation` - 检验单附件关联
- `qc_inspection_result` - 检验结果
- `qc_inspection_template` - 检验模板
- `qc_template_item` - 模板检验项
- `qc_unqualified_record` - 不合格品记录
- `qc_unqualified_review` - 不合格品评审

#### QMS模块主子表关系详解

```
qc_inspection_type (检测类型)
        ↓
        │
qc_inspection_item_category (检测项目分类) ←→ qc_inspection_item (检测项定义)
        ↓                                           ↓
        │                                           │
qc_inspection_template (检验模板) ←→ qc_template_item (模板检验项)
        ↓                                           │
        │                                           │
qc_inspection_main (检验单主表) ←───────────────────┘
        ↓
qc_inspection_result (检验结果)

qc_inspection_main (检验单主表) → [产生不合格] → qc_unqualified_review (不合格评审)
                                                                    ↓
                                                    qc_unqualified_record (不合格记录)
```

**主子表对**:

| 主表 | 子表 | 关联字段 | 说明 |
|-----|-----|---------|-----|
| `qc_inspection_template` | `qc_template_item` | `templateId` | 检验模板包含多个检测项 |
| `qc_inspection_main` | `qc_inspection_result` | `inspectionId` | 检验单包含多个检验结果 |
| `qc_unqualified_review` | `qc_unqualified_record` | `reviewId` | 不合格评审包含多个评审记录 |

**基础数据关联**:

| 表 | 关联表 | 关联字段 | 说明 |
|---|--------|---------|-----|
| `qc_inspection_item` | `qc_inspection_item_category` | `categoryId` | 检验项目归属分类 |
| `qc_inspection_item` | `qc_inspection_type` | `inspectionType` | 检验项目归属类型 |
| `qc_inspection_main` | `qc_inspection_template` | `templateId` | 检验单引用模板 |
| `qc_inspection_result` | `qc_inspection_item` | `itemId` | 检验结果关联检测项定义 |

**关键设计特点**:
1. **模板驱动**: 检验单关联模板，模板包含多个检测项定义
2. **级联继承**: 检验结果从检测项定义继承标准值、上下限等规格参数
3. **主子分离**: 主表记录总体信息（单号、物料、数量），子表记录明细（每个检测项的检测结果）
4. **不合格评审**: 当检验结果不合格时，触发评审流程，生成评审主表及记录子表

---

## 质检模板匹配策略（核心业务规则）

**生成质检任务时，按以下4级降级优先级自动匹配模板：**

```
┌─────────────────────────────────────────────────────────────┐
│                    质检模板匹配策略                           │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  第1级：物料 + 工位 + 工序 + 检测类型（精确匹配）            │
│    ↓ 未找到                                                  │
│  第2级：物料 + 工位 + 检测类型                               │
│    ↓ 未找到                                                  │
│  第3级：物料 + 检测类型                                      │
│    ↓ 未找到                                                  │
│  第4级：通用模板（仅检测类型 + isDefault=1）                 │
│    ↓ 未找到 → 抛出异常："无可用检测模板"                      │
│                                                              │
└─────────────────────────────────────────────────────────────┘
```

### 匹配条件说明

| 优先级 | 匹配条件 | 说明 | 业务场景 |
|-------|---------|------|---------|
| 1 | 物料 + 工位 + 工序 + 检测类型 | 最精确匹配 | 某物料在特定工位/工序有特殊质检要求 |
| 2 | 物料 + 工位 + 检测类型 | 特定工位（不限工序） | 某物料在特定工位的质检要求统一 |
| 3 | 物料 + 检测类型 | 特定物料（不限工位/工序） | 某物料的质检要求在任何工位/工序都一致 |
| 4 | 通用模板（仅检测类型） | 兜底方案 | 该检测类型的默认质检方案 |

### 检测类型字典

| 代码 | 检测类型 | 说明 |
|------|---------|------|
| 0 | 首检 | 生产开始前首批产品的检验 |
| 1 | 专检 | 专职检验员的检验 |
| 2 | 自检 | 操作工自己检验 |
| 3 | 互检 | 相互检验（上下工序互检） |
| 4 | 原材料检 | 原材料入库检验 |
| 5 | 抽检 | 抽样检验 |
| 6 | 成品检 | 成品检验 |
| 7 | 入库检 | 产品入库前的检验 |

### 通用模板规则

**定义**：
- **通用模板**：不绑定具体物料、工序或工位，仅按检测类型适用的默认质检方案
- **标识字段**：`is_default`（0否/1是）

**约束规则**：
1. **唯一性**：每种检测类型只能有一个通用模板
2. **互斥性**：通用模板不能同时绑定物料、工序或工位
3. **校验方式**：应用层校验（Service层代码校验，非数据库约束）

---

## 页面分类与检测类型对应关系

**前端路由参数映射**：

| 路由参数 | 页面名称 | 查询参数 | 包含的检测类型 |
|---------|---------|---------|---------------|
| `inspectionType=1` | 产品检测 | `qcInspectionTypes=['0','1','3','5','6']` | 首检、专检、互检、抽检、成品检 |
| `inspectionType=2` | 原材料检测 | `qcInspectionType='4'` | 原材料检 |
| `inspectionType=3` | 入库检测 | `qcInspectionType='7'` | 入库检 |

**注意**：
- 前端使用 `qcInspectionType`（单值）或 `qcInspectionTypes`（多值）查询
- 后端通过 `qc_inspection_type.qc_inspection_type` 字典字段过滤
- **不要**使用 `inspectionType`（Long 类型的 typeId 主键）进行分类查询

---

## 质检任务生成流程

### 触发方式

| 触发来源 | 接口路径 | 说明 |
|---------|---------|------|
| 上位机（HMI） | `POST /hmi/qcInspectionTask` | 无登录，需模拟登录传递租户 |
| PDA | `POST /pda/createInspectionTask` | 已登录用户 |
| 前端手工创建 | `POST /qms/QcInspectionMain` | 已登录用户 |

### 生成流程

```
┌─────────────────────────────────────────────────────────────────────┐
│                      质检任务生成流程                                 │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  1. 接收请求参数（物料编码、工位、检测类型等）                          │
│     ↓                                                                │
│  2. 参数校验（物料编码、检测类型必填）                                 │
│     ↓                                                                │
│  3. 工位名称 → 工位编码（如需要）                                     │
│     ↓                                                                │
│  4. 匹配质检模板（4级降级匹配策略）                                   │
│     ↓ 未找到 → 抛出异常                                              │
│  5. 调用编码规则服务生成质检单号                                      │
│     ↓                                                                │
│  6. 创建质检主表记录（qc_inspection_main）                           │
│     ↓                                                                │
│  7. 根据模板检测项（qc_template_item）生成质检结果子表                │
│     （qc_inspection_result）- 快照模式                               │
│     ↓                                                                │
│  8. 返回质检单号                                                     │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘
```

### 快照机制

质检结果子表（`qc_inspection_result`）采用**快照模式**存储检测项信息：

| 快照字段 | 来源 | 说明 |
|---------|------|------|
| `itemCode` | `qc_template_item.item_code` | 检测项编码 |
| `itemName` | `qc_template_item.item_name` | 检测项名称 |
| `standardValue` | `qc_template_item.standard_value` | 标准值 |
| `upperLimit` | `qc_template_item.upper_limit` | 控制上限 |
| `lowerLimit` | `qc_template_item.lower_limit` | 控制下限 |
| `detectType` | `qc_template_item.detect_type` | 检测方式（0定性/1定量） |
| `controlType` | `qc_template_item.control_type` | 控制类型（0手动/1自动） |

**设计目的**：模板修改后不影响已创建的历史检验单数据完整性。

---

## 质检结果判定逻辑

### 单项检测结果判定

| 检测方式 | 判定规则 | 结果值 |
|---------|---------|--------|
| 定量检测 | `lowerLimit ≤ detectValue ≤ upperLimit` → 合格 | 0合格/1不合格/2未判定 |
| 定性检测 | 人工选择合格/不合格 | 0合格/1不合格/2未判定 |

### 主表结果汇总

```
IF (所有子项 detectResult = 0) THEN
    主表 result = 0 (合格)
ELSE IF (任一子项 detectResult = 1) THEN
    主表 result = 1 (不合格)
ELSE
    主表 result = 2 (待判定)
```

### 状态流转

| 状态值 | 状态名称 | 说明 |
|-------|---------|------|
| 0 | 未处理 | 初始状态，等待检验 |
| 1 | 已完成 | 检验完成 |

---

## 不合格品评审流程

### 触发条件

当质检主表 `result = 1`（不合格）时，可触发不合格品评审流程。

### 评审结果类型

| 代码 | 评审结果 | 后续处理 |
|------|---------|---------|
| 0 | 报废 | 物料报废处理 |
| 1 | 返工 | 返回生产重新加工 |
| 2 | 退货 | 退回供应商 |
| 3 | 流转 | 继续流转到下工序 |
| 4 | 让步接收 | 降级使用或特批放行 |

### 评审流程

```
┌─────────────────────────────────────────────────────────────────────┐
│                      不合格品评审流程                                 │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  质检结果不合格（result=1）                                          │
│     ↓                                                                │
│  创建不合格品评审单（qc_unqualified_review）                         │
│     ↓                                                                │
│  启动工作流（Warm-Flow）                                             │
│     ↓                                                                │
│  评审人进行评审，选择评审结果                                         │
│     ↓                                                                │
│  创建评审记录（qc_unqualified_record）                               │
│     ↓                                                                │
│  根据评审结果执行后续处理                                             │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘
```

---

## 核心表字段详解

### qc_inspection_main（质检主表）

| 字段 | 类型 | 说明 |
|------|------|------|
| `inspection_id` | Long | 主键（雪花ID） |
| `inspection_no` | String | 质检单号（编码规则生成） |
| `template_id` | Long | 关联模板ID |
| `material_code` | String | 物料编码 |
| `material_name` | String | 物料名称 |
| `inspection_type` | Long | 检测类型ID（关联qc_inspection_type.type_id） |
| `inspection_qty` | BigDecimal | 质检数量 |
| `qualified_qty` | BigDecimal | 合格数 |
| `unqualified_qty` | BigDecimal | 不合格数 |
| `result` | String | 质检结果（0合格/1不合格/2待判定） |
| `status` | String | 单据状态（0未处理/1完成） |
| `production_order` | String | 业务来源单号 |
| `batch_no` | String | 批次号 |
| `barcode` | String | 条码号 |

### qc_inspection_result（质检结果子表）

| 字段 | 类型 | 说明 |
|------|------|------|
| `result_id` | Long | 主键（雪花ID） |
| `inspection_id` | Long | 关联质检主表ID |
| `item_id` | Long | 关联检测项ID |
| `detect_result` | String | 检测结果（0合格/1不合格/2未判定） |
| `detect_value` | BigDecimal | 定量检测值 |
| `spec_inspection` | String | 规格质检值（定性检测） |
| `problem_detail` | String | 不合格明细描述 |
| `detect_type` | String | 检测方式（0定性/1定量）【快照】 |
| `standard_value` | BigDecimal | 标准值【快照】 |
| `upper_limit` | BigDecimal | 控制上限【快照】 |
| `lower_limit` | BigDecimal | 控制下限【快照】 |

### qc_inspection_template（检验模板）

| 字段 | 类型 | 说明 |
|------|------|------|
| `template_id` | Long | 主键（雪花ID） |
| `template_code` | String | 模板编码 |
| `template_name` | String | 模板名称 |
| `material_code` | String | 物料编码（可空） |
| `type_id` | Long | 检测类型ID |
| `station_code` | String | 工位编码（可空） |
| `process_code` | String | 工序编码（可空） |
| `is_default` | String | 是否通用模板（0否/1是） |

### qc_inspection_item（检测项定义）

| 字段 | 类型 | 说明 |
|------|------|------|
| `item_id` | Long | 主键（雪花ID） |
| `item_code` | String | 检测项编码 |
| `item_name` | String | 检测项名称 |
| `category_id` | Long | 检测项类别ID |
| `inspection_type` | Long | 检测类型ID |
| `detect_type` | String | 检测方式（0定性/1定量） |
| `control_type` | String | 控制类型（0手动/1自动） |
| `standard_value` | BigDecimal | 标准值 |
| `upper_limit` | BigDecimal | 控制上限 |
| `lower_limit` | BigDecimal | 控制下限 |

---

## 跨服务调用说明

### 编码规则服务

| 调用场景 | 方法 | 编码规则编码 |
|---------|------|-------------|
| 生成质检单号 | `remoteCodeRuleService.selectCodeRuleCodeWithTenant("3")` | 3 |

**注意**：上位机调用时需使用 `selectCodeRuleCodeWithTenant` 方法，通过 `RpcContext.setAttachment("tenantId", ...)` 传递租户信息。

### Dubbo 租户传递

```java
// Consumer 端（上位机服务）
StpUtil.login(userId, "login");  // 模拟登录
TenantHelper.setDynamic(tenantId);  // 设置本地租户
RpcContext.getContext().setAttachment("tenantId", tenantId);  // 传递给远程服务

// Provider 端（编码规则服务）
String tenantId = RpcContext.getContext().getAttachment("tenantId");
TenantHelper.setDynamic(tenantId);  // 设置租户上下文
```