5.4 KiB
5.4 KiB
会议纪要 - 2026-03-05 | 文章详情 @某人 高亮与一键加好友方案讨论
本文件由助理橙子在会议结束后自动生成。
基本信息
- 时间：2026-03-05
- 议题：小程序文章详情中「@某人」高亮、点击添加好友；内容编辑时如何插入并存储用户信息（含用户 id），以及是否有更优实现方式
- 触发方式：开一个开发大会，讨论一下
- 参与角色：产品经理、后端开发、管理端开发工程师、小程序开发工程师、测试人员
各角色发言
【产品经理】
- 需求：文章中可出现「@某某人」，名称高亮，用户点击后执行添加该人为好友；添加好友能力以接口为准。
- 用户价值：从内容到人的关系链沉淀，提升互动与转化。
- 业务规则：仅支持 @ 已存在用户；展示名以昵称为准；点击统一为「发起添加好友」。
- 验收标准：文章详情内 @ 名称高亮且可点击；点击后调用添加好友流程；管理端/编辑侧能插入 @用户 并落库（含用户 id）。
【后端开发】
- 添加好友接口需在 soul-api 的 miniprogram 路由组下提供（如
POST /api/miniprogram/friend/add或POST /api/miniprogram/user/add-friend），入参建议targetUserId；开发文档/api_v1.md当前为存客宝文档，添加好友接口应单独约定或在该文档中新增小节。 - 内容存储推荐方案 A：正文存带 @ 标记的字符串，如
@[昵称](userId)或{{@userId:昵称}}，后端只存不解析，由前端解析；方案 B（正文 + mentions 位置表）需维护偏移量，正文变更易错位。 - 数据模型：内容表扩展 content 存带 @ 标记的字符串即可，无需单独表。
【管理端开发工程师】
- 文章/章节编辑页增加「插入 @用户」：选择用户后插入到光标位置，保存时写入约定格式的 content；仅调
/api/admin/*、/api/db/*。 - 管理端列表/预览可简单高亮或原样显示，与小程序约定同一 content 格式即可。
【小程序开发工程师】
- 阅读页当前为按行渲染纯文本；需将 content 解析为「段落 + 片段」（普通文本 / mention），WXML 中对 mention 渲染为可点击
<text data-user-id>并高亮，点击时调用 miniprogram 添加好友接口。 - 继续使用现有章节内容接口，保证返回的 content 含 @ 标记；添加好友调用 miniprogram 组新接口。
【测试人员】
- 用例：无 @ 行为不变；有 @ 高亮且点击调起添加好友并提示；重复点击、未登录、无权限等边界；管理端插入 @ 后保存再编辑，内容与用户 id 不错位。
- 联调：小程序 ↔ 章节接口、添加好友接口；管理端 ↔ 内容保存与用户列表。回归：阅读页其他功能不受影响。
讨论过程
- 一致同意采用「正文内嵌 @ 标记」方案，格式统一为
@[昵称](userId)（或约定等价格式）。 - 添加好友接口不混用存客宝 api_v1，在 soul-api miniprogram 组新增并在开发文档中明确。
- 管理端负责插入 @ 并写入同一 content 格式；小程序负责解析、展示与点击加好友。
会议决议
- 内容格式：正文使用内嵌 @ 标记，格式
@[昵称](userId)（或团队约定的等价格式），后端/管理端/小程序统一。 - 小程序：阅读页解析 content 中 @，渲染为高亮可点击；点击时调 miniprogram 添加好友接口（如
targetUserId），并做结果提示。 - 管理端：编辑页支持「插入 @用户」，保存时写入约定格式的 content。
- 后端：提供 miniprogram 添加好友接口；章节/文章接口返回的 content 支持带 @ 标记的字符串。
- 待确认：添加好友接口的最终 path、入参/出参；若已有好友/关注模型需对齐。
待办事项
| 责任角色 | 任务 | 优先级 | 截止建议 |
|---|---|---|---|
| 后端开发 | 在 miniprogram 组新增添加好友接口并更新开发文档 | 高 | 排期后 |
| 管理端开发工程师 | 文章/章节编辑页支持插入 @用户并保存为约定 content 格式 | 高 | 后端接口与格式确定后 |
| 小程序开发工程师 | 阅读页解析 @ 并高亮可点击，点击调添加好友接口 | 高 | 后端接口就绪后 |
| 产品经理 | 确认添加好友接口 path 与业务规则（已是好友/重复请求等） | 中 | 开发前 |
| 测试人员 | 编写 @ 展示与添加好友用例及回归清单 | 中 | 联调前 |
问题与作答区
| # | 问题 | 责任角色 | 作答 |
|---|---|---|---|
| 1 | 添加好友接口的最终 path、入参（如 targetUserId）、出参及错误码？ | 后端开发 | （待补充） |
| 2 | 开发文档中添加好友接口放在 api_v1.md 新小节还是单独文档？ | 后端/产品 | （待补充） |
| 3 | 是否已有「好友/关注」表或接口需与本次对接？ | 后端开发 | （待补充） |
各角色经验与业务理解更新
- 本次会议结论已同步至各角色当日经验文件（见
agent/{角色}/evolution/2026-03-05.md）。 - 团队共享：内容 @ 采用「正文内嵌
@[昵称](userId)」方案；添加好友接口归属 miniprogram 组，与存客宝 api_v1 分离。
会议纪要由助理橙子生成 | 各角色经验已同步至 agent/{角色}/evolution/2026-03-05.md