feat(UserAddressRepository): 扩展地址解析功能以包含区域ID

- 修改阿里云市场地址解析接口调用，增加区域ID查询功能
- 添加 appendRegionIds 方法从 rrx_regions 表查询省/市/区/街道的 ID
- 在返回数据中追加 province_id、city_id、district_id、street_id 字段
- 生成 code_list 字段拼接各级区域ID
- 更新方法注释说明新增的区域ID查询功能
- 添加查询构造器复用问题的注意事项注释

app/common/repositories/user/UserAddressRepository.php

@@ -142,7 +142,8 @@ class UserAddressRepository extends BaseRepository
     /**
      * 阿里云市场 - 地址解析
      *
-     * 调用阿里云市场地址解析接口，将完整的地址文本解析为省/市/区/街道等结构化信息
+     * 调用阿里云市场地址解析接口，将完整的地址文本解析为省/市/区/街道等结构化信息，
+     * 并从 rrx_regions 表查询省/市/区/街道的 id 追加到返回数据中
      *
      * 接口文档: https://market.aliyun.com/detail/cmapi00067026
      * 请求方式: POST
@@ -193,7 +194,10 @@ class UserAddressRepository extends BaseRepository
             // 接口返回格式：{"msg":"成功","success":true,"code":200,"data":{"orderNo":"...","data":{...}}}
             // 提取内层 data.data 作为解析结果
             if (isset($result['code']) && $result['code'] == 200 && isset($result['data']['data'])) {
-                return ['code' => 200, 'msg' => '成功', 'data' => $result['data']['data']];
+                $data = $result['data']['data'];
+                // 从 rrx_regions 表查询省/市/区/街道的 id
+                $data = $this->appendRegionIds($data);
+                return ['code' => 200, 'msg' => '成功', 'data' => $data];
             }
 
             // 如果外层 code 不是 200，返回接口的错误信息
@@ -211,4 +215,66 @@ class UserAddressRepository extends BaseRepository
             return ['code' => -5, 'msg' => $msg, 'data' => []];
         }
     }
+
+    /**
+     * 根据省/市/区/街道名称从 rrx_regions 表查询对应的 id，并追加到返回数据中
+     *
+     * 注意：每次查询必须重新调用 Db::name('regions')，避免 ThinkPHP 查询构造器复用导致 where 条件叠加
+     *
+     * @param array $data 接口返回的地址解析数据，包含 province/city/district/street
+     * @return array
+     */
+    private function appendRegionIds(array $data)
+    {
+        $provinceId = 0;
+        $cityId = 0;
+        $districtId = 0;
+        $streetId = 0;
+
+        // 查询省份 id (level = 1)，未查到返回 0
+        if (!empty($data['province'])) {
+            $province = \think\facade\Db::name('regions')
+                ->where('name', $data['province'])
+                ->where('level', 1)
+                ->find();
+            $provinceId = $province ? (int)$province['id'] : 0;
+        }
+        $data['province_id'] = $provinceId;
+
+        // 查询城市 id (level = 2)，未查到返回 0
+        if (!empty($data['city'])) {
+            $city = \think\facade\Db::name('regions')
+                ->where('name', $data['city'])
+                ->where('level', 2)
+                ->find();
+            $cityId = $city ? (int)$city['id'] : 0;
+        }
+        $data['city_id'] = $cityId;
+
+        // 查询区/县 id (level = 3)，未查到返回 0
+        if (!empty($data['district'])) {
+            $district = \think\facade\Db::name('regions')
+                ->where('name', $data['district'])
+                ->where('level', 3)
+                ->find();
+            $districtId = $district ? (int)$district['id'] : 0;
+        }
+        $data['district_id'] = $districtId;
+
+        // 查询街道/乡镇 id (level = 4)，未查到返回 0
+        if (!empty($data['street'])) {
+            $street = \think\facade\Db::name('regions')
+                ->where('name', $data['street'])
+                ->where('level', 4)
+                ->find();
+            $streetId = $street ? (int)$street['id'] : 0;
+        }
+        $data['street_id'] = $streetId;
+
+        // 拼接 code_list，格式：province_id,city_id,district_id,street_id
+        $codeList = implode(',', [$provinceId, $cityId, $districtId, $streetId]);
+        $data['code_list'] = $codeList;
+
+        return $data;
+    }
 }