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>

packages/contracts/openapi.yaml

@@ -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

packages/contracts/src/__tests__/events.test.ts

@@ -29,6 +29,7 @@ const publishedEvent: OutboxEvent<PhotoPublishedPayload> = {
   payload: {
     photoId: 'photo-1',
     albumId: 'album-1',
+    categoryId: null, // P2 Task 6：分类随载荷同步（ov 公开列表分类过滤所需）
     objectKey: 'albums/album-1/photo-1.webp',
     thumbKey: 'thumbs/album-1/photo-1.webp',
     browseKey: 'browse/album-1/photo-1.webp',

packages/contracts/src/events.ts

@@ -24,6 +24,7 @@ export interface OutboxEvent<T = unknown> {
 export interface PhotoPublishedPayload {
   photoId: string;
   albumId: string;
+  categoryId: string | null; // 分类过滤（ov 公开列表 ?category=）与单图同形所需
   objectKey: string; // 原图对象键
   thumbKey: string; // 缩略图对象键
   browseKey: string; // 浏览图对象键

packages/contracts/src/generated/openapi.d.ts

@@ -1253,8 +1253,13 @@ export interface components {
             categories: components["schemas"]["PublicCategory"][];
             /** @description 封面图签名 URL；未设置为 null。 */
             banner: components["schemas"]["SignedUrl"] | null;
-            /** @description P1a 占位 null；浏览计数由后续 /visits 端点提供（技术实施方案 §7.1）。 */
-            readonly viewCount: null;
+            /**
+             * Format: int64
+             * @description 累计浏览数。cn 部署返回 null（P1a 占位，Task 9 起由统计副本回填）；
+             *     ov 部署返回 album_stats 权威累计值（无行默认 0；计数由 /visits
+             *     端点维护，技术实施方案 §7.1）。
+             */
+            readonly viewCount: number | null;
         };
         /** @description 公开照片条目（仅 published 照片，处理完成即有宽高；URL 为短期签名，需在过期前刷新）。 */
         PublicPhoto: {
@@ -2707,6 +2712,13 @@ export interface operations {
             query?: {
                 /** @description 分类 ID 过滤（来自 PublicAlbum.categories 的 id）。 */
                 category?: string;
+                /**
+                 * @description 排序模式：latest=发布时间倒序（缺省）；hot=点赞数倒序（photoId 倒序
+                 *     决胜，短期快照语义——服务端约 30s 缓冲，窗口内顺序不随点赞变化，
+                 *     技术实施方案 §7）。hot 仅 ov 部署实现；cn 部署不感知该参数（固定
+                 *     latest 语义）。ov 部署对非法取值返回 400 VALIDATION_FAILED。
+                 */
+                sort?: "latest" | "hot";
                 /** @description 请求语言；缺省或取值不支持时按相册 defaultLocale 回退（不报 400，响应 resolvedLocale 指示实际返回语言）。 */
                 locale?: components["parameters"]["LocaleQuery"];
                 /** @description 分页游标（上一页响应的 nextCursor）。 */