Files

5.8 KiB
Raw Permalink Blame History

进度

  • 任务:模板包运行时与构建体系
  • 形态: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 和人工验收门禁。