From a647bc8a43c0212f482bee0630ebd14dca120a8a Mon Sep 17 00:00:00 2001
From: 吴羡 <16976746+Xian-TT3@user.noreply.gitee.com>
Date: 星期一, 28 九月 2026 14:13:28 +0800
Subject: [PATCH] feat: CRM 发票/合同导入、MES 质检批量导入与检测台账、回款与报价校验、权限码细化
---
docs/contract_product_field_change.md | 104 +++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 103 insertions(+), 1 deletions(-)
diff --git a/docs/contract_product_field_change.md b/docs/contract_product_field_change.md
index f16c12a..45d4f8d 100644
--- a/docs/contract_product_field_change.md
+++ b/docs/contract_product_field_change.md
@@ -151,7 +151,7 @@
<!-- 浜у搧鏄庣粏琛ㄦ牸 -->
<el-table-column prop="itemCode" label="鐗╂枡缂栫爜" />
<el-table-column prop="itemName" label="鐗╂枡鍚嶇О" />
-<el-table-column prop="itemBarCode" label="鐗╂枡鏉＄爜" />
+<el-table-column prop="barCode" label="鐗╂枡鏉＄爜" />
<el-table-column prop="itemUnitName" label="鍗曚綅" />
<el-table-column prop="itemPrice" label="鍘熶环" />
<el-table-column prop="contractPrice" label="鍚堝悓浠�" />
@@ -209,3 +209,105 @@
2. **浠锋牸鍙慨鏀�**锛歚contractPrice` 榛樿绛変簬鐗╂枡鍘熶环锛屼絾鍙互鎵嬪姩淇敼
3. **杩囨浮鏈�**锛氬悗绔殏鏃跺吋瀹� `productId` 鍜� `sellingPrice` 瀛楁锛屼絾鍚庣画浼氱Щ闄ゅ吋瀹归�昏緫
4. **鍏朵粬妯″潡鍚屾淇敼**锛氶攢鍞姤浠峰崟涔熶娇鐢� MDM 鐗╂枡锛屽瓧娈典笌鍚堝悓涓�鑷�
+
+---
+
+# 2026-09-24 澧為噺锛氬悎鍚屼骇鍝佹槑缁嗘樉绀哄瓧娈佃ˉ鍏� + 鍒犻櫎鍚堝悓绾ц仈娓呯悊鏄庣粏
+
+## 涓�銆佹樉绀哄瓧娈佃ˉ鍏�
+
+### 鑳屾櫙
+
+鍚堝悓璇︽儏鎺ュ彛姝ゅ墠鏈В鏋愪骇鍝佹槑缁嗙殑璁￠噺鍗曚綅鍚嶇О锛屾潯鐮佸瓧娈靛悕涓庡墠绔垪缁戝畾涓嶄竴鑷达紝瀵艰嚧浠ヤ笅浣嶇疆 **鍗曚綅鍒椼�佺墿鏂欐潯鐮佸垪鎭掍负绌�**锛堝晢鏈烘帴鍙ｄ竴鐩存甯歌繑鍥烇紝鏈瀵归綈鍟嗘満鍋氭硶锛夛細
+
+- 鍚堝悓璇︽儏 鈫掋�屼骇鍝併�嶉〉绛撅紙`ProductDetailsList` 鍏辩敤缁勪欢锛�
+- 鍚堝悓瀹℃壒椤� 鈫� 浜у搧鏄庣粏琛�
+- 缂栬緫鍚堝悓寮圭獥 鈫� 浜у搧琛ㄦ牸锛堝凡淇濆瓨琛屾鐨勮鏍煎瀷鍙峰悓鏍蜂负绌猴級
+
+### 娑夊強鐨勬帴鍙�
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| GET | /crm/contract/get | 鑾峰緱鍚堝悓璇︽儏锛堝惈浜у搧鏄庣粏锛夛紝鏈鍙樻洿浠呭奖鍝嶆鎺ュ彛 |
+
+> `/crm/contract/page`銆乣/crm/contract/page-by-customer`銆乣/crm/contract/page-by-business`銆佸鍑� Excel 鍧�**涓嶅惈**浜у搧鏄庣粏锛屼笉鍙楀奖鍝嶃��
+
+### 鍝嶅簲瀛楁鍙樻洿锛坉ata.products[]锛�
+
+| 瀛楁 | 绫诲瀷 | 鍙樻洿 | 璇存槑 |
+|------|------|------|------|
+| itemUnitName | String | 琛ュ叏鍙栧�� | 璁￠噺鍗曚綅鍚嶇О锛屾寜 `itemUnitId` 瑙ｆ瀽锛堝銆岀背銆嶃�屼釜銆嶏級锛屾鍓嶆亽涓� null |
+| barCode | String | **瀛楁鏇村悕** | 鐗╂枡鏉＄爜锛屽師瀛楁鍚� `itemBarCode` 鏀逛负 `barCode`锛屼笌鍟嗘満鎺ュ彛鍙婂墠绔骇鍝佹槑缁嗗垪琛ㄥ垪缁戝畾锛坒ield: 'barCode'锛変竴鑷� |
+| itemSpecification | String | 鏂板 | 瑙勬牸鍨嬪彿锛屽彇鑷� MDM 鐗╂枡锛屼笌鍟嗘満鎺ュ彛涓�鑷� |
+| itemBarCode | - | 宸茬Щ闄� | 鍓嶇濡傛湁寮曠敤璇锋敼鐢� `barCode` |
+
+**鍝嶅簲绀轰緥锛堣妭閫夛級锛�**
+
+```json
+{
+ "code": 0,
+ "data": {
+ "id": 19,
+ "no": "WTJC2025120501",
+ "products": [
+ {
+ "id": 42,
+ "itemId": 38,
+ "itemCode": "PHC300AB70-4.5",
+ "itemName": "PHC300AB70-4.5",
+ "barCode": null,
+ "itemSpecification": null,
+ "itemUnitId": 3,
+ "itemUnitName": "绫�",
+ "itemPrice": 68.000000,
+ "contractPrice": 68.000000,
+ "count": 179208.000000,
+ "totalPrice": 12186144.000000
+ }
+ ]
+ }
+}
+```
+
+### 瀛楁灞曠ず瑙勫垯
+
+| 瀛楁 | 灞曠ず浣嶇疆 | 璇存槑 |
+|------|----------|------|
+| itemUnitName | 鍚堝悓璇︽儏浜у搧椤电銆佸鎵归〉浜у搧琛ㄣ�佺紪杈戝脊绐椾骇鍝佽〃 | 鍗曚綅鍒楋紝鍙栧�� MDM 璁￠噺鍗曚綅鍚嶇О |
+| barCode | 鍚堝悓璇︽儏浜у搧椤电锛堢墿鏂欐潯鐮佸垪锛� | 涓庡晢鏈轰骇鍝佸垪琛ㄥ垪缁戝畾瀛楁涓�鑷� |
+| itemSpecification | 缂栬緫寮圭獥浜у搧琛ㄦ牸 | 璇︽儏椤典骇鍝侀〉绛炬棤姝ゅ垪 |
+
+### 涓氬姟瑙勫垯璇存槑
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| 鍗曚綅鍚嶇О鏉ユ簮 | 鐢� MDM 璁￠噺鍗曚綅琛ㄦ寜浜у搧鏄庣粏鐨� itemUnitId 瑙ｆ瀽锛涘鍏ョ殑鍚堝悓锛宨temUnitId 鍙栬嚜鐗╂枡涓绘暟鎹殑璁￠噺鍗曚綅 |
+| 鏉＄爜鍙栧�� | 鍙栬嚜 MDM 鐗╂枡妗ｆ鐨勬潯鐮侊紱鐗╂枡鏈淮鎶ゆ潯鐮佹椂涓虹┖锛屽睘姝ｅ父 |
+| 瑙勬牸鍨嬪彿鍙栧�� | 鍙栬嚜 MDM 鐗╂枡妗ｆ鐨勮鏍煎瀷鍙凤紱鏈淮鎶ゆ椂涓虹┖ |
+| 缂栬緫鍚堝悓鍚庝繚瀛� | 浜у搧鏄庣粏鍥炰紶鏃� barCode / itemSpecification / itemUnitName 灞炰簬灞曠ず瀛楁锛屽悗绔笉钀藉簱锛岀敱鎺ュ彛姣忔鎸� itemId / itemUnitId 瀹炴椂瑙ｆ瀽锛屼笉褰卞搷淇濆瓨缁撴灉 |
+
+### 娉ㄦ剰浜嬮」
+
+- 鏈涓�**鍝嶅簲瀛楁鍚嶅彉鏇�**锛坕temBarCode 鈫� barCode锛夈�傚墠绔被鍨嬪０鏄� `CrmContractApi.ContractProduct.itemBarCode` 寤鸿鍚屾鏀逛负 `barCode`锛堜粎绫诲瀷澹版槑锛岃繍琛屾椂涓嶈璇ュ瓧娈碉紝涓嶆敼涔熶笉鎶ラ敊锛夈��
+- 鍓嶇椤甸潰浠ｇ爜**鏃犻渶鏀瑰姩**锛氬崟浣嶅垪銆佹潯鐮佸垪銆佽鏍煎瀷鍙峰垪缁戝畾瀛楁宸蹭笌鏈杩斿洖涓�鑷淬��
+- 鍚堝悓銆屼骇鍝併�嶉〉绛俱�佸鎵归〉浜у搧琛ㄥ鐢ㄥ悓涓�鍒楀畾涔夛紝淇鍚庝笁澶勫悓鏃剁敓鏁堛��
+
+---
+
+## 浜屻�佸垹闄ゅ悎鍚岀骇鑱旀竻鐞嗕骇鍝佹槑缁�
+
+### 鑳屾櫙
+
+`DELETE /crm/contract/delete` 姝ゅ墠鍙垹闄ゅ悎鍚屼富琛ㄣ�佹姤浠峰崟寮曠敤涓庢暟鎹潈闄愶紝**鏈垹闄� `crm_contract_product` 浜у搧鏄庣粏**锛屽鑷村垹闄ゅ悎鍚屽悗鏄庣粏鎴愪负瀛ゅ効鏁版嵁锛堣〃鍐� deleted=0 浣嗗悎鍚屽凡涓嶅瓨鍦級銆�
+
+### 鍙樻洿鍚庤涓�
+
+| 鎿嶄綔 | 褰卞搷鏁版嵁 |
+|------|----------|
+| 鍒犻櫎鍚堝悓 | 鍚堝悓涓昏〃锛堥�昏緫鍒犻櫎锛�+ 浜у搧鏄庣粏锛堥�昏緫鍒犻櫎锛�+ 鎶ヤ环鍗曞紩鐢ㄨВ闄� + 鏁版嵁鏉冮檺鍒犻櫎 |
+
+### 娉ㄦ剰浜嬮」
+
+- 绾ц仈鍒犻櫎涓�**閫昏緫鍒犻櫎**锛坉eleted=1锛夛紝涓庡悎鍚屼富琛ㄥ彛寰勪竴鑷达紝鍘嗗彶鏁版嵁浠嶅彲杩芥函銆�
+- 鍚堝悓宸茶鍥炴寮曠敤鏃朵緷鏃х姝㈠垹闄わ紙鍘熸湁鏍￠獙涓嶅彉锛夈��
+- 鍘嗗彶閬楃暀鐨勫鍎挎槑缁嗭紙鏈淇鍓嶅垹闄や骇鐢熺殑锛変笉浼氳嚜鍔ㄦ竻鐞嗭紝濡傞渶娓呯悊璇锋寜 contract_id 鏍稿鍚庢墜宸ュ鐞嗐��
--
Gitblit v1.9.3