changelog: 421ec547 - feat: 团队填报改为表单模式——预填/暂存/提交三步流程

2026-04-01 12:43:52 +08:00 · 2026-04-01 12:43:52 +08:00 · 8d54c46554
--- a/changelogs/2026-04/2026-04-01_1243_421ec547_feat.md
+++ b/changelogs/2026-04/2026-04-01_1243_421ec547_feat.md
@ -0,0 +1,256 @@
+# 接口变更记录 — 2026-04-01 12:43
+
+> **提交** `421ec547` · **作者** wx · **时间** 2026-04-01 12:43:52 +0800
+>
+> feat: 团队填报改为表单模式——预填/暂存/提交三步流程
+
+## 变更总览
+
+- **订单服务**
+  - AdminTeamReport (+3, -1, 名1)
+
+---
+
+## 订单服务
+
+### AdminTeamReport
+
+> 📖 **接口文档**: [http://192.168.100.236:8084/doc.html](http://192.168.100.236:8084/doc.html) → 标签 **「团队填报管理」**
+
+### 🆕 `GET` /admin/team-report/prefill/{orderId} — 预填表单（从订单数据自动填充）
+
+**参数**
+
+  - `{orderId}` (`Long`) — 路径参数：订单ID
+
+**响应** `Result<TeamReportFormDTO>`
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `orderId` | `Long` | 订单ID |
+| `agencyCode` | `String` | 旅行社编码 hulai/qianshou/hulai-wenlu |
+| `businessType` | `Integer` | 业务类型 2=国内游组团 6=入境接待 7=国内接待 |
+| `agencyName` | `String` | 旅行社名称 |
+| `agencyLicense` | `String` | 经营许可证号 |
+| `itineraryName` | `String` | 线路名称 |
+| `teamId` | `String` | 团号 |
+| `dateGo` | `String` | 出发日期 yyyy-MM-dd |
+| `timeGoHour` | `String` | 出发时间 HH |
+| `timeGoMinute` | `String` | 出发时间 mm |
+| `dateBack` | `String` | 返回日期 yyyy-MM-dd |
+| `timeBackHour` | `String` | 返回时间 HH |
+| `timeBackMinute` | `String` | 返回时间 mm |
+| `sourceCity` | `String` | 出发城市 |
+| `sourceProvince` | `String` | 出发省份 |
+| `destinationCity` | `String` | 前往城市 |
+| `destinationProvince` | `String` | 前往省份 |
+| `itineraryDay` | `Integer` | 天数 |
+| `vehicle` | `Integer` | 出发交通 1=飞机 2=火车 3=轮船 4=汽车 5=其它 |
+| `vehicleIn` | `Integer` | 返回交通 1=飞机 2=火车 3=轮船 4=汽车 5=其它 |
+| `vehicleOutNums` | `String` | 出发班次/车次 |
+| `vehicleInNums` | `String` | 返回班次/车次 |
+| `nativeTravelAgency` | `String` | 地接社名称 |
+| `teamType` | `Integer` | 团队类型 1=自组自接 2=包机 3=专列 4=其他 |
+| `peopleNums` | `Integer` | 团队人数 |
+| `childNums` | `Integer` | 儿童人数 |
+| `journeyDesc` | `String` | 行程总描述 |
+| `applicantName` | `String` | 申请人姓名 |
+| `applicantPhone` | `String` | 申请人电话 |
+| `guides` | `List<GuideInfo>` | 导游列表 |
+| `name` | `String` | 导游姓名 |
+| `cardId` | `String` | 电子导游证号 |
+| `phone` | `String` | 导游电话 |
+| `type` | `Integer` | 导游类型 1=全陪 2=地陪 |
+| `isLeader` | `Integer` | 是否领队 0=否 1=是 |
+| `busInfo` | `List<BusInfo>` | 车队列表 |
+| `carId` | `String` | 车牌号 |
+| `carComp` | `String` | 所属公司 |
+| `driverName` | `String` | 驾驶员姓名 |
+| `driverPhone` | `String` | 驾驶员联系电话 |
+| `itineraryList` | `List<ItineraryItem>` | 行程列表（按天按站点） |
+| `dayNumber` | `Integer` | 第几天 |
+| `siteNum` | `Integer` | 当天第几个站点 |
+| `date` | `String` | 具体日期 yyyy-MM-dd |
+| `city` | `String` | 前往城市 |
+| `province` | `String` | 前往省份 |
+| `journeyDesc` | `String` | 站点行程描述 |
+| `title` | `String` | 站点标题 |
+| `isTransit` | `Integer` | 是否过境 0=否 1=是 |
+| `touristList` | `List<TouristInfo>` | 游客列表 |
+| `name` | `String` | 姓名 |
+| `pyFamilyName` | `String` | 姓拼音 |
+| `pyGivenName` | `String` | 名拼音 |
+| `dateOfBirth` | `String` | 出生日期 yyyy-MM-dd |
+| `phoneNum` | `String` | 联系方式 |
+| `sex` | `Integer` | 性别 0=男 1=女 |
+| `age` | `Integer` | 年龄 |
+| `isChild` | `Integer` | 是否儿童 0=否 1=是 |
+| `hrProvince` | `String` | 户籍所在省 |
+| `cardType` | `Integer` | 证件类型 1=身份证 2=护照 |
+| `cardId` | `String` | 证件号码 |
+| `cardValidTo` | `String` | 证件有效期至 yyyy-MM-dd |
+
+### 🆕 `POST` /admin/team-report/save — 暂存表单（不提交到12301）
+
+**请求体** `TeamReportFormDTO`
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `orderId` | `Long` | 订单ID |
+| `agencyCode` | `String` | 旅行社编码 hulai/qianshou/hulai-wenlu |
+| `businessType` | `Integer` | 业务类型 2=国内游组团 6=入境接待 7=国内接待 |
+| `agencyName` | `String` | 旅行社名称 |
+| `agencyLicense` | `String` | 经营许可证号 |
+| `itineraryName` | `String` | 线路名称 |
+| `teamId` | `String` | 团号 |
+| `dateGo` | `String` | 出发日期 yyyy-MM-dd |
+| `timeGoHour` | `String` | 出发时间 HH |
+| `timeGoMinute` | `String` | 出发时间 mm |
+| `dateBack` | `String` | 返回日期 yyyy-MM-dd |
+| `timeBackHour` | `String` | 返回时间 HH |
+| `timeBackMinute` | `String` | 返回时间 mm |
+| `sourceCity` | `String` | 出发城市 |
+| `sourceProvince` | `String` | 出发省份 |
+| `destinationCity` | `String` | 前往城市 |
+| `destinationProvince` | `String` | 前往省份 |
+| `itineraryDay` | `Integer` | 天数 |
+| `vehicle` | `Integer` | 出发交通 1=飞机 2=火车 3=轮船 4=汽车 5=其它 |
+| `vehicleIn` | `Integer` | 返回交通 1=飞机 2=火车 3=轮船 4=汽车 5=其它 |
+| `vehicleOutNums` | `String` | 出发班次/车次 |
+| `vehicleInNums` | `String` | 返回班次/车次 |
+| `nativeTravelAgency` | `String` | 地接社名称 |
+| `teamType` | `Integer` | 团队类型 1=自组自接 2=包机 3=专列 4=其他 |
+| `peopleNums` | `Integer` | 团队人数 |
+| `childNums` | `Integer` | 儿童人数 |
+| `journeyDesc` | `String` | 行程总描述 |
+| `applicantName` | `String` | 申请人姓名 |
+| `applicantPhone` | `String` | 申请人电话 |
+| `guides` | `List<GuideInfo>` | 导游列表 |
+| `name` | `String` | 导游姓名 |
+| `cardId` | `String` | 电子导游证号 |
+| `phone` | `String` | 导游电话 |
+| `type` | `Integer` | 导游类型 1=全陪 2=地陪 |
+| `isLeader` | `Integer` | 是否领队 0=否 1=是 |
+| `busInfo` | `List<BusInfo>` | 车队列表 |
+| `carId` | `String` | 车牌号 |
+| `carComp` | `String` | 所属公司 |
+| `driverName` | `String` | 驾驶员姓名 |
+| `driverPhone` | `String` | 驾驶员联系电话 |
+| `itineraryList` | `List<ItineraryItem>` | 行程列表（按天按站点） |
+| `dayNumber` | `Integer` | 第几天 |
+| `siteNum` | `Integer` | 当天第几个站点 |
+| `date` | `String` | 具体日期 yyyy-MM-dd |
+| `city` | `String` | 前往城市 |
+| `province` | `String` | 前往省份 |
+| `journeyDesc` | `String` | 站点行程描述 |
+| `title` | `String` | 站点标题 |
+| `isTransit` | `Integer` | 是否过境 0=否 1=是 |
+| `touristList` | `List<TouristInfo>` | 游客列表 |
+| `name` | `String` | 姓名 |
+| `pyFamilyName` | `String` | 姓拼音 |
+| `pyGivenName` | `String` | 名拼音 |
+| `dateOfBirth` | `String` | 出生日期 yyyy-MM-dd |
+| `phoneNum` | `String` | 联系方式 |
+| `sex` | `Integer` | 性别 0=男 1=女 |
+| `age` | `Integer` | 年龄 |
+| `isChild` | `Integer` | 是否儿童 0=否 1=是 |
+| `hrProvince` | `String` | 户籍所在省 |
+| `cardType` | `Integer` | 证件类型 1=身份证 2=护照 |
+| `cardId` | `String` | 证件号码 |
+| `cardValidTo` | `String` | 证件有效期至 yyyy-MM-dd |
+
+**响应** `Result<TeamReportVO>`
+
+### 🆕 `POST` /admin/team-report/submit — 提交到12301平台
+
+**请求体** `TeamReportFormDTO`
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `orderId` | `Long` | 订单ID |
+| `agencyCode` | `String` | 旅行社编码 hulai/qianshou/hulai-wenlu |
+| `businessType` | `Integer` | 业务类型 2=国内游组团 6=入境接待 7=国内接待 |
+| `agencyName` | `String` | 旅行社名称 |
+| `agencyLicense` | `String` | 经营许可证号 |
+| `itineraryName` | `String` | 线路名称 |
+| `teamId` | `String` | 团号 |
+| `dateGo` | `String` | 出发日期 yyyy-MM-dd |
+| `timeGoHour` | `String` | 出发时间 HH |
+| `timeGoMinute` | `String` | 出发时间 mm |
+| `dateBack` | `String` | 返回日期 yyyy-MM-dd |
+| `timeBackHour` | `String` | 返回时间 HH |
+| `timeBackMinute` | `String` | 返回时间 mm |
+| `sourceCity` | `String` | 出发城市 |
+| `sourceProvince` | `String` | 出发省份 |
+| `destinationCity` | `String` | 前往城市 |
+| `destinationProvince` | `String` | 前往省份 |
+| `itineraryDay` | `Integer` | 天数 |
+| `vehicle` | `Integer` | 出发交通 1=飞机 2=火车 3=轮船 4=汽车 5=其它 |
+| `vehicleIn` | `Integer` | 返回交通 1=飞机 2=火车 3=轮船 4=汽车 5=其它 |
+| `vehicleOutNums` | `String` | 出发班次/车次 |
+| `vehicleInNums` | `String` | 返回班次/车次 |
+| `nativeTravelAgency` | `String` | 地接社名称 |
+| `teamType` | `Integer` | 团队类型 1=自组自接 2=包机 3=专列 4=其他 |
+| `peopleNums` | `Integer` | 团队人数 |
+| `childNums` | `Integer` | 儿童人数 |
+| `journeyDesc` | `String` | 行程总描述 |
+| `applicantName` | `String` | 申请人姓名 |
+| `applicantPhone` | `String` | 申请人电话 |
+| `guides` | `List<GuideInfo>` | 导游列表 |
+| `name` | `String` | 导游姓名 |
+| `cardId` | `String` | 电子导游证号 |
+| `phone` | `String` | 导游电话 |
+| `type` | `Integer` | 导游类型 1=全陪 2=地陪 |
+| `isLeader` | `Integer` | 是否领队 0=否 1=是 |
+| `busInfo` | `List<BusInfo>` | 车队列表 |
+| `carId` | `String` | 车牌号 |
+| `carComp` | `String` | 所属公司 |
+| `driverName` | `String` | 驾驶员姓名 |
+| `driverPhone` | `String` | 驾驶员联系电话 |
+| `itineraryList` | `List<ItineraryItem>` | 行程列表（按天按站点） |
+| `dayNumber` | `Integer` | 第几天 |
+| `siteNum` | `Integer` | 当天第几个站点 |
+| `date` | `String` | 具体日期 yyyy-MM-dd |
+| `city` | `String` | 前往城市 |
+| `province` | `String` | 前往省份 |
+| `journeyDesc` | `String` | 站点行程描述 |
+| `title` | `String` | 站点标题 |
+| `isTransit` | `Integer` | 是否过境 0=否 1=是 |
+| `touristList` | `List<TouristInfo>` | 游客列表 |
+| `name` | `String` | 姓名 |
+| `pyFamilyName` | `String` | 姓拼音 |
+| `pyGivenName` | `String` | 名拼音 |
+| `dateOfBirth` | `String` | 出生日期 yyyy-MM-dd |
+| `phoneNum` | `String` | 联系方式 |
+| `sex` | `Integer` | 性别 0=男 1=女 |
+| `age` | `Integer` | 年龄 |
+| `isChild` | `Integer` | 是否儿童 0=否 1=是 |
+| `hrProvince` | `String` | 户籍所在省 |
+| `cardType` | `Integer` | 证件类型 1=身份证 2=护照 |
+| `cardId` | `String` | 证件号码 |
+| `cardValidTo` | `String` | 证件有效期至 yyyy-MM-dd |
+
+**响应** `Result<TeamReportVO>`
+
+### ❌ ~~`POST` /admin/team-report/sync — 同步团队信息到监管平台~~
+
+### 接口名称更新
+
+| 方法 | 路径 | 原名称 → 新名称 |
+| --- | --- | --- |
+| `GET` | `/admin/team-report/{orderId}` | 获取同步记录 → **获取同步记录（含表单数据）** |
+
+---
+
+<details>
+<summary>📁 全部变更文件 (点击展开)</summary>
+
+```
+M	hl-order-service/src/main/java/com/hulalv/teamreport/builder/TeamReportRequestBuilder.java
+M	hl-order-service/src/main/java/com/hulalv/teamreport/controller/AdminTeamReportController.java
+A	hl-order-service/src/main/java/com/hulalv/teamreport/dto/TeamReportFormDTO.java
+M	hl-order-service/src/main/java/com/hulalv/teamreport/entity/TeamReport.java
+M	hl-order-service/src/main/java/com/hulalv/teamreport/service/TeamReportService.java
+M	sql/team_report.sql
+```
+</details>