hl-api-changelog/changelogs/2026-03/2026-03-17_1111_23692ba_fix_Swagger.md

62 行
3.2 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 接口变更记录 — 2026-03-17 11:11
> **提交** `23692ba` · **作者** wx · **时间** 2026-03-17 11:11:23 +0800
>
> fix: 修复Swagger注解中字典引用与数据库不一致的问题
## 变更总览
---
## 📦 其他数据对象变更
> 以下变更未直接关联到本次接口变更,但可能影响现有接口的请求/响应
### 用户服务
#### ✏️ ContactRequest
- ✏️ `status`: 说明 "状态,关联字典common_status0=下线, 1=上线" → "状态,关联字典common_statusACTIVE=启用, INACTIVE=停用"
#### ✏️ ContactVO
- ✏️ `status`: 说明 "状态,关联字典common_status0=下线, 1=上线" → "状态,关联字典common_statusACTIVE=启用, INACTIVE=停用"
#### ✏️ LoginLogVO
- ✏️ `loginMethod`: 说明 "登录方式,关联字典login_methodPASSWORD=密码登录, WECHAT_QR=企微扫码登录, TWO_FA=二次验证登录" → "登录方式PASSWORD=密码登录, WECHAT_QR=企微扫码登录, TWO_FA=二次验证登录(非字典,代码常量)"
#### ✏️ SendLogVO
- ✏️ `channel`: 说明 "通道,关联字典notification_channelINAPP=站内信, SMS=短信, MINIAPP=小程序订阅, OA=公众号模板, WEWORK=企业微信" → "通道,关联字典notification_channelSMS=短信, MINIAPP=小程序, OA=公众号, INAPP=站内信, WECHAT_WORK=企业微信"
- ✏️ `status`: 说明 "发送状态,关联字典notification_send_status0=成功, 1=失败, 2=跳过" → "发送状态,关联字典notification_send_status0=成功, 1=失败, 2=已过滤, 3=已跳过(已禁用)"
#### ✏️ TravelerRequest
- ✏️ `travelerType`: 说明 "出行人类型,关联字典traveler_typeADULT=成人, CHILD=儿童, INFANT=婴儿无需传入,后端根据birthday自动判断" → "出行人类型,关联字典traveler_typeADULT=成人, CHILD=儿童, YOUNG_CHILD=小童, BABY=幼童无需传入,后端根据birthday自动判断"
- ✏️ `gender`: 说明 "性别,关联字典gender0=女, 1=男" → "性别,关联字典gender1=男, 2=女"
#### ✏️ UserVO
- ✏️ `gender`: 说明 "性别,关联字典gender0=女, 1=男" → "性别,关联字典gender1=男, 2=女"
<details>
<summary>📁 全部变更文件 (点击展开)</summary>
```
M .gitignore
M hl-monitor-service/src/main/java/com/hulalv/monitor/controller/OperationLogController.java
M hl-mp-service/src/main/java/com/hulalv/mp/controller/MpPaymentController.java
M hl-mp-service/src/main/java/com/hulalv/mp/controller/MpRefundController.java
M hl-payment-service/src/main/java/com/hulalv/payment/controller/InternalPaymentController.java
M hl-resource-service/src/main/java/com/hulalv/resource/restaurant/controller/RestaurantController.java
M hl-user-service/src/main/java/com/hulalv/user/dto/ContactRequest.java
M hl-user-service/src/main/java/com/hulalv/user/dto/TravelerRequest.java
M hl-user-service/src/main/java/com/hulalv/user/notification/vo/SendLogVO.java
M hl-user-service/src/main/java/com/hulalv/user/vo/ContactVO.java
M hl-user-service/src/main/java/com/hulalv/user/vo/LoginLogVO.java
M hl-user-service/src/main/java/com/hulalv/user/vo/UserVO.java
A scripts/check-dict-consistency.py
```
</details>