省市区code 从本地

ruoyi-ui/src/api/agri/region.js

@@ -1,15 +1,11 @@
-import request from '@/utils/request'
-import { normalizeRegionTree } from '@/utils/region'
+import { getRegionTreeFromCityCode, normalizeRegionTree } from '@/utils/region'
 
-// 查询省市区三级树（平台端，原始数据）
+/** 查询省市区三级树（本地 cityCode.json，原始结构） */
 export function getRegionTree() {
-  return request({
-    url: '/agri/region/tree',
-    method: 'get'
-  })
+  return Promise.resolve({ data: getRegionTreeFromCityCode() })
 }
 
 /** 查询供 el-cascader 使用的省市区树（已 normalize，仅区县可选） */
 export function getRegionCascaderTree() {
-  return getRegionTree().then(response => normalizeRegionTree(response.data || []))
+  return Promise.resolve(normalizeRegionTree(getRegionTreeFromCityCode()))
 }

ruoyi-ui/src/utils/region.js

@@ -1,3 +1,5 @@
+import cityCodeJson from '@/utils/json/cityCode.json'
+
 /** el-cascader 省市区配置（须配合 normalizeRegionTree 使用） */
 export const REGION_CASCADER_PROPS = {
   value: 'code',
@@ -106,3 +108,57 @@ export function parseRegionSelection(regionTree, codes) {
     name: names.join('/')
   }
 }
+
+let cachedRegionTree = null
+
+/**
+ * 将 cityCode.json 转为与后端 RegionTreeVO 一致的三级树结构。
+ * code 为字符串；省级 id 取行政区划 code 数值，供省份多选等场景使用。
+ */
+export function convertCityCodeToRegionTree(cityCodeList) {
+  return (cityCodeList || []).map(province => {
+    const provinceCode = String(province.code)
+    const cities = (province.cityList || []).map(city => {
+      const cityCode = String(city.code)
+      const areas = (city.areaList || []).map(area => ({
+        code: String(area.code),
+        name: area.name,
+        type: 3
+      }))
+      const cityNode = {
+        code: cityCode,
+        name: city.name,
+        type: 2
+      }
+      if (areas.length) {
+        cityNode.children = areas
+      }
+      return cityNode
+    })
+    const provinceNode = {
+      id: Number(provinceCode),
+      code: provinceCode,
+      name: province.name,
+      type: 1
+    }
+    if (cities.length) {
+      provinceNode.children = cities
+    }
+    return provinceNode
+  })
+}
+
+/** 从本地 cityCode.json 获取省市区树（带模块级缓存） */
+export function getRegionTreeFromCityCode() {
+  if (!cachedRegionTree) {
+    cachedRegionTree = convertCityCodeToRegionTree(cityCodeJson)
+  }
+  return cachedRegionTree
+}
+
+/** 从地区树提取省级选项（运费模版等省份多选） */
+export function getProvinceOptionsFromTree(regionTree) {
+  return (regionTree || [])
+    .filter(item => item.type === 1)
+    .map(item => ({ id: item.id, name: item.name }))
+}

shop-app/api/region.js

@@ -1,6 +1,9 @@
 import request from '@/utils/request'
 
-/** 省市区三级树（匿名，收货地址/入驻地址共用） */
+/**
+ * 省市区三级树（接口）
+ * @deprecated 业务已改读本地 utils/json/cityCode.json，见 utils/region.js
+ */
 export function getRegionTree() {
   return request({
     url: '/api/region/tree',

shop-app/utils/region.js

@@ -1,4 +1,4 @@
-import { getRegionTree } from '@/api/region'
+import cityCodeJson from '@/utils/json/cityCode.json'
 
 /** 与平台 ruoyi-ui `utils/region.js` 逻辑一致 */
 export function normalizeRegionTree(nodes) {
@@ -95,16 +95,57 @@ export function formatRegionDisplay(regionName) {
   return (regionName || '').replace(/\//g, ' ')
 }
 
+/**
+ * 将 cityCode.json 转为三级树（与后端 RegionTreeVO 结构一致）
+ */
+export function convertCityCodeToRegionTree(cityCodeList) {
+  return (cityCodeList || []).map((province) => {
+    const provinceCode = String(province.code)
+    const cities = (province.cityList || []).map((city) => {
+      const cityCode = String(city.code)
+      const areas = (city.areaList || []).map((area) => ({
+        code: String(area.code),
+        name: area.name,
+        type: 3
+      }))
+      const cityNode = {
+        code: cityCode,
+        name: city.name,
+        type: 2
+      }
+      if (areas.length) {
+        cityNode.children = areas
+      }
+      return cityNode
+    })
+    const provinceNode = {
+      code: provinceCode,
+      name: province.name,
+      type: 1
+    }
+    if (cities.length) {
+      provinceNode.children = cities
+    }
+    return provinceNode
+  })
+}
+
 let cachedRawTree = null
 let cachedCascaderTree = null
 
-/** 加载并缓存级联树（normalize 后供 up-cascader） */
-export async function loadRegionCascaderTree(force = false) {
+function getRegionTreeFromCityCode() {
+  if (!cachedRawTree) {
+    cachedRawTree = convertCityCodeToRegionTree(cityCodeJson)
+  }
+  return cachedRawTree
+}
+
+/** 加载并缓存级联树（本地 cityCode.json，normalize 后供 up-cascader） */
+export function loadRegionCascaderTree(force = false) {
   if (!force && cachedCascaderTree) {
-    return { raw: cachedRawTree, cascader: cachedCascaderTree }
+    return Promise.resolve({ raw: cachedRawTree, cascader: cachedCascaderTree })
   }
-  const res = await getRegionTree()
-  cachedRawTree = res.data || []
+  cachedRawTree = getRegionTreeFromCityCode()
   cachedCascaderTree = normalizeRegionTree(cachedRawTree)
-  return { raw: cachedRawTree, cascader: cachedCascaderTree }
+  return Promise.resolve({ raw: cachedRawTree, cascader: cachedCascaderTree })
 }