feat: 建立视觉模板包契约与林境映射

This commit is contained in:
que01 committed 2026-09-23 14:18:28 +08:00
1 parent 241c19812f
commit 031c81a7c1
9 files changed
+427

No files matched your search

@@ -0,0 +1,26 @@
# 小程序视觉模板包体系
## 目标
将当前仅包含主题颜色和少量变体的视觉配置,升级为可安装、可验证、可快照、可演进的小程序视觉模板包。视觉模板负责页面结构、模块变体、设计令牌和资源槽位;行业模板负责业务表达;能力插件负责咨询、预约、报价和状态流转。个人品牌身份、信任证明和转化路径始终是所有模板的共同主线。
## 交付边界
- 第一阶段定义 `VisualTemplateManifest` 和 `TemplatePackage` 契约,并完成林境模板映射,供用户验收。
- 第二阶段再改造小程序渲染器,使页面按 manifest 和 variant 组合渲染。
- 第三阶段补齐模板安装、初始数据导入、快照、升级和回滚。
- 第四阶段建立接口、构建、fixture 和截图回归门禁。
## 设计约束
- Stitch 产物只能作为设计输入,不能直接作为生产运行时。
- 视觉模板不可写入行业术语和业务字段;行业字段通过数据槽位和能力配置注入。
- 模板默认内容可编辑,模板结构约束和必需模块由安装器维护。
- 所有公共内容必须通过品牌上下文隔离;模板包不能携带跨品牌数据。
## 完成标准
- 所有子任务均为 `DONE`;
- manifest 类型可被 config、API 和 Miniapp 共享使用;
- 林境模板覆盖核心页面、模块顺序、资源槽位、数据槽位和能力依赖;
- 通过格式、config typecheck、API typecheck、API integration、Miniapp fixture 和 visual fixture 门禁。
@@ -0,0 +1,15 @@
# 进度
- 任务:小程序视觉模板包体系
- 形态:epic
- 进度:2/5
- 当前:子任务 1、2 已完成,等待用户验收视觉模板契约;子任务 3 暂不开始
- 真相文件:`SUBTASKS.csv`
## 恢复信息
- 多品牌隔离、品牌上下文和运行时 seed 数据已完成并提交。
- 已新增 `VisualTemplateManifest`、`TemplatePackage`、页面/模块/资源/数据槽位和设计 token 类型。
- 已将林境模板登记为 7 个核心页面的正式 manifest,并保留个人品牌主线、行业解耦和能力依赖。
- `pnpm format:check`、`pnpm --filter @personal-brand/config typecheck`、`git diff --check` 已通过。
- 当前等待用户验收契约和林境映射;确认后才能进入渲染器、安装器和快照实现。
@@ -0,0 +1,6 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,定义视觉模板包契约,single-full,,DONE,tasks/contract,VisualTemplateManifest 和 TemplatePackage 类型及契约说明完成,pnpm format:check && pnpm --filter @personal-brand/config typecheck,共享契约和 ADR 已完成
2,将林境静态设计映射为正式视觉模板,single-full,1,DONE,tasks/linjing-mapping,林境核心页面和资源数据映射到 manifest,pnpm --filter @personal-brand/config typecheck,7 个页面、模块变体、资源槽位、数据槽位和能力依赖已登记
3,改造小程序按 manifest 和 variant 渲染,single-full,1;2,TODO,tasks/miniapp-renderer,小程序不再依赖行业硬编码页面结构,pnpm --filter @personal-brand/miniapp test:fixture && pnpm --filter @personal-brand/miniapp test:visual-fixture,依赖前两项及用户验收
4,初始数据导入与模板安装快照,single-full,1;2,TODO,tasks/installation,新品牌可安装模板并导入初始内容且生成快照,pnpm --filter @personal-brand/api test:integration,与安装器和品牌隔离联动
5,视觉与全量回归,single-full,1;2;3;4,TODO,tasks/regression,接口、构建、fixture 和视觉回归全部通过,pnpm format:check && pnpm lint && pnpm typecheck && pnpm --filter @personal-brand/api test:integration,最终收口
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 定义视觉模板包契约 single-full DONE tasks/contract VisualTemplateManifest 和 TemplatePackage 类型及契约说明完成 pnpm format:check && pnpm --filter @personal-brand/config typecheck 共享契约和 ADR 已完成
3 2 将林境静态设计映射为正式视觉模板 single-full 1 DONE tasks/linjing-mapping 林境核心页面和资源数据映射到 manifest pnpm --filter @personal-brand/config typecheck 7 个页面、模块变体、资源槽位、数据槽位和能力依赖已登记
4 3 改造小程序按 manifest 和 variant 渲染 single-full 1;2 TODO tasks/miniapp-renderer 小程序不再依赖行业硬编码页面结构 pnpm --filter @personal-brand/miniapp test:fixture && pnpm --filter @personal-brand/miniapp test:visual-fixture 依赖前两项及用户验收
5 4 初始数据导入与模板安装快照 single-full 1;2 TODO tasks/installation 新品牌可安装模板并导入初始内容且生成快照 pnpm --filter @personal-brand/api test:integration 与安装器和品牌隔离联动
6 5 视觉与全量回归 single-full 1;2;3;4 TODO tasks/regression 接口、构建、fixture 和视觉回归全部通过 pnpm format:check && pnpm lint && pnpm typecheck && pnpm --filter @personal-brand/api test:integration 最终收口
@@ -0,0 +1,6 @@
# 视觉模板包契约
- 状态:DONE
- 范围:共享类型、注册表和 ADR
- 完成条件:config typecheck 与格式检查通过,并由用户验收契约方向
- 验证:`pnpm --filter @personal-brand/config typecheck`、`pnpm format:check`
@@ -0,0 +1,6 @@
# 林境模板映射
- 状态:DONE
- 依赖:视觉模板包契约
- 结果:登记首页、业务列表、详情、咨询、成功、记录、主理人 7 个页面,以及模块变体、资源槽位、数据槽位和能力依赖。
- 验证:`pnpm --filter @personal-brand/config typecheck`
@@ -0,0 +1,4 @@
# 小程序渲染器
- 状态:TODO
- 依赖:视觉模板包契约、林境模板映射和用户验收
@@ -0,0 +1,4 @@
# 回归验证
- 状态:TODO
- 依赖:前置实现全部完成