diff --git a/changelogs/2026-03/2026-03-20_0908_97d461c_feat.md b/changelogs/2026-03/2026-03-20_0908_97d461c_feat.md new file mode 100644 index 0000000..66f2be7 --- /dev/null +++ b/changelogs/2026-03/2026-03-20_0908_97d461c_feat.md @@ -0,0 +1,137 @@ +# 接口变更记录 — 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` + +--- + +## 小程序聚合服务 + +### 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` + +--- + +## 订单服务 + +### 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` + +--- + +## 📦 其他数据对象变更 + +> 以下变更未直接关联到本次接口变更，但可能影响现有接口的请求/响应 + +### 用户服务 + +#### ✏️ 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 +``` +
\ No newline at end of file