Files
persionalBrand/docs/data-model-v2.md

61 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 数据模型 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`;
- 复杂规则表达式引擎。