110 lines
7.9 KiB
Markdown
110 lines
7.9 KiB
Markdown
# 模板运行时实施进度
|
||
|
||
关联决策:docs/adr/0005-template-runtime-and-stitch-pipeline.md
|
||
|
||
统一任务入口:[模板管理与分发交付计划](template-management-delivery-plan.md)
|
||
|
||
模板管理边界:[ADR 0029](adr/0029-template-management-and-distribution.md)
|
||
|
||
> 状态校正(2026-10-16):本文中标记为 [x] 的条目只表示对应的局部代码或接口曾经落地,不代表已经通过模板包导出、线上导入、独立预览、品牌安装、升级回滚和微信上传的完整门禁。Phase 3 的“模板中心、安装快照、升级和回滚”整体仍未完成,后续进度以统一任务入口的阶段和证据为准。
|
||
|
||
## 当前分支
|
||
|
||
`feat/template-runtime-platform`
|
||
|
||
### 构建时模板叠加基线
|
||
|
||
- [x] Runtime、Capability、Template 三层编译结构已落地,详见 `docs/adr/0015-template-build-time-composition.md`。
|
||
- [x] 阿成、林境页面与 tab 资源已迁入独立模板包,Runtime 不再携带行业页面和模板组件。
|
||
- [x] `booking` 下单页面曾迁入 `packages/capability-booking`,因无入口且与咨询表单重复已移除;阿成统一走咨询。
|
||
- [x] 编译产物校验覆盖页面文件、组件引用、`require`、tab 图标、品牌参数和能力依赖错误。
|
||
- [x] 增加第二行业最小演练模板(`packages/template-compiler/test/fixtures/template-drill-consultant`),并由 `pnpm template:check` 门禁。
|
||
- [ ] 接入视觉截图回归。
|
||
|
||
## 阶段状态
|
||
|
||
### 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:模板中心、安装快照、升级和回滚,统一由 [TMP-PLATFORM-001](template-management-delivery-plan.md) 的 Phase 2 至 Phase 6 继续实施。
|
||
- [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] 集成测试覆盖品牌级能力安装读取、状态保留和配置隔离。
|
||
- [x] 增加 Admin 能力列表与状态更新接口,校验模板声明、品牌隔离和状态枚举。
|
||
- [x] 增加能力变更审计日志和授权 / 审计集成测试。
|
||
- [x] 建立 Capability 产品元数据、可选策略、用途绑定和受控配置字段契约。
|
||
- [x] Admin 更新能力时由服务端注册表派生 `capabilityVersion`,并拒绝未声明配置字段。
|
||
- [x] Runtime Workspace 输出品牌能力配置与配置字段声明;发布快照保持发布时状态。
|
||
- [ ] Phase 5:林境门作与第二行业双模板验证。
|
||
- [x] 注册 `doors@1.0.0` 门窗行业模板,复用个人品牌、信任、Offering 与 Inquiry 能力。
|
||
- [x] 增加门窗行业 fixture,并验证 Admin 安装后 Runtime Workspace 契约完整。
|
||
- [ ] 补充门窗真实 Offering、信任内容和咨询字段数据 fixture。
|
||
- [x] 增加门窗示例内容预览、幂等导入、审计和后台操作入口。
|
||
- [x] API 集成测试覆盖示例内容导入成功与重复导入保护。
|
||
- [x] 门窗行业结构与视觉 fixture 全量通过,可进入真实小程序渲染验证。
|
||
- [ ] Phase 6:Stitch 到 Manifest 的转换流水线。
|
||
|
||
## 当前交付门槛
|
||
|
||
在 Phase 1 的 API 契约、测试和客户端消费完成前,不新增第二个行业页面,也不继续扩展行业专属固定 WXML。当前 API 契约已建立,下一步优先补测试和客户端消费。
|
||
|
||
当前交付门槛还包括:模板版本事实一致、导出 checksum 稳定、线上导入幂等、未发布版本不可安装、预览不写入品牌、bootstrap 来源可追踪,以及构建/上传/发布状态能够在失败和重启后收敛。局部 Runtime Workspace 或模板目录接口通过,不能单独标记本任务完成。
|
||
|
||
## 统一任务进度
|
||
|
||
详见 [模板管理与分发交付计划](template-management-delivery-plan.md)。完成阶段时必须登记实现 commit、migration、测试命令、运行环境、外部证据和未解决问题;不要只修改本页的 checkbox。
|
||
|
||
## 当前边界说明
|
||
|
||
能力插件目前由模板注册表声明并以 `enabled` 状态输出,尚未提供品牌级启用 / 停用写入。下一步必须先增加独立的 `CapabilityInstallation` 持久化模型、权限校验、审计记录和 Runtime Workspace 合并规则,再开放 Admin 操作;不得将插件状态临时写入 `BrandProfile.config`。
|
||
|
||
- [x] 新增 `CapabilityInstallation` 模型、唯一约束和可逆 Prisma migration。
|