feat(ov,viewer): two-tier download with wechat guidance
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>
This commit is contained in:
@@ -455,12 +455,14 @@ describe('public (e2e)', () => {
|
||||
expect(res.body.endAt).toBe('2026-10-01T12:00:00.000Z');
|
||||
expect(Number.isNaN(Date.parse(res.body.startAt))).toBe(false);
|
||||
expect(Number.isNaN(Date.parse(res.body.endAt))).toBe(false);
|
||||
// 契约 PublicAlbum 必返字段全集(形状精确断言)。
|
||||
// 契约 PublicAlbum 必返字段全集(形状精确断言;P4a Task 4 增下载开关)。
|
||||
expect(Object.keys(res.body).sort()).toEqual([
|
||||
'banner',
|
||||
'categories',
|
||||
'defaultLocale',
|
||||
'downloadEnabled',
|
||||
'endAt',
|
||||
'originalDownloadEnabled',
|
||||
'publicToken',
|
||||
'resolvedLocale',
|
||||
'startAt',
|
||||
|
||||
Reference in New Issue
Block a user