feat: 收口多品牌与模板构建基础
This commit is contained in:
1 parent
0425a1c672
commit
77224ea51f
317 files changed
+11290
-1158
No files matched your search
@@ -0,0 +1,62 @@
|
||||
# 进度
|
||||
|
||||
- 任务:模板包运行时与构建体系
|
||||
- 形态:epic
|
||||
- 进度:4/4
|
||||
- 当前:模板包运行时与构建体系已完成,阿成与林境静态视觉原型均已通过人工验收;后续新增模板继续按独立 package + compiler 产物流程接入。动态数据、接口联调和品牌切换另行验收。
|
||||
- 真相文件:`SUBTASKS.csv`
|
||||
|
||||
## 决策
|
||||
|
||||
- 模板包是构建输入,不是小程序运行时下载内容。
|
||||
- 单次构建只包含一个模板包。
|
||||
- 模板包只负责视觉页面、导航和交互表达;公共 runtime 负责数据、鉴权、提交和状态。
|
||||
|
||||
## 已完成
|
||||
|
||||
- 新增 `packages/template-contract`,定义 runtime contract `1.0`、页面入口和导航声明。
|
||||
- 新增 `packages/template-compiler`,支持 `pnpm template:dev <template-key> --out <dir>`。
|
||||
- 新增 `packages/template-acheng-campus-food` 模板包骨架,已通过 workspace 模板校验。
|
||||
- 编译器已验证可生成带 `template.manifest.json` 的 Mini Program 目录。
|
||||
- 新增 `template-linjing-editorial` 包声明。
|
||||
- 阿成首页、菜单、主理人和出摊服务 renderer 已复制到独立模板包,compiler 会以 `apps/miniapp` shell 为基底合并模板文件。
|
||||
- compiler 现在会根据模板声明生成 `app.json` 标题和 `template.runtime.json`,并在生成前校验页面入口、导航和 runtime contract。
|
||||
- 当前仍处于迁移过渡期:shell 的旧 renderer 暂不删除,避免页面配置尚未覆盖完整时生成不可编译目录;只有模板包完成页面级覆盖后才执行所有权清理。
|
||||
- 新增 compiler 自动测试,验证阿成 5 导航、林境 3 导航、模板标题和 renderer 文件隔离。
|
||||
- 模板包现在声明 `renderers`,阿成和林境 renderer 源码已复制进各自 package;compiler 会校验 renderer 文件存在。
|
||||
- compiler 根据模板声明生成 `app.json.tabBar`,并从生成目录移除自定义 runtime tab bar 组件和引用;阿成 5 项、林境 3 项均有回归测试。
|
||||
- 导航协议支持模板扩展 entrypoint;阿成的“出摊服务”现在独立指向 `pages/stall-service/index`,不再与餐品页复用同一入口。
|
||||
- compiler 为模板 renderer 生成稳定的 `components/template-pages/<page>` alias,公共页面不再需要引用 `acheng-*` 或 `linjing-*` 组件名;生成页面只依赖 `template-home`、`template-offerings`、`template-profile` 等稳定别名。
|
||||
- 对没有专属 renderer 的模板页面,compiler 使用公共 runtime 模块生成 alias,不会从其他行业模板借用组件;单次生成结果中的 renderer 条件会被构建期固化,避免运行时保留模板分支。
|
||||
- 咨询页已移除 `templateKey` 行业分支,改为使用 workspace 下发的 presentation;compiler 会校验 manifest 中所有 entrypoint 的 `.js/.json/.wxml/.wxss` 文件均存在。
|
||||
- 生成完成后会删除 `components/templates` 旧 renderer 目录,生成产物不再携带其他模板组件;林境产物已验证不会混入阿成 renderer。
|
||||
- manifest 现在显式声明 `runtimeOwnedPages`,当前详情、咨询、成功、记录由公共 runtime 所有;compiler 会扫描生成页面,拒绝旧模板路径、runtime tab bar 和 `templateKey` 行业分支残留。
|
||||
- `pnpm test:template-compiler` 已通过,生成链路现在有自动回归而不是只依赖手工检查。
|
||||
|
||||
## 本轮验证
|
||||
|
||||
- `pnpm validate:templates`
|
||||
- `pnpm test:template-compiler`
|
||||
- `pnpm typecheck`
|
||||
- `pnpm format:check`
|
||||
- `git diff --check`
|
||||
|
||||
## 未完成
|
||||
|
||||
- 详情、成功、记录页面暂时继续使用公共 runtime 模块,后续如需行业专属视觉可通过 manifest renderer 声明扩展。
|
||||
- `ownedPaths` 仍用于声明模板源码所有权,但生成目录清理已由 compiler 的产物隔离逻辑负责。
|
||||
- 当前构建门禁已通过:`pnpm test:template-compiler`、`pnpm validate:templates`、`pnpm typecheck`、`pnpm format:check`、`git diff --check`。
|
||||
- 发布门禁已通过:`pnpm validate:template-release`、Mini Program fixture、visual fixture。
|
||||
- 阿成模板已补齐 5 个真实页面入口:首页、套餐餐品、出摊服务、主理人、定制咨询;生成目录的 5 个 tab 全部由微信原生 `tabBar` 驱动。
|
||||
- 阿成模板 package 进一步补齐餐品详情、预订成功、预订记录 3 个二级页面,并统一餐饮橙色视觉;生成产物的 8 个页面均来自 package 或公共 runtime 的明确入口。
|
||||
- 阿成 tab 图标资源已归属模板 package;图标完整性校验放在模板包校验脚本,compiler 只按 manifest 复制并写入原生 `tabBar`,不包含行业资源特判。
|
||||
- 本轮按 `/home/que01/下载/阿成校园餐---微信小程序原型/` 的 `ServiceView`、`BookingView` 先完成静态页面迁移:出摊服务包含固定日程、配送范围、4 步定制流程和咨询 CTA;定制咨询包含表单 / 历史记录切换、类型网格、人数/日期/预算/配送选择、错误态、提交承诺和记录卡,并继续接入现有提交接口。
|
||||
- 林境模板补齐独立案例 renderer、案例分类筛选、第三个 tab 外层间距和原生 tabBar 图标;模板声明默认品牌 `linjing-doors`,生成产物不再请求 `default-brand`。
|
||||
- 静态验收结论:阿成与林境模板的页面结构、主要视觉表现、原生 tabBar 和模板间隔离达到当前验收标准。
|
||||
- `apps/miniapp` 仍是开发过渡 shell,最终人工验收目录必须使用 `pnpm template:dev <template-key> --out <dir>` 生成的构建产物;生成产物已确认不包含自定义 tab bar。
|
||||
|
||||
## 阶段结论
|
||||
|
||||
- 阶段 3 模板包迁移:已完成,静态原型迁移和生成产物已人工验收。
|
||||
- 阶段 4 发布配置与回归:已完成,发布、fixture、类型和格式门禁通过。
|
||||
- 后续新增模板只需新增独立 `packages/template-*`、更新 `config/template-build.json`,并通过 compiler、fixture 和人工验收门禁。
|
||||
Reference in new issue
Block a user