更新小程序，新增VIP会员状态管理功能，优化章节解锁逻辑，支持VIP用户访问增值内容。调整用户详情页面，增加VIP相关字段和功能，提升用户体验。更新会议记录，反映最新讨论内容。

2026-03-10 11:04:34 +08:00
parent 30ebdb5ac7
commit 05ac60dc7e
60 changed files with 8387 additions and 1583 deletions
--- a/.cursor/meeting/2026-03-09_devlop与yongxu分支差异分析会议.md
+++ b/.cursor/meeting/2026-03-09_devlop与yongxu分支差异分析会议.md
@@ -0,0 +1,157 @@
+# 会议纪要 - 2026-03-09 | devlop 与 yongxu 分支差异分析
+
+> 本文件由**助理橙子**在会议结束后自动生成。
+
+---
+
+## 基本信息
+
+- **时间**：2026-03-09
+- **议题**：分析 devlop（dev 分支 / Mycontent-temp）与 yongxu（当前分支）两个项目的区别
+- **触发方式**：开个会议
+- **参与角色**：产品经理、后端开发、管理端开发工程师、小程序开发工程师、测试人员
+
+---
+
+## 各角色发言
+
+### 【产品经理】
+
+**分支定位**：
+- **devlop**：老板的老板主改，侧重内容管理、用户管理、找伙伴等管理端能力，开发文档已删除（迁移至他处）
+- **yongxu**：你主改，侧重 C 端体验：@提及、一键收款、个人资料页、找伙伴、推荐码绑定、分享带 ref、退款等
+
+**差异要点**：
+- devlop 删除了整个 `开发文档/` 目录（约 100+ 文件），yongxu 保留
+- 需求文档（20260308 内容管理、用户管理、找伙伴）在 devlop 侧有更新，yongxu 侧沿用旧版
+- 合并后需确保：C 端功能（@提及、推荐码、一键收款）不丢，管理端能力（ContentPage、FindPartnerPage、UsersPage）不丢
+
+### 【后端开发】
+
+**devlop 独有**（yongxu 没有）：
+- `admin_dashboard.go`、`admin_rfm.go`、`admin_shensheshou.go`、`admin_user_rules.go`
+- `db_book.go`、`db_person.go`（db 路由组扩展）
+- `ckb.go` 大改（存客宝扩展）
+- `match.go`、`match_records.go` 扩展
+- `book.go`、`user.go`、`cron.go` 等逻辑更新
+- `person.go`、`user_rule.go` 等 model 新增
+- 路由、数据库、配置等变更
+
+**yongxu 独有**（devlop 没有）：
+- @提及相关接口、免费章节判断、存客宝限频、退款逻辑等（在共同祖先 90d32a51 之后）
+
+**共同修改文件（易冲突）**：
+- `soul-api/internal/handler/miniprogram.go`
+- `soul-api/internal/config/config.go`
+- `soul-api/internal/database/database.go`
+- `soul-api/internal/router/router.go`
+
+### 【管理端开发工程师】
+
+**devlop 独有**（yongxu 没有）：
+- `ContentPage.tsx` 大改（约 1395 行变更）
+- `ChapterTree.tsx`、`ChaptersPage.tsx` 新增/重构
+- `FindPartnerPage.tsx` 及多 Tab：CKBConfigPanel、CKBStatsTab、FindPartnerTab、MatchPoolTab、MatchRecordsTab、MentorBookingTab、MentorTab、ResourceDockingTab、TeamRecruitTab
+- `RichEditor.tsx`、`UserDetailModal.tsx` 扩展
+- `UsersPage.tsx` 大改（约 1267 行）
+- `DashboardPage.tsx`、`DistributionPage.tsx`、`SettingsPage.tsx` 等更新
+- `client.ts`、`AdminLayout.tsx`、`App.tsx` 配置调整
+
+**yongxu**：管理端改动较少，主要在小程序侧
+
+**合并策略**：以 devlop 管理端为主，yongxu 若有管理端改动需手工合入
+
+### 【小程序开发工程师】
+
+**yongxu 独有**（相对共同祖先 90d32a51）：
+- `app.js`：baseUrl 真实后端、goBackOrToHome、推荐码/访问记录、checkUpdate
+- `read/*`：@提及解析与高亮、mid 优先跳转
+- `chapters/*`：章节列表、分享
+- `index/*`：首页、已读/待读
+- `my/*`：个人中心、导航栏
+
+**devlop 也改了同一批文件**：
+- `miniprogram/app.js`、`app.json`
+- `miniprogram/pages/chapters/chapters.js`、`chapters.json`
+- `miniprogram/pages/index/index.js`、`index.wxml`
+- `miniprogram/pages/my/my.js`
+- `miniprogram/pages/read/read.js`、`read.wxml`、`read.wxss`
+- `miniprogram/project.private.config.json`
+- `miniprogram/utils/readingTracker.js`
+
+**合并重点**：上述文件两分支均有修改，合并时需保留 yongxu 的 @提及、推荐码、baseUrl、goBackOrToHome 等业务逻辑，同时接纳 devlop 的其它改动（若有）
+
+### 【测试人员】
+
+合并后需做：
+- 三端联调：小程序↔API、管理端↔API
+- 回归测试：@提及、推荐码、找伙伴、内容管理、用户管理、存客宝、一键收款、退款
+- 建议合并完成后拉一份回归清单，逐项验证
+
+---
+
+## 讨论过程
+
+- 用户明确：Mycontent-temp 对应 dev 分支（devlop），当前打开的是 yongxu 分支
+- 基于 `git diff`、`git log` 分析两分支自共同祖先 90d32a51 以来的差异
+- 共识：devlop 改动量大（248 文件、约 6 万行变更），yongxu 改动小（7 文件、约 366 行），合并时需分模块处理
+
+---
+
+## 会议决议
+
+1. **差异总结**：devlop 侧重管理端与脚本（内容管理、找伙伴、飞书导出、开发文档删除）；yongxu 侧重 C 端（@提及、一键收款、推荐码、baseUrl 真实后端）
+2. **合并策略**：
+   - 管理端、soul-api 新增能力：以 devlop 为主
+   - 小程序：保留 yongxu 的 @提及、推荐码、goBackOrToHome、baseUrl 等，与 devlop 改动手工合并
+   - 开发文档：若需保留，从 yongxu 恢复；若已迁移他处，可沿用 devlop 的删除
+3. **待确认项**：开发文档最终保留在仓库内还是迁移到外部？合并冲突时以哪边为准（按模块已约定）
+
+---
+
+## 待办事项
+
+| 责任角色 | 任务 | 优先级 | 截止建议 |
+|---------|------|--------|---------|
+| 用户 | 确认开发文档保留策略 | 中 | 合并前 |
+| 用户 | 执行分支合并（如 git merge devlop 或 git merge yongxu） | 高 | 待用户操作 |
+| 助理橙子 | 合并时协助逐文件解决冲突 | 高 | 用户合并时 |
+| 测试人员 | 合并后回归测试 | 中 | 合并完成 |
+
+---
+
+## 问题与作答区
+
+| # | 问题 | 责任角色 | 作答 |
+|---|------|---------|------|
+| 1 | 开发文档最终保留在仓库内还是迁移到外部？ | 用户 | （待补充） |
+| 2 | 合并时以 devlop 为基准合并 yongxu，还是以 yongxu 为基准合并 devlop？ | 用户 | （待补充） |
+
+---
+
+## 两分支差异速查表
+
+| 维度 | devlop（dev 分支） | yongxu（当前分支） |
+|------|-------------------|---------------------|
+| 共同祖先 | 90d32a51 | 90d32a51 |
+| 独有提交数 | 约 200+ | 2 |
+| 变更文件数 | 248 | 7 |
+| 开发文档 | 已删除 | 保留 |
+| 小程序 | 有改动（与 yongxu 重叠） | @提及、推荐码、baseUrl、goBackOrToHome 等 |
+| 管理端 | ContentPage、FindPartnerPage、UsersPage 等大改 | 改动少 |
+| soul-api | admin_*、db_*、ckb、match 等扩展 | 免费章节、存客宝限频、退款等 |
+| 脚本 | 飞书导出、content_upload、Gitea 推送等 | 无 |
+| 会议纪要 | 合并策略、管理端与 API 分析等 | 代码完整性分析、各成员功能检测 |
+
+---
+
+## 各角色经验与业务理解更新
+
+### 团队共享
+
+- 分支差异分析会议：先确定共同祖先，再用 `git diff --stat`、`git log` 分模块梳理，便于制定合并策略
+- 多分支合并时按模块约定「以谁为主」：管理端/soul-api 以 devlop 为主，小程序保留 yongxu 业务逻辑
+
+---
+
+*会议纪要由助理橙子生成 | 各角色经验已同步至 `agent/{角色}/evolution/2026-03-09.md`*
--- a/.cursor/meeting/2026-03-09_dev分支需求分析与yongxu迁移方案.md
+++ b/.cursor/meeting/2026-03-09_dev分支需求分析与yongxu迁移方案.md
@@ -0,0 +1,165 @@
+# dev 分支需求分析与 yongxu 迁移方案
+
+> 基于用户反馈：dev 分支只改了样式，未考虑后端/API/小程序三端协调，导致 bug 或功能不全；yongxu 分支功能完善。本文档分析 dev 需求、识别三端缺口，并给出「新功能迁入 yongxu + 补全功能」的执行方案。
+
+---
+
+## 一、dev 分支变更概览
+
+### 1.1 变更性质（用户结论）
+
+- **dev 侧重**：管理端 UI/样式、新页面布局
+- **问题**：未同步考虑 soul-api、miniprogram 的接口与逻辑，导致：
+  - 管理端新页面调用的接口在 yongxu 的 soul-api 中不存在或不全
+  - 小程序端与 dev 管理端配置/数据模型不一致
+  - 三端联调时出现 bug 或功能不全
+
+### 1.2 dev 相对 yongxu 的增量（按模块）
+
+| 模块 | dev 新增/改动 | 依赖的 API/能力 |
+|------|---------------|-----------------|
+| **soul-admin** | ContentPage 大改、ChapterTree、RichEditor、@提及、persons、link-tags 配置 | `/api/db/book`（含 section-orders）、`/api/db/persons`、`/api/db/link-tags`、`/api/db/config/full?key=xxx` |
+| **soul-admin** | FindPartnerPage + 多 Tab（CKBConfigPanel、CKBStatsTab、MatchPoolTab 等） | `/api/db/config/full?key=ckb_config`、`/api/db/ckb-leads` |
+| **soul-admin** | UsersPage 大改、UserDetailModal 扩展 | `/api/db/users` 已有，可能需扩展字段 |
+| **soul-admin** | ChaptersPage 新增、DashboardPage 调整 | 依赖 db/book、db/users 等 |
+| **soul-admin** | DistributionPage、SettingsPage 等样式调整 | 现有 admin 接口 |
+| **soul-api** | admin_dashboard、admin_rfm、admin_shensheshou、admin_user_rules | 新增 handler |
+| **soul-api** | db_person、db_book 扩展（section-orders、move-sections） | 扩展 db_book action |
+| **soul-api** | ckb 扩展、match/match_records 扩展 | 扩展 ckb、match handler |
+| **miniprogram** | 部分页面简化/样式调整 | 与 yongxu 的 @提及、推荐码等可能冲突 |
+
+---
+
+## 二、三端缺口分析（yongxu 当前缺失）
+
+### 2.1 soul-api 缺口（管理端新页面依赖）
+
+| 接口/能力 | dev 管理端调用 | yongxu 是否已有 | 缺口说明 |
+|-----------|---------------|-----------------|----------|
+| `GET/POST/DELETE /api/db/persons` | ContentPage @提及人物配置 | ❌ 无 | 需新增 persons 表、model、handler |
+| `GET/POST/DELETE /api/db/link-tags` | ContentPage 链接标签配置 | ❌ 无 | 需新增 link_tags 表、model、handler |
+| `GET /api/db/book?action=section-orders&id=xxx` | ContentPage 章节内排序 | ❌ 无 | 需在 db_book 中扩展 action |
+| `PUT /api/db/book` action=move-sections | ContentPage 跨章移动 | ❌ 无 | 需在 db_book 中扩展 |
+| `GET /api/db/config/full?key=article_ranking_weights` | ContentPage | ✅ 有 | DBConfigGet 已支持 |
+| `GET /api/db/config/full?key=pinned_section_ids` | ContentPage | ✅ 有 | 同上 |
+| `GET /api/db/config/full?key=unpaid_preview_percent` | ContentPage | ✅ 有 | 同上 |
+| `GET /api/db/config/full?key=ckb_config` | FindPartnerPage CKBConfigPanel | ✅ 有 | 同上 |
+| `GET /api/db/ckb-leads?mode=submitted&page=1&pageSize=50` | FindPartnerPage 存客宝线索 | ❌ 无 | 需新增 ckb_leads 相关接口 |
+| admin_dashboard、admin_rfm、admin_shensheshou、admin_user_rules | Dashboard、神奢手等 | ❌ 无 | 可选，按业务需要 |
+
+### 2.2 小程序端
+
+- **yongxu 已完善**：@提及、推荐码、baseUrl、goBackOrToHome、一键收款、免费章节、存客宝限频、退款等
+- **策略**：**保留 yongxu 小程序全部逻辑**，不引入 dev 对 miniprogram 的简化（dev 可能删减了功能）
+
+### 2.3 管理端（soul-admin）
+
+- **yongxu 已有**：ContentPage、ChapterTree、UsersPage、DashboardPage 等基础版本
+- **dev 增量**：更丰富的 ContentPage（persons、link-tags、RichEditor @提及）、FindPartnerPage 整页、UsersPage 扩展
+- **策略**：在 soul-api 补全接口后，再选择性迁入 dev 的页面组件
+
+---
+
+## 三、迁移原则
+
+1. **基准分支**：yongxu（功能完善、三端协调良好）
+2. **不引入**：dev 对 miniprogram 的改动（避免覆盖 yongxu 的 @提及、推荐码等）
+3. **分阶段**：先补 soul-api 缺口 → 再迁入 soul-admin 新页面/组件
+4. **三端协调**：每迁入一个管理端功能，必须确保 soul-api 已有对应接口，且小程序若依赖该配置则已对齐
+
+---
+
+## 四、执行方案（按优先级）
+
+### 阶段 1：soul-api 补全（必须）
+
+| 序号 | 任务 | 说明 |
+|------|------|------|
+| 1.1 | 新增 `db/persons` | model.Person、表 persons，GET/POST/DELETE，供 ContentPage @提及人物配置 |
+| 1.2 | 新增 `db/link-tags` | model.LinkTag、表 link_tags，GET/POST/DELETE，供 ContentPage 链接标签 |
+| 1.3 | 扩展 `db/book` | 增加 action=section-orders、action=move-sections（若 ContentPage 需要） |
+| 1.4 | 新增 `db/ckb-leads` | 若存在 ckb_leads 表，GET 支持 mode=submitted/contact 分页；否则先建表再实现 |
+
+### 阶段 2：soul-admin 迁入（在阶段 1 完成后）
+
+| 序号 | 任务 | 说明 |
+|------|------|------|
+| 2.1 | ContentPage 增强 | 从 dev 迁入 persons、link-tags 配置区，RichEditor @提及（需 persons 接口） |
+| 2.2 | FindPartnerPage | 从 dev 迁入整页 + Tab（CKBConfigPanel、CKBStatsTab 等），需 ckb_config、ckb-leads 接口 |
+| 2.3 | UsersPage 扩展 | 从 dev 迁入 UserDetailModal 等扩展（若字段与 yongxu 的 db/users 一致） |
+| 2.4 | 菜单与路由 | 在 AdminLayout、App.tsx 中增加 FindPartner 入口（若尚未有） |
+
+### 阶段 3：可选（按业务需要）
+
+| 序号 | 任务 | 说明 |
+|------|------|------|
+| 3.1 | admin_dashboard、admin_rfm 等 | 若 Dashboard 需要新统计维度，再补充 |
+| 3.2 | dev 的 scripts、飞书导出等 | 与三端功能无直接关系，可单独评估 |
+
+---
+
+## 五、补全功能清单（可直接用于开发）
+
+### 5.1 soul-api 必须补全
+
+```
+[ ] 1. persons 表 + model + GET/POST/DELETE /api/db/persons
+[ ] 2. link_tags 表 + model + GET/POST/DELETE /api/db/link-tags
+[ ] 3. db_book 扩展：GET ?action=section-orders&id=xxx
+[ ] 4. db_book 扩展：PUT action=move-sections（若 ContentPage 需要）
+[ ] 5. ckb_leads 表（若无）+ GET /api/db/ckb-leads?mode=xxx&page=1&pageSize=50
+```
+
+### 5.2 soul-admin 迁入（依赖 5.1）
+
+```
+[ ] 6. ContentPage：persons 配置区、link-tags 配置区
+[ ] 7. ContentPage：RichEditor @提及（调用 persons）
+[ ] 8. FindPartnerPage + Tabs（CKBConfigPanel、CKBStatsTab、FindPartnerTab 等）
+[ ] 9. AdminLayout：增加「找伙伴」菜单项（若尚无）
+[ ] 10. UsersPage：UserDetailModal 扩展（按需）
+```
+
+### 5.3 小程序
+
+```
+[ ] 无需变更，保留 yongxu 全部逻辑
+```
+
+---
+
+## 六、迁移操作建议
+
+### 6.1 不推荐直接 merge devlop
+
+- dev 与 yongxu 在 miniprogram、部分 soul-api 上存在冲突
+- 直接 merge 会覆盖 yongxu 的完善功能
+
+### 6.2 推荐方式
+
+1. **保持当前在 yongxu 分支**
+2. **按阶段 1**：在 yongxu 上直接开发 soul-api 补全（persons、link-tags、db_book 扩展、ckb-leads）
+3. **按阶段 2**：用 `git show devlop:path/to/file` 取出 dev 的 soul-admin 文件，手工合并到 yongxu，并确认调用的接口已在 soul-api 中存在
+4. **每完成一个功能**：过 soul-change-checklist，做三端联调验证
+
+### 6.3 冲突文件处理（若必须 diff 参考）
+
+- `miniprogram/*`：**以 yongxu 为准**，不采纳 dev 的改动
+- `soul-admin/*`：选择性采纳 dev 的 UI/组件，确保调用的 API 已在 yongxu 的 soul-api 中实现
+- `soul-api/*`：以 yongxu 为基础，缺什么补什么（persons、link-tags、ckb-leads 等）
+
+---
+
+## 七、总结
+
+| 项目 | 结论 |
+|------|------|
+| 基准 | yongxu |
+| dev 价值 | 管理端 UI 增强（ContentPage、FindPartnerPage、UsersPage） |
+| dev 问题 | 未配套 soul-api 的 persons、link-tags、ckb-leads 等，导致功能不全 |
+| 迁移路径 | 先补 soul-api → 再迁入 soul-admin 新页面 |
+| 小程序 | 不改动，保留 yongxu |
+
+---
+
+*文档生成：2026-03-09 | 供开发执行参考*
--- a/.cursor/meeting/README.md
+++ b/.cursor/meeting/README.md
@@ -66,3 +66,5 @@ YYYY-MM-DD_会议主题.md
 | 2026-03-05 | 超级个体解锁眼睛需求分析 | 产品、小程序 | [2026-03-05_超级个体解锁眼睛需求分析.md](2026-03-05_超级个体解锁眼睛需求分析.md) |
 | 2026-03-05 | 文章详情 @某人 高亮与一键加好友方案讨论 | 产品、后端、管理端、小程序、测试 | [2026-03-05_文章详情@某人加好友方案讨论.md](2026-03-05_文章详情@某人加好友方案讨论.md) |
 | 2026-03-09 | 代码完整性分析与分支合并准备 | 产品、后端、管理端、小程序、测试 | [2026-03-09_代码完整性分析与分支合并准备.md](2026-03-09_代码完整性分析与分支合并准备.md) |
+| 2026-03-09 | devlop 与 yongxu 分支差异分析 | 产品、后端、管理端、小程序、测试 | [2026-03-09_devlop与yongxu分支差异分析会议.md](2026-03-09_devlop与yongxu分支差异分析会议.md) |
+| 2026-03-09 | dev 分支需求分析与 yongxu 迁移方案 | 产品、后端、管理端、小程序 | [2026-03-09_dev分支需求分析与yongxu迁移方案.md](2026-03-09_dev分支需求分析与yongxu迁移方案.md) |