changelog(fleet): 车辆新增所有权性质字段 个人/公司所有 (PR #3601)

changelogs-v2/2026-06/08_3601_车辆新增所有权性质字段个人公司所有-修改接口-管理后台.md

@@ -0,0 +1,103 @@
+# 【新增字段·车辆档案】车辆新增「所有权性质 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 车辆档案·所有权性质） |