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:
浅念
2026-09-18 17:05:56 +08:00
parent eac8da6d6c
commit 0fcf18cc5c
26 changed files with 1355 additions and 40 deletions
+16 -2
View File
@@ -12,6 +12,9 @@
// ④ admin UI 再登录:照片管理 3 行(就绪/已发布)→ 隐藏 1 张 → viewer 重载
// 剩 2 张 → 被隐深链 404 本地化提示;
// ⑤ 空相册 B(admin API 建,无照片):viewer 空态提示「照片即将上线」。
// P2 Task 6 起 viewer 观众腿读 ov 副本(VITE_API_BASE 直连 8081)——本剧本的
// cn 侧变更(发布/隐藏/建 B 相册)在各 viewer 腿前 flushSync(bootstrap 快照 +
// 真实发送管线排空)投影到 ov;admin/staffB 腿仍走 cn 8080(代理/直连,不变)。
// 数据清理:afterAll 按 viewer helpers 同序直删(含 album_members/upload_sessions/
// photo_jobs/outbox_events 等 API 链路落库行)+ staffB 账号域行。
import { randomBytes } from 'node:crypto';
@@ -25,6 +28,7 @@ import { createStorageFromEnv, type MinioStorageAdapter } from '@photo/storage';
import { hashPassword } from '../../../services/api/src/auth/password';
import { seedAdmin } from '../../../services/api/src/scripts/seed-admin';
import { PublishService } from '../../../services/worker/src/publish.service';
import { flushSync } from './helpers';
// 仓库根 .env 唯一来源(同 helpers.ts 约定):PrismaClient/createStorageFromEnv
// 构造前先加载。API 腿直连 8080(服务端到服务端,无 CORS 面)。
@@ -92,6 +96,7 @@ test.describe.serial('cross-frontend journey (admin → api/worker → viewer)',
let adminToken: string;
let albumId: string;
let publicToken: string;
let emptyAlbumId: string;
let emptyToken: string;
let categoryId: string;
const photoIds: string[] = [];
@@ -284,7 +289,8 @@ test.describe.serial('cross-frontend journey (admin → api/worker → viewer)',
},
});
expect(emptyAlbum.status).toBe(201);
journeyAlbumIds.push(emptyAlbum.json.id as string);
emptyAlbumId = emptyAlbum.json.id as string;
journeyAlbumIds.push(emptyAlbumId);
emptyToken = emptyAlbum.json.publicToken as string;
// ── ② staffB API:登录 → init×3 → presign PUT 实写 → complete×3 ──
@@ -363,6 +369,10 @@ test.describe.serial('cross-frontend journey (admin → api/worker → viewer)',
expect(items).toHaveLength(3);
expect(new Set(items.map((p) => p.photoId))).toEqual(new Set(photoIds));
// cn→ov:发布事实经真实管线投影(album/banner/分类/3 张照片快照入 outbox
// 并排空投递)——viewer 腿读 ov 副本,此后才可见。
await flushSync(albumId);
// ── ③ viewer UI:zh 打开 → banner 渲染 → 切 en 内容随切 → 回 zh ──
await page.addInitScript(() => localStorage.setItem('viewer.locale', 'zh-CN'));
await page.goto(`/a/${publicToken}`);
@@ -446,6 +456,9 @@ test.describe.serial('cross-frontend journey (admin → api/worker → viewer)',
await page.getByRole('button', { name: '确定' }).click();
await expect(targetRow.getByTestId('photo-visibility-tag')).toHaveText('已隐藏');
// 隐藏事实同步到 ov(viewer 下一腿的重载/深链 404 断言读 ov 副本)。
await flushSync(albumId);
// ── ④ viewer:重载列表变 2 → 被隐深链 404 本地化提示 ──
await page.goto(`/a/${publicToken}`);
await expect(page.locator('.cell')).toHaveCount(2);
@@ -455,7 +468,8 @@ test.describe.serial('cross-frontend journey (admin → api/worker → viewer)',
await expect(notice).toContainText('照片不存在或已下线');
await expect(page.locator('.lightbox')).toHaveCount(0);
// ── ⑤ 空相册 B:viewer 空态提示 ──
// ── ⑤ 空相册 B:viewer 空态提示(B 经 API 建于 cn,先同步到 ov)──
await flushSync(emptyAlbumId);
await page.goto(`/a/${emptyToken}`);
await expect(page.locator('.empty-notice')).toHaveText('照片即将上线');
await expect(page.locator('.cell')).toHaveCount(0);