From 8e9b32f147b694a87d6426c19114968865378bcb Mon Sep 17 00:00:00 2001
From: zhou zhou <3272660260@qq.com>
Date: 星期六, 28 三月 2026 10:34:19 +0800
Subject: [PATCH] docs: add rsf-design replacement phase-1 spec

---
 docs/superpowers/specs/2026-03-28-rsf-design-replace-rsf-admin-design.md |  331 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 331 insertions(+), 0 deletions(-)

diff --git a/docs/superpowers/specs/2026-03-28-rsf-design-replace-rsf-admin-design.md b/docs/superpowers/specs/2026-03-28-rsf-design-replace-rsf-admin-design.md
new file mode 100644
index 0000000..acbb532
--- /dev/null
+++ b/docs/superpowers/specs/2026-03-28-rsf-design-replace-rsf-admin-design.md
@@ -0,0 +1,331 @@
+# rsf-design 鏇夸唬 rsf-admin 绗竴闃舵璁捐
+
+## 鑳屾櫙
+
+褰撳墠浠撳簱涓瓨鍦ㄤ袱涓墠绔細
+
+- `rsf-admin`锛氱幇缃戞棫鍓嶇锛屾妧鏈爤涓� React + react-admin + MUI
+- `rsf-design`锛氭柊鍓嶇锛屾妧鏈爤涓� Vue 3 + Art Design Pro + Element Plus
+
+鍚庣涓� `rsf-server`锛屾湰娆¤璁℃槑纭害鏉熷涓嬶細
+
+- 鍚庣浠ｇ爜瀹屽叏涓嶄慨鏀�
+- `rsf-design` 闇�瑕佺洿鎺ラ�傞厤褰撳墠鍚庣鐪熷疄鎺ュ彛涓庢暟鎹粨鏋�
+- 涓嶅啓鍏滃簳浠ｇ爜锛屼笉淇濈暀妯℃澘榛樿鍗忚锛屼笉鍋氶暱鏈熷弻鍗忚鍏煎
+- `rsf-admin` 鍦ㄧ涓�闃舵缁х画淇濈暀涓烘棫鍏ュ彛骞惰杩愯
+
+## 鐩爣
+
+绗竴闃舵涓嶈姹� `rsf-design` 涓�娆℃�ц鐩� `rsf-admin` 鐨勫叏閮ㄤ笟鍔￠〉闈紝鑰屾槸鍏堢湡瀹炴帴绠¤繍琛岄鏋讹紝浣垮叾鎴愪负涓�涓彲浠ョ嫭绔嬬櫥褰曞拰鍔ㄦ�佽閰嶇殑鍙敤鏂板叆鍙ｃ��
+
+绗竴闃舵鐩爣鑳藉姏濡備笅锛�
+
+1. 鐧诲綍
+2. 閫�鍑虹櫥褰�
+3. 鐧诲綍鎬佹仮澶�
+4. 鑾峰彇鐢ㄦ埛淇℃伅
+5. 鑾峰彇鑿滃崟
+6. 鍔ㄦ�佹敞鍐岃矾鐢�
+7. 棣栭〉灞曠ず
+8. 鎸夐挳鏉冮檺鎺у埗
+
+## 闈炵洰鏍�
+
+绗竴闃舵涓嶅寘鍚互涓嬪唴瀹癸細
+
+1. 涓嶈縼绉诲叏閮ㄤ笟鍔￠〉闈�
+2. 涓嶉�氳繃 iframe銆佸閾炬垨妗ユ帴鏂瑰紡鎶� `rsf-admin` 宓屽洖 `rsf-design`
+3. 涓嶄繚鐣� `rsf-design` 妯℃澘榛樿鐧诲綍鎺ュ彛銆佺敤鎴锋帴鍙ｃ�佽彍鍗曟帴鍙�
+4. 涓嶄负鏈縼绉婚〉闈㈡彁渚涚┖鐧藉崰浣嶃�侀粯璁ょ寽娴嬬粍浠躲�佽繍琛屾椂鍏滃簳璺宠浆
+5. 涓嶆敼 `rsf-server` 鎺ュ彛銆佹潈闄愭ā鍨嬨�佽彍鍗曡繑鍥炴牸寮�
+
+## 鐜扮姸缁撹
+
+### rsf-admin 鐨勭湡瀹炶繍琛屾ā鍨�
+
+`rsf-admin` 褰撳墠鐩存帴渚濊禆浠ヤ笅鍚庣鎺ュ彛鍜岀害瀹氾細
+
+- 鐧诲綍锛歚/login`
+- 鑿滃崟锛歚/auth/menu`
+- 鐢ㄦ埛淇℃伅锛歚/auth/user`
+- 閫氱敤 CRUD锛�
+  - `/{resource}/page`
+  - `/{resource}/save`
+  - `/{resource}/update`
+  - `/{resource}/remove/*`
+
+鍏跺叧閿壒寰佷笉鏄�滃悗绔繑鍥炲墠绔矾鐢辫矾寰勨�濓紝鑰屾槸鈥滃悗绔彍鍗曞彾瀛愯妭鐐硅繑鍥炶祫婧愭爣璇嗏�濄�傛棫鍓嶇閫氳繃 `node.component` 杩欐牱鐨勬爣璇嗭紝渚嬪 `userLogin`銆乣outBound`銆乣stockTransfer`锛屽啀鍦� `rsf-admin/src/page/ResourceContent.js` 涓槧灏勫埌鍏蜂綋 React 椤甸潰瀹炵幇銆�
+
+### rsf-design 褰撳墠榛樿妯″瀷
+
+`rsf-design` 浣滀负 Art Design Pro 妯℃澘锛屽綋鍓嶉粯璁ゅ亣璁撅細
+
+- 鐧诲綍鎺ュ彛涓� `/api/auth/login`
+- 鐢ㄦ埛淇℃伅鎺ュ彛涓� `/api/user/info`
+- 鑿滃崟鎺ュ彛涓� `/api/v3/system/menus/simple`
+- `component` 瀛楁鍙洿鎺ユ槧灏勫埌 `src/views/**` 涓嬬殑 Vue 椤甸潰璺緞
+
+杩欏榛樿妯″瀷涓庡綋鍓嶅悗绔湡瀹炲崗璁苟涓嶄竴鑷达紝鍥犳涓嶈兘閫氳繃绠�鍗曟敼 baseURL 鎴栨敼鐜鍙橀噺瀹屾垚鏇夸唬銆�
+
+## 鎬讳綋鏂规
+
+### 鎬讳綋鍘熷垯
+
+绗竴闃舵閲囩敤鈥滄柊鍓嶇鐩存帴閫傞厤鏃у悗绔湡瀹炲崗璁�濈殑鏂瑰紡鎺ㄨ繘锛�
+
+- 鍚庣鍗忚涓嶅彉
+- 鏂板墠绔繍琛屾ā鍨嬮噸寤�
+- 涓嶇淮鎶ゆā鏉块粯璁ゅ崗璁�
+- 涓嶅仛鍙岃建鍏煎
+- 涓嶆毚闇叉湭杩佺Щ椤甸潰
+
+### 杩愯涓婚摼
+
+`rsf-design` 鐨勭涓�闃舵杩愯閾捐矾鏀舵暃涓轰竴鏉℃寮忎富閾撅細
+
+1. 鐢ㄦ埛鍦� `rsf-design` 鐧诲綍
+2. 鍓嶇璋冪敤褰撳墠鍚庣鐪熷疄鐧诲綍鎺ュ彛 `/login`
+3. 鐧诲綍鎴愬姛鍚庝繚瀛� token 骞舵爣璁扮櫥褰曠姸鎬�
+4. 璺敱瀹堝崼鍦ㄩ娆¤繘鍏ュ彈淇濇姢椤甸潰鏃惰皟鐢� `/auth/user`
+5. 璺敱瀹堝崼璋冪敤 `/auth/menu`
+6. 鑿滃崟杞崲妯″潡灏嗗悗绔湡瀹炶彍鍗曠粨鏋勮浆鎹负 Art Design Pro 鍙敞鍐岃矾鐢辩粨鏋�
+7. 鍔ㄦ�佹敞鍐岃矾鐢便�佺敓鎴愯彍鍗曘�佽绠楅椤佃惤鐐�
+8. 椤甸潰涓庢寜閽潈闄愮粺涓�浠庣湡瀹炵敤鎴蜂俊鎭拰鐪熷疄鑿滃崟鏉冮檺涓鍙�
+
+## 鏋舵瀯杈圭晫
+
+### 绗竴闃舵鍙戝竷杈圭晫
+
+`rsf-design` 绗竴闃舵鍙彂甯冨凡缁忕湡瀹炴帴鍏ョ殑鏂拌兘鍔涳細
+
+- 鐧诲綍椤�
+- 棣栭〉
+- 鐢ㄦ埛淇℃伅鑾峰彇
+- 鑿滃崟娓叉煋
+- 鍔ㄦ�佽矾鐢�
+- 鎸夐挳鏉冮檺
+- 宸叉槑纭帴鍏ョ殑鏂伴〉闈�
+
+鏈縼绉讳笟鍔￠〉涓嶅嚭鐜板湪 `rsf-design` 鐨勫彲瑙佽彍鍗曞拰鍙敞鍐岃矾鐢变腑銆�
+
+### 骞惰杩愯杈圭晫
+
+- `rsf-admin` 淇濈暀涓烘棫鍏ュ彛
+- `rsf-design` 鎻愪緵鏂板叆鍙�
+- 涓よ�呭苟琛屽瓨鍦紝浜掍笉妗ユ帴
+- 鍚庣画姣忚縼绉讳竴涓ā鍧楋紝鍐嶆妸瀵瑰簲璧勬簮绾冲叆 `rsf-design` 鐨勫彂甯冭寖鍥�
+
+## 鏁版嵁濂戠害璁捐
+
+### 鐧诲綍濂戠害
+
+`rsf-design` 鐧诲綍椤靛繀椤绘敼涓烘彁浜ゅ綋鍓嶅悗绔湡瀹炲瓧娈碉紝涓嶅啀娌跨敤妯℃澘绀轰緥瀛楁鍜屾紨绀鸿处鍙烽�昏緫銆�
+
+瑕佹眰锛�
+
+- 璇锋眰鍦板潃浣跨敤 `/login`
+- 璇锋眰鍙傛暟浣跨敤 `rsf-server` 褰撳墠鐪熷疄闇�瑕佺殑瀛楁
+- 鐧诲綍鎴愬姛鍚庡彧浠ョ湡瀹炲搷搴斿瓧娈靛啓鍏� store
+- 涓嶄繚鐣欐ā鏉夸腑 `token`銆乣refreshToken` 鐨勫亣璁惧懡鍚嶏紝鎸夌湡瀹炶繑鍥炰负鍑�
+
+### 鐢ㄦ埛淇℃伅濂戠害
+
+鐢ㄦ埛淇℃伅鎺ュ彛缁熶竴浣跨敤 `/auth/user`銆�
+
+璇ユ帴鍙ｆ壙鎷呬互涓嬭亴璐ｏ細
+
+- 鎻愪緵褰撳墠鐢ㄦ埛鍩虹淇℃伅
+- 鎻愪緵瑙掕壊淇℃伅 `roles`
+- 鎻愪緵鎸夐挳鏉冮檺闆嗗悎 `buttons` 鎴栧綋鍓嶇湡瀹炴潈闄愬瓧娈�
+
+`v-roles` 鍜� `useAuth` 蹇呴』鐩存帴娑堣垂鐪熷疄鐢ㄦ埛淇℃伅锛屼笉鍐嶄緷璧栨ā鏉跨ず渚嬫暟鎹��
+
+### 鑿滃崟濂戠害
+
+鑿滃崟鎺ュ彛缁熶竴浣跨敤 `/auth/menu`銆�
+
+鍚庣杩斿洖鐨勫師濮嬭彍鍗曟爲淇濇寔鍘熸牱锛屼笉瑕佹眰鍚庣璋冩暣涓� Vue 璺敱璺緞銆�
+
+鍓嶇鍦ㄥ敮涓�鐨勮彍鍗曡浆鎹㈡ā鍧椾腑瀹屾垚锛�
+
+1. 瀛楁鏍囧噯鍖�
+2. 鐖跺瓙璺緞鎷兼帴
+3. 棣栭〉閲嶅畾鍚戞帹瀵�
+4. 璧勬簮鏍囪瘑鍒� Vue 缁勪欢鐨勬槧灏�
+5. 绗竴闃舵鍙戝竷鑼冨洿杩囨护
+6. `meta` 瀛楁琛ラ綈
+
+## 妯″潡鎷嗗垎
+
+绗竴闃舵寤鸿闆嗕腑淇敼浠ヤ笅妯″潡銆�
+
+### 1. 璁よ瘉鎺ュ彛妯″潡
+
+鏂囦欢锛�
+
+- `rsf-design/src/api/auth.js`
+
+鑱岃矗锛�
+
+- 閲嶅啓鐧诲綍鎺ュ彛
+- 鏂板鑾峰彇鐢ㄦ埛淇℃伅鎺ュ彛
+- 鏂板鑾峰彇鑿滃崟鎺ュ彛
+- 鍒犻櫎妯℃澘榛樿璁よ瘉鎺ュ彛鍋囪
+
+### 2. 鐧诲綍椤�
+
+鏂囦欢锛�
+
+- `rsf-design/src/views/auth/login/index.vue`
+
+鑱岃矗锛�
+
+- 鍘绘帀妯℃澘婕旂ず璐﹀彿閫昏緫
+- 鎸夌湡瀹炰笟鍔″瓧娈垫彁浜ょ櫥褰曡姹�
+- 鐧诲綍鎴愬姛鍚庡啓鍏ョ敤鎴风姸鎬佸苟璺宠浆
+- 淇濈暀 Art Design Pro 椋庢牸锛屼絾浠ョ湡瀹炵櫥褰曟祦绋嬩负鍑�
+
+### 3. 鐢ㄦ埛鐘舵�佹ā鍧�
+
+鏂囦欢锛�
+
+- `rsf-design/src/store/modules/user.js`
+
+鑱岃矗锛�
+
+- 鎸夌湡瀹炴帴鍙ｅ瓧娈靛瓨鍌� token 涓庣敤鎴蜂俊鎭�
+- 淇濊瘉鍒锋柊鍚庡彲鎭㈠鐧诲綍鐘舵��
+- 閫�鍑虹櫥褰曟椂娓呯悊鏉冮檺銆佽彍鍗曘�佹爣绛鹃〉銆佽矾鐢辩紦瀛�
+
+### 4. 鑿滃崟杞崲妯″潡
+
+寤鸿鏂板鏂囦欢锛�
+
+- `rsf-design/src/router/adapters/backendMenuAdapter.js`
+
+鑱岃矗锛�
+
+- 鎺ユ敹 `/auth/menu` 鍘熷杩斿洖
+- 缁熶竴杞崲涓� Art Design Pro 鍙敞鍐岃矾鐢�
+- 鍦ㄨ繖閲屽畬鎴愬悗绔祫婧愭爣璇嗗埌 Vue 椤甸潰缁勪欢鐨勬槧灏�
+- 鍦ㄨ繖閲屾墽琛岀涓�闃舵鍙戝竷鑼冨洿杩囨护
+
+涓嶅崟鐙媶椤甸潰娉ㄥ唽妯″潡锛岄伩鍏嶉澶栨娊璞″眰銆�
+
+### 5. 鑿滃崟澶勭悊涓庡姩鎬佽矾鐢辨敞鍐�
+
+鏂囦欢锛�
+
+- `rsf-design/src/router/core/MenuProcessor.js`
+- `rsf-design/src/router/core/ComponentLoader.js`
+- `rsf-design/src/router/guards/beforeEach.js`
+
+鑱岃矗锛�
+
+- 鏀逛负浣跨敤鐪熷疄鑿滃崟鎺ュ彛
+- 鏀逛负渚濊禆鑿滃崟杞崲妯″潡鐨勭粨鏋�
+- 绉婚櫎鈥滃悗绔� component 鍙洿鎺ユ槧灏� views 璺緞鈥濈殑榛樿鍋囪
+- 淇濊瘉棣栨鐧诲綍銆佸埛鏂伴〉闈€�佺洿鎺ヨ闂繁閾炬帴鏃堕兘鑳芥纭姩鎬佹敞鍐�
+
+### 6. 鏉冮檺鎺у埗
+
+鏂囦欢锛�
+
+- `rsf-design/src/hooks/core/useAuth.js`
+- `rsf-design/src/directives/core/auth.js`
+- `rsf-design/src/directives/core/roles.js`
+
+鑱岃矗锛�
+
+- 涓庣湡瀹炵敤鎴蜂俊鎭拰鐪熷疄鑿滃崟鏉冮檺缁撴瀯淇濇寔涓�鑷�
+- 鎸夊悗绔繑鍥炵殑瑙掕壊涓庢寜閽潈闄愬仛缁熶竴鎺у埗
+- 涓嶄繚鐣欐ā鏉挎紨绀烘潈闄愰�昏緫
+
+## 鑿滃崟鍙戝竷瑙勫垯
+
+绗竴闃舵閲囩敤鈥滀弗鏍煎彂甯冣�濈瓥鐣ャ��
+
+瑙勫垯濡備笅锛�
+
+1. 鍚庣杩斿洖瀹屾暣鑿滃崟鏍�
+2. 鍓嶇鍏堝仛涓�娆′弗鏍艰浆鎹�
+3. 浠呬繚鐣欑涓�闃舵鏄庣‘鍏佽鍙戝竷鐨勮彍鍗曡妭鐐�
+4. 浠呬负鍏佽鍙戝竷鐨勮妭鐐规敞鍐岃矾鐢�
+5. 鏈繘鍏ュ彂甯冭寖鍥寸殑鑺傜偣鐩存帴鍦ㄨ彍鍗曡浆鎹㈤樁娈靛墧闄�
+
+杩欐牱鍋氱殑鐩殑涓嶆槸鍏煎锛岃�屾槸淇濊瘉 `rsf-design` 鍙戝竷鍑烘潵鐨勫叆鍙ｆ槸闂悎鍙敤鐨勭湡瀹炲瓙闆嗐��
+
+## 棣栭〉绛栫暐
+
+绗竴闃舵棣栭〉鐢� `rsf-design` 鐙珛鎵挎媴锛屼笉娌跨敤 `rsf-admin` 鐨� react-admin Dashboard 瀹炵幇銆�
+
+瑕佹眰锛�
+
+- 棣栭〉鏄柊鍓嶇鍘熺敓椤甸潰
+- 鏍峰紡涓庡竷灞�閬靛惊 Art Design Pro 瑙勮寖
+- 涓嶄緷璧栨棫鍓嶇椤甸潰妗ユ帴
+- 鍚庣画鍙�愭鍙犲姞缁熻鏁版嵁涓庝笟鍔″緟鍔烇紝浣嗙涓�闃舵鍙姹傛垚涓烘湁鏁堢櫥褰曡惤鐐�
+
+## 椋庨櫓涓庡簲瀵�
+
+### 椋庨櫓 1锛氬悗绔彍鍗曠殑 component 涓嶆槸 Vue 璺緞
+
+杩欐槸鏈鏇夸唬鐨勬牳蹇冨樊寮傘��
+
+搴斿锛�
+
+- 涓嶅啀鍋囪 `component` 鏄� `src/views/**` 璺緞
+- 鍦ㄨ彍鍗曡浆鎹㈡ā鍧椾腑鏄惧紡瀹屾垚璧勬簮鏍囪瘑鏄犲皠
+
+### 椋庨櫓 2锛氭ā鏉块粯璁ゆ帴鍙ｅ瓧娈典笌鐪熷疄鎺ュ彛瀛楁涓嶄竴鑷�
+
+搴斿锛�
+
+- 鍏ㄩ噺鏇挎崲 `rsf-design` 榛樿璁よ瘉鐩稿叧鎺ュ彛
+- 鎵�鏈夌櫥褰曘�佺敤鎴枫�佽彍鍗曞瓧娈典互鐪熷疄鍚庣杩斿洖涓哄噯
+
+### 椋庨櫓 3锛氭湭杩佺Щ鑿滃崟琚敊璇毚闇�
+
+搴斿锛�
+
+- 绗竴闃舵鍙戝竷鑼冨洿杩囨护蹇呴』鍙戠敓鍦ㄨ彍鍗曡浆鎹㈤樁娈�
+- 涓嶅厑璁告敞鍐屾湭鎺ュ叆椤甸潰鐨勮矾鐢�
+
+### 椋庨櫓 4锛氬埛鏂板悗涓㈠け鍔ㄦ�佽矾鐢�
+
+搴斿锛�
+
+- 璺敱瀹堝崼蹇呴』鏀寔鍩轰簬 token 鐨勯噸鏂版媺鍙栫敤鎴蜂俊鎭拰鑿滃崟骞堕噸寤哄姩鎬佽矾鐢�
+
+## 楠屾敹鏍囧噯
+
+绗竴闃舵瀹屾垚鍚庯紝鑷冲皯婊¤冻浠ヤ笅鏉′欢锛�
+
+1. 鐢ㄦ埛鍙�氳繃鐪熷疄璐﹀彿鍦� `rsf-design` 鎴愬姛鐧诲綍
+2. token銆佺敤鎴蜂俊鎭�佽鑹层�佹寜閽潈闄愬叏閮ㄦ潵鑷綋鍓嶅悗绔湡瀹炴帴鍙�
+3. `rsf-design` 鍙熀浜� `/auth/menu` 瀹屾垚鍔ㄦ�佽矾鐢辨敞鍐�
+4. 鍒锋柊椤甸潰鍚庡姩鎬佽矾鐢变粛鑳芥仮澶�
+5. 绗竴闃舵鍙戝竷鑿滃崟涓殑姣忎釜椤甸潰閮藉彲姝ｅ父璁块棶
+6. 涓嶅嚭鐜扮粍浠舵湭鎵惧埌銆佺┖鐧藉崰浣嶃�佸厹搴曡烦杞�佸亣鑿滃崟鑺傜偣
+7. `v-auth`銆乣useAuth`銆乣v-roles` 鍙纭帶鍒堕〉闈㈡寜閽樉绀�
+8. 鏈櫥褰曡闂彈淇濇姢椤甸潰鏃朵細璺冲洖鐧诲綍椤�
+9. `rsf-admin` 鏃у叆鍙ｄ粛淇濇寔鍙敤
+
+## 鍚庣画闃舵
+
+绗竴闃舵瀹屾垚鍚庯紝鍚庣画杩佺Щ浠モ�滄ā鍧楁壒娆♀�濇帹杩涖��
+
+姣忎釜涓氬姟妯″潡杩佺Щ鏃堕兘閬靛惊鐩稿悓娴佺▼锛�
+
+1. 鍦� `rsf-design` 涓疄鐜板搴� Vue 椤甸潰
+2. 鍦ㄨ彍鍗曡浆鎹㈡ā鍧椾腑琛ュ厖璇ヨ祫婧愭爣璇嗘槧灏�
+3. 灏嗚妯″潡鍔犲叆鍙戝竷鑼冨洿
+4. 瀹屾垚鑱旇皟涓庨獙璇佸悗鍐嶅澶栧紑鏀�
+
+杩欏彲浠ヤ繚璇佹浛浠ｈ繃绋嬪缁堟槸澧為噺鍙獙璇佺殑锛岃�屼笉鏄竴娆℃�уぇ鐖嗙偢鍒囨崲銆�
+
+## 缁撹
+
+`rsf-design` 瀹屽叏鏇夸唬 `rsf-admin` 鐨勬纭涓�姝ワ紝涓嶆槸鈥滃厛鎶婃墍鏈夐〉闈㈠鍒惰繃鍘烩�濓紝鑰屾槸鍏堣鏂板墠绔畬鏁存帴浣忔棫鍚庣鐨勭櫥褰曘�佺敤鎴枫�佽彍鍗曘�佹潈闄愪笌鍔ㄦ�佽閰嶆ā鍨嬨��
+
+鍙绗竴闃舵鎶婅繍琛岄鏋舵帴绋筹紝鍚庣画涓氬姟椤甸潰杩佺Щ灏变細浠庘�滃ぇ閲嶆瀯鈥濆彉鎴愨�滄寜璧勬簮鏍囪瘑閫愪釜杩佸叆鈥濈殑绋冲畾澧為噺宸ヤ綔銆�

--
Gitblit v1.9.1