From 52b61fce22f188e37a88c20740e005ff109637a7 Mon Sep 17 00:00:00 2001
From: hsy <1029150275@qq.com>
Date: 星期一, 17 八月 2026 15:02:27 +0800
Subject: [PATCH] dos: 新增表:mes_pro_task_pause_record
---
docs/srm_certificate_attachment_integration.md | 113 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 113 insertions(+), 0 deletions(-)
diff --git a/docs/srm_certificate_attachment_integration.md b/docs/srm_certificate_attachment_integration.md
new file mode 100644
index 0000000..3791d42
--- /dev/null
+++ b/docs/srm_certificate_attachment_integration.md
@@ -0,0 +1,113 @@
+# SRM 璧勮川闄勪欢涓婁紶 - 鍓嶇鑱旇皟鏂规
+
+## 娑夊強椤甸潰
+
+- 閲囪喘绠$悊-SRM-渚涘簲鍟嗙鐞�-璧勮川璇佷功鍒楄〃椤�
+- 閲囪喘绠$悊-SRM-渚涘簲鍟嗙鐞�-璧勮川璇佷功鏂板/缂栬緫寮圭獥
+- 閲囪喘绠$悊-SRM-鎷涙爣椤圭洰-鏂板/缂栬緫寮圭獥锛堝惈鍙戝竷涓�/鎶曟爣涓殑閮ㄥ垎鏇存柊锛�
+- 閲囪喘绠$悊-SRM-鎷涙爣椤圭洰-璇︽儏椤�
+
+## 涓氬姟娴佺▼涓庢暟鎹甫鍏�
+
+1. 鐢ㄦ埛鍦ㄨ〃鍗曚腑閫氳繃涓婁紶缁勪欢閫夋嫨鏂囦欢
+2. 涓婁紶缁勪欢璋冪敤 `/system/storage-blob/upload` 鑾峰緱 `blobId`
+3. 淇濆瓨涓氬姟璁板綍锛堣祫璐ㄨ瘉涔� / 鎷涙爣椤圭洰锛夋椂锛屽皢鏂囦欢 ID 鍒楄〃 `blobIds` 闅忎笟鍔℃暟鎹竴骞舵彁浜�
+4. 鍚庣鍦ㄤ笟鍔¤褰曚繚瀛樺悗锛岄�氳繃 `recordType + recordId` 灏嗘枃浠剁粦瀹氬埌 `system_storage_attachment` 涓棿琛�
+5. 鏌ヨ涓氬姟璁板綍锛堣鎯呫�佸垎椤碉級鏃讹紝鍚庣杩斿洖 `attachmentList`锛堝惈鏂囦欢 URL銆佸悕绉帮級锛屽墠绔睍绀轰笅杞介摼鎺�
+
+## API
+
+### 1. 璧勮川璇佷功闄勪欢
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| POST | /system/storage-blob/upload | 涓婁紶鏂囦欢锛屽叆鍙� multipart 鐨� `files`锛岃繑鍥� Blob 鍒楄〃锛堝惈 `id`锛� |
+| POST | /srm/supplier-certificate/create | 鍒涘缓璧勮川璇佷功锛屾柊澧炲叆鍙� `blobIds` |
+| PUT | /srm/supplier-certificate/update | 鏇存柊璧勮川璇佷功锛屾柊澧炲叆鍙� `blobIds`锛堝閲忔洿鏂伴檮浠讹級 |
+| DELETE | /srm/supplier-certificate/delete | 鍒犻櫎璧勮川璇佷功锛屽悓姝ュ垹闄ら檮浠� |
+| GET | /srm/supplier-certificate/page | 鍒嗛〉鏌ヨ锛屽搷搴旀柊澧� `attachmentList` |
+| GET | /srm/supplier-certificate/get | 璇︽儏鏌ヨ锛屽搷搴旀柊澧� `attachmentList` |
+| GET | /srm/supplier-certificate/list-by-supplier | 鎸変緵搴斿晢鏌ヨ锛屽搷搴旀柊澧� `attachmentList` |
+
+**璇锋眰鍙傛暟锛坈reate/update 鏂板瀛楁锛夛細**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭~ | 璇存槑 |
+|------|------|------|------|
+| blobIds | Array\<Long\> | 鍚� | 璧勮川璇佷功闄勪欢鏂囦欢 ID 鍒楄〃 |
+
+**鍝嶅簲瀛楁鏂板锛坅ttachmentList 鏁扮粍鍏冪礌锛夛細**
+
+| 瀛楁 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| id | Long | 鏂囦欢 ID |
+| name | String | 鍘熸枃浠跺悕 |
+| url | String | 鏂囦欢璁块棶鍦板潃 |
+| previewURL | String | 棰勮鍦板潃 |
+| downloadURL | String | 涓嬭浇鍦板潃 |
+
+**鍝嶅簲绀轰緥锛�**
+
+```json
+{
+ "code": 0,
+ "data": {
+ "id": 1,
+ "supplierId": 10,
+ "certificateName": "ISO9001璐ㄩ噺绠$悊浣撶郴",
+ "attachmentList": [
+ {
+ "id": 1001,
+ "name": "iso9001_cert.pdf",
+ "url": "https://example.com/files/xxx.pdf"
+ }
+ ]
+ }
+}
+```
+
+### 2. 鎷涙爣椤圭洰璧勮川瑕佹眰闄勪欢
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| POST | /system/storage-blob/upload | 涓婁紶鏂囦欢锛屽叆鍙� multipart 鐨� `files`锛岃繑鍥� Blob 鍒楄〃锛堝惈 `id`锛� |
+| POST | /srm/tender-project/create | 鍒涘缓鎷涙爣椤圭洰锛屾柊澧炲叆鍙� `blobIds` |
+| PUT | /srm/tender-project/update | 鏇存柊鎷涙爣椤圭洰锛屾柊澧炲叆鍙� `blobIds`锛堣崏绋�/鍙戝竷涓�/鎶曟爣涓潎澧為噺鏇存柊闄勪欢锛� |
+| PUT | /srm/tender-project/update-info | 閮ㄥ垎鏇存柊锛堝彂甯冧腑/鎶曟爣涓級锛屾柊澧炲叆鍙� `blobIds` |
+| DELETE | /srm/tender-project/delete | 鍒犻櫎鎷涙爣椤圭洰锛屽悓姝ュ垹闄ら檮浠� |
+| GET | /srm/tender-project/get | 璇︽儏鏌ヨ锛屽搷搴旀柊澧� `attachmentList` |
+| GET | /srm/tender-project/page | 鍒嗛〉鏌ヨ锛屽搷搴旀柊澧� `attachmentList` |
+
+**璇锋眰鍙傛暟锛坈reate/update/update-info 鏂板瀛楁锛夛細**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭~ | 璇存槑 |
+|------|------|------|------|
+| blobIds | Array\<Long\> | 鍚� | 璧勮川瑕佹眰闄勪欢鏂囦欢 ID 鍒楄〃 |
+
+**鍝嶅簲瀛楁鏂板锛�** 鍚岃祫璐ㄨ瘉涔︼紝`attachmentList` 鏁扮粍鍏冪礌鍚� `id`銆乣name`銆乣url`銆乣previewURL`銆乣downloadURL`銆�
+
+## 瀛楁灞曠ず瑙勫垯
+
+| 瀛楁 | 灞曠ず浣嶇疆 | 璇存槑 |
+|------|----------|------|
+| 璇佷功闄勪欢 | 璧勮川璇佷功鍒楄〃 | 鏂板銆岄檮浠躲�嶅垪锛屾樉绀洪檮浠跺悕绉伴摼鎺ワ紝鐐瑰嚮鏂扮獥鍙f墦寮�锛涙棤闄勪欢鏄剧ず `--` |
+| 璇佷功闄勪欢 | 璧勮川璇佷功鏂板/缂栬緫寮圭獥 | 銆岃瘉涔﹂檮浠躲�嶄笂浼犻」锛屾敮鎸佸鏂囦欢锛岀紪杈戞椂鍥炴樉宸蹭笂浼犳枃浠� |
+| 璧勮川瑕佹眰闄勪欢 | 鎷涙爣椤圭洰鏂板/缂栬緫寮圭獥 | 銆岃祫璐ㄨ姹傞檮浠躲�嶄笂浼犻」锛屾敮鎸佸鏂囦欢锛岀紪杈戞椂鍥炴樉宸蹭笂浼犳枃浠� |
+| 璧勮川瑕佹眰闄勪欢 | 鎷涙爣椤圭洰璇︽儏椤� | 銆岃祫璐ㄨ姹傘�嶆姌鍙犻潰鏉垮唴灞曠ず闄勪欢鍚嶇О閾炬帴锛岀偣鍑绘柊绐楀彛鎵撳紑 |
+
+## 涓氬姟瑙勫垯璇存槑
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| 缂栬緫鍥炴樉 | 缂栬緫鏃跺悗绔繑鍥� `attachmentList`锛屽墠绔皢鍏舵槧灏勪负涓婁紶缁勪欢鏂囦欢瀵硅薄锛坄uid`銆乣name`銆乣url`銆乣status='done'`銆乣id`锛夊苟璧嬬粰 `blobIds`锛屾彁浜ゆ椂鎸� `valueKey='id'` 鎻愬彇鏂囦欢 ID 鎻愪氦 |
+| 闄勪欢鏇存柊 | 鍚庣鎸夈�屽閲忔洿鏂般�嶅鐞嗭細浠ユ湰娆℃彁浜ょ殑 `blobIds` 涓哄噯锛岃嚜鍔ㄥ垹闄ゅ凡绉婚櫎鐨勬枃浠剁粦瀹氥�佹柊澧炴柊涓婁紶鐨勬枃浠剁粦瀹� |
+| 鍒犻櫎涓氬姟璁板綍 | 鍒犻櫎璧勮川璇佷功/鎷涙爣椤圭洰鏃讹紝鍚庣鍚屾鍒犻櫎鍏堕檮浠� |
+| 鍙戝竷涓�/鎶曟爣涓紪杈� | 鎷涙爣椤圭洰鍦ㄥ彂甯冧腑/鎶曟爣涓樁娈甸�氳繃 `update-info` 鎺ュ彛浠呰兘淇敼鎷涙爣璇存槑銆佽祫璐ㄨ姹傚強璧勮川瑕佹眰闄勪欢 |
+| 涓婁紶鏍煎紡 | 鏀寔 jpg銆乯peg銆乸ng銆乸df銆乨oc銆乨ocx锛屽崟涓枃浠朵笉瓒呰繃 2MB |
+
+## 娉ㄦ剰浜嬮」
+
+- 涓婁紶蹇呴』璧� `/system/storage-blob/upload`锛岀姝娇鐢ㄦ棫鐗� `/infra/file/*` 鎺ュ彛銆�
+- 璧勮川璇佷功涓庢嫑鏍囬」鐩娇鐢ㄤ笉鍚岀殑 `recordType`锛氳祫璐ㄨ瘉涔︿负 `srm_supplier_certificate`锛屾嫑鏍囬」鐩负 `srm_tender_project`锛屽墠绔棤闇�鍏冲績锛岀敱鍚庣澶勭悊銆�
+- 缂栬緫鍥炴樉鏃惰嫢鐢ㄦ埛鏈敼鍔ㄩ檮浠讹紝鎻愪氦鐨� `blobIds` 浠嶅簲鍖呭惈鍘熸湁鏂囦欢 ID锛堢敱涓婁紶缁勪欢鍥炴樉瀵硅薄鎼哄甫锛夛紝閬垮厤闄勪欢琚鍒犮��
+- 鎷涙爣椤圭洰閮ㄥ垎鏇存柊锛坄update-info`锛夎姹備綋鍚屾牱闇�鎼哄甫 `blobIds`銆�
+- 鍒楄〃椤甸檮浠堕摼鎺ュ缓璁� `target="_blank"` 鏂扮獥鍙f墦寮�锛屼究浜庨瑙� PDF/鍥剧墖銆�
--
Gitblit v1.9.3