浅念
2bb6f291d3
P4a Task 4（T12 收口）：ov 域公开照片下载端点 + viewer 下载 UI。
- interactions 增 downloads：GET /public/albums/{token}/photos/{photoId}
/download?variant=browse|original。两级开关（A18）：browse 需
downloadEnabled；original 需叠加 originalDownloadEnabled（级联，browse 关
则两者均 403 DOWNLOAD_DISABLED）。水印相册 browse 现签 watermark pattern
key（browse-key 解析抽取 shared/ov-browse-key 与 public-ov 复用）；原图
现签 originalObjectKey（SIGNED_URL_TTL）。来源 IP 固定窗限速
（DOWNLOAD_WINDOW_REQUESTS/DOWNLOAD_WINDOW_SECONDS，env 可调）；零浏览
计数写入（排除规则）。STORAGE_PORT_OV 经新 StorageOvModule 与 public-ov
共享同一实例。
- 契约微调登记：PublicAlbum 增 readOnly 必返 downloadEnabled/
originalDownloadEnabled（cn+ov 同形返回；public e2e 精确键断言同步）。
- viewer：lightbox 下载入口随开关渲染（无/单按钮/分体菜单两选项）、过期
凭证静默重取一次、微信内置浏览器（MicroMessenger UA）出保存图片指引
浮层（复制深链 + 反馈）替代直接下载；i18n zh/en 词条。
- tests：api e2e +7（开关矩阵 + URL/字节级断言、水印键一致、隐藏 404、
限速 429、零计数行）；viewer vitest +9（UA/矩阵/菜单/重取/失败/指引/
复制）；viewer Playwright +3（入口矩阵、微信 UA 浮层、真实端点 200 +
签名 URL 模式）。
Co-Authored-By: Claude Code <noreply@anthropic.com>
53 lines
1.7 KiB
TypeScript
53 lines
1.7 KiB
TypeScript
import type { PublicAlbum } from '../api/client';
|
|
|
|
// 组件测试共享夹具：公开相册响应的最小完整形状（对齐契约 PublicAlbum 必返字段）。
|
|
// vi.mock 工厂需在各 spec 文件内联（hoisting 限制），此处只承载数据构造。
|
|
export function makeAlbum(
|
|
overrides: Partial<PublicAlbum> & { translation?: Partial<PublicAlbum['translation']> } = {},
|
|
): PublicAlbum {
|
|
const { translation, ...rest } = overrides;
|
|
return {
|
|
publicToken: 'tokfixture0000000000aaaa',
|
|
resolvedLocale: 'zh-CN',
|
|
defaultLocale: 'zh-CN',
|
|
timezone: 'Asia/Shanghai',
|
|
startAt: '2026-10-01T02:00:00.000Z',
|
|
endAt: '2026-10-01T12:00:00.000Z',
|
|
translation: {
|
|
locale: 'zh-CN',
|
|
title: '2026 公司年会',
|
|
description: '年度盛会\n多行介绍',
|
|
venue: '大宴会厅',
|
|
address: '上海市浦东新区世纪大道 100 号',
|
|
...translation,
|
|
},
|
|
categories: [
|
|
{ id: 'cat-sign', name: '签到墙', sortOrder: 0 },
|
|
{ id: 'cat-open', name: '开场', sortOrder: 1 },
|
|
],
|
|
banner: null,
|
|
viewCount: null,
|
|
// P4a Task 4：下载两级开关（契约 PublicAlbum 必返字段；缺省 on/off）。
|
|
downloadEnabled: true,
|
|
originalDownloadEnabled: false,
|
|
...rest,
|
|
};
|
|
}
|
|
|
|
export function makeEnAlbum(): PublicAlbum {
|
|
return makeAlbum({
|
|
resolvedLocale: 'en',
|
|
translation: {
|
|
locale: 'en',
|
|
title: 'Annual Party 2026',
|
|
description: 'Yearly gala',
|
|
venue: 'Grand Ballroom',
|
|
address: '100 Century Ave, Pudong, Shanghai',
|
|
},
|
|
categories: [
|
|
{ id: 'cat-sign', name: 'Check-in Wall', sortOrder: 0 },
|
|
{ id: 'cat-open', name: 'Opening', sortOrder: 1 },
|
|
],
|
|
});
|
|
}
|