diff --git a/docs/superpowers/specs/2026-10-20-site-import-design.md b/docs/superpowers/specs/2026-10-20-site-import-design.md index e41c51f..d165815 100644 --- a/docs/superpowers/specs/2026-10-20-site-import-design.md +++ b/docs/superpowers/specs/2026-10-20-site-import-design.md @@ -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 时含完整草稿包)。 草稿包结构: