From 1458532478eedbd82947e6ee8515f881d4a4912a Mon Sep 17 00:00:00 2001
From: liyong <18434998025@163.com>
Date: 星期六, 18 七月 2026 16:14:23 +0800
Subject: [PATCH] Merge remote-tracking branch 'origin/dev_business' into dev_business
---
docs/route_process_output_item_integration.md | 143 +++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 143 insertions(+), 0 deletions(-)
diff --git a/docs/route_process_output_item_integration.md b/docs/route_process_output_item_integration.md
new file mode 100644
index 0000000..d1ec864
--- /dev/null
+++ b/docs/route_process_output_item_integration.md
@@ -0,0 +1,143 @@
+# 宸ヨ壓璺嚎宸ュ簭 - 浜у嚭浜у搧瀛楁 - 鍓嶇鑱旇皟鏂规
+
+## 娑夊強椤甸潰
+
+- 宸ヨ壓璺嚎 - 宸ュ簭閰嶇疆椤碉紙鏂板/缂栬緫宸ュ簭鏃堕�夋嫨浜у嚭浜у搧锛�
+- 鎺掍骇 - 浠诲姟鏂板椤碉紙鑷姩甯﹀叆浜у嚭浜у搧锛�
+- BOM 閰嶇疆椤碉紙宸ュ簭浜у嚭浜у搧鍙樻洿鍚庯紝BOM 鐨勪骇鍝佸瓧娈佃仈鍔級
+
+## 涓氬姟鑳屾櫙
+
+**闂**锛氬綋鍓嶆墍鏈夊伐搴忕殑浜у嚭閮芥槸鏈�缁堟垚鍝侊紝鏃犳硶鍖哄垎涓棿宸ュ簭鐨勫崐鎴愬搧浜у嚭銆備緥濡傦細
+- 宸ュ簭1锛氭媺涓� 鈫� 浜у嚭"閾濇潌"锛堝崐鎴愬搧锛夛紝涓嶆槸"閽㈣姱閾濈粸绾�"
+- 宸ュ簭2锛氱粸绾� 鈫� 浜у嚭"閽㈣姱閾濈粸绾�"锛堟渶缁堟垚鍝侊級
+
+**瑙ｅ喅**锛氬伐鑹鸿矾绾垮伐搴忔柊澧�"浜у嚭浜у搧"瀛楁锛屾帓浜ф椂鑷姩甯﹀叆浠诲姟鐨勭墿鏂欍��
+
+## 涓氬姟娴佺▼涓庢暟鎹甫鍏�
+
+1. **宸ヨ壓璺嚎閰嶇疆** 鈫� 姣忛亾宸ュ簭閫夋嫨浜у嚭浜у搧锛堝崐鎴愬搧/鎴愬搧锛�
+2. **鎺掍骇** 鈫� 閫夋嫨宸ュ簭鍚庯紝鑷姩浠庡伐搴忓甫鍑� `outputItemId` 浣滀负浠诲姟鐨� `itemId`
+3. **鎶ュ伐浜у嚭** 鈫� 浠庝换鍔″啑浣� `itemId`锛堝彲鑳芥槸鍗婃垚鍝侊級锛屼骇鍑哄崟鍜屽簱瀛樿嚜鍔ㄦ纭�
+4. **鍊掑啿鎵ｆ枡** 鈫� BOM 鏌ヨ鎸夊伐搴�+浜у嚭浜у搧鍖归厤锛岃嚜鍔ㄦ纭�
+
+## API
+
+### 宸ュ簭淇濆瓨鎺ュ彛锛堝彉鏇达級
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| POST | /mes/pro/route-process/create | 鍒涘缓宸ュ簭 |
+| PUT | /mes/pro/route-process/update | 鏇存柊宸ュ簭 |
+
+**璇锋眰鍙傛暟鏂板锛�**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
+|------|------|------|------|
+| outputItemId | Long | 鍚� | 浜у嚭浜у搧鐗╂枡缂栧彿锛堜负绌烘椂榛樿鐢ㄥ伐鍗曟垚鍝侊級 |
+
+**璇锋眰绀轰緥锛堟柊澧炲瓧娈碉級锛�**
+
+```json
+{
+ "routeId": 7,
+ "processId": 10,
+ "sort": 1,
+ "keyFlag": false,
+ "checkFlag": false,
+ "backflushFlag": true,
+ "outputItemId": 31
+}
+```
+
+### 宸ュ簭鏌ヨ鎺ュ彛锛堝彉鏇达級
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| GET | /mes/pro/route-process/list-by-route | 鎸夊伐鑹鸿矾绾挎煡宸ュ簭鍒楄〃 |
+| GET | /mes/pro/route-process/get-by-route-and-process | 鎸夎矾绾�+宸ュ簭鏌ラ厤缃� |
+| GET | /mes/pro/route-process/get | 鑾峰彇鍗曚釜宸ュ簭 |
+
+**鍝嶅簲瀛楁鏂板锛�**
+
+| 瀛楁 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| outputItemId | Long | 浜у嚭浜у搧鐗╂枡缂栧彿 |
+| outputItemCode | String | 浜у嚭浜у搧鐗╂枡缂栫爜 |
+| outputItemName | String | 浜у嚭浜у搧鐗╂枡鍚嶇О |
+
+**鍝嶅簲绀轰緥锛堟柊澧炲瓧娈碉級锛�**
+
+```json
+{
+ "code": 0,
+ "data": {
+ "id": 1,
+ "routeId": 7,
+ "processId": 10,
+ "processCode": "PROC_001",
+ "processName": "鎷変笣",
+ "sort": 1,
+ "keyFlag": false,
+ "checkFlag": false,
+ "backflushFlag": true,
+ "outputItemId": 31,
+ "outputItemCode": "ITEM_20260716004",
+ "outputItemName": "閾濇潌"
+ }
+}
+```
+
+## 瀛楁灞曠ず瑙勫垯
+
+| 瀛楁 | 灞曠ず浣嶇疆 | 璇存槑 |
+|------|----------|------|
+| outputItemId | 宸ュ簭閰嶇疆琛ㄥ崟 | 鐗╂枡閫夋嫨鍣紝鍙�夊崐鎴愬搧鎴栨垚鍝� |
+| outputItemCode | 宸ュ簭鍒楄〃銆佸伐搴忚鎯� | 鍙灞曠ず |
+| outputItemName | 宸ュ簭鍒楄〃銆佸伐搴忚鎯� | 鍙灞曠ず |
+
+## 鍓嶇淇敼鐐�
+
+### 1. 宸ヨ壓璺嚎 - 宸ュ簭閰嶇疆
+
+鍦�"鏄惁鍊掑啿"寮�鍏充箣鍚庯紝鏂板"浜у嚭浜у搧"閫夋嫨鍣細
+
+- 浣跨敤鐗╂枡閫夋嫨缁勪欢锛岀瓫閫夎寖鍥翠笌宸ュ崟浜у搧閫夋嫨鍣ㄤ竴鑷�
+- 闈炴渶鍚庡伐搴忥細閫夋嫨璇ュ伐搴忎骇鍑虹殑鍗婃垚鍝�
+- 鏈�鍚庝竴閬撳伐搴忥細鍙暀绌猴紙榛樿涓哄伐鍗曟垚鍝侊級锛屼篃鍙樉寮忛�夋嫨鏈�缁堟垚鍝�
+- 淇濆瓨鏃跺皢 `outputItemId` 鎻愪氦鍒板悗绔�
+
+### 2. 鎺掍骇 - 浠诲姟鏂板
+
+- 褰撶敤鎴烽�夋嫨宸ュ崟 + 宸ヨ壓璺嚎 + 宸ュ簭鍚庯紝璋冪敤 `/mes/pro/route-process/get-by-route-and-process` 鑾峰彇宸ュ簭閰嶇疆
+- 濡傛灉宸ュ簭閰嶇疆浜� `outputItemId`锛岃嚜鍔ㄥ～鍏ヤ换鍔＄殑鐗╂枡瀛楁锛堝睍绀� `outputItemName`锛�
+- 濡傛灉宸ュ簭鏈厤缃� `outputItemId`锛岃嚜鍔ㄥ洖閫�宸ュ崟鐨勬垚鍝�
+- 鐢ㄦ埛鍙互鎵嬪姩淇敼浠诲姟鐨勭墿鏂欙紙瑕嗙洊鑷姩濉叆鍊硷級
+
+### 3. BOM 閰嶇疆
+
+褰撳伐搴忛厤缃簡 `outputItemId` 鍚庯細
+- 璇ュ伐搴忕殑 BOM 璁板綍鐨�"浜у搧"瀛楁搴旇嚜鍔ㄥ叧鑱斿埌 `outputItemId`
+- 鍗� BOM 琛� `mes_pro_route_product_bom.product_id` 搴斾笌宸ュ簭鐨� `outputItemId` 涓�鑷�
+- **娉ㄦ剰**锛氱幇鏈� BOM 鏁版嵁鐨� `product_id` 鍏ㄩ儴鏄渶缁堟垚鍝� ID锛岄厤缃伐搴忎骇鍑轰骇鍝佸悗闇�閲嶆柊璋冩暣 BOM
+
+### 4. 宸ュ簭鍒楄〃灞曠ず
+
+宸ュ簭鍒楄〃涓柊澧�"浜у嚭浜у搧"鍒楋紝灞曠ず `outputItemName`锛屾湭閰嶇疆鏃舵樉绀�"榛樿锛堝伐鍗曟垚鍝侊級"銆�
+
+## 涓氬姟瑙勫垯璇存槑
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| outputItemId 涓虹┖ | 鎺掍骇鏃朵换鍔＄殑 itemId 榛樿鐢ㄥ伐鍗曠殑 productId锛堝悜鍚庡吋瀹癸級 |
+| outputItemId 涓嶄负绌� | 鎺掍骇鏃朵换鍔＄殑 itemId 鑷姩鐢ㄥ伐搴忕殑 outputItemId |
+| 鏈�鍚庝竴閬撳伐搴� | 寤鸿涓嶅～ outputItemId锛屾垨濉渶缁堟垚鍝侊紝鏁堟灉涓�鏍� |
+| 闈炴渶鍚庡伐搴� | 寤鸿濉啓鍗婃垚鍝侊紝杩欐牱鎶ュ伐浜у嚭鏃跺叆绾胯竟搴撶殑鏄崐鎴愬搧 |
+| 鍓嶇鏄惧紡浼� itemId | 鍚庣浼樺厛浣跨敤鍓嶇浼犲叆鍊硷紙鍚戝悗鍏煎鐜版湁鎺掍骇閫昏緫锛� |
+
+## 娉ㄦ剰浜嬮」
+
+- 鐜版湁宸ヨ壓鏈嚎鏁版嵁涓嶉渶瑕佽縼绉伙紝`outputItemId` 涓虹┖鏃惰涓轰笌涔嬪墠瀹屽叏涓�鑷�
+- 閰嶇疆浜� `outputItemId` 鍚庯紝闇�鍚屾璋冩暣璇ュ伐搴忕殑 BOM 閰嶇疆锛坄product_id` 鏀逛负鍗婃垚鍝� ID锛�
+- 鍗婃垚鍝佷骇鍑哄悗浼氬叆绾胯竟搴擄紙WIP锛夛紝涓嬩竴閬撳伐搴忔秷鑰楁椂閫氳繃 BOM 鍊掑啿鎴栨墜宸ユ姇鏂欐墸鍑�
+- 鎶ュ伐椤甸潰鐨�"浜у搧鐗╂枡"瀛楁鍙兘鏄剧ず鍗婃垚鍝侊紝杩欐槸姝ｇ‘鐨勶紝涓嶈璇互涓烘槸鏁版嵁閿欒
--
Gitblit v1.9.3