feat(user): 新增收货地址管理及售后申请页面

- 新增地址类型定义，增强前端地址数据结构
- 新增地址编辑页面，支持地址智能识别和定位选点功能
- 地址编辑支持省市区选择及默认地址设置
- 新增地址列表页面，支持地址展示、删除、编辑和选择功能
- 实现售后申请页面，支持选择售后类型和退款原因
- 售后申请支持商品选择、退款金额计算和凭证上传
- 新增售后详情页面，支持售后状态展示及申请取消
- 优化页面加载和用户交互体验，增加错误提示和权限处理

src_bak/api/shop/shopUserAddress/index.ts

@@ -0,0 +1,132 @@
+import request from '@/utils/request';
+import type { ApiResult, PageResult } from '@/api';
+import type { ShopUserAddress, ShopUserAddressParam } from './model';
+
+/**
+ * 分页查询收货地址
+ */
+export async function pageShopUserAddress(params: ShopUserAddressParam) {
+  const res = await request.get<ApiResult<PageResult<ShopUserAddress>>>(
+    '/shop/shop-user-address/page',
+    params
+  );
+  if (res.code === 0) {
+    return res.data;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 查询收货地址列表
+ */
+export async function listShopUserAddress(params?: ShopUserAddressParam) {
+  const res = await request.get<ApiResult<ShopUserAddress[]>>(
+    '/shop/shop-user-address',
+    params
+  );
+  console.log('[listShopUserAddress] raw response:', JSON.stringify(res)?.substring(0, 300))
+  // 兼容多种响应格式
+  // 1. 直接返回数组
+  if (Array.isArray(res)) {
+    return res as ShopUserAddress[];
+  }
+  // 2. 标准包装 { code, data, message }
+  if (res && typeof res === 'object') {
+    // 兼容 code: 0 和 code: 200
+    const isSuccess = res.code === 0 || res.code === 200
+    if (isSuccess) {
+      // data 是数组
+      if (Array.isArray(res.data)) {
+        return res.data;
+      }
+      // data 是分页对象 { list, count }
+      if (res.data && Array.isArray((res.data as any).list)) {
+        return (res.data as any).list as ShopUserAddress[];
+      }
+      // data 为 null/undefined 但 code 成功，返回空数组
+      return [];
+    }
+  }
+  return Promise.reject(new Error((res as any)?.message || '获取地址列表失败'));
+}
+
+/**
+ * 添加收货地址
+ */
+export async function addShopUserAddress(data: ShopUserAddress) {
+  const res = await request.post<ApiResult<unknown>>(
+    '/shop/shop-user-address',
+    data
+  );
+  if (res.code === 0) {
+    return res.message;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 修改收货地址
+ */
+export async function updateShopUserAddress(data: ShopUserAddress) {
+  const res = await request.put<ApiResult<unknown>>(
+    '/shop/shop-user-address/' + data.id,
+    data
+  );
+  if (res.code === 0) {
+    return res.message;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 删除收货地址
+ */
+export async function removeShopUserAddress(id?: number) {
+  const res = await request.del<ApiResult<unknown>>(
+    '/shop/shop-user-address/' + id
+  );
+  if (res.code === 0) {
+    return res.message;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 设置默认收货地址
+ */
+export async function setDefaultAddress(id: number) {
+  const res = await request.put<ApiResult<unknown>>(
+    '/shop/shop-user-address/set-default/' + id
+  );
+  if (res.code === 0) {
+    return res.message;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 批量删除收货地址
+ */
+export async function removeBatchShopUserAddress(data: (number | undefined)[]) {
+  const res = await request.del<ApiResult<unknown>>(
+    '/shop/shop-user-address/batch',
+    { ids: data.filter(Boolean) }
+  );
+  if (res.code === 0) {
+    return res.message;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 根据id查询收货地址
+ */
+export async function getShopUserAddress(id: number) {
+  const res = await request.get<ApiResult<ShopUserAddress>>(
+    '/shop/shop-user-address/' + id
+  );
+  if (res.code === 0 && res.data) {
+    return res.data;
+  }
+  return Promise.reject(new Error(res.message));
+}

src_bak/api/shop/shopUserAddress/model/index.ts

@@ -0,0 +1,53 @@
+import type { PageParam } from '@/api';
+
+/**
+ * 收货地址
+ */
+export interface ShopUserAddress {
+  // 主键ID
+  id?: number;
+  // 姓名
+  name?: string;
+  // 手机号码
+  phone?: string;
+  // 所在国家
+  country?: string;
+  // 所在省份
+  province?: string;
+  // 所在城市
+  city?: string;
+  // 所在辖区
+  region?: string;
+  // 收货地址
+  address?: string;
+  // 收货地址
+  fullAddress?: string;
+  //
+  lat?: string;
+  //
+  lng?: string;
+  // 1先生 2女士
+  gender?: number;
+  // 家、公司、学校
+  type?: string;
+  // 默认收货地址
+  isDefault?: boolean;
+  // 用户ID
+  userId?: number;
+  // 租户id
+  tenantId?: number;
+  // 注册时间
+  createTime?: string;
+  // 更新时间
+  updateTime?: string;
+}
+
+/**
+ * 收货地址搜索条件
+ */
+export interface ShopUserAddressParam extends PageParam {
+  id?: number;
+  userId?: number;
+  isDefault?: boolean;
+  keywords?: string;
+}