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

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

src_bak/api/shop/shopCart/index.ts

@@ -0,0 +1,153 @@
+import request from '@/utils/request';
+import type { ApiResult } from '@/api';
+import type { ShopCart, ShopCartParam, AddToCartParam, UpdateCartNumParam } from './model';
+
+/**
+ * 获取购物车列表
+ */
+export async function listShopCart(params?: ShopCartParam) {
+  const res = await request.get<ApiResult<ShopCart[]>>(
+    '/shop/shop-cart',
+    params
+  );
+  if (res.code === 0 && res.data) {
+    return res.data;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 获取购物车分页列表
+ */
+export async function pageShopCart(params: ShopCartParam) {
+  const res = await request.get<ApiResult<{ list: ShopCart[]; count: number }>>(
+    '/shop/shop-cart/page',
+    params
+  );
+  if (res.code === 0 && res.data) {
+    return res.data;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 获取购物车数量
+ */
+export async function getShopCartCount() {
+  const res = await request.get<ApiResult<{ count: number }>>(
+    '/shop/shop-cart/count'
+  );
+  if (res.code === 0 && res.data) {
+    return res.data.count;
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 添加商品到购物车
+ */
+export async function addToCart(data: AddToCartParam) {
+  const res = await request.post<ApiResult<unknown>>(
+    '/shop/shop-cart',
+    data
+  );
+  if (res.code === 0) {
+    return res.message || '添加成功';
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 更新购物车商品数量
+ */
+export async function updateCartNum(data: UpdateCartNumParam) {
+  const res = await request.put<ApiResult<unknown>>(
+    '/shop/shop-cart/' + data.id,
+    { quantity: data.num }
+  );
+  if (res.code === 0) {
+    return res.message || '更新成功';
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 更新购物车商品选中状态
+ */
+export async function updateCartChecked(id: number, checked: boolean) {
+  const res = await request.put<ApiResult<unknown>>(
+    '/shop/shop-cart/' + id,
+    { selected: checked }
+  );
+  if (res.code === 0) {
+    return res.message || '更新成功';
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 全选/取消全选购物车
+ */
+export async function updateCartAllChecked(checked: boolean) {
+  const res = await request.put<ApiResult<unknown>>(
+    '/shop/shop-cart/selected',
+    { selected: checked }
+  );
+  if (res.code === 0) {
+    return res.message || '更新成功';
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 删除购物车商品
+ */
+export async function removeShopCart(id: number) {
+  const res = await request.del<ApiResult<unknown>>(
+    '/shop/shop-cart/' + id
+  );
+  if (res.code === 0) {
+    return res.message || '删除成功';
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 批量删除购物车商品
+ */
+export async function removeBatchShopCart(ids: number[]) {
+  const res = await request.del<ApiResult<unknown>>(
+    '/shop/shop-cart/batch',
+    { ids }
+  );
+  if (res.code === 0) {
+    return res.message || '删除成功';
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 清空购物车
+ */
+export async function clearShopCart() {
+  const res = await request.del<ApiResult<unknown>>(
+    '/shop/shop-cart/clear'
+  );
+  if (res.code === 0) {
+    return res.message || '清空成功';
+  }
+  return Promise.reject(new Error(res.message));
+}
+
+/**
+ * 获取购物车详情
+ */
+export async function getShopCart(id: number) {
+  const res = await request.get<ApiResult<ShopCart>>(
+    '/shop/shop-cart/' + id
+  );
+  if (res.code === 0 && res.data) {
+    return res.data;
+  }
+  return Promise.reject(new Error(res.message));
+}

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

@@ -0,0 +1,74 @@
+import type { PageParam } from '@/api';
+
+/**
+ * 购物车项
+ */
+export interface ShopCart {
+  // 主键ID
+  id?: number;
+  // 用户ID
+  userId?: number;
+  // 商品ID
+  goodsId?: number;
+  // SKU ID
+  skuId?: number;
+  // 数量
+  num?: number;
+  // 商品名称
+  goodsName?: string;
+  // 商品图片
+  goodsImage?: string;
+  // SKU价格
+  skuPrice?: string;
+  // SKU规格
+  skuSpec?: string;
+  // 库存
+  stock?: number;
+  // 租户id
+  tenantId?: number;
+  // 创建时间
+  createTime?: string;
+  // 更新时间
+  updateTime?: string;
+}
+
+/**
+ * 购物车项扩展（包含选中状态，用于前端展示）
+ */
+export interface ShopCartItem extends ShopCart {
+  // 是否选中
+  checked?: boolean;
+  // 商品详情
+  product?: any;
+  // SKU详情
+  sku?: any;
+}
+
+/**
+ * 添加到购物车参数
+ */
+export interface AddToCartParam {
+  // 商品ID
+  goodsId: number;
+  // SKU ID（单规格可不传）
+  skuId?: number;
+  // 数量
+  num: number;
+}
+
+/**
+ * 更新购物车数量参数
+ */
+export interface UpdateCartNumParam {
+  // 购物车ID
+  id: number;
+  // 数量
+  num: number;
+}
+
+/**
+ * 购物车搜索条件
+ */
+export interface ShopCartParam extends PageParam {
+  userId?: number;
+}