hl-api-changelog/changelogs/2026-03/2026-03-20_0908_97d461c_feat.md

7.1 KiB

接口变更记录 — 2026-03-20 09:08

提交 97d461c · 作者 wx · 时间 2026-03-20 09:08:43 +0800

feat: 法大大合同平台 + 订单超时通知 + 第二期需求文档 + 软著材料

变更总览

  • 合同服务
    • ContractCallback (+1)
  • 小程序聚合服务
    • MpOrder (+1)
  • 订单服务
    • InternalMpOrder (+1)

合同服务

ContractCallback

📖 接口文档: http://192.168.100.236:8095/doc.html → 标签 「【回调接口】合同回调」

🆕 POST /contract/callback/fadada — 法大大合同状态回调

接收法大大电子合同平台的签署状态回调。签署完成/撤销/拒签时法大大推送事件到此接口

响应 ResponseEntity<String>


小程序聚合服务

MpOrder

📖 接口文档: http://192.168.100.236:8086/doc.html → 标签 「C端 - 订单接口」

🆕 POST /mp/order/{orderId}/urge — 催单

提醒定制师尽快处理订单内部流程,通过企业微信发送消息。每个订单2小时内只能催一次

参数

  • {orderId} (Long) — 路径参数订单ID

响应 Result<Void>


订单服务

InternalMpOrder

📖 接口文档: http://192.168.100.236:8084/doc.html → 标签 「【内部接口】小程序订单Feign调用

🆕 POST /internal/mp/order/{orderId}/urge — 催单

用户催单,通过企微消息提醒定制师尽快处理订单内部流程。

参数

  • {orderId} (Long) — 路径参数
  • userId (Long) — 查询参数

响应 Result<Void>


📦 其他数据对象变更

以下变更未直接关联到本次接口变更,但可能影响现有接口的请求/响应

用户服务

✏️ TravelerRequest

  • ✏️ birthday: 说明 "出生日期(必填,后端根据此字段自动判断人员类型)" → "出生日期后端根据此字段自动判断人员类型,未传则默认ADULT"

订单服务

✏️ CreateOrderRequest

  • ✏️ birthday: 说明 "出生日期(必填,后端根据此字段自动判断人员类型)" → "出生日期后端根据此字段自动判断人员类型,未传则默认ADULT"
📁 全部变更文件 (点击展开)
M	CLAUDE.md
M	docs/CLAUDE_WORKFLOW/README.md
A	"docs/architecture/\346\210\277\347\256\241\346\234\215\345\212\241\346\236\266\346\236\204\350\256\276\350\256\241.md"
A	"docs/architecture/\347\254\254\344\272\214\346\234\237\346\236\266\346\236\204\346\200\273\350\247\210.md"
A	"docs/architecture/\350\275\246\351\230\237\346\234\215\345\212\241\346\236\266\346\236\204\350\256\276\350\256\241.md"
A	docs/mindmap-v1.27-extracted.md
A	"docs/requirements/\345\217\270\346\234\272\347\253\257\345\274\202\345\270\270\345\244\204\347\220\206\344\270\216\346\213\222\345\215\225\351\234\200\346\261\202\350\247\204\346\240\274.md"
A	"docs/requirements/\345\217\270\346\234\272\347\253\257\346\240\270\345\277\203\346\265\201\347\250\213\351\234\200\346\261\202\350\247\204\346\240\274.md"
A	"docs/requirements/\345\217\270\346\234\272\347\256\241\347\220\206\344\270\216\346\216\210\346\235\203\347\237\251\351\230\265\351\234\200\346\261\202\350\247\204\346\240\274.md"
A	"docs/requirements/\346\210\277\347\256\241\345\220\216\345\217\260v1.27\344\274\230\345\214\226\351\234\200\346\261\202\350\247\204\346\240\274.md"
A	"docs/requirements/\346\210\277\347\256\241\346\234\215\345\212\241\351\234\200\346\261\202\350\247\204\346\240\274.md"
A	"docs/requirements/\346\216\222\347\217\255\344\270\216\346\224\266\345\205\245\351\234\200\346\261\202\350\247\204\346\240\274.md"
A	"docs/requirements/\346\264\276\345\215\225\350\260\203\345\272\246\346\250\241\345\235\227\351\234\200\346\261\202\350\247\204\346\240\274.md"
A	"docs/requirements/\346\266\210\346\201\257\345\256\232\344\275\215\344\270\216\345\272\224\346\200\245\351\234\200\346\261\202\350\247\204\346\240\274.md"
A	"docs/requirements/\347\254\254\344\272\214\346\234\237\347\273\237\344\270\200\346\225\260\346\215\256\345\255\227\345\205\270.md"
A	"docs/requirements/\350\257\204\345\210\206\344\270\216\345\237\271\350\256\255\351\234\200\346\261\202\350\247\204\346\240\274.md"
A	"docs/requirements/\350\260\203\345\272\246\345\244\247\347\233\230\351\234\200\346\261\202\350\247\204\346\240\274.md"
A	"docs/requirements/\350\267\257\345\206\265\351\242\204\350\255\246\347\263\273\347\273\237\351\234\200\346\261\202\350\247\204\346\240\274.md"
A	"docs/requirements/\350\275\246\350\276\206\347\256\241\347\220\206\345\215\207\347\272\247\351\234\200\346\261\202\350\247\204\346\240\274.md"
A	"docs/requirements/\350\275\246\351\230\237\347\274\226\347\273\204\344\270\216\345\215\217\345\220\214\350\260\203\345\272\246\351\234\200\346\261\202\350\247\204\346\240\274.md"
A	"docs/zzq/01-\347\224\263\350\257\267\346\235\220\346\226\231\346\270\205\345\215\225.md"
A	"docs/zzq/02-\350\272\253\344\273\275\350\257\201\346\230\216/\350\257\267\345\234\250\346\255\244\346\224\276\345\205\245\350\272\253\344\273\275\350\257\201\346\230\216\346\235\220\346\226\231.txt"
A	"docs/zzq/03-\346\272\220\344\273\243\347\240\201.txt"
A	"docs/zzq/04-\350\275\257\344\273\266\350\257\264\346\230\216\344\271\246.md"
A	docs/zzq/generate_source_code.py
M	hl-common/src/main/java/com/hulalv/common/exception/GlobalExceptionHandler.java
M	hl-contract-service/src/main/java/com/hulalv/contract/config/ContractPlatformProperties.java
M	hl-contract-service/src/main/java/com/hulalv/contract/controller/ContractCallbackController.java
A	hl-contract-service/src/main/java/com/hulalv/contract/platform/fadada/FadadaApiClient.java
M	hl-contract-service/src/main/java/com/hulalv/contract/platform/fadada/FadadaContractPlatform.java
A	hl-contract-service/src/main/java/com/hulalv/contract/platform/fadada/FadadaSignatureUtil.java
M	hl-contract-service/src/main/java/com/hulalv/contract/service/ContractCallbackService.java
M	hl-contract-service/src/main/java/com/hulalv/contract/service/ContractService.java
A	hl-contract-service/src/test/java/com/hulalv/contract/platform/fadada/FadadaApiClientTest.java
M	hl-contract-service/src/test/java/com/hulalv/contract/platform/fadada/FadadaContractPlatformTest.java
A	hl-contract-service/src/test/java/com/hulalv/contract/platform/fadada/FadadaSignatureUtilTest.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpOrderController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/feign/MpOrderFeignClient.java
M	hl-mp-service/src/main/java/com/hulalv/mp/feign/MpOrderFeignFallbackFactory.java
M	hl-order-service/src/main/java/com/hulalv/order/controller/InternalMpOrderController.java
M	hl-order-service/src/main/java/com/hulalv/order/dto/CreateOrderRequest.java
M	hl-order-service/src/main/java/com/hulalv/order/service/NotificationEventHelper.java
M	hl-order-service/src/main/java/com/hulalv/order/service/OrderService.java
M	hl-order-service/src/main/java/com/hulalv/order/service/OrderTodoService.java
M	hl-user-service/src/main/java/com/hulalv/user/dto/TravelerRequest.java
M	nacos-config/hl-contract-service-dev.yml
A	scripts/gen_copyright_pdf.py