Files
persionalBrand/.codex-tasks/brand-friendly-template-content-epic/EPIC.md
T

51 lines
2.4 KiB
Markdown

# 品牌友好内容工作台与模板契约增强
## 目标
- 让品牌管理员以通俗业务语言配置自己的品牌介绍、图片、业务提供项、案例、咨询问题和发布内容。
- 让视觉模板保持页面结构、交互和视觉表达的自由,不依赖公共视觉组件兜底。
- 建立稳定的模板数据、资产、字段语义和发布校验契约,支持未来大量独立模板 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 回归通过。