fix(v2): 房务 GET 查询日期参数绑定修复 changelog + 总览补日期格式约定
这个提交包含在:
@@ -15,7 +15,8 @@
|
||||
3. **金额一律是字符串**:所有 `BigDecimal` 金额(`totalAmount/sellPrice/protoPrice/budget/replyPrice/...`)在 JSON 里是**字符串**(如 `"600.00"`)。前端按 string 展示/计算(用 decimal 库),不要当 number。
|
||||
4. **统一响应包**:`{ "code": 200, "msg": "success", "data": {...} }`。HTTP 始终 200,业务错误用 `code` + 6 位错误码区分(见各域错误码表)。分页统一 `PageResult{ list/total }`(部分接口为 `{list,total,stats}`)。
|
||||
5. **错误码段位**:房务 order-v3 = `808xxx`;定制师提房需求 = `582xxx`;站内信 user-service = `281xxx`。
|
||||
6. **本总览=导航 + 核心契约**:高频建屏接口给到字段级 + 示例;其余给端点 + 用途 + 关键参数,**完整字段以 Knife4j/Swagger 在线文档为准**(每个 VO 都有 `@ApiModelProperty` 中文)。
|
||||
6. **GET 查询的日期参数格式**(务必遵守,否则报 500 转换异常):`LocalDate` 传 `yyyy-MM-dd`(如 `2026-06-20`);`LocalDateTime`(各种 `*From/*To`、`createTimeFrom`、`claimedAtFrom`、`repliedAtFrom` 等)**必须带 `T` 和时分秒** `yyyy-MM-dd'T'HH:mm:ss`(如 `2026-06-20T00:00:00`),不能只传日期。POST 请求体(`@RequestBody`)里的日期不受此限,传 `yyyy-MM-dd` 即可。详见同日《房务 GET 查询日期参数修复》changelog。
|
||||
7. **本总览=导航 + 核心契约**:高频建屏接口给到字段级 + 示例;其余给端点 + 用途 + 关键参数,**完整字段以 Knife4j/Swagger 在线文档为准**(每个 VO 都有 `@ApiModelProperty` 中文)。
|
||||
|
||||
---
|
||||
|
||||
|
||||
在新工单中引用
屏蔽一个用户