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>
This commit is contained in:
@@ -1790,6 +1790,7 @@ components:
|
||||
- translations
|
||||
- createdAt
|
||||
- updatedAt
|
||||
- statsSyncedAt
|
||||
properties:
|
||||
id:
|
||||
type: string
|
||||
@@ -1858,6 +1859,14 @@ components:
|
||||
format: date-time
|
||||
readOnly: true
|
||||
description: 最近更新时间。
|
||||
statsSyncedAt:
|
||||
type: [string, 'null']
|
||||
format: date-time
|
||||
readOnly: true
|
||||
description: |
|
||||
统计副本最近同步时间(P2 A27:ov→cn 统计快照在本相册的应用时刻);
|
||||
null 表示尚无回传应用(viewCountReplica 副本位仍为初始 0)。照片级
|
||||
点赞副本(PhotoRecord.likeCount)的同步时间不经相册行表达。
|
||||
|
||||
AlbumList:
|
||||
allOf:
|
||||
|
||||
Reference in New Issue
Block a user