1.7 KiB
1.7 KiB
用户服务接口契约审计修复（mp 侧字段/契约对齐）— 修改接口 — 小程序
变更类型：字段/契约对齐（无破坏性删除），小程序侧影响较小 端类型：小程序（用户中心/首页配置/收藏足迹/出行人 OCR） 日期：2026-06-17 服务：hl-user-service PR：wx/HL#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，字段名不变。
待小程序侧统一接线时一并对照本文件；如需提前对接某一节请单独知会。