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

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

src_bak/hooks/useAddress.ts

@@ -0,0 +1,98 @@
+import { useState, useCallback } from 'react'
+import {
+  listShopUserAddress,
+  getShopUserAddress,
+  addShopUserAddress,
+  updateShopUserAddress,
+  removeShopUserAddress,
+  setDefaultAddress,
+} from '@/api/shop/shopUserAddress'
+import type { ShopUserAddress } from '@/api/shop/shopUserAddress/model'
+
+interface UseAddressReturn {
+  addresses: ShopUserAddress[]
+  loading: boolean
+  defaultAddress: ShopUserAddress | null
+  loadAddresses: () => Promise<void>
+  getAddress: (id: number) => Promise<ShopUserAddress | null>
+  addAddress: (data: Partial<ShopUserAddress>) => Promise<boolean>
+  updateAddress: (data: ShopUserAddress) => Promise<boolean>
+  deleteAddress: (id: number) => Promise<boolean>
+  setDefault: (id: number) => Promise<boolean>
+}
+
+export function useAddress(): UseAddressReturn {
+  const [addresses, setAddresses] = useState<ShopUserAddress[]>([])
+  const [loading, setLoading] = useState(false)
+
+  const loadAddresses = useCallback(async () => {
+    setLoading(true)
+    try {
+      const list = await listShopUserAddress()
+      // 调试日志：可看到解析后的地址数量与首项
+      // eslint-disable-next-line no-console
+      console.log('[useAddress] loaded addresses:', Array.isArray(list) ? list.length : 0,
+        list && (list as any[]).length > 0 ? JSON.stringify(list[0])?.substring(0, 200) : '(empty)')
+      setAddresses(Array.isArray(list) ? list : [])
+    } catch (error: any) {
+      // eslint-disable-next-line no-console
+      console.error('[useAddress] Load addresses error:', error?.message || error)
+      setAddresses([])
+    } finally {
+      setLoading(false)
+    }
+  }, [])
+
+  /** 根据 ID 获取单个地址 */
+  const getAddress = useCallback(async (id: number): Promise<ShopUserAddress | null> => {
+    try {
+      return await getShopUserAddress(id)
+    } catch {
+      return null
+    }
+  }, [])
+
+  const addAddress = useCallback(async (data: Partial<ShopUserAddress>): Promise<boolean> => {
+    try {
+      await addShopUserAddress(data as any)
+      await loadAddresses()
+      return true
+    } catch {
+      return false
+    }
+  }, [loadAddresses])
+
+  const updateAddress = useCallback(async (data: ShopUserAddress): Promise<boolean> => {
+    try {
+      await updateShopUserAddress(data)
+      await loadAddresses()
+      return true
+    } catch {
+      return false
+    }
+  }, [loadAddresses])
+
+  const deleteAddress = useCallback(async (id: number): Promise<boolean> => {
+    try {
+      await removeShopUserAddress(id)
+      setAddresses(prev => prev.filter(a => a.id !== id))
+      return true
+    } catch {
+      return false
+    }
+  }, [])
+
+  const setDefault = useCallback(async (id: number): Promise<boolean> => {
+    try {
+      await setDefaultAddress(id)
+      await loadAddresses()
+      return true
+    } catch {
+      return false
+    }
+  }, [loadAddresses])
+
+  const defaultAddress = addresses.find(a => a.isDefault) || addresses[0] || null
+
+  return { addresses, loading, defaultAddress, loadAddresses, getAddress, addAddress, updateAddress, deleteAddress, setDefault }
+}