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>
This commit is contained in:
浅念
2026-09-28 23:01:09 +08:00
parent 318f69dae7
commit 539597e9f0
3 changed files with 15 additions and 2 deletions
@@ -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 全复用,零新增存储能力。