From 8feb0abfb96e5810d9267e2f8b92bcf45656db3f Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Tue, 17 Mar 2026 15:40:15 +0800 Subject: [PATCH] =?UTF-8?q?changelog:=20e6c349d=20-=20feat:=20=E5=AE=9A?= =?UTF-8?q?=E5=88=B6=E9=9C=80=E6=B1=82=E6=A8=A1=E5=9D=97+=E7=AE=A1?= =?UTF-8?q?=E7=90=86=E5=91=98=E5=8F=91=E7=A5=A8=E7=AE=A1=E7=90=86=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3+Knife4j=E5=88=86=E7=BB=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../2026-03/2026-03-17_1540_e6c349d_feat.md | 623 ++++++++++++++++++ 1 file changed, 623 insertions(+) create mode 100644 changelogs/2026-03/2026-03-17_1540_e6c349d_feat.md diff --git a/changelogs/2026-03/2026-03-17_1540_e6c349d_feat.md b/changelogs/2026-03/2026-03-17_1540_e6c349d_feat.md new file mode 100644 index 0000000..4e6307d --- /dev/null +++ b/changelogs/2026-03/2026-03-17_1540_e6c349d_feat.md @@ -0,0 +1,623 @@ +# 接口变更记录 — 2026-03-17 15:40 + +> **提交** `e6c349d` · **作者** wx · **时间** 2026-03-17 15:40:15 +0800 +> +> feat: 定制需求模块+管理员发票管理接口+Knife4j分组 + +## 变更总览 + +- **订单服务** + - 🆕 AdminInvoice (+5 接口) + - 🆕 AdminCustomize (+5 接口) + - 🆕 InternalCustomize (+4 接口) + +--- + +## 订单服务 + +### 🆕 新增: AdminInvoice + +#### `GET` /admin/invoice/page — 发票分页列表 + +**响应** `Result>` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `id` | `String` | 发票ID | +| `orderId` | `String` | 订单ID | +| `orderNo` | `String` | 订单号 | +| `amount` | `String` | 金额 | +| `titleType` | `String` | 抬头类型（personal=个人/company=企业） | +| `invoiceTitle` | `String` | 发票抬头 | +| `taxNumber` | `String` | 税号 | +| `email` | `String` | 接收邮箱 | +| `invoiceType` | `String` | 发票类型 | +| `invoiceContent` | `String` | 发票内容 | +| `status` | `String` | 发票状态 | +| `fileUrl` | `String` | 发票文件URL | +| `failReason` | `String` | 失败原因 | +| `contactPhone` | `String` | 联系电话 | +| `remark` | `String` | 备注信息 | +| `bankName` | `String` | 开户行（企业发票） | +| `bankAccount` | `String` | 银行账号（企业发票） | +| `companyAddress` | `String` | 企业地址（企业发票） | +| `companyPhone` | `String` | 企业电话（企业发票） | +| `invoiceNo` | `String` | 发票号码 | +| `issuedAt` | `LocalDateTime` | 开票时间 | +| `issuedBy` | `String` | 开票操作人ID | +| `userId` | `String` | 用户ID | +| `originalInvoiceId` | `String` | 原发票ID(换开时关联) | +| `reissueCount` | `Integer` | 换开次数 | +| `createdAt` | `LocalDateTime` | 创建时间 | +| `updatedAt` | `LocalDateTime` | 更新时间 | + +#### `GET` /admin/invoice/{id} — 发票详情 + +**参数** + + - `{id}` (Long) — 路径参数 + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `id` | `String` | 发票ID | +| `orderId` | `String` | 订单ID | +| `orderNo` | `String` | 订单号 | +| `amount` | `String` | 金额 | +| `titleType` | `String` | 抬头类型（personal=个人/company=企业） | +| `invoiceTitle` | `String` | 发票抬头 | +| `taxNumber` | `String` | 税号 | +| `email` | `String` | 接收邮箱 | +| `invoiceType` | `String` | 发票类型 | +| `invoiceContent` | `String` | 发票内容 | +| `status` | `String` | 发票状态 | +| `fileUrl` | `String` | 发票文件URL | +| `failReason` | `String` | 失败原因 | +| `contactPhone` | `String` | 联系电话 | +| `remark` | `String` | 备注信息 | +| `bankName` | `String` | 开户行（企业发票） | +| `bankAccount` | `String` | 银行账号（企业发票） | +| `companyAddress` | `String` | 企业地址（企业发票） | +| `companyPhone` | `String` | 企业电话（企业发票） | +| `invoiceNo` | `String` | 发票号码 | +| `issuedAt` | `LocalDateTime` | 开票时间 | +| `issuedBy` | `String` | 开票操作人ID | +| `userId` | `String` | 用户ID | +| `originalInvoiceId` | `String` | 原发票ID(换开时关联) | +| `reissueCount` | `Integer` | 换开次数 | +| `createdAt` | `LocalDateTime` | 创建时间 | +| `updatedAt` | `LocalDateTime` | 更新时间 | + +#### `PUT` /admin/invoice/{id}/issue — 开票完成 + +**参数** + + - `{id}` (Long) — 路径参数 + +**请求体** `AdminInvoiceIssueRequest` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `fileUrl` | `String` | 发票文件URL | +| `invoiceNo` | `String` | 发票号码 | + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `id` | `String` | 发票ID | +| `orderId` | `String` | 订单ID | +| `orderNo` | `String` | 订单号 | +| `amount` | `String` | 金额 | +| `titleType` | `String` | 抬头类型（personal=个人/company=企业） | +| `invoiceTitle` | `String` | 发票抬头 | +| `taxNumber` | `String` | 税号 | +| `email` | `String` | 接收邮箱 | +| `invoiceType` | `String` | 发票类型 | +| `invoiceContent` | `String` | 发票内容 | +| `status` | `String` | 发票状态 | +| `fileUrl` | `String` | 发票文件URL | +| `failReason` | `String` | 失败原因 | +| `contactPhone` | `String` | 联系电话 | +| `remark` | `String` | 备注信息 | +| `bankName` | `String` | 开户行（企业发票） | +| `bankAccount` | `String` | 银行账号（企业发票） | +| `companyAddress` | `String` | 企业地址（企业发票） | +| `companyPhone` | `String` | 企业电话（企业发票） | +| `invoiceNo` | `String` | 发票号码 | +| `issuedAt` | `LocalDateTime` | 开票时间 | +| `issuedBy` | `String` | 开票操作人ID | +| `userId` | `String` | 用户ID | +| `originalInvoiceId` | `String` | 原发票ID(换开时关联) | +| `reissueCount` | `Integer` | 换开次数 | +| `createdAt` | `LocalDateTime` | 创建时间 | +| `updatedAt` | `LocalDateTime` | 更新时间 | + +#### `PUT` /admin/invoice/{id}/fail — 开票失败 + +**参数** + + - `{id}` (Long) — 路径参数 + +**请求体** `AdminInvoiceFailRequest` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `failReason` | `String` | 失败原因 | + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `id` | `String` | 发票ID | +| `orderId` | `String` | 订单ID | +| `orderNo` | `String` | 订单号 | +| `amount` | `String` | 金额 | +| `titleType` | `String` | 抬头类型（personal=个人/company=企业） | +| `invoiceTitle` | `String` | 发票抬头 | +| `taxNumber` | `String` | 税号 | +| `email` | `String` | 接收邮箱 | +| `invoiceType` | `String` | 发票类型 | +| `invoiceContent` | `String` | 发票内容 | +| `status` | `String` | 发票状态 | +| `fileUrl` | `String` | 发票文件URL | +| `failReason` | `String` | 失败原因 | +| `contactPhone` | `String` | 联系电话 | +| `remark` | `String` | 备注信息 | +| `bankName` | `String` | 开户行（企业发票） | +| `bankAccount` | `String` | 银行账号（企业发票） | +| `companyAddress` | `String` | 企业地址（企业发票） | +| `companyPhone` | `String` | 企业电话（企业发票） | +| `invoiceNo` | `String` | 发票号码 | +| `issuedAt` | `LocalDateTime` | 开票时间 | +| `issuedBy` | `String` | 开票操作人ID | +| `userId` | `String` | 用户ID | +| `originalInvoiceId` | `String` | 原发票ID(换开时关联) | +| `reissueCount` | `Integer` | 换开次数 | +| `createdAt` | `LocalDateTime` | 创建时间 | +| `updatedAt` | `LocalDateTime` | 更新时间 | + +#### `PUT` /admin/invoice/{id}/void — 作废发票 + +**参数** + + - `{id}` (Long) — 路径参数 + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `id` | `String` | 发票ID | +| `orderId` | `String` | 订单ID | +| `orderNo` | `String` | 订单号 | +| `amount` | `String` | 金额 | +| `titleType` | `String` | 抬头类型（personal=个人/company=企业） | +| `invoiceTitle` | `String` | 发票抬头 | +| `taxNumber` | `String` | 税号 | +| `email` | `String` | 接收邮箱 | +| `invoiceType` | `String` | 发票类型 | +| `invoiceContent` | `String` | 发票内容 | +| `status` | `String` | 发票状态 | +| `fileUrl` | `String` | 发票文件URL | +| `failReason` | `String` | 失败原因 | +| `contactPhone` | `String` | 联系电话 | +| `remark` | `String` | 备注信息 | +| `bankName` | `String` | 开户行（企业发票） | +| `bankAccount` | `String` | 银行账号（企业发票） | +| `companyAddress` | `String` | 企业地址（企业发票） | +| `companyPhone` | `String` | 企业电话（企业发票） | +| `invoiceNo` | `String` | 发票号码 | +| `issuedAt` | `LocalDateTime` | 开票时间 | +| `issuedBy` | `String` | 开票操作人ID | +| `userId` | `String` | 用户ID | +| `originalInvoiceId` | `String` | 原发票ID(换开时关联) | +| `reissueCount` | `Integer` | 换开次数 | +| `createdAt` | `LocalDateTime` | 创建时间 | +| `updatedAt` | `LocalDateTime` | 更新时间 | + +### 🆕 新增: AdminCustomize + +#### `GET` /admin/order/customize/page — 定制请求列表 + +**响应** `Result>` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `requestId` | `Long` | 请求ID | +| `userId` | `Long` | 用户ID | +| `destination` | `String` | 目标地区 | +| `travelPurpose` | `String` | 旅游目的（字典：travel_purpose） | +| `requestType` | `String` | 需求类型（字典：customize_request_type） | +| `startDate` | `LocalDate` | 期望出发日期 | +| `days` | `Integer` | 期望天数 | +| `adultCount` | `Integer` | 成人数 | +| `childCount` | `Integer` | 儿童数 | +| `budget` | `String` | 预算范围（字典：customize_budget） | +| `status` | `String` | 状态（字典：customize_request_status） | +| `statusLabel` | `String` | 状态标签 | +| `designerName` | `String` | 定制师姓名 | +| `designerAvatar` | `String` | 定制师头像 | +| `createTime` | `LocalDateTime` | 创建时间 | + +#### `GET` /admin/order/customize/{requestId} — 定制请求详情 + +**参数** + + - `{requestId}` (Long) — 路径参数 + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `requestId` | `Long` | 请求ID | +| `userId` | `Long` | 用户ID | +| `designerId` | `Long` | 指定定制师ID | +| `destination` | `String` | 目标地区 | +| `travelPurpose` | `String` | 旅游目的（字典：travel_purpose） | +| `requestType` | `String` | 需求类型（字典：customize_request_type） | +| `startDate` | `LocalDate` | 期望出发日期 | +| `endDate` | `LocalDate` | 期望结束日期 | +| `days` | `Integer` | 期望天数 | +| `adultCount` | `Integer` | 成人数 | +| `childCount` | `Integer` | 儿童数 | +| `budget` | `String` | 预算范围（字典：customize_budget） | +| `requirements` | `String` | 详细需求描述 | +| `contactPhone` | `String` | 联系电话 | +| `contactName` | `String` | 联系人 | +| `status` | `String` | 状态（字典：customize_request_status） | +| `statusLabel` | `String` | 状态标签 | +| `designerName` | `String` | 定制师姓名 | +| `designerAvatar` | `String` | 定制师头像 | +| `productId` | `Long` | 关联产品ID | +| `reply` | `String` | 定制师回复 | +| `repliedAt` | `LocalDateTime` | 回复时间 | +| `createTime` | `LocalDateTime` | 创建时间 | +| `updateTime` | `LocalDateTime` | 更新时间 | + +#### `PUT` /admin/order/customize/{requestId}/accept — 接受定制请求 + +**参数** + + - `{requestId}` (Long) — 路径参数 + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `requestId` | `Long` | 请求ID | +| `userId` | `Long` | 用户ID | +| `designerId` | `Long` | 指定定制师ID | +| `destination` | `String` | 目标地区 | +| `travelPurpose` | `String` | 旅游目的（字典：travel_purpose） | +| `requestType` | `String` | 需求类型（字典：customize_request_type） | +| `startDate` | `LocalDate` | 期望出发日期 | +| `endDate` | `LocalDate` | 期望结束日期 | +| `days` | `Integer` | 期望天数 | +| `adultCount` | `Integer` | 成人数 | +| `childCount` | `Integer` | 儿童数 | +| `budget` | `String` | 预算范围（字典：customize_budget） | +| `requirements` | `String` | 详细需求描述 | +| `contactPhone` | `String` | 联系电话 | +| `contactName` | `String` | 联系人 | +| `status` | `String` | 状态（字典：customize_request_status） | +| `statusLabel` | `String` | 状态标签 | +| `designerName` | `String` | 定制师姓名 | +| `designerAvatar` | `String` | 定制师头像 | +| `productId` | `Long` | 关联产品ID | +| `reply` | `String` | 定制师回复 | +| `repliedAt` | `LocalDateTime` | 回复时间 | +| `createTime` | `LocalDateTime` | 创建时间 | +| `updateTime` | `LocalDateTime` | 更新时间 | + +#### `PUT` /admin/order/customize/{requestId}/reply — 回复/报价 + +**参数** + + - `{requestId}` (Long) — 路径参数 + +**请求体** `AdminReplyRequest` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `reply` | `String` | 回复内容 | +| `productId` | `Long` | 关联产品ID（定制产品已创建时传入） | + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `requestId` | `Long` | 请求ID | +| `userId` | `Long` | 用户ID | +| `designerId` | `Long` | 指定定制师ID | +| `destination` | `String` | 目标地区 | +| `travelPurpose` | `String` | 旅游目的（字典：travel_purpose） | +| `requestType` | `String` | 需求类型（字典：customize_request_type） | +| `startDate` | `LocalDate` | 期望出发日期 | +| `endDate` | `LocalDate` | 期望结束日期 | +| `days` | `Integer` | 期望天数 | +| `adultCount` | `Integer` | 成人数 | +| `childCount` | `Integer` | 儿童数 | +| `budget` | `String` | 预算范围（字典：customize_budget） | +| `requirements` | `String` | 详细需求描述 | +| `contactPhone` | `String` | 联系电话 | +| `contactName` | `String` | 联系人 | +| `status` | `String` | 状态（字典：customize_request_status） | +| `statusLabel` | `String` | 状态标签 | +| `designerName` | `String` | 定制师姓名 | +| `designerAvatar` | `String` | 定制师头像 | +| `productId` | `Long` | 关联产品ID | +| `reply` | `String` | 定制师回复 | +| `repliedAt` | `LocalDateTime` | 回复时间 | +| `createTime` | `LocalDateTime` | 创建时间 | +| `updateTime` | `LocalDateTime` | 更新时间 | + +#### `PUT` /admin/order/customize/{requestId}/complete — 标记完成 + +**参数** + + - `{requestId}` (Long) — 路径参数 + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `requestId` | `Long` | 请求ID | +| `userId` | `Long` | 用户ID | +| `designerId` | `Long` | 指定定制师ID | +| `destination` | `String` | 目标地区 | +| `travelPurpose` | `String` | 旅游目的（字典：travel_purpose） | +| `requestType` | `String` | 需求类型（字典：customize_request_type） | +| `startDate` | `LocalDate` | 期望出发日期 | +| `endDate` | `LocalDate` | 期望结束日期 | +| `days` | `Integer` | 期望天数 | +| `adultCount` | `Integer` | 成人数 | +| `childCount` | `Integer` | 儿童数 | +| `budget` | `String` | 预算范围（字典：customize_budget） | +| `requirements` | `String` | 详细需求描述 | +| `contactPhone` | `String` | 联系电话 | +| `contactName` | `String` | 联系人 | +| `status` | `String` | 状态（字典：customize_request_status） | +| `statusLabel` | `String` | 状态标签 | +| `designerName` | `String` | 定制师姓名 | +| `designerAvatar` | `String` | 定制师头像 | +| `productId` | `Long` | 关联产品ID | +| `reply` | `String` | 定制师回复 | +| `repliedAt` | `LocalDateTime` | 回复时间 | +| `createTime` | `LocalDateTime` | 创建时间 | +| `updateTime` | `LocalDateTime` | 更新时间 | + +### 🆕 新增: InternalCustomize + +#### `POST` /internal/mp/customize/submit — 提交定制请求 + +**参数** + + - `userId` (Long) — 查询参数 + +**请求体** `CreateCustomizeRequestDTO` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `designerId` | `Long` | 指定定制师ID（可为空=系统分配） | +| `destination` | `String` | 目标地区 | +| `travelPurpose` | `String` | 旅游目的（字典：travel_purpose） | +| `requestType` | `String` | 需求类型（字典：customize_request_type） | +| `startDate` | `LocalDate` | 期望出发日期 | +| `endDate` | `LocalDate` | 期望结束日期 | +| `days` | `Integer` | 期望天数 | +| `adultCount` | `Integer` | 成人数 | +| `childCount` | `Integer` | 儿童数 | +| `budget` | `String` | 预算范围（字典：customize_budget） | +| `requirements` | `String` | 详细需求描述 | +| `contactPhone` | `String` | 联系电话 | +| `contactName` | `String` | 联系人 | + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `requestId` | `Long` | 请求ID | +| `userId` | `Long` | 用户ID | +| `designerId` | `Long` | 指定定制师ID | +| `destination` | `String` | 目标地区 | +| `travelPurpose` | `String` | 旅游目的（字典：travel_purpose） | +| `requestType` | `String` | 需求类型（字典：customize_request_type） | +| `startDate` | `LocalDate` | 期望出发日期 | +| `endDate` | `LocalDate` | 期望结束日期 | +| `days` | `Integer` | 期望天数 | +| `adultCount` | `Integer` | 成人数 | +| `childCount` | `Integer` | 儿童数 | +| `budget` | `String` | 预算范围（字典：customize_budget） | +| `requirements` | `String` | 详细需求描述 | +| `contactPhone` | `String` | 联系电话 | +| `contactName` | `String` | 联系人 | +| `status` | `String` | 状态（字典：customize_request_status） | +| `statusLabel` | `String` | 状态标签 | +| `designerName` | `String` | 定制师姓名 | +| `designerAvatar` | `String` | 定制师头像 | +| `productId` | `Long` | 关联产品ID | +| `reply` | `String` | 定制师回复 | +| `repliedAt` | `LocalDateTime` | 回复时间 | +| `createTime` | `LocalDateTime` | 创建时间 | +| `updateTime` | `LocalDateTime` | 更新时间 | + +#### `GET` /internal/mp/customize/list — 定制请求列表 + +**参数** + + - `userId` (Long) — 查询参数 + - `page` (int) — 查询参数 + - `pageSize` (int) — 查询参数 + +**响应** `Result>` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `requestId` | `Long` | 请求ID | +| `userId` | `Long` | 用户ID | +| `destination` | `String` | 目标地区 | +| `travelPurpose` | `String` | 旅游目的（字典：travel_purpose） | +| `requestType` | `String` | 需求类型（字典：customize_request_type） | +| `startDate` | `LocalDate` | 期望出发日期 | +| `days` | `Integer` | 期望天数 | +| `adultCount` | `Integer` | 成人数 | +| `childCount` | `Integer` | 儿童数 | +| `budget` | `String` | 预算范围（字典：customize_budget） | +| `status` | `String` | 状态（字典：customize_request_status） | +| `statusLabel` | `String` | 状态标签 | +| `designerName` | `String` | 定制师姓名 | +| `designerAvatar` | `String` | 定制师头像 | +| `createTime` | `LocalDateTime` | 创建时间 | + +#### `GET` /internal/mp/customize/{requestId} — 定制请求详情 + +**参数** + + - `{requestId}` (Long) — 路径参数 + - `userId` (Long) — 查询参数 + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `requestId` | `Long` | 请求ID | +| `userId` | `Long` | 用户ID | +| `designerId` | `Long` | 指定定制师ID | +| `destination` | `String` | 目标地区 | +| `travelPurpose` | `String` | 旅游目的（字典：travel_purpose） | +| `requestType` | `String` | 需求类型（字典：customize_request_type） | +| `startDate` | `LocalDate` | 期望出发日期 | +| `endDate` | `LocalDate` | 期望结束日期 | +| `days` | `Integer` | 期望天数 | +| `adultCount` | `Integer` | 成人数 | +| `childCount` | `Integer` | 儿童数 | +| `budget` | `String` | 预算范围（字典：customize_budget） | +| `requirements` | `String` | 详细需求描述 | +| `contactPhone` | `String` | 联系电话 | +| `contactName` | `String` | 联系人 | +| `status` | `String` | 状态（字典：customize_request_status） | +| `statusLabel` | `String` | 状态标签 | +| `designerName` | `String` | 定制师姓名 | +| `designerAvatar` | `String` | 定制师头像 | +| `productId` | `Long` | 关联产品ID | +| `reply` | `String` | 定制师回复 | +| `repliedAt` | `LocalDateTime` | 回复时间 | +| `createTime` | `LocalDateTime` | 创建时间 | +| `updateTime` | `LocalDateTime` | 更新时间 | + +#### `POST` /internal/mp/customize/{requestId}/cancel — 取消定制请求 + +**参数** + + - `{requestId}` (Long) — 路径参数 + - `userId` (Long) — 查询参数 + +**响应** `Result` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `requestId` | `Long` | 请求ID | +| `userId` | `Long` | 用户ID | +| `designerId` | `Long` | 指定定制师ID | +| `destination` | `String` | 目标地区 | +| `travelPurpose` | `String` | 旅游目的（字典：travel_purpose） | +| `requestType` | `String` | 需求类型（字典：customize_request_type） | +| `startDate` | `LocalDate` | 期望出发日期 | +| `endDate` | `LocalDate` | 期望结束日期 | +| `days` | `Integer` | 期望天数 | +| `adultCount` | `Integer` | 成人数 | +| `childCount` | `Integer` | 儿童数 | +| `budget` | `String` | 预算范围（字典：customize_budget） | +| `requirements` | `String` | 详细需求描述 | +| `contactPhone` | `String` | 联系电话 | +| `contactName` | `String` | 联系人 | +| `status` | `String` | 状态（字典：customize_request_status） | +| `statusLabel` | `String` | 状态标签 | +| `designerName` | `String` | 定制师姓名 | +| `designerAvatar` | `String` | 定制师头像 | +| `productId` | `Long` | 关联产品ID | +| `reply` | `String` | 定制师回复 | +| `repliedAt` | `LocalDateTime` | 回复时间 | +| `createTime` | `LocalDateTime` | 创建时间 | +| `updateTime` | `LocalDateTime` | 更新时间 | + +--- + +## 📦 其他数据对象变更 + +> 以下变更未直接关联到本次接口变更，但可能影响现有接口的请求/响应 + +### 订单服务 + +#### 🆕 AdminCustomizeQueryRequest + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `keyword` | `String` | 搜索关键词（联系人/目标地区/需求描述） | +| `status` | `String` | 状态（字典：customize_request_status） | +| `designerId` | `Long` | 定制师ID | +| `sortBy` | `String` | 排序字段（createTime/startDate） | +| `sortDir` | `String` | 排序方向（desc/asc） | + +#### 🆕 AdminInvoiceQueryRequest + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `status` | `String` | 发票状态（字典：invoice_status） | +| `orderNo` | `String` | 订单编号（模糊搜索） | +| `userId` | `Long` | 用户ID | + +#### 🆕 CustomizeRequest + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `requestId` | `Long` | 请求ID | +| `userId` | `Long` | 用户ID | +| `designerId` | `Long` | 指定定制师ID（可为空=系统分配） | +| `destination` | `String` | 目标地区 | +| `travelPurpose` | `String` | 旅游目的 | +| `requestType` | `String` | 需求类型 | +| `startDate` | `LocalDate` | 期望出发日期 | +| `endDate` | `LocalDate` | 期望结束日期 | +| `days` | `Integer` | 期望天数 | +| `adultCount` | `Integer` | 成人数 | +| `childCount` | `Integer` | 儿童数 | +| `budget` | `String` | 预算范围 | +| `requirements` | `String` | 详细需求描述 | +| `contactPhone` | `String` | 联系电话 | +| `contactName` | `String` | 联系人 | +| `status` | `String` | 状态：PENDING/ACCEPTED/DESIGNING/QUOTED/COMPLETED/CANCELLED | +| `designerName` | `String` | 定制师姓名（冗余） | +| `designerAvatar` | `String` | 定制师头像（冗余） | +| `productId` | `Long` | 关联产品ID（定制师创建的定制产品） | +| `reply` | `String` | 定制师回复 | +| `repliedAt` | `LocalDateTime` | 回复时间 | +| `deletedAt` | `LocalDateTime` | 删除时间（软删除） | +| `createTime` | `LocalDateTime` | 创建时间 | +| `updateTime` | `LocalDateTime` | 更新时间 | + +
+📁 全部变更文件 (点击展开) + +``` +M hl-order-service/src/main/java/com/hulalv/order/OrderServiceApplication.java +M hl-order-service/src/main/java/com/hulalv/order/config/Knife4jConfig.java +A hl-order-service/src/main/java/com/hulalv/order/controller/AdminInvoiceController.java +A hl-order-service/src/main/java/com/hulalv/order/customize/constant/CustomizeConstants.java +A hl-order-service/src/main/java/com/hulalv/order/customize/controller/AdminCustomizeController.java +A hl-order-service/src/main/java/com/hulalv/order/customize/controller/InternalCustomizeController.java +A hl-order-service/src/main/java/com/hulalv/order/customize/dto/AdminCustomizeQueryRequest.java +A hl-order-service/src/main/java/com/hulalv/order/customize/dto/AdminReplyRequest.java +A hl-order-service/src/main/java/com/hulalv/order/customize/dto/CreateCustomizeRequestDTO.java +A hl-order-service/src/main/java/com/hulalv/order/customize/entity/CustomizeRequest.java +A hl-order-service/src/main/java/com/hulalv/order/customize/mapper/CustomizeRequestMapper.java +A hl-order-service/src/main/java/com/hulalv/order/customize/service/CustomizeRequestService.java +A hl-order-service/src/main/java/com/hulalv/order/customize/vo/CustomizeRequestListVO.java +A hl-order-service/src/main/java/com/hulalv/order/customize/vo/CustomizeRequestVO.java +A hl-order-service/src/main/java/com/hulalv/order/dto/AdminInvoiceFailRequest.java +A hl-order-service/src/main/java/com/hulalv/order/dto/AdminInvoiceIssueRequest.java +A hl-order-service/src/main/java/com/hulalv/order/dto/AdminInvoiceQueryRequest.java +A sql/customize_request.sql +``` +
\ No newline at end of file