From 6b5f7c66fc40d7f6099d561e31a34fbd50dd20d3 Mon Sep 17 00:00:00 2001
From: 云 <2163098428@qq.com>
Date: 星期三, 01 七月 2026 15:54:57 +0800
Subject: [PATCH] 初始化项目
---
docs/mdm_frontend_change.md | 241 ++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 241 insertions(+), 0 deletions(-)
diff --git a/docs/mdm_frontend_change.md b/docs/mdm_frontend_change.md
new file mode 100644
index 0000000..bb8589b
--- /dev/null
+++ b/docs/mdm_frontend_change.md
@@ -0,0 +1,241 @@
+# MDM 鐗╂枡涓绘暟鎹ā鍧楁敼閫� - 鍓嶇鍙樻洿鏂囨。
+
+## 姒傝堪
+
+鏈鏀归�犲皢 ERP銆丮ES銆乄MS 涓変釜妯″潡鐨勭墿鏂�/浜у搧鏁版嵁缁熶竴鍒� MDM锛堜富鏁版嵁绠＄悊锛夋ā鍧楋紝娑堥櫎鏁版嵁瀛ゅ矝銆�
+
+## 妯″潡鍙樻洿
+
+### 1. MDM 妯″潡锛堟柊澧烇級
+
+鏂板 MDM 鐗╂枡涓绘暟鎹鐞嗘ā鍧楋紝鍖呭惈浠ヤ笅椤甸潰锛�
+
+| 椤甸潰 | 璺緞 | 璇存槑 |
+|------|------|------|
+| 鐗╂枡绠＄悊 | /mdm/item | 鐗╂枡涓绘暟鎹鐞� |
+| 鐗╂枡鍒嗙被 | /mdm/category | 鐗╂枡鍒嗙被绠＄悊 |
+| 璁￠噺鍗曚綅 | /mdm/unit | 璁￠噺鍗曚綅绠＄悊 |
+| 鍝佺墝绠＄悊 | /mdm/brand | 鍝佺墝绠＄悊 |
+| 浠撳簱绠＄悊 | /mdm/warehouse | 浠撳簱涓绘暟鎹鐞� |
+
+### 2. ERP 妯″潡
+
+ERP 浜у搧鏁版嵁鏉ユ簮浜� MDM锛屽彉鏇村涓嬶細
+
+| 鍘熼〉闈� | 鍙樺寲 |
+|--------|------|
+| /erp/product | 浜у搧鏁版嵁浠� MDM 鑾峰彇锛岄〉闈繚鐣欎絾鏁版嵁婧愬彉鏇� |
+
+### 3. MES 妯″潡
+
+MES 鐗╂枡鏁版嵁鏉ユ簮浜� MDM锛屽彉鏇村涓嬶細
+
+| 鍘熼〉闈� | 鍙樺寲 |
+|--------|------|
+| /mes/md/item | 鐗╂枡鏁版嵁浠� MDM 鑾峰彇锛岄〉闈繚鐣欎絾鏁版嵁婧愬彉鏇� |
+
+### 4. WMS 妯″潡
+
+WMS 鍟嗗搧鍜� SKU 鏁版嵁鏉ユ簮浜� MDM锛屽彉鏇村涓嬶細
+
+| 鍘熼〉闈� | 鍙樺寲 |
+|--------|------|
+| /wms/item | 鍟嗗搧鏁版嵁浠� MDM 鑾峰彇锛岄〉闈繚鐣欎絾鏁版嵁婧愬彉鏇� |
+| /wms/item-sku | SKU 鏁版嵁浠� MDM 鑾峰彇锛岄〉闈繚鐣欎絾鏁版嵁婧愬彉鏇� |
+
+---
+
+## API 鍙樻洿璇存槑
+
+### MDM 鐗╂枡 API
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| POST | /mdm/item/create | 鍒涘缓鐗╂枡 |
+| PUT | /mdm/item/update | 鏇存柊鐗╂枡 |
+| PUT | /mdm/item/update-status | 鏇存柊鐗╂枡鐘舵�� |
+| DELETE | /mdm/item/delete | 鍒犻櫎鐗╂枡锛堝疄闄呬负绂佺敤锛� |
+| GET | /mdm/item/get | 鑾峰彇鐗╂枡 |
+| GET | /mdm/item/page | 鑾峰彇鐗╂枡鍒嗛〉 |
+| GET | /mdm/item/list-by-ids | 鑾峰彇鐗╂枡鍒楄〃 |
+
+**璇锋眰鍙傛暟锛堝垱寤猴級锛�**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
+|------|------|------|------|
+| code | String | 鏄� | 鐗╂枡缂栫爜 |
+| name | String | 鏄� | 鐗╂枡鍚嶇О |
+| barCode | String | 鍚� | 鐗╂枡鏉＄爜 |
+| specification | String | 鍚� | 瑙勬牸鍨嬪彿 |
+| categoryId | Long | 鏄� | 鐗╂枡鍒嗙被缂栧彿 |
+| unitMeasureId | Long | 鏄� | 璁￠噺鍗曚綅缂栧彿 |
+| brandId | Long | 鍚� | 鍝佺墝缂栧彿 |
+| itemType | Integer | 鏄� | 鐗╂枡绫诲瀷锛�1:鐗╂枡, 2:浜у搧, 3:鍗婃垚鍝侊級 |
+| status | Integer | 鍚� | 鐘舵�侊紙0:鍚敤, 1:绂佺敤锛� |
+| purchasePrice | BigDecimal | 鍚� | 閲囪喘浠锋牸 |
+| salesPrice | BigDecimal | 鍚� | 閿�鍞环鏍� |
+| costPrice | BigDecimal | 鍚� | 鎴愭湰浠锋牸 |
+| safetyStock | BigDecimal | 鍚� | 瀹夊叏搴撳瓨 |
+| expiryDays | Integer | 鍚� | 淇濊川鏈熷ぉ鏁� |
+| isBatchManaged | Boolean | 鍚� | 鏄惁鎵规绠＄悊 |
+| remark | String | 鍚� | 澶囨敞 |
+
+**鍝嶅簲锛�**
+
+```json
+{
+ "code": 0,
+ "data": 1,
+ "msg": "鎿嶄綔鎴愬姛"
+}
+```
+
+### MDM 鐗╂枡鍒嗙被 API
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| POST | /mdm/category/create | 鍒涘缓鍒嗙被 |
+| PUT | /mdm/category/update | 鏇存柊鍒嗙被 |
+| DELETE | /mdm/category/delete | 鍒犻櫎鍒嗙被 |
+| GET | /mdm/category/get | 鑾峰彇鍒嗙被 |
+| GET | /mdm/category/list | 鑾峰彇鍒嗙被鍒楄〃 |
+| GET | /mdm/category/list-all-simple | 鑾峰彇鍚敤鐨勫垎绫诲垪琛� |
+
+### MDM 璁￠噺鍗曚綅 API
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| POST | /mdm/unit/create | 鍒涘缓鍗曚綅 |
+| PUT | /mdm/unit/update | 鏇存柊鍗曚綅 |
+| DELETE | /mdm/unit/delete | 鍒犻櫎鍗曚綅 |
+| GET | /mdm/unit/get | 鑾峰彇鍗曚綅 |
+| GET | /mdm/unit/page | 鑾峰彇鍗曚綅鍒嗛〉 |
+| GET | /mdm/unit/list-by-ids | 鑾峰彇鍗曚綅鍒楄〃 |
+
+### MDM 鍝佺墝 API
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| POST | /mdm/brand/create | 鍒涘缓鍝佺墝 |
+| PUT | /mdm/brand/update | 鏇存柊鍝佺墝 |
+| DELETE | /mdm/brand/delete | 鍒犻櫎鍝佺墝 |
+| GET | /mdm/brand/get | 鑾峰彇鍝佺墝 |
+| GET | /mdm/brand/page | 鑾峰彇鍝佺墝鍒嗛〉 |
+| GET | /mdm/brand/list-by-ids | 鑾峰彇鍝佺墝鍒楄〃 |
+
+### MDM 浠撳簱 API
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| POST | /mdm/warehouse/create | 鍒涘缓浠撳簱 |
+| PUT | /mdm/warehouse/update | 鏇存柊浠撳簱 |
+| PUT | /mdm/warehouse/update-status | 鏇存柊浠撳簱鐘舵�� |
+| DELETE | /mdm/warehouse/delete | 鍒犻櫎浠撳簱 |
+| GET | /mdm/warehouse/get | 鑾峰彇浠撳簱 |
+| GET | /mdm/warehouse/page | 鑾峰彇浠撳簱鍒嗛〉 |
+| GET | /mdm/warehouse/list-by-ids | 鑾峰彇浠撳簱鍒楄〃 |
+
+---
+
+## 鍓嶇淇敼鐐�
+
+### 1. ERP 浜у搧椤甸潰
+
+ERP 浜у搧椤甸潰鏀逛负浠� MDM 鑾峰彇鏁版嵁锛屽墠绔渶瑕佷慨鏀癸細
+
+**API 璋冪敤鍙樻洿锛�**
+
+```js
+// 鍘熻皟鐢� ERP 浜у搧 API
+import { getProductPage, getProduct } from '@/api/erp/product'
+
+// 鏀逛负璋冪敤 MDM 鐗╂枡 API锛坕temType=2 浜у搧锛�
+import { getItemPage, getItem } from '@/api/mdm/item'
+
+// 鏌ヨ鏃堕渶瑕佷紶鍏� itemType=2锛堜骇鍝佺被鍨嬶級
+getItemPage({ itemType: 2, pageNo: 1, pageSize: 10 })
+```
+
+**瀛楁鏄犲皠锛�**
+
+| ERP 瀛楁 | MDM 瀛楁 | 璇存槑 |
+|----------|----------|------|
+| id | id | 缂栧彿 |
+| barCode | code | 缂栫爜锛堝師鏉＄爜鏀逛负缂栫爜锛� |
+| name | name | 鍚嶇О |
+| spec | specification | 瑙勬牸鍨嬪彿 |
+| categoryId | categoryId | 鍒嗙被缂栧彿 |
+| unitId | unitMeasureId | 鍗曚綅缂栧彿 |
+| brandId | brandId | 鍝佺墝缂栧彿 |
+| status | status | 鐘舵�� |
+| purchasePrice | purchasePrice | 閲囪喘浠锋牸 |
+| salePrice | salesPrice | 閿�鍞环鏍� |
+| minPrice | costPrice | 鏈�浣庝环鏍兼敼涓烘垚鏈环 |
+
+### 2. MES 鐗╂枡椤甸潰
+
+MES 鐗╂枡椤甸潰鏀逛负浠� MDM 鑾峰彇鏁版嵁锛�
+
+**API 璋冪敤鍙樻洿锛�**
+
+```js
+// 鍘熻皟鐢� MES 鐗╂枡 API
+import { getItemPage, getItem } from '@/api/mes/md/item'
+
+// 鏀逛负璋冪敤 MDM 鐗╂枡 API锛坕temType=1 鐗╂枡锛�
+import { getItemPage, getItem } from '@/api/mdm/item'
+
+// 鏌ヨ鏃堕渶瑕佷紶鍏� itemType=1锛堢墿鏂欑被鍨嬶級
+getItemPage({ itemType: 1, pageNo: 1, pageSize: 10 })
+```
+
+**MES 鐗规湁鍔熻兘淇濈暀锛�**
+- 鎵规灞炴�ч厤缃細浠嶇敱 MES 妯″潡绠＄悊
+- BOM 閰嶇疆锛氫粛鐢� MES 妯″潡绠＄悊
+- SOP/SIP 閰嶇疆锛氫粛鐢� MES 妯″潡绠＄悊
+
+### 3. WMS 鍟嗗搧/SKU 椤甸潰
+
+WMS 鍟嗗搧鍜� SKU 椤甸潰鏀逛负浠� MDM 鑾峰彇鏁版嵁锛�
+
+**API 璋冪敤鍙樻洿锛�**
+
+```js
+// 鍘熻皟鐢� WMS 鍟嗗搧 API
+import { getItemPage, getItem } from '@/api/wms/item'
+
+// 鏀逛负璋冪敤 MDM 鐗╂枡 API
+import { getItemPage, getItem } from '@/api/mdm/item'
+
+// SKU 鏁版嵁
+import { getItemSkuList } from '@/api/mdm/item-sku'
+```
+
+---
+
+## 娉ㄦ剰浜嬮」
+
+1. **鐗╂枡绫诲瀷鍖哄垎**锛�
+ - itemType=1锛氱墿鏂欙紙MES 浣跨敤锛�
+ - itemType=2锛氫骇鍝侊紙ERP 浣跨敤锛�
+ - itemType=3锛氬崐鎴愬搧
+
+2. **鍒犻櫎鎿嶄綔**锛歁DM 鐗╂枡鍒犻櫎瀹為檯涓虹鐢ㄦ搷浣滐紝涓嶅仛鐗╃悊鍒犻櫎
+
+3. **SKU 妯″紡**锛氭墍鏈夌墿鏂欏繀椤婚厤缃� SKU锛孍RP/MES 鏁版嵁杩佺Щ鏃惰嚜鍔ㄥ垱寤洪粯璁� SKU
+
+4. **鍚戝悗鍏煎**锛氬師妯″潡鐨� API 鎺ュ彛淇濈暀锛屽唴閮ㄨ皟鐢� MDM API
+
+---
+
+## 鏁版嵁搴撹〃
+
+| 琛ㄥ悕 | 璇存槑 |
+|------|------|
+| mdm_item | 鐗╂枡涓绘暟鎹〃 |
+| mdm_item_sku | 鐗╂枡 SKU 琛� |
+| mdm_item_category | 鐗╂枡鍒嗙被琛� |
+| mdm_unit_measure | 璁￠噺鍗曚綅琛� |
+| mdm_brand | 鍝佺墝琛� |
+| mdm_warehouse | 浠撳簱琛� |
+| mdm_item_batch_config | 鎵规灞炴�ч厤缃〃 |
--
Gitblit v1.9.3