资源管理端 Map→VO 类型化（批次 1）

PR: #1201 | 合并时间: 2026-04-22 19:27

背景

hl-resource-service 代码规范批次 1 整改，把管理端 Controller 返 Map<String,Object> 全部改成强类型 RespVO。字段名与原 Map key 完全一致，前端 .data.xxxId/.data.name 读法不变，但 TypeScript 类型定义可以升级到具体 VO。

影响的管理端接口

端点	旧返回	新返回	字段对齐
`GET /admin/hotel/list-all-simple`	`Result<List<Map>>`	`Result<List<HotelSimpleRespVO>>`	`hotelId: Long, hotelName: string`
`POST /admin/hotel/{id}/submit-approval`	`Result<Map<String,String>>`	`Result<ApprovalSubmitRespVO>`	`approvalId: string, status: string`
`POST /admin/hotel/room-type/{id}/submit-approval`	同上	同上	同上
`POST /admin/scenic/{id}/submit-approval`	同上	同上	同上
`POST /admin/restaurant/{id}/submit-approval`	同上	同上	同上
`POST /admin/activity/{id}/submit-approval`	同上	同上	同上
`POST /admin/service/{id}/submit-approval`	同上	同上	同上
`POST /admin/vehicle/{id}/submit-approval`	同上	同上	同上
`POST /admin/staff/{id}/submit-approval`	同上	同上	同上
`POST /admin/supplies/{id}/submit-approval`	同上	同上	同上
`GET /admin/material/export`	`Result<List<Map<String,String>>>`	`Result<List<MaterialExportRespVO>>`	字段名完全保留

前端改动建议

TypeScript 类型升级（可选，字段名无变化）：

// Before
interface HotelSimpleItem {
  hotelId: string;  // 或 number
  hotelName: string;
}

// After (对齐后端 HotelSimpleRespVO)
interface HotelSimpleRespVO {
  hotelId: number;  // Long
  hotelName: string;
}

// submitApproval 响应
interface ApprovalSubmitRespVO {
  approvalId: string;
  status: string;
}

渲染代码无需改动：response.data.hotelId / response.data.approvalId 依然可用。

校验增强（@Valid）

20 处 /admin/** 和 /internal/** 的 @RequestBody 接口补了 @Valid。以下 internal 端点如果前端曾绕过网关直连调用（不推荐），会因为校验失败返回 400：

POST /internal/{resource}/approval-result（需 ApprovalResultDTO.spNo/spStatus 非空）
POST /internal/resource/price/{resource}（需 PriceQuery 必填字段）
POST /admin/material/category/permissions（需 materialIds 非空）

前端实际调用都走网关 + 全字段传参，不受影响。

无需前端改动的范围

Mapper / Service 层重构（48 Mapper 升级 BaseMapperX、Wrapper 下沉到 default 方法）
4 个新增聚合 Service（ResourcePriceQueryService 等，仅改内部实现）

3.0 KiB 原始文件 Blame 文件历史 Unescape Escape

资源管理端 Map→VO 类型化（批次 1）

背景

影响的管理端接口

前端改动建议

校验增强（@Valid）

无需前端改动的范围

相关后端 changelog

3.0 KiB

原始文件 Blame 文件历史