【新增字段·车辆档案】车辆新增「所有权性质 ownerType」— 区分个人所有 / 公司所有

变更类型：🟢 新增字段（出入参 + 列表过滤 + 导入列，字典下拉） 端类型：管理后台服务：hl-fleet-service + hl-user-service（字典种子） PR：wx/HL#3601 日期：2026-06-08 影响范围：车辆新增 / 编辑 / 详情 / 列表 / 列表筛选 / Excel 导入

⚠️ 关键说明

车辆档案新增字段 ownerType（所有权性质），字典下拉，取值：

dictValue	dictLabel
`company`	公司所有
`personal`	个人所有

它和已有的 fleet（车队归属 own/coopA/coopB）正交，别混：

fleet 回答「谁在运营这车」——自有车队 / 合作车队A / 合作车队B。
ownerType 回答「车登记在谁名下」——个人 / 公司。

原因：原来 fleet=own（自有）把「公司自购车」和「司机自带车（个人产权）」混在一起，靠 regCertOwner（行驶证所有人）那个文本名字人眼猜。新字段把产权拆清楚。

不传默认 company（公司所有），存量车自动视为公司车。

1. 前端要改什么

位置	改动
车辆新增 / 编辑表单	加「所有权性质」下拉，选项从 `GET /admin/dict/data/vehicle_owner_type` 取（`dictValue` 作值、`dictLabel` 作显示）；不选默认 `company`
车辆详情 / 列表出参	多了 `ownerType` 字段，用字典把 `company`/`personal` 映射为公司所有/个人所有显示
车辆列表筛选	`GET /admin/fleet/vehicles/page` 新增可选 query 参数 `ownerType`（`company`/`personal`）
Excel 批量导入	模板可加「所有权性质(company/personal)」列（可选，不填默认 company）

2. 字典接口

GET /admin/dict/data/vehicle_owner_type（Bearer Token）

{
  "code": 200,
  "data": [
    { "dictValue": "company",  "dictLabel": "公司所有", "sortOrder": 10, "status": "ACTIVE" },
    { "dictValue": "personal", "dictLabel": "个人所有", "sortOrder": 20, "status": "ACTIVE" }
  ]
}

3. 字段位置（新增车辆入参示例节选）

POST /admin/fleet/vehicles

{
  "plate": "蒙A-66666",
  "vehicleModelId": "<id>",
  "fleet": "own",            // 车队归属(运营归属)
  "ownerType": "company",    // 🆕 所有权性质(产权;不传默认 company)
  "seats": 7,
  "...": "..."
}

详情 GET /admin/fleet/vehicles/{id} 出参同样多 ownerType 一项。

4. 关于「司机自带车自动归个人所有」

设计上：司机自带车审核通过的车应自动归 personal（个人所有）。

⚠️ 但这个自动置值挂在「自带车 → 自动建车 / 关联」的路径上，而该路径目前后端还没实现（自带车审核当前只在司机档案上记了个车牌字符串，没有自动创建/关联车辆记录；常驻司机 primaryDriverId 也还在后续里程碑）。所以现阶段：

字段和默认值已就绪。
车管在车辆档案里手动建/编辑自带车记录时，**手动选「个人所有」**即可。
待「自带车→自动建车」路径落地后，会自动置 personal（届时再发 changelog 告知）。

5. 验证

hl-fleet-service 209 单测全绿。
已部署测试服（user + fleet 双实例均 UP）；经网关 9443 实测字典返 2 项（公司所有/个人所有），运行态 OpenAPI 契约 SaveReq/Detail/列表项均含 ownerType。

6. 关联文档

文档	版本
API-SPEC-FLEET	v1.5.17
DATABASE-SCHEMA-FLEET	v1.5.14
SRS-FLEET	v1.5（§5.2 车辆档案·所有权性质）

3.7 KiB 原始文件 Blame 文件历史 Unescape Escape