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

> **变更类型**：🟢 新增字段（出入参 + 列表过滤 + 导入列，字典下拉）
> **端类型**：管理后台
> **服务**：hl-fleet-service + hl-user-service（字典种子）
> **PR**：https://git.1814.love:8443/wx/HL/pulls/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）

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

---

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

`POST /admin/fleet/vehicles`

```json
{
  "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 车辆档案·所有权性质） |
