- 关联的业务提供项必须存在且属于当前品牌,非法 id 返回 400 而不是数据库外键错误 - targetType 由 offeringId 推导,允许传 null 改回品牌通用入口 - 业务被停用时在发布准备度里点名说明,避免静默卡住发布 - 发布清单条目改为中性描述,是否达标交给状态标签表达
64 lines
2.8 KiB
Markdown
64 lines
2.8 KiB
Markdown
# 数据模型 v2 设计稿
|
||
|
||
## 目标
|
||
|
||
在兼容现有小程序和预约数据的前提下,引入品牌工作空间、模板安装、自定义字段和通用业务提供项。
|
||
|
||
## 核心实体
|
||
|
||
```text
|
||
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`;
|
||
- 复杂规则表达式引擎。
|