platforms/docs/项目文档_配送点订单合同空列表修复_v1.0.md

项目文档：配送点订单合同空列表修复 v1.0

项目概述

修复配送点管理端创建配送订单时，当前没有可履约合同时错误提示“配送合同列表响应结构无效”的问题。

核心文件说明

• backend/api/internal/logic/delivery/order.go：查询配送合同候选项；空结果初始化为非 nil 空切片，保证接口输出 list: []。
• backend/api/internal/logic/delivery/order_contract_attachment_test.go：覆盖合同空列表公开响应的回归测试。

行为变化

• 修复前：零条合同被序列化为 null，后端响应结构校验失败。
• 修复后：零条合同返回空数组，前端正常显示“暂无可下单的生效合同”。

接口兼容性

接口地址和字段保持不变，仅将异常的 list: null 规范为 list: []，兼容现有调用方。

测试方法

在 backend 目录执行：

go test ./api/internal/logic/delivery