58 lines
2.4 KiB
Markdown
58 lines
2.4 KiB
Markdown
# 小程序模板渲染边界
|
|
|
|
## 模板定位
|
|
|
|
模板是初始化品牌工作空间的业务表达方案,不是运行时继承体系。安装模板时复制模块、字段和默认内容;运行时以 `BrandWorkspace` 为最终事实来源。
|
|
|
|
`personal` 是默认基准模板,`food` 是行业示例。未来模板可以覆盖咨询、设计、摄影、教育等行业,但不能改变核心品牌模型。
|
|
|
|
## 数据来源
|
|
|
|
小程序只读取公开接口:
|
|
|
|
- `/public/brand`
|
|
- `/public/workspace`
|
|
- `/public/offerings`
|
|
- `/public/offerings/:id`
|
|
- `/public/inquiry-forms/:id`
|
|
|
|
小程序不得直接读取管理接口,也不得自行推断隐藏字段或品牌标识。
|
|
|
|
## 三层字段模型
|
|
|
|
### 核心字段
|
|
|
|
所有品牌都可使用:`name`、`tagline`、`audience`、`valueProposition`、`trustProof`。
|
|
|
|
### 模板字段
|
|
|
|
由模板初始化,例如餐饮的取送方式、摄影的拍摄类型。模板字段必须遵守后端字段类型白名单。
|
|
|
|
### 自定义字段
|
|
|
|
品牌方可以在管理后台增加,用于表达未被模板预见的业务需求。前端根据字段类型渲染,不为单个行业新增页面分支。
|
|
|
|
## Offering 渲染
|
|
|
|
Offering 的统一响应包含基础信息、`sections`、`media` 和 `cta`。分区支持 `text`、`image-list`、`timeline`、`faq`,未知分区必须安全降级,不得导致页面崩溃。
|
|
|
|
## 表单渲染
|
|
|
|
动态咨询表单必须使用后端返回的字段顺序、标签、类型、选项、必填状态和可见条件。提交请求必须携带字段值,服务端负责最终校验;客户端校验只用于即时反馈。
|
|
|
|
## 禁止事项
|
|
|
|
- 禁止 `if (templateKey === "food")` 形式的页面业务分支;
|
|
- 禁止把餐饮字段加入共享品牌模型;
|
|
- 禁止在小程序配置服务、Offering 或表单;
|
|
- 禁止引入购物车、库存、优惠券、会员积分和支付流程;
|
|
- 禁止将 TDesign 组件名暴露为行业模板协议。
|
|
|
|
## 演进策略
|
|
|
|
模板升级必须先生成差异预览,再由品牌方选择应用。新增字段和模块采用 additive 方式;删除或重命名必须保留迁移策略,不能破坏已有提交记录。
|
|
|
|
## 验收要求
|
|
|
|
使用 `personal` 和 `food` 两套数据验证同一套页面组件;再使用至少一个自定义字段验证动态表单。三种场景均不得修改页面代码,且接口、字段快照和错误状态测试必须通过。
|