feat(storage): 广告对象键布局（staging + 版本化终键）

adsStagingObjectKey（两步上传 presignPut 直传位）+ adObjectKey
（版本段=entityVersion：换图必然 bump 版本→新键，copyIfAbsent
禁止覆盖语义下天然防重复/防串图）；index.ts 按名再导出供 Task 6/7
ads.service 消费。设计方案 §2.1/§3 终键布局同步回填（偏差登记）。

Co-Authored-By: Claude Code <noreply@anthropic.com>

docs/plans/2026-09-28-广告位轮播-设计方案.md

@@ -38,7 +38,7 @@
 model ads {
   id             String   @id @default(cuid())
   title          String?  @db.VarChar(120)  // 后台备注名，不展示观众
-  imageObjectKey String   @db.VarChar(512)  // OSS 终键 photo-live/{env}/ads/{adId}.{ext}
+  imageObjectKey String   @db.VarChar(512)  // OSS 终键 photo-live/{env}/ads/{adId}/v{version}.{ext}（版本段：copyIfAbsent 禁止覆盖，换图新键——实施计划 Task 4 偏差登记）
   linkUrl        String   @db.VarChar(2048) // 仅 http/https（服务端校验）
   enabled        Boolean  @default(true)
   sortOrder      Int      @default(0)       // 升序；并列按 createdAt 升序
@@ -83,7 +83,7 @@ model ads_ov {
 3. `POST /v1/admin/ads` / `PATCH /v1/admin/ads/{id}` 携带 `imageStagingKey`：
    服务端同事务内 `head()` 核验（存在 + bytes + contentType 与申明一致，banner
    complete 同口径）→ `copyIfAbsent()` 到终键
-   `ads/{adId}.{ext}`（禁止覆盖语义天然防重复）→ 落库 + 写 outbox。
+   `ads/{adId}/v{version}.{ext}`（禁止覆盖语义天然防重复）→ 落库 + 写 outbox。
    编辑换图：新终键生效，旧终键对象不回收（OSS 生命周期兜底，与 banner 流同款）。
 
 - StoragePort 现有 presignPut/head/copyIfAbsent 全复用，零新增存储能力。

packages/storage/src/index.ts

@@ -13,6 +13,8 @@ export {
   OBJECT_KEY_ROOT,
   variantsObjectKey,
   watermarkVariantObjectKey,
+  adsStagingObjectKey,
+  adObjectKey,
 } from './keys';
 export type { PhotoVariantName } from './keys';
 

packages/storage/src/keys.ts

@@ -33,3 +33,14 @@ export function watermarkVariantObjectKey(
 ): string {
   return variantsObjectKey(albumId, photoId, configVersion, 'watermark');
 }
+
+/** 广告图 staging 键（两步上传第一步：presignPut 直传位）。 */
+export function adsStagingObjectKey(cuid: string, ext: string): string {
+  return `${OBJECT_KEY_ROOT}/ads/staging/${cuid}.${ext}`;
+}
+
+/** 广告图终键（版本段=entityVersion：换图必然 bump 版本 → 新键，
+ * copyIfAbsent 禁止覆盖语义下天然防重复/防串图）。 */
+export function adObjectKey(adId: string, version: number, ext: string): string {
+  return `${OBJECT_KEY_ROOT}/ads/${adId}/v${version}.${ext}`;
+}