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

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

src_bak/api/shop/shopDealerWithdraw/index.ts

@@ -0,0 +1,145 @@
+import request from '@/utils/request';
+import type { ApiResult, PageResult } from '@/api';
+import type { ShopDealerWithdraw, ShopDealerWithdrawParam } from './model';
+
+// WeChat transfer v3: backend may return `package_info` for MiniProgram to open the
+// "confirm receipt" page via `wx.requestMerchantTransfer`.
+export type ShopDealerWithdrawCreateResult =
+  | string
+  | {
+      package_info?: string;
+      packageInfo?: string;
+      [k: string]: any;
+    }
+  | null
+  | undefined;
+
+// When applyStatus=20, user can "receive" (WeChat confirm receipt flow).
+export type ShopDealerWithdrawReceiveResult = ShopDealerWithdrawCreateResult;
+
+/**
+ * 分页查询分销商提现明细表
+ */
+export async function pageShopDealerWithdraw(params: ShopDealerWithdrawParam) {
+  const res = await request.get<ApiResult<PageResult<ShopDealerWithdraw>>>(
+    '/shop/shop-dealer-withdraw/page',
+    params
+  );
+  if (res.code === 0) {
+    return res.data;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 查询分销商提现明细表列表
+ */
+export async function listShopDealerWithdraw(params?: ShopDealerWithdrawParam) {
+  const res = await request.get<ApiResult<ShopDealerWithdraw[]>>(
+    '/shop/shop-dealer-withdraw',
+    params
+  );
+  if (res.code === 0 && res.data) {
+    return res.data;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 添加分销商提现明细表
+ */
+export async function addShopDealerWithdraw(data: ShopDealerWithdraw): Promise<ShopDealerWithdrawCreateResult> {
+  const res = await request.post<ApiResult<any>>(
+    '/shop/shop-dealer-withdraw',
+    data
+  );
+  if (res.code === 0) {
+    // Some backends return `message`, while WeChat transfer flow returns `data.package_info`.
+    return res.data ?? res.message;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 用户领取（仅当 applyStatus=20 时）- 后台返回 package_info 供小程序调起确认收款页
+ */
+export async function receiveShopDealerWithdraw(id: number): Promise<ShopDealerWithdrawReceiveResult> {
+  const res = await request.post<ApiResult<any>>(
+    '/shop/shop-dealer-withdraw/receive/' + id,
+    {}
+  );
+  if (res.code === 0) {
+    return res.data ?? res.message;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 领取成功回调：前端确认收款后通知后台把状态置为 applyStatus=40
+ */
+export async function receiveSuccessShopDealerWithdraw(id: number) {
+  const res = await request.post<ApiResult<unknown>>(
+    '/shop/shop-dealer-withdraw/receive-success/' + id,
+    {}
+  );
+  if (res.code === 0) {
+    return res.message;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 修改分销商提现明细表
+ */
+export async function updateShopDealerWithdraw(data: ShopDealerWithdraw) {
+  const res = await request.put<ApiResult<unknown>>(
+    '/shop/shop-dealer-withdraw',
+    data
+  );
+  if (res.code === 0) {
+    return res.message;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 删除分销商提现明细表
+ */
+export async function removeShopDealerWithdraw(id?: number) {
+  const res = await request.del<ApiResult<unknown>>(
+    '/shop/shop-dealer-withdraw/' + id
+  );
+  if (res.code === 0) {
+    return res.message;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 批量删除分销商提现明细表
+ */
+export async function removeBatchShopDealerWithdraw(data: (number | undefined)[]) {
+  const res = await request.del<ApiResult<unknown>>(
+    '/shop/shop-dealer-withdraw/batch',
+    {
+      data
+    }
+  );
+  if (res.code === 0) {
+    return res.message;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 根据id查询分销商提现明细表
+ */
+export async function getShopDealerWithdraw(id: number) {
+  const res = await request.get<ApiResult<ShopDealerWithdraw>>(
+    '/shop/shop-dealer-withdraw/' + id
+  );
+  if (res.code === 0 && res.data) {
+    return res.data;
+  }
+  return Promise.reject(new Error(res.message));
+}

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

@@ -0,0 +1,48 @@
+import type { PageParam } from '@/api/index';
+
+/**
+ * 分销商提现明细表
+ */
+export interface ShopDealerWithdraw {
+  // 主键ID
+  id?: number;
+  // 分销商用户ID
+  userId?: number;
+  // 提现金额
+  money?: string;
+  // 打款方式 (10微信 20支付宝 30银行卡)
+  payType?: number;
+  // 支付宝姓名
+  alipayName?: string;
+  // 支付宝账号
+  alipayAccount?: string;
+  // 开户行名称
+  bankName?: string;
+  // 银行开户名
+  bankAccount?: string;
+  // 银行卡号
+  bankCard?: string;
+  // 申请状态 (10待审核 20审核通过 30驳回 40已打款)
+  applyStatus?: number;
+  // 审核时间
+  auditTime?: number;
+  // 驳回原因
+  rejectReason?: string;
+  // 来源客户端(APP、H5、小程序等)
+  platform?: string;
+  // 租户id
+  tenantId?: number;
+  // 创建时间
+  createTime?: string;
+  // 修改时间
+  updateTime?: string;
+}
+
+/**
+ * 分销商提现明细表搜索条件
+ */
+export interface ShopDealerWithdrawParam extends PageParam {
+  id?: number;
+  userId?: number;
+  keywords?: string;
+}