feat: 完善模板驱动的品牌内容工作台

This commit is contained in:
que01 committed 2026-09-25 05:21:42 +08:00
1 parent 77224ea51f
commit dd55af8d73
46 files changed
+2204 -295

No files matched your search

@@ -0,0 +1,34 @@
# 0014 模板声明品牌内容编辑契约
## Context
平台需要支持大量视觉与交互差异明显的小程序模板。品牌管理员需要配置自己的介绍、案例、图片和咨询内容,但不应理解 renderer、JSON、schema 或模板内部实现。当前 Admin 使用一套硬编码的页面表达字段,无法可靠覆盖阿成校园餐与林境建筑画册的不同业务表达。
## Decision
每个视觉模板 package 的 `template.json` 声明:
- `dataSlots`:运行时和发布检查需要的稳定业务数据集合;
- `assetSlots`:图片和媒体的业务名称、用途、必填性与推荐比例;
- `admin.sections`:品牌管理员看到的编辑分组、字段文案、帮助、输入类型与内部绑定。
模板 package 是页面结构、视觉、交互和内容编辑说明的唯一来源。后端负责校验、品牌隔离、快照与稳定数据投影;Admin 读取声明并渲染业务化表单。`binding`、renderer、capability、schema 等技术信息不会展示给品牌管理员。
## Alternatives
- 继续在 Admin 写共享页面表达字段:不能覆盖行业与视觉差异,模板增多后会产生模板 key 分支。
- 让品牌管理员编辑 JSON:灵活但不可用,且容易破坏发布内容。
- 用公共视觉积木约束所有模板:会牺牲模板的页面与交互自由度。
## Consequences
- 新模板必须同时交付页面代码、内容契约、媒体要求和业务化编辑文案。
- RuntimeWorkspace、发布检查和 Admin 需要在后续任务消费同一契约。
- 包内 manifest 的版本变更将进入发布快照,保证已发布品牌的展示可追溯。
## Migration Plan
1. 为阿成与林境补齐内容契约。
2. 将契约投影到 RuntimeWorkspace 和发布快照。
3. 发布前按必填槽位输出可行动提示。
4. 用声明驱动品牌管理员工作台,移除硬编码的通用页面表达表单。