Files
persionalBrand/docs/data-model-v2.md
que01 7b1e9eee47 fix: 校验咨询表单关联业务并修正发布清单文案
- 关联的业务提供项必须存在且属于当前品牌,非法 id 返回 400 而不是数据库外键错误
- targetType 由 offeringId 推导,允许传 null 改回品牌通用入口
- 业务被停用时在发布准备度里点名说明,避免静默卡住发布
- 发布清单条目改为中性描述,是否达标交给状态标签表达
2026-10-14 13:55:00 +08:00

2.8 KiB
Raw Permalink Blame History

数据模型 v2 设计稿

目标

在兼容现有小程序和预约数据的前提下,引入品牌工作空间、模板安装、自定义字段和通用业务提供项。

核心实体

BrandProfile
├── BrandTemplateInstallation
├── BrandFieldDefinition
├── Offering
├── InquiryForm
└── Asset

BrandTemplateInstallation

记录品牌安装的模板、版本和应用状态。模板安装采用复制快照,品牌配置不运行时继承模板。

BrandFieldDefinition

记录字段所属对象、字段类型、校验、显示条件、排序、来源和覆盖状态。核心字段不能删除;模板字段可被品牌覆盖;自定义字段由品牌管理。

Offering

通用业务提供项,替代 Service 承担未来扩展职责。kind 支持 service、product、package、subscription,包含基础信息、价格、媒体、内容分区、规格和行动按钮配置。

现有 Service 保留作为兼容模型,迁移阶段通过 offeringId 或数据映射逐步过渡,不直接删除旧字段。

InquiryForm

品牌或 Offering 使用的咨询表单定义,带版本号。字段来自 BrandFieldDefinition,提交时保存字段定义快照和 active 状态。

targetType 与 offeringId 必须一致,由服务端根据 offeringId 推导,避免出现「标成品牌通用、却挂着业务 id」的漂移:

  • offeringId 为空:品牌通用入口,小程序任一咨询按钮都能进入;
  • offeringId 有值:只在该 Offering 的详情页使用,小程序按 offeringId 选择对应表单,找不到时回退到品牌通用表单;
  • 关联的 Offering 必须存在且属于当前品牌,否则拒绝写入(不允许跨品牌关联);
  • 关联的 Offering 被停用后,该表单在小程序里没有入口;发布准备度会把这种情况连同表单名一起说明,提示启用业务或改回品牌通用入口。

InquirySubmission

保留现有 Booking 作为历史兼容入口,新增通用咨询提交语义。新提交记录保存表单版本、字段定义快照、用户值和 active 字段集合。

迁移顺序

  1. 新增模板安装、字段、Offering、表单定义和提交快照表;
  2. 为现有品牌安装 personal 或 food 模板快照;
  3. 将现有 Service 映射为 Offering(kind = "service");
  4. 保持旧预约接口继续工作;
  5. 新增通用 Offering 和 Inquiry API;
  6. 客户端切换到通用接口后,再评估废弃旧模型字段。

不在本阶段处理

  • 购物车、库存、支付和物流;
  • 多模板同时作为完整主模板运行;
  • 任意 JSON 页面搭建器;
  • 通过数据库模块开关重排模板视觉页面;
  • 破坏性删除 Service 或 Booking;
  • 复杂规则表达式引擎。