新增订单查询接口/api/v1/mall/order

docs/H5-积分商城接口文档.md

@@ -19,7 +19,8 @@
    - `POST /api/v1/mall/claim` 领取积分（幂等）
    - `GET /api/v1/mall/items` 获取商品
    - `POST /api/v1/mall/bonusRedeem` / `physicalRedeem` / `withdrawApply` 提交兑换/提现
-   - `GET /api/v1/mall/orders` 查询订单
+   - `GET /api/v1/mall/orders` 查询订单列表
+   - `GET /api/v1/mall/order` 按订单 ID 查询单笔订单（含状态）
    - `GET/POST /api/v1/mall/address*` 管理地址（addressList/addressAdd/addressEdit/addressDelete）
 
 ### 1.2 流程 B：playX token 换取 session（兼容）
@@ -159,6 +160,33 @@ curl "https://{域名}/api/v1/temLogin?username=test001"
 
 ---
 
+### 3.8.1 单笔订单查询（按 ID）
+
+**GET** ` /api/v1/mall/order `
+
+鉴权：`token` / `session_id` / `user_id`（同订单列表）
+
+参数（Query）：
+- `order_id`：必填，商城订单主键 `mall_order.id`（兼容参数名 `id`）
+
+说明：
+- 仅能查询当前鉴权用户本人名下的订单；订单不存在或不属于当前用户时返回「记录不存在」，不泄露他人订单信息。
+
+返回（成功 `data`）：
+- `order_id`：订单 ID
+- `status`：订单状态（`PENDING` / `COMPLETED` / `SHIPPED` / `REJECTED`）
+- `order`：订单详情（字段与订单列表单条一致，含 `reject_reason`、`grant_status`、`mallItem` 等）
+
+示例：
+
+```bash
+curl -G "https://{域名}/api/v1/mall/order" \
+  -H "token: <muser_token>" \
+  --data-urlencode "order_id=123"
+```
+
+---
+
 ### 3.9 积分流水（领取/兑换/退回）
 
 **GET** ` /api/v1/mall/pointsLogs `
@@ -240,6 +268,13 @@ Body 含 `receiver_name`（收货人，建议填写；实物兑换下单快照
 - `data.username`
 - `data.token_expire_at`
 
+**本地联调（不请求 PlayX）**：在 `.env` 中设置 `PLAYX_VERIFY_TOKEN_LOCAL_ONLY=true`，并配置：
+
+- `PLAYX_VERIFY_TOKEN_LOCAL_DEFAULT_USER_ID`：写入 `mall_session.user_id` / 资产 `playx_user_id`
+- `PLAYX_VERIFY_TOKEN_LOCAL_DEFAULT_USERNAME`：写入 `mall_session.username` 与资产展示名
+
+此时任意（或空）`token` 均视为验证通过，返回的 `user_id` / `username` 以上述环境变量为准。生产环境请保持 `PLAYX_VERIFY_TOKEN_LOCAL_ONLY=false` 并配置 `PLAYX_TOKEN_VERIFY_URL`。
+
 ---
 
 ## 6. 常见错误与排查