From 15e7d6065e67e6d6ee4feb7165d97dc3adaface1 Mon Sep 17 00:00:00 2001 From: kdletters <61648117+kdletters@users.noreply.github.com> Date: Mon, 21 Sep 2026 16:10:55 +0800 Subject: [PATCH] =?UTF-8?q?=E8=AE=B0=E5=BD=95=E5=90=8E=E5=8F=B0=E6=A8=A1?= =?UTF-8?q?=E6=9D=BF=E4=B8=8A=E4=BC=A0=E9=87=8C=E7=A8=8B=E7=A2=91=E7=9A=84?= =?UTF-8?q?=E5=AE=9E=E7=8E=B0=E4=B8=8E=E8=AF=81=E6=8D=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 里程碑 Status 更新为 implemented-awaiting-runtime-acceptance - 补实现与证据表：路由/权限、写入前整批拒绝、批量原子性、版本一致性、CAS 与锁、保留语义、内容寻址与回读、界面用例与静态检查 - 明确仍未执行：真实 dev bucket 的批量写入 smoke（需用户确认，建议两个 smoke-import 模板验证后下架） --- .../plans/【里程碑】后台模板上传-2026-09-21.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/docs/project-memory/plans/【里程碑】后台模板上传-2026-09-21.md b/docs/project-memory/plans/【里程碑】后台模板上传-2026-09-21.md index 2c87248b8..c886a92a5 100644 --- a/docs/project-memory/plans/【里程碑】后台模板上传-2026-09-21.md +++ b/docs/project-memory/plans/【里程碑】后台模板上传-2026-09-21.md @@ -3,7 +3,7 @@ | 字段 | 值 | | --- | --- | | Version | 1.0 | -| Status | proposed（用户 2026-09-21 提出“后台再加个模板上传功能，最好支持批量上传”；边界见下，评审通过后开工） | +| Status | implemented-awaiting-runtime-acceptance（接口、页面与定向用例已交付；真实 dev bucket 写入 smoke 未执行） | | Date | 2026-09-21 | | Parent Spec | `docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md` | @@ -51,3 +51,19 @@ - 已交付的后台模板管理链路（`GET/PUT /admin/api/agc-templates`、页面、锁与内容寻址发布协议）。 - 模板库 OSS 写凭据（`GENARRATIVE_AGC_TEMPLATE_LIBRARY_OSS_ACCESS_KEY_ID/SECRET` 或成套 `ALIYUN_OSS_*`）；无凭据时导入返回 503 且页面明确不可用。 - 真实 dev bucket 的写入验证需要用户显式确认（见实施计划「验证」）。 + +## 实现与证据（2026-09-21） + +| 验收项 | 证据 | +| --- | --- | +| 1 权限与路由 | 路由契约测试覆盖 `POST /admin/api/agc-templates/import`；页签权限矩阵用例覆盖 GET / PUT / POST 三条路径（`admin::tests::agc_template_routes_require_the_template_tab_permission`） | +| 2 校验失败关闭（写入前整批拒绝） | `template_import_archive_validation_fails_closed`（缺 entry / 越界路径 / 符号链接）、`template_import_plan_rejects_unknown_and_unreferenced_fields`（未引用字段、缺 ZIP 字段、字段前缀、未知 manifest 字段、非法 zip） | +| 3 批量原子性 | `module-assets` 的 `template_import_appends_new_entries_with_metadata`（3 条口径：新 ID 入 `templates`、下架条目留在 `inactiveTemplates`、未知字段保留）；发布编排在锁内写完全部对象后才提交一次清单 | +| 4 版本一致性 | `template_import_rejects_same_version_with_different_bytes`（同句文案）、`template_import_reuses_identical_bytes_for_the_same_version`（`reused`） | +| 5 CAS 与锁 | `import_templates` 复用 `check_revision`（409）与 `TemplatePublishSession`（`commit_index` 不确定即留锁 → 503）；存储层既有用例覆盖锁与不确定写入 | +| 6 保留语义 | 领域用例断言 `enabled` 分组、`extension` 未知字段与 `metadataKey` 保持不变 | +| 7 内容寻址与回读 | `template_import_plan_uses_content_addressed_keys_and_sniffed_cover`；`put_immutable` 逐个回读校验 | +| 8 界面 | 页面用例：多选 ZIP 生成行、封面匹配齐才可提交、确认后提交 manifest 与文件、成功后刷新列表、409 刷新引导、400 展示真实原因（共 40 项 vitest 通过） | +| 9 检查 | `cargo test`（module-assets 11、platform-oss 12、api-server 定向 4）、`npm run admin-web:typecheck`、`check:encoding`、`check:doc-index`（193 份）、`cargo fmt --check`、`git diff --check` 全部通过 | + +仍未执行：真实 `agc-dev` bucket 的批量写入 smoke（需要用户显式确认；建议用两个 `smoke-import-<时间戳>` 模板验证一批多模板 + 一次清单提交，验证后下架保留历史对象）。