# 会议纪要 - 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 渲染为可点击 `` 并高亮，点击时调用 miniprogram 添加好友接口。 - 继续使用现有章节内容接口，保证返回的 content 含 @ 标记；添加好友调用 miniprogram 组新接口。 ### 【测试人员】 - 用例：无 @ 行为不变；有 @ 高亮且点击调起添加好友并提示；重复点击、未登录、无权限等边界；管理端插入 @ 后保存再编辑，内容与用户 id 不错位。 - 联调：小程序 ↔ 章节接口、添加好友接口；管理端 ↔ 内容保存与用户列表。回归：阅读页其他功能不受影响。 --- ## 讨论过程 - 一致同意采用「正文内嵌 @ 标记」方案，格式统一为 `@[昵称](userId)`（或约定等价格式）。 - 添加好友接口不混用存客宝 api_v1，在 soul-api miniprogram 组新增并在开发文档中明确。 - 管理端负责插入 @ 并写入同一 content 格式；小程序负责解析、展示与点击加好友。 --- ## 会议决议 1. **内容格式**：正文使用内嵌 @ 标记，格式 `@[昵称](userId)`（或团队约定的等价格式），后端/管理端/小程序统一。 2. **小程序**：阅读页解析 content 中 @，渲染为高亮可点击；点击时调 miniprogram 添加好友接口（如 `targetUserId`），并做结果提示。 3. **管理端**：编辑页支持「插入 @用户」，保存时写入约定格式的 content。 4. **后端**：提供 miniprogram 添加好友接口；章节/文章接口返回的 content 支持带 @ 标记的字符串。 5. **待确认**：添加好友接口的最终 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`*