feat: 定合并的稳定版本

.cursor/agent/产品经理/evolution/2026-03-17.md

@@ -0,0 +1,8 @@
+# 产品经理 经验记录 - 2026-03-17
+
+## 新版管理端迁移到稳定版（会议：实施方案确认）
+
+- **需求基准**：以稳定版小程序为准，管理端支撑余额、代付、VIP、规则引擎等
+- **内容管理**：以稳定版为主，不采纳新版
+- **新版独有**：API 文档、OSS、编辑禁用、鉴权 → 全部吸纳（用户决议「新版有的就迁移」）
+- **待确认**：RFM、用户旅程、神射手是否继续使用

.cursor/agent/后端工程师/evolution/2026-03-17.md

@@ -26,3 +26,10 @@
 
 - 供小程序区分发起人/好友，展示不同 UI
 - 字段：`initiatorUserId`（发起人 user_id）
+
+---
+
+## 新版管理端迁移 - 后端任务（会议：2026-03-17）
+
+- **router 补齐**：迁移前注册 5 个路由：`db.GET("/users/rfm")`、`db.GET("/users/journey-stats")`、`admin.GET("/shensheshou/query")`、`admin.POST("/shensheshou/enrich")`、`admin.POST("/shensheshou/ingest")`
+- **待确认**：/api/admin/settings 是否已支持 ossConfig，若不支持需补充

.cursor/agent/团队/evolution/2026-03-17.md

@@ -19,3 +19,19 @@
 
 - 小程序：代付详情页双态 UI、读页跳转
 - 后端：PayNotify beneficiaryUserID、detail initiatorUserId
+
+---
+
+## 新版管理端迁移到稳定版（会议：2026-03-17）
+
+### 决议
+
+- **内容管理**：以稳定版为主，不采纳新版
+- **新版独有**：API 文档 Tab、api-docs 独立页、OSS 配置、编辑时手机号禁用、鉴权逻辑 → **全部吸纳**
+- **后端**：迁移前补 router（users/rfm、journey-stats、shensheshou 共 5 个）
+
+### 影响角色
+
+- 管理端开发工程师：主导迁移
+- 后端开发：router 补齐、ossConfig 确认
+- 测试人员：迁移后验收

.cursor/agent/开发助理/项目索引/助理橙子.md

@@ -22,9 +22,10 @@
 | 2026-03-17 | 吸收需求：代付美团式流程、PayNotify 权益归属、目录 loading、最新新增 5 条折叠 → 开发文档与 agent | 已完成 |
 | 2026-03-17 | 乘风吸收经验与交互：迁移完成度与待办清单、运营与变更第十二部分 | 已完成 |
 | 2026-03-17 | 吸收新需求：代付统一到代付页（gift=1&ref redirectTo）→ 需求汇总、找朋友代付流程、运营与变更 | 已完成 |
+| 2026-03-17 | 会议收尾：新版管理端迁移到稳定版实施方案确认；纪要、各角色经验入库、项目索引更新 | 已完成 |
 
 > **格式说明**：每次开发后在此追加一行，日期格式 YYYY-MM-DD，状态用：已完成 / 进行中 / 待续 / 搁置
 
 ---
 
-**最后更新**：2026-03-17（吸收代付与体验优化需求）
+**最后更新**：2026-03-17（会议收尾：新版管理端迁移实施方案）

.cursor/agent/开发助理/项目索引/后端.md

@@ -32,6 +32,7 @@ soul-api（Go + Gin + GORM + MySQL）提供三组路由：`/api/miniprogram/*`
 | 2026-03-16 | ParseAutoLinkContent 添加 data-label；存客宝 create planType=1 sceneId=9 status=1 | 已完成 |
 | 2026-03-16 | 会议：new-soul 新需求与当前项目差异分析；content_upload.py 与 chapters 一致性待核对 | 待续 |
 | 2026-03-17 | 代付 PayNotify 权益归属修复：beneficiaryUserID（代付=发起人）；gift-pay detail 返回 initiatorUserId | 已完成 |
+| 2026-03-17 | 会议：新版管理端迁移；router 补齐 users/rfm、journey-stats、shensheshou 共 5 个；确认 ossConfig | 进行中 |
 
 > **格式说明**：每次开发后在此追加一行，日期格式 YYYY-MM-DD，状态用：已完成 / 进行中 / 待续 / 搁置
 

.cursor/agent/开发助理/项目索引/管理端.md

@@ -8,6 +8,13 @@
 
 管理端（React + Vite + Tailwind）主要功能：用户管理、订单管理、提现审核、VIP 管理、内容/章节管理、配置项管理、数据统计。调用 `/api/admin/*` 与 `/api/db/*` 接口，JWT Bearer 鉴权。
 
+### 项目路径定义
+
+| 版本 | 路径 | 说明 |
+|------|------|------|
+| **稳定版（主用）** | `soul-admin/` | 根目录，线上部署 |
+| **新版（参考）** | `new-soul/soul-admin/` | 迁移时对照，含 ApiDocsPage 完整版、OSS region 等 |
+
 ---
 
 ## 开发进度
@@ -28,9 +35,14 @@
 | 2026-03-16 | 乘风发起例行开发进度同步 | 已完成 |
 | 2026-03-16 | 链接人与事：table 布局、planId/apiKey 列、复制图标、删除 Dialog 弹窗 | 已完成 |
 | 2026-03-16 | 会议：new-soul 新需求与当前项目差异分析；派对AI 不新增管理端需求 | 已完成 |
+| 2026-03-17 | 会议：新版管理端迁移到稳定版实施方案确认；新版独有全部吸纳，内容管理以稳定版为主 | 已完成 |
+| 2026-03-17 | 吸收新版管理端定义（new-soul/soul-admin）；迁移 ApiDocsPage 完整版、OSS region、鉴权失败 clearAdminToken | 已完成 |
+| 2026-03-17 | 修复 DistributionPage Order.description；用户余额人工调整（后端 adjust API + 用户详情入口）；代付列表页（后端 gift-pay-requests + 推广中心 Tab） | 已完成 |
 
 > **格式说明**：每次开发后在此追加一行，日期格式 YYYY-MM-DD，状态用：已完成 / 进行中 / 待续 / 搁置
 
 ---
 
-**最后更新**：2026-03-16
+**最后更新**：2026-03-17
+
+> 注：soul-admin 构建仍有 DistributionPage Order.description 类型错误（与本次迁移无关），待修复。

.cursor/agent/管理端开发工程师/evolution/2026-03-17.md

@@ -0,0 +1,15 @@
+# 管理端开发工程师 经验记录 - 2026-03-17
+
+## 新版管理端迁移到稳定版（会议：实施方案确认）
+
+### 迁移策略
+
+- **内容管理**：以稳定版为主，不采纳新版，ContentPage 及关联组件不覆盖
+- **新版独有全部吸纳**：API 文档 Tab、api-docs 独立页、OSS 配置、编辑时手机号禁用、鉴权逻辑
+- **必须保留**：用户详情余额、订单支付方式/代付、RechargeAlert、LinkedMp、用户规则、超级个体
+
+### 实施任务
+
+1. 从 new-soul/soul-admin 迁移：ApiDocsPage、OSS 配置、api-docs 路由、编辑时手机号禁用、鉴权逻辑
+2. 以稳定版为基准合并，内容管理不覆盖
+3. 按模块分批：Layout/Dashboard/设置 → 用户/订单/推广/提现/找伙伴

.cursor/agent/软件测试/evolution/2026-03-17.md

@@ -0,0 +1,8 @@
+# 软件测试 经验记录 - 2026-03-17
+
+## 新版管理端迁移验收（会议：实施方案确认）
+
+- **验收清单**：按《新版管理端迁移到稳定版-需求评估》§七
+- **回归范围**：提现、分销、找伙伴、导师、设置等
+- **风险**：合并时避免误覆盖稳定版独有逻辑，建议 diff 逐模块核对
+- **三端联调**：管理端 ↔ soul-api 重点验证；用户规则、订单、余额展示

.cursor/meeting/2026-03-17_新版管理端迁移到稳定版实施方案确认.md

@@ -0,0 +1,106 @@
+# 会议纪要 - 2026-03-17 | 新版管理端迁移到稳定版实施方案确认
+
+> 本文件由**助理橙子**在会议结束后自动生成。
+
+---
+
+## 基本信息
+
+- **时间**：2026-03-17
+- **议题**：新版管理端迁移到稳定版 - 确认实施方案
+- **触发方式**：乘风调动开发人员开会，并确认实施方案
+- **参与角色**：产品经理、后端开发、管理端开发工程师、小程序开发工程师、测试人员
+
+---
+
+## 各角色发言
+
+### 【产品经理】
+
+需求基准以稳定版小程序为准；内容管理以稳定版为主；验收标准见《需求评估》§七；RFM、journey、神射手是否保留需运营确认。
+
+### 【后端开发】
+
+以稳定版为主，后端无需新增接口；若保留 RFM/journey/神射手需补 5 个 router；OSS 需确认 /api/admin/settings 是否支持 ossConfig；建议先补 router 再迁移。
+
+### 【管理端开发工程师】
+
+内容管理以稳定版为准不覆盖；必须保留用户详情余额、订单支付方式/代付、RechargeAlert、LinkedMp 等；可吸纳编辑禁用、鉴权、API 文档、OSS；按模块分批合并。
+
+### 【小程序开发工程师】
+
+本次主要影响管理端，小程序无需改动；迁移后做三端联调验证用户规则、订单、余额。
+
+### 【测试人员】
+
+按《需求评估》§七验收；回归提现、分销、找伙伴等；合并时避免误覆盖稳定版独有逻辑。
+
+---
+
+## 讨论过程
+
+- 乘风确认：后端 router 补齐建议迁移前完成
+- 产品经理：OSS 按实际部署需求，用户决议「新版有的就迁移」→ OSS 纳入
+- 管理端：同意 OSS 纳入，新版独有能力全部吸纳
+
+---
+
+## 会议决议
+
+1. **新版有的就迁移**：API 文档 Tab、api-docs 独立页、OSS 配置、编辑时手机号禁用、鉴权逻辑优化，全部吸纳到稳定版
+2. **内容管理**：以稳定版为主，不采纳新版
+3. **后端 router**：迁移前补齐 users/rfm、users/journey-stats、shensheshou 共 5 个路由（若运营使用）
+4. **实施顺序**：Phase 0 后端补 router → Phase 1 基础模块 → Phase 2 业务模块 → Phase 3 内容保持 → Phase 4 验收
+
+---
+
+## 待办事项（乘风指派）
+
+| 责任角色 | 任务 | 优先级 | 截止建议 |
+|---------|------|--------|---------|
+| 后端开发 | soul-api router 注册 users/rfm、users/journey-stats、shensheshou 共 5 个路由 | 高 | 迁移前 |
+| 后端开发 | 确认 /api/admin/settings 是否支持 ossConfig，若不支持则补充 | 中 | 迁移前 |
+| 管理端开发工程师 | 从 new-soul/soul-admin 迁移：ApiDocsPage、OSS 配置、api-docs 路由、编辑时手机号禁用、鉴权逻辑 | 高 | - |
+| 管理端开发工程师 | 以稳定版为基准合并，内容管理不覆盖，其他模块选择性合并 | 高 | - |
+| 测试人员 | 迁移完成后按《需求评估》§七执行验收，三端联调 | 中 | 迁移后 |
+
+---
+
+## 问题与作答区
+
+| # | 问题 | 责任角色 | 作答 |
+|---|------|---------|------|
+| 1 | RFM、用户旅程、神射手是否继续使用？ | 产品/运营 | （待补充） |
+| 2 | /api/admin/settings 是否已支持 ossConfig？ | 后端开发 | （待补充） |
+
+---
+
+## 各角色经验与业务理解更新
+
+### 产品经理
+
+- 新版管理端迁移以稳定版为基准，内容管理以稳定版为主；新版独有能力（API 文档、OSS、编辑禁用、鉴权）全部吸纳
+
+### 后端开发
+
+- 迁移前需补 router：users/rfm、users/journey-stats、shensheshou 共 5 个；需确认 settings 的 ossConfig 支持
+
+### 管理端开发工程师
+
+- 迁移策略：内容管理不覆盖；其他模块以稳定版为主；吸纳新版 ApiDocsPage、OSS、编辑禁用、鉴权；按模块分批合并
+
+### 小程序开发工程师
+
+- 管理端迁移不影响小程序；迁移后做三端联调验证
+
+### 测试人员
+
+- 验收按《需求评估》§七；合并时需 diff 核对避免误覆盖
+
+### 团队共享
+
+- 新版管理端迁移到稳定版：内容管理以稳定版为主，新版独有能力全部吸纳；详见 agent/团队/evolution/2026-03-17.md
+
+---
+
+*会议纪要由助理橙子生成 | 各角色经验已同步至 `agent/{角色}/evolution/2026-03-17.md`*

.cursor/meeting/README.md

@@ -75,3 +75,4 @@ YYYY-MM-DD_会议主题.md
 | 2026-03-11 | 开发团队对齐业务逻辑与以界面定需求·会议收尾 | 产品、后端、管理端、小程序、团队 | [2026-03-11_开发团队对齐业务逻辑与以界面定需求会议收尾.md](2026-03-11_开发团队对齐业务逻辑与以界面定需求会议收尾.md) |
 | 2026-03-16 | 链接人与事与存客宝对接优化 | 管理端、后端、团队 | [2026-03-16_链接人与事与存客宝对接优化.md](2026-03-16_链接人与事与存客宝对接优化.md) |
 | 2026-03-16 | new-soul 新需求与当前项目差异分析 | 产品、后端、管理端、小程序、测试 | [2026-03-16_new-soul新需求与当前项目差异分析.md](2026-03-16_new-soul新需求与当前项目差异分析.md) |
+| 2026-03-17 | 新版管理端迁移到稳定版实施方案确认 | 产品、后端、管理端、小程序、测试 | [2026-03-17_新版管理端迁移到稳定版实施方案确认.md](2026-03-17_新版管理端迁移到稳定版实施方案确认.md) |

.cursor/rules/soul-project-boundary.mdc

@@ -15,9 +15,10 @@ alwaysApply: true
 | 子项目 | 目录 | 用途 | 后端对接 |
 |--------|------|------|----------|
 | 小程序 | miniprogram/ | 微信原生小程序 C 端 | soul-api |
-| 管理端 | soul-admin/ | React 管理后台 | soul-api |
+| 管理端 | soul-admin/ | React 管理后台（稳定版，主用） | soul-api |
 | API 后端 | soul-api/ | Go + Gin + GORM 接口服务 | - |
 | 预览/参考 | next-project/ | 仅预览，非线上 | 不依赖 |
+| **新版管理端** | **new-soul/soul-admin/** | 新版参考实现，迁移时对照 | soul-api |
 
 ## 核心原则