38 行
1.7 KiB
Markdown
38 行
1.7 KiB
Markdown
# 用户服务接口契约审计修复（mp 侧字段/契约对齐）— 修改接口 — 小程序
|
||
|
||
> 变更类型：字段/契约对齐（无破坏性删除），小程序侧影响较小
|
||
> 端类型：小程序（用户中心/首页配置/收藏足迹/出行人 OCR）
|
||
> 日期：2026-06-17
|
||
> 服务：hl-user-service
|
||
> PR：https://git.1814.love:8443/wx/HL/pulls/3924
|
||
> 说明：本文件随 user-service 契约审计一并产出，**暂缓推送**（与小程序侧统一节奏）。admin 侧见 changelogs-v2/2026-06/17_3924_*.md。
|
||
|
||
---
|
||
|
||
## 关键说明
|
||
|
||
用接口契约语义审计工作流扫描 hl-user-service 全部 Controller，mp（小程序 BFF）侧修复一批字段名/null 语义/响应结构与 Swagger 契约不符项。已合并 dev-v3、部署测试服、本地全量 2793 单测零新增回归。下面列 mp 侧对接相关变更。
|
||
|
||
---
|
||
|
||
## 1. 收藏 / 足迹（FavoriteRespVO / FootprintRespVO）
|
||
|
||
- 响应 VO 字段名/缺字段与契约对齐；金额类字段（如有）补 `@JsonSerialize(ToStringSerializer)` 输出字符串。
|
||
- 字段语义不变，前端按现有字段名接收即可；如此前对金额字段做数字运算，改为先转数值。
|
||
|
||
## 2. 首页配置（MpHomeConfig / MpHomeScreen2VO）
|
||
|
||
- 响应结构与 Swagger 契约对齐（字段名/层级稳定化），无破坏性删除。
|
||
|
||
## 3. 出行人 OCR / 内容安全（MpTravelerOcr / MpContentSecurity）
|
||
|
||
- 入参校验（`@Valid` / 校验分组）与错误码规范化；正常路径返回结构不变。
|
||
|
||
## 4. 站内信（InternalMpMessage / 未读数 UnreadCountRespVO）
|
||
|
||
- 未读数等响应改强类型 VO，字段名不变。
|
||
|
||
---
|
||
|
||
> 待小程序侧统一接线时一并对照本文件；如需提前对接某一节请单独知会。
|