优化订单履约状态处理

README.md

@@ -112,6 +112,8 @@ make docker-down    # 停止并移除
 | `OPEN_SIGN_SKEW` | 签名时间戳偏差（秒） | `300` |
 | `OPEN_API_DEBUG` | 开放接口调试日志 | debug 模式默认开启 |
 | `LOG_FILE` | 日志文件路径 | `logs/app.log` |
+| `FULFILLMENT_PROCESSING_TIMEOUT_MINUTES` | 履约中订单自动标记失败的超时分钟数，<=0 关闭 | `30` |
+| `FULFILLMENT_TIMEOUT_SCAN_INTERVAL_SECONDS` | 履约超时巡检间隔秒数 | `60` |
 
 ## 开放接口（皮肤源头对接）
 
@@ -122,6 +124,16 @@ make docker-down    # 停止并移除
 
 源头侧 `ship_notify` 当前只使用 `success` / `failed`，速查见 [`docs/发货通知约定.md`](docs/发货通知约定.md)，完整关系图见 [`docs/API对接关系.md`](docs/API对接关系.md)。两套 API 的签名算法不同，不能混用鉴权头或签名串。
 
+### 状态速查
+
+| 内部支付状态 | 内部履约状态 | 源头侧状态 | 含义 |
+|--------------|--------------|------------|------|
+| `paid` | `pending` | `paid` | 已付款，待发货 |
+| `paid` | `processing` | `delivering` | 已提交履约，等待结果 |
+| `paid` | `succeeded` | `delivered` | 履约成功 |
+| `paid` | `failed` | `ship_failed` | 履约失败，可重试 |
+| `refunded` | `cancelled` | `cancelled` | 已取消并退款 |
+
 上游皮肤源头系统调用源头侧接口时，需携带签名头 `X-Api-Key`、`X-Timestamp`、`X-Nonce`、`X-Sign`。
 
 ### 1. 查询订单（发货前置）