From a55afb67eb65d59803990015ac8634af786cd4e2 Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Thu, 27 Aug 2026 09:56:25 +0800
Subject: [PATCH] docs: document Admin generation media access (#72)

---
 Deployment-and-Operations.-.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/Deployment-and-Operations.-.md b/Deployment-and-Operations.-.md
index 77185fa..ca4245d 100644
--- a/Deployment-and-Operations.-.md
+++ b/Deployment-and-Operations.-.md
@@ -219,3 +219,20 @@ D:\supervisor\supervisord.exe ctl /c D:\supervisor\supervisord.conf status
 - 队列延后使用 `generations.available_at`，部署 #44 前必须已经完成迁移 `000006`。
 - 监控应区分本地 `local_rate_limit` 延后事件与真实 Provider 429；本地限流不得计入 Provider 失败率、熔断或真实 attempt。
 - 发布验证使用 mock Provider 检查：用户/API Key 429 与 `Retry-After`、Provider 限流不触发上游、全部候选受限后可在 `available_at` 到期重新认领。不得用真实 Provider 额度反复验证。
+
+<!-- issue-72-admin-media-deployment:start -->
+## Admin 生成媒体配置（#72）
+
+Admin API 需要对 Portal 使用的同一生成物目录拥有只读权限：
+
+```yaml
+settings:
+  extend:
+    chorus:
+      storage_root: ../var/storage
+```
+
+`storage_root` 按 Admin API 进程的工作目录解析。Supervisor 本机实例从 `admin/` 启动，因此项目内默认目录写为 `../var/storage`；也可以配置绝对路径。目录必须已经存在，Admin 启动不会创建或写入该目录。
+
+部署顺序：备份并确认数据库版本与 dirty 状态，执行 migration 10，安装新的 Admin API 与 Admin UI 制品，再重启 `chorus-admin-api` 和 `chorus-admin-ui`。migration 10 只登记四个 GET API、菜单关联和 `chorus_operator` Casbin 权限，不修改生成记录或媒体对象。回退时先回退 UI/API 制品，再执行 migration 10 down。
+<!-- issue-72-admin-media-deployment:end -->