soul-yongping/.cursor/meeting/2026-03-09_devlop与yongxu比较及各角色边界分析.md

devlop 与 yongxu 比较及各角色边界分析 - 2026-03-09

用户已切换至 devlop 分支。本文档对比老板（devlop）与用户（yongxu）的改动，各角色分析自身边界代码。

---

一、分支对比概览

项目	yongxu（你的）	devlop（当前/老板的）
最新 commit	c3de123e	07e8a43b
主要改动	@提及、一键收款、goBackOrToHome、推荐码、mid 优先跳转	内容管理深度优化、FindPartnerPage、神射手、RFM、dashboard-stats、推荐码自绑拦截
开发文档	保留	已删除（07e8a43b chore）

---

二、【小程序开发工程师】边界分析

2.1 API 路径合规性 ✅

检查项	结果
是否仅调用 /api/miniprogram/*	✅ 是
是否调用 /api/admin/* 或 /api/db/*	⚠️ read.js.backup 调用了 /api/db/config（备份文件，非运行代码）

结论：当前运行代码（read.js、app.js、my.js 等）全部使用 /api/miniprogram/*，符合边界。

2.2 devlop 中老板的改动（miniprogram）

文件	改动摘要
app.js	推荐码绑定优化：不能绑定自己的推荐码；新增 _normalizeReferralCode；错误处理优化
app.json	配置调整
chapters.js	章节列表逻辑调整（约 227 行变更）
index.js	首页逻辑调整（约 31 行）
my.js	新增 loadDashboardStats，调用 /api/miniprogram/user/dashboard-stats
read.js	阅读页逻辑调整（约 270 行变更）
read.wxss	样式调整（-7 行）
readingTracker.js	3 行变更
project.private.config.json	配置调整

2.3 yongxu 独有功能（可能被 devlop 覆盖）

功能	说明	当前 devlop 是否保留
goBackOrToHome	集中返回逻辑	✅ 保留（app.js 有）
baseUrl 真实后端	soulapi.quwanzhi.com	✅ 保留
@提及解析与高亮	阅读页 contentSegments、点击添加好友	❌ 未保留（read.js 无 contentSegments/mention）
一键收款	待确认收款、confirm-received	✅ 保留（my.js 有）
mid 优先跳转	分享带 mid、by-mid 接口	⚠️ 需核对 read.js onLoad 与 getChapterUrl
推荐码 visit/bind	访问记录、绑定	✅ 保留并增强（自绑拦截）

2.4 待办

• @提及功能缺失：devlop 的 read.js 无 contentSegments、ckb/lead 点击逻辑，需从 yongxu 合并或重新实现
• 核对 read.js 的 mid 支持（onLoad、getChapterUrl、by-mid）
• 删除或归档 read.js.backup（避免误用 /api/db/config）

---

三、【管理端开发工程师】边界分析

3.1 API 路径合规性 ✅

检查项	结果
是否仅调用 /api/admin/*、/api/db/*、/api/orders	✅ 是
是否调用 /api/miniprogram/*	✅ 否（SettingsPage 注释中提及为文档说明，非调用）

3.2 devlop 新增/变更的接口调用

接口	页面	后端是否注册
/api/admin/dashboard/overview	DashboardPage	✅
/api/admin/shensheshou/query	UserDetailModal	✅
/api/admin/shensheshou/enrich	UserDetailModal	✅
/api/admin/shensheshou/ingest	UserDetailModal	✅
/api/db/match-records?stats=true	CKBStatsTab	✅
/api/db/ckb-plan-stats	CKBStatsTab	✅
/api/db/match-pool-counts	MatchPoolTab	✅
/api/db/users/rfm	UsersPage	✅
/api/db/users/journey-stats	UsersPage	✅
/api/db/user-rules	UsersPage	✅
/api/db/persons	ContentPage	✅
/api/db/link-tags	ContentPage	✅
/api/db/book?action=section-orders	ContentPage	✅
/api/db/book?action=read	ContentPage	✅
/api/db/config/full?key=article_ranking_weights 等	ContentPage	✅

结论：管理端新增接口均在后端 router 中注册，无 404 风险。

3.3 devlop 新增页面

页面	路由	说明
FindPartnerPage	/find-partner	找伙伴管理（含 CKB 配置、匹配池、资源对接等 Tab）
ChaptersPage	/chapters	章节管理（若为新增）
RichEditor	组件	富文本编辑

3.4 待办

• 联调验证：Dashboard、FindPartner、ContentPage、UsersPage（RFM、user-rules、journey-stats）是否正常

---

四、【后端开发】边界分析

4.1 路由分组合规性 ✅

路由组	前缀	使用方	状态
miniprogram	/api/miniprogram/*	小程序	✅
admin	/api/admin/*	管理端	✅
db	/api/db/*	管理端	✅

4.2 devlop 新增/变更的 handler

Handler	路由	用途
AdminDashboardOverview	GET /api/admin/dashboard/overview	仪表盘概览
AdminShensheShouQuery	GET /api/admin/shensheshou/query	神射手查询
AdminShensheShouIngest	POST /api/admin/shensheshou/ingest	神射手入库
AdminShensheShouEnrich	POST /api/admin/shensheshou/enrich	神射手 enrich
UserDashboardStatsGet	GET /api/miniprogram/user/dashboard-stats	小程序「我的」阅读统计
DBBookAction	扩展	action=section-orders、read 等
DBPersonList/Save/Delete	/api/db/persons	人物管理
DBLinkTagList/Save/Delete	/api/db/link-tags	链接标签
DBUserRulesList/Action	/api/db/user-rules	用户规则
DBUsersRFM	GET /api/db/users/rfm	RFM 估值
DBUsersJourneyStats	GET /api/db/users/journey-stats	用户旅程统计
DBMatchPoolCounts	GET /api/db/match-pool-counts	匹配池统计
CKBPlanStats	GET /api/db/ckb-plan-stats	CKB 计划统计

4.3 待确认

项目	说明
/api/orders 鉴权	仍在 api 根下，未经过 AdminAuth，存在未授权访问风险
开发文档删除	07e8a43b 删除了开发文档目录，若需保留需从 yongxu 或历史恢复

---

五、合并建议

5.1 若需将 yongxu 的改动合入 devlop

1. 小程序：git cherry-pick 或手工合并关键提交：

   • @提及（若 devlop 已覆盖需确认）
   • 一键收款（若 devlop 已覆盖需确认）
   • 其他你独有的优化

2. 管理端：devlop 已大幅领先，无需从 yongxu 合并管理端代码

3. 后端：devlop 已包含更多 handler，yongxu 若有 soul-api 独有改动需手工核对

4. 开发文档：若需保留，可从 yongxu 或历史 commit 恢复 开发文档/ 目录

5.2 冲突处理优先级

• 冲突时以 devlop 为主，再手工补回 yongxu 中你确认必须保留的功能

---

六、会议决议

1. 小程序：边界合规；需核对 @提及、一键收款、mid 在 devlop 中是否完整
2. 管理端：边界合规；新增接口均有对应后端
3. 后端：路由分组正确；/api/orders 鉴权待补
4. 开发文档：若需保留，可从 yongxu 恢复

---

报告生成时间：2026-03-09 | 基于 devlop 分支与 yongxu 比较