From f29f4bc3d6c150b634c1c356a8a0d7026fc3e20b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=B5=85=E5=BF=B5?= Date: Tue, 20 Oct 2026 16:16:58 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20site-import=20spec=20=E7=BB=88=E5=AE=A1?= =?UTF-8?q?=E4=B8=A4=E4=B8=AA=E6=96=87=E6=A1=88=20nit=EF=BC=88API=20?= =?UTF-8?q?=E6=95=B0/retry=20=E8=AF=AD=E4=B9=89=E5=BC=95=20=C2=A73.3?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Code --- docs/superpowers/specs/2026-10-20-site-import-design.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) 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 时含完整草稿包）。 草稿包结构：