refactor: 重构模板叠加式编译产物

This commit is contained in:
que01 committed 2026-09-26 11:21:29 +08:00
1 parent c46297b13b
commit 25d1fe983c
93 files changed
+870 -2467

No files matched your search

@@ -0,0 +1,23 @@
# 模板构建时叠加平台
## 目标
将 `template:dev` 收敛为运行时层、能力包、模板包三层叠加编译,产出可直接被微信开发者工具打开的完整小程序。运行时不携带任何行业或具体模板代码,新增行业模板只需新增模板包。
## 范围
- 运行时壳清理与品牌构建参数注入。
- `template-contract` manifest 契约及 compiler 冲突校验。
- `capability-booking` 小程序页面迁移。
- 阿成、林境模板页面和资产包化。
- 编译产物校验、第二行业 fixture、文档与门禁。
## 不在范围
- 后端 Booking capability 化。
- 后台视觉模板切换、历史和回滚。
- 微信第三方平台、`ext.json` 和订单通知。
## 验收
阿成和林境模板均可独立编译;产物页面、组件、`require`、tab 图标、品牌参数均通过自动校验;运行时目录不含模板专属代码;`pnpm check`、模板校验和 compiler 测试通过。
@@ -0,0 +1,26 @@
# 执行记录
## 当前状态
本轮从既有未提交改动继续。叠加式 compiler 已可将 runtime、capability、template 编译成独立产物;`booking` 页面已迁入 capability 包;runtime 模板页面、模板组件和 tab 资产已移除。
## 已验证
- `acheng-campus-food` 编译成功。
- `linjing-editorial` 编译成功。
- compiler 已支持解析 `miniprogram_npm` 中的 TDesign 组件引用。
- 顶层 `templates/` 镜像已删除,模板目录校验统一读取 `packages/template-*`。
- `pnpm lint`、`pnpm typecheck`、模板 compiler 测试、模板契约测试和 miniapp fixture 均通过。
## 待办
- 更新 template catalog。
- 修正并扩展 compiler 测试和 fixture。
- 完成 runtime/template grep、typecheck、format、miniapp fixture 门禁。
- 补齐 ADR、README 和新增模板说明。
- `pnpm format:check` 全仓仍会报告已有 `.claude/settings.local.json`,该文件不属于本任务且未修改。
## 失败记录
- 初次编译因 `capability-booking/miniapp` 缺失而失败,已迁移页面解决。
- 初次林境编译因 runtime tab 资产和模板资产冲突而失败,已将 tab 资产归属模板并清理 runtime。
@@ -0,0 +1,6 @@
id,title,status,depends_on,validation,notes
1,完成叠加式契约与编译器,DONE,,pnpm test:template-compiler,阿成和林境编译及错误场景测试通过
2,清理运行时模板代码与资源,DONE,1,rg -n 'acheng|linjing|pageRenderer|templateKey ===' apps/miniapp,运行时生产目录无模板专属代码
3,迁移 booking 能力包,DONE,1,node packages/template-compiler/src/cli.mjs --template acheng-campus-food,
4,完善两个模板包页面与资产,DONE,1;2,node packages/template-compiler/src/cli.mjs --template linjing-editorial,林境页面和 tab 资源已迁移并编译通过
5,补齐测试、演练模板和文档,IN_PROGRESS,1;2;3;4,pnpm check,编译器测试、模板校验、fixture、lint、typecheck 通过;format 全仓受既有 settings 文件阻塞
1 id title status depends_on validation notes
2 1 完成叠加式契约与编译器 DONE pnpm test:template-compiler 阿成和林境编译及错误场景测试通过
3 2 清理运行时模板代码与资源 DONE 1 rg -n 'acheng|linjing|pageRenderer|templateKey ===' apps/miniapp 运行时生产目录无模板专属代码
4 3 迁移 booking 能力包 DONE 1 node packages/template-compiler/src/cli.mjs --template acheng-campus-food
5 4 完善两个模板包页面与资产 DONE 1;2 node packages/template-compiler/src/cli.mjs --template linjing-editorial 林境页面和 tab 资源已迁移并编译通过
6 5 补齐测试、演练模板和文档 IN_PROGRESS 1;2;3;4 pnpm check 编译器测试、模板校验、fixture、lint、typecheck 通过;format 全仓受既有 settings 文件阻塞