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

接口变更记录 — 2026-03-17 11:11

提交 23692ba · 作者 wx · 时间 2026-03-17 11:11:23 +0800

fix: 修复Swagger注解中字典引用与数据库不一致的问题

变更总览

---

📦 其他数据对象变更

以下变更未直接关联到本次接口变更，但可能影响现有接口的请求/响应

用户服务

✏️ ContactRequest

• ✏️ status: 说明 "状态，关联字典common_status：0=下线, 1=上线" → "状态，关联字典common_status：ACTIVE=启用, INACTIVE=停用"

✏️ ContactVO

• ✏️ status: 说明 "状态，关联字典common_status：0=下线, 1=上线" → "状态，关联字典common_status：ACTIVE=启用, INACTIVE=停用"

✏️ LoginLogVO

• ✏️ loginMethod: 说明 "登录方式，关联字典login_method：PASSWORD=密码登录, WECHAT_QR=企微扫码登录, TWO_FA=二次验证登录" → "登录方式：PASSWORD=密码登录, WECHAT_QR=企微扫码登录, TWO_FA=二次验证登录（非字典，代码常量）"

✏️ SendLogVO

• ✏️ channel: 说明 "通道，关联字典notification_channel：INAPP=站内信, SMS=短信, MINIAPP=小程序订阅, OA=公众号模板, WEWORK=企业微信" → "通道，关联字典notification_channel：SMS=短信, MINIAPP=小程序, OA=公众号, INAPP=站内信, WECHAT_WORK=企业微信"
• ✏️ status: 说明 "发送状态，关联字典notification_send_status：0=成功, 1=失败, 2=跳过" → "发送状态，关联字典notification_send_status：0=成功, 1=失败, 2=已过滤, 3=已跳过(已禁用)"

✏️ TravelerRequest

• ✏️ travelerType: 说明 "出行人类型，关联字典traveler_type：ADULT=成人, CHILD=儿童, INFANT=婴儿（无需传入，后端根据birthday自动判断）" → "出行人类型，关联字典traveler_type：ADULT=成人, CHILD=儿童, YOUNG_CHILD=小童, BABY=幼童（无需传入，后端根据birthday自动判断）"
• ✏️ gender: 说明 "性别，关联字典gender：0=女, 1=男" → "性别，关联字典gender：1=男, 2=女"

✏️ UserVO

• ✏️ gender: 说明 "性别，关联字典gender：0=女, 1=男" → "性别，关联字典gender：1=男, 2=女"

📁 全部变更文件 (点击展开)

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