docs: 设计品牌工作空间数据模型
This commit is contained in:
1 parent
800f82521f
commit
4f26dce212
1 file changed
+60
@@ -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`;
|
||||
- 复杂规则表达式引擎。
|
||||
Reference in new issue
Block a user