Files
persionalBrand/.codex-tasks/template-package-runtime-epic/PROGRESS.md
T

63 lines
5.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 进度
- 任务:模板包运行时与构建体系
- 形态: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 和人工验收门禁。