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

4.2 KiB

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. 最后接入小程序通用渲染和详情页。