feat(api-watermark): 添加水印管理相关接口

2026-09-04 12:45:27 +08:00
parent 70d9d5b92a
commit c2523fe349
10 changed files with 424 additions and 7 deletions
@@ -60,6 +60,12 @@
 - `store_credential_verification` 任务仅在 Worker 内读取当前未撤销密钥、短暂解密并调用 Ozon `POST /v1/description-category/tree`（`{ "language": "ZH_HANS" }`）进行低风险验证。该请求已用真实店铺验证可用；仓库接口留待仓库同步模块按其实际请求契约接入。401 表示认证失败；403 单独提示账户/权限不匹配；其他确定性 4xx 记录脱敏 HTTP 状态并标为验证请求错误，不误报为凭据无效。临时网络、限流和 Ozon 服务端错误最多指数退避重试 5 次。
 - 验证成功回写 `active / valid`；密钥被替换或门店删除时，旧任务取消且不得覆盖新状态。前端在验证中只显示一个标签，避免与“未验证”同时出现。

+### 1.5 开发进度（2026-09-04）：水印模板 API
+
+- 已实现字体目录、按工作空间隔离的水印模板列表/详情/创建/编辑/软删除，以及店铺推荐水印绑定与解绑。文字/图片模板均创建不可变渲染版本；仅改名不新增版本，渲染参数或类型变化会新增版本。
+- 删除模板会解除所有当前店铺绑定，但不删除历史版本或图片资产。模板与店铺写操作均要求 `Idempotency-Key`；编辑要求 `If-Match`。
+- 图片模板可校验已有 `media_asset` 的归属；素材直传、图片校验和短时预览 URL 尚未实现，不能在前端自行拼接对象存储地址。
+
 ## 2. 已确认产品决策

 | 主题 | 决策 |