# bat-api Dashboard

当前稳定交付的 dashboard 静态资产位于 `web/` 根目录，并由 Go embed 挂载到
`GET /admin/dashboard/`。本目录只保留后续完整管理后台的说明入口。`GET /admin/`
仍返回 health、ready、bootstrap、release、resources、OpenAPI、dashboard 和可用
控制链接。

需要配置 `BAT_API_AUTH_TOKEN` 的接口：

- `GET /admin/diagnostics`：转发 `daemon.doctor`，读取 daemon 诊断。
- `GET /admin/logs`：转发 `daemon.logs`，按 `tail` 读取 daemon 日志尾部。
- `GET /admin/tasks`、`GET /admin/tasks/status`、`GET /admin/tasks/logs`：
  转发 `task.*` 查询任务列表、单项状态和任务日志。
- `GET /admin/schedules`：转发 Rust 持有的 schedule 查询，支持 `id`、`group`
  和 `enabled` 过滤。
- `POST /admin/control/schedule-{add,update,remove,run}`：转发
  `schedule.*` 计划控制。
- `GET /admin/parse/status`、`GET /admin/parse/text-units`、
  `GET /admin/parse/errors`：转发 `parse.*` 只读查询当前 release 的解析状态、
  TextUnit 明细和解析错误。
- `POST /admin/control/task-cancel`：转发 `task.cancel`，请求字段为 `task_id`。
- `POST /admin/control/translation-task-update`：转发
  `translation.task.update`，供外部 provider 流程或人工校对流程回写任务状态；
  当 `status=completed` 时可带 `provider`、`provider_run_id` 和
  `translation_results`。
- `POST /admin/control/translation-worker-run`：转发
  `translation.worker.run`，触发 Rust provider worker。
- `POST /admin/control/translation-proofread`：转发
  `translation.proofread`，把汉化 workflow 标记为人工校对中。
- `POST /admin/control/localized-publish`：转发 `localized.publish`，从工作台或
  completed worker 结果构建并发布汉化 release。
- `POST /admin/control/localized-rollback`：转发 `localized.rollback`，恢复
  manifest 记录的上一汉化 release。
- `GET /admin/translation/status`：转发 `localized.status`，读取当前汉化 release
  与 workflow 状态。
- `GET /admin/translation/tasks`：转发 `translation.tasks`，按分页、release、
  TextUnit、状态和失败原因过滤查询 worker 状态。
- `GET /admin/translation/handoff`：转发 `translation.handoff`，读取当前
  release 的完整翻译交接视图。

内嵌 dashboard 自身允许免 token 读取静态资产；所有写操作和 Rust 状态查询仍复用
资源 API 的 HTTP 鉴权、限流、访问日志、反代处理和动态响应 `Cache-Control: no-store`
策略。当前组件边界见 `docs/reports/GO_STATUS.md`。