feat: 完善模板驱动的品牌内容工作台

This commit is contained in:
que01 committed 2026-09-25 05:21:42 +08:00
1 parent 77224ea51f
commit dd55af8d73
46 files changed
+2204 -295

No files matched your search

@@ -2,15 +2,16 @@
- 任务:品牌友好内容工作台与模板契约增强
- 形态:epic
- 进度:0/5
- 当前:任务已建立,等待从模板与 Admin 内容契约开始实施。
- 进度:5/5
- 当前:5 个自动化子任务完成,等待用户人工验收;Epic 尚未关闭。
- 真相文件:`SUBTASKS.csv`
## Context Recovery Block
- 当前子任务:#1 模板与 Admin 内容契约
- 当前状态:TODO
- 已完成:无
- 当前子任务:最终全量验证
- 当前状态:自动化完成,待人工验收
- 已完成:#1 契约、#2 RuntimeWorkspace 投影、#3 发布模板适配校验、#4 品牌友好内容工作台、#5 双模板回归;API 集成测试 37 项通过。
- 关键背景:阿成和林境静态视觉验收通过,但 RuntimeWorkspace、发布校验和 Admin 编辑仍不足以支撑大量差异化模板。
- 已知问题:后端导航存在固定结构痕迹;offering projection 可能丢失展示属性;公共视觉页面不应再作为模板兜底。
- 下一步:审计现有模板 manifest、Admin 配置页面和发布服务,定义最小的 Template Admin Contract。
- 已解决风险:导航和 offering 展示属性按 package 快照投影;Admin 编辑声明仅进入受保护 workspace,public Runtime 不暴露;模板目录指纹校验可发现生成产物过期。
- 后续事项:Admin production build 的 `api` chunk 约 667 KB,超过 Vite 500 KB 提示线;建议另开 Admin 路由级代码拆分任务,本 Epic 不以此阻塞验收。
- 下一步:用户验收阿成/林境 Admin 品牌表达页及发布体验;按反馈修订后再关闭 Epic。自动化验证通过不代替实际 UI 操作验收。
@@ -1,6 +1,6 @@
id,task,task_type,status,depends_on,task_dir,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,模板与 Admin 内容契约,single-full,TODO,,tasks/template-admin-contract,manifest 声明数据槽位资产槽位字段语义和通俗编辑文案,pnpm --filter @personal-brand/template-contract typecheck,,0,不引入模板专属后端 if else
2,RuntimeWorkspace 完整投影,single-full,TODO,1,tasks/runtime-workspace-projection,导航和 offering presentation/assets 完整且品牌隔离,pnpm --filter @personal-brand/api test:integration,,0,不得丢弃模板声明字段
3,发布模板适配校验,single-full,TODO,1;2,tasks/publication-compatibility,发布前给出可行动缺失提示并写入快照,pnpm --filter @personal-brand/api test:integration,,0,覆盖缺图缺字段缺表单场景
4,品牌友好内容工作台,single-full,TODO,1;2;3,tasks/brand-content-workbench,普通品牌管理员可按业务语言配置并发布,pnpm --filter @personal-brand/admin build,,0,不暴露 JSON schema renderer capability
5,双模板回归与验收,single-full,TODO,1;2;3;4,tasks/template-e2e-regression,阿成和林境品牌数据与模板产物均正确,pnpm test:template-compiler,,0,包含发布快照和品牌隔离回归
1,模板与 Admin 内容契约,single-full,DONE,,tasks/template-admin-contract,manifest 声明数据槽位资产槽位字段语义和通俗编辑文案,pnpm --filter @personal-brand/template-contract typecheck,2026-09-25,0,不引入模板专属后端 if else
2,RuntimeWorkspace 完整投影,single-full,DONE,1,tasks/runtime-workspace-projection,导航和 offering presentation/assets 完整且品牌隔离,pnpm --filter @personal-brand/api test:integration,2026-09-25,0,37 项通过
3,发布模板适配校验,single-full,DONE,1;2,tasks/publication-compatibility,发布前给出可行动缺失提示并写入快照,pnpm --filter @personal-brand/api test:integration,2026-09-25,0,缺失内容拦截及修复流程通过
4,品牌友好内容工作台,single-full,DONE,1;2;3,tasks/brand-content-workbench,普通品牌管理员可按业务语言配置并发布,pnpm --filter @personal-brand/admin build,2026-09-25,0,声明驱动编辑;仅写 brand.config binding;Admin 单测和 API 集成通过
5,双模板回归与验收,single-full,DONE,1;2;3;4,tasks/template-e2e-regression,阿成和林境品牌数据与模板产物均正确,pnpm test:template-compiler,2026-09-25,0,包含 Admin 声明品牌隔离、public 隔离、原生 tabbar 和发布契约回归
1 id task task_type status depends_on task_dir acceptance_criteria validation_command completed_at retry_count notes
2 1 模板与 Admin 内容契约 single-full TODO DONE tasks/template-admin-contract manifest 声明数据槽位资产槽位字段语义和通俗编辑文案 pnpm --filter @personal-brand/template-contract typecheck 2026-09-25 0 不引入模板专属后端 if else
3 2 RuntimeWorkspace 完整投影 single-full TODO DONE 1 tasks/runtime-workspace-projection 导航和 offering presentation/assets 完整且品牌隔离 pnpm --filter @personal-brand/api test:integration 2026-09-25 0 不得丢弃模板声明字段 37 项通过
4 3 发布模板适配校验 single-full TODO DONE 1;2 tasks/publication-compatibility 发布前给出可行动缺失提示并写入快照 pnpm --filter @personal-brand/api test:integration 2026-09-25 0 覆盖缺图缺字段缺表单场景 缺失内容拦截及修复流程通过
5 4 品牌友好内容工作台 single-full TODO DONE 1;2;3 tasks/brand-content-workbench 普通品牌管理员可按业务语言配置并发布 pnpm --filter @personal-brand/admin build 2026-09-25 0 不暴露 JSON schema renderer capability 声明驱动编辑;仅写 brand.config binding;Admin 单测和 API 集成通过
6 5 双模板回归与验收 single-full TODO DONE 1;2;3;4 tasks/template-e2e-regression 阿成和林境品牌数据与模板产物均正确 pnpm test:template-compiler 2026-09-25 0 包含发布快照和品牌隔离回归 包含 Admin 声明品牌隔离、public 隔离、原生 tabbar 和发布契约回归
@@ -0,0 +1,27 @@
# 进度
- 任务:品牌友好内容工作台
- 形态:single-full
- 进度:4/4
- 当前:完成,进入双模板回归。
- 真相文件:`TODO.csv`
## 结果
- `GET /admin/workspace` 按当前会话品牌的 `visualTemplateKey` 返回模板 `displayName`、通俗编辑分组和图片槽位。
- Admin 页面根据模板声明渲染不同分组、说明、字段、输入类型、必填和图片预览,不再硬编码模板页面字段。
- 编辑器只处理 `brand.config.*` binding;按声明合并回已有品牌 config,保留其它顶层与嵌套内容,拒绝原型链路径。
- 保存成功后刷新品牌、workspace、小程序 Runtime 和发布检查;请求失败时保留表单值并显示错误。
- public Runtime 不暴露 Admin 编辑声明。
## 验证
- `pnpm --filter @personal-brand/api typecheck`
- `pnpm --filter @personal-brand/admin test`,断言脚本通过,覆盖配置保留、嵌套 binding 和越界路径拒绝。
- `pnpm --filter @personal-brand/admin build`
- `pnpm validate:templates`
- `pnpm --filter @personal-brand/api test:integration`,37 项通过。
## 偏差与修正
- 集成测试首次发现模板源文件和生成目录不同步,Admin 因此读不到新增的主图编辑项。运行 `pnpm generate:template-catalog` 后重跑验证通过;模板目录指纹校验会阻止以后带着过期生成目录交付。
@@ -0,0 +1,14 @@
# 品牌友好内容工作台
## 目标
Admin 品牌表达编辑区按当前视觉模板的 `admin.sections` 和资产槽位显示字段。字段标题、帮助和输入类型全部来自模板声明,普通品牌管理员不接触内部 binding 或模板技术配置。
## 完成标准
- Admin workspace 返回当前品牌模板的编辑声明,按会话品牌隔离。
- 品牌编辑页不再硬编码首页、案例、咨询等公共字段集合。
- text、textarea、phone、image、number 均按声明渲染。
- 保存只更新声明对应的品牌配置路径,保留其他品牌配置。
- 保存失败保留用户输入,并提供可读错误;发布检查可跳转到对应编辑页。
- Admin production build 与 API 授权集成测试通过。
@@ -0,0 +1,5 @@
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,在 Admin workspace 提供品牌编辑声明,DONE,响应包含当前视觉模板的 sections 与 asset slots,pnpm --filter @personal-brand/api test:integration,2026-09-25,1,同步生成模板目录后通过;集成测试断言编辑声明
2,声明驱动渲染品牌内容表单,DONE,阿成和林境显示不同业务文案与字段,pnpm --filter @personal-brand/admin build,2026-09-25,0,字段类型和业务文案完全来自当前模板声明
3,按 binding 保存配置并保留输入,DONE,局部保存不会覆盖未编辑品牌配置,pnpm --filter @personal-brand/admin test,2026-09-25,0,覆盖嵌套更新、配置保留与越界 binding 拒绝
4,验证权限品牌隔离和构建,DONE,Admin API 和生产构建通过,pnpm --filter @personal-brand/api test:integration,2026-09-25,1,37 项集成测试通过;缺少登录为 401、客户角色为 403
1 id task status acceptance_criteria validation_command completed_at retry_count notes
2 1 在 Admin workspace 提供品牌编辑声明 DONE 响应包含当前视觉模板的 sections 与 asset slots pnpm --filter @personal-brand/api test:integration 2026-09-25 1 同步生成模板目录后通过;集成测试断言编辑声明
3 2 声明驱动渲染品牌内容表单 DONE 阿成和林境显示不同业务文案与字段 pnpm --filter @personal-brand/admin build 2026-09-25 0 字段类型和业务文案完全来自当前模板声明
4 3 按 binding 保存配置并保留输入 DONE 局部保存不会覆盖未编辑品牌配置 pnpm --filter @personal-brand/admin test 2026-09-25 0 覆盖嵌套更新、配置保留与越界 binding 拒绝
5 4 验证权限品牌隔离和构建 DONE Admin API 和生产构建通过 pnpm --filter @personal-brand/api test:integration 2026-09-25 1 37 项集成测试通过;缺少登录为 401、客户角色为 403
@@ -0,0 +1,22 @@
# 进度
- 任务:发布模板适配校验
- 形态:single-full
- 进度:4/4
- 当前:已完成,Epic 转入品牌友好内容工作台。
- 真相文件:`TODO.csv`
## 结果
- 发布检查读取视觉模板 package 的必填字段和媒体槽位。
- 缺少主理人信息、品牌主图、任一业务封面、咨询表单时阻止发布。
- 每项缺失提示返回编辑入口与模板编写的操作说明,用户界面不展示 binding。
- API 集成测试覆盖缺内容拦截、修复后发布、授权与品牌隔离。
## 验证
- `pnpm --filter @personal-brand/api typecheck`
- `pnpm validate:templates`
- `pnpm --filter @personal-brand/api test:integration`,37 项通过。
- `pnpm --filter @personal-brand/admin build`
- `pnpm format:check`
@@ -0,0 +1,13 @@
# 发布模板适配校验
## 目标
发布前根据当前品牌安装的视觉模板声明检查必需内容、媒体和咨询配置,返回品牌管理员能直接处理的中文提示。
## 完成标准
- 校验读取 package manifest,不按 template key 分支。
- 缺少图片、品牌介绍、业务提供项或可用咨询表单时禁止发布。
- readiness 返回用户可读项目名和补充位置提示,不返回内部 binding 或 manifest key。
- 发布快照同时记录被校验的模板 package manifest。
- API 集成测试覆盖通过与失败场景、权限和品牌隔离。
@@ -0,0 +1,5 @@
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,将图片槽位映射到业务字段,DONE,图片要求含内部绑定和用户可读建议,pnpm validate:templates,2026-09-25,0,通过
2,实现声明驱动的发布检查,DONE,必填内容按 manifest 校验并返回通俗提示,pnpm --filter @personal-brand/api typecheck,2026-09-25,0,通过
3,补足发布 readiness 测试,DONE,覆盖缺图缺主理人缺表单和成功发布,pnpm --filter @personal-brand/api test:integration,2026-09-25,0,37 项通过
4,更新任务与文档,DONE,契约和校验语义有记录且验证通过,pnpm format:check,2026-09-25,0,通过
1 id task status acceptance_criteria validation_command completed_at retry_count notes
2 1 将图片槽位映射到业务字段 DONE 图片要求含内部绑定和用户可读建议 pnpm validate:templates 2026-09-25 0 通过
3 2 实现声明驱动的发布检查 DONE 必填内容按 manifest 校验并返回通俗提示 pnpm --filter @personal-brand/api typecheck 2026-09-25 0 通过
4 3 补足发布 readiness 测试 DONE 覆盖缺图缺主理人缺表单和成功发布 pnpm --filter @personal-brand/api test:integration 2026-09-25 0 37 项通过
5 4 更新任务与文档 DONE 契约和校验语义有记录且验证通过 pnpm format:check 2026-09-25 0 通过
@@ -0,0 +1,24 @@
# 进度
- 任务:RuntimeWorkspace 完整投影
- 形态:single-full
- 进度:4/4
- 当前:已完成,进入发布模板适配校验。
- 真相文件:`TODO.csv`
## 结果
- 发布快照保存视觉模板 package manifest;Runtime 导航从快照投影,不再固定为三项。
- 阿成输出 5 项导航,林境输出 3 项导航;公开 Runtime 不返回 Admin binding 清单。
- offering 业务展示配置投影为 `presentation` 扩展字段,小程序 view model 原样保留。
- 生成目录由 package `template.json` 产生,并以 SHA-256 指纹阻止目录过期。
## 验证
- `pnpm --filter @personal-brand/api typecheck`
- `pnpm validate:templates`
- `pnpm test:template-compiler`
- `pnpm validate:template-release`
- `node --test apps/miniapp/test/runtime-workspace.test.cjs`
- `pnpm --filter @personal-brand/api test`
- `pnpm --filter @personal-brand/api test:integration`,37 项通过。
@@ -0,0 +1,18 @@
# RuntimeWorkspace 完整投影
## 目标
让已发布模板声明的数据槽位、媒体槽位、导航和业务提供项展示属性完整进入 `RuntimeWorkspace`,并保持品牌隔离。控制器只做投影,不能按模板 key 写分支。
## 完成标准
- 已发布快照中的模板内容契约可被 RuntimeWorkspace 消费。
- 导航来自发布模板声明,阿成保留 5 项、林境保留 3 项。
- offering 的 `presentation` 扩展属性不被控制器丢弃。
- 增加集成测试覆盖两个品牌和未发布品牌隔离。
## 当前事实
- `PublicWorkspaceController` 当前固定返回 3 项导航。
- `runtimeOfferings` 当前只投影少量 `presentation` 字段。
- 发布快照已保存 visual manifest,尚未保存 package content contract。
@@ -0,0 +1,5 @@
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,审计快照与 Runtime 类型,DONE,明确契约快照和 RuntimeWorkspace 的最小变化,rg -n "BrandReleaseSnapshot|RuntimeWorkspace|navigation" apps/api packages/types,2026-09-25,0,已确认快照需要 package contract,导航固定三项且 presentation 丢字段
2,投影发布模板声明和导航,DONE,RuntimeWorkspace 返回快照模板契约及声明导航,pnpm --filter @personal-brand/api typecheck,2026-09-25,0,通过
3,保留 offering 展示属性,DONE,presentation 扩展字段在 API 与小程序 view model 中保留,node --test apps/miniapp/test/runtime-workspace.test.cjs,2026-09-25,0,通过
4,补充双品牌隔离测试,DONE,阿成林境导航和品牌数据隔离测试通过,pnpm --filter @personal-brand/api test:integration,2026-09-25,0,37 项通过
Can't render this file because it contains an unexpected character in line 2 and column 100.
@@ -0,0 +1,21 @@
# 进度
- 任务:模板与 Admin 内容契约
- 形态:single-full
- 进度:4/4
- 当前:#1 已完成,Epic 转入 RuntimeWorkspace 完整投影。
- 真相文件:`TODO.csv`
## 发现
- 当前 `PresentationEditor` 硬编码了一组跨模板字段,不能表达阿成的出摊信息和林境的项目案例语义。
- 当前 package manifest 只覆盖构建、导航和 renderer,不能驱动发布检查或用户可见编辑界面。
- `packages/config` 仍保留运行时 visual manifest;后续任务将把 package 内容契约投影进发布快照,避免按模板 key 分支。
## 验证
- `pnpm --filter @personal-brand/template-contract typecheck`
- `pnpm validate:templates`
- `pnpm test:template-compiler`
- `pnpm validate:template-release`
- `pnpm format:check`
@@ -0,0 +1,16 @@
# 模板与 Admin 内容契约
## 目标
由每个视觉模板 package 声明自身需要的业务内容、媒体和品牌管理员编辑分组。平台只读取、校验与投影声明;不以模板 key 分支,不向品牌用户暴露 renderer、schema 或 JSON。
## 完成标准
- 两个现有模板都声明 data slots、asset slots 和通俗编辑区块。
- 合约类型和校验能拒绝不完整的模板声明。
- 记录模板 package 为编辑说明唯一来源的架构决策。
## 非目标
- 本任务不改动 RuntimeWorkspace 投影、数据库或 Admin 页面。
- 不实现新的小程序模板。
@@ -0,0 +1,5 @@
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,审计现有模板与编辑字段,DONE,两模板的页面数据和当前 Admin 字段已归纳,rg -n "visualPresentation|presentation" packages/template-*,,0,完成于本轮
2,定义并实现模板内容契约,DONE,合约包含数据槽位媒体槽位和通俗编辑区块,pnpm --filter @personal-brand/template-contract typecheck,2026-09-25,0,通过
3,为阿成与林境声明编辑契约,DONE,两个 template.json 通过契约和发布校验,pnpm validate:templates,2026-09-25,0,通过
4,记录 ADR 并验证,DONE,ADR 说明来源边界和迁移路径,pnpm format:check,2026-09-25,0,通过
Can't render this file because it contains an unexpected character in line 2 and column 104.
@@ -0,0 +1,17 @@
# 进度
- 任务:双模板端到端回归
- 形态:single-full
- 进度:4/4
- 当前:自动化回归通过;Epic 待最终全量验证和进度关闭。
- 真相文件:`TODO.csv`
## 验证
- `pnpm --filter @personal-brand/api test:integration`,37 项通过;新增阿成/林境 Admin 声明品牌隔离断言、错误角色拒绝和 public manifest 隔离断言。
- `node --test apps/miniapp/test/runtime-workspace.test.cjs`
- `pnpm test:template-compiler`,两套真实产物通过:阿成 5 项原生 tabbar,林境 3 项原生 tabbar,入口、renderer 和页面清理均符合声明。
- `pnpm validate:templates`
- `pnpm validate:template-release`
- `pnpm --filter @personal-brand/admin test`
- `pnpm --filter @personal-brand/admin build`
@@ -0,0 +1,13 @@
# 双模板端到端回归
## 目标
验证阿成校园餐与林境建筑画册作为独立视觉模板时,模板声明、Admin 编辑项、品牌数据隔离、Runtime 投影、发布快照和小程序构建均保持一致。
## 完成标准
- Admin workspace 根据当前品牌返回对应模板编辑清单,品牌切换不会串用另一模板声明。
- 受保护 workspace 路由覆盖未登录、错误角色和授权成功路径。
- public Runtime 不暴露 Admin 内部编辑声明;品牌内容由正确品牌快照投影。
- 两个模板产物使用微信原生 tabbar,导航项数、entrypoint 和 renderer 与 package manifest 相符。
- 模板 package 目录、生成目录与发布锁定版本校验通过。
@@ -0,0 +1,5 @@
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,回归 Admin 声明与多品牌隔离,DONE,阿成与林境会话分别返回匹配模板声明且角色校验生效,pnpm --filter @personal-brand/api test:integration,2026-09-25,0,37 项集成测试通过并新增声明隔离断言
2,回归 Runtime 数据投影与发布边界,DONE,品牌展示字段保留且 public 不含 Admin manifest,node --test apps/miniapp/test/runtime-workspace.test.cjs,2026-09-25,0,Runtime fixture 覆盖 offering 展示扩展字段
3,回归两个小程序模板构建产物,DONE,两模板 entrypoint 原生 tabbar renderer 和页面裁剪均符合 manifest,pnpm test:template-compiler,2026-09-25,0,Acheng 5 tab 与 Linjing 3 tab 编译测试通过
4,校验模板目录与版本发布契约,DONE,目录指纹、manifest 与发布版本锁定一致,pnpm validate:templates && pnpm validate:template-release,2026-09-25,0,模板包与生成目录同步
1 id task status acceptance_criteria validation_command completed_at retry_count notes
2 1 回归 Admin 声明与多品牌隔离 DONE 阿成与林境会话分别返回匹配模板声明且角色校验生效 pnpm --filter @personal-brand/api test:integration 2026-09-25 0 37 项集成测试通过并新增声明隔离断言
3 2 回归 Runtime 数据投影与发布边界 DONE 品牌展示字段保留且 public 不含 Admin manifest node --test apps/miniapp/test/runtime-workspace.test.cjs 2026-09-25 0 Runtime fixture 覆盖 offering 展示扩展字段
4 3 回归两个小程序模板构建产物 DONE 两模板 entrypoint 原生 tabbar renderer 和页面裁剪均符合 manifest pnpm test:template-compiler 2026-09-25 0 Acheng 5 tab 与 Linjing 3 tab 编译测试通过
5 4 校验模板目录与版本发布契约 DONE 目录指纹、manifest 与发布版本锁定一致 pnpm validate:templates && pnpm validate:template-release 2026-09-25 0 模板包与生成目录同步