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>
This commit is contained in:
@@ -1055,6 +1055,17 @@ paths:
|
||||
description: 分类 ID 过滤(来自 PublicAlbum.categories 的 id)。
|
||||
schema:
|
||||
type: string
|
||||
- name: sort
|
||||
in: query
|
||||
description: |
|
||||
排序模式:latest=发布时间倒序(缺省);hot=点赞数倒序(photoId 倒序
|
||||
决胜,短期快照语义——服务端约 30s 缓冲,窗口内顺序不随点赞变化,
|
||||
技术实施方案 §7)。hot 仅 ov 部署实现;cn 部署不感知该参数(固定
|
||||
latest 语义)。ov 部署对非法取值返回 400 VALIDATION_FAILED。
|
||||
schema:
|
||||
type: string
|
||||
enum: [latest, hot]
|
||||
default: latest
|
||||
- $ref: '#/components/parameters/LocaleQuery'
|
||||
- $ref: '#/components/parameters/CursorQuery'
|
||||
- name: limit
|
||||
@@ -2509,9 +2520,14 @@ components:
|
||||
- $ref: '#/components/schemas/SignedUrl'
|
||||
- type: 'null'
|
||||
viewCount:
|
||||
type: 'null'
|
||||
type: [integer, 'null']
|
||||
format: int64
|
||||
minimum: 0
|
||||
readOnly: true
|
||||
description: P1a 占位 null;浏览计数由后续 /visits 端点提供(技术实施方案 §7.1)。
|
||||
description: |
|
||||
累计浏览数。cn 部署返回 null(P1a 占位,Task 9 起由统计副本回填);
|
||||
ov 部署返回 album_stats 权威累计值(无行默认 0;计数由 /visits
|
||||
端点维护,技术实施方案 §7.1)。
|
||||
|
||||
PublicPhoto:
|
||||
type: object
|
||||
|
||||
Reference in New Issue
Block a user