# 笔记、互动计数与搜索源码

前一站：[认证](auth.md) · 接着读：[评论与关系](comments-relations.md)

## SaveNote：把保存分成可检查的阶段

1. require 检查身份，清理标题/正文两端空格。
2. 检查 type、长度、图片数量、topicId 和媒体 URL。
3. 图文至少有1张图片，视频必须有 videoUri；数组 nil 规范成 `[]`，序列化 JSON。
4. 新建时数据库分配 id；更新时 WHERE 同时限定 id、creator_id、deleted=0。
5. 更新影响零行返回403，不能“什么也没改却显示保存成功”。
6. 读取真实 Note 作为返回值，前端使用真实作者/ID进入详情。

源码在 [notes.go](../../internal/service/notes.go)。这里没有先把正文写到另一个服务的分布式事务：标题、正文、图片列表一次 SQL 写入，因此这些字段不会产生跨存储半成功状态。

## 读取规则集中表达

noteReadable 要求笔记未删、作者正常、公开或当前作者。Note、SearchNotes、Published、ReadableNoteID 使用相同条件；评论读取再调用 ReadableNoteID。不能只在首页隐藏私密，却让详情或评论按 ID 读取。

noteSelect 连接作者当前昵称/头像，计算赞/藏/评论数和当前人是否有关系。计数字符串保留前端契约，isLiked/isCollected 是布尔值。计数过滤停用或删除用户，评论还过滤已删除根讨论。正文直接作为字符串，不生成 HTML。

## 点赞为什么无需读出数字再写回

ReactNote 插入唯一关系行，已经存在则忽略；取消删除关系。读取时 COUNT 对象，避免“并发读到5，各自改为6”丢失更新，也不需要 `max(0,count-1)` 修补负数。客户端用 desired-state 的 like/unlike，而不是没有上下文的 toggle，所以网络重试不会翻转回去。

如果将来为性能加冗余 count 列，必须设计“新增关系成功才加计数”的同事务规则与重算检查；不能无条件计数加一又保留唯一行忽略。

## 搜索输入与 SQL

SearchNotes 将关键词作为参数，用 escapeLike 处理 `%`、`_` 和反斜线，LIKE 匹配标题或正文。排序由有限枚举选择预写的 SQL，不允许把用户传来的列名/方向直接拼进查询。时间范围换算成 UTC 时间阈值。type 可省略，用 `*int` 区分“0图文”和“未传不限”。

发现推荐和最新共用此方法。关注信息流追加 EXISTS follows 条件并要求登录。搜索没有独立索引副本，刚改私密后新查询立即遵守规则；它也没有中文分词、拼音纠错、ES 相关性与高亮。

## 两种分页

搜索、评论、关系列表使用 pageNo + OFFSET：容易理解、可显示总页数，但数据量大时深分页成本高，新增内容可能让分页位置变化。个人笔记使用 id 游标，每次多读一条判断 nextCursor；客户端最多取20条，把第20条ID作为下一次的“小于此ID”。

置顶在当前已加载个人列表排序，游标仍严格按 ID。这是为避免按 is_top + id 排序后游标只有 id 产生漏读；若产品要求任意年代置顶总是第一屏，需要单独查置顶集合并设计复合游标，而不是改一个 ORDER BY 就结束。

## 读测试

BusinessLifecycle 检查别人不能更新、私密后详情和评论拒绝、根评论删除后回复不可点赞。FollowingSearchPagination 验证真实关注列表、旧地址别名、23篇分页、LIKE 百分号字面匹配。ConcurrentLike 证明并发唯一和重新连接后的持久结果。

练习：为“按收藏数排序”准备两篇不同收藏数的笔记，验证顺序，而不是断言源码里出现 `ORDER BY`。
