From 1a796e52b17f44b9de58f32b87e989cd8f085b8b Mon Sep 17 00:00:00 2001 From: yaosutu <770858045@qq.com> Date: Thu, 21 May 2026 15:21:58 +0800 Subject: [PATCH] =?UTF-8?q?fix(=E8=BD=A6=E5=9E=8B=E7=AE=A1=E7=90=86?= =?UTF-8?q?=E5=BA=93=20changelog):=20typeKey=20=E6=98=AF=E8=A1=A8=E5=AD=97?= =?UTF-8?q?=E6=AE=B5=E4=B8=8D=E6=98=AF=E6=9E=9A=E4=B8=BE=EF=BC=8C=C2=A76?= =?UTF-8?q?=20=E6=94=B9=E4=B8=BA=E8=AF=B4=E6=98=8E=E6=97=A0=E5=AD=97?= =?UTF-8?q?=E5=85=B8=EF=BC=8C=E5=BB=BA=E8=AE=AE=E5=80=BC=E7=A7=BB=E5=88=B0?= =?UTF-8?q?=20=C2=A79=20=E4=B8=9A=E5=8A=A1=E8=BE=B9=E7=95=8C=E5=B9=B6?= =?UTF-8?q?=E5=BC=BA=E8=B0=83=E5=89=8D=E7=AB=AF=E4=B8=8D=E8=A6=81=E7=A1=AC?= =?UTF-8?q?=E7=BC=96=E7=A0=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../21_2785_车型管理库-新增接口-管理后台.md | 32 +++++++++++-------- 1 file changed, 18 insertions(+), 14 deletions(-) diff --git a/changelogs-v2/2026-05/21_2785_车型管理库-新增接口-管理后台.md b/changelogs-v2/2026-05/21_2785_车型管理库-新增接口-管理后台.md index bce11dd..2b988b2 100644 --- a/changelogs-v2/2026-05/21_2785_车型管理库-新增接口-管理后台.md +++ b/changelogs-v2/2026-05/21_2785_车型管理库-新增接口-管理后台.md @@ -589,20 +589,11 @@ Authorization: Bearer ## 6. 枚举 / 数据字典 -### 6.1 typeKey（车型大类 key，系统建议值） +本模块**无静态枚举 / 字典**： -**所属字段**：`VehicleTypeSaveReqVO.typeKey` / `VehicleTypeRespVO.typeKey` | **类型**：`String` | **必填**：✅（新增时） - -> 系统初始化已灌 4 个标准值。后端**无强枚举校验**，前端可按需扩展，但建议沿用以下值： - -| 值 | 中文 | 说明 | -|----|------|------| -| `suv` | SUV 越野 | 高底盘、多人出行 | -| `mpv` | MPV 商务 | 7 座商务车 | -| `bus` | 中巴 | 10-19 座 | -| `sedan` | 轿车 | 5 座 | - -> 业务无强校验意味着前端可灌入 `minibus` / `coach` 等自定义 key，唯一约束是**全局不重复**（违反抛 600101）。 +- `typeKey` 是 `fleet_vehicle_type` 表的一个 `VARCHAR(16)` 字段（行级数据），不是后端枚举常量，**没有字典表**。系统初始化灌入了 4 条标准记录（详见 §9 业务边界），但 typeKey 可通过 §3.3 自由扩展 +- `seats` 是数值范围（4-19，`@Min` / `@Max` 校验），不是枚举 +- 其他字段（modelName / basePrice / alias 等）均为自由文本/数字 --- @@ -628,11 +619,24 @@ Authorization: Bearer - ✅ **大类 typeKey 编辑**：编辑大类时后端**忽略**入参的 typeKey 字段（不改），其他字段正常更新 - ✅ **大类软删保护**：大类下有未删除型号时禁删（600104）；先删型号或迁移型号到其他大类 - ✅ **型号软删保护**：型号被任一车辆（fleet_vehicle）引用时禁删（600105） -- ✅ **同名约束**：typeKey **全局**唯一；modelName **同大类内**唯一 +- ✅ **同名约束**：typeKey **全局**唯一（违反抛 600101）；modelName **同大类内**唯一（违反抛 600103） - ✅ **分页默认值**：`page=1`、`pageSize=20`、`pageSize` 上限 100 - ✅ **跨大类搜索**：§3.7 不传 `vehicleTypeId` + 任意过滤 = 跨大类搜索（不报错） - ⚠️ **新增型号副作用**：§3.6 新增型号后会触发价格日历初始化（见 FLEET §9.4），前端无需感知 +### typeKey 系统初始化数据（不是枚举，可被 §3.3 扩展） + +系统初始化时灌入了 4 条标准大类（来自 DB 初始化脚本）： + +| typeKey | typeName | 用途参考 | +|---|---|---| +| `suv` | SUV 越野 | 高底盘 / 多人出行 | +| `mpv` | MPV 商务 | 7 座商务车 | +| `bus` | 中巴 | 10-19 座 | +| `sedan` | 轿车 | 5 座 | + +> ⚠️ 这是**表里的现有数据**，**不是枚举校验**。运营可随时通过 §3.3 新增 `minibus` / `coach` 等任意 typeKey（仅约束：全局不重复）。前端展示时**建议从 §3.1 或 §3.2 实时查**，不要硬编码上面 4 个值。 + --- ## 11. 影响评估