diff --git a/changelogs/2026-03/2026-03-16_522a737_feat_Knife4j.md b/changelogs/2026-03/2026-03-16_522a737_feat_Knife4j.md index 315a105..21a23f5 100644 --- a/changelogs/2026-03/2026-03-16_522a737_feat_Knife4j.md +++ b/changelogs/2026-03/2026-03-16_522a737_feat_Knife4j.md @@ -7,28 +7,17 @@ ## ⚡ 接口变更速览 - **产品服务** - - ✏️ **District** 修改1个接口 - - ✏️ **Family** 修改2个接口 - - ✏️ **Formula** 修改13个接口 - - ✏️ **GroupBatch** 修改7个接口 - - ✏️ **InternalMpProduct** 修改4个接口 - - ✏️ **InternalProduct** 修改16个接口 - - ✏️ **Itinerary** 修改9个接口 + - ✏️ **InternalProduct** 修改14个接口 - ✏️ **MpProduct** 修改3个接口 - - ✏️ **Pricing** 修改3个接口 - - ✏️ **Product** 修改2个接口 - - ✏️ **ProductFolder** 修改1个接口 - - ✏️ **ProductLine** 修改2个接口 + - ✏️ **Product** 修改1个接口 - ✏️ **Quote** 修改1个接口 - **任务服务** - - ✏️ **Board** 修改9个接口 + - ✏️ **Board** 修改8个接口 - ✏️ **Task** 修改9个接口 - **企微回调服务** - ✏️ **WxCallback** 修改4个接口 - **保险服务** - ✏️ **AdminInsurance** 修改3个接口 - - ✏️ **AdminInsuranceScheme** 修改2个接口 - - ✏️ **InternalInsurance** 修改1个接口 - **合同服务** - ✏️ **AdminClauseTemplate** 修改4个接口 - ✏️ **AdminContract** 修改10个接口 @@ -36,117 +25,118 @@ - ✏️ **InternalContract** 修改4个接口 - ✏️ **InternalMpContract** 修改4个接口 - **小程序聚合服务** + - ✏️ **MpBadge** 修改1个接口 - ✏️ **MpContract** 修改4个接口 - ✏️ **MpDesigner** 修改2个接口 - ✏️ **MpDict** 修改1个接口 - - ✏️ **MpExplore** 修改6个接口 + - ✏️ **MpExplore** 修改5个接口 - ✏️ **MpFavorite** 修改1个接口 - ✏️ **MpFootprint** 修改1个接口 + - ✏️ **MpHome** 修改1个接口 - ✏️ **MpInsurance** 修改1个接口 - ✏️ **MpInvoice** 修改3个接口 - ✏️ **MpOrder** 修改5个接口 - ✏️ **MpPayment** 修改2个接口 - ✏️ **MpProduct** 修改4个接口 - ✏️ **MpRefund** 修改4个接口 - - ✏️ **MpReview** 修改7个接口 - - ✏️ **MpTraveler** 修改2个接口 + - ✏️ **MpReview** 修改6个接口 + - ✏️ **MpSearch** 修改1个接口 + - ✏️ **MpTraveler** 修改3个接口 - ✏️ **MpTrip** 修改3个接口 - ✏️ **MpUser** 修改3个接口 - ✏️ **MpWeather** 修改3个接口 - - ✏️ **MpWiki** 修改2个接口 + - ✏️ **MpWiki** 修改1个接口 + - ✏️ **MpWish** 修改2个接口 - **支付服务** - ✏️ **AdminPayment** 修改2个接口 - ✏️ **InternalPayment** 修改3个接口 - ✏️ **PaymentCallback** 修改1个接口 - **攻略服务** - - ✏️ **AdminGuideArticle** 修改6个接口 + - ✏️ **AdminGuideArticle** 修改5个接口 - ✏️ **AdminGuideCategory** 修改4个接口 - - ✏️ **AdminGuideTag** 修改4个接口 + - ✏️ **AdminGuideTag** 修改3个接口 - ✏️ **InternalWiki** 修改2个接口 - **文件服务** - ✏️ **File** 修改8个接口 - - ✏️ **InternalFile** 修改8个接口 + - ✏️ **InternalFile** 修改7个接口 - ✏️ **MpFile** 修改1个接口 - **用户服务** - - ✏️ **AdminAgreement** 修改3个接口 - - ✏️ **AdminBanner** 修改3个接口 - - ✏️ **AdminContact** 修改3个接口 + - ✏️ **AdminAgreement** 修改1个接口 + - ✏️ **AdminBanner** 修改1个接口 + - ✏️ **AdminContact** 修改4个接口 - ✏️ **AdminCustomer** 修改4个接口 - ✏️ **AdminDesigner** 修改3个接口 - - ✏️ **AdminExploreCategory** 修改2个接口 - - ✏️ **AdminFaq** 修改6个接口 - - ✏️ **AdminFrontendConfig** 修改4个接口 + - ✏️ **AdminExploreCategory** 修改1个接口 + - ✏️ **AdminFrontendConfig** 修改1个接口 - ✏️ **AdminProfile** 修改4个接口 - - ✏️ **AdminTopic** 修改3个接口 - - ✏️ **AdminUser** 修改7个接口 + - ✏️ **AdminTopic** 修改1个接口 + - ✏️ **AdminUser** 修改8个接口 - ✏️ **Auth** 修改13个接口 - - ✏️ **Favorite** 修改2个接口 - - ✏️ **Footprint** 修改2个接口 + - ✏️ **Favorite** 修改3个接口 + - ✏️ **Footprint** 修改3个接口 - ✏️ **InternalApproval** 修改3个接口 - - ✏️ **InternalBadge** 修改1个接口 - ✏️ **InternalContact** 修改1个接口 - - ✏️ **InternalDesigner** 修改1个接口 - - ✏️ **InternalExploreCategory** 修改2个接口 - - ✏️ **InternalLike** 修改4个接口 + - ✏️ **InternalExploreCategory** 修改1个接口 + - ✏️ **InternalLike** 修改3个接口 - ✏️ **InternalLoginLog** 修改1个接口 - - ✏️ **InternalMpCommon** 修改2个接口 - ✏️ **InternalMpDict** 修改2个接口 - - ✏️ **InternalMpMessage** 修改6个接口 - - ✏️ **InternalMpUser** 修改19个接口 - - ✏️ **InternalOrderUser** 修改1个接口 + - ✏️ **InternalMpMessage** 修改4个接口 + - ✏️ **InternalMpUser** 修改9个接口 - ✏️ **InternalUser** 修改8个接口 - - ✏️ **InternalWechat** 修改6个接口 - - ✏️ **InternalWish** 修改1个接口 + - ✏️ **InternalWechat** 修改5个接口 + - ✏️ **InternalWish** 修改2个接口 - ✏️ **PublicDict** 修改1个接口 - ✏️ **SysDict** 修改12个接口 - ✏️ **SysJob** 修改7个接口 - - ✏️ **SysMenu** 修改5个接口 - - ✏️ **SysRole** 修改6个接口 - - ✏️ **Traveler** 修改4个接口 + - ✏️ **SysMenu** 修改3个接口 + - ✏️ **SysRole** 修改7个接口 + - ✏️ **Traveler** 修改5个接口 - ✏️ **User** 修改8个接口 - ✏️ **WechatSync** 修改5个接口 - - ✏️ **AdminNotification** 修改4个接口 + - ✏️ **AdminNotification** 修改3个接口 - **监控服务** - - ✏️ **ApprovalLog** 修改1个接口 + - ✏️ **ApprovalLog** 修改2个接口 - ✏️ **DataRetention** 修改1个接口 - ✏️ **ErrorLog** 修改1个接口 - ✏️ **InternalLog** 修改5个接口 - - ✏️ **MysqlMonitor** 修改2个接口 + - ✏️ **LoginLog** 修改1个接口 + - ✏️ **MysqlMonitor** 修改3个接口 - ✏️ **NotificationLog** 修改1个接口 - ✏️ **OperationLog** 修改1个接口 - - ✏️ **RocketMqMonitor** 修改2个接口 + - ✏️ **RedisMonitor** 修改1个接口 + - ✏️ **RocketMqMonitor** 修改3个接口 + - ✏️ **ServiceMonitor** 修改1个接口 - **素材服务** - ✏️ **InternalMaterial** 修改4个接口 - ✏️ **MaterialCategoryPermission** 修改2个接口 - ✏️ **Material** 修改13个接口 - - ✏️ **MaterialTag** 修改1个接口 - ✏️ **MpMaterial** 修改1个接口 - **订单服务** - ✏️ **AdminAlbum** 修改7个接口 - - ✏️ **AdminEarlyBird** 修改5个接口 + - ✏️ **AdminEarlyBird** 修改6个接口 - ✏️ **AdminOrderConfig** 修改2个接口 - - ✏️ **AdminOrder** 修改13个接口 - - ✏️ **AdminOrderItinerary** 修改17个接口 + - ✏️ **AdminOrder** 修改12个接口 + - ✏️ **AdminOrderItinerary** 修改16个接口 - ✏️ **AdminOrderTodo** 修改7个接口 - ✏️ **AdminRefund** 修改6个接口 - ✏️ **AdminRefundPolicy** 修改3个接口 - ✏️ **AdminWorkOrder** 修改8个接口 - ✏️ **InternalAlbum** 修改3个接口 - - ✏️ **InternalDashboard** 修改10个接口 - - ✏️ **InternalDesignerOrder** 修改4个接口 + - ✏️ **InternalDashboard** 修改9个接口 + - ✏️ **InternalDesignerOrder** 修改3个接口 - ✏️ **InternalEarlyBird** 修改2个接口 - - ✏️ **InternalInvoice** 修改4个接口 - - ✏️ **InternalMpOrder** 修改9个接口 - - ✏️ **InternalMpTrip** 修改4个接口 + - ✏️ **InternalInvoice** 修改3个接口 + - ✏️ **InternalMpOrder** 修改8个接口 + - ✏️ **InternalMpTrip** 修改3个接口 - ✏️ **InternalOrderStats** 修改3个接口 - - ✏️ **InternalOrderTraveler** 修改2个接口 + - ✏️ **InternalOrderTraveler** 修改1个接口 - ✏️ **InternalPaymentOrder** 修改4个接口 - ✏️ **InternalRefund** 修改8个接口 - ✏️ **MpOrder** 修改2个接口 - ✏️ **MpWeather** 修改3个接口 - **评价服务** - ✏️ **AdminReview** 修改5个接口 - - ✏️ **InternalMpReview** 修改8个接口 + - ✏️ **InternalMpReview** 修改5个接口 - ✏️ **InternalReview** 修改6个接口 - **资源服务** - ✏️ **Activity** 修改9个接口 @@ -182,7 +172,7 @@ - ✏️ **ServicePriceCalendar** 修改4个接口 - ✏️ **ServiceTag** 修改8个接口 - ✏️ **InternalStaff** 修改6个接口 - - ✏️ **Staff** 修改8个接口 + - ✏️ **Staff** 修改9个接口 - ✏️ **StaffPriceCalendar** 修改4个接口 - ✏️ **StaffTag** 修改8个接口 - ✏️ **InternalSupplies** 修改3个接口 @@ -197,85 +187,6 @@ ## 产品服务 -### ✏️ District (修改) - -**修改接口：** - -- `GET /admin/product/district/admin/product/district` - - - 参数变化: `['@RequestParam keywords']` → `[]` - -### ✏️ Family (修改) - -**修改接口：** - -- `GET /admin/product/item/{productId}/admin/product/item/{productId}` - - - 参数变化: `['@PathVariable productId']` → `[]` -- `GET /admin/product/item/{productId}/families` - 获取家庭分组列表 - - 参数变化: `['@PathVariable productId', '@PathVariable productId', '@RequestBody request']` → `['@PathVariable productId']` - -### ✏️ Formula (修改) - -**修改接口：** - -- `GET /admin/product/formula/group/list` - 公式组列表 - - 参数变化: `['@RequestParam productType', '@PathVariable groupId']` → `['@RequestParam productType']` -- `GET /admin/product/formula/group/{groupId}` - 公式组详情 - - 参数变化: `['@PathVariable groupId', '@RequestBody request']` → `['@PathVariable groupId']` -- `POST /admin/product/formula/group` - 创建公式组 - - 参数变化: `['@RequestBody request', '@PathVariable groupId']` → `['@RequestBody request']` -- `PUT /admin/product/formula/group/{groupId}` - 更新公式组 - - 参数变化: `['@PathVariable groupId', '@RequestBody request', '@PathVariable groupId']` → `['@PathVariable groupId', '@RequestBody request']` -- `PUT /admin/product/formula/group/{groupId}/activate` - 激活公式组 - - 参数变化: `['@PathVariable groupId', '@PathVariable groupId']` → `['@PathVariable groupId']` -- `GET /admin/product/formula/step/{formulaId}` - 公式步骤详情 - - 参数变化: `['@PathVariable formulaId', '@RequestBody request']` → `['@PathVariable formulaId']` -- `POST /admin/product/formula/step` - 创建公式步骤 - - 参数变化: `['@RequestBody request', '@PathVariable formulaId', '@RequestBody request']` → `['@RequestBody request', '@PathVariable formulaId']` -- `PUT /admin/product/formula/step/{formulaId}/toggle` - 启用/禁用公式步骤 - - 参数变化: `['@PathVariable formulaId', '@PathVariable formulaId']` → `['@PathVariable formulaId']` -- `DELETE /admin/product/formula/step/{formulaId}` - 删除公式步骤 - - 参数变化: `['@PathVariable formulaId', '@PathVariable formulaId']` → `['@PathVariable formulaId']` -- `GET /admin/product/formula/step/{formulaId}/versions` - 公式步骤版本历史 - - 参数变化: `['@PathVariable formulaId', '@PathVariable formulaId', '@PathVariable versionNum']` → `['@PathVariable formulaId', '@PathVariable formulaId']` -- `GET /admin/product/formula/var/list` - 公式变量列表 - - 参数变化: `['@RequestParam category', '@RequestBody request']` → `['@RequestParam category']` -- `POST /admin/product/formula/var` - 创建公式变量 - - 参数变化: `['@RequestBody request', '@PathVariable varId', '@RequestBody request']` → `['@RequestBody request']` -- `PUT /admin/product/formula/var/{varId}` - 更新公式变量 - - 参数变化: `['@PathVariable varId', '@RequestBody request', '@PathVariable varId']` → `['@PathVariable varId', '@RequestBody request']` - -### ✏️ GroupBatch (修改) - -**修改接口：** - -- `PUT /admin/product/item/{productId}/batch/{batchId}` - 更新批次 - - 参数变化: `['@PathVariable productId', '@PathVariable batchId', '@RequestBody request', '@PathVariable productId', '@PathVariable batchId']` → `['@PathVariable productId', '@PathVariable batchId', '@RequestBody request']` -- `DELETE /admin/product/item/{productId}/batch/{batchId}` - 删除批次 - - 参数变化: `['@PathVariable productId', '@PathVariable batchId', '@PathVariable productId']` → `['@PathVariable productId', '@PathVariable batchId']` -- `GET /admin/product/item/{productId}/batch/list` - 批次列表(树形) - - 参数变化: `['@PathVariable productId', '@PathVariable productId', '@PathVariable batchId']` → `['@PathVariable productId']` -- `PUT /admin/product/item/{productId}/batch/{batchId}/open` - 开启报名(PENDING->ENROLLING) - - 参数变化: `['@PathVariable productId', '@PathVariable batchId', '@PathVariable productId', '@PathVariable batchId']` → `['@PathVariable productId', '@PathVariable batchId']` -- `PUT /admin/product/item/{productId}/batch/{batchId}/close` - 关闭报名(ENROLLING/CONFIRMED->CLOSED) - - 参数变化: `['@PathVariable productId', '@PathVariable batchId', '@PathVariable productId', '@PathVariable batchId']` → `['@PathVariable productId', '@PathVariable batchId']` -- `POST /admin/product/item/{productId}/batch/{batchId}/staff` - 保存服务人员(全量替换) - - 参数变化: `['@PathVariable productId', '@PathVariable batchId', '@RequestBody List', '@PathVariable productId']` → `['@PathVariable productId', '@PathVariable batchId', '@RequestBody List']` -- `GET /admin/product/item/{productId}/batch/{batchId}/staff` - 服务人员列表 - - 参数变化: `['@PathVariable productId', '@PathVariable batchId', '@PathVariable productId', '@PathVariable batchId']` → `['@PathVariable productId', '@PathVariable batchId']` - -### ✏️ InternalMpProduct (修改) - -**修改接口：** - -- `GET /internal/mp/product/list` - 产品列表 - - 参数变化: `['@PathVariable productId']` → `[]` -- `GET /internal/mp/product/{productId}` - 产品详情 - - 参数变化: `['@PathVariable productId', '@PathVariable productId', '@RequestBody request']` → `['@PathVariable productId', '@PathVariable productId']` -- `GET /internal/mp/product/lines` - 产品线列表（活跃） - - 参数变化: `['@RequestParam limit']` → `[]` -- `GET /internal/mp/product/recommend` - 推荐产品列表 - - 参数变化: `['@RequestParam limit', '@PathVariable productId']` → `['@RequestParam limit']` - ### ✏️ InternalProduct (修改) **修改接口：** @@ -307,36 +218,8 @@ - 名称: ~~~~ → **GROUP产品报价（内部）** - `GET /internal/product/{productId}/batches/calendar` - 团期日历数据（内部） - 名称: ~~~~ → **团期日历数据（内部）** - - 参数变化: `['@PathVariable productId', '@PathVariable batchId']` → `['@PathVariable productId']` - `GET /internal/product/batch/{batchId}/combos` - 批次套餐列表（内部） - 名称: ~~~~ → **批次套餐列表（内部）** -- `GET /internal/product/global-stats` - 获取全局产品统计 - - 参数变化: `['@RequestParam createBy']` → `[]` -- `GET /internal/product/designer-stats` - 获取定制师产品统计 - - 参数变化: `['@RequestParam createBy', '@RequestParam createBy', '@RequestParam page']` → `['@RequestParam createBy']` - -### ✏️ Itinerary (修改) - -**修改接口：** - -- `PUT /admin/product/node/{nodeId}` - 更新行程节点 - - 参数变化: `['@PathVariable nodeId', '@RequestBody request', '@PathVariable nodeId']` → `['@PathVariable nodeId', '@RequestBody request']` -- `DELETE /admin/product/node/{nodeId}` - 删除行程节点 - - 参数变化: `['@PathVariable nodeId', '@PathVariable productId']` → `['@PathVariable nodeId']` -- `POST /admin/product/node/{nodeId}/copy` - 复制行程节点 - - 参数变化: `['@PathVariable nodeId', '@PathVariable nodeId', '@RequestBody request']` → `['@PathVariable nodeId']` -- `PUT /admin/product/hotel/{id}` - 更新每日住宿 - - 参数变化: `['@PathVariable id', '@RequestBody request', '@PathVariable id']` → `['@PathVariable id', '@RequestBody request']` -- `DELETE /admin/product/hotel/{id}` - 删除每日住宿 - - 参数变化: `['@PathVariable id', '@PathVariable productId']` → `['@PathVariable id']` -- `GET /admin/product/item/{productId}/day/{dayNumber}/dining` - 获取某天的餐厅推荐列表 - - 参数变化: `['@PathVariable productId', '@PathVariable dayNumber', '@PathVariable id']` → `['@PathVariable productId', '@PathVariable dayNumber']` -- `PUT /admin/product/supplies/{id}` - 更新物资配品 - - 参数变化: `['@PathVariable id', '@RequestBody request', '@PathVariable id']` → `['@PathVariable id', '@RequestBody request']` -- `PUT /admin/product/staff-config/{id}` - 更新人员配置 - - 参数变化: `['@PathVariable id', '@RequestBody request', '@PathVariable id']` → `['@PathVariable id', '@RequestBody request']` -- `DELETE /admin/product/staff-config/{id}` - 删除人员配置 - - 参数变化: `['@PathVariable id', '@PathVariable productId']` → `['@PathVariable id']` ### ✏️ MpProduct (修改) @@ -344,49 +227,18 @@ - `GET /mp/product/list` - 产品列表（C端） - 名称: ~~产品列表~~ → **产品列表（C端）** - - 参数变化: `['@PathVariable productId']` → `[]` - `GET /mp/product/{productId}` - 产品详情（C端） - 名称: ~~产品详情~~ → **产品详情（C端）** - - 参数变化: `['@PathVariable productId', '@PathVariable productId', '@RequestBody request']` → `['@PathVariable productId']` - `POST /mp/product/{productId}/quote` - 报价计算（C端） - 名称: ~~报价计算~~ → **报价计算（C端）** -### ✏️ Pricing (修改) - -**修改接口：** - -- `POST /admin/product/item/{productId}/pricing` - 保存定价规则 - - 参数变化: `['@PathVariable productId', '@RequestBody request', '@PathVariable productId']` → `['@PathVariable productId', '@RequestBody request']` -- `POST /admin/product/item/{productId}/price-calendar/calc-preview` - 测算预览（不写入数据库） - - 参数变化: `['@PathVariable productId', '@RequestBody request', '@PathVariable productId']` → `['@PathVariable productId', '@RequestBody request']` -- `POST /admin/product/item/{productId}/price-calendar/recalculate` - 重新测算所有自动测算日期的价格 - - 参数变化: `['@PathVariable productId', '@PathVariable productId', '@RequestBody request']` → `['@PathVariable productId']` - ### ✏️ Product (修改) **修改接口：** -- `GET /admin/product/item/{productId}` - 获取产品详情 - - 参数变化: `['@PathVariable productId', '@PathVariable productId', '@RequestBody request']` → `['@PathVariable productId']` - `PUT /admin/product/item/{productId}/status` - 产品状态变更（上架/下架/完成） - 名称: ~~产品状态变更（上架/下架等）~~ → **产品状态变更（上架/下架/完成）** -### ✏️ ProductFolder (修改) - -**修改接口：** - -- `GET /admin/product/folder/admin/product/folder` - - - 参数变化: `['@RequestBody request']` → `[]` - -### ✏️ ProductLine (修改) - -**修改接口：** - -- `GET /admin/product/line/admin/product/line` - - - 参数变化: `['@RequestBody request']` → `[]` -- `PUT /admin/product/line/{lineId}` - 更新产品线 - - 参数变化: `['@PathVariable lineId', '@RequestBody request', '@PathVariable lineId']` → `['@PathVariable lineId', '@RequestBody request']` - ### ✏️ Quote (修改) **修改接口：** @@ -402,15 +254,11 @@ - `GET /admin/task/boards` - 获取可见看板列表 - `GET /admin/task/board/{boardId}` - 看板详情 -- `POST /admin/task/board` - 创建自定义看板 - - 参数变化: `['@RequestBody req', '@PathVariable boardId']` → `['@RequestBody req']` - `DELETE /admin/task/board/{boardId}` - 删除看板 - `GET /admin/task/board/{boardId}/statuses` - 获取看板状态列 - - 参数变化: `['@PathVariable boardId', '@PathVariable boardId', '@RequestBody req']` → `['@PathVariable boardId', '@PathVariable boardId']` - `DELETE /admin/task/status/{statusId}` - 删除状态列 - `PUT /admin/task/board/{boardId}/status/sort` - 状态列排序 - `GET /admin/task/board/{boardId}/members` - 获取看板成员 - - 参数变化: `['@PathVariable boardId', '@PathVariable boardId', '@RequestBody req']` → `['@PathVariable boardId', '@PathVariable boardId']` - `DELETE /admin/task/board/{boardId}/member/{targetAdminId}` - 移除成员 ### ✏️ Task (修改) @@ -419,7 +267,7 @@ - `GET /admin/task/board/{boardId}/tasks` - 获取看板任务(按状态分组) - `GET /admin/task/{taskId}` - 任务详情 -- `PUT /admin/task/{taskId}` - 更新任务 +- `POST /admin/task` - 创建任务 - `PUT /admin/task/{taskId}/status` - 变更任务状态 - `PUT /admin/task/{taskId}/sort` - 任务排序 - `PUT /admin/task/subtask/{subtaskId}/toggle` - 切换子任务完成状态 @@ -452,22 +300,6 @@ - `GET /admin/insurance/orders` - 保险订单列表 - `GET /admin/insurance/orders/{id}` - 保险订单详情(含被保人) -### ✏️ AdminInsuranceScheme (修改) - -**修改接口：** - -- `GET /admin/insurance/scheme/{id}` - 方案详情 - - 参数变化: `['@PathVariable schemeId', '@RequestBody request']` → `['@PathVariable schemeId']` -- `PUT /admin/insurance/scheme/{id}/toggle-status` - 切换方案状态(启用/停用) - - 参数变化: `['@PathVariable schemeId', '@PathVariable schemeId']` → `['@PathVariable schemeId']` - -### ✏️ InternalInsurance (修改) - -**修改接口：** - -- `POST /internal/insurance/by-orders` - 按订单批量查询保险单(内部调用) - - 参数变化: `['@RequestBody List', '@PathVariable orderId', '@RequestParam travelerCount']` → `['@RequestBody List', '@PathVariable orderId']` - ## 合同服务 ### ✏️ AdminClauseTemplate (修改) @@ -476,7 +308,7 @@ - `GET /admin/contract/clause-template/list-all` - 获取全部补充约定模板（管理页用） - `PUT /admin/contract/clause-template/{id}/toggle-status` - 切换模板启用/停用状态 -- `PUT /admin/contract/clause-template/{id}` - 更新补充约定模板 +- `POST /admin/contract/clause-template` - 创建补充约定模板 - `DELETE /admin/contract/clause-template/{id}` - 删除补充约定模板 ### ✏️ AdminContract (修改) @@ -520,6 +352,12 @@ ## 小程序聚合服务 +### ✏️ MpBadge (修改) + +**修改接口：** + +- `GET /mp/badge` - 获取徽章数据 + ### ✏️ MpContract (修改) **修改接口：** @@ -546,8 +384,6 @@ **修改接口：** -- `GET /mp/explore/mp/explore` - - - 参数变化: `['@RequestParam sortType']` → `[]` - `GET /mp/explore/list` - 探索列表 - 返回类型: `` → `Result>` - `GET /mp/explore/{id}` - 探索详情 @@ -563,14 +399,19 @@ **修改接口：** -- `GET /mp/user/favorite/check` - 检查是否已收藏 +- `POST /mp/user/favorite` - 添加收藏 ### ✏️ MpFootprint (修改) **修改接口：** -- `DELETE /mp/user/footprint/{id}` - 删除足迹 - - 参数变化: `['@PathVariable id', '@RequestBody List']` → `['@PathVariable id']` +- `POST /mp/user/footprint` - 记录足迹 + +### ✏️ MpHome (修改) + +**修改接口：** + +- `GET /mp/home` - 首页数据 ### ✏️ MpInsurance (修改) @@ -633,16 +474,19 @@ - `GET /mp/review/target` - 某目标的已通过评价(公开) - `GET /mp/review/product/{productId}` - 按产品ID查看评价列表 - `GET /mp/review/featured` - 精选评价列表(公开) - - 参数变化: `['@RequestParam limit', '@PathVariable orderId']` → `['@RequestParam limit']` -- `GET /mp/review/order/{orderId}/reviewed` - 检查订单是否已评价 - - 参数变化: `['@PathVariable orderId', '@PathVariable orderId']` → `['@PathVariable orderId']` + +### ✏️ MpSearch (修改) + +**修改接口：** + +- `GET /mp/search` - 搜索产品 ### ✏️ MpTraveler (修改) **修改接口：** -- `GET /mp/user/traveler/{id}` - 出行人详情 - - 参数变化: `['@PathVariable id', '@PathVariable id']` → `['@PathVariable id']` +- `POST /mp/user/traveler` - 添加出行人 +- `GET /mp/user/traveler` - 出行人列表 - `PUT /mp/user/traveler/{id}/default` - 设为默认出行人 ### ✏️ MpTrip (修改) @@ -673,10 +517,15 @@ **修改接口：** -- `GET /mp/wiki/categories` - 攻略分类列表 - - 参数变化: `['@PathVariable categoryId', '@RequestParam page']` → `['@PathVariable categoryId']` - `GET /mp/wiki/article/{articleId}` - 文章详情 +### ✏️ MpWish (修改) + +**修改接口：** + +- `GET /mp/wish` - 心愿单列表 +- `POST /mp/wish` - 创建心愿 + ## 支付服务 ### ✏️ AdminPayment (修改) @@ -711,8 +560,6 @@ - `GET /admin/guide/article/list` - 文章列表 - `GET /admin/guide/article/{articleId}` - 文章详情 -- `PUT /admin/guide/article/{articleId}` - 更新文章 - - 参数变化: `['@PathVariable articleId', '@RequestBody request', '@PathVariable articleId']` → `['@PathVariable articleId', '@RequestBody request']` - `PUT /admin/guide/article/{articleId}/status` - 发布/下架 - `PUT /admin/guide/article/{articleId}/recommend` - 设置推荐 - `PUT /admin/guide/article/{articleId}/top` - 设置置顶 @@ -732,8 +579,6 @@ - `GET /admin/guide/tag/managed` - 系统标签列表 - `GET /admin/guide/tag/all` - 所有标签列表 -- `PUT /admin/guide/tag/{tagId}` - 更新标签 - - 参数变化: `['@PathVariable tagId', '@RequestBody request', '@PathVariable tagId']` → `['@PathVariable tagId', '@RequestBody request']` - `PUT /admin/guide/tag/article/{articleId}` - 更新文章标签 ### ✏️ InternalWiki (修改) @@ -764,8 +609,6 @@ - `POST /internal/file/bindRefs` - 绑定文件到业务实体 - `POST /internal/file/unbindRefs` - 解绑业务实体的所有文件 -- `POST /internal/file/byIds` - 批量获取文件信息 - - 参数变化: `['@RequestBody request', '@RequestBody request']` → `['@RequestBody request']` - `POST /internal/file/upload/direct` - 内部直接上传文件（服务间调用） - `POST /internal/file/upload/chunk/init` - 分片上传-初始化 - `POST /internal/file/upload/chunk` - 分片上传-上传分片 @@ -784,45 +627,30 @@ **修改接口：** -- `GET /admin/agreement/admin/agreement` - - - 参数变化: `['@RequestParam page']` → `[]` -- `GET /admin/agreement/{id}` - 协议详情 - - 参数变化: `['@PathVariable id', '@RequestBody request']` → `['@PathVariable id']` -- `PUT /admin/agreement/{id}` - 编辑协议 - - 参数变化: `['@PathVariable id', '@RequestBody request', '@PathVariable id']` → `['@PathVariable id', '@RequestBody request']` +- `GET /admin/agreement` - 协议列表 ### ✏️ AdminBanner (修改) **修改接口：** -- `GET /admin/banner/admin/banner` - - - 参数变化: `['@RequestParam page']` → `[]` -- `GET /admin/banner/{id}` - Banner详情 - - 参数变化: `['@PathVariable id', '@RequestBody request']` → `['@PathVariable id']` -- `PUT /admin/banner/{id}` - 更新Banner - - 参数变化: `['@PathVariable id', '@RequestBody request', '@PathVariable id']` → `['@PathVariable id', '@RequestBody request']` +- `GET /admin/banner` - Banner列表 ### ✏️ AdminContact (修改) **修改接口：** -- `GET /admin/contact/admin/contact` - - - 参数变化: `['@RequestParam page']` → `[]` +- `GET /admin/contact` - 联系方式列表 - `GET /admin/contact/{id}` - 联系方式详情 - - 参数变化: `['@PathVariable id', '@RequestBody request']` → `['@PathVariable id']` +- `POST /admin/contact` - 创建联系方式 - `PUT /admin/contact/{id}` - 更新联系方式 - - 参数变化: `['@PathVariable id', '@RequestBody request', '@PathVariable id']` → `['@PathVariable id', '@RequestBody request']` ### ✏️ AdminCustomer (修改) **修改接口：** -- `GET /admin/customer/admin/customer` - - - 参数变化: `['@RequestParam page']` → `[]` +- `GET /admin/customer` - 客户列表 - `GET /admin/customer/{userId}` - 客户详情 - - 参数变化: `['@PathVariable userId', '@PathVariable userId']` → `['@PathVariable userId']` - `POST /admin/customer/{userId}/ban` - 封禁客户 - - 参数变化: `['@PathVariable userId', '@PathVariable userId']` → `['@PathVariable userId']` - `POST /admin/customer/{userId}/unban` - 解封客户 ### ✏️ AdminDesigner (修改) @@ -830,7 +658,6 @@ **修改接口：** - `GET /admin/designer/profile` - 获取我的个人资料（已废弃，请使用 /admin/profile/me） - - 参数变化: `['@RequestBody body']` → `[]` - `GET /admin/designer/orders` - 我的订单列表（已废弃，请使用 /admin/profile/orders） - `GET /admin/designer/products` - 我的产品列表（已废弃，请使用 /admin/profile/products） @@ -838,40 +665,13 @@ **修改接口：** -- `GET /admin/explore/category/admin/explore/category` - - - 参数变化: `['@RequestParam page']` → `[]` -- `GET /admin/explore/category/{id}` - 探索分类详情 - - 参数变化: `['@PathVariable id', '@RequestBody request']` → `['@PathVariable id']` - -### ✏️ AdminFaq (修改) - -**修改接口：** - -- `GET /admin/faq/categories` - 分类列表 - - 参数变化: `['@RequestBody request']` → `[]` -- `POST /admin/faq/categories` - 创建分类 - - 参数变化: `['@RequestBody request', '@PathVariable id', '@RequestBody request']` → `['@RequestBody request']` -- `PUT /admin/faq/categories/{id}` - 更新分类 - - 参数变化: `['@PathVariable id', '@RequestBody request', '@PathVariable id']` → `['@PathVariable id', '@RequestBody request']` -- `GET /admin/faq/items` - 条目列表 - - 参数变化: `['@RequestParam categoryId', '@RequestBody request']` → `['@RequestParam categoryId']` -- `POST /admin/faq/items` - 创建条目 - - 参数变化: `['@RequestBody request', '@PathVariable id', '@RequestBody request']` → `['@RequestBody request']` -- `PUT /admin/faq/items/{id}` - 更新条目 - - 参数变化: `['@PathVariable id', '@RequestBody request', '@PathVariable id']` → `['@PathVariable id', '@RequestBody request']` +- `GET /admin/explore/category` - 探索分类列表 ### ✏️ AdminFrontendConfig (修改) **修改接口：** -- `GET /admin/frontend-config/admin/frontend-config` - - - 参数变化: `['@RequestParam page']` → `[]` -- `GET /admin/frontend-config/all` - 配置列表（不分页） - - 参数变化: `['@RequestParam configGroup', '@RequestParam status', '@PathVariable id']` → `['@RequestParam configGroup', '@RequestParam status']` -- `GET /admin/frontend-config/{id}` - 配置详情 - - 参数变化: `['@PathVariable id', '@PathVariable key']` → `['@PathVariable id']` -- `GET /admin/frontend-config/groups` - 获取所有分组 - - 参数变化: `['@RequestBody request']` → `[]` +- `GET /admin/frontend-config` - 配置列表 ### ✏️ AdminProfile (修改) @@ -887,26 +687,20 @@ **修改接口：** -- `GET /admin/topic/admin/topic` - - - 参数变化: `['@RequestParam page']` → `[]` -- `GET /admin/topic/{id}` - 专题详情 - - 参数变化: `['@PathVariable id', '@RequestBody request']` → `['@PathVariable id']` -- `PUT /admin/topic/{id}` - 更新专题 - - 参数变化: `['@PathVariable id', '@RequestBody request', '@PathVariable id']` → `['@PathVariable id', '@RequestBody request']` +- `GET /admin/topic` - 专题列表 ### ✏️ AdminUser (修改) **修改接口：** -- `GET /admin/user/admin/user` - - - 参数变化: `['@RequestBody request']` → `[]` +- `POST /admin/user` - 创建管理员 - `PUT /admin/user/{adminId}` - 更新管理员 - `DELETE /admin/user/{adminId}` - 删除管理员 - `POST /admin/user/{adminId}/unlock` - 解锁管理员 - `POST /admin/user/{adminId}/reset-password` - 重置密码 - `PUT /admin/user/{adminId}/wechat-binding` - 修改企业微信绑定（支持换绑） - `GET /admin/user/{adminId}` - 获取管理员详情 - - 参数变化: `['@PathVariable adminId', '@RequestParam page']` → `['@PathVariable adminId']` +- `GET /admin/user` - 管理员列表 ### ✏️ Auth (修改) @@ -916,12 +710,9 @@ - `POST /admin/auth/wechat/verify-2fa` - 2FA验证 - `PUT /admin/auth/password` - 修改密码 - `POST /admin/auth/logout` - 管理员登出 - - 参数变化: `['@RequestParam adminId']` → `[]` - `GET /admin/auth/2fa/qrcode` - 生成2FA扫码会话 - - 参数变化: `['@RequestParam adminId', '@RequestParam code', '@RequestParam state']` → `['@RequestParam adminId']` - `GET /admin/auth/2fa/callback` - 2FA企微扫码回调 - `GET /admin/auth/wechat-qr` - 生成企业微信扫码登录会话 - - 参数变化: `['@RequestParam code', '@RequestParam state']` → `[]` - `GET /admin/auth/wechat-qr/callback` - 企业微信扫码登录回调 - `GET /admin/auth/wechat-qr/status` - 查询企业微信扫码登录状态 - `GET /admin/auth/2fa/check` - 查询2FA扫码状态 @@ -933,16 +724,16 @@ **修改接口：** -- `GET /user/favorite/user/favorite` - - - 参数变化: `['@RequestBody favoriteRequest']` → `[]` +- `POST /user/favorite` - 添加收藏 +- `GET /user/favorite` - 收藏列表 - `DELETE /user/favorite/{favoriteId}` - 删除收藏 ### ✏️ Footprint (修改) **修改接口：** -- `GET /user/footprint/user/footprint` - - - 参数变化: `['@RequestBody footprintRequest']` → `[]` +- `POST /user/footprint` - 添加足迹 +- `GET /user/footprint` - 足迹列表 - `DELETE /user/footprint/{footprintId}` - 删除足迹 ### ✏️ InternalApproval (修改) @@ -956,40 +747,22 @@ - `GET /internal/wechat/approval-status/{spNo}` - 查询企业微信OA审批状态 - 名称: ~~Get approval status from enterprise WeChat OA~~ → **查询企业微信OA审批状态** -### ✏️ InternalBadge (修改) - -**修改接口：** - -- `GET /internal/mp/badge/internal/mp/badge` - - - 参数变化: `['@RequestParam userId']` → `[]` - ### ✏️ InternalContact (修改) **修改接口：** - `GET /internal/mp/contact/active` - 获取当前有效联系方式列表 -### ✏️ InternalDesigner (修改) - -**修改接口：** - -- `GET /internal/mp/designer/internal/mp/designer` - - - 参数变化: `['@RequestParam page', '@RequestParam limit']` → `[]` - ### ✏️ InternalExploreCategory (修改) **修改接口：** - `GET /internal/mp/explore/active` - 获取上线探索分类列表 -- `POST /internal/mp/explore/{id}/view` - 增加浏览量 - - 参数变化: `['@PathVariable id', '@PathVariable id']` → `['@PathVariable id']` ### ✏️ InternalLike (修改) **修改接口：** -- `GET /internal/like/internal/like` - - - 参数变化: `['@RequestParam targetType']` → `[]` - `POST /internal/like/toggle` - 切换点赞状态（通用） - `GET /internal/like/check` - 检查是否已点赞（通用） - `POST /internal/like/batch-check` - 批量检查是否已点赞（接受字符串ID，避免JS大数精度丢失） @@ -1001,15 +774,6 @@ - `GET /internal/login-logs` - 查询登录日志 - 名称: ~~Query login logs~~ → **查询登录日志** -### ✏️ InternalMpCommon (修改) - -**修改接口：** - -- `GET /internal/mp/common/faq` - FAQ列表 - - 参数变化: `['@RequestParam userId', '@RequestBody feedback']` → `[]` -- `POST /internal/mp/common/feedback` - 提交反馈 - - 参数变化: `['@RequestParam userId', '@RequestBody feedback', '@PathVariable type']` → `['@RequestParam userId', '@RequestBody feedback']` - ### ✏️ InternalMpDict (修改) **修改接口：** @@ -1021,11 +785,7 @@ **修改接口：** -- `GET /internal/mp/message/internal/mp/message` - - - 参数变化: `['@RequestParam userId']` → `[]` - `GET /internal/mp/message/categories` - 消息分类列表（含未读数和最新消息预览） -- `GET /internal/mp/message/summary` - 消息摘要（兼容旧接口） - - 参数变化: `['@RequestParam userId', '@RequestParam userId', '@RequestParam categoryCode']` → `['@RequestParam userId']` - `GET /internal/mp/message/list` - 分类内消息列表（进入后自动标记已读） - `GET /internal/mp/message/unread-count` - 获取总未读数 - `PUT /internal/mp/message/read-all` - 全部标记已读 @@ -1034,47 +794,15 @@ **修改接口：** -- `POST /internal/mp/user/sms/send` - 发送短信验证码 - - 参数变化: `['@RequestBody request', '@RequestBody request']` → `['@RequestBody request']` -- `POST /internal/mp/user/login/sms` - 短信登录 - - 参数变化: `['@RequestBody request', '@RequestBody request']` → `['@RequestBody request']` -- `POST /internal/mp/user/login` - 微信登录 - - 参数变化: `['@RequestBody request', '@RequestParam userId']` → `['@RequestBody request']` - `GET /internal/mp/user/profile` - 获取用户信息 -- `PUT /internal/mp/user/profile` - 更新用户信息 - - 参数变化: `['@RequestParam userId', '@RequestBody request', '@RequestParam userId']` → `['@RequestParam userId', '@RequestBody request']` -- `POST /internal/mp/user/logout` - 用户登出 - - 参数变化: `['@RequestParam userId', '@RequestParam userId']` → `['@RequestParam userId']` - `POST /internal/mp/user/favorite` - 添加收藏 - - 参数变化: `['@RequestParam userId', '@RequestBody request', '@RequestParam userId', '@RequestParam targetType']` → `['@RequestParam userId', '@RequestBody request']` - `GET /internal/mp/user/favorite` - 收藏列表 - `GET /internal/mp/user/favorite/check` - 检查是否已收藏 - - 参数变化: `['@RequestParam userId', '@RequestParam targetType', '@RequestParam targetId', '@RequestParam userId']` → `['@RequestParam userId', '@RequestParam targetType', '@RequestParam targetId']` -- `DELETE /internal/mp/user/favorite/batch` - 批量删除收藏 - - 参数变化: `['@RequestParam userId', '@RequestBody List', '@RequestParam userId']` → `['@RequestParam userId', '@RequestBody List']` - `DELETE /internal/mp/user/favorite/by-target` - 按目标取消收藏 - `POST /internal/mp/user/footprint` - 记录足迹 - - 参数变化: `['@RequestParam userId', '@RequestBody request', '@RequestParam userId', '@RequestParam resourceType']` → `['@RequestParam userId', '@RequestBody request']` - `GET /internal/mp/user/footprint` - 足迹列表 -- `DELETE /internal/mp/user/footprint/batch` - 批量删除足迹 - - 参数变化: `['@RequestParam userId', '@RequestBody List', '@RequestParam userId', '@PathVariable id']` → `['@RequestParam userId', '@RequestBody List']` - `POST /internal/mp/user/traveler` - 添加出行人 - - 参数变化: `['@RequestParam userId', '@RequestBody request', '@RequestParam userId']` → `['@RequestParam userId', '@RequestBody request']` - `GET /internal/mp/user/traveler` - 出行人列表 - - 参数变化: `['@RequestParam userId', '@RequestParam userId', '@PathVariable id']` → `['@RequestParam userId']` -- `GET /internal/mp/user/traveler/{id}` - 出行人详情 - - 参数变化: `['@RequestParam userId', '@PathVariable id', '@RequestParam userId', '@PathVariable id', '@RequestBody request']` → `['@RequestParam userId', '@PathVariable id']` -- `PUT /internal/mp/user/traveler/{id}` - 更新出行人 - - 参数变化: `['@RequestParam userId', '@PathVariable id', '@RequestBody request', '@RequestParam userId', '@PathVariable id']` → `['@RequestParam userId', '@PathVariable id', '@RequestBody request']` -- `DELETE /internal/mp/user/traveler/{id}` - 删除出行人 - - 参数变化: `['@RequestParam userId', '@PathVariable id', '@RequestParam userId', '@PathVariable id']` → `['@RequestParam userId', '@PathVariable id']` - -### ✏️ InternalOrderUser (修改) - -**修改接口：** - -- `GET /internal/order/user/internal/order/user` - - - 参数变化: `['@RequestParam userId']` → `[]` ### ✏️ InternalUser (修改) @@ -1094,7 +822,6 @@ - 名称: ~~Find C-end user ID by phone number~~ → **根据手机号查找C端用户ID** - `POST /internal/user/wechat/miniapp/generate-url-link` - 生成小程序URL Link - 名称: ~~Generate mini program URL Link for sharing~~ → **生成小程序URL Link** - - 参数变化: `['@RequestParam path', '@RequestParam query', '@RequestBody dto']` → `['@RequestParam path', '@RequestParam query']` - `POST /internal/user/wechat/send-message` - 发送企业微信消息 - 名称: ~~Send WeChat message to users~~ → **发送企业微信消息** @@ -1102,8 +829,6 @@ **修改接口：** -- `GET /internal/wechat/internal/wechat` - - - 参数变化: `['@RequestBody dto']` → `[]` - `POST /internal/wechat/user/sync` - 同步单个企微用户（回调触发） - 名称: ~~Sync single user from callback~~ → **同步单个企微用户（回调触发）** - 返回类型: `` → `Result` @@ -1124,8 +849,8 @@ **修改接口：** -- `GET /internal/mp/wish/internal/mp/wish` - - - 参数变化: `['@RequestParam userId']` → `[]` +- `GET /internal/mp/wish` - 获取用户祈愿列表 +- `POST /internal/mp/wish` - 创建祈愿 ### ✏️ PublicDict (修改) @@ -1141,9 +866,7 @@ - `GET /admin/dict/all` - 获取所有字典数据 - `POST /admin/dict/type` - 创建字典类型 - `PUT /admin/dict/type/{id}` - 更新字典类型 - - 参数变化: `['@PathVariable id', '@RequestBody request', '@PathVariable id']` → `['@PathVariable id', '@RequestBody request']` - `DELETE /admin/dict/type/{id}` - 删除字典类型 - - 参数变化: `['@PathVariable id', '@RequestParam page']` → `['@PathVariable id']` - `GET /admin/dict/type` - 分页查询字典类型 - `GET /admin/dict/type/{dictTypeId}` - 根据ID获取字典类型详情 - `POST /admin/dict/data` - 创建字典数据 @@ -1157,19 +880,15 @@ **修改接口：** -- `GET /admin/job/admin/job` - - - 参数变化: `['@RequestBody request']` → `[]` +- `POST /admin/job` - 创建定时任务 + - 返回类型: `Result` → `Result` - `PUT /admin/job/{jobId}` - 更新定时任务 - 返回类型: `Result` → `Result` - - 参数变化: `['@PathVariable jobId', '@RequestBody request', '@PathVariable jobId']` → `['@PathVariable jobId', '@RequestBody request']` -- `DELETE /admin/job/{jobId}` - 删除定时任务 - - 参数变化: `['@PathVariable jobId', '@RequestParam page']` → `['@PathVariable jobId']` +- `GET /admin/job` - 分页查询定时任务 + - 返回类型: `Result>` → `Result>` - `POST /admin/job/{jobId}/pause` - 暂停任务 - - 参数变化: `['@PathVariable jobId', '@PathVariable jobId']` → `['@PathVariable jobId']` - `POST /admin/job/{jobId}/resume` - 恢复任务 - - 参数变化: `['@PathVariable jobId', '@PathVariable jobId']` → `['@PathVariable jobId']` - `POST /admin/job/{jobId}/trigger` - 立即执行一次 - - 参数变化: `['@PathVariable jobId', '@PathVariable jobId']` → `['@PathVariable jobId']` - `GET /admin/job/{jobId}/logs` - 查询任务日志 - 返回类型: `Result>` → `Result>` @@ -1177,38 +896,28 @@ **修改接口：** -- `GET /admin/menu/admin/menu` - - - 参数变化: `['@RequestBody request']` → `[]` -- `PUT /admin/menu/{menuId}` - 更新菜单 - - 参数变化: `['@PathVariable menuId', '@RequestBody request', '@PathVariable menuId']` → `['@PathVariable menuId', '@RequestBody request']` -- `DELETE /admin/menu/{menuId}` - 删除菜单 - - 参数变化: `['@PathVariable menuId', '@PathVariable menuId']` → `['@PathVariable menuId']` +- `POST /admin/menu` - 创建菜单 - `GET /admin/menu/tree` - 获取完整菜单树 - - 参数变化: `['@PathVariable roleId']` → `[]` - `GET /admin/menu/my` - 获取当前管理员菜单 ### ✏️ SysRole (修改) **修改接口：** -- `GET /admin/role/admin/role` - - - 参数变化: `['@RequestBody request']` → `[]` +- `POST /admin/role` - 创建角色 - `PUT /admin/role/{roleId}` - 更新角色 - - 参数变化: `['@PathVariable roleId', '@RequestBody request', '@PathVariable roleId']` → `['@PathVariable roleId', '@RequestBody request']` - `DELETE /admin/role/{roleId}` - 删除角色 - - 参数变化: `['@PathVariable roleId', '@PathVariable roleId']` → `['@PathVariable roleId']` - `GET /admin/role/{roleId}` - 获取角色详情(含菜单ID) - - 参数变化: `['@PathVariable roleId', '@RequestParam page', '@RequestParam pageSize']` → `['@PathVariable roleId']` +- `GET /admin/role` - 分页查询角色 - `GET /admin/role/all` - 获取所有角色(下拉) - - 参数变化: `['@PathVariable roleId', '@RequestBody request']` → `[]` - `PUT /admin/role/{roleId}/menus` - 分配菜单权限 ### ✏️ Traveler (修改) **修改接口：** -- `GET /user/traveler/user/traveler` - - - 参数变化: `['@RequestBody travelerRequest']` → `[]` +- `POST /user/traveler` - 新增出行人 +- `GET /user/traveler` - 出行人列表 - `GET /user/traveler/{travelerId}` - 出行人详情 - `PUT /user/traveler/{travelerId}` - 更新出行人 - `PUT /user/traveler/{travelerId}/default` - 设为默认出行人 @@ -1218,9 +927,7 @@ **修改接口：** - `POST /user/sms/send` - 发送短信验证码 - - 参数变化: `['@RequestBody request', '@RequestBody request']` → `['@RequestBody request']` - `POST /user/login/sms` - 手机号验证码登录 - - 参数变化: `['@RequestBody request', '@RequestBody request']` → `['@RequestBody request']` - `POST /user/login` - 微信登录 - `GET /user/profile` - 获取用户信息 - `PUT /user/profile` - 更新用户信息 @@ -1235,7 +942,6 @@ - `POST /admin/wechat/sync/departments` - 手动同步部门 - `POST /admin/wechat/sync/users` - 手动同步用户 - `POST /admin/wechat/sync/all` - 手动同步全部（部门+用户） - - 参数变化: `['@RequestParam page']` → `[]` - `GET /admin/wechat/users` - 查询企业微信用户（分页+搜索） - `GET /admin/wechat/departments/tree` - 部门树（下拉筛选） @@ -1245,10 +951,7 @@ - `GET /admin/notification/config` - 获取通知配置列表（按分类分组） - `PUT /admin/notification/config/{id}/toggle` - 切换通道开关 - - 参数变化: `['@PathVariable id', '@RequestBody request', '@PathVariable id']` → `['@PathVariable id', '@RequestBody request']` - `GET /admin/notification/logs` - 查询发送日志 -- `GET /admin/notification/logs/stats` - 获取发送统计 - - 参数变化: `['@RequestBody request']` → `[]` ## 监控服务 @@ -1256,6 +959,7 @@ **修改接口：** +- `GET /admin/monitor/approval-logs` - 审批日志分页查询 - `GET /admin/monitor/approval-logs/{id}` - 审批日志详情 ### ✏️ DataRetention (修改) @@ -1268,7 +972,7 @@ **修改接口：** -- `GET /admin/monitor/error-logs/{id}` - 错误日志详情 +- `GET /admin/monitor/error-logs` - 错误日志分页查询 ### ✏️ InternalLog (修改) @@ -1289,10 +993,17 @@ - `GET /internal/monitor/notification-log/customer-stats` - 获取用户客户统计 - 名称: ~~Get customer stats for a user (add/loss counts)~~ → **获取用户客户统计** +### ✏️ LoginLog (修改) + +**修改接口：** + +- `GET /admin/monitor/login-logs` - 登录日志分页查询 + ### ✏️ MysqlMonitor (修改) **修改接口：** +- `GET /admin/monitor/mysql` - MySQL实时监控数据 - `GET /admin/monitor/mysql/tables` - 表空间列表 - `GET /admin/monitor/mysql/slow-queries` - 慢SQL查询统计 @@ -1300,21 +1011,34 @@ **修改接口：** -- `GET /admin/monitor/notification-logs/{id}` - 消息通知日志详情 +- `GET /admin/monitor/notification-logs` - 消息通知日志分页查询 ### ✏️ OperationLog (修改) **修改接口：** -- `GET /admin/monitor/operation-logs/{id}` - 操作日志详情 +- `GET /admin/monitor/operation-logs` - 操作日志分页查询 + +### ✏️ RedisMonitor (修改) + +**修改接口：** + +- `GET /admin/monitor/redis` - Redis实时监控数据 ### ✏️ RocketMqMonitor (修改) **修改接口：** +- `GET /admin/monitor/rocketmq` - RocketMQ概览 - `GET /admin/monitor/rocketmq/topics` - Topic统计 - `GET /admin/monitor/rocketmq/consumer-groups` - 消费者组统计 +### ✏️ ServiceMonitor (修改) + +**修改接口：** + +- `GET /admin/monitor/services` - 微服务列表和健康状态 + ## 素材服务 ### ✏️ InternalMaterial (修改) @@ -1351,13 +1075,6 @@ - `POST /admin/material/category/sub` - 创建子分类 - `DELETE /admin/material/category/sub/{categoryId}` - 删除子分类 -### ✏️ MaterialTag (修改) - -**修改接口：** - -- `PUT /admin/material/tag/{tagId}` - 编辑标签 - - 参数变化: `['@PathVariable tagId', '@RequestBody request', '@PathVariable tagId']` → `['@PathVariable tagId', '@RequestBody request']` - ### ✏️ MpMaterial (修改) **修改接口：** @@ -1385,6 +1102,7 @@ - `GET /admin/order/early-bird/list` - 早鸟优惠计划列表 - `GET /admin/order/early-bird/{planId}` - 早鸟优惠计划详情 +- `POST /admin/order/early-bird` - 创建早鸟优惠计划 - `PUT /admin/order/early-bird/{planId}` - 修改早鸟优惠计划 - `DELETE /admin/order/early-bird/{planId}` - 删除早鸟优惠计划 - `PUT /admin/order/early-bird/{planId}/toggle` - 启用/禁用早鸟优惠计划 @@ -1402,7 +1120,6 @@ - `POST /admin/order/quote` - 报价预览 - `GET /admin/order/list` - 订单列表 - - 参数变化: `['@PathVariable orderId']` → `[]` - `GET /admin/order/{orderId}` - 订单详情 - `POST /admin/order/{orderId}/remark` - 添加备注 - `PUT /admin/order/{orderId}/deposit` - 修改定金金额 @@ -1410,10 +1127,7 @@ - `POST /admin/order/{orderId}/discount` - 添加优惠项 - `PUT /admin/order/{orderId}/discount/{discountId}` - 修改优惠项 - `DELETE /admin/order/{orderId}/discount/{discountId}` - 删除优惠项 -- `POST /admin/order/{orderId}/vehicle-info/check-diff` - 检测车型一致性 - - 参数变化: `['@PathVariable orderId', '@RequestBody vehicleInfoJson', '@PathVariable orderId']` → `['@PathVariable orderId', '@RequestBody vehicleInfoJson']` - `PUT /admin/order/{orderId}/vehicle-assignment` - 分配车辆信息 - - 参数变化: `['@PathVariable orderId', '@PathVariable orderId']` → `['@PathVariable orderId']` - `PUT /admin/order/{orderId}/hotel-assignment` - 分配酒店信息 - `PUT /admin/order/{orderId}/balance-pay-method` - 设置尾款支付方式 @@ -1426,10 +1140,7 @@ - `POST /admin/order/{orderId}/itinerary/add` - 新增节点 - `DELETE /admin/order/{orderId}/itinerary/add/{editId}` - 删除新增的节点 - `GET /admin/order/{orderId}/itinerary/merged` - 获取合并后的行程（原始+编辑） -- `GET /admin/order/{orderId}/itinerary/balance-summary` - 获取尾款调整汇总 - - 参数变化: `['@PathVariable orderId', '@PathVariable orderId']` → `['@PathVariable orderId']` - `GET /admin/order/{orderId}/itinerary/edits` - 获取行程编辑记录列表 - - 参数变化: `['@PathVariable orderId', '@PathVariable orderId']` → `['@PathVariable orderId']` - `POST /admin/order/{orderId}/itinerary/room-type-change/preview` - 房型切换差价预览 - `POST /admin/order/{orderId}/itinerary/room-type-change` - 房型切换 - `POST /admin/order/{orderId}/itinerary/vehicle-type-change/preview` - 车型切换差价预览 @@ -1446,7 +1157,6 @@ **修改接口：** - `GET /admin/order/{orderId}/todos` - 获取订单待办列表 - - 参数变化: `['@PathVariable orderId', '@PathVariable todoId']` → `['@PathVariable orderId']` - `PUT /admin/order/todo/{todoId}/complete` - 完成待办 - `GET /admin/order/todo/my-list` - 我的待办列表 - `GET /admin/order/todo/my-count` - 我的待办数量 @@ -1460,10 +1170,8 @@ - `GET /admin/order/refund/list` - 退款申请列表 - `GET /admin/order/refund/{applicationId}` - 退款申请详情 - - 参数变化: `['@PathVariable applicationId', '@PathVariable applicationId']` → `['@PathVariable applicationId']` - `GET /admin/order/refund/reason/list` - 退款原因列表 - `POST /admin/order/refund/reason` - 创建退款原因 - - 参数变化: `['@RequestBody createRequest', '@PathVariable reasonId', '@RequestBody updateRequest']` → `['@RequestBody createRequest']` - `PUT /admin/order/refund/reason/{reasonId}` - 修改退款原因 - `DELETE /admin/order/refund/reason/{reasonId}` - 删除退款原因 @@ -1479,13 +1187,11 @@ **修改接口：** -- `GET /admin/order/work-order/admin/order/work-order` - - - 参数变化: `['@RequestParam status']` → `[]` - `GET /admin/order/work-order/list` - 工单列表 - `GET /admin/order/work-order/{workOrderId}` - 工单详情 - `GET /admin/order/work-order/stats` - 工单统计 - 名称: ~~工单统计(待处理数等)~~ → **工单统计** - - 参数变化: `['@RequestBody body']` → `[]` +- `POST /admin/order/work-order` - 创建工单 - `PUT /admin/order/work-order/{workOrderId}/process` - 处理工单（解决/驳回） - 名称: ~~处理工单(解决/驳回)~~ → **处理工单（解决/驳回）** - `PUT /admin/order/work-order/{workOrderId}/assign` - 指派工单 @@ -1498,7 +1204,6 @@ **修改接口：** - `GET /internal/mp/album/orders` - 用户有相册的订单列表 - - 参数变化: `['@RequestParam userId', '@RequestParam userId', '@PathVariable orderId']` → `['@RequestParam userId', '@RequestParam userId']` - `GET /internal/mp/album/folder/{folderId}/files` - 文件夹下的文件列表 - `GET /internal/mp/album/file/{albumFileId}/download-url` - 获取文件下载链接 @@ -1506,8 +1211,6 @@ **修改接口：** -- `GET /internal/order/dashboard/internal/order/dashboard` - - - 参数变化: `['@RequestParam customizerId']` → `[]` - `GET /internal/order/dashboard/overview-stats` - 概览统计 - 名称: ~~概览统计（支持定制师/全局，支持今日/本周/本月）~~ → **概览统计** - `GET /internal/order/dashboard/todo-summary` - 待办分类汇总 @@ -1525,11 +1228,8 @@ **修改接口：** -- `GET /internal/order/internal/order` - - - 参数变化: `['@RequestParam customizerId']` → `[]` - `GET /internal/order/designer-stats` - 获取定制师订单统计 - `GET /internal/order/global-stats` - 获取全局订单统计 - - 参数变化: `['@RequestParam customizerId', '@RequestParam page']` → `[]` - `GET /internal/order/designer-list` - 定制师订单列表 ### ✏️ InternalEarlyBird (修改) @@ -1537,35 +1237,25 @@ **修改接口：** - `GET /internal/mp/early-bird/active` - 获取当前有效的早鸟优惠计划列表 - - 参数变化: `['@RequestParam productType']` → `[]` - `GET /internal/mp/early-bird/match` - 匹配最优早鸟优惠计划 ### ✏️ InternalInvoice (修改) **修改接口：** -- `GET /internal/mp/invoice/internal/mp/invoice` - - - 参数变化: `['@RequestParam userId', '@RequestBody request']` → `[]` - `POST /internal/mp/invoice/apply` - 申请开票 - - 参数变化: `['@RequestParam userId', '@RequestBody request', '@RequestParam userId', '@PathVariable id']` → `['@RequestParam userId', '@RequestBody request']` - `GET /internal/mp/invoice/{id}` - 发票详情 - - 参数变化: `['@RequestParam userId', '@PathVariable id', '@RequestParam userId', '@PathVariable orderId']` → `['@RequestParam userId', '@PathVariable id']` - `GET /internal/mp/invoice/order/{orderId}` - 通过订单ID查询发票 ### ✏️ InternalMpOrder (修改) **修改接口：** -- `GET /internal/mp/order/internal/mp/order` - - - 参数变化: `['@RequestParam userId', '@RequestBody request']` → `[]` - `POST /internal/mp/order/create` - 创建订单 - `GET /internal/mp/order/list` - 订单列表 - - 参数变化: `['@RequestParam userId', '@RequestParam userId', '@PathVariable orderId']` → `['@RequestParam userId']` - `GET /internal/mp/order/{orderId}` - 订单详情 - - 参数变化: `['@RequestParam userId', '@PathVariable orderId', '@RequestParam userId', '@PathVariable orderId']` → `['@RequestParam userId', '@PathVariable orderId', '@RequestParam userId']` - `GET /internal/mp/order/lookup` - 通过联系人手机号+姓名查找订单 - 名称: ~~通过联系人手机号+姓名查找订单（无需登录）~~ → **通过联系人手机号+姓名查找订单** - - 参数变化: `['@RequestParam contactPhone', '@RequestParam contactName', '@RequestParam userId']` → `['@RequestParam contactPhone', '@RequestParam contactName']` - `POST /internal/mp/order/bind-by-contact` - 绑定未绑定的订单 - 名称: ~~绑定未绑定的订单（通过联系人手机号+姓名）~~ → **绑定未绑定的订单** - `POST /internal/mp/order/{orderId}/approve-unlock` - 客户同意解锁订单 @@ -1577,12 +1267,8 @@ **修改接口：** -- `GET /internal/mp/trip/internal/mp/trip` - - - 参数变化: `['@RequestParam userId']` → `[]` - `GET /internal/mp/trip/list` - 行程列表 - - 参数变化: `['@RequestParam userId', '@RequestParam userId', '@PathVariable orderId']` → `['@RequestParam userId']` - `GET /internal/mp/trip/{orderId}` - 行程详情 - - 参数变化: `['@RequestParam userId', '@PathVariable orderId', '@RequestParam userId']` → `['@RequestParam userId', '@PathVariable orderId']` - `GET /internal/mp/trip/today` - 今日行程 ### ✏️ InternalOrderStats (修改) @@ -1597,8 +1283,6 @@ **修改接口：** -- `GET /internal/order/traveler/internal/order/traveler` - - - 参数变化: `['@PathVariable orderId']` → `[]` - `GET /internal/order/traveler/validate/{orderId}` - 验证订单出行人信息 - 名称: ~~验证订单出行人信息（供支付服务调用）~~ → **验证订单出行人信息** @@ -1607,10 +1291,8 @@ **修改接口：** - `GET /internal/order/{orderId}/pay-info` - 获取订单支付信息 - - 参数变化: `['@PathVariable orderId', '@RequestBody dto']` → `['@PathVariable orderId']` - `POST /internal/order/payment-result` - 通知支付成功 - `POST /internal/order/refund-result` - 通知退款成功 - - 参数变化: `['@RequestBody dto', '@PathVariable orderId']` → `['@RequestBody dto']` - `GET /internal/order/{orderId}/basic` - 获取订单基本信息(供合同服务调用) ### ✏️ InternalRefund (修改) @@ -1620,11 +1302,9 @@ - `GET /internal/mp/order/{orderId}/refund-preview` - 退款金额预览 - `GET /internal/mp/order/refund-reasons` - 退款原因列表（C端） - 名称: ~~退款原因列表~~ → **退款原因列表（C端）** - - 参数变化: `['@RequestParam userId', '@RequestParam userName', '@PathVariable orderId']` → `['@RequestParam userId']` - `POST /internal/mp/order/{orderId}/refund` - 提交退款申请 - `GET /internal/mp/order/refund/{applicationId}` - 退款申请详情（C端） - 名称: ~~退款申请详情~~ → **退款申请详情（C端）** - - 参数变化: `['@RequestParam userId', '@PathVariable applicationId', '@RequestParam userId', '@PathVariable orderId']` → `['@RequestParam userId', '@PathVariable applicationId']` - `GET /internal/mp/order/{orderId}/refund-detail` - 根据订单ID获取最新退款申请 - 名称: ~~根据订单ID获取最新退款申请详情~~ → **根据订单ID获取最新退款申请** - `POST /internal/mp/order/refund/{applicationId}/cancel` - 撤回退款申请 @@ -1665,18 +1345,10 @@ **修改接口：** - `POST /internal/mp/review/create` - 创建评价(仅针对产品，每个订单仅可评价一次) - - 参数变化: `['@RequestBody body', '@PathVariable orderId']` → `['@RequestBody body']` - `GET /internal/mp/review/my` - 我的评价列表 - `GET /internal/mp/review/target` - 某目标的已通过评价(公开，支持好中差评/有图/有视频筛选) - `GET /internal/mp/review/search` - 关键词搜索评价(公开) - `GET /internal/mp/review/featured` - 首页精选评价 - - 参数变化: `['@RequestParam limit', '@PathVariable orderId']` → `['@RequestParam limit']` -- `GET /internal/mp/review/order/{orderId}/reviewable-targets` - 订单可评价目标列表 - - 参数变化: `['@PathVariable orderId', '@PathVariable reviewId']` → `['@PathVariable orderId']` -- `POST /internal/mp/review/{reviewId}/like` - 点赞/取消点赞评价 - - 参数变化: `['@PathVariable reviewId', '@PathVariable reviewId']` → `['@PathVariable reviewId']` -- `GET /internal/mp/review/{reviewId}/like/check` - 检查是否已点赞 - - 参数变化: `['@PathVariable reviewId', '@PathVariable reviewId']` → `['@PathVariable reviewId']` ### ✏️ InternalReview (修改) @@ -2041,6 +1713,7 @@ **修改接口：** +- `POST /admin/staff` - 创建服务人员 - `GET /admin/staff/list` - 服务人员列表 - `GET /admin/staff/{staffId}` - 服务人员详情 - `PUT /admin/staff/{staffId}` - 更新服务人员