From 6d15d7a800fcf4e074ba9918de05408b2c393967 Mon Sep 17 00:00:00 2001
From: 云 <2163098428@qq.com>
Date: 星期一, 07 九月 2026 16:11:25 +0800
Subject: [PATCH] docs(qc): 更新质检功能前端联调文档

---
 docs/qc_template_option_selection.md |  100 +++++++++++++++++++++++++++++++++
 docs/qc_export_integration.md        |   71 +++++++++++++++++++++++
 2 files changed, 171 insertions(+), 0 deletions(-)

diff --git a/docs/qc_export_integration.md b/docs/qc_export_integration.md
new file mode 100644
index 0000000..ecd4373
--- /dev/null
+++ b/docs/qc_export_integration.md
@@ -0,0 +1,71 @@
+# 璐ㄦ瀵煎嚭鍔熻兘澧炲己 - 鍓嶇鑱旇皟鏂规
+
+## 娑夊強椤甸潰
+
+- 鏉ユ枡妫�楠屽崟锛圛QC锛夊垪琛ㄩ〉
+- 杩囩▼妫�楠屽崟锛圛PQC锛夊垪琛ㄩ〉
+- 鍑鸿揣妫�楠屽崟锛圤QC锛夊垪琛ㄩ〉
+- 閫�璐ф楠屽崟锛圧QC锛夊垪琛ㄩ〉
+
+浠ヤ笂鍥涗釜椤甸潰鐨勩�屽鍑恒�嶅姛鑳藉潎闇�璋冩暣銆�
+
+## 鍙樻洿姒傝
+
+1. **瀵煎嚭 Excel 鏂板銆屾楠岄」鎸囨爣銆嶅垪**锛氬睍绀鸿妫�楠屽崟鎵�鏈夋楠岄」鐨勭粨鏋滄眹鎬汇��
+2. **瀵煎嚭鏀寔鎸夋娴嬫椂闂磋寖鍥寸瓫閫�**锛氱敤鎴烽�夋嫨鏃堕棿鑼冨洿鍚庯紝鍙鍑烘娴嬫棩鏈熻惤鍦ㄨ寖鍥村唴鐨勬楠屽崟銆�
+
+## 涓氬姟娴佺▼涓庢暟鎹甫鍏�
+
+1. 鐢ㄦ埛鍦ㄥ垪琛ㄩ〉璁剧疆绛涢�夋潯浠讹紙鍚柊澧炵殑銆屾娴嬫椂闂磋寖鍥淬�嶏級鈫� 鐐瑰嚮銆屽鍑恒�嶃��
+2. 瀵煎嚭鎺ュ彛浠ュ綋鍓嶇瓫閫夋潯浠讹紙涓庡垎椤垫煡璇㈢浉鍚岀殑绛涢�夊弬鏁帮級鎷夊彇鍏ㄩ儴鏁版嵁锛岀敓鎴� Excel 涓嬭浇銆�
+3. 涓嶉�夋嫨鏃堕棿鑼冨洿鏃讹紝瀵煎嚭琛屼负涓庢敼鍔ㄥ墠涓�鑷达紙瀵煎嚭鍏ㄩ儴绗﹀悎鍏跺畠绛涢�夋潯浠剁殑鏁版嵁锛夈��
+
+## API
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| GET | /mes/qc/iqc/export-excel | 瀵煎嚭鏉ユ枡妫�楠屽崟 |
+| GET | /mes/qc/ipqc/export-excel | 瀵煎嚭杩囩▼妫�楠屽崟 |
+| GET | /mes/qc/oqc/export-excel | 瀵煎嚭鍑鸿揣妫�楠屽崟 |
+| GET | /mes/qc/rqc/export-excel | 瀵煎嚭閫�璐ф楠屽崟 |
+
+**鏂板璇锋眰鍙傛暟锛堝洓涓帴鍙ｄ竴鑷达級锛�**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
+|------|------|------|------|
+| inspectDate[0] | String | 鍚� | 妫�娴嬪紑濮嬫椂闂达紝鏍煎紡 yyyy-MM-dd HH:mm:ss |
+| inspectDate[1] | String | 鍚� | 妫�娴嬬粨鏉熸椂闂达紝鏍煎紡 yyyy-MM-dd HH:mm:ss |
+
+璇存槑锛氭鍙傛暟涓虹瓫閫夋潯浠讹紝涓庡垎椤垫煡璇� `GET /mes/qc/xxx/page` 鐨勪紶鍙傛柟寮忓畬鍏ㄤ竴鑷达紝鍓嶇鍒嗛〉涓庡鍑哄彲澶嶇敤鍚屼竴濂楁煡璇㈠弬鏁板璞°��
+
+**瀵煎嚭 Excel 鏂板鍒楋細**
+
+| 鍒楀悕 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| 妫�楠岄」鎸囨爣 | String | 鏍煎紡锛氭寚鏍囧悕绉�:妫�娴嬪�� 鎴� 鎸囨爣鍚嶇О:妫�娴嬪��(澶囨敞)锛屽涓寚鏍囩敤閫楀彿鍒嗛殧锛屼緥濡� `澶栬:鑹ソ(OK), 灏哄:100.00mm(OK)`锛涙棤妫�楠岀粨鏋滄椂涓虹┖ |
+
+## 瀛楁灞曠ず瑙勫垯
+
+| 瀛楁 | 灞曠ず浣嶇疆 | 璇存槑 |
+|------|----------|------|
+| 妫�楠岄」鎸囨爣 | Excel銆屾楠岄」鎸囨爣銆嶅垪 | 鐢辩郴缁熻嚜鍔ㄦ嫾鎺ワ紝鍓嶇鏃犻渶澶勭悊鏍煎紡 |
+| 妫�娴嬫椂闂磋寖鍥� | 鍒楄〃椤电瓫閫夊尯 | 鏂板鏃堕棿鑼冨洿閫夋嫨鎺т欢锛屽缓璁笌鐜版湁銆屾娴嬫棩鏈熴�嶅垪瀵瑰簲 |
+
+## 涓氬姟瑙勫垯璇存槑
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| 鏈�夋嫨鏃堕棿鑼冨洿 | 瀵煎嚭鍏ㄩ儴鏁版嵁锛堜笌鏀瑰姩鍓嶄竴鑷达級 |
+| 浠呴�夋嫨寮�濮嬫椂闂� | 瀵煎嚭妫�娴嬫棩鏈熷ぇ浜庣瓑浜庡紑濮嬫椂闂寸殑璁板綍 |
+| 浠呴�夋嫨缁撴潫鏃堕棿 | 瀵煎嚭妫�娴嬫棩鏈熷皬浜庣瓑浜庣粨鏉熸椂闂寸殑璁板綍 |
+| 閫夋嫨瀹屾暣鑼冨洿 | 瀵煎嚭妫�娴嬫棩鏈熷湪闂尯闂� [寮�濮�, 缁撴潫] 鍐呯殑璁板綍 |
+| 鏃犳楠岀粨鏋� | 銆屾楠岄」鎸囨爣銆嶅垪瀵煎嚭涓虹┖ |
+| 杩囨护瀛楁 | 鏃堕棿鑼冨洿閽堝鍚勬楠屽崟鐨勩�屾娴嬫棩鏈熴�嶅瓧娈佃繃婊� |
+| 瀵煎嚭鏉冮檺 | 浠嶅彈鍚勯〉闈㈠師鏈� `export` 鏉冮檺鎺у埗锛孫QC 瀵煎嚭淇濈暀瀹㈡埛鏁版嵁鏉冮檺杩囨护 |
+
+## 娉ㄦ剰浜嬮」
+
+- 鍒嗛〉鍜屽鍑哄叡鐢ㄥ悓涓�濂楃瓫閫夊弬鏁帮紝鍓嶇瀵煎嚭鏃跺簲鎶婂綋鍓嶇瓫閫夋潯浠讹紙鍚椂闂磋寖鍥达級涓�骞朵綔涓鸿姹傚弬鏁颁紶閫掋��
+- 鏃堕棿鎺т欢鏍煎紡蹇呴』涓� `yyyy-MM-dd HH:mm:ss`锛屽惁鍒欏悗绔棤娉曡В鏋愩��
+- 鍥涗釜椤甸潰鍚勮嚜璋冪敤瀵瑰簲鐨勫鍑烘帴鍙ｏ紝鍙傛暟鍚嶅畬鍏ㄧ浉鍚岋紝鍙鐢ㄥ悓涓�瀵煎嚭鍑芥暟銆�
+- 鑻ュ悗缁渶瑕佹寜銆屽垱寤烘椂闂淬�嶇瓑鍏跺畠鏃堕棿缁村害绛涢�夛紝鍙彟琛屾墿灞曪紝鏈浠呮敮鎸佹娴嬫椂闂淬��
\ No newline at end of file
diff --git a/docs/qc_template_option_selection.md b/docs/qc_template_option_selection.md
new file mode 100644
index 0000000..c8772fd
--- /dev/null
+++ b/docs/qc_template_option_selection.md
@@ -0,0 +1,100 @@
+# 璐ㄦ妫�楠屽崟鎵嬪姩閫夋嫨璐ㄦ鏂规 - 鍓嶇鑱旇皟鏂规
+
+## 娑夊強椤甸潰
+
+- 鏉ユ枡妫�楠岋紙IQC锛夋柊寤鸿〃鍗�
+- 杩囩▼妫�楠岋紙IPQC锛夋柊寤鸿〃鍗�
+- 鍑鸿揣妫�楠岋紙OQC锛夋柊寤鸿〃鍗�
+- 閫�璐ф楠岋紙RQC锛夋柊寤鸿〃鍗�
+
+## 鑳屾櫙
+
+涓�涓骇鍝佸彲鍦� `mes_qc_template_item` 鍏宠仈澶氫釜璐ㄦ鏂规锛坄mes_qc_template`锛夈�傛鍓嶅悗绔懡涓涓柟妗堟椂闈欓粯鍙栫涓�涓紝鐢ㄦ埛鏃犳硶鎺у埗銆傜幇鏀寔鍦ㄦ楠屽崟**鏂板缓琛ㄥ崟**涓�氳繃銆岃川妫�鏂规銆嶄笅鎷夋墜鍔ㄩ�夋嫨锛涙湭閰嶇疆鎴栦粎涓�涓柟妗堟椂淇濇寔鍘熸湁鑷姩琛屼负涓嶅彉銆�
+
+## API
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| GET | /mes/qc/template/item/list-by-item-and-type | 鏍规嵁鐗╂枡鎴栧伐鍗�/浠诲姟鍜屾娴嬬绫昏幏鍙栧彲鐢ㄨ川妫�鏂规鍒楄〃 |
+
+**璇锋眰鍙傛暟锛�**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
+|------|------|------|------|
+| qcType | Integer | 鏄� | 妫�娴嬬绫伙細1=IQC銆�2=IPQC銆�3=OQC銆�4=RQC |
+| itemId | Long | 鍚� | 浜у搧鐗╂枡 ID锛坢es_md_item.id锛夛紱IQC/OQC/RQC 浣跨敤 |
+| workOrderId | Long | 鍚� | 鐢熶骇璁㈠崟 ID锛汭PQC 浣跨敤 |
+| taskId | Long | 鍚� | 鐢熶骇浠诲姟 ID锛汭PQC 浣跨敤 |
+
+> 璇存槑锛歚itemId`銆乣workOrderId`銆乣taskId` 涓夎�呰嚦灏戜紶涓�涓�備紭鍏堥『搴忥細taskId 鈫� workOrderId 鈫� itemId銆侷PQC 琛ㄥ崟涓嶉�夌墿鏂欙紝浼� workOrderId锛�+鍙�� taskId锛夌敱鍚庣瑙ｆ瀽浜у搧锛涘叾浣欎笁涓ā鍧椾紶 itemId銆�
+
+**鍝嶅簲瀛楁锛堟暟缁勶級锛�**
+
+| 瀛楁 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| id | Long | 鏂规-浜у搧鍏宠仈缂栧彿锛坱emplateItem.id锛� |
+| templateId | Long | 璐ㄦ鏂规 ID |
+| templateCode | String | 璐ㄦ鏂规缂栧彿 |
+| templateName | String | 璐ㄦ鏂规鍚嶇О |
+| quantityCheck | Integer | 鏈�浣庢娴嬫暟 |
+| quantityUnqualified | Integer | 鏈�澶т笉鍚堟牸鏁� |
+| criticalRate | BigDecimal | 鏈�澶ц嚧鍛界己闄风巼锛�%锛� |
+| majorRate | BigDecimal | 鏈�澶т弗閲嶇己闄风巼锛�%锛� |
+| minorRate | BigDecimal | 鏈�澶ц交寰己闄风巼锛�%锛� |
+
+**鍝嶅簲绀轰緥锛�**
+
+```json
+{
+  "code": 0,
+  "data": [
+    {
+      "id": 5,
+      "templateId": 10,
+      "templateCode": "IQC-AQL-鈪�",
+      "templateName": "IQC 姝ｅ父妫�楠屼簩绾ф按骞�",
+      "quantityCheck": 8,
+      "quantityUnqualified": 1,
+      "criticalRate": 0,
+      "majorRate": 2.5,
+      "minorRate": 10
+    }
+  ]
+}
+```
+
+## 鍓嶇琛ㄧ幇
+
+| 妯″潡 | 瑙﹀彂瀛楁 | qcType | 璇存槑 |
+|------|----------|--------|------|
+| IQC | itemId | 1 | 閫変腑鐗╂枡鍚庢寜 qcType=1 鎷夊彇 |
+| OQC | itemId | 3 | 閫変腑鐗╂枡鍚庢寜 qcType=3 鎷夊彇 |
+| RQC | itemId | 4 | 閫変腑鐗╂枡鍚庢寜 qcType=4 鎷夊彇锛堝悗绔凡淇涓烘寜妫�娴嬬绫诲尮閰嶆ā鏉匡紝涓嶅啀璇尮閰嶅埌 IQC/IPQC 鏂规锛� |
+| IPQC | workOrderId銆乼askId | 2 | 閫変腑鐢熶骇璁㈠崟鍚庢寜 qcType=2 鎷夊彇锛宼askId 鍙�変紶鍏� |
+
+## 瀛楁灞曠ず瑙勫垯
+
+銆岃川妫�鏂规銆嶅瓧娈碉紙templateId锛夛細
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| 鏂板缓銆佹湭閫夌墿鏂�/鐢熶骇璁㈠崟 | 涓嬫媺绂佺敤锛屾彁绀�"璇峰厛閫夋嫨浜у搧鐗╂枡/鐢熶骇璁㈠崟" |
+| 鏂板缓銆佸凡閫夌墿鏂�/鐢熶骇璁㈠崟 | 涓嬫媺鍙敤锛岄粯璁ら�変腑杩斿洖鍒楄〃绗竴涓柟妗堬紝鍙垏鎹� |
+| 缂栬緫/璇︽儏 | 涓嬫媺绂佺敤锛屼粎鍥炴樉宸蹭繚瀛樼殑鏂规 |
+| 浜у搧鏈厤缃彲鐢ㄦ柟妗� | 涓嬫媺涓虹┖锛堜繚瀛樻椂鍚庣浠嶆牎楠屾姤銆屾湭閰嶇疆璐ㄦ鏂规銆嶏級 |
+| 浜у搧閰嶇疆澶氫釜 enable 鏂规 | 涓嬫媺灞曠ず鍏ㄩ儴鍙�夋柟妗堬紝鐢ㄦ埛鍙垏鎹� |
+
+## 涓氬姟瑙勫垯璇存槑
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| 鍓嶇鏄惧紡浼犱簡 templateId | 鍚庣鍦ㄦ牎楠屾柟妗堝繀椤诲睘浜�"浜у搧+妫�娴嬬绫�"鍙尮閰嶅垪琛紝鍚﹀垯鎷掔粷锛堥槻姝㈤�夊埌鍏朵粬浜у搧/鍏朵粬妫�娴嬬绫荤殑鏂规锛� |
+| 鍓嶇鏈紶 templateId | 鑷姩鍙栧尮閰嶅垪琛ㄧ涓�涓柟妗堬紝涓庢棫琛屼负涓�鑷� |
+| 缂栬緫妫�楠屽崟 | 涓嶅厑璁镐慨鏀规柟妗堬紙鍚庣 update 鏃跺拷鐣� templateId锛� |
+| 鑷姩瑙﹀彂璺緞锛堝埌璐ч�氱煡鈫扞QC銆侀攢鍞嚭搴撯啋OQC锛� | 涓嶈蛋涓嬫媺锛屼粛鐢卞悗绔嚜鍔ㄥ彇鏂规锛岃涓轰笉鍙� |
+
+## 娉ㄦ剰浜嬮」
+
+- 鍒楄〃銆佽鎯呭洖鏄惧瓧娈� templateId 鍦ㄧ幇鏈� RespVO 涓凡瀛樺湪锛屾棤闇�棰濆瀵规帴銆�
+- 淇濆瓨璇锋眰鍙傛暟鏂板 `templateId`锛堣川妫�鏂规 ID锛夛紝鍥涗釜妯″潡 SaveReqVO 鍧囧凡琛ュ厖锛汻QC 鍘熸湰灏卞甫姝ゅ瓧娈点��
+- 涓嬫媺榛樿閫変腑绗竴涓緷璧栫粍浠� `autoSelect: 'first'`锛屼粎褰撳綋鍓嶅�间负绌烘椂鐢熸晥锛岀敤鎴锋墜鍔ㄩ�夋嫨鍚庝笉浼氳鍔ㄨ鐩栥��
\ No newline at end of file

--
Gitblit v1.9.3