feat: 收口多品牌与模板构建基础
This commit is contained in:
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,包含发布快照和品牌隔离回归
|
||||
|
Reference in new issue
Block a user