docs(M08-D): 回填广告与装修运营

2026-08-10 12:59:22 +08:00
parent c1c02421a1
commit e0e17159a7
6 changed files with 54 additions and 7 deletions
@@ -62,3 +62,14 @@
 | POST | `/admin-api/platform-apps/bind` | 仅 `platform.manage`/平台管理员可新增逻辑应用或当前租户绑定。 |

 所有 schema 均不接受或返回 AppSecret、支付密钥和证书。
+
+## 广告与装修管理增量
+
+| 方法 | 路径 | 权限与变更 |
+|---|---|---|
+| GET/POST | `/admin-api/media/images` | 新增素材安全列表；上传继续校验图片并压缩，门店运营必须指定授权门店，只有租户/平台管理员可创建租户公共素材。 |
+| GET/POST | `/admin-api/decorations` | 新增指定门店的装修版本列表；创建继续生成不可变草稿版本并校验组件白名单。 |
+| POST | `/admin-api/decorations/:id/publish` | 发布指定门店版本并自动归档上一发布版，支持历史版本重新发布。 |
+| GET/POST/PUT | `/admin-api/advertisements[/:id]` | 新增广告更新；写入同时校验原广告范围、目标范围和图片素材范围，门店管理员只能维护授权门店广告。 |
+
+响应新增广告 `imageAssetId`，用于无损编辑既有记录；素材和装修列表上限分别为 200/100 条，均按租户和授权门店裁剪。