From 91491239c5d4611b5b1404a7abeb2bb23d0edad5 Mon Sep 17 00:00:00 2001
From: liu <2021943741@qq.com>
Date: 星期三, 30 九月 2026 14:26:59 +0800
Subject: [PATCH] feat(wxcp): 活动封面改用附件中间表，报名姓名手机号改为选填
---
docs/wxcp_activity_integration.md | 25 ++++++++++++++++++++++---
1 files changed, 22 insertions(+), 3 deletions(-)
diff --git a/docs/wxcp_activity_integration.md b/docs/wxcp_activity_integration.md
index ca5c0fd..b6fb4c4 100644
--- a/docs/wxcp_activity_integration.md
+++ b/docs/wxcp_activity_integration.md
@@ -52,7 +52,7 @@
| id | Long | 淇敼鏃跺繀濉� | 缂栧彿 |
| title | String | 鏄� | 娲诲姩鏍囬锛屸墹128 瀛楃 |
| content | String | 鍚� | 娲诲姩璇︽儏 |
-| coverUrl | String | 鍚� | 灏侀潰鍥惧湴鍧� |
+| blobIds | Long[] | 鍚� | **灏侀潰鍥炬枃浠剁紪鍙�**锛屾渶澶� 1 涓紱涓嶄紶 = 涓嶆敼鍔ㄥ皝闈紝浼� `[]` = 娓呯┖灏侀潰 |
| location | String | 鍚� | 娲诲姩鍦扮偣锛屸墹255 瀛楃 |
| startTime | DateTime | 鍚� | 娲诲姩寮�濮嬫椂闂� |
| endTime | DateTime | 鍚� | 娲诲姩缁撴潫鏃堕棿 |
@@ -72,6 +72,7 @@
| signupCount | Integer | 宸叉姤鍚嶄汉鏁� |
| pushStatus | Integer | 0鏈帹閫� 1宸叉帹閫� |
| pushTime | DateTime | 鏈�杩戞帹閫佹椂闂� |
+| attachmentList | Object[] | **灏侀潰鍥鹃檮浠跺垪琛�**锛堟渶澶� 1 鏉★級锛屽瓧娈靛悓鎶ュ悕闄勪欢锛歚id`銆乣name`銆乣url`銆乣previewURL`銆乣downloadURL`銆傚垪琛ㄧ缉鐣ュ浘銆佽〃鍗曞洖鏄鹃兘浠庤繖閲屽彇 |
### 鎺ㄩ�佷笌浜岀淮鐮�
@@ -116,6 +117,18 @@
|------|------|------|
| GET | `/wxcp/activity/signup-page?id={娲诲姩缂栧彿}` | 鎶ュ悕钀藉湴椤� HTML锛岀敱鍚庣娓叉煋 |
| POST | `/wxcp/activity/signup` | 鎻愪氦鎶ュ悕锛堟敮鎸� `content` 鏂囧瓧 + `blobIds` 闄勪欢锛� |
+
+**鎻愪氦鎶ュ悕璇锋眰鍙傛暟锛�**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
+|------|------|------|------|
+| activityId | Long | 鏄� | 娲诲姩缂栧彿 |
+| name | String | 鍚� | 濮撳悕锛屸墹64 瀛楃 |
+| mobile | String | 鍚� | 鎵嬫満鍙凤紱**濉簡鎵嶆牎楠�** 11 浣嶆牸寮忥紝鐣欑┖閫氳繃 |
+| wxUserId | String | 鍚� | 浼佷笟寰俊鎴愬憳璐﹀彿 |
+| deptName | String | 鍚� | 閮ㄩ棬鍚嶇О |
+| content | String | 鍚� | 鍙備笌璇存槑 |
+| blobIds | Long[] | 鍚� | 闄勪欢鏂囦欢缂栧彿 |
### 鎶ュ悕缁熻涓庨檮浠�
@@ -180,7 +193,7 @@
1. 鏂板缓娲诲姩 鈫� 淇濆瓨涓�**鑽夌**锛屾鏃舵壂鐮佹姤鍚嶄細鎻愮ず銆屾姤鍚嶅凡缁撴潫銆�
2. 鐐广�屽彂甯冦�嶁啋 鐘舵�佸彉銆屽凡鍙戝竷銆嶏紝姝ゆ椂浜岀淮鐮佸拰鎶ュ悕椤垫墠鍙敤
3. 鐐广�屾帹閫併�嶁啋 鎴愬憳浼佷笟寰俊鏀跺埌鍗＄墖娑堟伅锛屾爣棰樹负娲诲姩鏍囬锛屾鏂囧惈**娲诲姩鏃堕棿 / 鍦扮偣 / 鎶ュ悕鎴 / 鍚嶉**锛屾寜閽�岀珛鍗虫姤鍚嶃�嶇洿杈炬姤鍚嶉〉
-4. 鎴愬憳鐐规寜閽垨鎵爜 鈫� 鎵撳紑鎶ュ悕椤� 鈫� 濉鍚嶅拰鎵嬫満鍙� 鈫� 鎻愪氦
+4. 鎴愬憳鐐规寜閽垨鎵爜 鈫� 鎵撳紑鎶ュ悕椤� 鈫掞紙鍙�夛級濉鍚嶅拰鎵嬫満鍙� + 浼犻檮浠� 鈫� 鎻愪氦
5. 鎶ュ悕鎴愬姛 鈫� 娲诲姩 `signupCount` 鑷姩 +1
6. 鍚庡彴鍦ㄦ椿鍔ㄨ鎯呯殑鎶ュ悕璁板綍鍒楄〃閲屽彲鐪嬪埌璇ユ垚鍛橈紝鍙墽琛屻�屽彇娑堟姤鍚嶃�嶃�岀鍒般��
@@ -219,9 +232,12 @@
| 鎺ㄩ�佹垚鍔熷悗 | 娲诲姩 `pushStatus` 缃� 1銆乣pushTime` 璁板綍鏃堕棿锛涢噸澶嶆帹閫佷細瑕嗙洊杩欎袱涓瓧娈� |
| 鎶ュ悕鏃堕棿绐楀彛 | 鏈埌 `signupStartTime` 鎴栧凡杩� `signupEndTime` 鍧囦笉鑳芥姤鍚� |
| 鎶ュ悕鍚嶉 | `signupLimit=0` 琛ㄧず涓嶉檺锛涘凡婊℃椂鎻愮ず銆屾姤鍚嶄汉鏁板凡婊°�� |
-| 閲嶅鎶ュ悕 | 鏈変紒涓氬井淇¤韩浠芥寜鎴愬憳璐﹀彿鍒ら噸锛涙櫘閫氭祻瑙堝櫒鎸�**鎵嬫満鍙�**鍒ら噸 |
+| 鎶ュ悕濮撳悕/鎵嬫満鍙� | **鍧囦负閫夊～**銆傛墜鏈哄彿濉簡鎵嶆牎楠屾牸寮忥紝鐣欑┖鍏佽鎻愪氦 |
+| 閲嶅鎶ュ悕 | 鏈変紒涓氬井淇¤韩浠芥寜鎴愬憳璐﹀彿鍒ら噸锛涙病鏈夎处鍙蜂絾鏈夋墜鏈哄彿鍒欐寜鎵嬫満鍙峰垽閲嶏紱**涓よ�呴兘娌℃湁鏃朵笉鍋氬垽閲�**锛堟棤娉曞垽瀹氳韩浠斤紝姣忔鎻愪氦閮芥柊寤轰竴鏉★級 |
| 鍙栨秷鍚庨噸鏂版姤鍚� | 澶嶇敤鍘熻褰曪紝涓嶄細浜х敓绗簩鏉″巻鍙� |
| 鍙栨秷鎶ュ悕 | 娲诲姩 `signupCount` 鑷姩 -1 |
+| 灏侀潰鍥� | 涓嶅瓨涓氬姟琛ㄥ瓧娈碉紝瀛� `system_storage_attachment`锛坄record_type = wxcp_activity`锛夈�傚垹闄ゆ椿鍔ㄦ椂涓�骞舵竻鎺夐檮浠跺叧绯� |
+| 灏侀潰鍥惧睍绀� | 鎶ュ悕椤甸《閮ㄤ互 `object-fit: cover` 灞曠ず锛涚鐞嗗悗鍙板垪琛ㄥ湪鏍囬宸︿晶鏄剧ず缂╃暐鍥� |
## 娉ㄦ剰浜嬮」
@@ -236,6 +252,9 @@
- **鎺ㄩ�佺洰鏍囩敤鐨勬槸 `userId`锛堟垚鍛樿处鍙凤紝濡� `LiuYi`锛夛紝涓嶆槸濮撳悕銆佷篃涓嶆槸鎵嬫満鍙枫��** 浠庨�氳褰曟帴鍙ｅ彇 `userId` 濉繘 `pushTarget`銆�
- **闄勪欢涓婁紶璧� system 妯″潡鐨勫叕鍏变笂浼犳帴鍙�**锛氭姤鍚嶉〉鍏堣皟 `POST /admin-api/system/storage-blob/public-upload`锛堣〃鍗曞瓧娈靛悕 `files`锛夋嬁鍒� `blobId`锛屽啀鎶� `blobIds` 闅忔姤鍚嶆彁浜わ紝鐢�**鏈嶅姟绔�**瀹屾垚涓庢姤鍚嶈褰曠殑缁戝畾銆傜鐞嗗悗鍙版煡闄勪欢鐢� `/wxcp/activity/signup/attachments`銆�
- **鎶ュ悕鐨� `recordType` 鍥哄畾涓� `wxcp_activity_signup`**锛屽凡娉ㄥ唽杩� system 妯″潡鐨� `StorageRecordTypeEnum` 鐧藉悕鍗曘�備互鍚庢柊澧炲埆鐨勯檮浠跺叧鑱旂被鍨嬶紝蹇呴』鍚屾娉ㄥ唽锛屽惁鍒欑粦瀹氫細鎶ャ�屾棤鏁堢殑璁板綍绫诲瀷銆嶃��
+- **娲诲姩灏侀潰鐨� `recordType` 涓� `wxcp_activity`**锛屽悓鏍峰凡娉ㄥ唽杩涚櫧鍚嶅崟銆傚皝闈�**涓嶅啀鏈� `coverUrl` 瀛楁**锛宍POST/PUT /wxcp/activity/create|update` 鎻愪氦 `blobIds`锛宍GET` 璇� `attachmentList`銆�
+- **灏侀潰鍥惧湪鎶ュ悕椤垫樉绀烘椂浼氬幓鎺夊崗璁拰鍩熷悕**銆傞檮浠跺湴鍧�閲岀殑鍩熷悕鍙栬嚜 `yudao.storage.domain`锛堜竴鑸槸鍐呯綉鍦板潃锛夛紝鑰屾墜鏈烘壂鐮佹槸浠庡叕缃戝煙鍚嶆墦寮�椤甸潰鐨勶紝鐩磋繛鍐呯綉鍦板潃鍔犺浇涓嶅嚭鍥剧墖锛屾墍浠ュ悗绔彧淇濈暀 `/admin-api/...` 璺緞浜ょ粰鍚屾簮浠ｇ悊銆�**濡傛灉閮ㄧ讲鏃剁鐞嗗悗鍙颁笌鎶ュ悕椤典笉鍚屾簮锛岃繖涓鐞嗛渶瑕侀噸鏂拌瘎浼般��**
+- 琛ㄥ崟閲岀殑灏侀潰鐢� `ImageUpload` 缁勪欢锛坄maxNumber: 1`锛夋椂锛岀粍浠惰繑鍥炵殑鏄�**鍗曞�艰�屼笉鏄暟缁�**锛屾彁浜ゅ墠蹇呴』鍖呮垚鏁扮粍锛坄blobIds` 鍚庣绛惧悕鏄� `List<Long>`锛夈��
- 閫氳褰曟帴鍙�**瀹炴椂璋冧紒涓氬井淇�**锛屾湁棰戠巼闄愬埗锛屽墠绔姟蹇呯紦瀛橈紝涓嶈闅忚緭鍏ュ疄鏃惰姹傘��
- 閫氱煡姝ｆ枃瓒呰繃 600 瀛椾細**鑷姩鎴柇**锛堜紒涓氬井淇℃枃鏈秷鎭湁闀垮害涓婇檺锛夛紝鎴柇鎻愮ず浼氬啓鍦ㄦ秷鎭湯灏俱��
--
Gitblit v1.9.3