docs: site-import spec 终审两个文案 nit(API 数/retry 语义引 §3.3)

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-10-20 16:16:58 +08:00
parent 13e6c06c4d
commit f29f4bc3d6
@@ -2,7 +2,7 @@
- 日期:2026-10-20
- 状态:待评审
- 范围:后端抓取/生成/任务三件套 + 3 个 API + admin 审核界面
- 范围:后端抓取/生成/任务三件套 + 2 个 API + admin 审核界面
- 前置:共享域名模式已上线(feature/shared-domain 合入 main);两次人工导入实操沉淀(租户 yotaienergys / televicsic,2026-10-20)
## 1. 背景与目标
@@ -63,7 +63,7 @@
## 4. API(2 个端点,挂 platform 认证 + 既有 `_tenant_guard`,超管+租户管理员可用;路由文件 `app/platform/routes/site_import_routes.py` 照 config_routes 组织,挂 `/api/platform/tenants` 前缀)
- `POST /api/platform/tenants/{slug}/site-import` body `{url}`(或 `{retry: "generate"}` 复用进行中任务的抓取产物)→ `{task_id}`。校验:URL 格式 http(s);目标租户非停用;无同租户进行中任务(409)。
- `POST /api/platform/tenants/{slug}/site-import` body `{url}`(或 `{retry: "generate"}`——语义见 §3.3:failed-at-generate 任务 30 分钟窗口内同 task_id 复活重跑生成步)→ `{task_id}`。校验:URL 格式 http(s);目标租户非停用;无同租户进行中任务(409)。
- `GET /api/platform/tenants/{slug}/site-import/{task_id}` → `{status, phase?, pages?, draft?, warnings?, error?}`(done 时含完整草稿包)。
草稿包结构: