feat: 增加模板预览短期隔离上下文

This commit is contained in:
que01 committed 2026-10-16 19:46:38 +08:00
1 parent b60174885e
commit d38dbe02aa
8 files changed
+190 -22

No files matched your search

+10 -2
View File
@@ -2,7 +2,7 @@
> 任务 ID:TMP-PLATFORM-001
>
> 状态:实施中,Phase 0/1/2 已完成,Phase 3 已接入版本预览、独立 fixture 和包内图片校验,隔离上下文与完整矩阵仍待验收
> 状态:实施中,Phase 0/1/2 已完成,Phase 3 已接入版本预览、独立 fixture、包内图片校验和短期隔离 session;origin/CSP、CTA 导航、完整矩阵与最终视觉验收待完成
>
> 唯一任务入口:本文档
>
@@ -393,7 +393,7 @@ Phase 2 当前进度(2026-10-16):
### Phase 3:独立预览和模板管理页面
- [ ] 增加 preview session 或同等短期隔离上下文;
- [x] 增加 preview session 或同等短期隔离上下文;
- [ ] 按行业选择兼容组合,使用 preview fixture 通过真实 Runtime projection 渲染;
- [ ] 页面展示模块顺序、字段来源、资源缺失、能力依赖和诊断;
- [ ] 预览禁止真实咨询、客户记录、品牌发布和上传;
@@ -427,6 +427,14 @@ Phase 3 独立 fixture 与资源进展(2026-10-16):
- 自动化新增独立 fixture 与 bootstrap 解耦、无效安全策略导入拒绝、敏感身份字段拒绝、兼容来源标识、archive 漂移阻断及图片类型/体积/摘要故障回归。API HTTP integration `52/52`、upload `2/2`、API unit `51/51`、Client/Admin unit 各 `6/6`、真实包图片浏览器交互 `1/1` 通过;typecheck、Admin production build、变更范围 lint 和 `template:check` 通过。
- 仍待推进:预览上下文与 origin/CSP 隔离、画布内 CTA 导航、跨模板/行业/版本完整矩阵和最终视觉验收。前述初版实现记录中的 fixture 与包内资源缺口由本段更新,其余阶段门禁不变。
Phase 3 短期隔离 session 进展(2026-10-16):
- 预览响应新增 `preview.session`;首次预览生成 64 位十六进制短期 token,有效期 15 分钟。`GET /admin/templates/:id/preview` 支持 `session` 查询参数,DTO 仅接受预期格式。
- 服务端 session 只在 API 进程内存中保存已构建投影,上限 20 个并主动清理过期项;每次复用必须匹配同一平台模板管理员、版本 ID 和行业。因此 token 不是跨管理员可重放凭据,不同版本/行业/管理员不会串数据。
- 带 session 的成功复用不重复读取 archive,也不重复写 `previewed` 审计;不存在、过期或绑定不匹配返回可操作的 `400`,管理员可重新创建预览。
- Admin 预览按版本和行业保留短期 token 供失败重试复用;请求失败时删除对应 token,行业/版本选择和业务记录选择仍保留。
- 自动化覆盖 session 成功复用、复用不新增审计、跨管理员拒绝、未知 token 拒绝、版本/行业绑定、shared client URL 和 Admin 重试上下文。本轮 API HTTP integration `52/52`、upload `2/2`、Client `6/6`、Admin unit `3/3` 和全仓 typecheck 通过;origin/CSP 隔离与最终矩阵验收仍待完成。
### Phase 4:品牌安装、bootstrap 和发布
- [ ] 区分行业安装和视觉包安装,保存精确版本与 checksum 快照;