From 38b7b5add8824914d85c58eceb6d7498d62556c8 Mon Sep 17 00:00:00 2001
From: 云 <2163098428@qq.com>
Date: 星期二, 01 九月 2026 10:24:31 +0800
Subject: [PATCH] docs(mes): 添加报工倒计时和产品入库单自动生成功能文档

---
 docs/process_feedback_wait_countdown_integration.md        |  116 +++++++++++++++++++++++
 docs/product_receipt_auto_stock_integration.md             |  111 ++++++++++++++++++++++
 docs/process_feedback_wait_countdown_remind_integration.md |   47 +++++++++
 3 files changed, 274 insertions(+), 0 deletions(-)

diff --git a/docs/process_feedback_wait_countdown_integration.md b/docs/process_feedback_wait_countdown_integration.md
new file mode 100644
index 0000000..0a01c3e
--- /dev/null
+++ b/docs/process_feedback_wait_countdown_integration.md
@@ -0,0 +1,116 @@
+# 鎶ュ伐绛夊緟鏃堕暱鍊掕鏃� + 鎶ュ伐鏁伴噺鍙�� - 鍓嶇鑱旇皟鏂规
+
+## 娑夊強椤甸潰
+
+- 宸ュ簭绠＄悊锛坄src/views/mes/pro/process`锛岃〃鍗� `modules/form.vue`锛�
+- 蹇�熸姤宸ワ紙`src/views/mes/pro/workorder-center/modules/quick-feedback.vue`锛�
+- 鎶ュ伐琛ㄥ崟锛坄src/views/mes/pro/feedback/modules/form.vue`锛�
+- 鐢熶骇浠诲姟鐩稿叧灞曠ず锛堝垪琛�/璇︽儏锛屾姤宸ュ�掕鏃剁姸鎬佸睍绀猴級
+
+## 涓氬姟娴佺▼涓庢暟鎹甫鍏�
+
+1. **宸ュ簭涓绘暟鎹厤缃�**锛氬湪宸ュ簭绠＄悊椤甸潰涓哄伐搴忛厤缃�岀瓑寰呮椂闀匡紙灏忔椂锛夈�嶄笌銆屾槸鍚﹂渶瑕佸～鍐欐姤宸ユ暟閲忋�嶄袱涓柊瀛楁銆傚瓧娈典繚瀛樺埌宸ュ簭涓绘暟鎹紙`mes_pro_process`锛夛紝鎵�鏈夊紩鐢ㄨ宸ュ簭鐨勫伐鑹鸿矾绾垮叡鐢ㄣ��
+2. **鎶ュ伐鐣岄潰璇诲彇宸ュ簭閰嶇疆**锛氭姤宸ヨ〃鍗曪紙鏂板/缂栬緫锛夐�夋嫨浠诲姟鍚庯紝閫氳繃 `getRouteProcessByRouteAndProcess(routeId, processId)`锛堢幇鏈夎皟鐢級鎷夊彇宸ュ簭閰嶇疆锛屽搷搴旀柊澧炶繑鍥� `waitDuration`銆乣needReportQuantity`銆�
+   - `waitDuration > 0`锛氳宸ュ簭鎶ュ伐鍓嶅繀椤诲厛鐐瑰嚮銆屽紑濮嬪�掕鏃躲�嶏紝鍊掕鏃剁粨鏉熸墠鑳芥姤宸ャ��
+   - `needReportQuantity = false`锛氭姤宸ユ暟閲忓厑璁镐负绌猴紙涓嶆樉绀烘暟閲忚緭鍏ラ」銆佷笉鍋�"蹇呴』澶т簬 0"鏍￠獙锛夈��
+3. **寮�濮嬪�掕鏃�**锛氭搷浣滃憳鐐瑰嚮銆屽紑濮嬪�掕鏃躲�嶁啋 璋冪敤鏂版帴鍙� `startWaitCountdown` 鈫� 鍚庣鎶婂綋鍓嶆椂闂村啓鍏ヤ换鍔★紙`mes_pro_task.wait_start_time`锛夈��
+4. **浠诲姟鐘舵�佸洖鏄�**锛氫换鍔″垪琛�/璇︽儏鍝嶅簲鏂板 `waitStartTime` 瀛楁锛屽墠绔敤浜庡睍绀哄�掕鏃剁姸鎬侊紙宸插紑濮�/杩涜涓�/宸茬粨鏉燂級銆�
+5. **鎻愪氦鎶ュ伐**锛氭姤宸ユ彁浜わ紙蹇�熸姤宸� / 鎶ュ伐琛ㄥ崟鎻愪氦 / 瀹℃壒閫氳繃锛夋椂锛屽悗绔粺涓�鏍￠獙绛夊緟鏃堕暱涓庢暟閲忚鍒欍��
+
+## API
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| POST | `/mes/pro/task/start-wait-countdown` | 寮�濮嬫姤宸ュ�掕鏃讹紙璁板綍寮�濮嬫椂闂村埌浠诲姟锛� |
+| GET | `/mes/pro/route/process/get-by-route-and-process` | 鐜版湁鎺ュ彛锛屽搷搴旀柊澧� `waitDuration`/`needReportQuantity` |
+
+### 鏂板鎺ュ彛锛氬紑濮嬫姤宸ュ�掕鏃�
+
+**璇锋眰鍙傛暟锛�**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
+|------|------|------|------|
+| taskId | Long | 鏄� | 鐢熶骇浠诲姟缂栧彿锛圥OST body JSON 浼犻�掞級 |
+
+**璇锋眰绀轰緥锛�**
+
+```json
+{
+  "taskId": 35
+}
+```
+
+**鍝嶅簲锛�** 杩斿洖鍊掕鏃跺紑濮嬫椂闂达紙`yyyy-MM-dd HH:mm:ss`锛夈��
+
+**鍝嶅簲绀轰緥锛�**
+
+```json
+{
+  "code": 0,
+  "data": "2026-08-29 10:30:00"
+}
+```
+
+**涓氬姟鍓嶇疆鏍￠獙锛堝悗绔級锛�**
+
+| 鍦烘櫙 | 缁撴灉 |
+|------|------|
+| 浠诲姟涓嶅瓨鍦� / 宸茬粓鎬侊紙瀹屾垚銆佸彇娑堬級 | 鎶ラ敊锛堜换鍔″紓甯革級 |
+| 浠诲姟宸插仠宸� | 鎶ラ敊锛堝仠宸ヤ笉鑳芥姤宸ワ級 |
+| 宸ュ簭鏈厤缃瓑寰呮椂闀匡紙涓虹┖鎴� 0锛� | 鎶ラ敊銆岃宸ュ簭鏈厤缃瓑寰呮椂闀匡紝鏃犻渶鍊掕鏃躲�� |
+| 宸ュ簭宸查厤缃瓑寰呮椂闀� | 鎴愬姛锛岃褰曞紑濮嬫椂闂达紱閲嶅鐐瑰嚮浼氶噸缃负褰撳墠鏃堕棿 |
+
+### 鐜版湁鎺ュ彛鍝嶅簲瀛楁鏂板
+
+**`get-by-route-and-process` 鍝嶅簲鏂板瀛楁锛�**
+
+| 瀛楁 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| waitDuration | BigDecimal | 绛夊緟鏃堕暱锛堝皬鏃讹級銆�>0 琛ㄧず鎶ュ伐鍓嶉渶鍊掕鏃剁瓑寰� |
+| needReportQuantity | Boolean | 鏄惁闇�瑕佸～鍐欐姤宸ユ暟閲忋�俙false`=鎶ュ伐鏁伴噺鍏佽涓虹┖ |
+
+**鐢熶骇浠诲姟鐩稿叧鍝嶅簲鏂板瀛楁锛堝垪琛�/璇︽儏/浠诲姟閫夋嫨缁勪欢锛夛細**
+
+| 瀛楁 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| waitStartTime | LocalDateTime | 鎶ュ伐鍊掕鏃跺紑濮嬫椂闂淬�備负绌鸿〃绀哄皻鏈紑濮嬪�掕鏃� |
+
+**宸ュ簭涓绘暟鎹繚瀛�/鍝嶅簲鏂板瀛楁锛�**
+
+| 瀛楁 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| waitDuration | BigDecimal | 绛夊緟鏃堕暱锛堝皬鏃讹級锛屾姤宸ュ墠闇�鍊掕鏃剁瓑寰� |
+| needReportQuantity | Boolean | 鏄惁闇�瑕佸～鍐欐姤宸ユ暟閲� |
+
+## 瀛楁灞曠ず瑙勫垯
+
+| 瀛楁 | 灞曠ず浣嶇疆 | 璇存槑 |
+|------|----------|------|
+| 绛夊緟鏃堕暱锛堝皬鏃讹級 | 宸ュ簭绠＄悊琛ㄥ崟 | 鏁板瓧杈撳叆锛屽皬鏁版渶澶� 2 浣嶏紱鐣欑┖/0 琛ㄧず璇ュ伐搴忔姤宸ユ棤闇�鍊掕鏃� |
+| 鏄惁闇�瑕佸～鍐欐姤宸ユ暟閲� | 宸ュ簭绠＄悊琛ㄥ崟 | 寮�鍏炽�傚叧闂悗璇ュ伐搴忔姤宸ユ暟閲忓厑璁镐负绌� |
+| 寰呮姤宸ユ暟閲� | 蹇�熸姤宸� / 鎶ュ伐琛ㄥ崟 | 鐜版湁瀛楁銆傝嫢宸ュ簭鏃犻渶濉啓鏁伴噺锛屾姤宸ユ暟閲忚緭鍏ラ」鍙笉鏄剧ず |
+| 鏈鎶ュ伐鏁伴噺 | 蹇�熸姤宸� / 鎶ュ伐琛ㄥ崟 | 鎸夊伐搴忛厤缃喅瀹氭槸鍚﹀繀濉�/鍙┖ |
+| 寮�濮嬪�掕鏃� 鎸夐挳 + 鍊掕鏃跺墿浣欐椂闂� | 蹇�熸姤宸� / 鎶ュ伐琛ㄥ崟 | 宸ュ簭閰嶇疆绛夊緟鏃堕暱鏃跺睍绀猴紱鐐瑰嚮鍚庡睍绀哄�掕鏃跺墿浣欐椂闂� |
+| 鍊掕鏃剁姸鎬� | 鐢熶骇浠诲姟鍒楄〃/璇︽儏锛堝彲閫夛級 | 渚濇嵁 `waitStartTime` 涓庡綋鍓嶆椂闂磋绠楀墿浣欐椂闂� |
+
+## 涓氬姟瑙勫垯璇存槑
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| 宸ュ簭 `waitDuration` 涓虹┖鎴� 0 | 鎶ュ伐鏃犻渶鍊掕鏃讹紝鍘熸祦绋嬩笉鍙� |
+| 宸ュ簭 `waitDuration > 0`锛屼换鍔℃湭鐐广�屽紑濮嬪�掕鏃躲�� | 鎶ュ伐鎶ラ敊銆岃宸ュ簭璁剧疆浜嗙瓑寰呮椂闀匡紝璇峰厛鐐瑰嚮"寮�濮嬪�掕鏃�"銆� |
+| 宸ュ簭 `waitDuration > 0`锛屽�掕鏃舵湭缁撴潫 | 鎶ュ伐鎶ラ敊銆岀瓑寰呭�掕鏃舵湭缁撴潫锛岃繕闇�绛夊緟 X灏忔椂X鍒嗛挓銆� |
+| 宸ュ簭 `waitDuration > 0`锛屽�掕鏃跺凡缁撴潫 | 鍙甯告姤宸ワ紱寮�濮嬫椂闂磋褰曞湪浠诲姟涓婏紝姣忎换鍔′竴娆� |
+| 閲嶅鐐瑰嚮銆屽紑濮嬪�掕鏃躲�� | 閲嶇疆寮�濮嬫椂闂翠负褰撳墠鏃堕棿 |
+| 宸ュ簭 `needReportQuantity = true` 鎴栨湭閰嶇疆 | 鎶ュ伐鏁伴噺蹇呴』 > 0锛堝師閫昏緫锛� |
+| 宸ュ簭 `needReportQuantity = false` | 鎶ュ伐鏁伴噺鍏佽涓虹┖/0锛涘悗绔烦杩囨暟閲忔牎楠岋紝瀹℃壒鏃朵笉鐢熸垚浜у嚭鍗�/鎵规锛屼笉鎵ｅ�掑啿鐗╂枡锛屼粎瀹屾垚鎶ュ伐 |
+| 鍊掕鏃堕�傜敤鑼冨洿 | 鎸夊伐搴忓垽鏂紝寮�濮嬫椂闂磋褰曞埌鐢熶骇浠诲姟锛屾瘡浠诲姟涓�娆� |
+
+## 娉ㄦ剰浜嬮」
+
+- 绛夊緟鏃堕暱鍗曚綅鍥哄畾涓�**灏忔椂**锛屽墠绔緭鍏ユ椂娉ㄦ剰鍗曚綅鎻愮ず锛堢ず渚� `2.00` 琛ㄧず 2 灏忔椂锛沗0.5` 琛ㄧず 30 鍒嗛挓锛夈��
+- 鍊掕鏃跺紑濮嬫椂闂磋褰曞湪**鐢熶骇浠诲姟**涓婏紝涓庡伐搴忕瓑寰呮椂闀匡紙涓绘暟鎹級鍒嗗紑缁存姢锛涗慨鏀瑰伐搴忕瓑寰呮椂闀夸笉褰卞搷宸插紑濮嬬殑浠诲姟鍊掕鏃躲��
+- 鑻ュ伐搴忛厤缃簡绛夊緟鏃堕暱浣嗕换鍔℃湭寮�濮嬪�掕鏃讹紝鐩存帴鎻愪氦鎶ュ伐浼氳鍚庣鎷︽埅锛堝垱寤恒�佸揩閫熸姤宸ャ�佸鎵归�氳繃涓夊鍏ュ彛閮芥牎楠岋級銆�
+- 蹇�熸姤宸ュ綋鍓嶄负鏁伴噺蹇呭～锛屾帴鍏ュ悗闇�鎸� `needReportQuantity` 璋冩暣銆岃杈撳叆鎶ュ伐鏁伴噺銆嶇殑蹇呭～鏍￠獙涓庢暟閲忚緭鍏ユ灞曠ず銆�
+- 鎶ュ伐鏁伴噺涓虹┖/0 鐨勬姤宸ワ細涓嶄細鐢熸垚浜у嚭鍗�/鎵规銆佷笉浼氬�掑啿鎵ｆ枡锛屼粎鎶婃姤宸ユ爣璁颁负宸插畬鎴愬苟鏇存柊浠诲姟杩涘害锛涜鍦ㄥ墠绔浉搴旈殣钘忔暟閲忕浉鍏冲睍绀猴紝閬垮厤璇銆�
+- 鎶ュ伐琛ㄥ崟缂栬緫/瀹℃壒鏃朵换鍔″彲鑳藉凡杩囩瓑寰呮湡锛屾鏃舵棤闇�鍐嶅�掕鏃跺嵆鍙彁浜ゃ��
diff --git a/docs/process_feedback_wait_countdown_remind_integration.md b/docs/process_feedback_wait_countdown_remind_integration.md
new file mode 100644
index 0000000..847113e
--- /dev/null
+++ b/docs/process_feedback_wait_countdown_remind_integration.md
@@ -0,0 +1,47 @@
+# 鎶ュ伐鍊掕鏃剁郴缁熸秷鎭彁閱掞紙10鍒嗛挓 / 5鍒嗛挓 / 缁撴潫锛� - 鍓嶇鑱旇皟鏂规
+
+## 娑夊強椤甸潰
+
+- 鏃犲墠绔〉闈㈡敼鍔ㄣ�傛彁閱掔敱**鍚庣瀹氭椂浠诲姟**鑷姩鍙戦�佸埌**绯荤粺绔欏唴淇★紙娑堟伅涓績锛�**锛屾搷浣滃憳鍦ㄧ珯鍐呬俊鍒楄〃鏌ョ湅鍗冲彲銆�
+
+## 璇存槑
+
+鎶ュ伐鍊掕鏃惰缃郴缁熸秷鎭彁閱掞紝鍒嗕笁涓瓑绾ц嚜鍔ㄥ彂閫佺珯鍐呬俊锛�
+
+| 绛夌骇 | 瑙﹀彂鏃舵満 | 绔欏唴淇℃ā鏉� code |
+|------|----------|-----------------|
+| 1 | 鍊掕鏃跺墿浣� 鈮� 10 鍒嗛挓 | `mes_task_wait_remind_10` |
+| 2 | 鍊掕鏃跺墿浣� 鈮� 5 鍒嗛挓 | `mes_task_wait_remind_5` |
+| 3 | 鍊掕鏃剁粨鏉燂紙鍓╀綑 鈮� 0锛� | `mes_task_wait_remind_end` |
+
+鍚庣鏂板瀹氭椂浠诲姟锛�**姣忓垎閽熸壂鎻忎竴娆�**鎵�鏈夊凡寮�濮嬪�掕鏃讹紙`waitStartTime` 闈炵┖锛変笖鏈粓鎬併�佹湭鍋滃伐鐨勬姤宸ヤ换鍔★紝鍒拌揪瀵瑰簲鏃堕棿鐐硅嚜鍔ㄥ彂閫佺珯鍐呬俊銆�
+
+## 绔欏唴淇″唴瀹�
+
+| 妯℃澘 code | 鍐呭绀轰緥 |
+|-----------|----------|
+| `mes_task_wait_remind_10` | 鐢熶骇浠诲姟銆恵taskCode}銆憑taskName} 鎶ュ伐鍊掕鏃跺墿浣� 10 鍒嗛挓锛岃鍑嗗鎶ュ伐銆� |
+| `mes_task_wait_remind_5` | 鐢熶骇浠诲姟銆恵taskCode}銆憑taskName} 鎶ュ伐鍊掕鏃跺墿浣� 5 鍒嗛挓锛屽嵆灏嗗彲浠ユ姤宸ャ�� |
+| `mes_task_wait_remind_end` | 鐢熶骇浠诲姟銆恵taskCode}銆憑taskName} 鎶ュ伐鍊掕鏃跺凡缁撴潫锛屽彲浠ヨ繘琛屾姤宸ャ�� |
+
+鍗犱綅绗︼細`taskCode`锛堜换鍔＄紪鐮侊級銆乣taskName`锛堜换鍔″悕绉帮級銆乣processName`锛堝伐搴忓悕绉帮級銆�
+
+## 鎺ユ敹浜�
+
+1. **浼樺厛**锛氫换鍔℃寚瀹氱殑鎶ュ伐浜哄憳锛坄mes_pro_task_assignee`锛夛紝鍏ㄩ儴鍙戦�併��
+2. **鍏滃簳**锛氫换鍔℃湭鎸囧畾鎶ュ伐浜哄憳鏃讹紝鍙戠粰浠诲姟鍒涘缓浜恒��
+
+## 涓氬姟瑙勫垯璇存槑
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| 宸ュ簭绛夊緟鏃堕暱涓嶈冻 10 鍒嗛挓锛堝 5 鍒嗛挓锛� | 寮�濮嬪�掕鏃跺悗绔嬪嵆瑙﹀彂"10 鍒嗛挓"涓�"5 鍒嗛挓"鎻愰啋锛堝墿浣欎笉瓒冲嵆鎻愰啋锛� |
+| 閲嶅鐐瑰嚮"寮�濮嬪�掕鏃�"閲嶇疆鏃堕棿 | 鎻愰啋鎸夋柊鐨勫紑濮嬫椂闂撮噸鏂拌绠楋紝閲嶆柊瑙﹀彂涓�杞彁閱� |
+| 浠诲姟宸插畬鎴� / 宸插彇娑� / 宸插仠宸� | 涓嶅啀鎵弿鎻愰啋 |
+| 鍚屼竴绛夌骇鍚屼竴杞�掕鏃� | 鍙彁閱掍竴娆★紙Redis 鍘婚噸锛�24 灏忔椂锛� |
+
+## 娉ㄦ剰浜嬮」
+
+- 鎻愰啋涓�**绯荤粺绔欏唴淇�**锛屾搷浣滃憳鍦ㄧ郴缁熸秷鎭腑蹇冩煡鐪嬶紝鏃犲脊绐�/鏃犲墠绔帴鍙ｈ皟鐢ㄣ��
+- 绔欏唴淇℃ā鏉垮彲鍦ㄣ�岀郴缁熺鐞� 鈫� 绔欏唴淇℃ā鏉裤�嶄腑鎸� code 鏌ョ湅/淇敼鍐呭銆�
+- 璇ュ姛鑳戒负鏂板锛屼笉褰卞搷鍘熸湁鎶ュ伐鍊掕鏃舵姤宸ユ牎楠岄�昏緫銆�
diff --git a/docs/product_receipt_auto_stock_integration.md b/docs/product_receipt_auto_stock_integration.md
new file mode 100644
index 0000000..c5e079c
--- /dev/null
+++ b/docs/product_receipt_auto_stock_integration.md
@@ -0,0 +1,111 @@
+# 鎶ュ伐鑷姩鐢熸垚浜у搧鍏ュ簱鍗� + 鍕鹃�夊叆搴� + 涓嶅悎鏍间粨搴撳厹搴� - 鍓嶇鑱旇皟鏂规
+
+## 娑夊強椤甸潰
+
+- 浜у搧鍏ュ簱锛坄src/views/wls/productreceipt`锛屽垪琛� `index.vue` + 琛ㄥ崟 `modules/form.vue`銆佽 `modules/line-list.vue`銆佷笂鏋舵槑缁� `modules/detail-form.vue`锛�
+- 鎶ュ伐瀹℃壒锛堜粎鏁版嵁鏉ユ簮锛屾棤闇�鏀瑰姩锛屽鎵归�氳繃鍚庤嚜鍔ㄧ敓鎴愬叆搴撳崟锛�
+
+## 涓氬姟娴佺▼涓庢暟鎹甫鍏�
+
+1. **鎶ュ伐瀹℃壒 鈫� 鑷姩鐢熸垚鍏ュ簱鍗�**锛氭姤宸ュ鎵归�氳繃鍚庯紝鍚庣鑷姩鐢熸垚涓�鏉′骇鍝佸叆搴撳崟锛坄mes_wm_product_receipt`锛夛紝涓�娆℃姤宸�=涓�鏉″叆搴撳崟锛堝箓绛夛級銆�
+2. **琛� = 浜у嚭琛�**锛氬叆搴撳崟琛屾潵鑷敓浜у叆搴撳崟浜у嚭琛岋紙`mes_wm_product_produce_line`锛夛紝鎸夊悎鏍�/涓嶅悎鏍煎垎琛岋紝姣忚鑷姩甯﹀叆 `itemId`銆乣quantity`锛堜骇鍑烘暟閲忥級銆乣batchId/batchCode`銆乣qualityStatus`锛堣川閲忕姸鎬佸悎鏍�/涓嶅悎鏍硷級锛岄粯璁� `isStock=false`锛堟湭鍕鹃�夊叆搴擄級銆�
+3. **涓�涓暟閲忎竴琛�**锛氫骇鍝佸叆搴撻〉琛ㄦ牸鎸�"涓�琛�=涓�涓暟閲�"灞曠ず锛岃鍗虫湰娆℃姤宸ョ殑涓�涓骇鍑烘暟閲忥紙鍚堟牸琛�/涓嶅悎鏍艰鍚勪竴鏉★級銆�
+4. **鎵ц鍏ュ簱鍓嶅嬀閫�**锛氬湪銆屽緟涓婃灦銆嶇姸鎬佺殑鍏ュ簱鍗曚笂锛屾瘡琛屽嬀閫�"鏄惁鍏ュ簱"锛涘嬀閫夊叆搴撶殑琛屽睍寮�涓夌骇锛堜粨搴撯啋搴撳尯鈫掑簱浣嶏級澶氶�夊苟鍒嗛厤鏁伴噺銆�
+5. **鎵ц涓婃灦淇濆瓨**锛氳皟鐢ㄦ柊鎺ュ彛 `submit-stock` 淇濆瓨姣忚鐨勫嬀閫夌姸鎬佷笌浠撳簱/搴撳尯/搴撲綅鍒嗛厤銆�
+6. **鎵ц鍏ュ簱鍏滃簳**锛氭墽琛屽叆搴撴椂锛屾湭鍕鹃�夊叆搴撶殑琛屾垨鍒嗛厤鏁伴噺涓嶈冻鐨勮锛屽墿浣欐暟閲忚嚜鍔ㄨ繘銆屼笉鍚堟牸浠撳簱銆嶏紙涓夌骇锛欴EFECT_WAREHOUSE / DEFECT_LOCATION / DEFECT_AREA锛夛紝姣忎釜鏁伴噺鐢熸垚涓�鏉℃祦姘达紙鍑鸿櫄鎷熺嚎杈瑰簱 + 鍏ュ疄闄�/涓嶅悎鏍间粨搴擄級銆�
+
+## API
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| POST | `/mes/wm/product-receipt/submit-stock` | 鎵归噺涓婃灦锛堝嬀閫夋槸鍚﹀叆搴� + 浠撳簱/搴撳尯/搴撲綅鍒嗛厤鏁伴噺锛夛紝鏂板 |
+| PUT | `/mes/wm/product-receipt/submit` | 鎻愪氦锛堣崏绋� 鈫� 寰呬笂鏋讹級锛岀幇鏈� |
+| PUT | `/mes/wm/product-receipt/stock` | 鎵ц涓婃灦锛堝緟涓婃灦 鈫� 寰呮墽琛屽叆搴擄級锛岀幇鏈� |
+| PUT | `/mes/wm/product-receipt/finish` | 鎵ц鍏ュ簱锛堝緟鎵ц鍏ュ簱 鈫� 宸插畬鎴愶級锛岀幇鏈� |
+
+### 鏂板鎺ュ彛锛氭壒閲忎笂鏋�
+
+**璇锋眰鍙傛暟锛坄submit-stock`锛夛細**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
+|------|------|------|------|
+| receiptId | Long | 鏄� | 浜у搧鍏ュ簱鍗曠紪鍙� |
+| rows | List\<Row\> | 鏄� | 琛屼笂鏋跺垪琛� |
+| rows[].lineId | Long | 鏄� | 鍏ュ簱鍗曡缂栧彿 |
+| rows[].isStock | Boolean | 鏄� | 鏄惁鍏ュ簱锛坱rue=鍕鹃�夊叆搴撳苟鍒嗛厤浠撳簱/搴撲綅锛沠alse=鎵ц鍏ュ簱鏃惰嚜鍔ㄨ繘涓嶅悎鏍间粨搴擄級 |
+| rows[].details | List\<Detail\> | 鏉′欢 | isStock=true 鏃跺繀椤伙紱姣忎釜鍒嗛厤涓�鏉★紝鏁伴噺涔嬪拰=琛屾敹璐ф暟閲� |
+| details[].warehouseId | Long | 鏄� | 浠撳簱缂栧彿 |
+| details[].locationId | Long | 鏄� | 搴撳尯缂栧彿 |
+| details[].areaId | Long | 鏄� | 搴撲綅缂栧彿 |
+| details[].quantity | BigDecimal | 鏄� | 鍒嗛厤鏁伴噺 |
+
+**璇锋眰绀轰緥锛�**
+
+```json
+{
+  "receiptId": 1,
+  "rows": [
+    {
+      "lineId": 11,
+      "isStock": true,
+      "details": [
+        { "warehouseId": 1, "locationId": 1, "areaId": 1, "quantity": 60 },
+        { "warehouseId": 1, "locationId": 2, "areaId": 2, "quantity": 40 }
+      ]
+    },
+    {
+      "lineId": 12,
+      "isStock": false
+    }
+  ]
+}
+```
+
+**鍝嶅簲锛�** `{ "code": 0, "data": true }`
+
+### 鐜版湁鎺ュ彛鍝嶅簲瀛楁鏂板
+
+**浜у搧鍏ュ簱鍗曡鎯�/鍒嗛〉鍝嶅簲锛圧espVO锛夋柊澧烇細**
+
+| 瀛楁 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| feedbackId | Long | 鏉ユ簮鎶ュ伐缂栧彿銆傞潪绌鸿〃绀虹敱鎶ュ伐鑷姩鐢熸垚锛屼笉鍙墜宸ユ敼琛� |
+
+**浜у搧鍏ュ簱鍗曡鍝嶅簲锛圠ineRespVO锛夋柊澧烇細**
+
+| 瀛楁 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| qualityStatus | Integer | 璐ㄩ噺鐘舵�併�傚瓧鍏� `MES_WM_QUALITY_STATUS`锛堝悎鏍�/涓嶅悎鏍硷級锛岃嚜鍔ㄧ敓鎴愮殑鍏ュ簱鍗曡甯﹀叆 |
+| isStock | Boolean | 鏄惁鍏ュ簱锛坒alse/绌�=鎵ц鍏ュ簱鏃堕粯璁よ繘涓嶅悎鏍间粨搴擄級 |
+
+## 瀛楁灞曠ず瑙勫垯
+
+| 瀛楁 | 灞曠ず浣嶇疆 | 璇存槑 |
+|------|----------|------|
+| 鎶ュ伐鏉ユ簮 | 鍒楄〃 | 鏈� `feedbackId` 鐨勫叆搴撳崟鍙睍绀�"鑷姩鐢熸垚"鏍囪瘑 |
+| 璐ㄩ噺鐘舵�� | 琛岃〃鏍� | 灞曠ず鍚堟牸/涓嶅悎鏍硷紝鏉ヨ嚜浜у嚭 |
+| 鏄惁鍏ュ簱 | 琛岃〃鏍� | 姣忚涓�涓嬀閫夛紙浠呭緟涓婃灦鐘舵�佸彲鏀癸級锛涘嬀閫夊悗灞曞紑浠撳簱/搴撳尯/搴撲綅鍒嗛厤 |
+| 浠撳簱/搴撳尯/搴撲綅 | 琛屽睍寮�鏄庣粏 | 涓夌骇绾ц仈閫夋嫨锛屽彲澶氶�夛紱姣忔潯鏄庣粏涓�涓暟閲� |
+| 鍒嗛厤鏁伴噺 | 琛屽睍寮�鏄庣粏 | 鍕鹃�夊叆搴撶殑琛岃姹傚垎閰嶆暟閲忎箣鍜� = 琛屾敹璐ф暟閲� |
+| 鍓╀綑鏁伴噺 | 琛屽睍寮�鏄庣粏 | 琛屾敹璐ф暟閲� - 宸插垎閰嶆暟閲忥紱鎵ц鍏ュ簱鏃跺墿浣欒嚜鍔ㄨ繘涓嶅悎鏍间粨搴� |
+
+## 涓氬姟瑙勫垯璇存槑
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| 鎶ュ伐瀹℃壒閫氳繃锛堟棤璐ㄦ锛� | 鑷姩鐢熸垚鍏ュ簱鍗曪紝琛�=鍚堟牸/涓嶅悎鏍间骇鍑鸿锛岀姸鎬�=鑽夌 |
+| 鎶ュ伐瀹℃壒閫氳繃锛堣川妫�锛孖PQC 瀹屾垚鍚庯級 | 鑷姩鐢熸垚鍏ュ簱鍗曪紝琛�=鍚堟牸/涓嶅悎鏍兼媶鍒嗚 |
+| 閲嶅瑙﹀彂鍚屼竴鎶ュ伐 | 骞傜瓑锛氬凡瀛樺湪鍒欎笉鍐嶇敓鎴愮浜屾潯 |
+| isStock=false 鎴栨湭鍒嗛厤瀹� | 鎵ц鍏ュ簱鏃跺墿浣欐暟閲忚嚜鍔ㄨ繘涓嶅悎鏍间粨搴� |
+| isStock=true 浣嗗垎閰嶆暟閲忎箣鍜� 鈮� 琛屾敹璐ф暟閲� | 鎶ラ敊銆屽嬀閫夊叆搴撶殑鍒嗛厤鏁伴噺涓庤鏀惰揣鏁伴噺涓嶄竴鑷淬�� |
+| 涓嶅悎鏍间粨搴撴湭閰嶇疆 | 鎵ц鍏ュ簱鎶ラ敊銆屾湭閰嶇疆涓嶅悎鏍间粨搴擄紝璇峰厛鍒涘缓 DEFECT_WAREHOUSE 浠撳簱銆� |
+| 鎵ц鍏ュ簱 | 姣忔潯鏄庣粏鐢熸垚涓�鏉℃祦姘达紙鍑鸿櫄鎷熺嚎杈瑰簱 + 鍏ュ疄闄�/涓嶅悎鏍间粨搴擄級锛屼竴涓暟閲�=涓�鏉℃祦姘� |
+| 鑷姩鐢熸垚鐨勫叆搴撳崟 | 琛屼笉鍙墜宸ュ鍒犳敼锛堝彲鏁村崟鍙栨秷锛夛紱鎵嬪伐鍒涘缓鐨勫叆搴撳崟涓嶅彈褰卞搷 |
+
+## 娉ㄦ剰浜嬮」
+
+- 寰呬笂鏋剁姸鎬佹墠鍏佽鍕鹃��"鏄惁鍏ュ簱"涓庡垎閰嶄粨搴�/搴撲綅锛涙墽琛屼笂鏋朵繚瀛樺悗鐘舵�佸彉涓哄緟鎵ц鍏ュ簱銆�
+- 鍕鹃�夊叆搴撶殑琛屽繀椤诲垎閰嶅畬鏁存暟閲忥紱鍙垎閰嶄竴閮ㄥ垎鏃讹紝鍓╀綑閮ㄥ垎鎵ц鍏ュ簱浠嶄細杩涗笉鍚堟牸浠撳簱銆�
+- 涓嶅悎鏍兼暟閲忛粯璁や笉鍕鹃�夊叆搴擄紙杩涗笉鍚堟牸浠撳簱锛夛紱鍚堟牸鏁伴噺鐢辨搷浣滃憳鍐冲畾鏄惁鍏ュ簱鍙婂叆鍝釜浠撳簱銆�
+- 鑷姩鐢熸垚鐨勫叆搴撳崟 `qualityStatus` 鐢变骇鍑鸿甯﹀叆锛岃鏈韩涓嶅彲淇敼锛涘闇�璋冩暣鍏ュ簱鍘诲悜锛岄�氳繃鍕鹃�変笌鍒嗛厤瀹炵幇銆�
+- 鍏ュ簱娴佹按浠�"鏁伴噺"涓哄崟浣嶏細鍚屼竴琛屽垎鍒颁笉鍚屼粨搴�/搴撲綅锛屼竴鏉℃槑缁嗗搴斾竴鏉� OUT锛堣櫄鎷熺嚎杈瑰簱锛�+ IN锛堝疄闄呬粨搴擄級娴佹按銆�

--
Gitblit v1.9.3