BE-02 Spring Boot 基础与建单接口交付记录

article
2026年7月20日阅读约 1 分钟74 字

更新于 2026年7月20日

BE-02 Spring Boot 基础与建单接口交付记录

修改范围

  • backend/pom.xml:切换到 Spring Boot 3.5.13,加入 Web、Validation、Test starter 和 Boot Maven plugin,保留 Java 17。
  • BookingReconciliationApplication:Spring Boot 启动入口、默认 BookingReconciliationService Bean、UTC Clock Bean。
  • api:新增建单请求 record、POST /api/v1/booking-reconciliations/create-results、统一 ApiError 和异常处理。
  • web/TraceIdFilter:处理 /api/** 的 X-Trace-Id,贯通响应头、MDC、错误响应、错误日志和正常审计日志。
  • BookingReconciliationControllerTest:覆盖不确定结果安全响应、400 与 500 的 traceId 一致性。

行为

Controller 仅调用既有 BookingReconciliationService.afterCreate,不复制领域决策。TIMEOUT 仍返回 PENDING_RECONCILIATION / QUERY_BY_CLIENT_REFERENCE / safeToCreateAgain=false / CREATE_RESULT_UNCERTAIN。IllegalArgumentException、请求解析和校验错误为 400 INVALID_REQUEST;非预期故障为不泄露细节的 500 INTERNAL_ERROR。审计日志不记录供应商订单号、确认号或请求体。

边界与验证

未实现数据库、快照持久化、供应商调用、鉴权、Repository、MQ、调度、分布式幂等或审计存储;端点只对调用方快照生成同步决策。

验证:mvn -f backend/pom.xml test
结果:25 tests,0 failures,0 errors,0 skipped,BUILD SUCCESS(2026-07-20 10:49:31 +08:00)。