perf(presence): 联系人列表与在线广播 presence 批量化（Redis pipeline 单次往返）

[DeliciousBuding]

背景

#2154 探索 lane 新发现：联系人在线状态存在 Redis N+1。DB 侧 N+1 早已批量化（P2-1/P2-2 注释），但 presence 仍逐人一轮 HLEN device_route:<uid> 往返——ListContacts 每次拉联系人列表 = N 次 Redis RTT；broadcastOnlineStatus（上/下线事件扇出）同样逐好友查询。

变更

• cache.Client.AreOnline(ctx, userIDs)：把每人一条 HLEN 打包进单条 Redis pipeline（一次往返），入参去重，错误语义与逐项 IsOnline 一致（调用方忽略错误即视为离线）。
• cache.NoOpCache.AreOnline 对齐。
• contact.Cache port 扩展 AreOnline；ListContacts 循环前一次批量解析，循环内改查结果集。
• app.broadcastOnlineStatus：同样改为一次批量后再扇出。

验证

• cache.TestAreOnline：空入参/混合在线离线/去重/路由删除翻转，miniredis 实测。
• contact.TestListContacts_BatchesPresenceLookups：断言 AreOnline 恰好调用 1 次且覆盖全部好友、IsOnline 零调用，Online 标志逐人正确。
• app.TestBroadcastOnlineStatusUsesBatchedPresence：sqlmock 好友列表 + miniredis 路由 + 真实 ws.Manager 连接——在线好友收到 device.online 帧，离线好友收不到。
• go vet ./...、make test（edge+hub）全绿；5 项 verifier + git diff --check 全绿。

备注

• 已基于含 test(flake): 登记 FLK-003/004 并放宽渲染重用车道测试超时至 30s #2180 的 master rebase（前端/文档改动与本 PR Go 路径无交集）。
• 纯后端性能改动，无 API/契约变化；联系人规模上限 500（friendships 查询 LIMIT），pipeline 打包收益随好友数线性。
• [整理] 静态审计 backlog 跟踪（探索 lane 剩余项） #2154 后端性能项至此仅剩 edge SQLiteStore 全量快照（较大，需过 durability 门禁）。

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Team

Run ID: 0ee5a7ce-680e-4f1c-ab74-fb91baeefbd2

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}