feat: 增加模板版本独立预览入口

This commit is contained in:
que01 committed 2026-10-16 17:28:07 +08:00
1 parent 413413efda
commit 6edde5a8d6
15 files changed
+781 -14

No files matched your search

+14 -1
View File
@@ -2,7 +2,7 @@
> 任务 ID:TMP-PLATFORM-001
>
> 状态:实施中,Phase 0/1 已完成,Phase 2 导入基础链路已完成,目录发布与独立预览待继续推进
> 状态:实施中,Phase 0/1/2 已完成,Phase 3 已接入版本预览 API 和管理页,完整 fixture、资源诊断与隔离预览仍待验收
>
> 唯一任务入口:本文档
>
@@ -402,6 +402,19 @@ Phase 2 当前进度(2026-10-16):
退出门禁:预览不创建品牌和业务数据;不同版本、行业和资源组合不会串数据;页面失败时保留上传和选择上下文;真实 Runtime 和预览数据映射有测试。
Phase 3 当前实现(2026-10-16):
- 增加 `GET /admin/templates/:id/preview?industry=<key>`,只允许平台模板管理员;DTO 校验查询,服务读取数据库版本的 `manifestSnapshot.sampleContent`,不读取当前品牌内容,不创建品牌或业务记录。
- `imported` 和 `published` 可预览;`retired` 和其他不可用状态返回 `409`。不存在的版本、非法行业组合、Runtime/renderer/capability/sample 校验失败返回 `400`,沿用统一错误 envelope。
- 使用 `assemblePublicWorkspace` 投影演示快照,Client 和 Admin 同步接入;模板管理页按行业选择,并可查看首页、我的、业务详情和咨询等内页,失败保留选择并支持重试。
- 当前 renderer 兼容策略保守地要求部署 registry 的 package key、visual key 和版本一致;这只是第一步兼容门禁,尚未引入独立 renderer version/hash。API 不执行导入包源码,Admin 只挂载已部署 renderer。
- 当前预览为请求内存上下文,模拟 ID 使用 `template-preview:` 前缀,咨询组件使用 `preview` 模式并禁用提交;客户记录组件沿用不读取客户 API 的预览模式。
- 自动化:API 集成测试覆盖缺少/无效凭证、普通品牌管理员和 customer 拒绝、真实 atelier 包预览、行业不兼容、无 renderer、无 capability、缺 sample、撤回状态及全局业务表计数不变。浏览器交互使用真实 manifest 和同一生产投影生成 fixture,HTTP mock 仅证明页面交互,不代替 API 授权/数据库证据。
- 预览入口增加嵌套声明结构门禁;集成测试覆盖 `dataSlots`、`navigation`、`templateFields`、`trustContentTypes` 和 Admin section 的畸形输入,返回可操作的 `400` 错误。
- 本轮验证:API HTTP integration `52/52`、upload `2/2`、API unit `49/49`、Client `6/6`、Admin unit `6/6`、Playwright 预览交互 `1/1`;全仓 typecheck、Admin production build、变更范围 lint、format、`template:check` 通过。`template:doctor` 未解决项为 `0`,模板完成度仍为 `unverified`。Playwright 运行前需构建 API/config 并启动 Admin:`ADMIN_PORT=3016 pnpm --filter @personal-brand/admin dev`,随后在 `apps/taro` 运行 `pnpm exec playwright test test/browser/template-management.spec.ts`。
- 咨询按钮改动另行完成 atelier 的 `weapp` 和 `h5` 构建,参数为 `TEMPLATE_KEY=atelier-solopreneur API_BASE_URL=https://wechat.app.que01.top/api WEAPP_APP_ID=wxd75d946d6978d183 pnpm --filter @personal-brand/taro build:<weapp|h5>`;产物包含对应 AppID/API 地址并通过 masking 检查。本轮不作为微信真机视觉验收。
- 本阶段尚未完成:独立 `previewFixture` 与 bootstrap sample 的拆分、包内完整身份和媒体 fixture、按 checksum 提供导入资源、逐资源缺失诊断、画布内 CTA 导航、预览审计、短期 session/origin/CSP 隔离、跨模板/行业/版本矩阵及最终视觉验收。因此以上阶段清单仍保留未完成状态。
### Phase 4:品牌安装、bootstrap 和发布
- [ ] 区分行业安装和视觉包安装,保存精确版本与 checksum 快照;