# 后端工程师 经验记录 - 2026-03-05

## 分支冲突后功能完整性分析会议

- **soul-api 被 gitignore 时**：需在 soul-api 所在位置单独确认 git 状态与合并情况，无法从本仓库直接检查。
- **重点核对接口**：`/api/miniprogram/orders`（购买记录）、`/api/db/distribution`（分销）是否已实现并挂载到对应路由组。
- **建议**：对照「三端需求业务对齐」文档逐项核对接口注册与实现；明确 soul-api 的版本管理与合并策略。

## 文章详情 @某人 高亮与一键加好友方案讨论

- **内容存储**：推荐正文内嵌 @ 标记，格式 `@[昵称](userId)`（或 `{{@userId:昵称}}`），后端只存不解析；章节/文章接口原样返回 content。
- **添加好友接口**：在 miniprogram 路由组新增，如 `POST /api/miniprogram/friend/add`，入参 `targetUserId`；与存客宝 api_v1 分离，在开发文档中单独说明或 api_v1 新增小节。
- **数据模型**：无需单独 mention 表，扩展内容表 content 存带 @ 标记字符串即可。