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 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 116 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 鐨勬姤宸ワ細涓嶄細鐢熸垚浜у嚭鍗�/鎵规銆佷笉浼氬�掑啿鎵ｆ枡锛屼粎鎶婃姤宸ユ爣璁颁负宸插畬鎴愬苟鏇存柊浠诲姟杩涘害锛涜鍦ㄥ墠绔浉搴旈殣钘忔暟閲忕浉鍏冲睍绀猴紝閬垮厤璇銆�
+- 鎶ュ伐琛ㄥ崟缂栬緫/瀹℃壒鏃朵换鍔″彲鑳藉凡杩囩瓑寰呮湡锛屾鏃舵棤闇�鍐嶅�掕鏃跺嵆鍙彁浜ゃ��
--
Gitblit v1.9.3