我的地址

doc/消费者APP/我的服务/我的服务前端技术方案.md

@@ -1,9 +1,9 @@
 # 我的服务 — 前端技术方案（C 端 · shop-app）
 
-> **依据：** 《我的服务功能需求.md》v1.1、《我的服务技术方案.md》v1.2  
+> **依据：** 《我的服务功能需求.md》v1.1、《我的服务技术方案.md》v1.3（仅作接口对照，**本文档独立维护**）  
 > **关联：** 《会员注册登录前端技术方案.md》（登录前置）、后续《订单管理》等（地址被结算引用）  
 > **范围：** C 端 **个人资料、修改密码、收货地址、商家入驻**；**不** 改后端、**不** 实现我的订单/消息中心/换绑手机。  
-> **实现状态：** 我的 Tab + 分包页面已落地；资料页已对齐 v1.2（**无出生日期**），待联调。
+> **实现状态：** 已对齐 v1.3（地址 `regionCode`/`regionName` + 省市区级联），待联调。
 
 ---
 
@@ -13,10 +13,11 @@
 |----|------|
 | 框架 | uni-app **Vue 3** + **uview-plus** |
 | 请求 | `@/utils/request`；须登录接口默认带 `Authorization: Bearer {token}` |
-| 登录前置 | **MS0**：子功能经 `ensureApiToken` / `navigateMinePage` 拦截，引导 `PAGE_LOGIN` |
-| 上传 | `@/utils/upload` → `POST /common/upload`，返回 `url` 写入表单 |
-| 样式 | `styles/mine.scss`（与登录页绿色主色一致） |
-| 路由 | 业务页在 **`subpackage/account/`**；Tab 仍在 **`pages/mine/index`** |
+| 登录前置 | **MS0**：子功能经 `ensureApiToken` / `navigateMinePage` 拦截 |
+| 上传 | `@/utils/upload` → `POST /common/upload` |
+| 省市区 | `GET /api/region/tree`（匿名）+ `up-cascader`；逻辑对齐 `ruoyi-ui/utils/region.js` |
+| 样式 | `styles/mine.scss` |
+| 路由 | 业务页在 **`subpackage/account/`**；Tab 在 **`pages/mine/index`** |
 
 ---
 
@@ -25,20 +26,14 @@
 | 页面 | 路径 | 包 | 入口 |
 |------|------|-----|------|
 | 我的（服务入口） | `pages/mine/index` | 主包 Tab | TabBar「我的」 |
-| 个人资料 | `subpackage/account/profile` | 分包 | 我的 → 编辑个人资料 / 点头像 |
+| 个人资料 | `subpackage/account/profile` | 分包 | 我的 → 编辑个人资料 |
 | 修改密码 | `subpackage/account/password` | 分包 | 我的 → 修改密码 |
 | 收货地址列表 | `subpackage/account/address-list` | 分包 | 我的 → 收货地址 |
 | 地址编辑 | `subpackage/account/address-edit` | 分包 | 列表新增/编辑 |
-| 商家入驻 | `subpackage/account/entry-apply` | 分包 | 我的 → 我要入驻 |
-| 我的入驻申请 | `subpackage/account/entry-list` | 分包 | 我的 → 我的入驻申请 |
+| 商家入驻 | `subpackage/account/entry-apply` | 分包 | 我要入驻 |
+| 我的入驻申请 | `subpackage/account/entry-list` | 分包 | 我的入驻申请 |
 | 申请详情 | `subpackage/account/entry-detail` | 分包 | 列表项 |
 
-**Query：**
-
-| 页面 | 参数 | 说明 |
-|------|------|------|
-| address-edit | `mode=add\|edit`、`id` | 编辑时传 `addressId` |
-
 **路径常量：** `utils/pageRoute.js` → `PAGE_PROFILE`、`PAGE_PASSWORD`、`PAGE_ADDRESS_*`、`PAGE_ENTRY_*`
 
 ---
@@ -47,23 +42,15 @@
 
 | 类型 | 路径 | 说明 |
 |------|------|------|
-| 我的 Tab | `shop-app/pages/mine/index.vue` | 登录态、菜单分区、退出 |
-| 资料 | `shop-app/subpackage/account/profile.vue` | 只读 ID/手机号/会员名；可编昵称/头像/邮箱/性别 |
-| 密码 | `shop-app/subpackage/account/password.vue` | 旧密码 + 新密码 + 确认 |
-| 地址列表 | `shop-app/subpackage/account/address-list.vue` | 默认置顶、设默认、删改 |
-| 地址编辑 | `shop-app/subpackage/account/address-edit.vue` | 省市区手填 + 详细地址 |
-| 入驻申请 | `shop-app/subpackage/account/entry-apply.vue` | 分步：类型→主体→经营→店铺→提交 |
-| 入驻列表 | `shop-app/subpackage/account/entry-list.vue` | 状态、驳回原因摘要 |
-| 入驻详情 | `shop-app/subpackage/account/entry-detail.vue` | 公示期、驳回、完成说明 |
+| 我的 Tab | `shop-app/pages/mine/index.vue` | 服务菜单入口 |
+| 资料/密码/地址/入驻 | `shop-app/subpackage/account/*.vue` | 各子页 |
 | 会员 API | `shop-app/api/member.js` | profile / password / address |
+| 地区 API | `shop-app/api/region.js` | `GET /api/region/tree` |
 | 入驻 API | `shop-app/api/merchantEntry.js` | agreement / apply / my |
-| 导航 | `shop-app/utils/mineNav.js` | 登录后 `navigateTo` |
-| 入驻常量 | `shop-app/utils/entryConstants.js` | 状态文案、阻塞判断 |
-| 入驻表单 | `shop-app/utils/entryForm.js` | 空白表单、分步校验、提交体 |
-| 图片上传 | `shop-app/components/mine/ImageUpload.vue` | 头像/证件/Logo |
-| 地区 | `shop-app/components/mine/RegionFields.vue` | 省市区三栏 |
-| 入驻字段块 | `shop-app/components/mine/entry/*.vue` | 个人/企业分步表单项 |
-| 协议 | `shop-app/components/account/AgreementBlock.vue` | 入驻提交勾选 |
+| 地区工具 | `shop-app/utils/region.js` | normalize、路径回显、解析区县 |
+| 地区组件 | `shop-app/components/mine/RegionFields.vue` | **级联选择**（替换手填三栏） |
+| 入驻表单 | `shop-app/utils/entryForm.js` | 分步校验、提交体 |
+| 其它 | `mineNav.js`、`entryConstants.js`、`ImageUpload`、`entry/*` | 见 v1.0 |
 
 ---
 
@@ -84,119 +71,99 @@
 
 #### 个人资料（v1.2）
 
-| 字段 | GET 展示 | PUT 可写 | 说明 |
-|------|:--------:|:--------:|------|
-| memberId | 是 | 否 | 用户 ID（只读） |
-| memberCode | 是 | 否 | 会员名称（登录账号，只读） |
-| mobile | 是 | 否 | 手机号（只读） |
-| nickName | 是 | 是 | 必填，前端 `maxlength=30` |
-| avatar | 是 | 是 | 图片上传 URL |
-| email | 是 | 是 | 可空，格式校验 |
-| sex | 是 | 是 | `0` 男 / `1` 女 / `2` 保密 |
-| ~~birthday~~ | — | — | **v1.2 已移除**，与后端 `MemberProfileAppVO` 一致 |
+可写：`nickName`、`avatar`、`email`、`sex`。**无** `birthday`。
 
-> **说明：** 入驻申请中的 **出生日期**（个人主体 `birthDate`、法人 `legalBirthDate`）属于 **商户主体字段**，与个人资料无关，仍在 `entry-apply` 分步表单中填写。
+#### 收货地址（v1.3 · 重要变更）
 
-**密码 Body：** `oldPassword`、`newPassword`、`confirmPassword`。
+| 字段 | 说明 |
+|------|------|
+| `regionCode` | 区县级 `code`（字符串提交） |
+| `regionName` | 省/市/区，**`/` 拼接**（如 `青海省/西宁市/城西区`） |
+| `detailAddress` | 街道门牌 |
+| ~~province/city/district~~ | **已废弃**，勿再提交 |
 
-**地址 Body：** `consigneeName`、`mobile`、`regionCode`、`regionName`、`detailAddress`、`isDefault`（`0`/`1`）。
+列表项 `MemberAddressVO`：`regionCode`、`regionName`、`fullAddress`（后端拼接展示用）。
 
-### 4.2 入驻 `/api/merchant/entry`
+### 4.2 省市区 `/api/region`
 
 | 方法 | HTTP | 路径 | 鉴权 |
 |------|------|------|------|
-| `getEntryAgreement` | GET | `/agreement` | 匿名 |
-| `getEntryStatus` | GET | `/status` | 匿名 |
-| `submitEntryApply` | POST | `/apply` | Token |
-| `getMyEntryApplies` | GET | `/my` | Token |
+| `getRegionTree` | GET | `/tree` | **匿名** |
 
-**提交 Body：** `subject` + `biz` + `shop` + `agreementAccepted`（结构见 `utils/entryForm.js`）。
+响应：树节点 `code`、`name`、`type`（1 省 2 市 3 区县）、`children`。
 
-**申请状态：**
+**前端规则：**
 
-| applyStatus | 含义 |
-|-------------|------|
-| `0` | 待审核 |
-| `3` | 公示中 |
-| `1` | 已完成入驻 |
-| `2` | 审核未通过 |
+- `normalizeRegionTree` 供 `up-cascader` 使用；
+- 确认时 `parseRegionSelection`：**末级须 type=3**；
+- `regionName = 路径名称 join('/')`；
+- `regionCode = 末级 code`。
 
-**阻塞新申请：** 存在 status `0` 或 `3` 时不可再提交（**MS-E6**）。
+### 4.3 入驻 `/api/merchant/entry`
 
-**入驻前置：** 后端要求会员 `nick_name` 非空；须先在资料页填写昵称。
+与 v1.2 相同；经营/注册地址字段为 `bizRegionCode`/`bizRegionName`、`regRegionCode`/`regRegionName`，UI 共用 `RegionFields`。
 
 ---
 
-## 5. 我的 Tab 结构（`pages/mine/index`）
+## 5. 地区组件（`RegionFields.vue`）
 
 ```text
-顶栏（绿渐变）
-├── 未登录：提示 + 登录 / 注册
-└── 已登录：头像、昵称、手机号 → 点击进个人资料
-
-账号管理 → 个人资料、修改密码
-收货地址 → 地址列表
-商家入驻 → 我要入驻、我的入驻申请
-退出登录
+点击「所在地区」行
+    → 弹出 up-cascader（省 → 市 → 区）
+    → 确认后 emit：
+        regionCode、regionName、pathCodes（回显用）
+        兼容 code、name（入驻 applyRegion 使用）
 ```
 
----
-
-## 6. 关键交互与规则
+**使用页面：**
 
-| 规则 | 前端落实 |
-|------|----------|
-| MS0 | 子页 `ensureApiToken` |
-| MS-P1 | 用户 ID、手机号、会员名称只读 |
-| MS-P2 | 昵称必填、≤30 字 |
-| MS-P3 | 头像须上传成功 |
-| MS-P4 | 保存后 `fetchUserInfo` 刷新 Tab |
-| MS-W1～W3 | `PUT /password` |
-| MS-A1～A4 | 地址默认互斥、删除确认 |
-| MS-E5～E9 | 协议勾选、阻塞待审、提交确认 |
+- `address-edit.vue` — 收货地址；
+- `EntryPersonBiz` / `EntryEnterpriseBiz` / `EntryEnterpriseSubject` — 入驻经营/注册地址。
 
-**地区：** `regionCode` = 区县 `code`；`regionName` = 省/市/区 `/` 拼接（与商户 `biz_region_*` 一致）；UI 暂用手填三栏，后续可接 `GET /api/region/tree` 级联。
+**缓存：** `loadRegionCascaderTree()` 模块内缓存，避免重复请求。
 
 ---
 
-## 7. 登录态
+## 6. 关键交互与规则
 
-```text
-我的 Tab onShow → 有 Token 则拉 profile 刷新 store
-子页保存资料 → userStore.fetchUserInfo()
-```
+| 规则 | 前端落实 |
+|------|----------|
+| MS-A · 级联 | 功能需求 §8.3「省/市/区级联」→ `RegionFields` + `/api/region/tree` |
+| MS-A1～A4 | 默认互斥、删除确认、列表用 `fullAddress` 或 `regionName`+详细 |
+| MS-P2 | 昵称 ≤30 字 |
+| MS-E6 | 待审/公示阻塞新入驻 |
 
 ---
 
-## 8. 联调检查清单
+## 7. 联调检查清单
 
-- [ ] 资料页 **无** 出生日期项；`PUT /profile` 仅 nickName/avatar/email/sex
-- [ ] 昵称空、超长 30 字前端拦截
-- [ ] 密码、地址 CRUD
-- [ ] 入驻个人/企业提交；待审阻塞
-- [ ] 未填昵称时入驻提交后端提示（引导完善资料）
+- [ ] `GET /api/region/tree` 返回三级树
+- [ ] 地址新增/编辑提交 `regionCode`+`regionName`，**无** province/city/district
+- [ ] 编辑地址能按 `regionCode` 回显级联路径
+- [ ] 未选至区县时前端提示「请选择完整的省市区」
+- [ ] 入驻经营/注册地址同样走级联
+- [ ] 资料、密码、入驻其它项同 v1.2 清单
 
 ---
 
-## 9. 非本期
+## 8. 非本期
 
 | 项 | 说明 |
 |----|------|
-| 个人资料出生日期 | v1.2 明确不做 |
 | 我的订单、消息中心 | 另模块 |
 | 手机号换绑 | — |
-| 省市区级联字典 | 可后续接 API |
 
 ---
 
-## 10. 修订记录
+## 9. 修订记录
 
 | 版本 | 说明 |
 |------|------|
 | **v1.0** | 首版：我的 Tab、资料/密码/地址/入驻分包 |
-| **v1.1** | 对齐后端 v1.1：password 独立接口、email/sex |
-| **v1.2** | 对齐后端/需求 v1.2：**移除资料页出生日期**；昵称 ≤30 字；更新联调清单 |
+| **v1.1** | password 独立；email/sex |
+| **v1.2** | 资料移除 birthday；昵称 ≤30 |
+| **v1.3** | 地址字段改为 **regionCode/regionName**；`api/region` + `RegionFields` 级联；入驻/地址联调清单更新 |
 
 ---
 
-*文档版本：v1.2 · 关联《我的服务技术方案.md》v1.2、《我的服务功能需求.md》v1.1*
+*文档版本：v1.3 · 关联《我的服务功能需求.md》v1.1*

shop-app/api/region.js

@@ -0,0 +1,11 @@
+import request from '@/utils/request'
+
+/** 省市区三级树（匿名，收货地址/入驻地址共用） */
+export function getRegionTree() {
+  return request({
+    url: '/api/region/tree',
+    method: 'GET',
+    header: { isToken: false },
+    silent: true
+  })
+}

shop-app/components/mine/RegionFields.vue

@@ -1,87 +1,131 @@
 <template>
-	<view class="region-fields">
-		<view class="form-row">
-			<text class="form-row__label form-row__label--req">省份</text>
-			<input
-				v-model="province"
-				class="form-row__input"
-				placeholder="如：青海省"
-				@input="emitChange"
-			/>
-		</view>
-		<view class="form-row">
-			<text class="form-row__label form-row__label--req">城市</text>
-			<input
-				v-model="city"
-				class="form-row__input"
-				placeholder="如：西宁市"
-				@input="emitChange"
-			/>
-		</view>
-		<view class="form-row">
-			<text class="form-row__label form-row__label--req">区县</text>
-			<input
-				v-model="district"
-				class="form-row__input"
-				placeholder="如：城西区"
-				@input="emitChange"
-			/>
+	<view class="region-cascader">
+		<view class="form-row" @click="openPicker">
+			<text class="form-row__label form-row__label--req">所在地区</text>
+			<view class="form-row__picker region-cascader__value">
+				<text :class="{ 'form-row__placeholder': !displayText }">
+					{{ displayText || '请选择省 / 市 / 区' }}
+				</text>
+			</view>
+			<u-icon name="arrow-right" color="#ccc" size="16" />
 		</view>
+		<up-cascader
+			v-if="treeReady"
+			:show="pickerShow"
+			:data="cascaderTree"
+			v-model="pathCodes"
+			value-key="code"
+			label-key="name"
+			children-key="children"
+			:closeable="true"
+			@update:show="pickerShow = $event"
+			@confirm="onConfirm"
+		/>
 	</view>
 </template>
 
 <script setup>
-import { ref, watch } from 'vue'
+import { ref, computed, watch, onMounted } from 'vue'
+import {
+  loadRegionCascaderTree,
+  findRegionPath,
+  parseRegionSelection,
+  formatRegionDisplay
+} from '@/utils/region'
 
 const props = defineProps({
 	modelValue: {
 		type: Object,
-		default: () => ({ code: '', name: '', province: '', city: '', district: '' })
+		default: () => ({
+			regionCode: '',
+			regionName: '',
+			code: '',
+			name: '',
+			pathCodes: []
+		})
 	}
 })
 
 const emit = defineEmits(['update:modelValue'])
 
-const province = ref('')
-const city = ref('')
-const district = ref('')
+const pickerShow = ref(false)
+const treeReady = ref(false)
+const rawTree = ref([])
+const cascaderTree = ref([])
+const pathCodes = ref([])
+
+const displayText = computed(() => {
+  const name = props.modelValue?.regionName || props.modelValue?.name || ''
+  return formatRegionDisplay(name)
+})
 
 watch(
   () => props.modelValue,
   (v) => {
-    if (!v) return
-    province.value = v.province || ''
-    city.value = v.city || ''
-    district.value = v.district || ''
-    if (!province.value && v.name) {
-      const parts = String(v.name).split(/\s+/)
-      province.value = parts[0] || ''
-      city.value = parts[1] || ''
-      district.value = parts[2] || ''
-    }
+    if (!v || !rawTree.value.length) return
+    syncPathFromModel(v)
   },
-  { immediate: true, deep: true }
+  { deep: true }
 )
 
-function emitChange() {
-  const p = (province.value || '').trim()
-  const c = (city.value || '').trim()
-  const d = (district.value || '').trim()
-  const name = [p, c, d].filter(Boolean).join(' ')
-  const code = [p, c, d].filter(Boolean).join('|')
+onMounted(() => {
+  loadRegionCascaderTree()
+    .then(({ raw, cascader }) => {
+      rawTree.value = raw
+      cascaderTree.value = cascader
+      treeReady.value = true
+      syncPathFromModel(props.modelValue)
+    })
+    .catch(() => {
+      uni.showToast({ title: '地区数据加载失败', icon: 'none' })
+    })
+})
+
+function syncPathFromModel(v) {
+  if (!v) return
+  if (Array.isArray(v.pathCodes) && v.pathCodes.length) {
+    pathCodes.value = [...v.pathCodes]
+    return
+  }
+  const code = v.regionCode || v.code
+  if (code && rawTree.value.length) {
+    const path = findRegionPath(rawTree.value, code)
+    pathCodes.value = path || []
+  }
+}
+
+function openPicker() {
+  if (!treeReady.value) {
+    uni.showToast({ title: '地区数据加载中', icon: 'none' })
+    return
+  }
+  pickerShow.value = true
+}
+
+function onConfirm(codes) {
+  const parsed = parseRegionSelection(rawTree.value, codes)
+  if (!parsed.valid) {
+    uni.showToast({ title: '请选择完整的省市区', icon: 'none' })
+    return
+  }
   emit('update:modelValue', {
-    province: p,
-    city: c,
-    district: d,
-    name,
-    code
+    regionCode: parsed.code,
+    regionName: parsed.name,
+    code: parsed.code,
+    name: parsed.name,
+    pathCodes: codes
   })
 }
 </script>
 
 <style lang="scss" scoped>
 @import '@/styles/mine.scss';
-.region-fields .form-row:last-child {
+
+.region-cascader .form-row {
   border-bottom: none;
 }
+.region-cascader__value {
+  flex: 1;
+  min-width: 0;
+}
 </style>

shop-app/styles/mine.scss

@@ -1,8 +1,8 @@
 @import '@/styles/morandi.scss';
 
 .mine-page {
-  min-height: 100vh;
-  padding-bottom: 48rpx;
+  height: calc(100vh - 188rpx);
+  // padding-bottom: 48rpx;
   background: $morandi-bg-page;
   box-sizing: border-box;
 }

shop-app/subpackage/account/address-edit.vue

@@ -24,7 +24,7 @@
 					placeholder="街道、门牌号等"
 				/>
 			</view>
-			<view class="form-row" @click="form.isDefault = form.isDefault === '1' ? '0' : '1'">
+			<view class="form-row">
 				<text class="form-row__label">设为默认</text>
 				<switch :checked="form.isDefault === '1'" color="#2e7d32" @change="onDefaultChange" />
 			</view>
@@ -43,6 +43,7 @@ import { onLoad } from '@dcloudio/uni-app'
 import { getAddressList, addAddress, updateAddress } from '@/api/member'
 import { ensureApiToken } from '@/utils/apiAuth'
 import { validateMobile } from '@/utils/memberValidate'
+import { loadRegionCascaderTree, findRegionPath } from '@/utils/region'
 import RegionFields from '@/components/mine/RegionFields.vue'
 
 const mode = ref('add')
@@ -52,14 +53,15 @@ const saving = ref(false)
 const form = reactive({
   consigneeName: '',
   mobile: '',
-  province: '',
-  city: '',
-  district: '',
   detailAddress: '',
   isDefault: '0'
 })
 
-const region = ref({ code: '', name: '', province: '', city: '', district: '' })
+const region = ref({
+  regionCode: '',
+  regionName: '',
+  pathCodes: []
+})
 
 onLoad((options) => {
   if (!ensureApiToken()) return
@@ -74,25 +76,25 @@ onLoad((options) => {
 })
 
 function loadDetail() {
-  getAddressList().then((res) => {
-    const rows = res.data || []
-    const item = rows.find((r) => r.addressId === addressId.value)
-    if (!item) return
-    form.consigneeName = item.consigneeName || ''
-    form.mobile = item.mobile || ''
-    form.province = item.province || ''
-    form.city = item.city || ''
-    form.district = item.district || ''
-    form.detailAddress = item.detailAddress || ''
-    form.isDefault = item.isDefault === '1' ? '1' : '0'
-    region.value = {
-      province: form.province,
-      city: form.city,
-      district: form.district,
-      name: [form.province, form.city, form.district].filter(Boolean).join(' '),
-      code: [form.province, form.city, form.district].filter(Boolean).join('|')
-    }
-  })
+  Promise.all([getAddressList(), loadRegionCascaderTree()])
+    .then(([addrRes, { raw }]) => {
+      const rows = addrRes.data || []
+      const item = rows.find((r) => r.addressId === addressId.value)
+      if (!item) return
+      form.consigneeName = item.consigneeName || ''
+      form.mobile = item.mobile || ''
+      form.detailAddress = item.detailAddress || ''
+      form.isDefault = item.isDefault === '1' ? '1' : '0'
+      const code = item.regionCode || ''
+      region.value = {
+        regionCode: code,
+        regionName: item.regionName || '',
+        code,
+        name: item.regionName || '',
+        pathCodes: code ? findRegionPath(raw, code) || [] : []
+      }
+    })
+    .catch(() => {})
 }
 
 function onDefaultChange(e) {
@@ -109,8 +111,12 @@ function validate() {
     uni.showToast({ title: m, icon: 'none' })
     return false
   }
-  if (!region.value.name) {
-    uni.showToast({ title: '请填写所在地区', icon: 'none' })
+  if (!(region.value.regionCode || '').trim()) {
+    uni.showToast({ title: '请选择所在地区', icon: 'none' })
+    return false
+  }
+  if (!(region.value.regionName || '').trim()) {
+    uni.showToast({ title: '请选择所在地区', icon: 'none' })
     return false
   }
   if (!(form.detailAddress || '').trim()) {
@@ -121,14 +127,12 @@ function validate() {
 }
 
 function buildPayload() {
-  const parts = region.value
   return {
     addressId: mode.value === 'edit' ? addressId.value : undefined,
     consigneeName: form.consigneeName.trim(),
     mobile: form.mobile.trim(),
-    province: parts.province,
-    city: parts.city,
-    district: parts.district,
+    regionCode: region.value.regionCode,
+    regionName: region.value.regionName,
     detailAddress: form.detailAddress.trim(),
     isDefault: form.isDefault
   }

shop-app/subpackage/account/address-list.vue

@@ -67,7 +67,11 @@ function loadList() {
 }
 
 function formatAddr(item) {
-  return [item.province, item.city, item.district, item.detailAddress].filter(Boolean).join('')
+  if (item.fullAddress) {
+    return item.fullAddress
+  }
+  const region = (item.regionName || '').replace(/\//g, '')
+  return region + (item.detailAddress || '')
 }
 
 function goAdd() {

shop-app/subpackage/account/entry-apply.vue

@@ -115,8 +115,8 @@ const stepIndex = ref(0)
 const submitting = ref(false)
 const entryOpen = ref(true)
 const blocked = ref(false)
-const regionBiz = ref({ code: '', name: '', province: '', city: '', district: '' })
-const regionReg = ref({ code: '', name: '', province: '', city: '', district: '' })
+const regionBiz = ref({ regionCode: '', regionName: '', pathCodes: [] })
+const regionReg = ref({ regionCode: '', regionName: '', pathCodes: [] })
 const userStore = useUserStore()
 
 const stepKeys = computed(() => ['type', 'subject', 'biz', 'shop', 'submit'])
@@ -179,8 +179,8 @@ function selectType(type) {
   form.biz = next.biz
   form.shop = next.shop
   form.agreementAccepted = false
-  regionBiz.value = { code: '', name: '', province: '', city: '', district: '' }
-  regionReg.value = { code: '', name: '', province: '', city: '', district: '' }
+  regionBiz.value = { regionCode: '', regionName: '', pathCodes: [] }
+  regionReg.value = { regionCode: '', regionName: '', pathCodes: [] }
 }
 
 function onBizRegion(v) {

shop-app/utils/entryForm.js

@@ -171,7 +171,7 @@ export function validateEntryStep(form, stepKey) {
       return (
         requireText(biz.merchantName, '请输入商户名称') ||
         requireText(biz.servicePhone, '请输入客服电话') ||
-        requireText(biz.bizRegionName, '请选择经营地址') ||
+        (requireText(biz.bizRegionCode, '请选择经营地址') || requireText(biz.bizRegionName, '请选择经营地址')) ||
         requireText(biz.bizDetailAddress, '请输入经营详细地址')
       )
     }
@@ -179,7 +179,7 @@ export function validateEntryStep(form, stepKey) {
     if (stepKey === 'subject') {
       return (
         requireText(subject.companyName, '请输入企业名称') ||
-        requireText(subject.regRegionName, '请选择注册地址') ||
+        (requireText(subject.regRegionCode, '请选择注册地址') || requireText(subject.regRegionName, '请选择注册地址')) ||
         requireText(subject.companyDetailAddress, '请输入注册详细地址') ||
         requireText(subject.businessScope, '请输入经营范围') ||
         requireText(subject.creditCode, '请输入统一社会信用代码') ||
@@ -204,7 +204,7 @@ export function validateEntryStep(form, stepKey) {
     }
     if (stepKey === 'biz') {
       return (
-        requireText(biz.bizRegionName, '请选择经营地址') ||
+        (requireText(biz.bizRegionCode, '请选择经营地址') || requireText(biz.bizRegionName, '请选择经营地址')) ||
         requireText(biz.bizDetailAddress, '请输入经营详细地址') ||
         requireText(biz.businessLicense, '请上传营业执照')
       )

shop-app/utils/region.js

@@ -0,0 +1,110 @@
+import { getRegionTree } from '@/api/region'
+
+/** 与平台 ruoyi-ui `utils/region.js` 逻辑一致 */
+export function normalizeRegionTree(nodes) {
+  if (!nodes || !nodes.length) {
+    return []
+  }
+  return nodes.map((node) => {
+    const hasChildren = node.children && node.children.length > 0
+    const children = hasChildren ? normalizeRegionTree(node.children) : undefined
+    const isDistrict = node.type === 3
+    const item = {
+      code: node.code,
+      name: node.name,
+      type: node.type
+    }
+    if (children && children.length) {
+      item.children = children
+    }
+    return item
+  })
+}
+
+export function findRegionPath(nodes, targetCode, path) {
+  if (!nodes || !nodes.length || targetCode == null || targetCode === '') {
+    return null
+  }
+  const target = String(targetCode)
+  for (let i = 0; i < nodes.length; i++) {
+    const node = nodes[i]
+    const nextPath = (path || []).concat(node.code)
+    if (String(node.code) === target) {
+      return nextPath
+    }
+    if (node.children && node.children.length) {
+      const found = findRegionPath(node.children, target, nextPath)
+      if (found) {
+        return found
+      }
+    }
+  }
+  return null
+}
+
+export function getRegionNamesByCodes(regionTree, codes) {
+  const names = []
+  let nodes = regionTree
+  for (let i = 0; i < codes.length; i++) {
+    const code = codes[i]
+    const node = (nodes || []).find((item) => String(item.code) === String(code))
+    if (!node) {
+      break
+    }
+    names.push(node.name)
+    nodes = node.children || []
+  }
+  return names
+}
+
+export function findRegionNodeByCodes(regionTree, codes) {
+  let nodes = regionTree
+  let node = null
+  for (let i = 0; i < codes.length; i++) {
+    node = (nodes || []).find((item) => String(item.code) === String(codes[i]))
+    if (!node) {
+      return null
+    }
+    nodes = node.children || []
+  }
+  return node
+}
+
+/**
+ * 解析级联选择结果（须选至区县 type=3）
+ * @returns {{ valid: boolean, code?: string, name?: string }}
+ */
+export function parseRegionSelection(regionTree, codes) {
+  if (!codes || !codes.length) {
+    return { valid: false }
+  }
+  const lastNode = findRegionNodeByCodes(regionTree, codes)
+  if (!lastNode || lastNode.type !== 3) {
+    return { valid: false }
+  }
+  const names = getRegionNamesByCodes(regionTree, codes)
+  return {
+    valid: true,
+    code: String(codes[codes.length - 1]),
+    name: names.join('/')
+  }
+}
+
+/** 展示用：省/市/区 → 空格分隔 */
+export function formatRegionDisplay(regionName) {
+  return (regionName || '').replace(/\//g, ' ')
+}
+
+let cachedRawTree = null
+let cachedCascaderTree = null
+
+/** 加载并缓存级联树（normalize 后供 up-cascader） */
+export async function loadRegionCascaderTree(force = false) {
+  if (!force && cachedCascaderTree) {
+    return { raw: cachedRawTree, cascader: cachedCascaderTree }
+  }
+  const res = await getRegionTree()
+  cachedRawTree = res.data || []
+  cachedCascaderTree = normalizeRegionTree(cachedRawTree)
+  return { raw: cachedRawTree, cascader: cachedCascaderTree }
+}