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

- 新增地址类型定义,增强前端地址数据结构
- 新增地址编辑页面,支持地址智能识别和定位选点功能
- 地址编辑支持省市区选择及默认地址设置
- 新增地址列表页面,支持地址展示、删除、编辑和选择功能
- 实现售后申请页面,支持选择售后类型和退款原因
- 售后申请支持商品选择、退款金额计算和凭证上传
- 新增售后详情页面,支持售后状态展示及申请取消
- 优化页面加载和用户交互体验,增加错误提示和权限处理
This commit is contained in:
2026-07-01 12:11:56 +08:00
parent bf6ed504cc
commit 1fa58040f3
636 changed files with 58878 additions and 716 deletions

View File

@@ -0,0 +1,15 @@
import { createContext, useContext } from 'react'
export interface AppContextType {
theme: 'light' | 'dark'
toggleTheme: () => void
}
const AppContext = createContext<AppContextType>({
theme: 'light',
toggleTheme: () => {}
})
export const useAppContext = () => useContext(AppContext)
export default AppContext

View File

@@ -0,0 +1,233 @@
import React, { createContext, useContext, useState, useCallback, type ReactNode } from 'react'
import Taro from '@tarojs/taro'
import { listShopCart, addToCart, updateCartNum, removeShopCart, removeBatchShopCart, updateCartAllChecked } from '@/api/shop/shopCart'
import type { ShopGoods, ShopGoodsSku } from '@/api/shop/shopGoods/model'
export interface CartItem {
id?: number
goodsId: number
skuId?: number
quantity: number
product?: ShopGoods
sku?: ShopGoodsSku
checked?: boolean
// 后端返回的字段
goodsName?: string
goodsImage?: string
skuPrice?: string
skuSpec?: string
stock?: number
}
interface CartContextType {
items: CartItem[]
totalCount: number
totalPrice: string
selectedItems: CartItem[]
selectedCount: number
selectedPrice: string
loading: boolean
refresh: () => Promise<void>
addItem: (product: ShopGoods, sku?: ShopGoodsSku, quantity?: number) => Promise<void>
removeItem: (goodsId: number, skuId?: number) => Promise<void>
updateQuantity: (goodsId: number, skuId: number | undefined, quantity: number) => Promise<void>
toggleSelect: (goodsId: number, skuId: number | undefined) => Promise<void>
selectAll: (checked: boolean) => Promise<void>
clearCart: () => Promise<void>
getItemQuantity: (goodsId: number, skuId?: number) => number
// 删除选中的商品
removeSelected: () => Promise<void>
}
const CartContext = createContext<CartContextType | undefined>(undefined)
export const CartProvider: React.FC<{ children: ReactNode }> = ({ children }) => {
const [items, setItems] = useState<CartItem[]>([])
const [loading, setLoading] = useState(false)
// 刷新购物车数据
const refresh = useCallback(async () => {
setLoading(true)
try {
const data = await listShopCart()
// 防御性检查:确保返回的是数组
const safeData = Array.isArray(data) ? data : []
// 转换为前端格式,默认都选中
const mappedItems: CartItem[] = safeData.map(item => ({
id: item.id,
goodsId: item.goodsId!,
skuId: item.skuId,
quantity: item.num || 1,
goodsName: item.goodsName,
goodsImage: item.goodsImage,
skuPrice: item.skuPrice,
skuSpec: item.skuSpec,
stock: item.stock,
checked: true,
}))
setItems(mappedItems)
} catch (err) {
console.error('刷新购物车失败', err)
setItems([])
} finally {
setLoading(false)
}
}, [])
// 添加商品到购物车
const addItem = useCallback(async (product: ShopGoods, sku?: ShopGoodsSku, quantity = 1) => {
try {
const params = {
goodsId: product.goodsId!,
num: quantity,
} as Record<string, unknown>
// 只有多规格商品才传 skuId且不能为 0
if (sku?.id && sku.id > 0) {
params.skuId = sku.id
}
await addToCart(params)
Taro.showToast({ title: '已加入购物车', icon: 'success' })
// 刷新购物车
await refresh()
} catch (err: any) {
console.error('[CartContext] 添加失败:', err)
Taro.showToast({ title: err.message || '添加失败', icon: 'none' })
throw err
}
}, [refresh])
// 删除商品
const removeItem = useCallback(async (goodsId: number, skuId?: number) => {
const item = items.find(i => i.goodsId === goodsId && i.skuId === skuId)
if (!item?.id) return
try {
await removeShopCart(item.id)
// 本地更新
setItems(prev => prev.filter(i => !(i.goodsId === goodsId && i.skuId === skuId)))
} catch (err: any) {
Taro.showToast({ title: err.message || '删除失败', icon: 'none' })
}
}, [items])
// 更新数量
const updateQuantity = useCallback(async (goodsId: number, skuId: number | undefined, quantity: number) => {
if (quantity <= 0) {
await removeItem(goodsId, skuId)
return
}
const item = items.find(i => i.goodsId === goodsId && i.skuId === skuId)
if (!item?.id) return
try {
await updateCartNum({ id: item.id, num: quantity })
// 本地更新
setItems(prev => prev.map(i =>
(i.goodsId === goodsId && i.skuId === skuId) ? { ...i, quantity } : i
))
} catch (err: any) {
Taro.showToast({ title: err.message || '更新失败', icon: 'none' })
}
}, [items, removeItem])
// 切换选中状态
const toggleSelect = useCallback(async (goodsId: number, skuId: number | undefined) => {
const item = items.find(i => i.goodsId === goodsId && i.skuId === skuId)
if (!item || !item.id) return
const newChecked = !item.checked
// 本地立即更新
setItems(prev => prev.map(i =>
(i.goodsId === goodsId && i.skuId === skuId) ? { ...i, checked: newChecked } : i
))
// 同步到后端
try {
await updateCartChecked(item.id, newChecked)
} catch (err) {
// API失败时回滚本地状态
setItems(prev => prev.map(i =>
(i.goodsId === goodsId && i.skuId === skuId) ? { ...i, checked: !newChecked } : i
))
console.error('更新选中状态失败', err)
}
}, [items])
// 全选/取消全选
const selectAll = useCallback(async (checked: boolean) => {
// 本地立即更新
setItems(prev => prev.map(i => ({ ...i, checked })))
// 尝试调用API
try {
await updateCartAllChecked(checked)
} catch (err) {
// API失败时静默处理本地状态已更新
}
}, [])
// 清空购物车
const clearCart = useCallback(async () => {
try {
await removeBatchShopCart(items.map(i => i.id!).filter(Boolean))
setItems([])
} catch (err: any) {
Taro.showToast({ title: err.message || '清空失败', icon: 'none' })
}
}, [items])
// 删除选中的商品
const removeSelected = useCallback(async () => {
const selected = items.filter(i => i.checked && i.id)
if (selected.length === 0) return
try {
await removeBatchShopCart(selected.map(i => i.id!))
setItems(prev => prev.filter(i => !i.checked))
Taro.showToast({ title: `已删除${selected.length}件商品`, icon: 'success' })
} catch (err: any) {
Taro.showToast({ title: err.message || '删除失败', icon: 'none' })
}
}, [items])
const getItemQuantity = useCallback((goodsId: number, skuId?: number): number => {
return items.find(i => i.goodsId === goodsId && i.skuId === skuId)?.quantity || 0
}, [items])
const calcPrice = (list: CartItem[]) =>
list.reduce((sum, i) => sum + Number(i.skuPrice || i.sku?.price || i.product?.salePrice || i.product?.price || 0) * i.quantity, 0).toFixed(2)
const selectedItems = items.filter(i => i.checked)
const selectedCount = selectedItems.reduce((s, i) => s + i.quantity, 0)
return (
<CartContext.Provider
value={{
items,
totalCount: items.reduce((s, i) => s + i.quantity, 0),
totalPrice: calcPrice(items),
selectedItems,
selectedCount,
selectedPrice: calcPrice(selectedItems),
loading,
refresh,
addItem,
removeItem,
updateQuantity,
toggleSelect,
selectAll,
clearCart,
getItemQuantity,
removeSelected,
}}
>
{children}
</CartContext.Provider>
)
}
export const useCartContext = (): CartContextType => {
const context = useContext(CartContext)
if (!context) throw new Error('useCartContext must be used within CartProvider')
return context
}

View File

@@ -0,0 +1,135 @@
import React, { createContext, useContext, useState, useEffect, type ReactNode } from 'react'
import Taro from '@tarojs/taro'
import type { User } from '@/api/system/user/model'
import { getUserInfo, loginByOpenId } from '@/api/layout'
import { saveStorageByLoginUser, clearStorageByLoginUser } from '@/utils/server'
import { TenantId } from '@/config/app'
interface UserContextType {
user: User | null
isLoggedIn: boolean
loading: boolean
loginUser: (token: string, userInfo: User) => void
logoutUser: () => void
refreshUser: () => Promise<User | null>
syncFromStorage: () => boolean
}
const UserContext = createContext<UserContextType | undefined>(undefined)
export const UserProvider: React.FC<{ children: ReactNode }> = ({ children }) => {
const [user, setUser] = useState<User | null>(null)
const [loading, setLoading] = useState(true)
useEffect(() => {
const init = async () => {
const token = Taro.getStorageSync('access_token')
const userData = Taro.getStorageSync('User')
// 情况1: 有本地token和用户数据直接使用
if (token && userData) {
const parsed = typeof userData === 'string' ? JSON.parse(userData) : userData
setUser(parsed as User)
setLoading(false)
return
}
// 情况2: 有token但没有用户数据尝试从接口获取
if (token) {
try {
const userInfo = await getUserInfo()
setUser(userInfo)
setLoading(false)
return
} catch {
// token无效清除并尝试静默登录
clearStorageByLoginUser()
}
}
// 情况3: 没有本地token尝试静默登录老用户自动登录
try {
const loginResult = await new Promise<{ access_token?: string; user?: User }>((resolve, reject) => {
Taro.login({
success: (res) => {
if (res.code) {
loginByOpenId({ code: res.code, tenantId: TenantId })
.then(resolve)
.catch(reject)
} else {
reject(new Error('no code'))
}
},
fail: reject,
})
})
// 静默登录成功(老用户),自动完成登录
if (loginResult?.access_token && loginResult?.user) {
saveStorageByLoginUser(loginResult.access_token, loginResult.user)
setUser(loginResult.user)
}
} catch {
// 静默登录失败(非老用户或网络问题),保持未登录状态
}
setLoading(false)
}
init()
}, [])
const loginUser = (token: string, userInfo: User) => {
saveStorageByLoginUser(token, userInfo)
setUser(userInfo)
}
const logoutUser = () => {
clearStorageByLoginUser()
setUser(null)
}
/** 从 storage 快速同步用户状态(无需网络请求),供页面 useDidShow 调用 */
const syncFromStorage = (): boolean => {
const token = Taro.getStorageSync('access_token')
const userData = Taro.getStorageSync('User')
if (token && userData) {
const parsed = typeof userData === 'string' ? JSON.parse(userData) : userData
setUser(parsed as User)
return true
}
if (!token) {
setUser(null)
}
return false
}
const refreshUser = async (): Promise<User | null> => {
if (!Taro.getStorageSync('access_token')) return null
try {
const userInfo = await getUserInfo()
const token = Taro.getStorageSync('access_token')
if (token) {
saveStorageByLoginUser(token, userInfo)
}
setUser(userInfo)
return userInfo
} catch {
return null
}
}
return (
<UserContext.Provider
value={{ user, isLoggedIn: !!user, loading, loginUser, logoutUser, refreshUser, syncFromStorage }}
>
{children}
</UserContext.Provider>
)
}
export const useUserContext = (): UserContextType => {
const context = useContext(UserContext)
if (!context) {
throw new Error('useUserContext must be used within UserProvider')
}
return context
}