photo-live

xinyouhe/photo-live

Fork 0

Commit Graph

Author	SHA1	Message	Date
浅念	85b2da3db5	feat(ov): idempotent batched likes and realtime broadcast P2 Task 7（点赞批次端点 + ov 实时网关）： - interactions 模块（仅 ov 装配）：POST /public/albums/{token}/photos/ {photoId}/likes——相册不可见/照片未发布 404、delta 1..20 与 sessionId/batchId 1..64 校验 400；单事务 like_batches 唯一插入（P2002=幂等重试，batchAccepted=true 不重加）→ photos_ov.likeTotal/ countVersion 原子自增回读 → outbox_stat_events(kind=likes) 兜底； Redis ov（REDIS_URL_OV）INCRBY+TTL 会话/IP 双窗口限流（默认 500/2000，超限 429 RATE_LIMITED），幂等重试先于限流不耗额度 - 过期批次重放边界（24h 清理后的 batchId 重插会再次计入）：接受该边界——无永久账本可查（保留全量批次行违背清理策略），会话/IP 窗口上限即重放天然封顶（同一 sessionId 重放挤占自身额度），偏差已在 likes.service 头注释登记，Task 8 统计侧按清理后语义处理 - realtime：ContractWsAdapter（契约 {type,...} 帧分发，ws 与 HTTP 同端口挂 /v1/realtime）+ RealtimeGateway 相册房间模型——subscribe 逐相册校验 isAlbumVisibleOv，失败回 error 帧且连接保持；应用层 ping→ pong 回显 ts；传输层 HEARTBEAT_MS 周期 ping 踢死连接；点赞提交经 EventEmitter2（单进程，多实例 Redis pub/sub 登记 P5）触发 likes.burst 500ms 合并窗（delta 聚合、originBatchIds 供客户端过滤自身批次）；sync-inbox 应用事务提交后发 OV_PHOTO_APPLIED → photo.published/hidden/deleted 按房间广播（stale/duplicate/暂存/ 缺席即撤下不转发） - 契约：REALTIME_WS_PATH、ServerMessage 增 error 帧（穷尽锁 7 成员 + 类型测试）、LIKE_SESSION_WINDOW_DELTA/LIKE_IP_WINDOW_DELTA/ LIKE_BURST_MERGE_MS 常量与 .env.example - e2e（likes-realtime.e2e-spec.ts，6 用例）：A09 三批累加/幂等重试/ outbox 行、小额度 429、ping/pong+幽灵 token error 帧连接保持、 A10 双房间隔离（先证非空调订）、合并窗单 burst（delta 求和+双 originBatchIds）、cn 隐藏→房间收 photo.hidden+隐藏后点赞 404；凡进程内起 AppOvModule 的 spec（sync×2/public-ov/emergency）补装 ContractWsAdapter 与生产 main-ov 一致——api e2e 168（162+6） Co-Authored-By: Claude Code <noreply@anthropic.com>	2026-09-18 17:51:55 +08:00
浅念	eac8da6d6c	feat(ov): emergency disable channel independent of sync P2 Task 5（海外紧急停用入口）： - ov 新增 POST /v1/internal/emergency/disable\|enable（InternalSyncGuard HMAC，albumToken/albumId 恰好其一、都缺省 400；副本不存在 404 ALBUM_NOT_FOUND）：直写 albums_ov.emergencyDisabled（唯一 ov 本地可写位），独立于同步版本链——更高版本 album.updated 重放不解除（e2e 断言 entityVersion 推进而标志保持），恢复仅经显式 enable；幂等语义（alreadyDisabled/wasDisabled 入审计行） - cn 侧不感知：无对应 cn 状态位、无反向同步（契约描述文档化） - 审计：pino child（audit=emergency 字段常驻每行）结构化日志——偏差登记：计划原文「写 ov 侧日志文件」落地为字段标记而非独立文件通道（免新增文件 transport 依赖，P5 运维按字段路由聚合）；注入令牌 EMERGENCY_AUDIT_LOGGER，测试覆写为内存目的地断言字段 - isAlbumVisibleOv 共享判定（status=active && publicEnabled && !emergencyDisabled——镜像 cn 公开语义叠加本地停用位）：Task 6 公开 API / Task 7 WS subscribe 的 404 ALBUM_NOT_PUBLIC 语义单一实现，判定矩阵单测锁定 - 契约 [internal] 增 emergency disable/enable 操作与 schema（gen 已跑、 redocly 通过）；e2e：token/id 定位、幂等、enable 恢复、未签名 401、均缺省 400、未知相册 404、同步事件不解除 Co-Authored-By: Claude Code <noreply@anthropic.com>	2026-09-18 16:19:02 +08:00

Author

SHA1

Message

Date

浅念

85b2da3db5

feat(ov): idempotent batched likes and realtime broadcast

P2 Task 7（点赞批次端点 + ov 实时网关）：
- interactions 模块（仅 ov 装配）：POST /public/albums/{token}/photos/
  {photoId}/likes——相册不可见/照片未发布 404、delta 1..20 与
  sessionId/batchId 1..64 校验 400；单事务 like_batches 唯一插入
  （P2002=幂等重试，batchAccepted=true 不重加）→ photos_ov.likeTotal/
  countVersion 原子自增回读 → outbox_stat_events(kind=likes) 兜底；
  Redis ov（REDIS_URL_OV）INCRBY+TTL 会话/IP 双窗口限流（默认
  500/2000，超限 429 RATE_LIMITED），幂等重试先于限流不耗额度
- 过期批次重放边界（24h 清理后的 batchId 重插会再次计入）：接受该
  边界——无永久账本可查（保留全量批次行违背清理策略），会话/IP 窗口
  上限即重放天然封顶（同一 sessionId 重放挤占自身额度），偏差已在
  likes.service 头注释登记，Task 8 统计侧按清理后语义处理
- realtime：ContractWsAdapter（契约 {type,...} 帧分发，ws 与 HTTP 同
  端口挂 /v1/realtime）+ RealtimeGateway 相册房间模型——subscribe 逐
  相册校验 isAlbumVisibleOv，失败回 error 帧且连接保持；应用层 ping→
  pong 回显 ts；传输层 HEARTBEAT_MS 周期 ping 踢死连接；点赞提交经
  EventEmitter2（单进程，多实例 Redis pub/sub 登记 P5）触发
  likes.burst 500ms 合并窗（delta 聚合、originBatchIds 供客户端过滤
  自身批次）；sync-inbox 应用事务提交后发 OV_PHOTO_APPLIED →
  photo.published/hidden/deleted 按房间广播（stale/duplicate/暂存/
  缺席即撤下不转发）
- 契约：REALTIME_WS_PATH、ServerMessage 增 error 帧（穷尽锁 7 成员
  + 类型测试）、LIKE_SESSION_WINDOW_DELTA/LIKE_IP_WINDOW_DELTA/
  LIKE_BURST_MERGE_MS 常量与 .env.example
- e2e（likes-realtime.e2e-spec.ts，6 用例）：A09 三批累加/幂等重试/
  outbox 行、小额度 429、ping/pong+幽灵 token error 帧连接保持、
  A10 双房间隔离（先证非空调订）、合并窗单 burst（delta 求和+双
  originBatchIds）、cn 隐藏→房间收 photo.hidden+隐藏后点赞 404；
  凡进程内起 AppOvModule 的 spec（sync×2/public-ov/emergency）补装
  ContractWsAdapter 与生产 main-ov 一致——api e2e 168（162+6）

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-09-18 17:51:55 +08:00

浅念

eac8da6d6c

feat(ov): emergency disable channel independent of sync

P2 Task 5（海外紧急停用入口）：
- ov 新增 POST /v1/internal/emergency/disable|enable（InternalSyncGuard
  HMAC，albumToken/albumId 恰好其一、都缺省 400；副本不存在 404
  ALBUM_NOT_FOUND）：直写 albums_ov.emergencyDisabled（唯一 ov 本地可写
  位），独立于同步版本链——更高版本 album.updated 重放不解除（e2e 断言
  entityVersion 推进而标志保持），恢复仅经显式 enable；幂等语义
  （alreadyDisabled/wasDisabled 入审计行）
- cn 侧不感知：无对应 cn 状态位、无反向同步（契约描述文档化）
- 审计：pino child（audit=emergency 字段常驻每行）结构化日志——偏差
  登记：计划原文「写 ov 侧日志文件」落地为字段标记而非独立文件通道
  （免新增文件 transport 依赖，P5 运维按字段路由聚合）；注入令牌
  EMERGENCY_AUDIT_LOGGER，测试覆写为内存目的地断言字段
- isAlbumVisibleOv 共享判定（status=active && publicEnabled &&
  !emergencyDisabled——镜像 cn 公开语义叠加本地停用位）：Task 6 公开
  API / Task 7 WS subscribe 的 404 ALBUM_NOT_PUBLIC 语义单一实现，
  判定矩阵单测锁定
- 契约 [internal] 增 emergency disable/enable 操作与 schema（gen 已跑、
  redocly 通过）；e2e：token/id 定位、幂等、enable 恢复、未签名 401、
  均缺省 400、未知相册 404、同步事件不解除

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-09-18 16:19:02 +08:00

2 Commits