Files
persionalBrand/docs/adr/0002-template-workspace-and-offering-model.md

75 lines
4.2 KiB
Markdown

# ADR 0002:模板、品牌工作空间与业务提供项模型
- 状态:已采纳
- 日期:2026-09-19
## 背景
产品的核心是帮助已有业务的个人建立信任并持续运营品牌。用户可能来自咨询、设计、摄影、餐饮、定制产品等不同领域,因此模板必须提供行业表达起点,同时保留品牌的自定义业务空间。
## 决策
### 1. 品牌工作空间是最终事实来源
`BrandWorkspace` 保存品牌实际使用的模块、字段、服务、业务提供项、咨询表单、主题和资源。客户端只渲染工作空间配置,不直接根据行业名称编写业务分支。
### 2. 模板是初始化方案,不是运行时继承
模板定义默认模块、字段、服务分类、咨询表单、合作流程、文案建议和主题。安装模板时复制默认配置到品牌工作空间;安装完成后品牌配置独立存在。
模板升级通过差异预览应用,不能覆盖品牌已经修改的内容。差异分为新增、修改、废弃和冲突。
### 3. 核心字段、模板字段和自定义字段分层
- 核心字段:名称、定位、服务对象、价值主张、信任证明入口,平台固定且不可删除;
- 模板字段:由模板推荐,品牌可以启用、停用、改名和排序;
- 自定义字段:由品牌创建和维护,不受具体行业模板限制。
第一阶段字段类型限定为:`text`、`textarea`、`number`、`date`、`select`、`multi-select`、`image`、`url`、`phone`。
### 4. 模块与字段分离
模块决定页面展示结构和顺序,字段决定模块内部的数据。第一阶段模块类型包括:`text`、`image-list`、`timeline`、`faq`、`services`、`inquiry`、`trust-content`。
默认页面采用固定叙事顺序,品牌可以调整模块顺序、字段顺序并关闭非核心模块。后续可以增加模板策略限制模块是否可关闭或修改。
### 5. Offering 是通用业务提供项
餐饮套餐、定制产品、咨询服务、摄影套餐等统一抽象为 `Offering`,而不是传统电商 `Product`。Offering 支持基础信息、媒体、内容分区、价格、规格、交付说明、FAQ 和行动按钮,但不引入购物车、库存、优惠券、支付或物流。
现有 `Service` 作为兼容入口,逐步映射为 `Offering(kind = "service")`。未来可支持 `service`、`product`、`package`、`subscription` 等类型。
Offering 的详情页由小程序通用渲染,行动按钮通过配置决定:`inquiry`、`booking`、`contact`、`external-link`。
### 6. 动态咨询表单和历史快照
品牌资料、Offering 和咨询表单支持自定义字段及简单条件显示。条件隐藏的字段保留原值,提交时标记为 `inactive`。
咨询提交必须保存表单版本、字段定义快照、用户值和 active 状态。历史记录按提交快照展示,当前规则只用于后续业务处理。
### 7. 模板策略默认自由
当前模板默认允许品牌新增字段、新增模块、调整顺序和停用非核心模块。未来模板可以声明必需模块、允许字段类型和不可修改字段,但不改变基础数据模型。
## 备选方案
- 让小程序针对每个行业写独立页面:放弃,因为会造成行业逻辑与客户端耦合;
- 直接使用传统电商商品模型:放弃,因为当前目标是建立信任并承接咨询,不是交易闭环;
- 使用一个无限制 JSON 配置替代结构化模型:放弃,因为无法稳定校验、迁移、渲染和保存历史快照;
- 模板运行时继承品牌配置:放弃,因为模板升级会覆盖品牌自定义内容。
## 后果
- 初期需要新增模板安装、字段定义、模块配置、Offering 和表单快照模型;
- 客户端需要实现统一模块和字段渲染器;
- 模板可以持续扩展行业表达,同时不会污染个人品牌核心模型;
- 数据模型和 API 契约需要优先于具体后台页面实现。
## 后续实施顺序
1. 设计并迁移品牌工作空间、字段、模块和模板安装模型;
2. 设计 Offering 基础模型和详情接口;
3. 设计动态咨询表单及提交快照;
4. 增加后台配置界面和 API 集成测试;
5. 最后接入小程序通用渲染和详情页。