5.8 KiB
5.8 KiB
进度
- 任务:模板包运行时与构建体系
- 形态:epic
- 进度:4/4
- 当前:模板包运行时与构建体系已完成,阿成与林境静态视觉原型均已通过人工验收;后续新增模板继续按独立 package + compiler 产物流程接入。动态数据、接口联调和品牌切换另行验收。
- 真相文件:
SUBTASKS.csv
决策
- 模板包是构建输入,不是小程序运行时下载内容。
- 单次构建只包含一个模板包。
- 模板包只负责视觉页面、导航和交互表达;公共 runtime 负责数据、鉴权、提交和状态。
已完成
- 新增
packages/template-contract,定义 runtime contract1.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/miniappshell 为基底合并模板文件。 - 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:templatespnpm test:template-compilerpnpm typecheckpnpm format:checkgit 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 和人工验收门禁。