Files
que01 7b1e9eee47 fix: 校验咨询表单关联业务并修正发布清单文案
- 关联的业务提供项必须存在且属于当前品牌,非法 id 返回 400 而不是数据库外键错误
- targetType 由 offeringId 推导,允许传 null 改回品牌通用入口
- 业务被停用时在发布准备度里点名说明,避免静默卡住发布
- 发布清单条目改为中性描述,是否达标交给状态标签表达
2026-10-14 13:55:00 +08:00

64 lines
2.8 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
├── 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`;
- 复杂规则表达式引擎。