feat: 收口多品牌与模板构建基础

This commit is contained in:
que01 committed 2026-09-25 02:55:46 +08:00
1 parent 0425a1c672
commit 77224ea51f
317 files changed
+11290 -1158

No files matched your search

@@ -3,7 +3,7 @@
- 任务:小程序视觉模板包体系
- 形态:epic
- 进度:5/5
- 当前:视觉模板包体系本轮完成
- 当前:本 Epic 已完成,下一阶段应进入模板选择与内容配置的真实业务验收
- 真相文件:`SUBTASKS.csv`
## 恢复信息
@@ -12,8 +12,11 @@
- 已新增 `VisualTemplateManifest`、`TemplatePackage`、页面/模块/资源/数据槽位和设计 token 类型。
- 已将林境模板登记为 7 个核心页面的正式 manifest,并保留个人品牌主线、行业解耦和能力依赖。
- `pnpm format:check`、`pnpm --filter @personal-brand/config typecheck`、`git diff --check` 已通过。
- 小程序 workspace 现在消费 `visualTemplateManifest`,将 manifest 页面模块解析为运行时模块和首页布局,并兼容旧版 `layout`。
- API workspace 返回完整视觉 manifest,API integration 28/28、Miniapp fixture 和 visual fixture 已通过。
- 模板安装快照现在包含行业模板、视觉 manifest 和能力依赖;现有示例内容导入流程保持幂等并纳入安装验收。
- 全量门禁通过:`format:check`、`lint`、`typecheck`、`build`、API integration 28/28、Miniapp fixture 和 visual fixture。
- lint 仅保留既有测试文件中的 6 个 `any` warning,无 error。
- 已发现:先前仅验证 manifest 形状,没有验证静态设计中的顶部主理人信息和信任区数据投影,也没有达到林境静态页的视觉还原要求。
- 当前修复:API 正式投影品牌身份与信任呈现数据;seed 由模板声明注册表驱动,消除按行业 key 的共享逻辑分支;首页开始渲染工艺支柱与履约流程。
- 本轮新增:林境的完整作品规格、履约资料和咨询字段由模板初始数据声明导入;小程序移除了静默回退到过期静态数据的路径,改为同品牌 workspace 缓存与明确错误状态。已确认 `172.16.6.123:3001` 的 `linjing-doors` workspace 返回 4 个完整作品、品牌资料、信任内容和表单字段。
- 内容审计:林境首页、作品、详情、咨询、提交成功、记录与“主理人与我”的业务文案均已改为读取 `brand.visualPresentation`、`trustPresentation`、`offerings` 或 `inquiryForms`。布局、图标和通用交互仍保留在视觉组件中。API 集成测试覆盖了关键 presentation 文案下发。
- 视觉验收限制:本机微信开发者工具 CLI 不提供可脚本化截图能力;文本 fixture 只能验证页面绑定和结构。用户已确认首页、作品、详情、咨询、成功、记录、我的页面均能正常显示。
- 2026-09-23:数据真实性复核完成。小程序业务内容来自 `public/workspace`,图片来自 workspace brand/offering 数据,表单来自 `inquiryForms`,咨询记录来自客户 API;已删除未使用的 `linjingInquiryRecords` 本地假数据读取。客户微信会话改为携带 `brandSlug`,服务端按请求品牌签发 token,并在集成测试中验证林境品牌隔离。
- 2026-09-23:通用组件的林境业务硬编码已清理,联系人标签、信任标题、流程标题和作品区文案改由 presentation slot 输入;fixture 增加品牌会话隔离与静态业务词泄漏检查。
- 2026-09-23:全量回归完成:`format:check`、`lint`、`typecheck`、`build`、API 集成测试 `30/30`、miniapp fixture、visual-fixture 和 `git diff --check` 全部通过。lint 仅有既存测试文件的 6 个 `any` warning,无新增 error。
@@ -1,6 +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,DONE,tasks/miniapp-renderer,小程序不再依赖行业硬编码页面结构,pnpm --filter @personal-brand/miniapp test:fixture && pnpm --filter @personal-brand/miniapp test:visual-fixture,运行时解析 visualTemplateManifest,保留旧 workspace 兼容
3,改造小程序按 manifest 和 variant 渲染,single-full,1;2,DONE,tasks/miniapp-renderer,小程序按 manifest 和 variant 渲染且林境视觉与数据完整,pnpm --filter @personal-brand/miniapp test:fixture && pnpm --filter @personal-brand/miniapp test:visual-fixture,用户已在微信开发者工具确认核心页面正常显示;数据链路与多品牌客户会话已验证
4,初始数据导入与模板安装快照,single-full,1;2,DONE,tasks/installation,新品牌可安装模板并导入初始内容且生成快照,pnpm --filter @personal-brand/api test:integration,安装快照包含行业模板、视觉 manifest 和能力依赖;示例内容导入保持幂等
5,视觉与全量回归,single-full,1;2;3;4,DONE,tasks/regression,接口、构建、fixture 和视觉回归全部通过,pnpm format:check && pnpm lint && pnpm typecheck && pnpm --filter @personal-brand/api test:integration,全部门禁通过;lint 保留 6 个既有 any warning
5,视觉与全量回归,single-full,1;2;3;4,DONE,tasks/regression,接口、构建、fixture 和视觉回归全部通过,pnpm format:check && pnpm lint && pnpm typecheck && pnpm --filter @personal-brand/api test:integration,用户页面验收通过;全量工程门禁与 API 30/30 集成测试通过
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 DONE tasks/miniapp-renderer 小程序不再依赖行业硬编码页面结构 小程序按 manifest 和 variant 渲染且林境视觉与数据完整 pnpm --filter @personal-brand/miniapp test:fixture && pnpm --filter @personal-brand/miniapp test:visual-fixture 运行时解析 visualTemplateManifest,保留旧 workspace 兼容 用户已在微信开发者工具确认核心页面正常显示;数据链路与多品牌客户会话已验证
5 4 初始数据导入与模板安装快照 single-full 1;2 DONE tasks/installation 新品牌可安装模板并导入初始内容且生成快照 pnpm --filter @personal-brand/api test:integration 安装快照包含行业模板、视觉 manifest 和能力依赖;示例内容导入保持幂等
6 5 视觉与全量回归 single-full 1;2;3;4 DONE tasks/regression 接口、构建、fixture 和视觉回归全部通过 pnpm format:check && pnpm lint && pnpm typecheck && pnpm --filter @personal-brand/api test:integration 全部门禁通过;lint 保留 6 个既有 any warning 用户页面验收通过;全量工程门禁与 API 30/30 集成测试通过
@@ -2,5 +2,9 @@
- 状态:DONE
- 依赖:视觉模板包契约、林境模板映射和用户验收
- 结果:公共 workspace 返回视觉 manifest;Miniapp runtime 按 manifest 页面和模块 variant 解析,并保留旧 workspace fallback。
- 验证:`pnpm --filter @personal-brand/api test:integration`、`pnpm --filter @personal-brand/miniapp test:fixture`、`pnpm --filter @personal-brand/miniapp test:visual-fixture`
- 已发现静态设计还原缺口,不能以 manifest 返回和 fixture 通过作为完成标准。
- 当前方向:删除不必要的旧契约兼容思路,使用模板声明数据和视觉模块完成林境首页还原。
- 2026-09-23:运行时 seed 已补齐林境 4 个作品、详情规格、联系资料和动态表单;作品、详情与“主理人与我”页面已接入对应数据。API 请求失败不再静默返回不完整的静态 fallback,而是使用同品牌缓存或显示错误状态。待微信开发者工具截图对照静态基准。
- 2026-09-23:完成业务静态文案审计。林境专属页面的行业标题、履约说明、转化文案和空状态均通过 `brand.visualPresentation` 下发;不再由 WXML 写死。运行时 API 测试与小程序 fixture 已通过,待 7 页截图对照。
- 2026-09-23:复核数据来源并修复多品牌客户会话。`customer/session/wechat` 现在使用请求中的 `brandSlug`,小程序 token 按品牌缓存;“主理人与我”记录数改为读取客户咨询 API,不再读取不存在的行业专属本地 key。集成测试 30/30、fixture 和 visual-fixture 均通过。
- 2026-09-23:用户在微信开发者工具确认核心页面显示正常,子任务收口,后续进入全量工程回归。