docs: 设计品牌工作空间数据模型

This commit is contained in:
que01 committed 2026-09-19 22:39:11 +08:00
1 parent 800f82521f
commit 4f26dce212
1 file changed
+60
+60
View File
@@ -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`;
- 复杂规则表达式引擎。