xinyouhe/photo-live
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
325 Commits 1 Branch 0 Tags
main
Commit Graph

10 Commits

Author SHA1 Message Date
浅念 9ec8226577 fix(sync): reconciler 清扫环补 ad——错过的 ad.* 推送恢复自愈通道 
SWEEP_ENTITY_TYPES 追加 'ad'：生产对账循环阶段一逐类拉 cn reconcile
清单时纳入广告当前态（清单恒全量、确定性排序），重放走既有
content-batches 幂等管道。此前 ad 只有 cn 端点而无调用方——ad.* outbox
事件「投后即失」时 ads_ov 无自愈路径（digest 是相册维度计数，覆盖不了
无相册归属的广告；含 enabled=false 下线与硬删墓碑后的终态收敛）。

sweep() 对各类型均一处理（无 per-type 簿记），'ad' 与 'asset' 同构接入；
文件头/Stats 注释同步（四类→五类）。

测试：reconcile.e2e ⑤ 追加 runOnce 生产环断言——sweptEvents=5
（album+photo×2+ad×2）、replayApplied=2（仅 ad 新 eventId）、
ads_ov 两行投影就位（全局 albumIds NULL/定向数组）、digest 稳态不受
影响。sync 全量 e2e 4 suites/28 tests、api ads 16/16、typecheck/lint 净。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-29 00:26:21 +08:00
浅念 60b675a908 feat(sync): 对账清单 ad 实体当前态清扫 
Task 8（ads-carousel）：cn reconcile 增 entityType='ad' 分支——纯 SELECT
当前态映射（sortOrder/createdAt 确定性排序，albumId 恒空串信封约定），
载荷复用 ads/ad-payload.ts 单一出处（与业务事务内即时事件逐字节同形，
纯函数模块无依赖环）；DTO SYNC_ENTITY_TYPES 追加 'ad'（对齐契约 enum）。

随附质量审查两项：
- ads.service list() 行→AdminAdItem 映射复用 toItem（删 ~14 行内联重复，
  ⑮ 补 admin list 200 形状断言覆盖重构路径）；
- 新增 test/ads-extensions.spec.ts 守护 AD_IMAGE_EXTENSIONS ===
  UPLOAD_CONTENT_TYPES 派生归一扩展名集合（jpeg→jpg），防三处白名单漂移。

测试基建：reset.ts RESET_TABLES 补 'ads'（Task 6 建表遗漏，固定 id 直种
依赖跨 spec 清场）；reconcile.e2e-spec 追加 ⑤（红→绿，5/5）。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-29 00:22:13 +08:00
浅念 4db90b0e9e feat(sync): ov inbox ad 分支与 sender adId 推导（disabled/墓碑=删投影行） 
- dto.ts SYNC_ENTITY_TYPES 追加 'ad'（对齐契约 SyncEntityType）。
- decideAndApply ③依赖检查豁免 ad：albumId 恒空串，不豁免则事件被永久
  暂存且无解锁路径（slot-state 同款空 albumId 危害）。
- project() 新增 ad 分支：全量快照直投 ads_ov；墓碑或 enabled=false 均
  deleteMany（disabled=公开不可见=无投影）；albumIds 整体替换；createdAt
  取 cn 原值、updatedAt 为 ov 应用时刻（载荷无该字段）。
- sender.toWireEvent 新增 ad 分支：entityId 取载荷 adId（outbox 表无列），
  泛化 categoryId/assetId 兜底之前，缺料 fail-fast。
- e2e ads.e2e-spec：手工构造 outbox 行（绕过 CRUD，Task 7 才有）走真实
  sender→HTTP→inbox 链路，5 用例覆盖快照落位/disable 删行/复活 upsert/
  迟到旧版本不回滚/墓碑删行；reset-ov 增清 ads_ov。
- db-ov schema 附带注释修：ads_ov updatedAt 语义纠正（迁移头过度声明，
  迁移文件不动防 checksum 漂移）+ sync_inbox.entityType 枚举补 ad。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-28 23:18:37 +08:00
浅念 aee4b7ac46 feat(api): embed slots with ov replica and public feed 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-20 22:22:19 +08:00
浅念 452ec12bbd test(sync): cross-region simulation integration suite 
P2 Task 11: 六幕串行场景套件（cn+ov 双入口进程内起真服务，真实双
MySQL/MinIO/HMAC/WS）——①端到端复制+互动+统计回传（A25 观众路径只打
ov、A27 快照替换）②隐藏传播（high 优先+WS photo.hidden+恢复发布复原）
③发送器停机积压→排空追平→对账稳态④墓碑不复活（旧 published 重放拒绝
+bootstrap 重跑仍隐藏，A26）⑤紧急停用（ov 404/WS error、cn 无感、enable
复原含新照片）⑥50 并发点赞/30 并发浏览幂等小样（终值==Σdelta、恰+15）。

services/sync devDeps 增 ws/@types/ws/ioredis（WS 场景客户端 + 限速
滑窗键清场，同 api spec 约定；版本与 api 对齐）。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-18 20:05:25 +08:00
浅念 955bea49b5 feat(sync): stat snapshot return path with version replacement 
P2 Task 9 统计回传（ov→cn）：
- cn 迁移：albums 增 viewCountReplica/statsVersion/statsSyncedAt、
  photos 增 statsVersion（like_count 已有副本位；无 VARCHAR 新列不涉校对手决）
- cn 接收端 POST /v1/internal/sync/stat-snapshots（InternalSyncGuard）：
  整批单事务，逐快照 updateMany WHERE statsVersion < statVersion —— 仅更高
  statVersion 以权威 total 整体替换副本（绝不相加），重复/乱序幂等忽略；
  accepted 只数实际应用条数；views 应用同时推进 statsSyncedAt（A27 展示）
- ov 回传发送器 services/sync/stat-return.ts：聚合 outbox_stat_events 未发送
  行按（kind, photoId|albumId）取 MAX(statVersion) 折叠突发 → HMAC 推送 →
  200 后按计数器标记截至该版本全部源行 sentAt；失败留待下轮重发；main.ts
  第三循环 STAT_RETURN_INTERVAL_MS（默认 60s，env 可调）
- 契约 AlbumSummary + statsSyncedAt（string|null readOnly，+gen）；listAlbums/
  getAlbum 经 toSummaryResponse 暴露（管理 UI 列留 P4a）
- e2e（services/sync stat-return.e2e-spec，7 例）：逐次点赞回传替换式收敛
  （2→5→10 非累加）、浏览窗口去重回传 + statsSyncedAt、重复回传 accepted=0
  值不动（A27 不重复累计）、乱序高版本替换（total 可下调）+ 低版本忽略、
  发送端折叠只发最高版本且被折叠行随批确认、管理列表 likeCount/statsSyncedAt
  展示、新端点 401/400 守卫

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-18 18:45:43 +08:00
浅念 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
浅念 0fcf18cc5c feat(ov): public read api on replicas with hot sorting 
P2 Task 6（ov 公开读 API + viewer 切换）：
- ov 装配 PublicOvModule（仅 app-ov.module）：/public/albums/{token}、
  /photos、/photos/{id} 三端点同契约读 ov 副本——translations/categories
  自 JSON 列解析（防御性过滤），banner 经 ov 侧 STORAGE_PORT_OV 预签名
  （同本地 MinIO；只读属约定，真实 OSS 只读凭证 P5），viewCount 取
  album_stats 权威累计（无行默认 0；计数端点 Task 8 接线）
- 排序：latest=发布时间 keyset（shared/cursor.ts 同 cn）；hot=likeTotal
  desc + photoId desc 决胜，顺序按 `${albumId}|${category}` 短期快照
  （内存 TTL 默认 30s，HOT_SORT_TTL_MS 惰性读取）——计数逐请求现读、
  顺序冻结窗口内一致，偏移游标（base64url 整数）在快照内严格稳定；
  非法 sort 400 VALIDATION_FAILED（cn 不感知该参数）
- 契约：viewCount 放宽为 integer|null（cn null、ov 权威值）；
  listPublicPhotos 增 sort 枚举（latest|hot，缺省 latest）；
  PhotoPublishedPayload 增 categoryId——补上 Tasks 3/4 管线缺口
  （payloads/publish.service/sync-inbox 投影 + 关联测试随改）
- e2e（services/api/test/public-ov.e2e-spec.ts，7 用例）：双入口同进程
  起 cn+ov，cn API 种子→真实发送管线投递；断言相册/列表/单图与 cn
  深等（仅签名 URL 剔除）、banner 真字节、参数矩阵 400/404、hot 排序
  TTL 内快照（计数新/顺序旧）+TTL 过期翻转+偏移翻页、隐藏/下线/紧急
  停用逐态撤下
- viewer 切 ov：API 基址 VITE_API_BASE（缺省 http://127.0.0.1:8081，
  空串=同源网关；Vite 只读 apps/viewer/.env*，根 .env 对前端无效），
  移除 /v1 dev 代理（CORS_ORIGINS 增 127.0.0.1:5175 直连两形）；
  playwright webServer 增 dev:ov；e2e 夹具 flushSync(albumId)=cn
  bootstrap 快照 + deliverPendingOnce（sender 新导出）经真实管线投影
  种子，deleteSeededPhoto 改软删让墓碑可同步；14 个 Playwright 全绿
  （journey 管理/staffB 腿仍走 cn 8080）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-18 17:05:56 +08:00
浅念 36082c5a74 feat(sync): reconciliation scheduler with digest and bootstrap healing 
P2 Task 4（inbox 对账）：
- services/sync 新增 SyncReconciler（runOnce 可测；main 双循环，间隔
  SYNC_RECONCILE_INTERVAL_MS env 可调，CN_API_URL 指向 cn 入口）：每轮
  先按 album/category/photo/asset 逐类分页拉取 cn reconcile「当前状态
  事件」并直接签名推送到既有 content-batches 管道。sinceVersion 取 0
  （全量当前态）而非 per-type 已应用最大版本——cn reconcile 以类型级
  全局版本阈值过滤，类型内单实体滞后会被 max 掩蔽；ov 的 eventId 幂等
  + 版本单调把已追平实体全部判重（recon 确定性 eventId 重扫零成本），
  偏差登记：计划原文对账返回「缺失清单」，契约已定为可重放 SyncEvent
  数组（免建第二条拉取通道），openapi 描述同步更新
- cn 新增 POST /internal/sync/digest：每相册权威计数 {categoryCount,
  publishedPhotoCount, photoCount, assetCount}；ov 比对副本计数（照片
  取 [publishedPhotoCount, photoCount] 区间口径——hidden/deleted 照片
  若从未以 published 态同步过 ov 合法无行，缺席即撤下），不一致相册
  自动触发 cn bootstrap 重建；ov-only 相册（cn 行已删，bootstrap 无法
  表达删除）告警登记不自动处置
- 收敛语义两处落位：① sync-inbox 版本比较改「严格更旧才拒绝」——
  同版本新 eventId（bootstrap/reconcile 快照重发）为当前态幂等重断言
  应用，修复 ov 缺失副本行；A26 不受影响（更旧版本仍拒绝，cn 侧
  entityVersion 与状态一一对应）② album.updated 快照载荷（bootstrap/
  reconcile）携带分类全量清单，ov 存在即整体替换 albums_ov.categories
  ——修复错过的 category 墓碑（Task 3 登记边界：cn 行已删，无现存实体
  事件可重放，唯全量替换可收敛）
- e2e（reconcile.e2e-spec）：漏事件追赶（ov v1/cn v5 事件投后即失）→
  清扫追平；digest 修复缺失 photos_ov 行（bootstrap 重发 → 同版本
  重断言重建）；digest 修复丢失的分类墓碑（全量清单替换收敛）；稳态
  空转（applied=0、无 bootstrap）；Task 3 套件保持绿

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-18 16:18:31 +08:00
浅念 65726702f3 feat(sync): cn event coverage, bootstrap and outbox sender 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-18 15:21:41 +08:00