From ce85503abbd0924f8d999e6a86eeb46498b85665 Mon Sep 17 00:00:00 2001
From: 云 <2163098428@qq.com>
Date: 星期六, 07 十一月 2026 19:26:53 +0800
Subject: [PATCH] docs(mes): 新增MES生产报工与入库设计方案文档
---
docs/production_feedback_qc_fix_plan.md | 270 ++++++++++++++++++
docs/product_receipt_stock_timing.md | 49 +++
docs/process_multi_output_design.md | 251 ++++++++++++++++
docs/task_reporter_assignment.md | 99 ++++++
docs/qc_source_link_frontend_integration.md | 121 ++++++++
docs/feedback_qc_flag_source.md | 68 ++++
6 files changed, 858 insertions(+), 0 deletions(-)
diff --git a/docs/feedback_qc_flag_source.md b/docs/feedback_qc_flag_source.md
new file mode 100644
index 0000000..694a404
--- /dev/null
+++ b/docs/feedback_qc_flag_source.md
@@ -0,0 +1,68 @@
+# 鎶ュ伐璐ㄦ鏍囪瘑鍙栧�艰皟鏁� - 鍓嶇鑱旇皟鏂规
+
+## 娑夊強椤甸潰
+
+- 鐢熶骇璁㈠崟锛堝伐鍗曞伐搴忓垪琛ㄣ�佸伐搴忕紪杈戯級
+- MES 鐢熶骇浠诲姟锛堜换鍔″垪琛ㄣ�佷换鍔¤鎯呫�佸緟鎶ュ伐鍙拌处锛�
+- MES 鐢熶骇鎶ュ伐锛堟柊澧�/淇敼銆佸鎵癸級
+- 鐢熶骇宸ヤ綔鍙帮紙浠诲姟鍒楄〃銆佹姤宸ラ〉绛撅級
+
+## 涓氬姟鑳屾櫙
+
+宸ュ崟鍒涘缓鏃跺彲浠ュ湪銆屽伐搴忋�嶉〉绛惧崟鐙嬀閫夋湰宸ュ崟姣忛亾宸ュ簭鏄惁璐ㄦ锛岃閰嶇疆淇濆瓨鍦ㄥ伐鍗曞伐搴忓揩鐓� `mes_pro_work_order_process`銆�
+
+姝ゅ墠鎶ュ伐瀹℃壒銆佷换鍔″垪琛ㄣ�佸伐浣滃彴鍒ゆ柇銆屾槸鍚﹂渶瑕佽川妫�銆嶆椂璇诲彇鐨勬槸宸ヨ壓璺嚎妯℃澘 `mes_pro_route_process`锛屽鑷村伐鍗曚笂鍕鹃�夈�岃川妫�銆嶄絾宸ヨ壓璺嚎璇ュ伐搴忎负銆屽惁銆嶆椂锛屾姤宸ュ鎵硅蛋鐨勬槸鍏嶆鍒嗘敮锛氫骇鍑虹洿鎺ユ寜鍚堟牸鍏ュ簱锛屼笉鐢熸垚寰呮浠诲姟锛屼换鍔℃姤瀹屽伐鍚庝笉浼氳繘鍏ヨ川妫�銆�
+
+璋冩暣鍚庣粺涓�涓猴細**涓�寰嬩互宸ュ崟宸ュ簭蹇収鐨勩�岃川妫�銆嶆爣璇嗕负鍑�**锛屼粎鍦ㄥ伐鍗曟湭缁存姢瀵瑰簲宸ュ簭鏃跺洖閫�宸ヨ壓璺嚎妯℃澘銆�
+
+## 璁拌处/娴佺▼瑙勫垯
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| 宸ュ崟宸ュ簭鍕鹃�夎川妫� | 鎶ュ伐瀹℃壒鍚庣敓鎴愩�屽緟妫�楠屻�嶄骇鍑猴紝杩涘叆寰呮浠诲姟锛岃川妫�瀹屾垚鍚庢墠鍏ュ簱 |
+| 宸ュ崟宸ュ簭鏈嬀閫夎川妫� | 鎶ュ伐瀹℃壒鍚庢寜鍚堟牸/涓嶅悎鏍兼暟閲忕洿鎺ュ畬鎴愬叆搴� |
+| 宸ュ崟鏈淮鎶よ宸ュ簭 | 鍥為��璇诲彇宸ヨ壓璺嚎宸ュ簭鐨勮川妫�鏍囪瘑 |
+| 鍊掑啿鏍囪瘑 | 涓庤川妫�鏍囪瘑涓�鑷达細宸ュ崟宸ュ簭蹇収浼樺厛锛屽伐鑹鸿矾绾垮厹搴� |
+
+## API
+
+鎺ュ彛璺緞銆佽姹傚弬鏁般�佸搷搴旂粨鏋勫潎鏃犲彉鍖栵紝浠� `checkFlag` 瀛楁鐨勫彇鍊兼潵婧愯皟鏁淬��
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| GET | /mes/pro/task/get | 浠诲姟璇︽儏锛宍checkFlag` 鏀逛负鍙栧伐鍗曞伐搴忓揩鐓� |
+| GET | /mes/pro/task/page | 浠诲姟鍒嗛〉锛屽悓涓� |
+| GET | /mes/pro/task/pending-feedback-page | 寰呮姤宸ュ彴璐︼紝鍚屼笂 |
+| GET | /mes/pro/feedback/get | 鎶ュ伐璇︽儏锛宍checkFlag` 鏀逛负鍙栧伐鍗曞伐搴忓揩鐓� |
+| GET | /mes/pro/feedback/page | 鎶ュ伐鍒嗛〉锛屽悓涓� |
+| PUT | /mes/pro/feedback/update | 鏍¢獙鍙e緞鏀逛负宸ュ崟宸ュ簭蹇収锛堥渶妫�宸ュ簭鍙牎楠屾姤宸ユ暟閲忥級 |
+| POST | /mes/pro/feedback/approve | 瀹℃壒鎸夊伐鍗曞伐搴忓揩鐓у喅瀹氭槸鍚﹁繘鍏ヨ川妫� |
+
+## 瀛楁灞曠ず瑙勫垯
+
+| 瀛楁 | 灞曠ず浣嶇疆 | 鍙樺寲璇存槑 |
+|------|----------|----------|
+| checkFlag | 鐢熶骇浠诲姟鍒楄〃銆佷换鍔¢�夋嫨寮圭獥 | 鍙栧伐鍗曞伐搴忓揩鐓э紝琛ㄧず璇ヤ换鍔′骇鍑烘槸鍚﹂渶瑕佽川妫� |
+| checkFlag | 鎶ュ伐琛ㄥ崟鏁伴噺鍖哄煙 | 涓� true 鏃跺彧濉姤宸ユ暟閲忥紝涓� false 鏃跺~鍚堟牸/涓嶅悎鏍兼暟閲� |
+| backflushFlag | 浠诲姟鍒楄〃 | 鍙栧伐鍗曞伐搴忓揩鐓э紝琛ㄧず璇ュ伐搴忔槸鍚﹀�掑啿鎵f枡 |
+
+## 澶氫骇鍑虹墿鏂欑殑妫�楠岃鍒�
+
+鍚屼竴閬撳伐搴忓彲鑳藉悓鏃朵骇鍑哄涓墿鏂欙紙涓讳骇鍑� + 鑱斾骇鍑猴紝鏉ユ簮涓哄伐鍗曞伐搴忓揩鐓� `outputItemId`锛夛紝闇�瑕佹楠屾椂锛�
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| 鎶ュ伐瀹℃壒 | 姣忎釜浜у嚭鐗╂枡鍚勭敓鎴愪竴鏉°�屽緟妫�楠屻�嶄骇鍑鸿锛屼骇鍑哄崟淇濇寔鏈畬鎴愶紝鎶ュ伐鐘舵�佷负寰呮楠� |
+| 寰呮浠诲姟 | 姣忔潯浜у嚭琛屽憟鐜颁负涓�鏉″緟妫�璁板綍锛岀墿鏂欏彇浜у嚭琛岀墿鏂欙紝宸ュ簭鍙栨姤宸ュ崟宸ュ簭 |
+| 鍒涘缓杩囩▼妫�楠屽崟 | 妫�楠岀墿鏂欐寜鏉ユ簮浜у嚭琛岀‘瀹氾紙涓嶅啀鍙栦换鍔$墿鏂欙級锛屽伐搴忓彇鎶ュ伐鍗曞伐搴� |
+| 瀹屾垚鏌愬紶妫�楠屽崟 | 鍙媶鍒嗚妫�楠屽崟瀵瑰簲鐨勪骇鍑鸿锛堢敓鎴愬悎鏍�/涓嶅悎鏍兼槑缁嗭級 |
+| 瀹屾垚鎶ュ伐 | 鍚屼竴鎶ュ伐鐨勬墍鏈変骇鍑鸿閮芥楠屽畬鎴愬悗锛屼骇鍑哄崟鎵嶅畬鎴愬叆搴擄紝鎶ュ伐/浠诲姟杩涘害鎵嶅洖鍐� |
+| 鏁伴噺鍙e緞 | 鎶ュ伐鍗曚笌浠诲姟鐨勫悎鏍�/涓嶅悎鏍�/搴熷搧鏁伴噺鍙粺璁′富浜у嚭鐗╂枡锛岃仈浜у嚭鐗╂枡鍗曠嫭妫�楠屻�佸崟鐙叆搴� |
+| 妫�楠屾ā鏉� | 姣忎釜浜у嚭鐗╂枡閮藉繀椤诲崟鐙厤缃惎鐢ㄧ殑杩囩▼妫�楠屾ā鏉匡紙IPQC锛夛紝鍚﹀垯瀹℃壒鎴栧缓鍗曚細鎻愮ず缂哄け |
+
+## 娉ㄦ剰浜嬮」
+
+- 宸ュ崟宸ュ簭鍕鹃�夈�岃川妫�銆嶆椂锛岃宸ュ簭鐨勬瘡涓骇鍑虹墿鏂欓兘蹇呴』宸查厤缃惎鐢ㄧ殑杩囩▼妫�楠屾ā鏉匡紙IPQC锛夛紝鍚﹀垯瀹℃壒浼氭彁绀恒�屾湭閰嶇疆鍚敤鐨勮繃绋嬫楠屾ā鏉裤�嶃��
+- 鍓嶇濡傝嚜琛岃皟鐢� `/mes/pro/route-process/get-by-route-and-process` 鎺ㄥ `checkFlag`锛屽簲鏀逛负浼樺厛浣跨敤浠诲姟鎴栨姤宸ユ帴鍙h繑鍥炵殑 `checkFlag`锛岄伩鍏嶄笌鍚庣瀹℃壒鍙e緞涓嶄竴鑷淬��
+- 杩囩▼妫�楠屽崟鐨勭墿鏂欑敱鍚庣鎸夋潵婧愪骇鍑鸿纭畾锛屽墠绔棤闇�浼� `itemId`锛涗紶浜嗕篃涓嶄細鏀瑰彉妫�楠岀墿鏂欍��
+- 鍘嗗彶浠诲姟 RW2611070009 宸叉寜 `scripts/feedback-qc-rollback-20261107/01_rollback_rw2611070009.sql` 鍜� `03_rollback_per_material_ipqc.sql` 鍥為��鎶ュ伐鍗曘�佷换鍔¤繘搴︺�佷骇鍑�/鑷姩鍏ュ簱鍗曞強杩囩▼妫�楠屽崟锛屽彲閲嶆柊鎶ュ伐楠岃瘉璐ㄦ娴佺▼銆�
diff --git a/docs/process_multi_output_design.md b/docs/process_multi_output_design.md
new file mode 100644
index 0000000..96d5d7f
--- /dev/null
+++ b/docs/process_multi_output_design.md
@@ -0,0 +1,251 @@
+# 涓�閬撳伐搴忓浜у嚭锛堣仈浜у搧锛夎璁′笌鏀归�犳柟妗�
+
+> 鐘舵�侊細寰呯‘璁わ紝纭鍚庡啀瀹炴柦
+> 鏃ユ湡锛�2026-11-07
+
+## 1. 鑳屾櫙
+
+涓�閿帓浜ч瑙堟椂锛屽伐鍗� `WO_202611070001` 鍦ㄥ伐搴忋�岄搧鑺彔瑁呫�嶈鎷︽埅锛�
+
+```
+宸ュ簭閾佽姱鍙犺瀵瑰簲澶氫釜浜у嚭锛岃鎵嬪伐鎺掍骇纭鍚勪骇鍑烘暟閲�
+```
+
+鏉ユ簮锛歚MesProBatchScheduleService.java:252-260`銆傚綋鍓嶆帓浜фā鍨嬫槸銆屼竴閬撳伐搴� = 涓�涓换鍔� = 涓�涓骇鍑虹墿鏂欍�嶏紝妫�娴嬪埌宸ュ簭浜у嚭澶氫簬涓�涓椂鐩存帴鎶涢敊銆�
+
+浣嗗伐鑹鸿矾绾挎湰韬厑璁镐竴閬撳伐搴忛厤缃涓骇鍑猴紙`mes_pro_route_process_output`锛夛紝宸ュ崟宸ュ簭蹇収涔熶繚瀛樹簡澶氫釜浜у嚭锛坄mes_pro_work_order_process.output_item_id`锛岄�楀彿鍒嗛殧锛夈�備笅娓哥殑浠诲姟銆佹姤宸ャ�佺敓浜т骇鍑哄崟鍙堥兘鏄崟鐗╂枡妯″瀷锛屽洜姝ゅ浜у嚭鐩墠澶勪簬銆岃兘閰嶃�佷笉鑳芥帓銆佷笉鑳芥纭祦杞�嶇殑鐘舵�併��
+
+鍚屾椂鎺掓煡鍙戠幇鍑犱釜鍏宠仈闂锛�
+
+| 浣嶇疆 | 鐜扮姸闂 |
+|------|----------|
+| `MesProBatchScheduleService` | 澶氫骇鍑虹洿鎺ユ嫆缁濓紝鏃犳硶鎵归噺鎺掍骇 |
+| `schedule-form.vue:128` | 鎺掍骇鏃舵妸 `outputItemId`锛堥�楀彿涓诧級鐩存帴褰� `itemId` 浼犵粰浠诲姟锛屽浜у嚭鏃朵細浼犻潪娉曞�� |
+| `MesProTaskServiceImpl.resolveTaskItemId` | 鍙栫涓�涓骇鍑猴紝椤哄簭涓嶇‘瀹� |
+| `MesWmProductProduceServiceImpl` | 涓�涓姤宸ュ彧鐢熸垚涓�涓墿鏂欑殑浜у嚭琛� |
+| `MesProWorkOrderBomController.buildWorkOrderItems` | 浜у嚭鈫掑伐搴忔姇鏂欐槧灏勫彧鍙� CSV 绗竴涓骇鍑� |
+| `mes_pro_route_process_output` | 瀛橀噺瀛樺湪閲嶅琛岋紙route_process 126/127/128/129 鍏� 4 缁勶級 |
+
+## 2. 涓氬姟瀹氫箟锛堝凡纭锛�
+
+1. **鍚屼竴娆″姞宸ュ悓鏃朵骇鍑哄涓墿鏂�**锛堣仈浜у搧/鍓骇鍝侊級锛屼笉鏄悓涓�宸ュ簭鍒嗗埆鐢熶骇銆�
+2. 鍚勪骇鍑烘暟閲忕敱**宸ヨ壓璺嚎宸ュ簭浜у嚭閰嶇疆涓殑鍥哄畾閰嶆瘮**鍐冲畾锛屼互涓讳骇鍑轰负鍩哄噯 `1`锛�
+ - 涓讳骇鍑猴細姣忓姞宸� 1 涓富浜у嚭锛�
+ - 鍏跺畠浜у嚭锛氭瘡鍔犲伐 1 涓富浜у嚭闄勫甫鐨勬暟閲忥紙濡� `2` 琛ㄧず 1 涓富浜у嚭鍚屾椂浜у嚭 2 涓崟浣嶏級銆�
+3. 鎺掍骇銆佹姤宸ャ�佸伐鍗曡繘搴︺�佹姤宸ユ墸鏂欓兘浠�**涓讳骇鍑烘暟閲�**涓哄噯锛涘叾瀹冧骇鍑烘寜閰嶆瘮鑷姩鎹㈢畻銆�
+4. 涓�涓伐搴忎粛鐒�**鍙敓鎴愪竴涓敓浜т换鍔°�佸彧鎶ヤ竴娆″伐**锛屼骇鍑哄崟鎸変骇鍑虹墿鏂欐媶鎴愬琛屻��
+
+## 3. 鎬讳綋鏂规
+
+```
+宸ヨ壓璺嚎宸ュ簭
+ 鈹斺攢鈹� 浜у嚭閰嶇疆锛坕temId, 閰嶆瘮 quantity, 涓讳骇鍑� mainFlag锛�
+ 鈹�
+ 鈻�
+宸ュ崟宸ュ簭蹇収锛坥utput_item_id 閫楀彿涓诧紝涓讳骇鍑烘帓绗竴浣嶏級
+ 鈹�
+ 鈻�
+鐢熶骇浠诲姟锛堜竴鏉★紝itemId = 涓讳骇鍑猴紝quantity = 涓讳骇鍑烘暟閲忥級
+ 鈹�
+ 鈻�
+鎶ュ伐锛堜竴娆★紝feedback.itemId = 涓讳骇鍑猴級
+ 鈹�
+ 鈻�
+鐢熶骇浜у嚭鍗曪紙涓�涓崟澶达紝姣忎釜浜у嚭涓�琛� line + 涓�鏉� detail锛�
+ 鈹�
+ 鈻�
+浜у搧鍏ュ簱鍗曪紙涓�涓崟澶达紝姣忚涓�涓骇鍑猴級
+```
+
+鏍稿績鍘熷垯锛�**涓嶆柊澧炰换鍔$淮搴︺�佷笉鏀规姤宸ユā鍨�**锛屽彧鍦ㄤ骇鍑哄崟鐢熸垚鏃舵寜閰嶆瘮灞曞紑澶氳銆傝繖鏍锋帓浜у伐鏃躲�佹姤宸ユ墸鏂欍�佸伐鍗曞凡鐢熶骇鏁伴噺鐨勮绠楅兘涓嶅彈褰卞搷銆�
+
+## 4. 鏁版嵁妯″瀷
+
+### 4.1 `mes_pro_route_process_output` 澧炲姞瀛楁
+
+```sql
+ALTER TABLE mes_pro_route_process_output
+ ADD COLUMN quantity DECIMAL(18,6) NOT NULL DEFAULT 1.000000 COMMENT '閰嶆瘮锛氭瘡1涓富浜у嚭鐨勯檮甯︽暟閲忥紝涓讳骇鍑哄浐瀹氫负1' AFTER item_id;
+
+ALTER TABLE mes_pro_route_process_output
+ ADD COLUMN main_flag TINYINT NOT NULL DEFAULT 0 COMMENT '鏄惁涓讳骇鍑猴細1鏄� 0鍚�' AFTER quantity;
+```
+
+璇存槑锛�
+
+- 涓讳骇鍑虹殑 `quantity` 鍥哄畾涓� 1锛岀敱鏈嶅姟绔己鍒讹紱鍏跺畠浜у嚭蹇呴』 > 0銆�
+- 鍚屼竴閬撳伐搴忥紙鍚屼竴褰掑睘浜у搧鍒嗙粍鍐咃級鏈�澶氫竴涓� `main_flag = 1`锛涙湇鍔″眰鏍¢獙锛屼笉鍋氭暟鎹簱鍞竴绱㈠紩锛坄product_id` 鍏佽涓� NULL锛屽敮涓�绱㈠紩鏃犳硶绾︽潫锛夈��
+- 宸ュ簭浜у嚭鍊欓�夐泦浠嶆寜 `product_id IS NULL OR product_id = 褰撳墠浜у搧` 杩囨护锛涜嫢杩囨护鍚庢病鏈変富浜у嚭锛岃繍琛屾椂鍥為��鍙栨帓搴忕涓�鏉°��
+
+### 4.2 宸ュ崟宸ュ簭蹇収
+
+`mes_pro_work_order_process.output_item_id` 缁х画浣跨敤閫楀彿涓诧紝**鍙皟鏁撮『搴忥細涓讳骇鍑烘帓绗竴浣�**锛屽叾浣欐寜 sort 鎺掑簭銆�
+
+鍘熷洜锛氱幇鏈変换鍔″垱寤恒�丅OM 灞曞紑銆佸墠绔睍绀洪兘鏈夊彇銆岀涓�涓�嶇殑鍏滃簳閫昏緫锛屼繚鎸佺涓�浣嶆槸涓讳骇鍑哄彲浠ユ渶灏忓寲鏀瑰姩銆�
+
+閰嶆瘮涓嶅揩鐓у埌宸ュ崟锛岀敓鎴愪骇鍑哄崟鏃舵寜 `(routeId, processId, productId, itemId)` 鍥炴煡璺嚎閰嶇疆锛涙煡涓嶅埌鏃堕粯璁� 1銆�
+
+> 杈圭晫锛氳矾绾垮惎鐢ㄥ悗涓嶅厑璁哥紪杈戯紱鍋滅敤鈫掍慨鏀光啋鍐嶅惎鐢ㄦ椂锛屽巻鍙插伐鍗曠殑閰嶆瘮浼氳窡闅忚矾绾垮彉鍖栥�傚闇�鍐荤粨锛屽悗缁彲澧炲姞宸ュ崟宸ュ簭浜у嚭蹇収琛紝鏈柟妗堟殏涓嶅紩鍏ャ��
+
+### 4.3 瀛橀噺鏁版嵁娓呯悊
+
+```sql
+-- 1) 鍒犻櫎閲嶅浜у嚭褰掑睘琛岋紝淇濈暀姣忕粍鏈�灏� id
+DELETE o1 FROM mes_pro_route_process_output o1
+JOIN mes_pro_route_process_output o2
+ ON o1.route_process_id = o2.route_process_id
+ AND o1.item_id = o2.item_id
+ AND (o1.product_id = o2.product_id OR (o1.product_id IS NULL AND o2.product_id IS NULL))
+ AND o1.id > o2.id;
+
+-- 2) 姣忛亾宸ュ簭鍥炲~涓�涓富浜у嚭锛堟帓搴忔渶灏忋�佸悓搴忓彇 id 鏈�灏忥級
+UPDATE mes_pro_route_process_output o
+JOIN (
+ SELECT route_process_id, MIN(id) AS keep_id
+ FROM (
+ SELECT route_process_id, id,
+ ROW_NUMBER() OVER (PARTITION BY route_process_id
+ ORDER BY sort IS NULL, sort, id) AS rn
+ FROM mes_pro_route_process_output
+ ) t
+ WHERE rn = 1
+ GROUP BY route_process_id
+) m ON m.keep_id = o.id
+SET o.main_flag = 1;
+```
+
+> 娉細濡傛灉鏌愰亾宸ュ簭鎸変笉鍚屽綊灞炰骇鍝侀厤缃簡涓嶅悓浜у嚭锛屼富浜у嚭鎸夊叏灞�鍙栦竴鏉★紱杩愯鏃惰嫢褰撳墠浜у搧杩囨护鍚庝笉鍚琛岋紝鍥為��鍙栨帓搴忕涓�鏉°��
+
+## 5. 鍚庣鏀归�犳竻鍗�
+
+| 鏂囦欢 | 鏀瑰姩 |
+|------|------|
+| `MesProRouteProcessOutputDO` | 澧炲姞 `quantity`銆乣mainFlag` 瀛楁 |
+| `MesProRouteProcessSaveReqVO.OutputItem` | 澧炲姞 `quantity`銆乣mainFlag`锛涗繚瀛樻椂鏍¢獙涓讳骇鍑哄敮涓�銆侀厤姣� > 0 |
+| `MesProRouteProcessOutputVO` / `RespVO` | 鍝嶅簲澧炲姞 `quantity`銆乣mainFlag` |
+| `MesProRouteProcessServiceImpl` | 淇濆瓨閰嶆瘮/涓讳骇鍑猴紱`resolveOutputItemId` 鎸夈�屼富浜у嚭浼樺厛 + sort銆嶆嫾鎺ワ紱`getOutputItemIdsByRouteProcessId` 杩斿洖椤哄簭涓讳骇鍑轰紭鍏堬紱鏂板 `getProcessOutputs(routeProcessId, productId)` 杩斿洖 `itemId + ratio + mainFlag` |
+| `MesProWorkOrderProcessServiceImpl.getProcessListByProductId` | 宸茶蛋 `getRouteProcessListByProductId`锛屼繚璇� CSV 涓讳骇鍑哄湪棣栦綅 |
+| `MesProBatchScheduleService` | 鍒犻櫎銆屽涓骇鍑恒�嶆姏閿欙紱浠诲姟鐗╂枡鍙栦富浜у嚭锛涢瑙堝鍔� warning銆屽伐搴� X 鍚� N 涓仈浜у嚭锛屾寜涓讳骇鍑烘帓浜с�� |
+| `MesProTaskServiceImpl.resolveTaskItemId` | 鍙栦富浜у嚭锛堜緷璧栦笂闈㈢殑鎺掑簭淇濊瘉鍙栫涓�涓嵆涓讳骇鍑猴級 |
+| `MesWmProductProduceServiceImpl.generateProductProduce` | 鎸変骇鍑哄垪琛ㄧ敓鎴愬琛岋細姣忚 `itemId` = 浜у嚭鐗╂枡锛宍quantity` = 鎶ュ伐鏁伴噺 脳 閰嶆瘮锛涙壒娆℃寜鍚勮嚜鐗╂枡鐢熸垚 |
+| `MesWmProductProduceServiceImpl.splitPendingAndFinishProduce` | IPQC 瀹屾垚鏃讹紝闄ゆ簮琛屽鎸夊悓涓�鍚堟牸鐜囨媶鍒嗗悓浜у嚭鍗曞唴鍏跺畠寰呮琛� |
+| `MesProWorkOrderBomController.buildWorkOrderItems` | 浜у嚭鈫掑伐搴忔姇鏂欐槧灏勮鐩栧叏閮ㄤ骇鍑猴紱鑱斾骇鍑烘寜銆岃疆娆� = max(闇�姹傞噺 / 姣忚疆浜у嚭閲�)銆嶅彧灞曞紑涓�娆★紝閬垮厤閲嶅璁$畻 |
+| `MesProFeedbackServiceImpl` | 涓嶅彉锛堟姤宸ョ墿鏂欎粛涓轰富浜у嚭锛夛紱濡傞渶鍦ㄦ姤宸ュ崟灞曠ず鑱斾骇鍑猴紝浠呭仛鍙灞曠ず |
+| `MesWmItemConsumeServiceImpl` | 涓嶅彉锛堜竴娆℃姤宸ユ寜宸ュ簭 BOM 脳 鎶ュ伐鏁伴噺鎵d竴娆℃枡锛屽ぉ鐒舵纭級 |
+| `MesWmProductReceiptServiceImpl` | 涓嶅彉锛堜骇鍑哄崟澶氳 鈫� 鍏ュ簱鍗曞琛岋紝鐜版湁閫昏緫宸叉敮鎸侊級 |
+| `ErrorCodeConstants` | 鏂板锛歚PRO_ROUTE_PROCESS_OUTPUT_MAIN_REQUIRED`锛�1_040_501_104锛夈�乣PRO_ROUTE_PROCESS_OUTPUT_RATIO_INVALID`锛坃105锛夈�乣PRO_ROUTE_PROCESS_OUTPUT_MAIN_DUPLICATE`锛坃106锛� |
+
+## 6. 鏍稿績绠楁硶
+
+### 6.1 鏁伴噺鎹㈢畻
+
+```
+涓讳骇鍑猴細qty_main = feedbackQuantity
+鍏跺畠浜у嚭 i锛歲ty_i = feedbackQuantity 脳 ratio_i
+```
+
+- 閰嶆瘮鍏佽灏忔暟锛堝 0.5 kg / 1 涓級锛屼繚鐣� 6 浣嶃��
+- 涓嶅仛寮哄埗鍙栨暣锛涘闇�鎸夌墿鏂欒閲忓崟浣嶅彇鏁达紝鍚庣画鍦ㄤ骇鍑虹敓鎴愬琛ュ厖銆�
+
+### 6.2 鎵归噺鎺掍骇
+
+1. 宸ュ簭鐩爣鏁伴噺 `targetQuantity` 浠嶆寜鏀剁巼鍊掓帹锛堜富浜у嚭鍙e緞锛夈��
+2. 瑙f瀽璇ュ伐搴忎富浜у嚭鐗╂枡锛氫紭鍏堝彇 `main_flag = 1` 涓斿綊灞炲綋鍓嶄骇鍝佺殑浜у嚭锛涙病鏈夊垯鍙栨帓搴忕涓�鏉°��
+3. 浠诲姟鏁伴噺 = `targetQuantity - 宸叉帓浠诲姟鏁伴噺`锛屼换鍔$墿鏂� = 涓讳骇鍑恒��
+4. 涓嶅啀鍥犱负瀛樺湪鍏跺畠浜у嚭鑰屾姤閿欙紱鍏跺畠浜у嚭涓嶇敓鎴愪换鍔°��
+5. 棰勮缁撴灉瀵瑰浜у嚭宸ュ簭杩藉姞涓�鏉¢潪闃绘柇 warning 鎻愮ず銆�
+
+### 6.3 鎶ュ伐 鈫� 浜у嚭鍗�
+
+`generateProductProduce` 鍐咃細
+
+1. 瑙f瀽浜у嚭鍒楄〃锛氬伐鍗曞伐搴忓揩鐓х殑 `output_item_id`锛堥『搴忓嵆涓讳骇鍑轰紭鍏堬級鈭� 璺嚎閰嶆瘮閰嶇疆锛涚己澶遍厤姣旀寜 1銆�
+2. 鏃犳楠岋細姣忎釜浜у嚭鎸夈�屽悎鏍兼暟 / 涓嶅悎鏍兼暟銆嶅悇鐢熸垚涓�琛岋紙娌跨敤鐜版湁鎷嗗垎瑙勫垯锛夛紝鏁伴噺鍚勮嚜涔橀厤姣斻��
+3. 闇�瑕佹楠岋細姣忎釜浜у嚭鐢熸垚涓�鏉°�屽緟妫�楠屻�嶈锛岀瓑寰� IPQC銆�
+4. 鎵规鍙锋寜鍚勪骇鍑虹墿鏂欏垎鍒敓鎴愶紙娌跨敤 `getOrGenerateBatchCode`锛夈��
+5. 鏄庣粏琛岀殑浠撳簱娌跨敤 `resolveOutputTarget(workOrderId, processId, itemId, feedbackId)`锛�
+ - 宸ュ崟宸ュ簭閰嶇疆浜嗕粨搴� 鈫� 鎵�鏈変骇鍑鸿閮界敤璇ヤ粨搴擄紱
+ - 鍚﹀垯鎸変骇鍑虹墿鏂欐煡璺嚎浜у搧浠撳簱锛�
+ - 鏈亾宸ュ簭浠嶈姹傚疄闄呬粨搴擄紝涓棿宸ュ簭浠嶅彲钀借櫄鎷熺嚎杈瑰簱銆�
+
+### 6.4 IPQC
+
+- 妫�楠屼粛浠ヤ富浜у嚭寰呮琛屼负婧愯锛圛PQC 鍗曚笌鎶ュ伐鍗曚竴涓�瀵瑰簲锛夈��
+- 妫�楠屽畬鎴愭椂锛屾寜涓讳骇鍑鸿鐨� `鍚堟牸鏁� / 寰呮鏁伴噺` 寰楀埌鍚堟牸鐜� `r`锛屽鍚屼骇鍑哄崟鍐呭叾瀹冨緟妫�琛屾墽琛岋細
+ - `鍚堟牸_i = 琛屾暟閲� 脳 r`锛堜繚鐣� 6 浣嶏級锛�
+ - `涓嶅悎鏍糭i = 琛屾暟閲� - 鍚堟牸_i`銆�
+- 琛屾暟閲忎负 0 鐨勪骇鍑轰笉鐢熸垚浜у嚭鍗曡銆�
+
+### 6.5 鐗╂枡闇�姹傚睍寮�
+
+`buildWorkOrderItems` 璋冩暣锛�
+
+1. 姣忎釜浜у嚭鐗╂枡閮藉缓绔嬨�屼骇鍑� 鈫� 鏈伐搴忔姇鏂欓厤鏂广�嶆槧灏勶紙涓嶅啀鍙彇绗竴涓級銆�
+2. 閫愬眰灞曞紑鏃讹紝瀵瑰睘浜庡悓涓�宸ュ簭鐨勫涓骇鍑哄厛鎸夎疆娆″綊骞讹細
+ ```
+ runs = max(鍚勪骇鍑洪渶姹傞噺 / 璇ヤ骇鍑烘瘡杞骇鍑洪噺)
+ 姣忚疆浜у嚭閲忥細涓讳骇鍑� = 1锛屽叾瀹冧骇鍑� = ratio
+ ```
+ 鐢� `runs` 灞曞紑涓�娆¤宸ュ簭鎶曟枡锛岄伩鍏嶅悓宸ュ簭浜у嚭鍒嗗埆灞曞紑瀵艰嚧鐗╂枡閲嶅銆�
+3. 鍙湁涓�涓骇鍑虹殑宸ュ簭淇濇寔鐜版湁閫昏緫涓嶅彉銆�
+
+## 7. 鍓嶇鏀归�犳竻鍗�
+
+| 椤甸潰 / 鏂囦欢 | 鏀瑰姩 |
+|-------------|------|
+| `pro/route/components/output-attribution.vue` | 姣忚澧炲姞銆岄厤姣斻�岻nputNumber锛堥粯璁� 1銆佹渶灏� 0.000001锛夈�併�屼富浜у嚭銆峈adio锛涘垏鎹富浜у嚭鏃惰嚜鍔ㄦ妸涓婁竴琛屼富浜у嚭鍙栨秷 |
+| `pro/route/data.ts` 宸ュ簭鍒楄〃 | 銆屾湰宸ュ簭浜у嚭銆嶅垪灞曠ず `鍚嶇О 脳 閰嶆瘮`锛屼富浜у嚭鍔犳爣璁� |
+| 宸ュ崟鍒涘缓/缂栬緫 鈫� 宸ュ簭涓庝骇鍑� | 灞曠ず鑱斾骇鍑哄強閰嶆瘮锛堝彧璇伙級 |
+| `pro/task/modules/schedule-form.vue` | 淇 `item-id` 浼犲叆锛氬彇宸ュ崟宸ュ簭杈撳嚭鐨勭涓�涓� id锛堜富浜у嚭锛夛紝涓嶈鐩存帴浼犻�楀彿涓� |
+| 鎺掍骇棰勮寮圭獥 | 澶氫骇鍑哄伐搴忔樉绀烘彁绀烘枃妗堬紙闈為樆鏂級 |
+| 鐢熶骇浜у嚭鍗� / 浜у搧鍏ュ簱鍗� | 鐜版湁鍒楄〃鎸夎灞曠ず锛屾棤闇�鏂伴〉闈紱纭澶氳姝e父鏄剧ず锛屾潵婧愬垪浠嶆寜浜у嚭鍗曞睍绀� |
+
+## 8. 鍏煎鎬т笌杈圭晫
+
+| 鍦烘櫙 | 澶勭悊 |
+|------|------|
+| 瀛橀噺宸ュ崟缂哄皯涓讳骇鍑烘爣璁� | 杩愯鏃跺彇鎺掑簭绗竴鏉′綔涓轰富浜у嚭 |
+| 瀛橀噺宸ュ崟蹇収 CSV 椤哄簭涓庤矾绾夸笉涓�鑷� | 浠ュ揩鐓� CSV 绗竴鏉′负涓讳骇鍑猴紝閰嶆瘮鎸夌墿鏂欏洖鏌ヨ矾绾� |
+| 鍓骇鍑哄湪璺嚎浜у搧涓婃病鏈変粨搴撻厤缃� | 浼樺厛鐢ㄥ伐鍗曞伐搴忎粨搴擄紱涓棿宸ュ簭鍥為��铏氭嫙绾胯竟搴擄紱鏈亾宸ュ簭浠嶈姹傚疄闄呬粨搴擄紙涓庣幇鏈夋牎楠屼竴鑷达級 |
+| 鎶ュ伐鍙姤涓讳骇鍑烘暟閲� | 鍓骇鍑烘暟閲忕敱閰嶆瘮鎺ㄥ锛屼笉鍏佽鍗曠嫭淇敼锛堥伩鍏嶄笌涓讳骇鍑鸿劚鑺傦級 |
+| 宸ュ簭鍙湁涓�涓骇鍑� | 鍏ㄩ儴閫昏緫閫�鍖栦负鐜版湁琛屼负 |
+| 鍚屼竴宸ュ簭宸叉湁鍘嗗彶浠诲姟锛堝浠诲姟锛� | 涓嶈嚜鍔ㄥ悎骞讹紱鏂版帓浜т粛鎸夈�屽凡鏈変换鍔℃暟閲忓悎璁°�嶈绠楀墿浣欓噺 |
+| 浜у嚭褰掑睘閲嶅琛� | 鐢辫縼绉昏剼鏈竻鐞嗭紱鏈嶅姟灞備繚瀛樻椂鎸� `productId + itemId` 鍘婚噸锛堝凡鏈夐�昏緫锛� |
+
+## 9. 杩佺Щ鑴氭湰
+
+鐩綍锛歚scripts/process-multi-output-20261107/`
+
+- `01_ddl.sql`锛氬姞 `quantity`銆乣main_flag` 鍒�
+- `02_cleanup.sql`锛氭竻鐞嗛噸澶嶄骇鍑鸿 + 鍥炲~涓讳骇鍑�
+
+鑴氭湰涓嶅寘鍚� `tenant_id`锛堟湰椤圭洰涓嶄娇鐢ㄥ绉熸埛锛夈��
+
+## 10. 楠屾敹娓呭崟
+
+1. 宸ヨ壓璺嚎銆岄搧鑺彔瑁呫�嶉厤缃� 2 涓骇鍑猴紝鍏朵腑 1 涓富浜у嚭銆侀厤姣斿垎鍒负 1 / 2锛屼繚瀛樻垚鍔燂紱閰嶇疆涓や釜涓讳骇鍑烘椂琚嫤鎴��
+2. 鏂板缓宸ュ崟骞剁敓鎴愬伐搴忥紝蹇収 `output_item_id` 涓讳骇鍑哄湪绗竴浣嶃��
+3. 涓�閿帓浜ч瑙堥�氳繃锛岀敓鎴� 1 涓换鍔★紝鐗╂枡涓轰富浜у嚭锛屾暟閲� = 宸ュ崟鏁伴噺銆�
+4. 鎶ュ伐 100锛屼骇鍑哄崟鐢熸垚 2 琛岋細涓讳骇鍑� 100銆佸壇浜у嚭 200锛堥厤姣� 2锛夈��
+5. 浜у搧鍏ュ簱鍗曠敓鎴� 2 琛岋紝鏁伴噺鍜屼粨搴撴纭��
+6. 寮�鍚� IPQC锛氭楠屼富浜у嚭鍚堟牸 90/100锛屼骇鍑哄崟涓よ鎸� 90% 鎷嗗垎锛�90/10銆�180/20锛夈��
+7. 宸ュ崟宸茬敓浜ф暟閲忓彧澧炲姞 100锛屼笉閲嶅绱姞銆�
+8. 鎶ュ伐鑷姩鎵f枡锛氭寜宸ュ簭 BOM 脳 100 鎵d竴娆★紝涓嶅洜澶氫骇鍑洪噸澶嶆墸鏂欍��
+9. 鐗╂枡闇�姹傚睍寮�涓嶉噸澶嶈绠楄宸ュ簭鎶曟枡銆�
+10. 瀛橀噺鍗曚骇鍑哄伐搴忓姛鑳藉洖褰掓甯搞��
+
+## 11. 瀹炴柦椤哄簭
+
+1. DDL + DO/VO + 璺嚎淇濆瓨/璇诲彇锛堝惈涓讳骇鍑恒�侀厤姣斻�佹帓搴忥級
+2. 鏁版嵁娓呯悊鑴氭湰 + 瀛橀噺鍥炲~
+3. 鎺掍骇瑙i攣锛坄MesProBatchScheduleService`銆佸墠绔� schedule-form 淇锛�
+4. 鎶ュ伐浜у嚭鍗曞琛� + IPQC 鎷嗗垎
+5. 鍏ュ簱鍥炲綊
+6. 鐗╂枡闇�姹傚睍寮�鑱斾骇鍑哄綊骞�
+7. 鍓嶇浜у嚭閰嶇疆銆佸垪琛ㄥ睍绀恒�佹彁绀�
+
+## 12. 寰呯‘璁�
+
+1. 鑱斾骇鍑虹殑璐ㄦ鏄惁鍏ㄩ儴璺熼殢涓讳骇鍑哄悎鏍肩巼锛堟湰鏂规榛樿璺熼殢锛夈��
+2. 鎶ュ伐鐣岄潰鏄惁闇�瑕佸睍绀鸿仈浜у嚭鏄庣粏锛堟湰鏂规榛樿鍙睍绀轰富浜у嚭锛屼骇鍑哄崟閲屼綋鐜帮級銆�
+3. 閰嶆瘮鏄惁鍏佽鎸夊伐鍗曡鐩栵紙鏈柟妗堥粯璁ゅ彧鍦ㄥ伐鑹鸿矾绾跨淮鎶わ紝宸ュ崟鍙锛夈��
diff --git a/docs/product_receipt_stock_timing.md b/docs/product_receipt_stock_timing.md
new file mode 100644
index 0000000..a0a4f92
--- /dev/null
+++ b/docs/product_receipt_stock_timing.md
@@ -0,0 +1,49 @@
+# 浜у搧鍏ュ簱搴撳瓨璁拌处鏃剁偣璋冩暣 - 鍓嶇鑱旇皟鏂规
+
+## 娑夊強椤甸潰
+
+- 浜у搧鍏ュ簱锛堝垪琛ㄣ�佹彁浜ゃ�佹墽琛屼笂鏋躲�佹墽琛屽叆搴擄級
+- 搴撳瓨浜嬪姟娴佹按
+- 搴撳瓨鍙拌处 / 鐗╂枡搴撳瓨
+
+## 涓氬姟鑳屾櫙
+
+姝ゅ墠鎶ュ伐瀹℃壒鐢熸垚浜у嚭鍗曞悗锛屼骇鍑哄崟瀹屾垚鏃跺氨鎶婃垚鍝佺洿鎺ヨ鍏ュ疄闄呬粨搴撳簱瀛橈紝瀵艰嚧銆屼骇鍝佸叆搴撳崟杩樻湭鎻愪氦銆佹湭鎵ц涓婃灦銆佹湭鎵ц鍏ュ簱銆嶆椂锛屽簱瀛樹簨鍔℃祦姘撮噷宸茬粡鍑虹幇浜у搧浜у嚭鍏ュ簱璁板綍銆佸簱瀛樻暟閲忎篃宸插鍔犮��
+
+璋冩暣鍚庣粺涓�涓猴細**浜у搧鍏ュ簱鍗曟墽琛屽叆搴撴椂鎵嶇櫥璁板疄闄呬粨搴撳簱瀛�**锛屼笌閲囪喘鍏ュ簱鐨勬墽琛屽叆搴撳彛寰勪竴鑷淬��
+
+## 璁拌处瑙勫垯
+
+| 鍦烘櫙 | 璁拌处鏃剁偣 | 璇存槑 |
+|------|----------|------|
+| 涓棿宸ュ簭浜у嚭鍒拌櫄鎷熺嚎杈瑰簱 | 鎶ュ伐瀹℃壒鐢熸垚浜у嚭鍗曞苟瀹屾垚鏃� | 杞﹂棿鍦ㄥ埗搴撳瓨锛屼笅閬撳伐搴忓�掑啿棰嗙敤渚濊禆璇ュ簱瀛橈紝淇濇寔绔嬪嵆璁拌处 |
+| 浜у嚭鍒板疄闄呬粨搴擄紙鎴愬搧/鍗婃垚鍝侊級 | 浜у搧鍏ュ簱鍗曘�屾墽琛屽叆搴撱�嶆椂 | 浜嬪姟绫诲瀷 `浜у搧浜у嚭` 涓嶅啀浜х敓瀹為檯浠撳簱鍏ュ簱锛涙敼涓� `鐢熶骇鍏ュ簱` 鍏ュ簱浜嬪姟 |
+| 鑷姩鐢熸垚鐨勪骇鍝佸叆搴撳崟锛圓UTO-PR-*锛� | 鎵ц鍏ュ簱鏃� | 浠呯櫥璁板疄闄呬粨搴撳叆搴� |
+| 鎵嬪伐鍒涘缓鐨勪骇鍝佸叆搴撳崟 | 鎵ц鍏ュ簱鏃� | 淇濇寔銆岃櫄鎷熺嚎杈瑰簱鍑哄簱 + 瀹為檯浠撳簱鍏ュ簱銆� |
+
+## API
+
+鎺ュ彛璺緞銆佽姹傚弬鏁般�佸搷搴旂粨鏋勫潎鏃犲彉鍖栥��
+
+## 瀛楁灞曠ず瑙勫垯
+
+| 瀛楁 | 灞曠ず浣嶇疆 | 鍙樺寲璇存槑 |
+|------|----------|----------|
+| 搴撳瓨浜嬪姟娴佹按 | 搴撳瓨浜嬪姟娴佹按椤甸潰 | 浜у嚭鍒板疄闄呬粨搴撶殑璁板綍锛屼笟鍔$被鍨嬬敱銆屼骇鍝佷骇鍑恒�嶅彉涓恒�岀敓浜у叆搴撱�嶏紝涓旀椂闂寸偣鍙樹负鎵ц鍏ュ簱鏃堕棿 |
+| 搴撳瓨鏁伴噺 | 搴撳瓨鍙拌处銆佺墿鏂欏簱瀛� | 鎴愬搧/鍗婃垚鍝佸簱瀛樺湪鎵ц鍏ュ簱鍚庢墠澧炲姞 |
+| 浜у搧鍏ュ簱鍗曟槑缁嗕粨搴� | 浜у搧鍏ュ簱璇︽儏 | 浠嶄负棰勫~鐨勭洰鏍囦粨搴擄紝鎵ц鍏ュ簱鏃舵寜鏄庣粏鏈�缁堜粨搴撹璐� |
+
+## 涓氬姟瑙勫垯璇存槑
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| 浜у搧鍏ュ簱鍗曚负鑽夌 / 寰呬笂鏋� / 寰呮墽琛屽叆搴� | 瀹為檯浠撳簱搴撳瓨涓嶅彉锛屼笉浜х敓搴撳瓨浜嬪姟娴佹按 |
+| 鎵ц鍏ュ簱 | 鎸変笂鏋舵槑缁嗙殑瀹為檯浠撳簱銆佸簱浣嶃�佸簱鍖虹櫥璁板叆搴撲簨鍔★紝骞跺鍔犲簱瀛� |
+| 鑷姩鍏ュ簱鍗曞瓨鍦ㄦ槑缁嗘寚鍚戣櫄鎷熺嚎杈瑰簱 | 璺宠繃璁拌处锛堜骇鍑哄崟瀹屾垚鏃跺凡璁拌处锛夛紝閬垮厤閲嶅 |
+| 浜у嚭鍒拌櫄鎷熺嚎杈瑰簱锛堜腑闂村伐搴忥級 | 浠嶇珛鍗宠璐︼紝鍚﹀垯涓嬮亾宸ュ簭鍊掑啿浼氭姤銆屽簱瀛樹笉瓒炽�� |
+
+## 娉ㄦ剰浜嬮」
+
+- 鍘嗗彶鏈畬鎴愮殑鑷姩鍏ュ簱鍗� AUTO-PR-37 宸叉寜 `scripts/product-receipt-stock-timing-20261107/01_cleanup_early_transactions.sql` 鍐查攢鎻愬墠璁拌处鐨勫簱瀛樹笌浜嬪姟锛屽悗缁墽琛屽叆搴撲細姝e父鍏ヨ处銆�
+- AUTO-PR-36 缂哄皯涓婃灦鏄庣粏鏃犳硶鎵ц鍏ュ簱锛屽叾鎻愬墠璁拌处鐨勫簱瀛樻殏鏈啿閿�锛涘闇�琛ラ綈鏄庣粏鍚庡叆搴擄紝椤诲厛鎸夎剼鏈敞閲婂啿閿�瀵瑰簲浜嬪姟锛屽惁鍒欎細閲嶅璁拌处銆�
+- 宸插畬鎴愮殑鍏ュ簱鍗曚笉鍙楀奖鍝嶏紝涓嶉噸澶嶈璐︺��
diff --git a/docs/production_feedback_qc_fix_plan.md b/docs/production_feedback_qc_fix_plan.md
new file mode 100644
index 0000000..db705c8
--- /dev/null
+++ b/docs/production_feedback_qc_fix_plan.md
@@ -0,0 +1,270 @@
+# 鐢熶骇鎶ュ伐鑷姩鎵f枡 / 璐ㄦ娴佽浆 / 浜у嚭鍏ュ簱 淇敼鏂规
+
+> 鑼冨洿锛歁ES 鐢熶骇鎶ュ伐锛坒eedback锛夊鎵� 鈫� 鍊掑啿鎵f枡 鈫� 杩囩▼妫�楠岋紙IPQC锛夆啋 浜у嚭鍏ュ簱
+> 鐘舵�侊細寰呰瘎瀹�
+> 娑夊強妯″潡锛歚yudao-module-mes`锛坧ro / qc / wm锛�
+
+## 涓�銆佽儗鏅�
+
+褰撳墠鎶ュ伐閾捐矾宸插疄鐜拌嚜鍔ㄥ寲锛屼絾鍦ㄤ互涓嬬幆鑺傚瓨鍦ㄦ暟鎹纭�т笌娴佺▼闂幆闂锛�
+
+- 鑷姩鎵f枡锛堝�掑啿锛夌己灏戝彲鐢ㄩ噺鏍¢獙锛屼笖涓嶅悎鏍煎搧/涓棿宸ュ簭鐨勮处鍔″彛寰勪笉娓呮櫚
+- 璐ㄦ瀹屾垚鍥炶皟娌℃湁鍥炲啓浠诲姟銆佸伐鍗曘�丮PS 鏁伴噺
+- 杩囩▼妫�楠屾暟閲忔病鏈変笂闄愭牎楠岋紝涓斾笉鍚堟牸鍝佹寜姝e父鍝佸叆璐�
+- 浜у嚭鍏ュ簱鍦ㄦ湯閬撳伐搴忔湭閰嶇疆浜у嚭浠撳簱鏃讹紝鎴愬搧婊炵暀铏氭嫙绾胯竟搴�
+- 銆屾病鏈夎川妫�鏂规銆嶆椂锛屾姤宸ヨ繘鍏ュ緟妫�鍚庢棤娉曞垱寤鸿繃绋嬫楠屽崟锛屾案涔呭崱鍦ㄥ緟妫�鐘舵��
+
+鏈枃妗f眹鎬婚棶棰樸�佹牴鍥犱笌淇敼鏂规锛屼緵璇勫鍚庡疄鏂姐��
+
+## 浜屻�佺幇鐘堕摼璺�
+
+### 2.1 鏃犺川妫�锛堝伐搴� checkFlag = 0锛�
+
+```
+鎶ュ伐瀹℃壒 approveFeedback
+ 鈹斺攢 鍊掑啿宸ュ簭锛� 鈹�鈹� 鏄� 鈫� 鐢熸垚娑堣�楀崟 + 鎵g嚎杈瑰簱 + 鐢熸垚鍊掑啿棰嗘枡鍑瘉
+ 鈹斺攢 鐢熸垚浜у嚭鍗曪紙鎸夊悎鏍�/涓嶅悎鏍兼媶琛� + 鏄庣粏锛�
+ 鈹斺攢 finishProductProduce
+ 鈹溾攢 涓恒�屾墍鏈夎銆嶅垱寤� IN 搴撳瓨浜嬪姟锛堝惈涓嶅悎鏍艰锛�
+ 鈹溾攢 鏇存柊浜у嚭鍗曚负宸插畬鎴�
+ 鈹斺攢 鑻ヤ负鏈亾宸ュ簭 鈫� 鐢熸垚浜у搧鍏ュ簱鍗曪紙浠呭悎鏍艰锛岀姸鎬�=鑽夌锛�
+鎶ュ伐瀹屾垚
+```
+
+### 2.2 鏈夎川妫�锛堝伐搴� checkFlag = 1锛�
+
+```
+鎶ュ伐瀹℃壒 approveFeedback
+ 鈹斺攢 鍊掑啿鎵f枡锛堝悓涓婏紝鎵f枡鍙戠敓鍦ㄨ川妫�涔嬪墠锛�
+ 鈹斺攢 鐢熸垚浜у嚭鍗曪細鍙缓涓�鏉°�屽緟妫�楠屻�嶈锛屼笉寤烘槑缁�
+ 鈹斺攢 鎶ュ伐鐘舵�� 鈫� 寰呮楠�
+寰呮浠诲姟椤碉紙quality_status = 寰呮楠� 鐨勪骇鍑鸿锛�
+ 鈹斺攢 鍒涘缓杩囩▼妫�楠屽崟锛堥渶鐗╂枡宸查厤缃� IPQC 妫�楠屾ā鏉匡級
+ 鈹斺攢 瀹屾垚妫�楠� finishIpqc
+ 鈹溾攢 鎸夊悎鏍�/涓嶅悎鏍兼媶寰呮琛屻�佺敓鎴愭槑缁�
+ 鈹溾攢 finishProductProduce锛堝叆搴擄紝鏈亾鐢熸垚鍏ュ簱鍗曪級
+ 鈹溾攢 鍥炲啓鎶ュ伐鍚堟牸/涓嶅悎鏍�/搴熷搧鏁伴噺锛岀姸鎬� 鈫� 宸插畬鎴�
+ 鈹斺攢 涓嶅悎鏍艰嚜鍔ㄧ敓鎴� NCR
+```
+
+## 涓夈�侀棶棰樻眹鎬�
+
+| 缂栧彿 | 浼樺厛绾� | 妯″潡 | 闂鎽樿 |
+|---|---|---|---|
+| Q1 | P0 | 璐ㄦ鍥炲啓 | 璐ㄦ瀹屾垚鍥炶皟鏈洿鏂颁换鍔�/宸ュ崟/MPS 鏁伴噺 |
+| Q2 | P0 | 鎶ュ伐 | 鍏抽敭宸ュ簭鏁伴噺鏇存柊鏃剁偣鏃╀簬浜у嚭鍗曠敓鎴愶紝鍚堟牸/涓嶅悎鏍兼亽涓� 0 |
+| Q3 | P1 | 鎶ュ伐 | 鏈亾宸ュ簭鑻ラ潪鍏抽敭宸ュ簭锛屽伐鍗�/MPS 宸茬敓浜ф暟閲忔案涓嶇疮鍔� |
+| Q4 | P1 | 鎶ュ伐 | 璺嚎宸ュ簭鏌ヤ笉鍒版椂锛岄潤榛橀檷绾т负銆屼笉璐ㄦ銆佷笉鎵f枡銆� |
+| Q5 | P0 | 杩囩▼妫�楠� | 璐ㄦ鏁伴噺鏃犱竴鑷存��/涓婇檺鏍¢獙锛屽彲瓒呴噺鍏ュ簱 |
+| Q6 | P0 | 杩囩▼妫�楠�/鍏ュ簱 | 涓嶅悎鏍煎搧涔熸寜姝e父鍝佸垱寤哄叆搴撲簨鍔★紝娣峰叆鍙敤搴撳瓨 |
+| Q7 | P1 | 杩囩▼妫�楠� | 鍏ㄩ儴涓嶅悎鏍兼垨鍚堟牸鏁颁负 0 鏃朵骇鐢� 0 鏁伴噺鑴忔暟鎹� |
+| Q8 | P1 | 杩囩▼妫�楠� | 鍚屼竴寰呮琛屽彲閲嶅鍒涘缓澶氬紶妫�楠屽崟 |
+| Q9 | P2 | 杩囩▼妫�楠� | 鎵嬪伐/瀵煎叆鍒涘缓鐨勬楠屽崟闈� taskId 鍏滃簳鍥炲啓锛屽彲鑳戒覆鍗曟垨澶辫触 |
+| Q10 | P1 | 杩囩▼妫�楠� | 鏃犳楠屾ā鏉挎椂鍒涘缓鎶ラ敊涓嶆槑纭紱鎶ュ伐鍗″湪寰呮 |
+| P1 | P0 | 浜у嚭鍏ュ簱 | 鏈亾宸ュ簭鏈厤缃骇鍑轰粨鏃讹紝鎴愬搧婊炵暀铏氭嫙绾胯竟搴� |
+| P2 | P1 | 浜у嚭鍏ュ簱 | 鑷姩鍏ュ簱鍗曞彧寤鸿涓嶅缓鏄庣粏锛屾墽琛屽叆搴撳繀鐒跺け璐� |
+| P3 | P2 | 浜у嚭鍏ュ簱 | 寰呮鏈熼棿浜у搧瀹屽叏涓嶅叆璐︼紙璐﹀锛� |
+| D1 | P1 | 鑷姩鎵f枡 | 鍊掑啿鎵f枡鏃犲彲鐢ㄩ噺鏍¢獙锛岀嚎杈瑰簱鍙鎵f垚璐熸暟 |
+| D2 | P2 | 鑷姩鎵f枡 | 鍚屼竴宸ュ簭 BOM 鍑虹幇鍚屼竴鐗╂枡澶氳鏃讹紝閲嶅鍗犵敤鍚屼竴鎵规 |
+
+## 鍥涖�佷慨鏀规柟妗�
+
+### Q1 璐ㄦ瀹屾垚鍥炶皟琛ュ洖鍐欎换鍔�/宸ュ崟/MPS
+
+- 浣嶇疆锛歚MesProFeedbackServiceImpl.java:632-658`
+- 鐜拌薄锛氭柟娉曟敞閲婂啓鐫�銆�4. 鏇存柊浠诲姟/宸ュ崟鐨勫凡鐢熶骇鏁伴噺銆嶏紝浣嗗彧瀵瑰唴瀛樺璞� `set` 浜嗕袱涓瓧娈碉紝娌℃湁璋冪敤 `updateTaskAndWorkOrderByFeedback`銆傜粨鏋滆川妫�宸ュ簭鐨勫悎鏍�/涓嶅悎鏍兼暟涓嶈繘浠诲姟锛涙湯閬撳伐搴忎负璐ㄦ宸ュ簭鏃讹紝宸ュ崟 `quantity_produced` 涓� MPS `quantity_produced` 涓嶇疮鍔狅紝MPS/閿�鍞鍗曠殑銆岀敓浜у畬鎴愩�嶅垽瀹氭案杩滀笉婊¤冻銆�
+- 鏂规锛�
+ 1. 绗� 5 姝ヤ箣鍓嶉噸鏂拌鍙栨姤宸ュ崟鏈�鏂版暟鎹紙鐘舵�佸凡鏀逛负宸插畬鎴愶紝涓旀暟閲忓凡鍥炲啓锛夈��
+ 2. 璋冪敤涓庣洿鎺ュ叆搴撳垎鏀粺涓�鐨勮繘搴︽洿鏂版柟娉� `updateTaskAndWorkOrderByFeedback(feedback)`銆�
+ 3. 鍒犻櫎绗� 655 琛屾棤鏁堢殑 `feedback.setQualifiedQuantity(...)` 璋冪敤銆�
+- 褰卞搷锛氫换鍔°�佸伐鍗曘�丮PS銆侀攢鍞鍗曠敓浜у畬鎴愪簨浠剁殑鏁伴噺鍙e緞淇銆�
+
+### Q2 淇鍏抽敭宸ュ簭鏁伴噺鏇存柊鏃剁偣
+
+- 浣嶇疆锛歚MesProFeedbackServiceImpl.java:330-360`
+- 鐜拌薄锛歚keyFlag=true` 鏃跺厛璋冪敤 `updateTaskAndWorkOrderByFeedback`锛岃�岃鏂规硶鏄寜 `feedbackId` 鑱氬悎浜у嚭鍗曡璁$畻鍚堟牸/涓嶅悎鏍兼暟锛涙鏃朵骇鍑哄崟灏氭湭鐢熸垚锛岃仛鍚堢粨鏋滄亽涓� 0銆�
+- 鏂规锛堜簩閫変竴锛屾帹鑽愭柟妗� A锛夛細
+ - **A锛堢粺涓�鏀跺彛锛�**锛氭妸銆屼换鍔�/宸ュ崟/MPS 杩涘害鏇存柊銆嶄粠 `approveFeedback` 涓Щ闄わ紝缁熶竴鏀惧埌浜у嚭鍗曠敓鎴�/瀹屾垚涔嬪悗鎵ц锛涙棤璐ㄦ鍦� `finishProductProduce` 涔嬪悗璋冪敤锛屾湁璐ㄦ鍦� `updateProFeedbackWhenIpqcFinish` 涓皟鐢ㄣ�俙approveFeedback` 鍙礋璐f墸鏂欍�佺敓鎴愪骇鍑哄崟鍜岀姸鎬佹祦杞��
+ - **B锛堝垎灞傛洿鏂帮級**锛歚approveFeedback` 鍙疮鍔� `producedQuantity`锛堜笉渚濊禆浜у嚭鍗曪級锛屽悎鏍�/涓嶅悎鏍兼暟鍦ㄤ骇鍑哄崟瀹屾垚鍚庡崟鐙疮鍔犮��
+- 褰卞搷锛氬叧閿伐搴忕殑浠诲姟鍚堟牸鏁般�佷笉鍚堟牸鏁版仮澶嶆纭��
+
+### Q3 鏈亾宸ュ簭宸ュ崟/MPS 鏇存柊涓� keyFlag 瑙h��
+
+- 浣嶇疆锛歚MesProFeedbackServiceImpl.java:338-347`
+- 鐜拌薄锛氬伐鍗� `quantity_produced` 鍜� MPS `quantity_produced` 鐨勭疮鍔犺鏀惧湪 `keyFlag=true` 鍒嗘敮鍐咃紝涓斿唴閮ㄥ啀鍒ゆ柇鏄惁鏈亾宸ュ簭銆傝嫢鏈亾宸ュ簭鏈厤缃�屽叧閿伐搴忋�嶏紝宸ュ崟浜у嚭姘歌繙涓� 0銆�
+- 鏂规锛氬皢銆屾槸鍚︽湯閬撳伐搴忋�嶅垽鏂嫭绔嬪嚭鏉ワ紱鍙鏈鎶ュ伐宸ュ簭鏄湯閬撳伐搴忥紝鏃犺 `keyFlag` 涓庡惁閮芥洿鏂板伐鍗�/MPS銆俙keyFlag` 鍙奖鍝嶆槸鍚﹂渶瑕侀噸澶嶇疮鍔犱腑闂村伐搴忎骇鍑猴紙鎸夌幇鏈変笟鍔℃剰鍥句繚鐣欙級銆�
+- 闇�纭锛氫腑闂村伐搴忔槸鍚﹁鍏ュ伐鍗曚骇鍑恒�傝嫢涓嶈鍏ワ紝鍒欎粎鏈亾宸ュ簭绱姞锛涜嫢璁″叆锛屽垯鎵�鏈夊伐搴忛兘绱姞锛屼簩鑰呭彧淇濈暀涓�绉嶅彛寰勩��
+
+### Q4 璺嚎宸ュ簭缂哄け涓嶅啀闈欓粯闄嶇骇
+
+- 浣嶇疆锛歚MesProFeedbackServiceImpl.java:300-314`
+- 鐜拌薄锛歚getRouteProcessByRouteIdAndProcessId` 杩斿洖 null 鏃讹紝`keyFlag`銆乣checkFlag`銆乣backflushFlag` 鍏ㄩ儴鎸� false 澶勭悊锛屾棦涓嶆墸鏂欎篃涓嶈繘璐ㄦ锛屼笖娌℃湁浠讳綍鎻愮ず銆�
+- 鏂规锛�
+ 1. 鏌ヨ涓嶅埌璺嚎宸ュ簭鏃舵姏鍑轰笟鍔″紓甯革紙鎻愮ず銆屾姤宸ュ伐搴忔湭鍦ㄥ伐鑹鸿矾绾夸腑鎵惧埌锛岃妫�鏌ュ伐鍗曞伐鑹鸿矾绾块厤缃�嶏級銆�
+ 2. 鑻ヤ笟鍔″厑璁稿巻鍙叉暟鎹瓨鍦紝鍒欒嚦灏戣褰� error 鏃ュ織骞跺湪鎺ュ彛杩斿洖涓彁绀猴紝绂佹闈欓粯銆�
+- 褰卞搷锛氶伩鍏嶅洜閰嶇疆缂哄け瀵艰嚧鏉愭枡涓嶆墸銆佽川妫�璺宠繃鍗存棤浜哄彂鐜般��
+
+### Q5 杩囩▼妫�楠屾暟閲忎竴鑷存�ф牎楠�
+
+- 浣嶇疆锛歚MesQcIpqcServiceImpl.java:225-244`锛沗MesWmProductProduceServiceImpl.java:270-325`
+- 鐜拌薄锛氬畬鎴愭楠屽彧鏍¢獙銆屾娴嬬粨璁洪潪绌� + 鑷冲皯涓�鏉℃娴嬮」銆嶏紝涓嶆牎楠岋細
+ - `妫�娴嬫暟閲� = 鍚堟牸鏁伴噺 + 涓嶅悎鏍兼暟閲廯
+ - `妫�娴嬫暟閲� 鈮� 寰呮浜у嚭琛屾暟閲廯
+- 鍚庢灉锛氬彲濉嚭瓒呰繃鎶ュ伐鏁伴噺鐨勫悎鏍兼暟锛屾媶琛屽悗鎸夊~鎶ユ暟鐢熸垚鍏ュ簱鏄庣粏锛岄�犳垚瓒呴噺鍏ュ簱銆�
+- 鏂规锛歚finishIpqc` 鍦ㄦ洿鏂扮姸鎬佸墠澧炲姞鏍¢獙锛�
+ 1. 鍚堟牸鏁般�佷笉鍚堟牸鏁颁笉寰椾负璐熴��
+ 2. 鍚堟牸鏁� + 涓嶅悎鏍兼暟 = 妫�娴嬫暟閲忋��
+ 3. 鑻ユ潵婧愪负鎶ュ伐浜у嚭琛岋紝妫�娴嬫暟閲忎笉寰楀ぇ浜庤寰呮琛岀殑鏁伴噺銆�
+ 4. 鏍¢獙澶辫触杩斿洖鏄庣‘閿欒鐮侊紙鏂板 `QC_IPQC_QUANTITY_MISMATCH`銆乣QC_IPQC_QUANTITY_EXCEEDS_SOURCE`锛夈��
+- 鍚屾锛歚MesWmProductProduceServiceImpl#splitPendingAndFinishProduce` 澧炲姞鍏滃簳鏍¢獙锛岄槻姝㈢粫杩� IPQC 鐩存帴璋冪敤銆�
+
+### Q6 涓嶅悎鏍煎搧涓嶅緱鎸夋甯稿搧鍏ヨ处
+
+- 浣嶇疆锛歚MesWmProductProduceServiceImpl.java:96銆�110-134`锛沗MesWmProductReceiptServiceImpl.java:106-112`
+- 鐜拌薄锛歚finishProductProduce` 瀵逛笂鎵�鏈変骇鍑哄崟琛屽垱寤� IN 浜嬪姟锛堝惈 `FAIL` 琛岋級锛屼粨搴撲负姝e父浜у嚭浠�/绾胯竟搴擄紱鑰屼骇鍝佸叆搴撳崟鍙 `PASS` 琛岀敓鎴愩�傜粨鏋滀笉鍚堟牸鍝佹湁搴撳瓨銆佹棤鍗曟嵁锛屼笌鍚堟牸鍝佹贩鏀撅紝鍙鍚庣画棰嗙敤鎴栧彂璐с�侼CR 鍙缓鍗曪紝涓嶅仛搴撳瓨闅旂銆�
+- 鏂规锛堥渶涓氬姟纭锛屼簩閫変竴锛夛細
+ - **A锛堟帹鑽愶級涓嶅悎鏍煎搧鍏ヤ笉鑹搧浠�**锛歚resolveOutputTarget` 澧炲姞鎸夎川閲忕姸鎬侀�夋嫨浠撳簱锛沗FAIL` 琛岄粯璁ゅ叆涓嶈壇鍝佷粨锛堝彲閰嶇疆锛夛紝`PASS` 琛屽叆姝e父浜у嚭浠撱��
+ - **B 涓嶅悎鏍煎搧涓嶅叆璐�**锛氬彧瀵� `PASS` 琛屽垱寤� IN 浜嬪姟锛宍FAIL` 琛屼粎淇濈暀浜у嚭璁板綍锛岀敱 NCR 鍚庣画澶勭疆锛堣繑宸�/鎶ュ簾锛夋椂鍐嶈蛋搴撳瓨浜嬪姟銆�
+- 鏃犺鍝锛岄兘瑕佹眰銆屽簱瀛樹簨鍔¤銆嶄笌銆屽叆搴撳崟琛屻�嶅彛寰勪竴鑷淬��
+
+### Q7 鍏ㄩ儴涓嶅悎鏍�/闆舵暟閲忎笉鍐嶄骇鐢熻剰鏁版嵁
+
+- 浣嶇疆锛歚MesWmProductProduceServiceImpl.java:282-321`
+- 鐜拌薄锛氬悎鏍兼暟涓� 0 鏃讹紝寰呮琛屼粛琚敼鎴� `PASS`銆佹暟閲� 0锛屽苟鐢熸垚 0 鏁伴噺鏄庣粏鍜� 0 鏁伴噺鍏ュ簱浜嬪姟銆�
+- 鏂规锛�
+ 1. 鍚堟牸鏁颁负 0 涓斾笉鍚堟牸鏁� > 0 鏃讹紝寰呮琛岀洿鎺ユ爣璁颁负 `FAIL`锛屼笉鐢熸垚鍚堟牸鏄庣粏銆�
+ 2. 鏁伴噺涓� 0 鐨勮涓嶅垱寤烘槑缁嗐�佷笉鍒涘缓搴撳瓨浜嬪姟銆�
+ 3. 鑻ュ悎鏍兼暟涓庝笉鍚堟牸鏁板潎涓� 0锛屽畬鎴愭楠岀洿鎺ユ姤閿欍��
+
+### Q8 闃叉鍚屼竴寰呮琛岄噸澶嶅缓妫�楠屽崟
+
+- 浣嶇疆锛氫骇鍑鸿 DO锛沗MesQcIpqcServiceImpl.java:368-371`
+- 鐜拌薄锛氫骇鍑鸿娌℃湁鍜� IPQC 鐨勫叧鑱斿瓧娈碉紝鍒涘缓鏃跺彧鏍¢獙 `PENDING`銆傜涓�寮犳楠屽崟瀹屾垚鍓嶅彲閲嶅鍒涘缓澶氬紶锛涚浜屽紶瀹屾垚鏃跺洜浜у嚭鍗曞凡瀹屾垚鎶涘紓甯稿洖婊氾紝鐣欎笅鏃犳硶瀹屾垚鐨勬楠屽崟銆�
+- 鏂规锛�
+ 1. `mes_wm_product_produce_line` 澧炲姞 `ipqc_id`锛圔IGINT锛屽彲绌猴級銆�
+ 2. `createIpqc` 鏍¢獙浜у嚭琛� `ipqc_id` 涓虹┖锛涘垱寤烘垚鍔熷悗鍥炲啓 `ipqc_id`銆�
+ 3. 寰呮浠诲姟 SQL 澧炲姞 `ppl.ipqc_id IS NULL` 杩囨护銆�
+ 4. 鍒犻櫎妫�楠屽崟鏃舵竻闄� `ipqc_id`锛堜粎鑽夌鐘舵�佸厑璁稿垹闄わ級銆�
+- 鏁版嵁搴撳彉鏇磋绗叚鑺傘��
+
+### Q9 鎵嬪伐/瀵煎叆鍒涘缓鐨勬楠屽崟鍥炲啓鍙潬鎬�
+
+- 浣嶇疆锛歚MesQcIpqcServiceImpl.java:279-297`
+- 鐜拌薄锛氭病鏈夋潵婧愬崟鎹椂锛屾寜 `taskId` 鎵剧涓�寮犮�屽緟妫�楠屻�嶆姤宸ュ厹搴曘�傚悓涓�浠诲姟澶氬紶寰呮浼氫覆鍗曪紱`sourceLineId` 涓虹┖鏃舵媶鍒嗙洿鎺ユ姏寮傚父銆�
+- 鏂规锛�
+ 1. 鏉ユ簮涓烘姤宸ユ椂寮哄埗瑕佹眰 `sourceDocId` + `sourceLineId`锛堝墠绔彧鍏佽浠庡緟妫�浠诲姟椤靛彂璧凤級銆�
+ 2. 绉婚櫎鎸� `taskId` 鐚滄祴鍥炲啓鐨勯�昏緫锛屾敼涓烘棤娉曞畾浣嶆潵婧愭椂鏄庣‘鎶ラ敊鎴栬烦杩囧苟璁板綍 warning銆�
+ 3. 瀵煎叆鍒涘缓鐨勬楠屽崟涓嶅厑璁稿叧鑱旀潵婧愶紝瀹屾垚鍚庝笉鎺ㄨ繘鎶ュ伐锛堜繚鎸佺幇鐘朵絾鎵撴棩蹇楋級銆�
+
+### Q10 鏃犳楠屾ā鏉挎椂鐨勬彁绀轰笌鐘舵�佸鐞�
+
+- 浣嶇疆锛歚MesQcIpqcServiceImpl.java:140-143`锛沗MesQcTemplateItemServiceImpl.java:118-141`
+- 鐜拌薄锛氱墿鏂欐湭閰嶇疆 IPQC 妯℃澘鏃跺垱寤烘楠屽崟鎶� `QC_NO_TEMPLATE`锛岀幇鍦洪毦浠ュ畾浣嶏紱鎶ュ伐宸茶繘鍏ュ緟妫�锛岃嫢鏃犳硶鍒涘缓妫�楠屽崟浼氭案涔呭崱浣忋��
+- 鏂规锛�
+ 1. 鎶ラ敊鏂囨鏄庣‘涓恒�岀墿鏂欍�恱xx銆戞湭閰嶇疆 IPQC 妫�楠屾柟妗堬紝璇峰厛鍦ㄨ川妫�妯℃澘涓负璇ョ墿鏂欏惎鐢ㄨ繃绋嬫楠屻�嶃��
+ 2. 寰呮浠诲姟鍒楄〃澧炲姞銆屾槸鍚﹀彲妫�楠屻�嶆彁绀猴紙渚濇嵁妯℃澘鍖归厤缁撴灉锛夛紝閬垮厤鐢ㄦ埛鐩茬洰鐐瑰垱寤恒��
+ 3. 鎶ュ伐瀹℃壒鏃惰嫢宸ュ簭 `checkFlag=1`锛屽鍔犱竴娆℃ā鏉垮瓨鍦ㄦ�ч妫�锛岀己澶辨椂鍦ㄥ鎵瑰墠鐩存帴鎻愮ず锛堥伩鍏嶆姤宸ヨ繘鍏ュ緟妫�鍚庢墠澶辫触锛夈��
+- 闇�纭锛氭槸鍚﹀厑璁搞�屾棤妯℃澘浣嗘湁宸ュ簭妫�楠屾爣璇嗐�嶇殑鎶ュ伐鐩存帴鏀捐骞惰涓哄厤妫�銆�
+
+### P1 鏈亾宸ュ簭浜у嚭浠撳厹搴曠瓥鐣�
+
+- 浣嶇疆锛歚MesWmProductProduceServiceImpl.java:327-354`锛沗MesWmProductReceiptServiceImpl.java:269-273`
+- 鐜拌薄锛氭湯閬撳伐搴忔湭閰嶇疆浜у嚭浠撴椂鍥為��铏氭嫙绾胯竟搴擄紱浜у嚭浜嬪姟璁板叆绾胯竟搴擄紝鑷姩鍏ュ簱鍗曞張鍥� `produceId != null` 璺宠繃杞Щ浜嬪姟锛屾垚鍝佹案杩滅暀鍦ㄧ嚎杈瑰簱锛屼笉浼氳繘鍏ユ垚鍝佷粨銆�
+- 鏂规锛堟帹鑽� A锛夛細
+ - **A 寮哄埗閰嶇疆**锛氭湯閬撳伐搴忓繀椤婚厤缃姤宸ヤ粨搴擄紙宸ュ崟宸ュ簭鎴栧伐鑹鸿矾绾夸骇鍝侊級锛宍resolveOutputTarget` 鍦ㄦ湯閬撳伐搴忎笉鍏佽鍥為��铏氭嫙绾胯竟搴擄紝缂哄け鏃跺鎵规姤閿欍��
+ - **B 鑷姩杞Щ**锛氳嚜鍔ㄥ叆搴撳崟瀹屾垚鏃讹紝鑻ユ槑缁嗕粨搴撲负铏氭嫙绾胯竟搴擄紝琛ュ仛銆岀嚎杈瑰簱 OUT + 瀹為檯浠� IN銆嶏紱闇�瑕佸叆搴撳崟鑳界‘瀹氱洰鏍囨垚鍝佷粨銆�
+- 鍚屾椂鏄庣‘锛氫腑闂村伐搴忎骇鍑烘槸鍚﹀厑璁歌繘瀹為檯浠撱�傝嫢鍏佽锛屽簲鍚屾鐢熸垚瀵瑰簲鐨勫崐鎴愬搧鍏ュ簱鍗曪紝閬垮厤銆屾湁搴撳瓨鏃犲崟鎹�嶃��
+
+### P2 鑷姩鍏ュ簱鍗曡ˉ榻愭槑缁�
+
+- 浣嶇疆锛歚MesWmProductReceiptServiceImpl.java:160-168`锛沗finishProductReceipt` 鏄庣粏闈炵┖鏍¢獙 `:264-267`
+- 鐜拌薄锛氳嚜鍔ㄧ敓鎴愮殑浜у搧鍏ュ簱鍗曞彧鏈夎銆佹病鏈夋槑缁嗭紝鎵ц鍏ュ簱浼氬洜銆屾棤鏄庣粏銆嶅け璐ワ紝蹇呴』浜哄伐琛ャ��
+- 鏂规锛歚generateProductReceipt` 鐢熸垚琛岀殑鍚屾椂锛屾寜浜у嚭鍗曟槑缁嗙敓鎴愬叆搴撴槑缁嗭紙浠撳簱銆佸簱浣嶃�佸簱鍖恒�佹壒娆°�佹暟閲忓潎鍙粠 `mes_wm_product_produce_detail` 甯﹀嚭锛夈�傝嫢閲囩敤 P1-A锛堜骇鍑虹洿鎺ュ叆鎴愬搧浠擄級锛屽垯鍏ュ簱鍗曚粎浣滀笟鍔″嚟璇侊紝闇�鍦ㄩ〉闈笂鏄庣‘鏍囪瘑銆岃嚜鍔ㄥ崟鎹紝鏃犻渶鎵ц鍏ュ簱銆嶏紝鎴栨敼涓虹敱浜у嚭鍗曠洿鎺ョ敓鎴愬凡瀹屾垚鍏ュ簱鍗曘��
+
+### P3 寰呮鏈熼棿浜у搧涓嶅叆璐︼紙璁捐鏉冭 锛�
+
+- 浣嶇疆锛歚MesWmProductProduceServiceImpl.java:190-195`
+- 鐜拌薄锛歚checkFlag=true` 鏃朵笉鐢熸垚浠讳綍搴撳瓨浜嬪姟锛屼骇鍝佸湪寰呮鏈熼棿澶勪簬璐﹀鐘舵�併��
+- 鏂规锛氬闇�涓ユ牸搴撳瓨绠$悊锛屽彲鍦ㄥ鎵规椂鍏堝皢寰呮鏁伴噺鍏ャ�屽緟妫�浠撱�嶏紝璐ㄦ瀹屾垚鍚庡仛銆屽緟妫�浠� 鈫� 鍚堟牸浠� / 涓嶈壇鍝佷粨銆嶈浆绉伙紱鑻ユ帴鍙楀綋鍓嶅彛寰勶紝鍒欏湪鏂囨。涓庢姤琛ㄤ腑璇存槑寰呮浜у搧涓嶈搴撳瓨銆�
+
+### D1 鍊掑啿鎵f枡鍙敤閲忔牎楠�
+
+- 浣嶇疆锛歚MesWmItemConsumeServiceImpl.java:126-159銆�192`
+- 鐜拌薄锛氱嚎杈瑰簱鏃犲簱瀛樻垨涓嶈冻鏃朵粛鐢熸垚鏃犳壒娆℃槑缁嗭紝涓斿簱瀛樹簨鍔� `checkFlag=false` 鍏佽璐熷簱瀛橈紝鎵f垚璐熸暟鏃犳彁绀恒��
+- 鏂规锛�
+ 1. 涓ユ牸妯″紡锛氬�掑啿鍓嶆牎楠岀嚎杈瑰簱鍙敤閲忥紝涓嶈冻鏃舵姤閿欏苟鎻愮ず銆岃鍏堟墽琛岀敓浜ч鏂欍�嶃��
+ 2. 瀹芥澗妯″紡锛堣嫢涓氬姟鍏佽璐熷簱瀛橈級锛氫繚鐣欐墸鍑忥紝浣嗚繑鍥�/璁板綍棰勮锛屽苟鍦ㄦ姤宸ュ鎵圭粨鏋滀腑鎻愮ず鍙敤閲忎笉瓒炽��
+- 闇�纭锛氱嚎杈瑰簱鏄惁鍏佽璐熷簱瀛樸�傚缓璁粯璁や弗鏍兼ā寮忋��
+
+### D2 鍚屼竴鐗╂枡澶氳閲嶅鍗犵敤鎵规
+
+- 浣嶇疆锛歚MesWmItemConsumeServiceImpl.java:126-159`
+- 鐜拌薄锛氭瘡鏉℃秷鑰楄鐙珛鏌ヨ搴撳瓨蹇収鍋� FIFO锛屽悓涓�宸ュ簭 BOM 鑻ュ嚭鐜板悓涓�鐗╂枡澶氳锛屼細閲嶅鍗犵敤鍚屼竴鎵规銆�
+- 鏂规锛�
+ 1. 鏈嶅姟绔牎楠屽悓涓�宸ュ簭 BOM 鐗╂枡涓嶅彲閲嶅锛堜繚瀛樻椂鎶ラ敊锛夈��
+ 2. 娑堣�楃敓鎴愭椂鎸� `itemId` 鍚堝苟鍚庡啀鍒嗛厤鎵规銆�
+ 3. 鎴栬�呭湪鍐呭瓨涓淮鎶ゃ�屽凡鍒嗛厤閲忋�嶏紝姣忔潯琛岀殑鍙敤閲� = 搴撳瓨鏁伴噺 - 宸插垎閰嶉噺銆�
+
+## 浜斻�侀渶瑕佺‘璁ょ殑涓氬姟鍐崇瓥
+
+| 缂栧彿 | 鍐崇瓥鐐� | 澶囬�� |
+|---|---|---|
+| 1 | 涓嶅悎鏍煎搧搴撳瓨鍘诲悜 | 鍏ヤ笉鑹搧浠� / 涓嶅叆璐︾敱 NCR 澶勭疆 / 鍐荤粨 |
+| 2 | 宸ュ崟宸茬敓浜ф暟閲忓彛寰� | 鍙疮璁℃湯閬撳伐搴� / 绱鎵�鏈夊伐搴� |
+| 3 | 鏈亾宸ュ簭浜у嚭浠� | 寮哄埗閰嶇疆 / 鑷姩浠庣嚎杈瑰簱杞Щ鍒版垚鍝佷粨 |
+| 4 | 涓棿宸ュ簭浜у嚭 | 鍙叆绾胯竟搴� / 鍏佽鍏ュ疄闄呬粨骞剁敓鎴愬崐鎴愬搧鍏ュ簱鍗� |
+| 5 | 绾胯竟搴撹礋搴撳瓨 | 绂佹 / 鍏佽骞堕璀� |
+| 6 | 寰呮鏈熼棿搴撳瓨 | 涓嶅叆璐︼紙鐜扮姸锛�/ 鍏ュ緟妫�浠� |
+| 7 | 鏃犳楠屾ā鏉夸絾宸ュ簭瑕佹眰妫�楠� | 鎶ュ伐瀹℃壒鏃舵姤閿� / 鍏佽鍏嶆鏀捐 |
+
+## 鍏�佹暟鎹簱鍙樻洿
+
+```sql
+-- Q8锛氫骇鍑鸿鍏宠仈杩囩▼妫�楠屽崟锛岄槻姝㈤噸澶嶅缓鍗�
+ALTER TABLE mes_wm_product_produce_line
+ ADD COLUMN ipqc_id BIGINT NULL COMMENT '杩囩▼妫�楠屽崟ID' AFTER quality_status;
+
+CREATE INDEX idx_ppl_ipqc_id ON mes_wm_product_produce_line (ipqc_id);
+```
+
+> 鑻� Q6 閫夋嫨銆屼笉鍚堟牸鍝佸叆涓嶈壇鍝佷粨銆嶏紝闇�琛ュ厖涓嶈壇鍝佷粨鐨勯厤缃」锛堝缓璁鐢ㄤ粨搴撶被鍨嬪瓧娈垫垨鏂板瀛楀吀锛夛紝涓嶆柊澧炰笟鍔¤〃瀛楁鍓嶅厛纭鐜版湁浠撳簱妯″瀷銆�
+
+## 涓冦�佸疄鏂介『搴�
+
+1. **绗竴鎵癸紙鏁版嵁姝g‘鎬э紝P0锛�**
+ - Q1 璐ㄦ鍥炶皟琛ュ啓浠诲姟/宸ュ崟/MPS
+ - Q2 璋冩暣鏁伴噺鏇存柊鏃剁偣
+ - Q5 璐ㄦ鏁伴噺鏍¢獙
+ - Q6 涓嶅悎鏍煎搧鍏ヨ处鍙e緞
+2. **绗簩鎵癸紙娴佺▼闂幆锛孭1锛�**
+ - Q3 鏈亾宸ュ簭涓� keyFlag 瑙h��
+ - Q4 璺嚎宸ュ簭缂哄け鎶ラ敊
+ - Q7 闆舵暟閲忚剰鏁版嵁
+ - Q8 閲嶅寤哄崟锛堝惈 DDL锛�
+ - Q10 妯℃澘缂哄け鎻愮ず
+ - P1 鏈亾浜у嚭浠撶瓥鐣�
+ - P2 鑷姩鍏ュ簱鏄庣粏
+3. **绗笁鎵癸紙鍋ュ.鎬э紝P2锛�**
+ - Q9 鏉ユ簮鍗曟嵁寮烘牎楠�
+ - D1 鍙敤閲忔牎楠�
+ - D2 BOM 閲嶅鐗╂枡
+ - P3 寰呮浠擄紙鍙�夛級
+
+## 鍏�佹祴璇曢獙璇佹竻鍗�
+
+- [ ] 闈炲�掑啿宸ュ簭鎶ュ伐锛氫笉鎵f枡銆佺洿鎺ュ叆搴撱�佹湯閬撶敓鎴愬叆搴撳崟
+- [ ] 鍊掑啿宸ュ簭鎶ュ伐锛氭秷鑰楀崟鏁伴噺 = 鍗曚綅鐢ㄦ枡 脳 鎶ュ伐鏁伴噺锛孎IFO 鎵规姝g‘锛屽簱瀛樻墸鍑忔纭�
+- [ ] 鍊掑啿宸ュ簭绾胯竟搴撲笉瓒筹細鎸夌‘璁ょ殑妯″紡鎶ラ敊鎴栭璀�
+- [ ] 鏃犻渶妫�楠� + 鏈亾宸ュ簭锛氫骇鍑轰簨鍔′笌鍏ュ簱鍗曚竴鑷�
+- [ ] 闇�妫�楠岋細鎶ュ伐杩涘叆寰呮锛屽緟妫�椤靛嚭鐜颁骇鍑鸿
+- [ ] 鏃� IPQC 妯℃澘锛氬垱寤烘楠屽崟缁欏嚭鏄庣‘鎻愮ず
+- [ ] IPQC 鍏ㄩ儴鍚堟牸锛氭姤宸ュ畬鎴愩�佷骇鍑哄叆搴撱�佷换鍔�/宸ュ崟/MPS 鏁伴噺姝g‘
+- [ ] IPQC 閮ㄥ垎涓嶅悎鏍硷細鍚堟牸鍝佸叆姝e父浠撱�佷笉鍚堟牸鍝佹寜纭鍙e緞澶勭悊锛孨CR 鐢熸垚
+- [ ] IPQC 鍏ㄩ儴涓嶅悎鏍硷細涓嶄骇鐢� 0 鏁伴噺鏄庣粏涓庝簨鍔★紝浠诲姟/宸ュ崟鏁伴噺姝g‘
+- [ ] IPQC 鏁伴噺瓒呰繃寰呮鏁伴噺锛氳鎷︽埅
+- [ ] 鍚屼竴寰呮琛岄噸澶嶅缓鍗曪細绗簩寮犺鎷︽埅
+- [ ] 鍏抽敭宸ュ簭 + 璐ㄦ锛氬悎鏍�/涓嶅悎鏍兼暟閲忚繘鍏ヤ换鍔�
+- [ ] 鏈亾宸ュ簭闈炲叧閿細宸ュ崟/MPS 浜у嚭绱姞
+- [ ] 鏈亾宸ュ簭鏈厤缃骇鍑轰粨锛氭寜纭绛栫暐鎶ラ敊鎴栬浆绉�
+- [ ] 鑷姩鍏ュ簱鍗曪細鏄庣粏榻愬叏锛屽彲瀹屾垚鍏ュ簱锛堟垨鏄庣‘涓哄厤鎵ц鍑瘉锛�
+- [ ] 瀹℃壒閲嶅鎻愪氦锛氭墸鏂欍�佷骇鍑哄崟銆佸叆搴撳崟鍧囦笉閲嶅
diff --git a/docs/qc_source_link_frontend_integration.md b/docs/qc_source_link_frontend_integration.md
new file mode 100644
index 0000000..003687a
--- /dev/null
+++ b/docs/qc_source_link_frontend_integration.md
@@ -0,0 +1,121 @@
+# 璐ㄦ鍗曞叧鑱旂敓浜ф姤宸�/閿�鍞嚭搴� - 鍓嶇鑱旇皟鏂规
+
+## 娑夊強椤甸潰
+
+- 璐ㄩ噺绠$悊 鈫� 杩囩▼妫�楠岋紙IPQC锛夊垪琛ㄣ�佽鎯�
+- 璐ㄩ噺绠$悊 鈫� 鍑鸿揣妫�楠岋紙OQC锛夊垪琛ㄣ�佽鎯�
+- 鐢熶骇绠$悊 鈫� 鐢熶骇鎶ュ伐锛堝彧璇诲弬鑰冿細鎶ュ伐鍗曞彿銆佺姸鎬併�佺洏鍙凤級
+- 浠撳偍绠$悊 鈫� 閿�鍞嚭搴撳崟锛堝彧璇诲弬鑰冿細鍑哄簱鍗曞彿銆佹槑缁嗙洏鍙枫�佽川閲忕姸鎬侊級
+
+## 涓氬姟娴佺▼涓庢暟鎹甫鍏�
+
+### 杩囩▼妫�楠岋紙IPQC锛夊叧鑱旂敓浜ф姤宸�
+
+1. 璐ㄦ宸ュ簭鎶ュ伐瀹℃壒閫氳繃鍚庯紝鎶ュ伐鍗曡浆涓恒�屽緟妫�楠岋紙3锛夈�嶏紝鍚屾椂鐢熸垚璐ㄩ噺鐘舵�佷负銆屽緟妫�楠岋紙0锛夈�嶇殑浜у嚭琛岋紝浜у嚭琛岀洏鍙锋潵鑷敓浜у伐鍗曘��
+2. 璐ㄦ鍛樼嫭绔嬫柊寤烘垨瀵煎叆 IPQC 鍗曪紝濉啓妫�娴嬫暟閲忋�佸悎鏍兼暟閲忋�佷笉鍚堟牸鏁伴噺骞朵笂浼犳楠岄檮浠讹紝瀹屾垚鍚庣敱鍚庣鎸夋暟閲忚嚜鍔ㄥ垽瀹氾細涓嶅悎鏍兼暟閲忎负 0 鈫� 鏍¢獙閫氳繃锛�1锛夛紝鍚﹀垯鏍¢獙涓嶉�氳繃锛�2锛夈��
+3. 鍦ㄥ凡瀹屾垚涓旀湭鍏宠仈鏉ユ簮鐨� IPQC 璇︽儏椤电偣鍑汇�屽叧鑱旂敓浜ф姤宸ャ�嶏紝鍓嶇璋冪敤鍊欓�夋帴鍙c�傚悗绔嚜鍔ㄤ娇鐢ㄦ湰鍗曠殑銆岀墿鏂� + 鐩樺彿銆嶇瓫閫夛紝鍙繑鍥炵墿鏂欍�佺洏鍙枫�佹暟閲忎笌褰撳墠璐ㄦ鍗曞畬鍏ㄤ竴鑷达紝涓斾粛澶勪簬寰呮楠岀姸鎬佺殑鎶ュ伐浜у嚭琛屻��
+4. 鐢ㄦ埛閫変腑涓�鏉″�欓�夊悗鎻愪氦鍏宠仈銆傚悗绔牎楠岄�氳繃鍚庡洖鍐欙細鎶ュ伐鍗曠姸鎬� 鈫� 宸插畬鎴愶紙4锛夈�佹寜鍚堟牸/涓嶅悎鏍兼暟閲忔媶鍒嗕骇鍑鸿骞跺畬鎴愪骇鍑哄叆搴撱�佸洖鍐欎换鍔¤川閲忔暟閲忋�佹鏌ュ伐鍗曟槸鍚﹀畬宸ャ��
+5. 鍏宠仈鎴愬姛鍚庯紝璐ㄦ鍗曡鎯呭簲鏄剧ず鏉ユ簮鍗曟嵁绫诲瀷銆佹潵婧愬崟鎹紪鍙枫�佹潵婧愯 ID锛屽苟闅愯棌銆屽叧鑱旂敓浜ф姤宸ャ�嶆寜閽��
+
+### 鍑鸿揣妫�楠岋紙OQC锛夊叧鑱旈攢鍞嚭搴�
+
+1. 閿�鍞嚭搴撳崟鎻愪氦鏃讹紝鍕鹃�夈�岄渶瑕佸嚭璐ф楠屻�嶇殑鏄庣粏璐ㄩ噺鐘舵�佺疆涓恒�屽緟妫�楠岋紙0锛夈�嶏紝鍑哄簱鍗曠姸鎬佽繘鍏ャ�屽緟妫�娴嬶紙1锛夈�嶃�傛彁浜ゅ姩浣滀笉鍐嶈嚜鍔ㄥ垱寤� OQC 鍗曘��
+2. 璐ㄦ鍛樼嫭绔嬫柊寤烘垨瀵煎叆 OQC 鍗曪紝濉啓妫�娴嬫暟閲忋�佸悎鏍兼暟閲忋�佷笉鍚堟牸鏁伴噺骞朵笂浼犳楠岄檮浠讹紝瀹屾垚鍚庡悓鏍锋寜鏁伴噺鑷姩鍒ゅ畾 1/2銆�
+3. 鍦ㄥ凡瀹屾垚涓旀湭鍏宠仈鏉ユ簮鐨� OQC 璇︽儏椤电偣鍑汇�屽叧鑱旈攢鍞嚭搴撱�嶏紝鍓嶇璋冪敤鍊欓�夋帴鍙c�傚悗绔嚜鍔ㄤ娇鐢ㄦ湰鍗曠殑銆岀墿鏂� + 鐩樺彿銆嶇瓫閫夛紝鍙繑鍥炲嚭搴撳崟鐘舵�佷负銆屽緟妫�娴嬨�嶃�佹槑缁嗗嬀閫変簡鍑鸿揣妫�楠屻�佸皻鏈叧鑱旇川妫�鍗曪紝涓旂墿鏂欍�佺洏鍙枫�佹暟閲忎笌褰撳墠璐ㄦ鍗曞畬鍏ㄤ竴鑷寸殑鏄庣粏銆�
+4. 鐢ㄦ埛閫変腑涓�鏉″�欓�夊悗鎻愪氦鍏宠仈銆傚悗绔洖鍐欏嚭搴撴槑缁嗙殑璐ㄦ鍗� ID 涓庤川閲忕姸鎬侊紙鍚堟牸 鈫� PASS锛屼笉鍚堟牸 鈫� FAIL锛夈��
+5. 褰撹鍑哄簱鍗曟墍鏈夐渶妫�楠屾槑缁嗛兘鍙樹负鍚堟牸鍚庯紝鍑哄簱鍗曡嚜鍔ㄤ粠銆屽緟妫�娴嬶紙1锛夈�嶆祦杞埌銆屽緟鎷h揣锛�2锛夈�嶃�傚瓨鍦ㄤ笉鍚堟牸鏄庣粏鏃朵繚鎸併�屽緟妫�娴嬨�嶏紝绛夊緟鍚庣画澶勭疆锛屼笉浼氳嚜鍔ㄥ彇娑堟暣寮犲嚭搴撳崟銆�
+
+## API
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| GET | /mes/qc/source-link/feedback-candidates | 鏌ヨ IPQC 鍙叧鑱旂殑鐢熶骇鎶ュ伐浜у嚭琛屽�欓�� |
+| POST | /mes/qc/source-link/feedback | 灏� IPQC 鍏宠仈鍒版寚瀹氭姤宸ヤ骇鍑鸿 |
+| GET | /mes/qc/source-link/sales-candidates | 鏌ヨ OQC 鍙叧鑱旂殑閿�鍞嚭搴撴槑缁嗗�欓�� |
+| POST | /mes/qc/source-link/sales | 灏� OQC 鍏宠仈鍒版寚瀹氶攢鍞嚭搴撴槑缁� |
+
+鏉冮檺鐮侊細
+
+| 鎺ュ彛 | 鏉冮檺鐮� |
+|------|--------|
+| feedback-candidates銆乫eedback | mes:qc-ipqc:update |
+| sales-candidates銆乻ales | mes:qc-oqc:update |
+
+**璇锋眰鍙傛暟锛堝�欓�夋煡璇級锛�**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭~ | 璇存槑 |
+|------|------|------|------|
+| qcId | Long | 鏄� | 褰撳墠璐ㄦ鍗� ID锛圛PQC 鎴� OQC锛� |
+
+**璇锋眰鍙傛暟锛堟彁浜ゅ叧鑱旓級锛�**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭~ | 璇存槑 |
+|------|------|------|------|
+| qcId | Long | 鏄� | 褰撳墠璐ㄦ鍗� ID |
+| lineId | Long | 鏄� | 鍊欓�夋帴鍙h繑鍥炵殑 lineId锛堟姤宸ヤ骇鍑鸿 ID 鎴栭攢鍞嚭搴撴槑缁� ID锛� |
+
+**鍊欓�夊搷搴斿瓧娈碉細**
+
+| 瀛楁 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| lineId | Long | 寰呮鏄庣粏 ID锛屾彁浜ゅ叧鑱旀椂鍥炰紶 |
+| documentId | Long | 鏉ユ簮鍗曟嵁 ID锛氭姤宸ュ崟 ID 鎴栭攢鍞嚭搴撳崟 ID |
+| documentCode | String | 鏉ユ簮鍗曟嵁缂栧彿锛氭姤宸ュ崟鍙锋垨鍑哄簱鍗曞彿 |
+| reelNo | String | 鐩樺彿 |
+| quantity | BigDecimal | 寰呮鏁伴噺 |
+
+**鍊欓�夊搷搴旂ず渚嬶細**
+
+```json
+{
+ "code": 0,
+ "data": [
+ {
+ "lineId": 123,
+ "documentId": 456,
+ "documentCode": "BG20261104001",
+ "reelNo": "PAN-001",
+ "quantity": 200
+ }
+ ]
+}
+```
+
+**鍏宠仈鎴愬姛鍝嶅簲锛�** `{ "code": 0, "data": true }`
+
+## 瀛楁灞曠ず瑙勫垯
+
+| 瀛楁 | 灞曠ず浣嶇疆 | 璇存槑 |
+|------|----------|------|
+| sourceDocCode | 璐ㄦ鍗曡鎯� | 宸插叧鑱旀椂灞曠ず鏉ユ簮鍗曟嵁缂栧彿锛屾湭鍏宠仈鏃舵樉绀虹┖ |
+| sourceDocType | 璐ㄦ鍗曡鎯� | 鍚庣杩斿洖 304=鐢熶骇鎶ュ伐锛�119=閿�鍞嚭搴� |
+| sourceLineId | 璐ㄦ鍗曡鎯� | 宸插叧鑱旀椂闈炵┖锛岀敤浜庡垽鏂槸鍚﹂殣钘忓叧鑱旀寜閽� |
+| reelNo | 璐ㄦ鍗曞垪琛ㄣ�佽鎯� | 宸插畬鎴愯川妫�鍗曞繀椤婚潪绌烘墠鑳藉彂璧峰叧鑱� |
+| documentCode | 鍊欓�夊脊绐� | 鎶ュ伐鍗曞彿鎴栭攢鍞嚭搴撳崟鍙� |
+| reelNo | 鍊欓�夊脊绐� | 鐩樺彿锛岀敤浜庝汉宸ュ鏍� |
+| quantity | 鍊欓�夊脊绐� | 寰呮鏁伴噺锛屽簲涓庤川妫�鍗曟娴嬫暟閲忎竴鑷� |
+
+## 涓氬姟瑙勫垯
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| IPQC 鍏宠仈鍓嶇疆鏉′欢 | 璐ㄦ鍗曠姸鎬佸繀椤讳负宸插畬鎴愶紙4锛夛紝涓� sourceDocType銆乻ourceDocId銆乻ourceLineId 鍧囦负绌猴紝鐩樺彿闈炵┖ |
+| IPQC 鍊欓�夋潯浠� | 浜у嚭琛岃川閲忕姸鎬佷负寰呮楠岋紙0锛夈�佸叧鑱旀姤宸ュ崟鐘舵�佷负寰呮楠岋紙3锛夈�佺墿鏂欎竴鑷淬�佺敓浜у伐鍗曚竴鑷达紱璐ㄦ鍗曟寚瀹氫簡鐢熶骇浠诲姟鏃朵换鍔′篃蹇呴』涓�鑷达紱鐩樺彿涓�鑷达紱鎶ュ伐浜у嚭琛屾暟閲忕瓑浜庤川妫�鍗曟娴嬫暟閲� |
+| IPQC 鍏宠仈鍐欏洖 | 鎶ュ伐鍗曡浆宸插畬鎴愶紙4锛夛紝鎸夊悎鏍�/涓嶅悎鏍兼暟閲忔媶鍒嗕骇鍑鸿骞跺畬鎴愪骇鍑哄叆搴擄紝鍥炲啓浠诲姟璐ㄩ噺鏁伴噺涓庡伐鍗曡繘搴� |
+| OQC 鍏宠仈鍓嶇疆鏉′欢 | 璐ㄦ鍗曠姸鎬佸繀椤讳负宸插畬鎴愶紙4锛夛紝涓� sourceDocType銆乻ourceDocId銆乻ourceLineId 鍧囦负绌猴紝鐩樺彿闈炵┖ |
+| OQC 鍊欓�夋潯浠� | 鍑哄簱鍗曠姸鎬佷负寰呮娴嬶紙1锛夈�佹槑缁嗗嬀閫夐渶瑕佸嚭璐ф楠屻�佹槑缁嗗皻鏈叧鑱旇川妫�鍗曘�佺墿鏂欎竴鑷淬�佸鎴蜂竴鑷达紙璐ㄦ鍗曞~鍐欏鎴锋椂锛夈�佺洏鍙蜂竴鑷淬�佹槑缁嗘暟閲忕瓑浜庤川妫�鍗曟娴嬫暟閲� |
+| OQC 鍏宠仈鍐欏洖 | 鍑哄簱鏄庣粏鍐欏叆璐ㄦ鍗� ID 涓庤川閲忕姸鎬侊紱鍏ㄩ儴闇�妫�鏄庣粏鍚堟牸鍚庡嚭搴撳崟杞緟鎷h揣锛�2锛� |
+| 涓�瀵逛竴绾︽潫 | 涓�鏉″緟妫�鏄庣粏鍙兘琚竴寮犺川妫�鍗曞叧鑱旓紱涓�寮犺川妫�鍗曞彧鑳藉叧鑱斾竴鏉℃潵婧愭槑缁� |
+| 鐩樺彿鏉ユ簮 | IPQC 鍙栫敓浜у伐鍗曠洏鍙凤紱OQC 鍙栭攢鍞鍗曟槑缁嗙洏鍙凤紱涓ゅ鍧囦笉鍋氭ā绯婂尮閰嶏紝浠呭幓闄ら灏剧┖鏍煎悗姣旇緝 |
+| 鏁伴噺绾︽潫 | 璐ㄦ鍗曟娴嬫暟閲忓繀椤诲ぇ浜� 0 涓斾笌寰呮鏄庣粏鏁伴噺瀹屽叏鐩哥瓑 |
+
+## 娉ㄦ剰浜嬮」
+
+- 鍏宠仈鎿嶄綔涓嶅彲閲嶅锛氳川妫�鍗曞凡鍏宠仈鏉ユ簮鍚庯紝璇︽儏椤靛簲闅愯棌鍏宠仈鍏ュ彛锛涢噸澶嶆彁浜や細琚悗绔嫆缁濆苟鎻愮ず宸插叧鑱旀潵婧愬崟鎹紪鍙枫��
+- 鍊欓�夊垪琛ㄤ负绌轰笉浠h〃鎺ュ彛寮傚父锛氬涓虹洏鍙枫�佹暟閲忔垨鍗曟嵁鐘舵�佷笉婊¤冻锛涘墠绔簲鎻愮ず鐢ㄦ埛鏍稿鐩樺彿涓庢娴嬫暟閲忥紝骞跺埛鏂伴噸璇曘��
+- 鍚庣閿欒鎻愮ず浼氭寜銆屽崟鎹姸鎬� / 鐗╂枡 / 宸ュ崟 / 浠诲姟 / 鐩樺彿 / 鏁伴噺 / 宸插叧鑱斻�嶇粰鍑哄叿浣撶淮搴︿笌鍙屾柟瀹為檯鍊硷紝鍓嶇搴旂洿鎺ュ睍绀哄悗绔� message锛屼笉瑕佹浛鎹负缁熶竴鐨勨�滄搷浣滃け璐モ�濄��
+- 瀹屾垚璐ㄦ鍗曟椂鍚庣浼氭牎楠岋細鍚堟牸鏁伴噺涓庝笉鍚堟牸鏁伴噺涔嬪拰蹇呴』澶т簬 0 涓旂瓑浜庢娴嬫暟閲忥紝骞朵笖蹇呴』宸蹭笂浼犺嚦灏戜竴浠芥楠岄檮浠讹紱鏈弧瓒虫椂涓嶅厑璁稿畬鎴愩��
+- 璐ㄦ缁撹鐢辨暟閲忚嚜鍔ㄨ绠楋紝鍓嶇瀹屾垚寮圭獥鏃犻渶鍐嶈鐢ㄦ埛閫夋嫨鍒ゅ畾缁撴灉锛涙彁浜ょ殑鍒ゅ畾鍊间細琚悗绔鐩栥��
+- 鏂板缓璐ㄦ鍗曚笉鍐嶄緷璧栬川妫�鏂规锛氬悗绔細蹇界暐 templateId锛屼篃涓嶄細鑷姩鐢熸垚妫�楠屾寚鏍囪锛涘墠绔〃鍗曟棤闇�鍐嶅己鏍¢獙璐ㄦ鏂规銆�
+- 閿�鍞嚭搴撳崟鎻愪氦鍚庝笉鍐嶈嚜鍔ㄥ垱寤� OQC锛屽師鈥滄彁浜ゅ嵆鐢熸垚妫�楠屽崟鈥濈殑鎻愮ず鏂囨鍜屽悗缁烦杞渶鍚屾璋冩暣銆�
+- 鍏宠仈鎴愬姛鍚庨渶鍒锋柊璐ㄦ鍗曡鎯呬笌鏉ユ簮鍗曟嵁鍒楄〃锛岄伩鍏嶇户缁睍绀烘棫鐨勭姸鎬佷笌鍏宠仈淇℃伅銆�
diff --git a/docs/task_reporter_assignment.md b/docs/task_reporter_assignment.md
new file mode 100644
index 0000000..7414171
--- /dev/null
+++ b/docs/task_reporter_assignment.md
@@ -0,0 +1,99 @@
+# 鐢熶骇浠诲姟鎶ュ伐浜洪檺鍒� - 鍓嶇鑱旇皟鏂规
+
+## 娑夊強椤甸潰
+
+- MES 鐢熶骇浠诲姟锛堟柊澧�/缂栬緫寮圭獥锛�
+- 鐢熶骇宸ヤ綔鍙帮紙浠诲姟鍒楄〃銆佸伐浣滅珯閫夋嫨寮圭獥锛�
+- MES 鐢熶骇鎶ュ伐锛堟柊澧�/淇敼/鎻愪氦銆佸揩鎹锋姤宸ャ�佹壒閲忔姤宸ャ�佸鍏ワ級
+
+## 涓氬姟娴佺▼涓庢暟鎹甫鍏�
+
+1. 鐢熶骇浠诲姟鏂板/缂栬緫鏃堕�夋嫨銆屾姤宸ヤ汉銆嶏紙鍙閫夛級锛屼繚瀛樺悗鍐欏叆浠诲姟琛ㄣ��
+2. 宸ヤ綔鍙版寜褰撳墠鐧诲綍浜鸿繃婊ゅ緟鎶ュ伐浠诲姟锛氬彧鏄剧ず鎶ュ伐浜哄寘鍚綋鍓嶇櫥褰曚汉鐨勪换鍔°��
+3. 鎶ュ伐鏃跺悗绔啀娆℃牎楠岋細浠呬换鍔$殑鎶ュ伐浜哄彲浠ュ垱寤恒�佷慨鏀广�佹彁浜ゆ姤宸ュ崟銆�
+4. 鏂板缓浠诲姟鏈寚瀹氭姤宸ヤ汉鏃讹紝鑷姩鍙栬宸ヤ綔绔欓厤缃汉鍛橈紙宀椾綅涓嬪惎鐢ㄧ敤鎴凤級浣滀负鎶ュ伐浜猴紱涓�閿帓浜х瓑鑷姩鐢熸垚浠诲姟鍚屾牱閫傜敤銆�
+5. 浠诲姟娌℃湁鎶ュ伐浜猴紙宸ヤ綔绔欐湭閰嶇疆浜哄憳锛夋椂锛屼换浣曚汉鍦ㄥ伐浣滃彴閮界湅涓嶅埌銆佷篃鏃犳硶鎶ュ伐銆�
+
+## API
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| POST | /mes/pro/task/create | 鍒涘缓浠诲姟锛屾柊澧� `assigneeUserIds` |
+| PUT | /mes/pro/task/update | 鏇存柊浠诲姟锛屾柊澧� `assigneeUserIds` |
+| GET | /mes/pro/task/get | 浠诲姟璇︽儏锛屽搷搴旀柊澧� `assigneeUserIds`銆乣assigneeUserNames` |
+| GET | /mes/pro/task/page | 浠诲姟鍒嗛〉锛屽搷搴旀柊澧� `assigneeUserIds`銆乣assigneeUserNames` |
+| GET | /mes/pro/task/pending-feedback-page | 寰呮姤宸ュ彴璐︼紝鏂板 `onlyMine` 鍙傛暟 |
+| GET | /mes/pro/task/pending-count-by-workstation | 鎸夊伐浣滅珯缁熻寰呮姤宸ユ暟锛屾柊澧� `onlyMine` 鍙傛暟 |
+
+**浠诲姟淇濆瓨璇锋眰鍙傛暟鏂板锛�**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭~ | 璇存槑 |
+|------|------|------|------|
+| assigneeUserIds | Long[] | 鍚� | 鎶ュ伐浜虹敤鎴风紪鍙峰垪琛紱鏂板鏃朵笉浼犳垨浼犵┖琛ㄧず涓嶉檺鍒讹紱鏇存柊鏃朵紶 null 琛ㄧず涓嶄慨鏀癸紝浼犵┖鏁扮粍琛ㄧず娓呯┖闄愬埗 |
+
+**浠诲姟鍝嶅簲瀛楁鏂板锛�**
+
+| 瀛楁 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| assigneeUserIds | Long[] | 鎶ュ伐浜虹敤鎴风紪鍙峰垪琛紝绌烘暟缁勮〃绀轰笉闄愬埗 |
+| assigneeUserNames | String | 鎶ュ伐浜哄鍚嶏紝澶氫釜鐢ㄩ】鍙封�溿�佲�濆垎闅� |
+
+**寰呮姤宸ュ彴璐﹁姹傚弬鏁版柊澧烇細**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭~ | 璇存槑 |
+|------|------|------|------|
+| onlyMine | Boolean | 鍚� | 涓� true 鏃朵粎杩斿洖褰撳墠鐧诲綍浜哄彲鎶ュ伐鐨勪换鍔★紙鍚湭閰嶇疆鎶ュ伐浜虹殑浠诲姟锛� |
+
+**璇锋眰绀轰緥锛�**
+
+```
+GET /mes/pro/task/pending-feedback-page?workstationId=10&pageNo=1&pageSize=200&onlyMine=true
+GET /mes/pro/task/pending-count-by-workstation?onlyMine=true
+```
+
+**鍝嶅簲绀轰緥锛�**
+
+```json
+{
+ "code": 0,
+ "data": {
+ "list": [
+ {
+ "id": 1001,
+ "code": "PT202611070001",
+ "assigneeUserIds": [1024, 1025],
+ "assigneeUserNames": "寮犱笁銆佹潕鍥�"
+ }
+ ],
+ "total": 1
+ }
+}
+```
+
+## 瀛楁灞曠ず瑙勫垯
+
+| 瀛楁 | 灞曠ず浣嶇疆 | 璇存槑 |
+|------|----------|------|
+| assigneeUserIds | 浠诲姟鏂板/缂栬緫寮圭獥 | 澶氶�変笅鎷夛紝閫夐」鏉ユ簮涓哄伐浣滅珯浜哄憳锛涚紪杈戞椂鍥炴樉 |
+| assigneeUserNames | 浠诲姟鍒楄〃锛堝彲閫夛級 | 閫楀彿/椤垮彿鍒嗛殧鐨勫鍚嶄覆锛岀函灞曠ず |
+
+## 涓氬姟瑙勫垯璇存槑
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| 浠诲姟鏈厤缃姤宸ヤ汉 | 鏃犱汉鍙姤宸ワ紝涓嶅湪浠讳綍浜虹殑宸ヤ綔鍙版樉绀� |
+| 浠诲姟宸查厤缃姤宸ヤ汉 | 浠呭垪琛ㄥ唴浜哄憳鍙互鍒涘缓銆佷慨鏀广�佹彁浜ゆ姤宸ュ崟 |
+| 鏂板缓浠诲姟鏈寚瀹氭姤宸ヤ汉 | 鑷姩鍙栧伐浣滅珯閰嶇疆浜哄憳浣滀负鎶ュ伐浜� |
+| 鎵归噺涓�閿帓浜� | 鍒涘缓浠诲姟鏃惰嚜鍔ㄥ甫宸ヤ綔绔欓厤缃汉鍛樹綔涓烘姤宸ヤ汉 |
+| 宸ヤ綔鍙颁换鍔″垪琛� | 璋冪敤 `pending-feedback-page` 鏃朵紶 `onlyMine=true`锛屼粎鏄剧ず鎶ュ伐浜哄惈鑷繁鐨勪换鍔� |
+| 宸ヤ綔鍙板伐浣滅珯鍗$墖 | 璋冪敤 `pending-count-by-workstation` 鏃朵紶 `onlyMine=true`锛屼换鍔℃暟鍙e緞涓庡垪琛ㄤ竴鑷� |
+| 绠$悊绔换鍔″彴璐� | 涓嶄紶 `onlyMine`锛屾煡鐪嬪叏閮ㄤ换鍔� |
+| 鎶ュ伐瀵煎叆 | 澶嶇敤鍒涘缓/淇敼鏍¢獙锛屽鍏ヤ汉闇�涓轰换鍔℃姤宸ヤ汉 |
+
+## 娉ㄦ剰浜嬮」
+
+- 鏂板閿欒鐮� `1_040_506_018`锛氥�屾偍涓嶆槸璇ョ敓浜т换鍔$殑鎶ュ伐浜猴紝鏃犳硶鎶ュ伐銆嶏紝鍓嶇鍙洿鎺ュ睍绀哄悗绔� message銆�
+- `assigneeUserIds` 鏇存柊璇箟锛歚null` 涓嶄慨鏀癸紝绌烘暟缁勬竻绌烘姤宸ヤ汉锛堟竻绌哄悗璇ヤ换鍔℃棤浜哄彲鎶ュ伐锛夛紝闈炵┖鏁扮粍瑕嗙洊銆�
+- 浠诲姟琛ㄩ渶鍏堟墽琛岃縼绉昏剼鏈� `scripts/task-reporter-20261107/01_ddl.sql` 澧炲姞 `assignee_user_ids` 鍒椼��
+- 鍘嗗彶浠诲姟宸查�氳繃 `scripts/task-reporter-20261107/02_backfill.sql` 鎸夊伐浣滅珯浜哄憳鍥炲~鎶ュ伐浜猴紱宸ヤ綔绔欐湭閰嶇疆浜哄憳锛堝矖浣嶏級鐨勪换鍔′粛涓虹┖锛岃繖浜涗换鍔″湪琛ラ綈鎶ュ伐浜哄墠涓嶄細鍑虹幇鍦ㄥ伐浣滃彴銆�
+- 宸ヤ綔绔欎汉鍛樺彇鑷�屽伐浣滅珯-宀椾綅銆嶉厤缃紙`mes_md_workstation_worker`锛変笅鎵�鏈夊惎鐢ㄧ敤鎴枫��
--
Gitblit v1.9.3