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

2.4 KiB

品牌友好内容工作台与模板契约增强

目标

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