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