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

@@ -0,0 +1,50 @@
# 品牌友好内容工作台与模板契约增强
## 目标
- 让品牌管理员以通俗业务语言配置自己的品牌介绍、图片、业务提供项、案例、咨询问题和发布内容。
- 让视觉模板保持页面结构、交互和视觉表达的自由,不依赖公共视觉组件兜底。
- 建立稳定的模板数据、资产、字段语义和发布校验契约,支持未来大量独立模板 package。
## 非目标
- 不实现小程序运行时下载或执行模板代码。
- 不在本 Epic 新增第三个行业模板。
- 不让品牌用户直接编辑 JSON、schemaKey、renderer、capability 或模板版本。
## 约束
- 继续使用 NestJS、Prisma、React Admin、微信小程序和 pnpm workspace。
- 后端只提供稳定业务事实、状态和能力;模板负责视觉和交互表达。
- 所有受保护 API 必须覆盖未授权、错误角色和成功路径的自动化测试。
- 品牌隔离必须由服务端当前会话/品牌上下文决定,不能信任客户端 brandId。
- 新增或修改发布数据必须进入 immutable release snapshot。
## 风险
- RuntimeWorkspace 契约变更可能影响 Admin、小程序和已有模板,必须用双模板 fixture 回归。
- 数据库与快照结构变更需要 migration、seed、发布流程和 API 测试同步更新。
- “通俗易懂”的配置文案是模板定义的一部分,不能通过通用技术字段勉强复用。
## 子任务
1. 增强 Template Contract:数据槽位、资产槽位、字段语义、导航和 Admin 编辑声明。
2. 完整 RuntimeWorkspace Projection:稳定输出导航、展示属性、资产和模板适配状态。
3. 发布前模板适配校验与快照:阻止缺少关键内容、图片或表单的发布。
4. 品牌友好 Admin 内容工作台:按模板 Admin manifest 渲染业务化编辑界面。
5. 双模板端到端回归:阿成与林境的品牌隔离、发布、数据槽位和小程序构建验收。
## 依赖
- 任务 2 依赖任务 1。
- 任务 3 依赖任务 1 和 2。
- 任务 4 依赖任务 1、2 和 3。
- 任务 5 依赖任务 1 至 4。
## 完成条件
- [ ] 所有 `SUBTASKS.csv` 行为 `DONE`。
- [ ] 两个模板均可由品牌管理员通过通俗编辑界面完成配置并发布。
- [ ] 发布时能以可行动提示阻止模板必需内容缺失。
- [ ] RuntimeWorkspace 不丢失模板已声明的展示字段。
- [ ] API、Admin build、模板编译和双模板 fixture 回归通过。
@@ -0,0 +1,16 @@
# 进度
- 任务:品牌友好内容工作台与模板契约增强
- 形态:epic
- 进度:0/5
- 当前:任务已建立,等待从模板与 Admin 内容契约开始实施。
- 真相文件:`SUBTASKS.csv`
## Context Recovery Block
- 当前子任务:#1 模板与 Admin 内容契约
- 当前状态:TODO
- 已完成:无
- 关键背景:阿成和林境静态视觉验收通过,但 RuntimeWorkspace、发布校验和 Admin 编辑仍不足以支撑大量差异化模板。
- 已知问题:后端导航存在固定结构痕迹;offering projection 可能丢失展示属性;公共视觉页面不应再作为模板兜底。
- 下一步:审计现有模板 manifest、Admin 配置页面和发布服务,定义最小的 Template Admin Contract。
@@ -0,0 +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 id task task_type status depends_on task_dir acceptance_criteria validation_command completed_at retry_count notes
2 1 模板与 Admin 内容契约 single-full TODO tasks/template-admin-contract manifest 声明数据槽位资产槽位字段语义和通俗编辑文案 pnpm --filter @personal-brand/template-contract typecheck 0 不引入模板专属后端 if else
3 2 RuntimeWorkspace 完整投影 single-full TODO 1 tasks/runtime-workspace-projection 导航和 offering presentation/assets 完整且品牌隔离 pnpm --filter @personal-brand/api test:integration 0 不得丢弃模板声明字段
4 3 发布模板适配校验 single-full TODO 1;2 tasks/publication-compatibility 发布前给出可行动缺失提示并写入快照 pnpm --filter @personal-brand/api test:integration 0 覆盖缺图缺字段缺表单场景
5 4 品牌友好内容工作台 single-full TODO 1;2;3 tasks/brand-content-workbench 普通品牌管理员可按业务语言配置并发布 pnpm --filter @personal-brand/admin build 0 不暴露 JSON schema renderer capability
6 5 双模板回归与验收 single-full TODO 1;2;3;4 tasks/template-e2e-regression 阿成和林境品牌数据与模板产物均正确 pnpm test:template-compiler 0 包含发布快照和品牌隔离回归