feat: 更新电子卡券卡密详情页及相关逻辑

- 修改卡密详情页以支持多种卡密展示，优化卡密信息的结构和样式
- 增加卡密履约状态管理，支持卡密发放状态的显示
- 更新 utils/goodsType.js，增加卡密履约状态的处理逻辑
- 优化数据加载逻辑，确保卡密信息的准确性和完整性

pages/order/cardKey/cardKeyDetail.vue

@@ -1,6 +1,6 @@
 <!--
   @Author Mike
-  @Date 2026-07-31
+  @Date 2026-08-03
 -->
 <template>
   <view class="card-key-page">
@@ -11,21 +11,34 @@
     </view>
     <view v-else>
       <view
-        class="card-key-item"
-        v-for="(row, index) in cardKeyRows"
-        :key="`${row.cardNo || index}-${index}`"
+        v-for="(line, lineIndex) in cardKeyFulfillLines"
+        :key="line.key || lineIndex"
+        class="card-key-fulfill-block"
       >
-        <view class="card-key-item__title">卡密 {{ index + 1 }}</view>
-        <view class="card-key-item__row">
-          <text class="card-key-item__label">卡号：</text>
-          <text class="card-key-item__value">{{ row.cardNo || '-' }}</text>
+        <view v-if="cardKeyFulfillLines.length > 1" class="card-key-fulfill-title">
+          {{ line.goodsName || (line.isGift ? '满赠电子卡券' : '电子卡券') }}
         </view>
-        <view class="card-key-item__row">
-          <text class="card-key-item__label">卡密：</text>
-          <text class="card-key-item__value">{{ row.cardSecret || '-' }}</text>
-        </view>
-        <view class="card-key-item__actions">
-          <view class="card-key-item__copy" @click="copyCardKey(row)">复制</view>
+        <view
+          class="card-key-item"
+          v-for="(row, index) in line.cardKeys"
+          :key="`${line.key}-${row.cardNo || index}-${index}`"
+        >
+          <view class="card-key-item__title">卡密 {{ index + 1 }}</view>
+          <view class="card-key-item__row">
+            <text class="card-key-item__label">卡号：</text>
+            <text class="card-key-item__value card-key-item__value--plain" selectable>{{
+              row.cardNo || '-'
+            }}</text>
+          </view>
+          <view class="card-key-item__row">
+            <text class="card-key-item__label">卡密：</text>
+            <text class="card-key-item__value card-key-item__value--plain" selectable>{{
+              row.cardSecret || '-'
+            }}</text>
+          </view>
+          <view class="card-key-item__actions">
+            <view class="card-key-item__copy" @click="copyCardKey(row)">复制</view>
+          </view>
         </view>
       </view>
       <view class="card-key-page__footer">
@@ -37,12 +50,8 @@
 
 <script setup lang="ts">
 /**
- * @Author Mike
- * @Date 2026-07-31
- *
  * 电子卡券卡密二级页（原型 P-09）。
- * 数据来源：GET /buyer/order/order/{orderSn} → orderItems[].cardKeys；
- * 不展示过期时间；未发卡/非 E_COUPON 订单不泄露 cardSecret。
+ * 数据来源：GET /buyer/order/order/{orderSn} → orderItems[].cardKeys（明文 cardSecret）。
  */
 import { ref, computed } from 'vue'
 import { onLoad, onPullDownRefresh } from '@dcloudio/uni-app'
@@ -50,22 +59,40 @@ import { getOrderDetail } from '@/api/order.js'
 import { setClipboard } from '@/utils/filters.js'
 import {
   isECouponOrder,
+  collectCardKeyFulfillLines,
   flattenOrderCardKeys,
-  isCardKeyDelivered,
+  resolveCardKeyFulfillMessage,
+  CARD_KEY_FULFILL_STATUS,
 } from '@/utils/goodsType.js'
 
 const orderSn = ref('')
 const loading = ref(true)
 const errorMessage = ref('')
 const orderItems = ref<any[]>([])
+const giftECouponOrders = ref<any[]>([])
 const orderStatus = ref('')
 
-const cardKeyRows = computed(() => flattenOrderCardKeys(orderItems.value))
+const cardKeyFulfillLines = computed(() =>
+  collectCardKeyFulfillLines(orderItems.value, giftECouponOrders.value).filter(
+    (line) => line.status === CARD_KEY_FULFILL_STATUS.DELIVERED && line.cardKeys.length
+  )
+)
+
+const cardKeyRows = computed(() =>
+  flattenOrderCardKeys(orderItems.value, false, giftECouponOrders.value)
+)
 
 const emptyMessage = computed(() => {
   if (orderStatus.value === 'CANCELLED') {
     return '订单已关闭，暂无卡密信息'
   }
+  const pending = collectCardKeyFulfillLines(
+    orderItems.value,
+    giftECouponOrders.value
+  ).find((line) => line.status !== CARD_KEY_FULFILL_STATUS.DELIVERED)
+  if (pending) {
+    return resolveCardKeyFulfillMessage(pending)
+  }
   if (orderStatus.value === 'COMPLETED') {
     return '卡密尚未发放，请稍后刷新'
   }
@@ -99,16 +126,16 @@ function loadData(fromPullDown = false) {
         return
       }
       const result = res.data.result
-      if (!isECouponOrder(result?.order?.orderType)) {
-        errorMessage.value = '该订单不是电子卡券订单'
+      const isEcoupon = isECouponOrder(result?.order?.orderType)
+      const hasGiftEcoupon =
+        Array.isArray(result?.giftECouponOrders) && result.giftECouponOrders.length > 0
+      if (!isEcoupon && !hasGiftEcoupon) {
+        errorMessage.value = '该订单没有电子卡券卡密'
         return
       }
       orderItems.value = result.orderItems || []
+      giftECouponOrders.value = result.giftECouponOrders || []
       orderStatus.value = result.order?.orderStatus || ''
-      // 未 cardKeyDelivered 时不展示卡密（UNPAID/PAID 发卡中或发卡失败）
-      if (!isCardKeyDelivered(orderItems.value)) {
-        orderItems.value = []
-      }
     })
     .catch(() => {
       errorMessage.value = '加载失败，请稍后重试'
@@ -154,6 +181,12 @@ function copyAllCardKeys() {
   font-size: 28rpx;
 }
 
+.card-key-fulfill-title {
+  font-size: 26rpx;
+  color: #666;
+  margin-bottom: 12rpx;
+}
+
 .card-key-item {
   background: #fff;
   border-radius: 20rpx;
@@ -186,6 +219,11 @@ function copyAllCardKeys() {
   word-break: break-all;
 }
 
+.card-key-item__value--plain {
+  font-family: monospace;
+  flex: 1;
+}
+
 .card-key-item__actions {
   display: flex;
   justify-content: flex-end;

utils/goodsType.js

@@ -1,6 +1,6 @@
 /**
  * @Author Mike
- * @Date 2026-07-31
+ * @Date 2026-08-03
  *
  * 卡密商品（电子卡券 E_COUPON）类型与订单工具。
  *
@@ -71,18 +71,105 @@ export function hasECouponInCheckout(orderMessage) {
   )
 }
 
-/** 将 orderItems[].cardKeys 展平为列表，供卡密二级页展示 */
-export function flattenOrderCardKeys(orderItems) {
-  const rows = []
+/** 卡密履约状态（与后端 CardKeyFulfillStatusEnum 一致） */
+export const CARD_KEY_FULFILL_STATUS = {
+  PENDING: 'PENDING',
+  DELIVERED: 'DELIVERED',
+  FAILED: 'FAILED',
+  NOT_APPLICABLE: 'NOT_APPLICABLE',
+}
+
+export const CARD_KEY_FULFILL_STATUS_TEXT = {
+  PENDING: '待发放',
+  DELIVERED: '已发放',
+  FAILED: '发放失败',
+  NOT_APPLICABLE: '不适用',
+}
+
+export function resolveCardKeyFulfillMessage(line) {
+  if (line && line.message) return line.message
+  return CARD_KEY_FULFILL_STATUS_TEXT[line?.status] || line?.status || '—'
+}
+
+export function isCardKeyFulfillApplicable(item) {
+  if (!item) return false
+  const status = item.cardKeyFulfillStatus
+  if (status) return status !== CARD_KEY_FULFILL_STATUS.NOT_APPLICABLE
+  if (item.cardKeyDelivered != null || (item.cardKeys && item.cardKeys.length)) {
+    return true
+  }
+  return item.goodsType === E_COUPON_GOODS_TYPE
+}
+
+function normalizeCardKeyFulfillLine(source) {
+  const status =
+    source.cardKeyFulfillStatus ||
+    (source.cardKeyDelivered
+      ? CARD_KEY_FULFILL_STATUS.DELIVERED
+      : CARD_KEY_FULFILL_STATUS.PENDING)
+  const cardKeys =
+    status === CARD_KEY_FULFILL_STATUS.DELIVERED ? source.cardKeys || [] : []
+  return {
+    key: source.sn || source.orderSn || source.id || source.skuId,
+    goodsName: source.goodsName,
+    status,
+    message: source.cardKeyFulfillMessage,
+    cardKeys,
+    isGift: !!source.isGift,
+  }
+}
+
+/** 汇总 E_COUPON 主单行 + 满赠子单摘要的履约行 */
+export function collectCardKeyFulfillLines(orderItems = [], giftSummaries = []) {
+  const lines = []
   ;(orderItems || []).forEach((item) => {
-    ;(item.cardKeys || []).forEach((ck) => {
-      rows.push({ ...ck })
+    if (!isCardKeyFulfillApplicable(item)) return
+    lines.push(normalizeCardKeyFulfillLine(item))
+  })
+  ;(giftSummaries || []).forEach((gift) => {
+    lines.push(normalizeCardKeyFulfillLine({ ...gift, isGift: true }))
+  })
+  return lines
+}
+
+function flattenCardKeyFulfillLines(lines, withGoodsName = false) {
+  const rows = []
+  ;(lines || []).forEach((line) => {
+    if (line.status !== CARD_KEY_FULFILL_STATUS.DELIVERED) return
+    ;(line.cardKeys || []).forEach((ck) => {
+      rows.push(withGoodsName ? { ...ck, goodsName: line.goodsName } : { ...ck })
     })
   })
   return rows
 }
 
-/** 是否已发卡（API-B-01：cardKeyDelivered 或 orderItems 内标记） */
-export function isCardKeyDelivered(orderItems) {
-  return (orderItems || []).some((item) => item.cardKeyDelivered)
+/** 订单是否含已交付卡密（含满赠 E_COUPON 子单） */
+export function orderHasCardKeyContent(orderItems, giftSummaries) {
+  const lines = collectCardKeyFulfillLines(orderItems, giftSummaries)
+  return flattenCardKeyFulfillLines(lines).length > 0
+}
+
+/** 将 orderItems[].cardKeys 展平为明文列表（DELIVERED 且含 cardSecret） */
+export function flattenOrderCardKeys(
+  orderItems,
+  withGoodsName = false,
+  giftSummaries
+) {
+  const lines = collectCardKeyFulfillLines(orderItems, giftSummaries)
+  if (lines.some((line) => line.status)) {
+    return flattenCardKeyFulfillLines(lines, withGoodsName)
+  }
+  const rows = []
+  ;(orderItems || []).forEach((item) => {
+    if (!item.cardKeyDelivered || !item.cardKeys || !item.cardKeys.length) return
+    item.cardKeys.forEach((ck) => {
+      rows.push(withGoodsName ? { ...ck, goodsName: item.goodsName } : { ...ck })
+    })
+  })
+  return rows
+}
+
+/** 是否已发卡（兼容旧调用；含满赠子单） */
+export function isCardKeyDelivered(orderItems, giftSummaries) {
+  return orderHasCardKeyContent(orderItems, giftSummaries)
 }