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

137 行
7.1 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 接口变更记录 — 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](http://192.168.100.236:8095/doc.html) → 标签 **「【回调接口】合同回调」**
### 🆕 `POST` /contract/callback/fadada — 法大大合同状态回调
> 接收法大大电子合同平台的签署状态回调。签署完成/撤销/拒签时法大大推送事件到此接口
**响应** `ResponseEntity<String>`
---
## 小程序聚合服务
### MpOrder
> 📖 **接口文档**: [http://192.168.100.236:8086/doc.html](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](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"
<details>
<summary>📁 全部变更文件 (点击展开)</summary>
```
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
```
</details>