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