1

云

6 小时以前 d913cc2ef67620a9ad9f6fcfd38bea897a023c00

1

 docs/20260623_factory_inspect_add_shipping_info_id.sql

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,8 @@
-- å‡ºåŽ‚检验添加发货信息关联字段
-- æ‰§è¡Œæ—¶é—´ï¼š2026-06-23

ALTER TABLE quality_inspect
    ADD COLUMN shipping_info_id BIGINT DEFAULT NULL COMMENT '发货信息id（出厂检验关联发货）' AFTER sales_ledger_id;

-- æ·»åŠ ç´¢å¼•ä¼˜åŒ–查询
CREATE INDEX idx_quality_inspect_shipping_info ON quality_inspect(shipping_info_id, product_model_id);

 docs/20260623_factory_inspect_optimization.md

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,82 @@
# å‡ºåŽ‚质检优化 - å‰ç«¯è”调文档

## å˜æ›´æ¦‚è¿°

优化发货流程中的出厂质检环节：
1. å‘货审核通过后，自动生成出厂检验单
2. å‡ºåº“审批前，必须完成出厂质检

## ä¸€ã€æ•°æ®åº“变更

执行 `docs/20260623_factory_inspect_add_shipping_info_id.sql`：

```sql
ALTER TABLE quality_inspect
    ADD COLUMN shipping_info_id BIGINT DEFAULT NULL COMMENT '发货信息id（出厂检验关联发货）' AFTER sales_ledger_id;

CREATE INDEX idx_quality_inspect_shipping_info ON quality_inspect(shipping_info_id, product_model_id);
```

## äºŒã€ä¸šåŠ¡æµç¨‹å˜æ›´

### åŽŸæµç¨‹
发货 â†’ å‘货审核 â†’ å‡ºåŽ‚质检 â†’ å‡ºåº“审核 â†’ å‡ºåº“通过

### ä¼˜åŒ–后流程
1. **发货申请** â†’ åˆ›å»ºå‘货单，状态"待审核"
2. **发货审核通过** â†’ è‡ªåŠ¨ç”Ÿæˆå‡ºåŽ‚检验单，状态变为"审核通过"
3. **出厂质检** â†’ å®Œæˆå‡ºåŽ‚检验单（提交检验结果）
4. **出库审核** â†’ æ£€æŸ¥å‡ºåŽ‚质检是否完成，通过后扣减库存
5. **出库通过** â†’ å®Œæˆ

## ä¸‰ã€æŽ¥å£å˜æ›´

### 3.1 å‡ºåŽ‚检验单新增字段

**GET** `/quality/qualityInspect/listPage?inspectType=2`

返回字段新增：

| å­—段 | ç±»åž‹ | è¯´æ˜Ž |
|------|------|------|
| `shippingInfoId` | Long | å…³è”的发货信息ID |

### 3.2 å‡ºåº“审批校验

**POST** `/stockOutRecord/approve`

出库审批通过时，后端会检查：
- é”€å”®å‡ºåº“（recordType=SALE_SHIP_STOCK_OUT）是否有关联的出厂检验单
- å‡ºåŽ‚检验单是否已完成（inspectState=1）

**错误提示：**
- `"该出库记录未生成出厂检验单，请先完成发货审批"` - å‘货审核未通过
- `"出厂检验单尚未提交完成，请先完成出厂质检后再进行出库审批"` - å‡ºåŽ‚质检未完成

## å››ã€å‰ç«¯å¯¹æŽ¥è¦ç‚¹

### 4.1 å‡ºåŽ‚检验列表页

出厂检验单新增 `shippingInfoId` å­—段，可用于：
- è·³è½¬åˆ°å‘货详情页
- æ˜¾ç¤ºå…³è”的发货编号

### 4.2 å‡ºåº“审批页

出库审批时，如果返回错误提示，前端应引导用户：
1. å…ˆå®Œæˆå‘货审核（发货审核通过后自动生成出厂检验单）
2. å®Œæˆå‡ºåŽ‚质检后再进行出库审批

### 4.3 å»ºè®®ä¼˜åŒ–

可在出库审批页面增加"出厂质检状态"列，显示：
- æœªç”Ÿæˆ - å‘货审核未通过
- å¾…检验 - å·²ç”Ÿæˆå‡ºåŽ‚检验单，未提交
- å·²å®Œæˆ - å‡ºåŽ‚检验单已提交

## äº”、注意事项

1. å‡ºåŽ‚检验单在发货审核通过后自动生成，无需手动创建
2. æ¯ä¸ªå‘货产品明细会生成一条对应的出厂检验单
3. å‡ºåŽ‚检验单的检验参数会根据产品的出厂检验标准自动初始化
4. å‡ºåº“审批通过前必须完成出厂质检，否则会报错