# 接口变更记录 — 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=女"

<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>