Files
persionalBrand/docs/template-runtime-progress.md
T

79 lines
5.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 模板运行时实施进度
关联决策:`docs/adr/0005-template-runtime-and-stitch-pipeline.md`
## 当前分支
`feat/template-runtime-platform`
## 阶段状态
### Phase 0:冻结林境门作基线
- [x] 静态小程序提交基线版本 `8489c8c`。
- [ ] 固定各页面测试 fixture 和截图基准。
- [ ] 清理远程图片依赖或建立本地资源清单。
### Phase 1:Runtime Workspace
- [x] 新增共享 `TemplateManifest`、`ModuleManifest`、`CapabilityManifest` 类型。
- [x] 新增 `RuntimeWorkspace`、Offering、Inquiry 和 Capability 运行时类型。
- [x] 新增模板声明的基础校验函数。
- [x] 在 API 增加运行时工作空间公开接口字段(`/public/workspace`)。
- [x] API 工作空间输出统一导航、模块、Offering、表单和能力结构。
- [x] 增加公开工作空间契约结构测试。
- [x] 集成测试覆盖运行时 schemaVersion、导航、模块、Offering、表单、能力和主题。
- [ ] 增加 API 授权、品牌隔离和 schema 版本测试。
- [ ] 让 Admin 工作空间预览读取同一运行时契约。
- [x] Admin 工作空间预览展示 Runtime Workspace 的 schema、模块、能力和公开业务统计。
- [x] 小程序首页和案例列表优先消费 `/public/workspace`,保留静态降级基线。
### 后续阶段
- [ ] Phase 2:标准模块库。
- [x] 建立小程序核心模块注册表、变体清单和未知模块降级策略。
- [x] 兼容旧模板模块 key,并将运行时模块状态注入首页和案例列表页面。
- [x] 更新基础 Design Tokens 到林境门作视觉基线,后续主题通过 Runtime Workspace 覆盖。
- [x] 首页已抽取 `FounderCard`、`TrustProof`、`OfferingList` 标准模块。
- [x] 首页已抽取 `BrandHero`、`TrustManifesto` 标准模块。
- [x] 建立 `OfferingDetail` 与 `InquiryForm` 标准模块骨架,待页面接入。
- [x] 建立 `Records`、`Profile`、`SuccessSummary` 用户链路模块骨架。
- [x] 建立林境门作模板 fixture 和标准模块 / 页面完整性检查。
- [x] 建立固定页面状态、视口和视觉锚点清单,可供后续截图回归执行。
- [ ] Phase 3:模板中心、安装快照、升级和回滚。
- [x] 建立行业模板与视觉模板注册表,并注册林境建筑画册与极简留白视觉模板。
- [x] Runtime Workspace 合并品牌配置中的视觉模板主题、版本和模块变体。
- [x] Admin 工作空间支持切换视觉模板并保存 `visualTemplateKey`。
- [x] 集成测试验证视觉模板切换会影响公开 Runtime Workspace 的主题和变体。
- [x] 增加视觉模板预览接口,并在品牌配置更新时合并 config,避免覆盖其他配置。
- [x] 后台视觉模板切换增加确认和差异说明,避免误操作覆盖业务内容。
- [x] 视觉模板切换记录历史快照,并提供后台历史查询接口。
- [x] 后台展示视觉模板历史并支持安全回滚。
- [x] 模板中心行业 / 视觉目录由后端注册表接口驱动。
- [x] 行业模板安装增加版本、描述和能力依赖确认。
- [x] Admin 展示视觉模板主题色、适用场景和模块变体预览卡片。
- [x] 增加行业模板与视觉模板的安装前组合预览接口,不写入品牌配置。
- [x] Admin 接入模板组合预览,可在安装前查看模块变体和能力依赖。
- [x] 首页标准模块按 `layout.home` 受控显示,未知模块安全隐藏。
- [x] 首页通过受控模块分支按 `layout.home` 实际改变模块渲染顺序。
- [x] 增加林境建筑画册与极简留白双视觉模板 fixture 验收。
- [x] 建立通用咨询 Capability Plugin manifest,明确模块依赖和 API 契约。
- [x] Phase 4:Capability Plugin 基础运行时合并。
- [x] 新增 `CapabilityInstallation` 持久化模型、唯一约束和可逆 Prisma migration。
- [x] Runtime Workspace 优先读取品牌级能力安装记录,并保留模板默认能力回退。
- [x] 能力状态统一输出为 `enabled`、`disabled` 或 `degraded`,并保留能力配置。
- [x] 集成测试覆盖品牌级能力安装读取、状态保留和配置隔离。
- [ ] 增加 Admin 能力启用 / 停用写接口、DTO、权限、审计和状态转换测试。
- [ ] Phase 5:林境门作与第二行业双模板验证。
- [ ] Phase 6:Stitch 到 Manifest 的转换流水线。
## 当前交付门槛
在 Phase 1 的 API 契约、测试和客户端消费完成前,不新增第二个行业页面,也不继续扩展行业专属固定 WXML。当前 API 契约已建立,下一步优先补测试和客户端消费。
## 当前边界说明
能力插件目前由模板注册表声明并以 `enabled` 状态输出,尚未提供品牌级启用 / 停用写入。下一步必须先增加独立的 `CapabilityInstallation` 持久化模型、权限校验、审计记录和 Runtime Workspace 合并规则,再开放 Admin 操作;不得将插件状态临时写入 `BrandProfile.config`。
- [x] 新增 `CapabilityInstallation` 模型、唯一约束和可逆 Prisma migration。