diff --git a/docs/data-model-v2.md b/docs/data-model-v2.md new file mode 100644 index 0000000..f921074 --- /dev/null +++ b/docs/data-model-v2.md @@ -0,0 +1,60 @@ +# 数据模型 v2 设计稿 + +## 目标 + +在兼容现有小程序和预约数据的前提下,引入品牌工作空间、模板安装、自定义字段和通用业务提供项。 + +## 核心实体 + +```text +BrandProfile +├── BrandTemplateInstallation +├── BrandModule +├── BrandFieldDefinition +├── Offering +├── InquiryForm +└── Asset +``` + +### BrandTemplateInstallation + +记录品牌安装的模板、版本和应用状态。模板安装采用复制快照,品牌配置不运行时继承模板。 + +### BrandModule + +记录品牌公开页面模块:类型、标题、启用状态、排序、配置和来源。模块类型包括 `text`、`image-list`、`timeline`、`faq`、`services`、`inquiry`、`trust-content`。 + +### BrandFieldDefinition + +记录字段所属对象、字段类型、校验、显示条件、排序、来源和覆盖状态。核心字段不能删除;模板字段可被品牌覆盖;自定义字段由品牌管理。 + +### Offering + +通用业务提供项,替代 Service 承担未来扩展职责。`kind` 支持 `service`、`product`、`package`、`subscription`,包含基础信息、价格、媒体、内容分区、规格和行动按钮配置。 + +现有 `Service` 保留作为兼容模型,迁移阶段通过 `offeringId` 或数据映射逐步过渡,不直接删除旧字段。 + +### InquiryForm + +品牌或 Offering 使用的咨询表单定义,带版本号。字段来自 `BrandFieldDefinition`,提交时保存字段定义快照和 active 状态。 + +### InquirySubmission + +保留现有 `Booking` 作为历史兼容入口,新增通用咨询提交语义。新提交记录保存表单版本、字段定义快照、用户值和 active 字段集合。 + +## 迁移顺序 + +1. 新增模板安装、模块、字段、Offering、表单定义和提交快照表; +2. 为现有品牌安装 `personal` 或 `food` 模板快照; +3. 将现有 `Service` 映射为 `Offering(kind = "service")`; +4. 保持旧预约接口继续工作; +5. 新增通用 Offering 和 Inquiry API; +6. 客户端切换到通用接口后,再评估废弃旧模型字段。 + +## 不在本阶段处理 + +- 购物车、库存、支付和物流; +- 多模板同时作为完整主模板运行; +- 任意 JSON 页面搭建器; +- 破坏性删除 `Service` 或 `Booking`; +- 复杂规则表达式引擎。