feat(order): 增加订单确认页面数量步长控制功能

- 在订单确认页面实现商品购买数量的步长控制机制 - 添加了商品模型中的step字段支持，用于定义购买步长 - 实现了水票套票模板的step配置和最小购买数量逻辑 - 优化了订单参数解析逻辑，支持orderData模式下的商品规格信息传递 - 更新了API基础URL配置，切换到新的测试服务器地址 - 在下单接口中增加了skuId和specInfo参数传递支持 - 完善了数量变更时的价格计算和库存限制逻辑
2026-03-16 00:20:42 +08:00 · 2026-03-16 00:19:30 +08:00 · 2026-03-11 18:51:23 +08:00
5 changed files with 184 additions and 50 deletions
--- a/config/env.ts
+++ b/config/env.ts
@@ -2,21 +2,21 @@
 export const ENV_CONFIG = {
  // 开发环境
  development: {
-    // API_BASE_URL: 'http://127.0.0.1:9200/api',
-    API_BASE_URL: 'https://glt-api.websoft.top/api',
+    API_BASE_URL: 'http://127.0.0.1:9200/api',
+    // API_BASE_URL: 'https://glt-api2.websoft.top/api',
    APP_NAME: '开发环境',
    DEBUG: 'true',
  },
  // 生产环境
  production: {
-    API_BASE_URL: 'https://glt-api.websoft.top/api',
+    API_BASE_URL: 'https://glt-api2.websoft.top/api',
    APP_NAME: '桂乐淘',
    DEBUG: 'false',
  },
  // 测试环境
  test: {
    // API_BASE_URL: 'http://127.0.0.1:9200/api',
-    API_BASE_URL: 'https://glt-api.websoft.top/api',
+    API_BASE_URL: 'https://glt-api2.websoft.top/api',
    APP_NAME: '测试环境',
    DEBUG: 'true',
  }
--- a/src/api/glt/gltTicketTemplate/model/index.ts
+++ b/src/api/glt/gltTicketTemplate/model/index.ts
@@ -16,6 +16,8 @@ export interface GltTicketTemplate {
  unitName?: string;
  // 最小购买数量
  minBuyQty?: number;
+  // 购买步长（如：5 的倍数）
+  step?: number;
  // 起始发送数量
  startSendQty?: number;
  // 买赠：买1送4 => gift_multiplier=4
--- a/src/api/shop/shopGoods/model/index.ts
+++ b/src/api/shop/shopGoods/model/index.ts
@@ -81,6 +81,8 @@ export interface ShopGoods {
  isNew?: number;
  // 库存
  stock?: number;
+  // 步长
+  step?: number;
  // 商品重量
  goodsWeight?: number;
  // 消费赚取积分
--- a/src/shop/orderConfirm/index.tsx
+++ b/src/shop/orderConfirm/index.tsx
@@ -1,4 +1,4 @@
-import {useEffect, useState} from "react";
+import {useEffect, useMemo, useState} from "react";
 import {
  Image,
  Button,
@@ -82,17 +82,62 @@ const OrderConfirm = () => {
  const [selectedStore, setSelectedStore] = useState<ShopStore | null>(getSelectedStoreFromStorage())

  const router = Taro.getCurrentInstance().router;
-  const goodsId = router?.params?.goodsId;
+  const params = router?.params || ({} as Record<string, any>)
+  const goodsIdParam = params?.goodsId
+  const orderDataRaw = params?.orderData
+
+  type OrderDataParam = {
+    goodsId?: number | string
+    skuId?: number | string
+    quantity?: number | string
+    price?: number | string
+    specInfo?: string
+  }
+
+  const orderDataParam: OrderDataParam | null = useMemo(() => {
+    if (!orderDataRaw) return null
+    const rawText = String(orderDataRaw)
+    try {
+      return JSON.parse(decodeURIComponent(rawText)) as OrderDataParam
+    } catch (_e1) {
+      try {
+        return JSON.parse(rawText) as OrderDataParam
+      } catch (_e2) {
+        console.error('orderData 参数解析失败:', orderDataRaw)
+        return null
+      }
+    }
+  }, [orderDataRaw])
+
+  const resolvedGoodsId = (() => {
+    const id1 = Number(goodsIdParam)
+    if (Number.isFinite(id1) && id1 > 0) return id1
+    const id2 = Number(orderDataParam?.goodsId)
+    if (Number.isFinite(id2) && id2 > 0) return id2
+    return undefined
+  })()
+
+  const resolvedSkuId = (() => {
+    const n = Number(orderDataParam?.skuId)
+    return Number.isFinite(n) && n > 0 ? n : undefined
+  })()
+
+  const quantityFromParam = (() => {
+    const n = Number(orderDataParam?.quantity)
+    return Number.isFinite(n) && n > 0 ? Math.floor(n) : undefined
+  })()

  // 页面级兜底：未登录直接进入下单页时，引导去注册/登录并回跳
  useEffect(() => {
-    if (!goodsId) {
-      // 也可能是 orderData 模式；这里只做最小兜底
-      if (!ensureLoggedIn('/shop/orderConfirm/index')) return
-      return
-    }
-    if (!ensureLoggedIn(`/shop/orderConfirm/index?goodsId=${goodsId}`)) return
-  }, [goodsId])
+    // 兼容 goodsId / orderData 两种进入方式（goodsDetail 有规格时会走 orderData）
+    const backUrl =
+      orderDataRaw
+        ? `/shop/orderConfirm/index?orderData=${orderDataRaw}`
+        : resolvedGoodsId
+          ? `/shop/orderConfirm/index?goodsId=${resolvedGoodsId}`
+          : '/shop/orderConfirm/index'
+    if (!ensureLoggedIn(backUrl)) return
+  }, [resolvedGoodsId, orderDataRaw])

  const isTicketTemplateActive =
    !!ticketTemplate &&
@@ -142,7 +187,9 @@ const OrderConfirm = () => {
  // 计算商品总价
  const getGoodsTotal = () => {
    if (!goods) return 0
-    const price = parseFloat(goods.price || '0')
+    const rawPrice = String(orderDataParam?.price ?? goods.price ?? '0')
+    const priceNum = parseFloat(rawPrice)
+    const price = Number.isFinite(priceNum) ? priceNum : 0
    // const total = price * quantity

    // 🔍 详细日志，用于排查数值精度问题
@@ -183,12 +230,21 @@ const OrderConfirm = () => {
  const handleQuantityChange = (value: string | number) => {
    const fallback = isTicketTemplateActive ? minBuyQty : 1
    const newQuantity = typeof value === 'string' ? parseInt(value, 10) || fallback : value
-    const finalQuantity = Math.max(fallback, Math.min(newQuantity, goods?.stock || 999))
+    const step = goods?.step || 1
+    const stockMax = goods?.stock ?? 999
+    const maxMultiple = step > 1 ? Math.floor(stockMax / step) * step : stockMax
+    const maxAllowed = maxMultiple > 0 ? maxMultiple : stockMax
+    const effectiveMin = Math.min(fallback, maxAllowed)
+    const clamped = Math.max(effectiveMin, Math.min(Number(newQuantity) || fallback, maxAllowed))
+    const snapped = step > 1 ? Math.ceil(clamped / step) * step : clamped
+    const finalQuantity = Math.max(effectiveMin, Math.min(snapped, maxAllowed))
    setQuantity(finalQuantity)

    // 数量变化时，重新排序优惠券并检查当前选中的优惠券是否还可用
    if (availableCoupons.length > 0) {
-      const newTotal = parseFloat(goods?.price || '0') * finalQuantity
+      const priceNum = parseFloat(String(orderDataParam?.price ?? goods?.price ?? '0'))
+      const unitPrice = Number.isFinite(priceNum) ? priceNum : 0
+      const newTotal = unitPrice * finalQuantity
      const sortedCoupons = sortCoupons(availableCoupons, newTotal)
      const usableCoupons = filterUsableCoupons(sortedCoupons, newTotal)
      setAvailableCoupons(sortedCoupons)
@@ -497,7 +553,9 @@ const OrderConfirm = () => {
                  comments: goods.name,
                  deliveryType: 0,
                  buyerRemarks: orderRemark,
-                  couponId: parseInt(String(bestCoupon.id), 10)
+                  couponId: parseInt(String(bestCoupon.id), 10),
+                  skuId: resolvedSkuId,
+                  specInfo: orderDataParam?.specInfo
                }
              );

@@ -507,6 +565,7 @@ const OrderConfirm = () => {
              await PaymentHandler.pay(updatedOrderData, currentPaymentType, hasTicketTemplate ? {
                onSuccess: async () => {
                  const id = goods.goodsId
+                  const ticketIndexUrl = `/user/ticket/index?fromPayAt=${Date.now()}`
                  try {
                    const res = await Taro.showModal({
                      title: '提示',
@@ -518,13 +577,13 @@ const OrderConfirm = () => {
                      if (id) {
                        await Taro.redirectTo({ url: `/user/ticket/use?goodsId=${id}` })
                      } else {
-                        await Taro.redirectTo({ url: '/user/ticket/index' })
+                        await Taro.redirectTo({ url: ticketIndexUrl })
                      }
                    } else {
-                      await Taro.redirectTo({ url: '/user/ticket/index' })
+                      await Taro.redirectTo({ url: ticketIndexUrl })
                    }
                  } catch (_e) {
-                    await Taro.redirectTo({ url: '/user/ticket/index' })
+                    await Taro.redirectTo({ url: ticketIndexUrl })
                  }
                  return false
                }
@@ -547,7 +606,9 @@ const OrderConfirm = () => {
          deliveryType: 0,
          buyerRemarks: orderRemark,
          // 🔧 确保 couponId 是正确的数字类型，且不传递 undefined
-          couponId: selectedCoupon ? parseInt(String(selectedCoupon.id), 10) : undefined
+          couponId: selectedCoupon ? parseInt(String(selectedCoupon.id), 10) : undefined,
+          skuId: resolvedSkuId,
+          specInfo: orderDataParam?.specInfo
        }
      );

@@ -583,6 +644,7 @@ const OrderConfirm = () => {
      await PaymentHandler.pay(orderData, paymentType, hasTicketTemplate ? {
        onSuccess: async () => {
          const id = goods.goodsId
+          const ticketIndexUrl = `/user/ticket/index?fromPayAt=${Date.now()}`
          try {
            const res = await Taro.showModal({
              title: '提示',
@@ -594,13 +656,13 @@ const OrderConfirm = () => {
              if (id) {
                await Taro.redirectTo({ url: `/user/ticket/use?goodsId=${id}` })
              } else {
-                await Taro.redirectTo({ url: '/user/ticket/index' })
+                await Taro.redirectTo({ url: ticketIndexUrl })
              }
            } else {
-              await Taro.redirectTo({ url: '/user/ticket/index' })
+              await Taro.redirectTo({ url: ticketIndexUrl })
            }
          } catch (_e) {
-            await Taro.redirectTo({ url: '/user/ticket/index' })
+            await Taro.redirectTo({ url: ticketIndexUrl })
          }
          return false
        }
@@ -682,8 +744,8 @@ const OrderConfirm = () => {

      // 分别加载数据，避免类型推断问题
      let goodsRes: ShopGoods | null = null
-      if (goodsId) {
-        goodsRes = await getShopGoods(Number(goodsId))
+      if (resolvedGoodsId) {
+        goodsRes = await getShopGoods(resolvedGoodsId)
      }

      const [addressRes, paymentRes] = await Promise.all([
@@ -694,9 +756,9 @@ const OrderConfirm = () => {
      // 设置商品信息
      // 查询当前商品是否存在水票套票活动（失败/无数据时不影响正常下单）
      let tpl: GltTicketTemplate | null = null
-      if (goodsId) {
+      if (resolvedGoodsId) {
        try {
-          tpl = await getGltTicketTemplateByGoodsId(Number(goodsId))
+          tpl = await getGltTicketTemplateByGoodsId(resolvedGoodsId)
        } catch (e) {
          tpl = null
        }
@@ -712,18 +774,41 @@ const OrderConfirm = () => {
        const n = Number(tpl?.minBuyQty)
        return Number.isFinite(n) && n > 0 ? Math.floor(n) : 1
      })()
+      const tplStep = (() => {
+        const n = Number(tpl?.step)
+        return Number.isFinite(n) && n > 0 ? Math.floor(n) : undefined
+      })()

      // 设置商品信息（若存在套票模板，则默认 canBuyNumber 使用模板最小购买量）
      if (goodsRes) {
        const patchedGoods: ShopGoods = { ...goodsRes }
+        // 兜底：确保 step 为合法正整数；若存在套票模板则优先使用模板 step
+        const goodsStepNum = Number((patchedGoods as any)?.step)
+        const goodsStep = Number.isFinite(goodsStepNum) && goodsStepNum > 0 ? Math.floor(goodsStepNum) : 1
+        patchedGoods.step = tplActive && tplStep ? tplStep : goodsStep
+
+        // 规格商品（orderData 模式）下单时，用 sku 价格覆盖展示与计算金额
+        if (orderDataParam?.price !== undefined && orderDataParam?.price !== null && orderDataParam?.price !== '') {
+          patchedGoods.price = String(orderDataParam.price)
+        }
+
        if (tplActive && ((patchedGoods.canBuyNumber ?? 0) === 0)) {
          patchedGoods.canBuyNumber = tplMinBuyQty
        }
        setGoods(patchedGoods)

-        // 设置默认购买数量：优先使用 canBuyNumber，否则使用 1
-        const initQty = (patchedGoods.canBuyNumber ?? 0) > 0 ? (patchedGoods.canBuyNumber as number) : 1
-        setQuantity(initQty)
+        // 设置默认购买数量：优先使用 canBuyNumber，其次使用路由参数 quantity，否则使用 1
+        const fixedQty = (patchedGoods.canBuyNumber ?? 0) > 0 ? Number(patchedGoods.canBuyNumber) : undefined
+        const rawQty = fixedQty ?? quantityFromParam ?? 1
+        const minQty = tplActive ? tplMinBuyQty : 1
+        const step = patchedGoods.step || 1
+        const stockMax = patchedGoods.stock ?? 999
+        const maxMultiple = step > 1 ? Math.floor(stockMax / step) * step : stockMax
+        const maxAllowed = maxMultiple > 0 ? maxMultiple : stockMax
+        const effectiveMin = Math.min(minQty, maxAllowed)
+        const clamped = Math.max(effectiveMin, Math.min(Math.floor(rawQty), maxAllowed))
+        const stepped = step > 1 ? Math.ceil(clamped / step) * step : clamped
+        setQuantity(Math.min(maxAllowed, Math.max(effectiveMin, stepped)))
      }

      setTicketTemplate(tpl)
@@ -748,9 +833,20 @@ const OrderConfirm = () => {
          const n = Number(goodsRes?.canBuyNumber)
          if (Number.isFinite(n) && n > 0) return Math.floor(n)
          if (tplActive) return tplMinBuyQty
-          return 1
+          return quantityFromParam || 1
        })()
-        const total = parseFloat(goodsRes.price || '0') * initQty
+        const stepForInit = tplActive && tplStep ? tplStep : (() => {
+          const n = Number((goodsRes as any)?.step)
+          return Number.isFinite(n) && n > 0 ? Math.floor(n) : 1
+        })()
+        const stockMax = goodsRes.stock ?? 999
+        const maxMultiple = stepForInit > 1 ? Math.floor(stockMax / stepForInit) * stepForInit : stockMax
+        const maxAllowed = maxMultiple > 0 ? maxMultiple : stockMax
+        const initQtySnapped = stepForInit > 1 ? Math.ceil(initQty / stepForInit) * stepForInit : initQty
+        const effectiveMin = Math.min(tplActive ? tplMinBuyQty : 1, maxAllowed)
+        const safeInitQty = Math.max(effectiveMin, Math.min(initQtySnapped, maxAllowed))
+        const unitPrice = parseFloat(String(orderDataParam?.price ?? goodsRes.price ?? '0'))
+        const total = unitPrice * safeInitQty
        await loadUserCoupons(total)
      }
    } catch (err) {
@@ -771,7 +867,7 @@ const OrderConfirm = () => {
  useEffect(() => {
    if (!isLoggedIn()) return
    loadAllData()
-  }, [goodsId]);
+  }, [resolvedGoodsId, orderDataRaw]);

  // 重新加载数据
  const handleRetry = () => {
@@ -868,7 +964,7 @@ const OrderConfirm = () => {
 	                      value={quantity}
 	                      min={isTicketTemplateActive ? minBuyQty : 1}
 	                      max={goods.stock || 999}
-	                      step={minBuyQty === 1 ? 1 : 10}
+	                      step={goods.step || 1}
 	                      readOnly
                        disabled={((goods.canBuyNumber ?? 0) !== 0) && !isTicketTemplateActive}
 	                      onChange={handleQuantityChange}
--- a/src/user/ticket/index.tsx
+++ b/src/user/ticket/index.tsx
@@ -1,4 +1,4 @@
-import { useState } from 'react';
+import { useRef, useState } from 'react';
 import Taro, { useDidShow } from '@tarojs/taro';
 import {
  Button,
@@ -23,6 +23,7 @@ import dayjs from "dayjs";
 import { ensureLoggedIn } from '@/utils/auth';

 const PAGE_SIZE = 10;
+const PAY_REFRESH_HANDLED_KEY = 'user_ticket_from_pay_at_handled';

 const UserTicketList = () => {
  const [ticketList, setTicketList] = useState<GltUserTicket[]>([]);
@@ -47,6 +48,25 @@ const UserTicketList = () => {
  const [qrVisible, setQrVisible] = useState(false);
  const [qrTicket, setQrTicket] = useState<GltUserTicket | null>(null);
  const [qrImageUrl, setQrImageUrl] = useState('');
+  const payAutoRefreshRunningRef = useRef(false);
+
+  const sleep = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));
+
+  const parsePositiveNumberParam = (v: unknown) => {
+    const n = Number(v);
+    return Number.isFinite(n) && n > 0 ? n : undefined;
+  };
+
+  const getFromPayAtParam = () => {
+    const params = Taro.getCurrentInstance().router?.params;
+    return parsePositiveNumberParam((params as any)?.fromPayAt);
+  };
+
+  const shouldAutoRefreshAfterPay = (fromPayAt?: number) => {
+    if (!fromPayAt) return false;
+    const handled = parsePositiveNumberParam(Taro.getStorageSync(PAY_REFRESH_HANDLED_KEY)) || 0;
+    return handled !== fromPayAt;
+  };

  const getUserId = () => {
    const raw = Taro.getStorageSync('UserId');
@@ -530,22 +550,36 @@ const UserTicketList = () => {
  }

  useDidShow(() => {
-    const tabParam = Taro.getCurrentInstance().router?.params?.tab
-    const nextTab =
-      tabParam === 'ticket' || tabParam === 'order'
-        ? tabParam
-        : undefined
+    void (async () => {
+      const tabParam = Taro.getCurrentInstance().router?.params?.tab;
+      const nextTab = tabParam === 'ticket' || tabParam === 'order' ? tabParam : undefined;

-    if (nextTab && nextTab !== activeTab) {
-      setActiveTab(nextTab)
-    }
+      if (nextTab && nextTab !== activeTab) {
+        setActiveTab(nextTab);
+      }

-    const tabToLoad = nextTab || activeTab
-    if (tabToLoad === 'ticket') {
-      reloadTickets(true).then()
-    } else {
-      reloadOrders(true).then()
-    }
+      const tabToLoad = nextTab || activeTab;
+      if (tabToLoad === 'ticket') {
+        await reloadTickets(true);
+
+        const fromPayAt = getFromPayAtParam();
+        if (shouldAutoRefreshAfterPay(fromPayAt) && !payAutoRefreshRunningRef.current) {
+          payAutoRefreshRunningRef.current = true;
+          try {
+            Taro.setStorageSync(PAY_REFRESH_HANDLED_KEY, fromPayAt);
+            // 支付后水票可能异步入账：自动再刷新几次，避免用户手动下拉刷新。
+            for (const delayMs of [800, 1500, 2500]) {
+              await sleep(delayMs);
+              await reloadTickets(true);
+            }
+          } finally {
+            payAutoRefreshRunningRef.current = false;
+          }
+        }
+      } else {
+        await reloadOrders(true);
+      }
+    })();
  })

  return (