feat(@vben/web-antd): add finance settlement page module

feat(member): implement points mall module pages

apps/web-antd/src/api/finance/index.ts

@@ -3,6 +3,8 @@
  */
 import { requestClient } from '#/api/request';
 
+export * from './settlement';
+
 /** 交易类型筛选值。 */
 export type FinanceTransactionTypeFilter =
   | 'all'

apps/web-antd/src/api/finance/settlement.ts

@@ -0,0 +1,137 @@
+/**
+ * 文件职责：财务中心到账查询 API 契约与请求封装。
+ */
+import { requestClient } from '#/api/request';
+
+/** 到账渠道筛选值。 */
+export type FinanceSettlementChannelFilter = 'alipay' | 'all' | 'wechat';
+
+/** 到账查询筛选参数。 */
+export interface FinanceSettlementFilterQuery {
+  channel?: FinanceSettlementChannelFilter;
+  endDate?: string;
+  startDate?: string;
+  storeId: string;
+}
+
+/** 到账查询列表参数。 */
+export interface FinanceSettlementListQuery extends FinanceSettlementFilterQuery {
+  page: number;
+  pageSize: number;
+}
+
+/** 到账统计结果。 */
+export interface FinanceSettlementStatsDto {
+  currentMonthArrivedAmount: number;
+  currentMonthTransactionCount: number;
+  todayArrivedAmount: number;
+  yesterdayArrivedAmount: number;
+}
+
+/** 到账账户信息。 */
+export interface FinanceSettlementAccountDto {
+  alipayPidMasked: string;
+  bankAccountName: string;
+  bankAccountNoMasked: string;
+  bankName: string;
+  settlementPeriodText: string;
+  wechatMerchantNoMasked: string;
+}
+
+/** 到账列表行。 */
+export interface FinanceSettlementListItemDto {
+  arrivedAmount: number;
+  arrivedDate: string;
+  channel: 'alipay' | 'wechat';
+  channelText: string;
+  transactionCount: number;
+}
+
+/** 到账列表结果。 */
+export interface FinanceSettlementListResultDto {
+  items: FinanceSettlementListItemDto[];
+  page: number;
+  pageSize: number;
+  total: number;
+}
+
+/** 到账明细查询参数。 */
+export interface FinanceSettlementDetailQuery {
+  arrivedDate: string;
+  channel: 'alipay' | 'wechat';
+  storeId: string;
+}
+
+/** 到账明细行。 */
+export interface FinanceSettlementDetailItemDto {
+  amount: number;
+  orderNo: string;
+  paidAt: string;
+}
+
+/** 到账明细结果。 */
+export interface FinanceSettlementDetailResultDto {
+  items: FinanceSettlementDetailItemDto[];
+}
+
+/** 到账导出结果。 */
+export interface FinanceSettlementExportDto {
+  fileContentBase64: string;
+  fileName: string;
+  totalCount: number;
+}
+
+/** 查询到账统计。 */
+export async function getFinanceSettlementStatsApi(params: {
+  storeId: string;
+}) {
+  return requestClient.get<FinanceSettlementStatsDto>(
+    '/finance/settlement/stats',
+    {
+      params,
+    },
+  );
+}
+
+/** 查询到账账户信息。 */
+export async function getFinanceSettlementAccountApi() {
+  return requestClient.get<FinanceSettlementAccountDto>(
+    '/finance/settlement/account',
+  );
+}
+
+/** 查询到账列表。 */
+export async function getFinanceSettlementListApi(
+  params: FinanceSettlementListQuery,
+) {
+  return requestClient.get<FinanceSettlementListResultDto>(
+    '/finance/settlement/list',
+    {
+      params,
+    },
+  );
+}
+
+/** 查询到账明细。 */
+export async function getFinanceSettlementDetailApi(
+  params: FinanceSettlementDetailQuery,
+) {
+  return requestClient.get<FinanceSettlementDetailResultDto>(
+    '/finance/settlement/detail',
+    {
+      params,
+    },
+  );
+}
+
+/** 导出到账汇总 CSV。 */
+export async function exportFinanceSettlementCsvApi(
+  params: FinanceSettlementFilterQuery,
+) {
+  return requestClient.get<FinanceSettlementExportDto>(
+    '/finance/settlement/export',
+    {
+      params,
+    },
+  );
+}

apps/web-antd/src/api/member/index.ts

@@ -283,4 +283,5 @@ export async function getMemberCouponPickerApi(params: {
 }
 
 export * from './message-reach';
+export * from './points-mall';
 export * from './stored-card';

apps/web-antd/src/api/member/points-mall.ts

@@ -0,0 +1,372 @@
+/**
+ * 文件职责：会员中心积分商城 API 契约定义。
+ */
+import { requestClient } from '#/api/request';
+
+/** 兑换类型。 */
+export type MemberPointMallRedeemType = 'coupon' | 'physical' | 'product';
+
+/** 兑换方式。 */
+export type MemberPointMallExchangeType = 'mixed' | 'points';
+
+/** 商品状态。 */
+export type MemberPointMallProductStatus = 'disabled' | 'enabled';
+
+/** 积分有效期模式。 */
+export type MemberPointMallExpiryMode = 'permanent' | 'yearly_clear';
+
+/** 通知渠道。 */
+export type MemberPointMallNotifyChannel = 'in_app' | 'sms';
+
+/** 实物领取方式。 */
+export type MemberPointMallPickupMethod = 'delivery' | 'store_pickup';
+
+/** 兑换记录状态。 */
+export type MemberPointMallRecordStatus =
+  | 'canceled'
+  | 'completed'
+  | 'issued'
+  | 'pending_pickup';
+
+/** 核销方式。 */
+export type MemberPointMallVerifyMethod = 'manual' | 'scan';
+
+/** 规则详情查询。 */
+export interface MemberPointMallRuleDetailQuery {
+  storeId: string;
+}
+
+/** 规则模型。 */
+export interface MemberPointMallRuleDto {
+  consumeAmountPerStep: number;
+  consumeRewardPointsPerStep: number;
+  expiryMode: MemberPointMallExpiryMode;
+  isConsumeRewardEnabled: boolean;
+  isRegisterRewardEnabled: boolean;
+  isReviewRewardEnabled: boolean;
+  isSigninRewardEnabled: boolean;
+  registerRewardPoints: number;
+  reviewRewardPoints: number;
+  signinRewardPoints: number;
+  storeId: string;
+}
+
+/** 规则统计。 */
+export interface MemberPointMallRuleStatsDto {
+  pointMembers: number;
+  redeemRate: number;
+  redeemedPoints: number;
+  totalIssuedPoints: number;
+}
+
+/** 规则详情结果。 */
+export interface MemberPointMallRuleDetailResultDto {
+  rule: MemberPointMallRuleDto;
+  stats: MemberPointMallRuleStatsDto;
+}
+
+/** 保存规则。 */
+export type SaveMemberPointMallRulePayload = MemberPointMallRuleDto;
+
+/** 商品列表查询。 */
+export interface MemberPointMallProductListQuery {
+  keyword?: string;
+  status?: MemberPointMallProductStatus;
+  storeId: string;
+}
+
+/** 商品详情查询。 */
+export interface MemberPointMallProductDetailQuery {
+  pointMallProductId: string;
+  storeId: string;
+}
+
+/** 商品模型。 */
+export interface MemberPointMallProductDto {
+  cashAmount: number;
+  couponTemplateId?: string;
+  description?: string;
+  exchangeType: MemberPointMallExchangeType;
+  imageUrl?: string;
+  name: string;
+  notifyChannels: MemberPointMallNotifyChannel[];
+  perMemberLimit?: number;
+  physicalName?: string;
+  pickupMethod?: MemberPointMallPickupMethod;
+  pointMallProductId: string;
+  productId?: string;
+  redeemType: MemberPointMallRedeemType;
+  redeemTypeText: string;
+  redeemedCount: number;
+  requiredPoints: number;
+  status: MemberPointMallProductStatus;
+  statusText: string;
+  stockAvailable: number;
+  stockTotal: number;
+  storeId: string;
+  updatedAt: string;
+}
+
+/** 商品列表结果。 */
+export interface MemberPointMallProductListResultDto {
+  items: MemberPointMallProductDto[];
+}
+
+/** 保存商品。 */
+export interface SaveMemberPointMallProductPayload {
+  cashAmount: number;
+  couponTemplateId?: string;
+  description?: string;
+  exchangeType: MemberPointMallExchangeType;
+  imageUrl?: string;
+  name: string;
+  notifyChannels: MemberPointMallNotifyChannel[];
+  perMemberLimit?: number;
+  physicalName?: string;
+  pickupMethod?: MemberPointMallPickupMethod;
+  pointMallProductId?: string;
+  productId?: string;
+  redeemType: MemberPointMallRedeemType;
+  requiredPoints: number;
+  status: MemberPointMallProductStatus;
+  stockTotal: number;
+  storeId: string;
+}
+
+/** 修改商品状态。 */
+export interface ChangeMemberPointMallProductStatusPayload {
+  pointMallProductId: string;
+  status: MemberPointMallProductStatus;
+  storeId: string;
+}
+
+/** 删除商品。 */
+export interface DeleteMemberPointMallProductPayload {
+  pointMallProductId: string;
+  storeId: string;
+}
+
+/** 记录列表查询。 */
+export interface MemberPointMallRecordListQuery {
+  endDate?: string;
+  keyword?: string;
+  page: number;
+  pageSize: number;
+  redeemType?: MemberPointMallRedeemType;
+  startDate?: string;
+  status?: MemberPointMallRecordStatus;
+  storeId: string;
+}
+
+/** 记录详情查询。 */
+export interface MemberPointMallRecordDetailQuery {
+  recordId: string;
+  storeId: string;
+}
+
+/** 记录模型。 */
+export interface MemberPointMallRecordDto {
+  cashAmount: number;
+  exchangeType: MemberPointMallExchangeType;
+  issuedAt?: string;
+  memberId: string;
+  memberMobileMasked: string;
+  memberName: string;
+  pointMallProductId: string;
+  productName: string;
+  recordId: string;
+  recordNo: string;
+  redeemedAt: string;
+  redeemType: MemberPointMallRedeemType;
+  redeemTypeText: string;
+  status: MemberPointMallRecordStatus;
+  statusText: string;
+  usedPoints: number;
+  verifiedAt?: string;
+}
+
+/** 记录详情。 */
+export interface MemberPointMallRecordDetailDto extends MemberPointMallRecordDto {
+  verifyMethod?: MemberPointMallVerifyMethod;
+  verifyMethodText?: string;
+  verifyRemark?: string;
+  verifiedBy?: string;
+}
+
+/** 记录统计。 */
+export interface MemberPointMallRecordStatsDto {
+  currentMonthUsedPoints: number;
+  pendingPhysicalCount: number;
+  todayRedeemCount: number;
+}
+
+/** 记录分页结果。 */
+export interface MemberPointMallRecordListResultDto {
+  items: MemberPointMallRecordDto[];
+  page: number;
+  pageSize: number;
+  stats: MemberPointMallRecordStatsDto;
+  totalCount: number;
+}
+
+/** 导出记录查询。 */
+export interface ExportMemberPointMallRecordQuery {
+  endDate?: string;
+  keyword?: string;
+  redeemType?: MemberPointMallRedeemType;
+  startDate?: string;
+  status?: MemberPointMallRecordStatus;
+  storeId: string;
+}
+
+/** 导出结果。 */
+export interface MemberPointMallRecordExportDto {
+  fileContentBase64: string;
+  fileName: string;
+  totalCount: number;
+}
+
+/** 写入记录请求。 */
+export interface WriteMemberPointMallRecordPayload {
+  memberId: string;
+  pointMallProductId: string;
+  redeemedAt?: string;
+  storeId: string;
+}
+
+/** 核销记录请求。 */
+export interface VerifyMemberPointMallRecordPayload {
+  recordId: string;
+  storeId: string;
+  verifyMethod: MemberPointMallVerifyMethod;
+  verifyRemark?: string;
+}
+
+/** 查询规则详情。 */
+export async function getMemberPointMallRuleDetailApi(
+  params: MemberPointMallRuleDetailQuery,
+) {
+  return requestClient.get<MemberPointMallRuleDetailResultDto>(
+    '/member/points-mall/rule/detail',
+    {
+      params,
+    },
+  );
+}
+
+/** 保存规则。 */
+export async function saveMemberPointMallRuleApi(
+  payload: SaveMemberPointMallRulePayload,
+) {
+  return requestClient.post<MemberPointMallRuleDto>(
+    '/member/points-mall/rule/save',
+    payload,
+  );
+}
+
+/** 查询商品列表。 */
+export async function getMemberPointMallProductListApi(
+  params: MemberPointMallProductListQuery,
+) {
+  return requestClient.get<MemberPointMallProductListResultDto>(
+    '/member/points-mall/product/list',
+    {
+      params,
+    },
+  );
+}
+
+/** 查询商品详情。 */
+export async function getMemberPointMallProductDetailApi(
+  params: MemberPointMallProductDetailQuery,
+) {
+  return requestClient.get<MemberPointMallProductDto>(
+    '/member/points-mall/product/detail',
+    {
+      params,
+    },
+  );
+}
+
+/** 保存商品。 */
+export async function saveMemberPointMallProductApi(
+  payload: SaveMemberPointMallProductPayload,
+) {
+  return requestClient.post<MemberPointMallProductDto>(
+    '/member/points-mall/product/save',
+    payload,
+  );
+}
+
+/** 修改商品状态。 */
+export async function changeMemberPointMallProductStatusApi(
+  payload: ChangeMemberPointMallProductStatusPayload,
+) {
+  return requestClient.post<MemberPointMallProductDto>(
+    '/member/points-mall/product/status',
+    payload,
+  );
+}
+
+/** 删除商品。 */
+export async function deleteMemberPointMallProductApi(
+  payload: DeleteMemberPointMallProductPayload,
+) {
+  return requestClient.post('/member/points-mall/product/delete', payload);
+}
+
+/** 查询兑换记录。 */
+export async function getMemberPointMallRecordListApi(
+  params: MemberPointMallRecordListQuery,
+) {
+  return requestClient.get<MemberPointMallRecordListResultDto>(
+    '/member/points-mall/record/list',
+    {
+      params,
+    },
+  );
+}
+
+/** 查询兑换记录详情。 */
+export async function getMemberPointMallRecordDetailApi(
+  params: MemberPointMallRecordDetailQuery,
+) {
+  return requestClient.get<MemberPointMallRecordDetailDto>(
+    '/member/points-mall/record/detail',
+    {
+      params,
+    },
+  );
+}
+
+/** 导出兑换记录。 */
+export async function exportMemberPointMallRecordApi(
+  params: ExportMemberPointMallRecordQuery,
+) {
+  return requestClient.get<MemberPointMallRecordExportDto>(
+    '/member/points-mall/record/export',
+    {
+      params,
+    },
+  );
+}
+
+/** 写入兑换记录。 */
+export async function writeMemberPointMallRecordApi(
+  payload: WriteMemberPointMallRecordPayload,
+) {
+  return requestClient.post<MemberPointMallRecordDto>(
+    '/member/points-mall/record/write',
+    payload,
+  );
+}
+
+/** 核销兑换记录。 */
+export async function verifyMemberPointMallRecordApi(
+  payload: VerifyMemberPointMallRecordPayload,
+) {
+  return requestClient.post<MemberPointMallRecordDetailDto>(
+    '/member/points-mall/record/verify',
+    payload,
+  );
+}

apps/web-antd/src/views/finance/settlement/components/SettlementAccountBar.vue

@@ -0,0 +1,60 @@
+<script setup lang="ts">
+/**
+ * 文件职责：到账查询结算账户信息条展示。
+ */
+import type { FinanceSettlementAccountDto } from '#/api/finance';
+
+import { computed } from 'vue';
+
+import { IconifyIcon } from '@vben/icons';
+
+interface Props {
+  account: FinanceSettlementAccountDto | null;
+  loading: boolean;
+}
+
+const props = defineProps<Props>();
+
+const accountText = computed(() => {
+  const bankName = props.account?.bankName?.trim();
+  const accountNoMasked = props.account?.bankAccountNoMasked?.trim();
+
+  if (!bankName && !accountNoMasked) {
+    return '--';
+  }
+
+  return `${bankName || ''} ${accountNoMasked || ''}`.trim();
+});
+</script>
+
+<template>
+  <div class="fst-account-bar" :class="{ 'is-loading': props.loading }">
+    <IconifyIcon icon="lucide:landmark" class="fst-account-icon" />
+
+    <span>
+      结算账户：<strong>{{ accountText }}</strong>
+    </span>
+
+    <span class="fst-account-sep"></span>
+
+    <span>
+      微信商户号：<strong>{{
+        props.account?.wechatMerchantNoMasked || '--'
+      }}</strong>
+    </span>
+
+    <span class="fst-account-sep"></span>
+
+    <span>
+      支付宝PID：<strong>{{ props.account?.alipayPidMasked || '--' }}</strong>
+    </span>
+
+    <span class="fst-account-sep"></span>
+
+    <span>
+      结算周期：<strong>{{
+        props.account?.settlementPeriodText || '--'
+      }}</strong>
+    </span>
+  </div>
+</template>

apps/web-antd/src/views/finance/settlement/components/SettlementDetailTable.vue

@@ -0,0 +1,51 @@
+<script setup lang="ts">
+/**
+ * 文件职责：到账查询展开明细子表。
+ */
+import type { FinanceSettlementDetailItemDto } from '#/api/finance';
+
+import {
+  formatCurrency,
+  formatPaidTime,
+} from '../composables/settlement-page/helpers';
+
+interface Props {
+  items: FinanceSettlementDetailItemDto[];
+  loading: boolean;
+}
+
+const props = defineProps<Props>();
+</script>
+
+<template>
+  <div class="fst-detail-wrap">
+    <div class="fst-detail-title">交易明细（部分）</div>
+
+    <table class="fst-mini-table">
+      <thead>
+        <tr>
+          <th>订单号</th>
+          <th>金额</th>
+          <th>时间</th>
+        </tr>
+      </thead>
+      <tbody>
+        <tr v-if="props.loading">
+          <td colspan="3">加载中...</td>
+        </tr>
+        <tr v-else-if="props.items.length === 0">
+          <td colspan="3">暂无明细数据</td>
+        </tr>
+        <tr
+          v-for="item in props.items"
+          v-else
+          :key="`${item.orderNo}_${item.paidAt}`"
+        >
+          <td class="fst-mono">{{ item.orderNo }}</td>
+          <td>{{ formatCurrency(item.amount) }}</td>
+          <td>{{ formatPaidTime(item.paidAt) }}</td>
+        </tr>
+      </tbody>
+    </table>
+  </div>
+</template>

apps/web-antd/src/views/finance/settlement/components/SettlementFilterBar.vue

@@ -0,0 +1,105 @@
+<script setup lang="ts">
+/**
+ * 文件职责：到账查询筛选栏（门店、日期、渠道、导出）。
+ */
+import type { FinanceSettlementFilterState, OptionItem } from '../types';
+
+import { IconifyIcon } from '@vben/icons';
+
+import { Button, Input, Select } from 'ant-design-vue';
+
+import { SETTLEMENT_CHANNEL_OPTIONS } from '../composables/settlement-page/constants';
+
+interface Props {
+  canExport: boolean;
+  filters: FinanceSettlementFilterState;
+  isExporting: boolean;
+  isStoreLoading: boolean;
+  selectedStoreId: string;
+  storeOptions: OptionItem[];
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'export'): void;
+  (event: 'search'): void;
+  (event: 'update:channel', value: string): void;
+  (event: 'update:endDate', value: string): void;
+  (event: 'update:selectedStoreId', value: string): void;
+  (event: 'update:startDate', value: string): void;
+}>();
+
+function handleStoreChange(value: unknown) {
+  if (typeof value === 'number' || typeof value === 'string') {
+    emit('update:selectedStoreId', String(value));
+    return;
+  }
+
+  emit('update:selectedStoreId', '');
+}
+
+function handleStartDateChange(value: string | undefined) {
+  emit('update:startDate', String(value ?? ''));
+  emit('search');
+}
+
+function handleEndDateChange(value: string | undefined) {
+  emit('update:endDate', String(value ?? ''));
+  emit('search');
+}
+
+function handleChannelChange(value: unknown) {
+  emit('update:channel', String(value ?? 'all'));
+  emit('search');
+}
+</script>
+
+<template>
+  <div class="fst-toolbar">
+    <Select
+      class="fst-store-select"
+      :value="props.selectedStoreId"
+      placeholder="选择门店"
+      :loading="props.isStoreLoading"
+      :options="props.storeOptions"
+      :disabled="props.isStoreLoading || props.storeOptions.length === 0"
+      @update:value="(value) => handleStoreChange(value)"
+    />
+
+    <Input
+      class="fst-date-input"
+      type="date"
+      :value="props.filters.startDate"
+      @update:value="(value) => handleStartDateChange(value)"
+    />
+    <span class="fst-date-sep">~</span>
+    <Input
+      class="fst-date-input"
+      type="date"
+      :value="props.filters.endDate"
+      @update:value="(value) => handleEndDateChange(value)"
+    />
+
+    <Select
+      class="fst-channel-select"
+      :value="props.filters.channel"
+      :options="SETTLEMENT_CHANNEL_OPTIONS"
+      @update:value="(value) => handleChannelChange(value)"
+    />
+
+    <div class="fst-toolbar-right">
+      <Button
+        class="fst-export-btn"
+        :disabled="!props.canExport || !props.selectedStoreId"
+        :loading="props.isExporting"
+        @click="emit('export')"
+      >
+        <template #icon>
+          <IconifyIcon icon="lucide:download" />
+        </template>
+        导出
+      </Button>
+    </div>
+  </div>
+</template>

apps/web-antd/src/views/finance/settlement/components/SettlementStatsCards.vue

@@ -0,0 +1,63 @@
+<script setup lang="ts">
+/**
+ * 文件职责：到账查询统计卡片展示。
+ */
+import type { FinanceSettlementStatsDto } from '#/api/finance';
+
+import { IconifyIcon } from '@vben/icons';
+
+import {
+  formatCount,
+  formatCurrency,
+} from '../composables/settlement-page/helpers';
+
+interface Props {
+  stats: FinanceSettlementStatsDto;
+}
+
+const props = defineProps<Props>();
+</script>
+
+<template>
+  <div class="fst-stats">
+    <div class="fst-stat-card">
+      <div class="fst-stat-label">
+        <IconifyIcon icon="lucide:circle-check" class="fst-stat-icon" />
+        今日到账
+      </div>
+      <div class="fst-stat-value is-green">
+        {{ formatCurrency(props.stats.todayArrivedAmount) }}
+      </div>
+    </div>
+
+    <div class="fst-stat-card">
+      <div class="fst-stat-label">
+        <IconifyIcon icon="lucide:calendar-minus" class="fst-stat-icon" />
+        昨日到账
+      </div>
+      <div class="fst-stat-value">
+        {{ formatCurrency(props.stats.yesterdayArrivedAmount) }}
+      </div>
+    </div>
+
+    <div class="fst-stat-card">
+      <div class="fst-stat-label">
+        <IconifyIcon icon="lucide:calendar-check" class="fst-stat-icon" />
+        本月累计到账
+      </div>
+      <div class="fst-stat-value">
+        {{ formatCurrency(props.stats.currentMonthArrivedAmount) }}
+      </div>
+    </div>
+
+    <div class="fst-stat-card">
+      <div class="fst-stat-label">
+        <IconifyIcon icon="lucide:receipt" class="fst-stat-icon" />
+        本月交易笔数
+      </div>
+      <div class="fst-stat-value">
+        {{ formatCount(props.stats.currentMonthTransactionCount) }}
+      </div>
+    </div>
+  </div>
+</template>

apps/web-antd/src/views/finance/settlement/components/SettlementTableCard.vue

@@ -0,0 +1,131 @@
+<script setup lang="ts">
+/**
+ * 文件职责：到账查询列表表格与展开明细。
+ */
+import type { TablePaginationConfig, TableProps } from 'ant-design-vue';
+
+import type { FinanceSettlementDetailStateMap } from '../types';
+
+import type { FinanceSettlementListItemDto } from '#/api/finance';
+
+import { computed } from 'vue';
+
+import { Table } from 'ant-design-vue';
+
+import {
+  formatCurrency,
+  getSettlementRowKey,
+  resolveChannelDotClass,
+} from '../composables/settlement-page/helpers';
+import SettlementDetailTable from './SettlementDetailTable.vue';
+
+interface PaginationState {
+  page: number;
+  pageSize: number;
+  total: number;
+}
+
+interface Props {
+  detailStates: FinanceSettlementDetailStateMap;
+  expandedRowKeys: string[];
+  loading: boolean;
+  pagination: PaginationState;
+  rows: FinanceSettlementListItemDto[];
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'expand', expanded: boolean, row: FinanceSettlementListItemDto): void;
+  (event: 'pageChange', page: number, pageSize: number): void;
+}>();
+
+const columns: TableProps['columns'] = [
+  {
+    title: '到账日期',
+    dataIndex: 'arrivedDate',
+    width: 170,
+  },
+  {
+    title: '支付渠道',
+    dataIndex: 'channelText',
+    width: 190,
+  },
+  {
+    title: '交易笔数',
+    dataIndex: 'transactionCount',
+    width: 130,
+  },
+  {
+    title: '到账金额',
+    dataIndex: 'arrivedAmount',
+    align: 'right',
+    width: 180,
+  },
+];
+
+const expandable = computed(() => ({
+  expandedRowKeys: props.expandedRowKeys,
+  onExpand: (expanded: boolean, row: FinanceSettlementListItemDto) => {
+    emit('expand', expanded, row);
+  },
+}));
+
+function handleTableChange(next: TablePaginationConfig) {
+  emit('pageChange', Number(next.current || 1), Number(next.pageSize || 20));
+}
+
+function resolveDetailState(row: FinanceSettlementListItemDto) {
+  return (
+    props.detailStates[getSettlementRowKey(row)] ?? {
+      loading: false,
+      items: [],
+    }
+  );
+}
+</script>
+
+<template>
+  <div class="fst-table-card">
+    <Table
+      :row-key="getSettlementRowKey"
+      :columns="columns"
+      :data-source="props.rows"
+      :loading="props.loading"
+      :pagination="{
+        current: props.pagination.page,
+        pageSize: props.pagination.pageSize,
+        total: props.pagination.total,
+        showSizeChanger: true,
+        pageSizeOptions: ['20', '50', '100'],
+        showTotal: (total: number) => `共 ${total} 条`,
+      }"
+      :expandable="expandable"
+      @change="handleTableChange"
+    >
+      <template #bodyCell="{ column, record }">
+        <template v-if="column.dataIndex === 'channelText'">
+          <span class="fst-channel-icon">
+            <span
+              class="fst-channel-dot"
+              :class="resolveChannelDotClass(String(record.channel))"
+            ></span>
+            {{ record.channelText }}
+          </span>
+        </template>
+        <template v-else-if="column.dataIndex === 'arrivedAmount'">
+          <span class="fst-amount">{{
+            formatCurrency(Number(record.arrivedAmount || 0))
+          }}</span>
+        </template>
+      </template>
+
+      <template #expandedRowRender="{ record }">
+        <SettlementDetailTable
+          :loading="resolveDetailState(record).loading"
+          :items="resolveDetailState(record).items"
+        />
+      </template>
+    </Table>
+  </div>
+</template>

apps/web-antd/src/views/finance/settlement/composables/settlement-page/constants.ts

@@ -0,0 +1,55 @@
+import type { FinanceSettlementFilterState, OptionItem } from '../../types';
+
+import type {
+  FinanceSettlementAccountDto,
+  FinanceSettlementChannelFilter,
+  FinanceSettlementStatsDto,
+} from '#/api/finance';
+
+/**
+ * 文件职责：到账查询页面常量与默认状态定义。
+ */
+import { getTodayDateString } from './helpers';
+
+/** 到账查询查看权限。 */
+export const FINANCE_SETTLEMENT_VIEW_PERMISSION =
+  'tenant:finance:settlement:view';
+
+/** 到账查询导出权限。 */
+export const FINANCE_SETTLEMENT_EXPORT_PERMISSION =
+  'tenant:finance:settlement:export';
+
+/** 到账渠道筛选项。 */
+export const SETTLEMENT_CHANNEL_OPTIONS: OptionItem[] = [
+  { label: '全部渠道', value: 'all' },
+  { label: '微信支付', value: 'wechat' },
+  { label: '支付宝', value: 'alipay' },
+];
+
+/** 默认筛选状态。 */
+export function createDefaultFilters(): FinanceSettlementFilterState {
+  const today = getTodayDateString();
+  return {
+    channel: 'all' as FinanceSettlementChannelFilter,
+    startDate: today,
+    endDate: today,
+  };
+}
+
+/** 默认统计数据。 */
+export const DEFAULT_STATS: FinanceSettlementStatsDto = {
+  todayArrivedAmount: 0,
+  yesterdayArrivedAmount: 0,
+  currentMonthArrivedAmount: 0,
+  currentMonthTransactionCount: 0,
+};
+
+/** 默认账户信息。 */
+export const DEFAULT_ACCOUNT: FinanceSettlementAccountDto = {
+  bankName: '',
+  bankAccountName: '',
+  bankAccountNoMasked: '',
+  wechatMerchantNoMasked: '',
+  alipayPidMasked: '',
+  settlementPeriodText: '',
+};

apps/web-antd/src/views/finance/settlement/composables/settlement-page/data-actions.ts

@@ -0,0 +1,133 @@
+import type {
+  FinanceSettlementFilterState,
+  FinanceSettlementPaginationState,
+} from '../../types';
+
+import type {
+  FinanceSettlementAccountDto,
+  FinanceSettlementListItemDto,
+  FinanceSettlementStatsDto,
+} from '#/api/finance';
+import type { StoreListItemDto } from '#/api/store';
+
+/**
+ * 文件职责：到账查询页面数据加载动作。
+ */
+import {
+  getFinanceSettlementAccountApi,
+  getFinanceSettlementListApi,
+  getFinanceSettlementStatsApi,
+} from '#/api/finance';
+import { getStoreListApi } from '#/api/store';
+
+import { buildListQueryPayload } from './helpers';
+
+interface DataActionOptions {
+  account: { value: FinanceSettlementAccountDto | null };
+  filters: FinanceSettlementFilterState;
+  isAccountLoading: { value: boolean };
+  isListLoading: { value: boolean };
+  isStatsLoading: { value: boolean };
+  isStoreLoading: { value: boolean };
+  pagination: FinanceSettlementPaginationState;
+  rows: { value: FinanceSettlementListItemDto[] };
+  selectedStoreId: { value: string };
+  stats: FinanceSettlementStatsDto;
+  stores: { value: StoreListItemDto[] };
+}
+
+/** 创建数据相关动作。 */
+export function createDataActions(options: DataActionOptions) {
+  function resetStats() {
+    options.stats.todayArrivedAmount = 0;
+    options.stats.yesterdayArrivedAmount = 0;
+    options.stats.currentMonthArrivedAmount = 0;
+    options.stats.currentMonthTransactionCount = 0;
+  }
+
+  function clearPageData() {
+    options.rows.value = [];
+    options.pagination.total = 0;
+    resetStats();
+  }
+
+  async function loadStores() {
+    options.isStoreLoading.value = true;
+    try {
+      const result = await getStoreListApi({ page: 1, pageSize: 200 });
+      options.stores.value = result.items;
+
+      if (result.items.length === 0) {
+        options.selectedStoreId.value = '';
+        clearPageData();
+        return;
+      }
+
+      const matched = result.items.some(
+        (item) => item.id === options.selectedStoreId.value,
+      );
+
+      if (!matched) {
+        options.selectedStoreId.value = result.items[0]?.id ?? '';
+      }
+    } finally {
+      options.isStoreLoading.value = false;
+    }
+  }
+
+  async function loadAccount() {
+    options.isAccountLoading.value = true;
+    try {
+      options.account.value = await getFinanceSettlementAccountApi();
+    } finally {
+      options.isAccountLoading.value = false;
+    }
+  }
+
+  async function loadPageData() {
+    if (!options.selectedStoreId.value) {
+      clearPageData();
+      return;
+    }
+
+    const storeId = options.selectedStoreId.value;
+    const listPayload = buildListQueryPayload(
+      storeId,
+      options.filters,
+      options.pagination.page,
+      options.pagination.pageSize,
+    );
+
+    options.isListLoading.value = true;
+    options.isStatsLoading.value = true;
+    try {
+      const [listResult, statsResult] = await Promise.all([
+        getFinanceSettlementListApi(listPayload),
+        getFinanceSettlementStatsApi({ storeId }),
+      ]);
+
+      options.rows.value = listResult.items;
+      options.pagination.total = listResult.total;
+      options.pagination.page = listResult.page;
+      options.pagination.pageSize = listResult.pageSize;
+
+      options.stats.todayArrivedAmount = statsResult.todayArrivedAmount;
+      options.stats.yesterdayArrivedAmount = statsResult.yesterdayArrivedAmount;
+      options.stats.currentMonthArrivedAmount =
+        statsResult.currentMonthArrivedAmount;
+      options.stats.currentMonthTransactionCount =
+        statsResult.currentMonthTransactionCount;
+    } finally {
+      options.isListLoading.value = false;
+      options.isStatsLoading.value = false;
+    }
+  }
+
+  return {
+    clearPageData,
+    loadAccount,
+    loadPageData,
+    loadStores,
+    resetStats,
+  };
+}

apps/web-antd/src/views/finance/settlement/composables/settlement-page/detail-actions.ts

@@ -0,0 +1,76 @@
+import type {
+  FinanceSettlementDetailStateMap,
+  FinanceSettlementExpandAction,
+} from '../../types';
+
+/**
+ * 文件职责：到账查询展开明细动作。
+ */
+import { getFinanceSettlementDetailApi } from '#/api/finance';
+
+import { getSettlementRowKey } from './helpers';
+
+interface DetailActionOptions {
+  detailStates: FinanceSettlementDetailStateMap;
+  expandedRowKeys: { value: string[] };
+  selectedStoreId: { value: string };
+}
+
+/** 创建展开明细动作。 */
+export function createDetailActions(options: DetailActionOptions) {
+  function clearDetailStates() {
+    options.expandedRowKeys.value = [];
+    for (const key of Object.keys(options.detailStates)) {
+      Reflect.deleteProperty(options.detailStates, key);
+    }
+  }
+
+  async function handleExpand(action: FinanceSettlementExpandAction) {
+    const key = getSettlementRowKey(action.row);
+
+    if (!action.expanded) {
+      options.expandedRowKeys.value = options.expandedRowKeys.value.filter(
+        (item) => item !== key,
+      );
+      return;
+    }
+
+    if (!options.selectedStoreId.value) {
+      return;
+    }
+
+    if (!options.expandedRowKeys.value.includes(key)) {
+      options.expandedRowKeys.value = [...options.expandedRowKeys.value, key];
+    }
+
+    const currentState = options.detailStates[key] ?? {
+      loading: false,
+      items: [],
+    };
+
+    if (currentState.loading || currentState.items.length > 0) {
+      options.detailStates[key] = currentState;
+      return;
+    }
+
+    currentState.loading = true;
+    options.detailStates[key] = currentState;
+
+    try {
+      const result = await getFinanceSettlementDetailApi({
+        storeId: options.selectedStoreId.value,
+        arrivedDate: action.row.arrivedDate,
+        channel: action.row.channel,
+      });
+
+      currentState.items = result.items;
+    } finally {
+      currentState.loading = false;
+    }
+  }
+
+  return {
+    clearDetailStates,
+    handleExpand,
+  };
+}

apps/web-antd/src/views/finance/settlement/composables/settlement-page/export-actions.ts

@@ -0,0 +1,52 @@
+import type { FinanceSettlementFilterState } from '../../types';
+
+/**
+ * 文件职责：到账查询导出动作。
+ */
+import { message } from 'ant-design-vue';
+
+import { exportFinanceSettlementCsvApi } from '#/api/finance';
+
+import {
+  buildFilterQueryPayload,
+  downloadBase64File,
+  isDateRangeInvalid,
+} from './helpers';
+
+interface ExportActionOptions {
+  canExport: { value: boolean };
+  filters: FinanceSettlementFilterState;
+  isExporting: { value: boolean };
+  selectedStoreId: { value: string };
+}
+
+/** 创建导出动作。 */
+export function createExportActions(options: ExportActionOptions) {
+  async function handleExport() {
+    if (!options.canExport.value || !options.selectedStoreId.value) {
+      return;
+    }
+
+    if (isDateRangeInvalid(options.filters)) {
+      message.warning('开始日期不能晚于结束日期');
+      return;
+    }
+
+    options.isExporting.value = true;
+    try {
+      const payload = buildFilterQueryPayload(
+        options.selectedStoreId.value,
+        options.filters,
+      );
+      const result = await exportFinanceSettlementCsvApi(payload);
+      downloadBase64File(result.fileName, result.fileContentBase64);
+      message.success(`导出成功，共 ${result.totalCount} 条记录`);
+    } finally {
+      options.isExporting.value = false;
+    }
+  }
+
+  return {
+    handleExport,
+  };
+}

apps/web-antd/src/views/finance/settlement/composables/settlement-page/filter-actions.ts

@@ -0,0 +1,57 @@
+import type {
+  FinanceSettlementFilterState,
+  FinanceSettlementPaginationState,
+} from '../../types';
+
+/**
+ * 文件职责：到账查询页面筛选与分页行为。
+ */
+import { message } from 'ant-design-vue';
+
+import { isDateRangeInvalid } from './helpers';
+
+interface FilterActionOptions {
+  filters: FinanceSettlementFilterState;
+  loadPageData: () => Promise<void>;
+  pagination: FinanceSettlementPaginationState;
+}
+
+/** 创建筛选行为。 */
+export function createFilterActions(options: FilterActionOptions) {
+  function setChannel(value: string) {
+    options.filters.channel = (value ||
+      'all') as FinanceSettlementFilterState['channel'];
+  }
+
+  function setStartDate(value: string) {
+    options.filters.startDate = value;
+  }
+
+  function setEndDate(value: string) {
+    options.filters.endDate = value;
+  }
+
+  async function handleSearch() {
+    if (isDateRangeInvalid(options.filters)) {
+      message.warning('开始日期不能晚于结束日期');
+      return;
+    }
+
+    options.pagination.page = 1;
+    await options.loadPageData();
+  }
+
+  async function handlePageChange(page: number, pageSize: number) {
+    options.pagination.page = page;
+    options.pagination.pageSize = pageSize;
+    await options.loadPageData();
+  }
+
+  return {
+    handlePageChange,
+    handleSearch,
+    setChannel,
+    setEndDate,
+    setStartDate,
+  };
+}

apps/web-antd/src/views/finance/settlement/composables/settlement-page/helpers.ts

@@ -0,0 +1,134 @@
+import type {
+  FinanceSettlementFilterState,
+  FinanceSettlementListQueryPayload,
+  FinanceSettlementQueryPayload,
+} from '../../types';
+
+/**
+ * 文件职责：到账查询页面纯函数与数据转换工具。
+ */
+import type {
+  FinanceSettlementChannelFilter,
+  FinanceSettlementListItemDto,
+} from '#/api/finance';
+
+function formatDate(date: Date) {
+  const year = date.getFullYear();
+  const month = `${date.getMonth() + 1}`.padStart(2, '0');
+  const day = `${date.getDate()}`.padStart(2, '0');
+  return `${year}-${month}-${day}`;
+}
+
+function normalizeChannel(value: FinanceSettlementChannelFilter) {
+  return value === 'all' ? undefined : value;
+}
+
+function decodeBase64ToBlob(base64: string) {
+  const binary = atob(base64);
+  const bytes = new Uint8Array(binary.length);
+  for (let index = 0; index < binary.length; index += 1) {
+    bytes[index] = binary.codePointAt(index) ?? 0;
+  }
+  return new Blob([bytes], { type: 'text/csv;charset=utf-8;' });
+}
+
+/** 获取今天日期字符串（yyyy-MM-dd）。 */
+export function getTodayDateString() {
+  return formatDate(new Date());
+}
+
+/** 构建到账筛选请求。 */
+export function buildFilterQueryPayload(
+  storeId: string,
+  filters: FinanceSettlementFilterState,
+): FinanceSettlementQueryPayload {
+  return {
+    storeId,
+    startDate: filters.startDate || undefined,
+    endDate: filters.endDate || undefined,
+    channel: normalizeChannel(filters.channel),
+  };
+}
+
+/** 构建到账列表请求。 */
+export function buildListQueryPayload(
+  storeId: string,
+  filters: FinanceSettlementFilterState,
+  page: number,
+  pageSize: number,
+): FinanceSettlementListQueryPayload {
+  return {
+    ...buildFilterQueryPayload(storeId, filters),
+    page,
+    pageSize,
+  };
+}
+
+/** 判断日期范围是否合法。 */
+export function isDateRangeInvalid(filters: FinanceSettlementFilterState) {
+  if (!filters.startDate || !filters.endDate) {
+    return false;
+  }
+  return filters.startDate > filters.endDate;
+}
+
+/** 货币格式化（人民币）。 */
+export function formatCurrency(value: number) {
+  return new Intl.NumberFormat('zh-CN', {
+    style: 'currency',
+    currency: 'CNY',
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2,
+  }).format(Number.isFinite(value) ? value : 0);
+}
+
+/** 数值格式化（千分位整数）。 */
+export function formatCount(value: number) {
+  return new Intl.NumberFormat('zh-CN', {
+    maximumFractionDigits: 0,
+  }).format(Number.isFinite(value) ? value : 0);
+}
+
+/** 表格行唯一键。 */
+export function getSettlementRowKey(row: FinanceSettlementListItemDto) {
+  return `${row.arrivedDate}_${row.channel}`;
+}
+
+/** 到账渠道圆点类名。 */
+export function resolveChannelDotClass(channel: string) {
+  return channel === 'wechat' ? 'is-wechat' : 'is-alipay';
+}
+
+/** 明细支付时间格式化（HH:mm）。 */
+export function formatPaidTime(value: string) {
+  const normalized = String(value || '').trim();
+  if (!normalized) {
+    return '--';
+  }
+
+  const separatorIndex = normalized.indexOf(' ');
+  if (separatorIndex !== -1 && normalized.length >= separatorIndex + 6) {
+    return normalized.slice(separatorIndex + 1, separatorIndex + 6);
+  }
+
+  const timePrefix = normalized.match(/^\d{2}:\d{2}/);
+  if (timePrefix?.[0]) {
+    return timePrefix[0];
+  }
+
+  return normalized;
+}
+
+/** 下载 Base64 编码文件。 */
+export function downloadBase64File(
+  fileName: string,
+  fileContentBase64: string,
+) {
+  const blob = decodeBase64ToBlob(fileContentBase64);
+  const url = URL.createObjectURL(blob);
+  const anchor = document.createElement('a');
+  anchor.href = url;
+  anchor.download = fileName;
+  anchor.click();
+  URL.revokeObjectURL(url);
+}

apps/web-antd/src/views/finance/settlement/composables/useFinanceSettlementPage.ts

@@ -0,0 +1,201 @@
+import type { FinanceSettlementDetailStateMap } from '../types';
+
+/**
+ * 文件职责：到账查询页面状态与动作编排。
+ */
+import type {
+  FinanceSettlementAccountDto,
+  FinanceSettlementListItemDto,
+  FinanceSettlementStatsDto,
+} from '#/api/finance';
+import type { StoreListItemDto } from '#/api/store';
+
+import { computed, onActivated, onMounted, reactive, ref, watch } from 'vue';
+
+import { useAccessStore } from '@vben/stores';
+
+import {
+  createDefaultFilters,
+  DEFAULT_STATS,
+  FINANCE_SETTLEMENT_EXPORT_PERMISSION,
+  FINANCE_SETTLEMENT_VIEW_PERMISSION,
+} from './settlement-page/constants';
+import { createDataActions } from './settlement-page/data-actions';
+import { createDetailActions } from './settlement-page/detail-actions';
+import { createExportActions } from './settlement-page/export-actions';
+import { createFilterActions } from './settlement-page/filter-actions';
+
+/** 创建到账查询页面组合状态。 */
+export function useFinanceSettlementPage() {
+  const accessStore = useAccessStore();
+
+  const stores = ref<StoreListItemDto[]>([]);
+  const selectedStoreId = ref('');
+  const isStoreLoading = ref(false);
+
+  const filters = reactive(createDefaultFilters());
+  const rows = ref<FinanceSettlementListItemDto[]>([]);
+  const pagination = reactive({
+    page: 1,
+    pageSize: 20,
+    total: 0,
+  });
+
+  const stats = reactive<FinanceSettlementStatsDto>({ ...DEFAULT_STATS });
+  const account = ref<FinanceSettlementAccountDto | null>(null);
+
+  const isListLoading = ref(false);
+  const isStatsLoading = ref(false);
+  const isAccountLoading = ref(false);
+  const isExporting = ref(false);
+
+  const expandedRowKeys = ref<string[]>([]);
+  const detailStates = reactive<FinanceSettlementDetailStateMap>({});
+
+  const storeOptions = computed(() =>
+    stores.value.map((item) => ({
+      label: item.name,
+      value: item.id,
+    })),
+  );
+
+  const accessCodeSet = computed(
+    () => new Set((accessStore.accessCodes ?? []).map(String)),
+  );
+
+  const canView = computed(() =>
+    accessCodeSet.value.has(FINANCE_SETTLEMENT_VIEW_PERMISSION),
+  );
+
+  const canExport = computed(() =>
+    accessCodeSet.value.has(FINANCE_SETTLEMENT_EXPORT_PERMISSION),
+  );
+
+  const { clearPageData, loadAccount, loadPageData, loadStores, resetStats } =
+    createDataActions({
+      stores,
+      selectedStoreId,
+      filters,
+      rows,
+      pagination,
+      stats,
+      account,
+      isStoreLoading,
+      isListLoading,
+      isStatsLoading,
+      isAccountLoading,
+    });
+
+  const {
+    handlePageChange,
+    handleSearch,
+    setChannel,
+    setEndDate,
+    setStartDate,
+  } = createFilterActions({
+    filters,
+    pagination,
+    loadPageData,
+  });
+
+  const { clearDetailStates, handleExpand } = createDetailActions({
+    selectedStoreId,
+    expandedRowKeys,
+    detailStates,
+  });
+
+  const { handleExport } = createExportActions({
+    canExport,
+    selectedStoreId,
+    filters,
+    isExporting,
+  });
+
+  function setSelectedStoreId(value: string) {
+    selectedStoreId.value = value;
+  }
+
+  function clearByPermission() {
+    stores.value = [];
+    selectedStoreId.value = '';
+    account.value = null;
+    clearPageData();
+    clearDetailStates();
+    resetStats();
+  }
+
+  watch(selectedStoreId, async (storeId) => {
+    clearDetailStates();
+
+    if (!storeId) {
+      clearPageData();
+      return;
+    }
+
+    pagination.page = 1;
+    await loadPageData();
+  });
+
+  watch(canView, async (value, oldValue) => {
+    if (value === oldValue) {
+      return;
+    }
+
+    if (!value) {
+      clearByPermission();
+      return;
+    }
+
+    await Promise.all([loadStores(), loadAccount()]);
+  });
+
+  onMounted(async () => {
+    if (!canView.value) {
+      clearByPermission();
+      return;
+    }
+
+    await Promise.all([loadStores(), loadAccount()]);
+  });
+
+  onActivated(() => {
+    if (!canView.value) {
+      return;
+    }
+
+    if (stores.value.length === 0 || !selectedStoreId.value) {
+      void loadStores();
+    }
+
+    if (!account.value && !isAccountLoading.value) {
+      void loadAccount();
+    }
+  });
+
+  return {
+    account,
+    canExport,
+    canView,
+    detailStates,
+    expandedRowKeys,
+    filters,
+    handleExpand,
+    handleExport,
+    handlePageChange,
+    handleSearch,
+    isAccountLoading,
+    isExporting,
+    isListLoading,
+    isStatsLoading,
+    isStoreLoading,
+    pagination,
+    rows,
+    selectedStoreId,
+    setChannel,
+    setEndDate,
+    setSelectedStoreId,
+    setStartDate,
+    stats,
+    storeOptions,
+  };
+}

apps/web-antd/src/views/finance/settlement/index.vue

@@ -0,0 +1,83 @@
+<script setup lang="ts">
+/**
+ * 文件职责：财务中心到账查询页面入口编排。
+ */
+import { Page } from '@vben/common-ui';
+
+import { Empty } from 'ant-design-vue';
+
+import SettlementAccountBar from './components/SettlementAccountBar.vue';
+import SettlementFilterBar from './components/SettlementFilterBar.vue';
+import SettlementStatsCards from './components/SettlementStatsCards.vue';
+import SettlementTableCard from './components/SettlementTableCard.vue';
+import { useFinanceSettlementPage } from './composables/useFinanceSettlementPage';
+
+const {
+  account,
+  canExport,
+  canView,
+  detailStates,
+  expandedRowKeys,
+  filters,
+  handleExpand,
+  handleExport,
+  handlePageChange,
+  handleSearch,
+  isAccountLoading,
+  isExporting,
+  isListLoading,
+  isStoreLoading,
+  pagination,
+  rows,
+  selectedStoreId,
+  setChannel,
+  setEndDate,
+  setSelectedStoreId,
+  setStartDate,
+  stats,
+  storeOptions,
+} = useFinanceSettlementPage();
+</script>
+
+<template>
+  <Page title="到账查询" content-class="page-finance-settlement">
+    <div class="fst-page">
+      <template v-if="canView">
+        <SettlementStatsCards :stats="stats" />
+
+        <SettlementAccountBar :account="account" :loading="isAccountLoading" />
+
+        <SettlementFilterBar
+          :selected-store-id="selectedStoreId"
+          :store-options="storeOptions"
+          :is-store-loading="isStoreLoading"
+          :filters="filters"
+          :can-export="canExport"
+          :is-exporting="isExporting"
+          @update:selected-store-id="setSelectedStoreId"
+          @update:start-date="setStartDate"
+          @update:end-date="setEndDate"
+          @update:channel="setChannel"
+          @search="handleSearch"
+          @export="handleExport"
+        />
+
+        <SettlementTableCard
+          :rows="rows"
+          :loading="isListLoading"
+          :pagination="pagination"
+          :expanded-row-keys="expandedRowKeys"
+          :detail-states="detailStates"
+          @expand="(expanded, row) => handleExpand({ expanded, row })"
+          @page-change="handlePageChange"
+        />
+      </template>
+
+      <Empty v-else description="暂无到账查询页面访问权限" />
+    </div>
+  </Page>
+</template>
+
+<style lang="less">
+@import './styles/index.less';
+</style>

apps/web-antd/src/views/finance/settlement/styles/base.less

@@ -0,0 +1,18 @@
+/**
+ * 文件职责：到账查询页面基础容器样式。
+ */
+.page-finance-settlement {
+  .ant-card {
+    border-radius: 10px;
+  }
+}
+
+.fst-page {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.fst-mono {
+  font-family: ui-monospace, sfmono-regular, menlo, consolas, monospace;
+}

apps/web-antd/src/views/finance/settlement/styles/index.less

@@ -0,0 +1,7 @@
+/**
+ * 文件职责：到账查询页面样式聚合入口。
+ */
+@import './base.less';
+@import './layout.less';
+@import './table.less';
+@import './responsive.less';

apps/web-antd/src/views/finance/settlement/styles/layout.less

@@ -0,0 +1,134 @@
+/**
+ * 文件职责：到账查询页面布局与筛选区域样式。
+ */
+.fst-stats {
+  display: grid;
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+  gap: 12px;
+}
+
+.fst-stat-card {
+  padding: 18px 20px;
+  background: #fff;
+  border: 1px solid #f0f0f0;
+  border-radius: 10px;
+  box-shadow: 0 2px 8px rgb(15 23 42 / 6%);
+  transition: all 0.2s ease;
+
+  &:hover {
+    box-shadow: 0 6px 14px rgb(15 23 42 / 10%);
+    transform: translateY(-1px);
+  }
+}
+
+.fst-stat-label {
+  display: flex;
+  gap: 6px;
+  align-items: center;
+  margin-bottom: 6px;
+  font-size: 13px;
+  color: rgb(0 0 0 / 45%);
+}
+
+.fst-stat-icon {
+  width: 16px;
+  height: 16px;
+}
+
+.fst-stat-value {
+  font-size: 24px;
+  font-weight: 700;
+  line-height: 1.2;
+  color: rgb(0 0 0 / 88%);
+
+  &.is-green {
+    color: #52c41a;
+  }
+}
+
+.fst-account-bar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 14px;
+  align-items: center;
+  padding: 14px 20px;
+  font-size: 13px;
+  color: rgb(0 0 0 / 65%);
+  background: #fff;
+  border: 1px solid #f0f0f0;
+  border-radius: 10px;
+  box-shadow: 0 2px 8px rgb(15 23 42 / 6%);
+
+  &.is-loading {
+    opacity: 0.8;
+  }
+
+  strong {
+    font-weight: 600;
+    color: rgb(0 0 0 / 88%);
+  }
+}
+
+.fst-account-icon {
+  width: 18px;
+  height: 18px;
+  color: #1677ff;
+}
+
+.fst-account-sep {
+  width: 1px;
+  height: 20px;
+  background: #f0f0f0;
+}
+
+.fst-toolbar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 10px;
+  align-items: center;
+  padding: 14px 18px;
+  background: #fff;
+  border: 1px solid #f0f0f0;
+  border-radius: 10px;
+  box-shadow: 0 2px 8px rgb(15 23 42 / 6%);
+
+  .fst-store-select {
+    width: 220px;
+  }
+
+  .fst-date-input {
+    width: 145px;
+  }
+
+  .fst-channel-select {
+    width: 130px;
+  }
+
+  .fst-date-sep {
+    font-size: 13px;
+    line-height: 32px;
+    color: rgb(0 0 0 / 45%);
+  }
+
+  .fst-toolbar-right {
+    margin-left: auto;
+  }
+
+  .fst-export-btn {
+    display: inline-flex;
+    gap: 4px;
+    align-items: center;
+    height: 32px;
+  }
+
+  .ant-select-selector,
+  .ant-input,
+  .ant-input-affix-wrapper {
+    height: 32px;
+    font-size: 13px;
+  }
+
+  .ant-input-affix-wrapper .ant-input {
+    height: 100%;
+  }
+}

apps/web-antd/src/views/finance/settlement/styles/responsive.less

@@ -0,0 +1,48 @@
+/**
+ * 文件职责：到账查询页面响应式样式。
+ */
+@media (max-width: 1600px) {
+  .fst-stats {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+}
+
+@media (max-width: 992px) {
+  .fst-account-sep {
+    display: none;
+  }
+}
+
+@media (max-width: 768px) {
+  .fst-stats {
+    grid-template-columns: 1fr;
+  }
+
+  .fst-toolbar {
+    padding: 14px 12px;
+
+    .fst-store-select,
+    .fst-date-input,
+    .fst-channel-select {
+      width: 100%;
+    }
+
+    .fst-date-sep {
+      display: none;
+    }
+
+    .fst-toolbar-right {
+      width: 100%;
+      margin-left: 0;
+    }
+
+    .fst-export-btn {
+      justify-content: center;
+      width: 100%;
+    }
+  }
+
+  .fst-detail-wrap {
+    padding: 12px 12px 12px 24px;
+  }
+}

apps/web-antd/src/views/finance/settlement/styles/table.less

@@ -0,0 +1,98 @@
+/**
+ * 文件职责：到账查询表格与展开明细样式。
+ */
+.fst-table-card {
+  overflow: hidden;
+  background: #fff;
+  border: 1px solid #f0f0f0;
+  border-radius: 10px;
+
+  .ant-table-wrapper {
+    .ant-table-thead > tr > th {
+      font-size: 13px;
+      white-space: nowrap;
+    }
+
+    .ant-table-tbody > tr > td {
+      font-size: 13px;
+      vertical-align: middle;
+    }
+
+    .ant-table-expanded-row > td {
+      padding: 0 !important;
+      background: #f8f9fb !important;
+    }
+  }
+
+  .ant-pagination {
+    margin: 14px 16px;
+  }
+}
+
+.fst-channel-icon {
+  display: inline-flex;
+  gap: 6px;
+  align-items: center;
+}
+
+.fst-channel-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+
+  &.is-wechat {
+    background: #07c160;
+  }
+
+  &.is-alipay {
+    background: #1677ff;
+  }
+}
+
+.fst-amount {
+  font-weight: 600;
+  white-space: nowrap;
+}
+
+.fst-detail-wrap {
+  padding: 14px 20px 14px 40px;
+}
+
+.fst-detail-title {
+  padding-left: 10px;
+  margin-bottom: 10px;
+  font-size: 13px;
+  font-weight: 600;
+  color: rgb(0 0 0 / 88%);
+  border-left: 3px solid #1677ff;
+}
+
+.fst-mini-table {
+  width: 100%;
+  font-size: 12px;
+  border-collapse: collapse;
+
+  th {
+    padding: 8px 10px;
+    font-weight: 500;
+    color: rgb(0 0 0 / 45%);
+    text-align: left;
+    background: #fff;
+    border-bottom: 1px solid #f0f0f0;
+  }
+
+  td {
+    padding: 8px 10px;
+    color: rgb(0 0 0 / 88%);
+    border-bottom: 1px solid #f3f4f6;
+  }
+
+  tbody tr:last-child td {
+    border-bottom: none;
+  }
+
+  tbody tr td[colspan] {
+    color: rgb(0 0 0 / 45%);
+    text-align: center;
+  }
+}

apps/web-antd/src/views/finance/settlement/types.ts

@@ -0,0 +1,60 @@
+/**
+ * 文件职责：到账查询页面本地状态类型定义。
+ */
+import type {
+  FinanceSettlementChannelFilter,
+  FinanceSettlementDetailItemDto,
+  FinanceSettlementListItemDto,
+} from '#/api/finance';
+
+/** 到账查询筛选状态。 */
+export interface FinanceSettlementFilterState {
+  channel: FinanceSettlementChannelFilter;
+  endDate: string;
+  startDate: string;
+}
+
+/** 到账查询分页状态。 */
+export interface FinanceSettlementPaginationState {
+  page: number;
+  pageSize: number;
+  total: number;
+}
+
+/** 通用选项项。 */
+export interface OptionItem {
+  label: string;
+  value: string;
+}
+
+/** 到账筛选请求负载。 */
+export interface FinanceSettlementQueryPayload {
+  channel?: Exclude<FinanceSettlementChannelFilter, 'all'>;
+  endDate?: string;
+  startDate?: string;
+  storeId: string;
+}
+
+/** 到账列表请求负载。 */
+export interface FinanceSettlementListQueryPayload extends FinanceSettlementQueryPayload {
+  page: number;
+  pageSize: number;
+}
+
+/** 展开行明细状态。 */
+export interface FinanceSettlementDetailState {
+  items: FinanceSettlementDetailItemDto[];
+  loading: boolean;
+}
+
+/** 展开行明细缓存映射。 */
+export type FinanceSettlementDetailStateMap = Record<
+  string,
+  FinanceSettlementDetailState
+>;
+
+/** 表格展开动作参数。 */
+export interface FinanceSettlementExpandAction {
+  expanded: boolean;
+  row: FinanceSettlementListItemDto;
+}

apps/web-antd/src/views/member/points-mall/components/PointsMallProductCard.vue

@@ -0,0 +1,109 @@
+<script setup lang="ts">
+import type { PointMallProductCardViewModel } from '../types';
+
+import { computed } from 'vue';
+
+import { IconifyIcon } from '@vben/icons';
+
+import { Tag } from 'ant-design-vue';
+
+import {
+  POINTS_MALL_PRODUCT_STATUS_TEXT_MAP,
+  POINTS_MALL_REDEEM_TYPE_CLASS_MAP,
+} from '../composables/points-mall-page/constants';
+import {
+  formatCurrency,
+  formatPoints,
+} from '../composables/points-mall-page/helpers';
+
+const props = defineProps<{
+  canManage: boolean;
+  item: PointMallProductCardViewModel;
+}>();
+
+const emit = defineEmits<{
+  (event: 'edit', item: PointMallProductCardViewModel): void;
+  (event: 'remove', item: PointMallProductCardViewModel): void;
+  (event: 'toggleStatus', item: PointMallProductCardViewModel): void;
+}>();
+
+const statusTagColor = computed(() =>
+  props.item.status === 'enabled' ? 'green' : 'default',
+);
+
+const statusActionText = computed(() =>
+  props.item.status === 'enabled' ? '下架' : '上架',
+);
+
+const redeemTypeClass = computed(
+  () => POINTS_MALL_REDEEM_TYPE_CLASS_MAP[props.item.redeemType],
+);
+
+const statusText = computed(
+  () =>
+    props.item.statusText ||
+    POINTS_MALL_PRODUCT_STATUS_TEXT_MAP[props.item.status] ||
+    '未知',
+);
+</script>
+
+<template>
+  <div
+    class="mpm-product-card"
+    :class="{ 'is-disabled': item.status !== 'enabled' }"
+  >
+    <div class="mpm-product-image">
+      <img v-if="item.imageUrl" :src="item.imageUrl" :alt="item.name" />
+      <IconifyIcon v-else icon="lucide:image" />
+    </div>
+
+    <div class="mpm-product-body">
+      <div class="mpm-product-name">
+        <span>{{ item.name }}</span>
+        <span class="mpm-type-tag" :class="redeemTypeClass">
+          {{ item.redeemTypeText }}
+        </span>
+      </div>
+
+      <div class="mpm-product-price">
+        {{ formatPoints(item.requiredPoints) }}积分
+        <span v-if="item.exchangeType === 'mixed'" class="cash">
+          + {{ formatCurrency(item.cashAmount) }}
+        </span>
+      </div>
+
+      <div class="mpm-product-meta">
+        <span>库存 {{ formatPoints(item.stockAvailable) }}</span>
+        <span>已兑换 {{ formatPoints(item.redeemedCount) }}</span>
+      </div>
+
+      <div class="mpm-product-footer">
+        <button
+          type="button"
+          class="g-action"
+          :disabled="!canManage"
+          @click="emit('edit', item)"
+        >
+          编辑
+        </button>
+        <button
+          type="button"
+          class="g-action"
+          :disabled="!canManage"
+          @click="emit('toggleStatus', item)"
+        >
+          {{ statusActionText }}
+        </button>
+        <button
+          type="button"
+          class="g-action g-action-danger"
+          :disabled="!canManage"
+          @click="emit('remove', item)"
+        >
+          删除
+        </button>
+        <Tag :color="statusTagColor">{{ statusText }}</Tag>
+      </div>
+    </div>
+  </div>
+</template>

apps/web-antd/src/views/member/points-mall/components/PointsMallProductEditorDrawer.vue

@@ -0,0 +1,381 @@
+<script setup lang="ts">
+import type { UploadChangeParam, UploadFile } from 'ant-design-vue';
+
+import type { PointMallProductEditorForm } from '../types';
+
+import { ref } from 'vue';
+
+import { IconifyIcon } from '@vben/icons';
+
+import {
+  Button,
+  Drawer,
+  Form,
+  Input,
+  InputNumber,
+  message,
+  Select,
+  Switch,
+  Upload,
+} from 'ant-design-vue';
+
+import { uploadTenantFileApi } from '#/api/files';
+
+import {
+  POINTS_MALL_EXCHANGE_TYPE_OPTIONS,
+  POINTS_MALL_NOTIFY_CHANNEL_OPTIONS,
+  POINTS_MALL_PICKUP_METHOD_OPTIONS,
+  POINTS_MALL_REDEEM_TYPE_HINT_MAP,
+  POINTS_MALL_REDEEM_TYPE_OPTIONS,
+} from '../composables/points-mall-page/constants';
+
+defineProps<{
+  canManage: boolean;
+  couponOptions: Array<{ label: string; value: string }>;
+  form: PointMallProductEditorForm;
+  loading: boolean;
+  open: boolean;
+  submitText: string;
+  submitting: boolean;
+  title: string;
+}>();
+
+const emit = defineEmits<{
+  (event: 'close'): void;
+  (event: 'openProductPicker'): void;
+  (event: 'searchCoupon', keyword: string): void;
+  (event: 'setCashAmount', value: null | number): void;
+  (event: 'setCouponTemplateId', value: string): void;
+  (event: 'setDescription', value: string): void;
+  (event: 'setExchangeType', value: 'mixed' | 'points'): void;
+  (event: 'setImageUrl', value: string): void;
+  (event: 'setName', value: string): void;
+  (event: 'setPerMemberLimit', value: null | number): void;
+  (event: 'setPhysicalName', value: string): void;
+  (event: 'setPickupMethod', value: 'delivery' | 'store_pickup'): void;
+  (event: 'setRedeemType', value: 'coupon' | 'physical' | 'product'): void;
+  (event: 'setRequiredPoints', value: null | number): void;
+  (event: 'setStatus', value: 'disabled' | 'enabled'): void;
+  (event: 'setStockTotal', value: null | number): void;
+  (event: 'submit'): void;
+  (event: 'toggleNotifyChannel', value: 'in_app' | 'sms'): void;
+}>();
+
+const isUploading = ref(false);
+
+function parseNullableNumber(value: null | number | string) {
+  if (value === null || value === undefined || value === '') {
+    return null;
+  }
+  const parsed = Number(value);
+  return Number.isNaN(parsed) ? null : parsed;
+}
+
+function setRedeemType(value: unknown) {
+  if (value === 'product' || value === 'coupon' || value === 'physical') {
+    emit('setRedeemType', value);
+  }
+}
+
+function setExchangeType(value: unknown) {
+  if (value === 'points' || value === 'mixed') {
+    emit('setExchangeType', value);
+  }
+}
+
+function setPickupMethod(value: unknown) {
+  if (value === 'store_pickup' || value === 'delivery') {
+    emit('setPickupMethod', value);
+  }
+}
+
+function setStatusByChecked(checked: unknown) {
+  emit('setStatus', checked === true ? 'enabled' : 'disabled');
+}
+
+async function handleUploadChange(info: UploadChangeParam<UploadFile>) {
+  const rawFile = info.file.originFileObj;
+  if (!rawFile) {
+    return;
+  }
+
+  isUploading.value = true;
+  try {
+    const result = await uploadTenantFileApi(rawFile, 'dish_image');
+    if (result.url) {
+      emit('setImageUrl', result.url);
+      message.success('上传成功');
+    } else {
+      message.error('上传失败');
+    }
+  } catch (error) {
+    console.error(error);
+    message.error('上传失败');
+  } finally {
+    isUploading.value = false;
+  }
+}
+</script>
+
+<template>
+  <Drawer
+    :open="open"
+    :title="title"
+    width="560"
+    class="mpm-editor-drawer"
+    @close="emit('close')"
+  >
+    <Form layout="vertical">
+      <Form.Item label="兑换类型" required>
+        <div class="mpm-pill-row">
+          <button
+            v-for="item in POINTS_MALL_REDEEM_TYPE_OPTIONS"
+            :key="item.value"
+            type="button"
+            class="mpm-pill"
+            :class="{ checked: form.redeemType === item.value }"
+            :disabled="!canManage || loading"
+            @click="setRedeemType(item.value)"
+          >
+            {{ item.label }}
+          </button>
+        </div>
+        <div class="mpm-form-hint">
+          {{ POINTS_MALL_REDEEM_TYPE_HINT_MAP[form.redeemType] }}
+        </div>
+      </Form.Item>
+
+      <template v-if="form.redeemType === 'product'">
+        <Form.Item label="关联商品" required>
+          <div v-if="form.productId" class="mpm-selected-product">
+            <span class="name">{{ form.productName || form.productId }}</span>
+            <span class="id">ID: {{ form.productId }}</span>
+          </div>
+          <Button
+            :disabled="!canManage || loading"
+            @click="emit('openProductPicker')"
+          >
+            选择商品/套餐
+          </Button>
+          <div class="mpm-form-hint">兑换后系统自动生成该商品的兑换券</div>
+        </Form.Item>
+      </template>
+
+      <template v-else-if="form.redeemType === 'coupon'">
+        <Form.Item label="关联优惠券" required>
+          <Select
+            :value="form.couponTemplateId || undefined"
+            :options="couponOptions"
+            show-search
+            :filter-option="false"
+            :disabled="!canManage || loading"
+            placeholder="请选择优惠券"
+            @search="(value) => emit('searchCoupon', String(value ?? ''))"
+            @update:value="
+              (value) => emit('setCouponTemplateId', String(value ?? ''))
+            "
+          />
+          <div class="mpm-form-hint">
+            选择已在优惠券管理中创建的券，兑换后直接发到顾客券包
+          </div>
+        </Form.Item>
+      </template>
+
+      <template v-else>
+        <Form.Item label="实物名称" required>
+          <Input
+            :value="form.physicalName"
+            :maxlength="64"
+            :disabled="!canManage || loading"
+            placeholder="如：定制保温杯、品牌帆布袋"
+            @update:value="
+              (value) => emit('setPhysicalName', String(value ?? ''))
+            "
+          />
+        </Form.Item>
+        <Form.Item label="领取方式">
+          <div class="mpm-pill-row">
+            <button
+              v-for="item in POINTS_MALL_PICKUP_METHOD_OPTIONS"
+              :key="item.value"
+              type="button"
+              class="mpm-pill"
+              :class="{ checked: form.pickupMethod === item.value }"
+              :disabled="!canManage || loading"
+              @click="setPickupMethod(item.value)"
+            >
+              {{ item.label }}
+            </button>
+          </div>
+        </Form.Item>
+      </template>
+
+      <Form.Item label="展示名称" required>
+        <Input
+          :value="form.name"
+          :maxlength="64"
+          :disabled="!canManage || loading"
+          placeholder="如：招牌奶茶兑换券、满50减15券"
+          @update:value="(value) => emit('setName', String(value ?? ''))"
+        />
+        <div class="mpm-form-hint">顾客在积分商城看到的名称</div>
+      </Form.Item>
+
+      <Form.Item label="展示图片">
+        <div class="mpm-image-field">
+          <img
+            v-if="form.imageUrl"
+            class="mpm-image-preview"
+            :src="form.imageUrl"
+            alt="points-product"
+          />
+          <Upload
+            :show-upload-list="false"
+            :before-upload="() => false"
+            :disabled="!canManage || loading || isUploading"
+            @change="handleUploadChange"
+          >
+            <Button :loading="isUploading" :disabled="!canManage || loading">
+              <IconifyIcon icon="lucide:upload-cloud" />
+              {{ form.imageUrl ? '重新上传' : '点击上传商品图片' }}
+            </Button>
+          </Upload>
+        </div>
+      </Form.Item>
+
+      <Form.Item label="兑换方式" required>
+        <div class="mpm-pill-row">
+          <button
+            v-for="item in POINTS_MALL_EXCHANGE_TYPE_OPTIONS"
+            :key="item.value"
+            type="button"
+            class="mpm-pill"
+            :class="{ checked: form.exchangeType === item.value }"
+            :disabled="!canManage || loading"
+            @click="setExchangeType(item.value)"
+          >
+            {{ item.label }}
+          </button>
+        </div>
+      </Form.Item>
+
+      <Form.Item label="所需积分" required>
+        <InputNumber
+          :value="form.requiredPoints ?? undefined"
+          :min="0"
+          :precision="0"
+          :disabled="!canManage || loading"
+          style="width: 100%"
+          placeholder="请输入所需积分数量"
+          @update:value="
+            (value) => emit('setRequiredPoints', parseNullableNumber(value))
+          "
+        />
+      </Form.Item>
+
+      <Form.Item v-if="form.exchangeType === 'mixed'" label="现金部分" required>
+        <InputNumber
+          :value="form.cashAmount ?? undefined"
+          :min="0"
+          :precision="2"
+          :disabled="!canManage || loading"
+          style="width: 100%"
+          placeholder="请输入需额外支付的金额"
+          @update:value="
+            (value) => emit('setCashAmount', parseNullableNumber(value))
+          "
+        />
+        <div class="mpm-form-hint">用户兑换时需额外支付的现金金额</div>
+      </Form.Item>
+
+      <Form.Item label="库存数量" required>
+        <InputNumber
+          :value="form.stockTotal ?? undefined"
+          :min="0"
+          :precision="0"
+          :disabled="!canManage || loading"
+          style="width: 100%"
+          placeholder="请输入库存数量"
+          @update:value="
+            (value) => emit('setStockTotal', parseNullableNumber(value))
+          "
+        />
+      </Form.Item>
+
+      <Form.Item label="兑换限制">
+        <div class="mpm-inline-fields">
+          <span>每人限兑</span>
+          <InputNumber
+            :value="form.perMemberLimit ?? undefined"
+            :min="0"
+            :precision="0"
+            :disabled="!canManage || loading"
+            placeholder="不限"
+            @update:value="
+              (value) => emit('setPerMemberLimit', parseNullableNumber(value))
+            "
+          />
+          <span>次</span>
+        </div>
+        <div class="mpm-form-hint">留空或填0表示不限制兑换次数</div>
+      </Form.Item>
+
+      <Form.Item label="商品描述">
+        <Input.TextArea
+          :value="form.description"
+          :maxlength="512"
+          :rows="4"
+          :disabled="!canManage || loading"
+          placeholder="请输入商品描述信息，如使用规则、有效期等"
+          @update:value="(value) => emit('setDescription', String(value ?? ''))"
+        />
+      </Form.Item>
+
+      <Form.Item label="到账通知">
+        <div class="mpm-pill-row">
+          <button
+            v-for="item in POINTS_MALL_NOTIFY_CHANNEL_OPTIONS"
+            :key="item.value"
+            type="button"
+            class="mpm-pill"
+            :class="{ checked: form.notifyChannels.includes(item.value) }"
+            :disabled="!canManage || loading"
+            @click="emit('toggleNotifyChannel', item.value)"
+          >
+            {{ item.label }}
+          </button>
+        </div>
+        <div class="mpm-form-hint">
+          选择兑换成功后通知顾客的方式，实物商品建议开启短信通知
+        </div>
+      </Form.Item>
+
+      <Form.Item label="上架状态">
+        <div class="mpm-inline-fields">
+          <Switch
+            :checked="form.status === 'enabled'"
+            :disabled="!canManage || loading"
+            @change="setStatusByChecked"
+          />
+          <span class="mpm-form-hint">
+            {{ form.status === 'enabled' ? '当前上架中' : '当前已下架' }}
+          </span>
+        </div>
+      </Form.Item>
+    </Form>
+
+    <template #footer>
+      <div class="mpm-drawer-footer">
+        <Button @click="emit('close')">取消</Button>
+        <Button
+          type="primary"
+          :loading="submitting"
+          :disabled="!canManage || loading"
+          @click="emit('submit')"
+        >
+          {{ submitText }}
+        </Button>
+      </div>
+    </template>
+  </Drawer>
+</template>

apps/web-antd/src/views/member/points-mall/components/PointsMallProductPickerModal.vue

@@ -0,0 +1,89 @@
+<script setup lang="ts">
+import type { ProductPickerItemDto } from '#/api/product';
+
+import { Empty, Input, Modal, Spin } from 'ant-design-vue';
+
+defineProps<{
+  keyword: string;
+  loading: boolean;
+  open: boolean;
+  rows: ProductPickerItemDto[];
+  selectedId: string;
+}>();
+
+const emit = defineEmits<{
+  (event: 'close'): void;
+  (event: 'search'): void;
+  (event: 'select', value: string): void;
+  (event: 'setKeyword', value: string): void;
+  (event: 'submit'): void;
+}>();
+</script>
+
+<template>
+  <Modal
+    :open="open"
+    title="选择兑换商品"
+    width="760px"
+    ok-text="确认选择"
+    cancel-text="取消"
+    @ok="emit('submit')"
+    @cancel="emit('close')"
+  >
+    <div class="mpm-picker-toolbar">
+      <Input
+        :value="keyword"
+        allow-clear
+        placeholder="搜索商品名称/SPU"
+        @update:value="(value) => emit('setKeyword', String(value ?? ''))"
+        @press-enter="emit('search')"
+      />
+      <button type="button" class="g-btn g-btn-sm" @click="emit('search')">
+        搜索
+      </button>
+    </div>
+
+    <Spin :spinning="loading">
+      <div v-if="rows.length === 0" class="mpm-picker-empty">
+        <Empty description="暂无可选商品" />
+      </div>
+      <div v-else class="mpm-picker-table-wrap">
+        <table class="mpm-picker-table">
+          <thead>
+            <tr>
+              <th class="col-radio"></th>
+              <th>商品</th>
+              <th>分类</th>
+              <th class="col-price">售价</th>
+              <th class="col-status">状态</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr
+              v-for="item in rows"
+              :key="item.id"
+              :class="{ checked: selectedId === item.id }"
+              @click="emit('select', item.id)"
+            >
+              <td class="col-radio">
+                <input
+                  type="radio"
+                  name="mpm-product-picker"
+                  :checked="selectedId === item.id"
+                  @change.stop="emit('select', item.id)"
+                />
+              </td>
+              <td>
+                <div class="name">{{ item.name }}</div>
+                <div class="spu">{{ item.spuCode }}</div>
+              </td>
+              <td>{{ item.categoryName }}</td>
+              <td class="col-price">¥{{ item.price.toFixed(2) }}</td>
+              <td class="col-status">{{ item.status }}</td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+    </Spin>
+  </Modal>
+</template>

apps/web-antd/src/views/member/points-mall/components/PointsMallProductToolbar.vue

@@ -0,0 +1,63 @@
+<script setup lang="ts">
+import type { PointMallProductFilterForm } from '../types';
+
+import { Button, Input, Select } from 'ant-design-vue';
+
+import { POINTS_MALL_PRODUCT_STATUS_FILTER_OPTIONS } from '../composables/points-mall-page/constants';
+
+defineProps<{
+  canManage: boolean;
+  filters: PointMallProductFilterForm;
+  loading: boolean;
+}>();
+
+const emit = defineEmits<{
+  (event: 'create'): void;
+  (event: 'reset'): void;
+  (event: 'search'): void;
+  (event: 'setKeyword', value: string): void;
+  (event: 'setStatus', value: '' | 'disabled' | 'enabled'): void;
+}>();
+
+function setStatus(value: unknown) {
+  if (value === '' || value === 'enabled' || value === 'disabled') {
+    emit('setStatus', value);
+    return;
+  }
+  emit('setStatus', '');
+}
+</script>
+
+<template>
+  <div class="mpm-toolbar">
+    <Select
+      class="mpm-filter-select"
+      :value="filters.status"
+      :options="POINTS_MALL_PRODUCT_STATUS_FILTER_OPTIONS"
+      :disabled="loading"
+      @update:value="setStatus"
+    />
+
+    <Input
+      class="mpm-search-input"
+      :value="filters.keyword"
+      :disabled="loading"
+      placeholder="搜索兑换商品"
+      allow-clear
+      @update:value="(value) => emit('setKeyword', String(value ?? ''))"
+      @press-enter="emit('search')"
+    />
+
+    <Button :disabled="loading" @click="emit('search')">搜索</Button>
+    <Button :disabled="loading" @click="emit('reset')">重置</Button>
+
+    <span class="mpm-spacer"></span>
+    <Button
+      type="primary"
+      :disabled="!canManage || loading"
+      @click="emit('create')"
+    >
+      添加兑换商品
+    </Button>
+  </div>
+</template>

apps/web-antd/src/views/member/points-mall/components/PointsMallRecordDetailDrawer.vue

@@ -0,0 +1,105 @@
+<script setup lang="ts">
+import type { PointMallRecordDetailViewModel } from '../types';
+
+import { Drawer, Spin } from 'ant-design-vue';
+
+import {
+  POINTS_MALL_RECORD_STATUS_CLASS_MAP,
+  POINTS_MALL_REDEEM_TYPE_CLASS_MAP,
+} from '../composables/points-mall-page/constants';
+import {
+  formatCurrency,
+  formatPoints,
+} from '../composables/points-mall-page/helpers';
+
+defineProps<{
+  loading: boolean;
+  open: boolean;
+  record: null | PointMallRecordDetailViewModel;
+}>();
+
+const emit = defineEmits<{
+  (event: 'close'): void;
+}>();
+</script>
+
+<template>
+  <Drawer
+    :open="open"
+    title="兑换详情"
+    width="520"
+    class="mpm-detail-drawer"
+    @close="emit('close')"
+  >
+    <Spin :spinning="loading">
+      <div v-if="record" class="mpm-detail-content">
+        <div class="mpm-detail-top">
+          <div class="name">{{ record.productName }}</div>
+          <span
+            class="mpm-type-tag"
+            :class="POINTS_MALL_REDEEM_TYPE_CLASS_MAP[record.redeemType]"
+          >
+            {{ record.redeemTypeText }}
+          </span>
+        </div>
+
+        <div class="mpm-detail-grid">
+          <div class="item">
+            <span class="label">兑换单号</span>
+            <span class="value mono">{{ record.recordNo }}</span>
+          </div>
+          <div class="item">
+            <span class="label">状态</span>
+            <span
+              class="value mpm-record-status"
+              :class="POINTS_MALL_RECORD_STATUS_CLASS_MAP[record.status]"
+            >
+              {{ record.statusText }}
+            </span>
+          </div>
+          <div class="item">
+            <span class="label">会员</span>
+            <span class="value">{{ record.memberName }}</span>
+          </div>
+          <div class="item">
+            <span class="label">手机号</span>
+            <span class="value">{{ record.memberMobileMasked }}</span>
+          </div>
+          <div class="item">
+            <span class="label">消耗积分</span>
+            <span class="value">{{ formatPoints(record.usedPoints) }}</span>
+          </div>
+          <div class="item">
+            <span class="label">现金部分</span>
+            <span class="value">{{ formatCurrency(record.cashAmount) }}</span>
+          </div>
+          <div class="item">
+            <span class="label">兑换时间</span>
+            <span class="value">{{ record.redeemedAt }}</span>
+          </div>
+          <div class="item">
+            <span class="label">发放时间</span>
+            <span class="value">{{ record.issuedAt || '-' }}</span>
+          </div>
+          <div class="item">
+            <span class="label">核销时间</span>
+            <span class="value">{{ record.verifiedAt || '-' }}</span>
+          </div>
+          <div class="item">
+            <span class="label">核销方式</span>
+            <span class="value">{{ record.verifyMethodText || '-' }}</span>
+          </div>
+          <div class="item">
+            <span class="label">核销备注</span>
+            <span class="value">{{ record.verifyRemark || '-' }}</span>
+          </div>
+          <div class="item">
+            <span class="label">核销人</span>
+            <span class="value">{{ record.verifiedBy || '-' }}</span>
+          </div>
+        </div>
+      </div>
+      <div v-else class="mpm-empty-tip">暂无记录详情</div>
+    </Spin>
+  </Drawer>
+</template>

apps/web-antd/src/views/member/points-mall/components/PointsMallRecordStatsCards.vue

@@ -0,0 +1,32 @@
+<script setup lang="ts">
+import type { PointMallRecordStatsViewModel } from '../types';
+
+import { formatInteger } from '../composables/points-mall-page/helpers';
+
+defineProps<{
+  stats: PointMallRecordStatsViewModel;
+}>();
+</script>
+
+<template>
+  <div class="mpm-stats mpm-record-stats">
+    <div class="mpm-stat-card">
+      <div class="mpm-stat-label">今日兑换</div>
+      <div class="mpm-stat-value is-primary">
+        {{ formatInteger(stats.todayRedeemCount) }}
+      </div>
+    </div>
+    <div class="mpm-stat-card">
+      <div class="mpm-stat-label">待领取实物</div>
+      <div class="mpm-stat-value is-orange">
+        {{ formatInteger(stats.pendingPhysicalCount) }}
+      </div>
+    </div>
+    <div class="mpm-stat-card">
+      <div class="mpm-stat-label">本月消耗积分</div>
+      <div class="mpm-stat-value">
+        {{ formatInteger(stats.currentMonthUsedPoints) }}
+      </div>
+    </div>
+  </div>
+</template>

apps/web-antd/src/views/member/points-mall/components/PointsMallRecordTable.vue

@@ -0,0 +1,176 @@
+<script setup lang="ts">
+import type { TableColumnType } from 'ant-design-vue';
+
+import type { PointMallRecordPager } from '../types';
+
+import type { MemberPointMallRecordDto } from '#/api/member/points-mall';
+
+import { Pagination, Table } from 'ant-design-vue';
+
+import {
+  POINTS_MALL_RECORD_STATUS_CLASS_MAP,
+  POINTS_MALL_REDEEM_TYPE_CLASS_MAP,
+} from '../composables/points-mall-page/constants';
+import { formatPoints } from '../composables/points-mall-page/helpers';
+
+defineProps<{
+  canManage: boolean;
+  loading: boolean;
+  pager: PointMallRecordPager;
+}>();
+
+const emit = defineEmits<{
+  (event: 'detail', recordId: string): void;
+  (event: 'pageChange', page: number, pageSize: number): void;
+  (event: 'verify', recordId: string): void;
+}>();
+
+const columns: TableColumnType<MemberPointMallRecordDto>[] = [
+  {
+    title: '兑换单号',
+    dataIndex: 'recordNo',
+    key: 'recordNo',
+    width: 190,
+  },
+  {
+    title: '会员',
+    dataIndex: 'memberName',
+    key: 'memberName',
+    width: 160,
+  },
+  {
+    title: '兑换商品',
+    dataIndex: 'productName',
+    key: 'productName',
+    width: 180,
+  },
+  {
+    title: '类型',
+    dataIndex: 'redeemTypeText',
+    key: 'redeemTypeText',
+    width: 120,
+  },
+  {
+    title: '消耗积分',
+    dataIndex: 'usedPoints',
+    key: 'usedPoints',
+    width: 120,
+  },
+  {
+    title: '兑换时间',
+    dataIndex: 'redeemedAt',
+    key: 'redeemedAt',
+    width: 180,
+  },
+  {
+    title: '状态',
+    dataIndex: 'statusText',
+    key: 'statusText',
+    width: 130,
+  },
+  {
+    title: '操作',
+    dataIndex: 'actions',
+    key: 'actions',
+    width: 120,
+    fixed: 'right',
+  },
+];
+
+function canVerify(record: MemberPointMallRecordDto, canManage: boolean) {
+  return (
+    canManage &&
+    record.redeemType === 'physical' &&
+    record.status === 'pending_pickup'
+  );
+}
+
+function asRecord(record: unknown) {
+  return record as MemberPointMallRecordDto;
+}
+</script>
+
+<template>
+  <div class="mpm-record-table-wrap">
+    <Table
+      row-key="recordId"
+      :columns="columns"
+      :loading="loading"
+      :pagination="false"
+      :data-source="pager.items"
+      :scroll="{ x: 1180 }"
+      class="mpm-record-table"
+    >
+      <template #bodyCell="{ column, record }">
+        <template v-if="column.key === 'recordNo'">
+          <div class="mpm-record-no">{{ record.recordNo }}</div>
+        </template>
+
+        <template v-else-if="column.key === 'memberName'">
+          <div class="mpm-record-member">
+            <span class="name">{{ record.memberName }}</span>
+            <span class="phone">{{ record.memberMobileMasked }}</span>
+          </div>
+        </template>
+
+        <template v-else-if="column.key === 'redeemTypeText'">
+          <span
+            class="mpm-type-tag"
+            :class="
+              POINTS_MALL_REDEEM_TYPE_CLASS_MAP[asRecord(record).redeemType]
+            "
+          >
+            {{ asRecord(record).redeemTypeText }}
+          </span>
+        </template>
+
+        <template v-else-if="column.key === 'usedPoints'">
+          <span class="mpm-record-points">
+            {{ formatPoints(asRecord(record).usedPoints) }}
+          </span>
+        </template>
+
+        <template v-else-if="column.key === 'statusText'">
+          <span
+            class="mpm-record-status"
+            :class="
+              POINTS_MALL_RECORD_STATUS_CLASS_MAP[asRecord(record).status]
+            "
+          >
+            {{ asRecord(record).statusText }}
+          </span>
+        </template>
+
+        <template v-else-if="column.key === 'actions'">
+          <button
+            v-if="canVerify(asRecord(record), canManage)"
+            type="button"
+            class="g-action"
+            @click="emit('verify', asRecord(record).recordId)"
+          >
+            核销
+          </button>
+          <button
+            type="button"
+            class="g-action"
+            @click="emit('detail', asRecord(record).recordId)"
+          >
+            详情
+          </button>
+        </template>
+      </template>
+    </Table>
+
+    <div class="mpm-pagination">
+      <Pagination
+        :current="pager.page"
+        :page-size="pager.pageSize"
+        :total="pager.totalCount"
+        show-size-changer
+        :show-total="(value) => `共 ${value} 条`"
+        :page-size-options="['10', '20', '50', '100']"
+        @change="(page, pageSize) => emit('pageChange', page, pageSize)"
+      />
+    </div>
+  </div>
+</template>

apps/web-antd/src/views/member/points-mall/components/PointsMallRecordToolbar.vue

@@ -0,0 +1,99 @@
+<script setup lang="ts">
+import type { PointMallRecordFilterForm } from '../types';
+
+import { Button, Input, Select } from 'ant-design-vue';
+
+import {
+  POINTS_MALL_RECORD_REDEEM_FILTER_OPTIONS,
+  POINTS_MALL_RECORD_STATUS_FILTER_OPTIONS,
+} from '../composables/points-mall-page/constants';
+
+defineProps<{
+  canManage: boolean;
+  exporting: boolean;
+  filters: PointMallRecordFilterForm;
+  loading: boolean;
+}>();
+
+const emit = defineEmits<{
+  (event: 'export'): void;
+  (event: 'reset'): void;
+  (event: 'search'): void;
+  (event: 'setKeyword', value: string): void;
+  (event: 'setRedeemType', value: '' | 'coupon' | 'physical' | 'product'): void;
+  (
+    event: 'setStatus',
+    value: '' | 'canceled' | 'completed' | 'issued' | 'pending_pickup',
+  ): void;
+}>();
+
+function setRedeemType(value: unknown) {
+  if (
+    value === '' ||
+    value === 'product' ||
+    value === 'coupon' ||
+    value === 'physical'
+  ) {
+    emit('setRedeemType', value);
+    return;
+  }
+  emit('setRedeemType', '');
+}
+
+function setStatus(value: unknown) {
+  if (
+    value === '' ||
+    value === 'pending_pickup' ||
+    value === 'issued' ||
+    value === 'completed' ||
+    value === 'canceled'
+  ) {
+    emit('setStatus', value);
+    return;
+  }
+  emit('setStatus', '');
+}
+</script>
+
+<template>
+  <div class="mpm-toolbar">
+    <Select
+      class="mpm-filter-select"
+      :value="filters.redeemType"
+      :disabled="loading"
+      :options="POINTS_MALL_RECORD_REDEEM_FILTER_OPTIONS"
+      @update:value="setRedeemType"
+    />
+
+    <Select
+      class="mpm-filter-select"
+      :value="filters.status"
+      :disabled="loading"
+      :options="POINTS_MALL_RECORD_STATUS_FILTER_OPTIONS"
+      @update:value="setStatus"
+    />
+
+    <Input
+      class="mpm-search-input"
+      :value="filters.keyword"
+      :disabled="loading"
+      allow-clear
+      placeholder="搜索会员/商品名称"
+      @update:value="(value) => emit('setKeyword', String(value ?? ''))"
+      @press-enter="emit('search')"
+    />
+
+    <Button :disabled="loading" @click="emit('search')">搜索</Button>
+    <Button :disabled="loading" @click="emit('reset')">重置</Button>
+
+    <span class="mpm-spacer"></span>
+
+    <Button
+      :loading="exporting"
+      :disabled="!canManage || loading"
+      @click="emit('export')"
+    >
+      导出
+    </Button>
+  </div>
+</template>

apps/web-antd/src/views/member/points-mall/components/PointsMallRulePanel.vue

@@ -0,0 +1,179 @@
+<script setup lang="ts">
+import type { PointMallRuleForm } from '../types';
+
+import { Button, Card, InputNumber, Switch } from 'ant-design-vue';
+
+defineProps<{
+  canManage: boolean;
+  form: PointMallRuleForm;
+  loading: boolean;
+  submitting: boolean;
+}>();
+
+const emit = defineEmits<{
+  (event: 'save'): void;
+  (event: 'setConsumeAmountPerStep', value: null | number): void;
+  (event: 'setConsumeRewardEnabled', value: boolean): void;
+  (event: 'setConsumeRewardPointsPerStep', value: null | number): void;
+  (event: 'setExpiryMode', value: 'permanent' | 'yearly_clear'): void;
+  (event: 'setRegisterRewardEnabled', value: boolean): void;
+  (event: 'setRegisterRewardPoints', value: null | number): void;
+  (event: 'setReviewRewardEnabled', value: boolean): void;
+  (event: 'setReviewRewardPoints', value: null | number): void;
+  (event: 'setSigninRewardEnabled', value: boolean): void;
+  (event: 'setSigninRewardPoints', value: null | number): void;
+}>();
+
+function parseNullableNumber(value: null | number | string) {
+  if (value === null || value === undefined || value === '') {
+    return null;
+  }
+  const parsed = Number(value);
+  return Number.isNaN(parsed) ? null : parsed;
+}
+</script>
+
+<template>
+  <div class="mpm-rule-panel">
+    <Card class="mpm-card">
+      <div class="mpm-section-title">积分获取规则</div>
+
+      <div class="mpm-rule-row">
+        <Switch
+          :checked="form.isConsumeRewardEnabled"
+          :disabled="!canManage || loading"
+          @change="(value) => emit('setConsumeRewardEnabled', Boolean(value))"
+        />
+        <span class="mpm-rule-label">消费获取</span>
+        <span class="mpm-rule-text">每消费</span>
+        <InputNumber
+          :value="form.consumeAmountPerStep ?? undefined"
+          :disabled="!canManage || loading"
+          :min="0"
+          :precision="0"
+          class="mpm-rule-input"
+          @update:value="
+            (value) =>
+              emit('setConsumeAmountPerStep', parseNullableNumber(value))
+          "
+        />
+        <span class="mpm-rule-text">元获得</span>
+        <InputNumber
+          :value="form.consumeRewardPointsPerStep ?? undefined"
+          :disabled="!canManage || loading"
+          :min="0"
+          :precision="0"
+          class="mpm-rule-input"
+          @update:value="
+            (value) =>
+              emit('setConsumeRewardPointsPerStep', parseNullableNumber(value))
+          "
+        />
+        <span class="mpm-rule-text">积分</span>
+      </div>
+
+      <div class="mpm-rule-row">
+        <Switch
+          :checked="form.isReviewRewardEnabled"
+          :disabled="!canManage || loading"
+          @change="(value) => emit('setReviewRewardEnabled', Boolean(value))"
+        />
+        <span class="mpm-rule-label">评价奖励</span>
+        <span class="mpm-rule-text">发表评价奖励</span>
+        <InputNumber
+          :value="form.reviewRewardPoints ?? undefined"
+          :disabled="!canManage || loading"
+          :min="0"
+          :precision="0"
+          class="mpm-rule-input"
+          @update:value="
+            (value) => emit('setReviewRewardPoints', parseNullableNumber(value))
+          "
+        />
+        <span class="mpm-rule-text">积分</span>
+      </div>
+
+      <div class="mpm-rule-row">
+        <Switch
+          :checked="form.isRegisterRewardEnabled"
+          :disabled="!canManage || loading"
+          @change="(value) => emit('setRegisterRewardEnabled', Boolean(value))"
+        />
+        <span class="mpm-rule-label">注册奖励</span>
+        <span class="mpm-rule-text">新用户注册赠送</span>
+        <InputNumber
+          :value="form.registerRewardPoints ?? undefined"
+          :disabled="!canManage || loading"
+          :min="0"
+          :precision="0"
+          class="mpm-rule-input"
+          @update:value="
+            (value) =>
+              emit('setRegisterRewardPoints', parseNullableNumber(value))
+          "
+        />
+        <span class="mpm-rule-text">积分</span>
+      </div>
+
+      <div class="mpm-rule-row">
+        <Switch
+          :checked="form.isSigninRewardEnabled"
+          :disabled="!canManage || loading"
+          @change="(value) => emit('setSigninRewardEnabled', Boolean(value))"
+        />
+        <span class="mpm-rule-label">签到奖励</span>
+        <span class="mpm-rule-text">每日签到奖励</span>
+        <InputNumber
+          :value="form.signinRewardPoints ?? undefined"
+          :disabled="!canManage || loading"
+          :min="0"
+          :precision="0"
+          class="mpm-rule-input"
+          @update:value="
+            (value) => emit('setSigninRewardPoints', parseNullableNumber(value))
+          "
+        />
+        <span class="mpm-rule-text">积分</span>
+      </div>
+    </Card>
+
+    <Card class="mpm-card">
+      <div class="mpm-section-title">积分有效期</div>
+      <div class="mpm-pill-row">
+        <button
+          type="button"
+          class="mpm-pill"
+          :class="{ checked: form.expiryMode === 'permanent' }"
+          :disabled="!canManage || loading"
+          @click="emit('setExpiryMode', 'permanent')"
+        >
+          永久有效
+        </button>
+        <button
+          type="button"
+          class="mpm-pill"
+          :class="{ checked: form.expiryMode === 'yearly_clear' }"
+          :disabled="!canManage || loading"
+          @click="emit('setExpiryMode', 'yearly_clear')"
+        >
+          按年清零
+        </button>
+      </div>
+      <div v-if="form.expiryMode === 'yearly_clear'" class="mpm-form-hint">
+        每年12月31日清零当年获得的积分，请提前通知会员
+      </div>
+    </Card>
+
+    <div class="mpm-save-bar">
+      <Button
+        type="primary"
+        size="large"
+        :loading="submitting"
+        :disabled="!canManage || loading"
+        @click="emit('save')"
+      >
+        保存规则
+      </Button>
+    </div>
+  </div>
+</template>

apps/web-antd/src/views/member/points-mall/components/PointsMallRuleStatsCards.vue

@@ -0,0 +1,38 @@
+<script setup lang="ts">
+import type { PointMallRuleStatsViewModel } from '../types';
+
+import { formatInteger } from '../composables/points-mall-page/helpers';
+
+defineProps<{
+  stats: PointMallRuleStatsViewModel;
+}>();
+</script>
+
+<template>
+  <div class="mpm-stats mpm-rule-stats">
+    <div class="mpm-stat-card">
+      <div class="mpm-stat-label">累计发放积分</div>
+      <div class="mpm-stat-value is-primary">
+        {{ formatInteger(stats.totalIssuedPoints) }}
+      </div>
+    </div>
+    <div class="mpm-stat-card">
+      <div class="mpm-stat-label">已兑换积分</div>
+      <div class="mpm-stat-value is-orange">
+        {{ formatInteger(stats.redeemedPoints) }}
+      </div>
+    </div>
+    <div class="mpm-stat-card">
+      <div class="mpm-stat-label">积分用户</div>
+      <div class="mpm-stat-value">
+        {{ formatInteger(stats.pointMembers) }} 人
+      </div>
+    </div>
+    <div class="mpm-stat-card">
+      <div class="mpm-stat-label">兑换率</div>
+      <div class="mpm-stat-value is-green">
+        {{ Number(stats.redeemRate ?? 0).toFixed(1) }}%
+      </div>
+    </div>
+  </div>
+</template>

apps/web-antd/src/views/member/points-mall/components/PointsMallVerifyDrawer.vue

@@ -0,0 +1,123 @@
+<script setup lang="ts">
+import type {
+  PointMallRecordDetailViewModel,
+  PointMallVerifyForm,
+} from '../types';
+
+import { Drawer, Form, Input } from 'ant-design-vue';
+
+import {
+  POINTS_MALL_REDEEM_TYPE_CLASS_MAP,
+  POINTS_MALL_VERIFY_METHOD_OPTIONS,
+} from '../composables/points-mall-page/constants';
+import { formatPoints } from '../composables/points-mall-page/helpers';
+
+defineProps<{
+  canManage: boolean;
+  form: PointMallVerifyForm;
+  loading: boolean;
+  open: boolean;
+  record: null | PointMallRecordDetailViewModel;
+  submitting: boolean;
+}>();
+
+const emit = defineEmits<{
+  (event: 'close'): void;
+  (event: 'setVerifyMethod', value: 'manual' | 'scan'): void;
+  (event: 'setVerifyRemark', value: string): void;
+  (event: 'submit'): void;
+}>();
+
+function resolveMemberText(record: PointMallRecordDetailViewModel) {
+  return `${record.memberName} (${record.memberMobileMasked})`;
+}
+</script>
+
+<template>
+  <Drawer
+    :open="open"
+    title="兑换核销"
+    width="460"
+    class="mpm-verify-drawer"
+    @close="emit('close')"
+  >
+    <div v-if="record" class="mpm-verify-content">
+      <div class="mpm-verify-card">
+        <div class="mpm-verify-product">
+          <div class="name">{{ record.productName }}</div>
+          <span
+            class="mpm-type-tag"
+            :class="POINTS_MALL_REDEEM_TYPE_CLASS_MAP[record.redeemType]"
+          >
+            {{ record.redeemTypeText }}
+          </span>
+        </div>
+        <div class="mpm-verify-grid">
+          <div class="item">
+            <span class="label">兑换单号</span>
+            <span class="value mono">{{ record.recordNo }}</span>
+          </div>
+          <div class="item">
+            <span class="label">消耗积分</span>
+            <span class="value is-primary">{{
+              formatPoints(record.usedPoints)
+            }}</span>
+          </div>
+          <div class="item">
+            <span class="label">兑换会员</span>
+            <span class="value">{{ resolveMemberText(record) }}</span>
+          </div>
+          <div class="item">
+            <span class="label">兑换时间</span>
+            <span class="value">{{ record.redeemedAt }}</span>
+          </div>
+        </div>
+      </div>
+
+      <Form layout="vertical">
+        <Form.Item label="核销方式">
+          <div class="mpm-pill-row">
+            <button
+              v-for="item in POINTS_MALL_VERIFY_METHOD_OPTIONS"
+              :key="item.value"
+              type="button"
+              class="mpm-pill"
+              :class="{ checked: form.verifyMethod === item.value }"
+              :disabled="!canManage || loading"
+              @click="emit('setVerifyMethod', item.value)"
+            >
+              {{ item.label }}
+            </button>
+          </div>
+        </Form.Item>
+
+        <Form.Item label="核销备注">
+          <Input.TextArea
+            :value="form.verifyRemark"
+            :rows="3"
+            :maxlength="256"
+            :disabled="!canManage || loading"
+            placeholder="可选，如：顾客已到店领取"
+            @update:value="
+              (value) => emit('setVerifyRemark', String(value ?? ''))
+            "
+          />
+        </Form.Item>
+      </Form>
+    </div>
+
+    <template #footer>
+      <div class="mpm-drawer-footer">
+        <button type="button" class="g-btn" @click="emit('close')">取消</button>
+        <button
+          type="button"
+          class="g-btn g-btn-primary"
+          :disabled="!canManage || loading || submitting"
+          @click="emit('submit')"
+        >
+          确认核销
+        </button>
+      </div>
+    </template>
+  </Drawer>
+</template>

apps/web-antd/src/views/member/points-mall/composables/points-mall-page/constants.ts

@@ -0,0 +1,147 @@
+import type {
+  MemberPointMallExchangeType,
+  MemberPointMallNotifyChannel,
+  MemberPointMallPickupMethod,
+  MemberPointMallProductStatus,
+  MemberPointMallRecordStatus,
+  MemberPointMallRedeemType,
+  MemberPointMallVerifyMethod,
+} from '#/api/member/points-mall';
+import type { PointMallTabKey } from '#/views/member/points-mall/types';
+
+/** 积分商城查看权限。 */
+export const MEMBER_POINTS_MALL_VIEW_PERMISSION =
+  'tenant:member:points-mall:view';
+
+/** 积分商城管理权限。 */
+export const MEMBER_POINTS_MALL_MANAGE_PERMISSION =
+  'tenant:member:points-mall:manage';
+
+/** 页面 Tab 选项。 */
+export const POINTS_MALL_TAB_OPTIONS: Array<{
+  label: string;
+  value: PointMallTabKey;
+}> = [
+  { label: '积分规则', value: 'rules' },
+  { label: '兑换商品', value: 'products' },
+  { label: '兑换记录', value: 'records' },
+];
+
+/** 商品状态筛选。 */
+export const POINTS_MALL_PRODUCT_STATUS_FILTER_OPTIONS: Array<{
+  label: string;
+  value: '' | MemberPointMallProductStatus;
+}> = [
+  { label: '全部状态', value: '' },
+  { label: '上架', value: 'enabled' },
+  { label: '下架', value: 'disabled' },
+];
+
+/** 记录类型筛选。 */
+export const POINTS_MALL_RECORD_REDEEM_FILTER_OPTIONS: Array<{
+  label: string;
+  value: '' | MemberPointMallRedeemType;
+}> = [
+  { label: '全部类型', value: '' },
+  { label: '兑换商品', value: 'product' },
+  { label: '兑换优惠券', value: 'coupon' },
+  { label: '兑换实物', value: 'physical' },
+];
+
+/** 记录状态筛选。 */
+export const POINTS_MALL_RECORD_STATUS_FILTER_OPTIONS: Array<{
+  label: string;
+  value: '' | MemberPointMallRecordStatus;
+}> = [
+  { label: '全部状态', value: '' },
+  { label: '待领取', value: 'pending_pickup' },
+  { label: '已发放', value: 'issued' },
+  { label: '已完成', value: 'completed' },
+  { label: '已取消', value: 'canceled' },
+];
+
+/** 兑换类型选项。 */
+export const POINTS_MALL_REDEEM_TYPE_OPTIONS: Array<{
+  label: string;
+  value: MemberPointMallRedeemType;
+}> = [
+  { label: '兑换商品', value: 'product' },
+  { label: '兑换优惠券', value: 'coupon' },
+  { label: '兑换实物', value: 'physical' },
+];
+
+/** 兑换类型提示。 */
+export const POINTS_MALL_REDEEM_TYPE_HINT_MAP: Record<
+  MemberPointMallRedeemType,
+  string
+> = {
+  product: '顾客兑换后系统自动发放商品兑换券，下单时该商品免费',
+  coupon: '顾客兑换后优惠券直接发到券包',
+  physical: '实物商品需到店自提，不走线上履约',
+};
+
+/** 领取方式选项。 */
+export const POINTS_MALL_PICKUP_METHOD_OPTIONS: Array<{
+  label: string;
+  value: MemberPointMallPickupMethod;
+}> = [
+  { label: '到店自提', value: 'store_pickup' },
+  { label: '快递配送', value: 'delivery' },
+];
+
+/** 兑换方式选项。 */
+export const POINTS_MALL_EXCHANGE_TYPE_OPTIONS: Array<{
+  label: string;
+  value: MemberPointMallExchangeType;
+}> = [
+  { label: '纯积分', value: 'points' },
+  { label: '积分 + 现金', value: 'mixed' },
+];
+
+/** 通知渠道选项。 */
+export const POINTS_MALL_NOTIFY_CHANNEL_OPTIONS: Array<{
+  label: string;
+  value: MemberPointMallNotifyChannel;
+}> = [
+  { label: '站内消息', value: 'in_app' },
+  { label: '短信通知', value: 'sms' },
+];
+
+/** 核销方式选项。 */
+export const POINTS_MALL_VERIFY_METHOD_OPTIONS: Array<{
+  label: string;
+  value: MemberPointMallVerifyMethod;
+}> = [
+  { label: '扫码核销', value: 'scan' },
+  { label: '手动核销', value: 'manual' },
+];
+
+/** 商品状态文案。 */
+export const POINTS_MALL_PRODUCT_STATUS_TEXT_MAP: Record<
+  MemberPointMallProductStatus,
+  string
+> = {
+  enabled: '上架',
+  disabled: '下架',
+};
+
+/** 类型 Tag 样式。 */
+export const POINTS_MALL_REDEEM_TYPE_CLASS_MAP: Record<
+  MemberPointMallRedeemType,
+  'is-blue' | 'is-green' | 'is-orange'
+> = {
+  product: 'is-blue',
+  coupon: 'is-green',
+  physical: 'is-orange',
+};
+
+/** 记录状态样式。 */
+export const POINTS_MALL_RECORD_STATUS_CLASS_MAP: Record<
+  MemberPointMallRecordStatus,
+  'is-gray' | 'is-green' | 'is-orange' | 'is-red'
+> = {
+  pending_pickup: 'is-orange',
+  issued: 'is-green',
+  completed: 'is-green',
+  canceled: 'is-gray',
+};

apps/web-antd/src/views/member/points-mall/composables/points-mall-page/data-actions.ts

@@ -0,0 +1,207 @@
+import type { Ref } from 'vue';
+
+import type { StoreListItemDto } from '#/api/store';
+import type {
+  PointMallProductCardViewModel,
+  PointMallProductFilterForm,
+  PointMallRecordFilterForm,
+  PointMallRecordPager,
+  PointMallRecordStatsViewModel,
+  PointMallRuleForm,
+  PointMallRuleStatsViewModel,
+} from '#/views/member/points-mall/types';
+
+import { message } from 'ant-design-vue';
+
+import {
+  getMemberPointMallProductListApi,
+  getMemberPointMallRecordListApi,
+  getMemberPointMallRuleDetailApi,
+} from '#/api/member/points-mall';
+import { getStoreListApi } from '#/api/store';
+
+import { mapRecordFilterToQuery, mapRuleToForm } from './helpers';
+
+interface CreateDataActionsOptions {
+  isProductLoading: Ref<boolean>;
+  isRecordLoading: Ref<boolean>;
+  isRuleLoading: Ref<boolean>;
+  isStoreLoading: Ref<boolean>;
+  productFilterForm: PointMallProductFilterForm;
+  productRows: Ref<PointMallProductCardViewModel[]>;
+  recordFilterForm: PointMallRecordFilterForm;
+  recordPager: Ref<PointMallRecordPager>;
+  recordStats: Ref<PointMallRecordStatsViewModel>;
+  ruleForm: PointMallRuleForm;
+  ruleStats: Ref<PointMallRuleStatsViewModel>;
+  selectedStoreId: Ref<string>;
+  stores: Ref<StoreListItemDto[]>;
+}
+
+export function createDataActions(options: CreateDataActionsOptions) {
+  function resetRuleData() {
+    options.ruleStats.value = {
+      totalIssuedPoints: 0,
+      redeemedPoints: 0,
+      pointMembers: 0,
+      redeemRate: 0,
+    };
+  }
+
+  function resetProductData() {
+    options.productRows.value = [];
+  }
+
+  function resetRecordData() {
+    options.recordPager.value = {
+      ...options.recordPager.value,
+      items: [],
+      totalCount: 0,
+    };
+    options.recordStats.value = {
+      todayRedeemCount: 0,
+      pendingPhysicalCount: 0,
+      currentMonthUsedPoints: 0,
+    };
+  }
+
+  async function loadStores() {
+    options.isStoreLoading.value = true;
+    try {
+      const result = await getStoreListApi({
+        page: 1,
+        pageSize: 200,
+      });
+
+      options.stores.value = result.items ?? [];
+
+      if (options.stores.value.length === 0) {
+        options.selectedStoreId.value = '';
+        resetRuleData();
+        resetProductData();
+        resetRecordData();
+        return;
+      }
+
+      if (!options.selectedStoreId.value) {
+        options.selectedStoreId.value = options.stores.value[0]?.id ?? '';
+        return;
+      }
+
+      const exists = options.stores.value.some(
+        (item) => item.id === options.selectedStoreId.value,
+      );
+      if (!exists) {
+        options.selectedStoreId.value = options.stores.value[0]?.id ?? '';
+      }
+    } catch (error) {
+      console.error(error);
+      message.error('加载门店失败');
+    } finally {
+      options.isStoreLoading.value = false;
+    }
+  }
+
+  async function loadRuleDetail() {
+    if (!options.selectedStoreId.value) {
+      resetRuleData();
+      return;
+    }
+
+    options.isRuleLoading.value = true;
+    try {
+      const result = await getMemberPointMallRuleDetailApi({
+        storeId: options.selectedStoreId.value,
+      });
+
+      const form = mapRuleToForm({
+        ...result.rule,
+        storeId: options.selectedStoreId.value,
+      });
+      options.ruleForm.isConsumeRewardEnabled = form.isConsumeRewardEnabled;
+      options.ruleForm.consumeAmountPerStep = form.consumeAmountPerStep;
+      options.ruleForm.consumeRewardPointsPerStep =
+        form.consumeRewardPointsPerStep;
+      options.ruleForm.isReviewRewardEnabled = form.isReviewRewardEnabled;
+      options.ruleForm.reviewRewardPoints = form.reviewRewardPoints;
+      options.ruleForm.isRegisterRewardEnabled = form.isRegisterRewardEnabled;
+      options.ruleForm.registerRewardPoints = form.registerRewardPoints;
+      options.ruleForm.isSigninRewardEnabled = form.isSigninRewardEnabled;
+      options.ruleForm.signinRewardPoints = form.signinRewardPoints;
+      options.ruleForm.expiryMode = form.expiryMode;
+      options.ruleStats.value = result.stats ?? options.ruleStats.value;
+    } catch (error) {
+      console.error(error);
+      resetRuleData();
+      message.error('加载积分规则失败');
+    } finally {
+      options.isRuleLoading.value = false;
+    }
+  }
+
+  async function loadProductList() {
+    if (!options.selectedStoreId.value) {
+      resetProductData();
+      return;
+    }
+
+    options.isProductLoading.value = true;
+    try {
+      const result = await getMemberPointMallProductListApi({
+        storeId: options.selectedStoreId.value,
+        status: options.productFilterForm.status || undefined,
+        keyword: options.productFilterForm.keyword.trim() || undefined,
+      });
+      options.productRows.value = result.items ?? [];
+    } catch (error) {
+      console.error(error);
+      resetProductData();
+      message.error('加载兑换商品失败');
+    } finally {
+      options.isProductLoading.value = false;
+    }
+  }
+
+  async function loadRecordList() {
+    if (!options.selectedStoreId.value) {
+      resetRecordData();
+      return;
+    }
+
+    options.isRecordLoading.value = true;
+    try {
+      const query = mapRecordFilterToQuery(options.recordFilterForm);
+      const result = await getMemberPointMallRecordListApi({
+        storeId: options.selectedStoreId.value,
+        page: options.recordPager.value.page,
+        pageSize: options.recordPager.value.pageSize,
+        ...query,
+      });
+
+      options.recordPager.value = {
+        items: result.items ?? [],
+        page: result.page,
+        pageSize: result.pageSize,
+        totalCount: result.totalCount,
+      };
+      options.recordStats.value = result.stats ?? {
+        todayRedeemCount: 0,
+        pendingPhysicalCount: 0,
+        currentMonthUsedPoints: 0,
+      };
+    } catch (error) {
+      console.error(error);
+      resetRecordData();
+      message.error('加载兑换记录失败');
+    } finally {
+      options.isRecordLoading.value = false;
+    }
+  }
+
+  return {
+    loadProductList,
+    loadRecordList,
+    loadRuleDetail,
+    loadStores,
+  };
+}

apps/web-antd/src/views/member/points-mall/composables/points-mall-page/drawer-actions.ts

@@ -0,0 +1,356 @@
+import type { Ref } from 'vue';
+
+import type {
+  PointMallProductCardViewModel,
+  PointMallProductEditorForm,
+} from '#/views/member/points-mall/types';
+
+import { message } from 'ant-design-vue';
+
+import { getMemberCouponPickerApi } from '#/api/member';
+import {
+  getMemberPointMallProductDetailApi,
+  saveMemberPointMallProductApi,
+} from '#/api/member/points-mall';
+
+import {
+  mapProductEditorFormToSavePayload,
+  mapProductToEditorForm,
+  resetProductEditorForm,
+} from './helpers';
+
+interface CouponOption {
+  label: string;
+  value: string;
+}
+
+interface CreateDrawerActionsOptions {
+  canManage: Ref<boolean>;
+  couponOptions: Ref<CouponOption[]>;
+  drawerMode: Ref<'create' | 'edit'>;
+  form: PointMallProductEditorForm;
+  isDrawerLoading: Ref<boolean>;
+  isDrawerOpen: Ref<boolean>;
+  isDrawerSubmitting: Ref<boolean>;
+  loadProductList: () => Promise<void>;
+  openPicker: (currentProductId?: string) => Promise<void>;
+  selectedStoreId: Ref<string>;
+}
+
+export function createDrawerActions(options: CreateDrawerActionsOptions) {
+  async function loadCouponOptions(keyword?: string) {
+    if (!options.selectedStoreId.value) {
+      options.couponOptions.value = [];
+      return;
+    }
+
+    try {
+      const rows = await getMemberCouponPickerApi({
+        storeId: options.selectedStoreId.value,
+        keyword: keyword?.trim() || undefined,
+      });
+      options.couponOptions.value = rows.map((item) => ({
+        label: item.displayText || item.name,
+        value: item.couponTemplateId,
+      }));
+    } catch (error) {
+      console.error(error);
+      options.couponOptions.value = [];
+      message.error('加载优惠券失败');
+    }
+  }
+
+  async function openCreateDrawer() {
+    if (!options.selectedStoreId.value) {
+      message.warning('请先选择门店');
+      return;
+    }
+
+    options.drawerMode.value = 'create';
+    resetProductEditorForm(options.form);
+    options.isDrawerLoading.value = false;
+    options.isDrawerOpen.value = true;
+    await loadCouponOptions();
+  }
+
+  async function openEditDrawer(item: PointMallProductCardViewModel) {
+    if (!options.selectedStoreId.value) {
+      message.warning('请先选择门店');
+      return;
+    }
+
+    options.drawerMode.value = 'edit';
+    options.isDrawerLoading.value = true;
+    options.isDrawerOpen.value = true;
+
+    try {
+      const detail = await getMemberPointMallProductDetailApi({
+        storeId: options.selectedStoreId.value,
+        pointMallProductId: item.pointMallProductId,
+      });
+      const mapped = mapProductToEditorForm(detail);
+
+      options.form.pointMallProductId = mapped.pointMallProductId;
+      options.form.redeemType = mapped.redeemType;
+      options.form.productId = mapped.productId;
+      options.form.productName = mapped.productName;
+      options.form.couponTemplateId = mapped.couponTemplateId;
+      options.form.couponTemplateName = mapped.couponTemplateName;
+      options.form.physicalName = mapped.physicalName;
+      options.form.pickupMethod = mapped.pickupMethod;
+      options.form.name = mapped.name;
+      options.form.imageUrl = mapped.imageUrl;
+      options.form.exchangeType = mapped.exchangeType;
+      options.form.requiredPoints = mapped.requiredPoints;
+      options.form.cashAmount = mapped.cashAmount;
+      options.form.stockTotal = mapped.stockTotal;
+      options.form.perMemberLimit = mapped.perMemberLimit;
+      options.form.description = mapped.description;
+      options.form.notifyChannels = [...mapped.notifyChannels];
+      options.form.status = mapped.status;
+
+      if (detail.redeemType === 'coupon') {
+        await loadCouponOptions();
+        const selected = options.couponOptions.value.find(
+          (row) => row.value === detail.couponTemplateId,
+        );
+        options.form.couponTemplateName = selected?.label ?? '';
+      }
+    } catch (error) {
+      console.error(error);
+      message.error('加载兑换商品详情失败');
+      options.isDrawerOpen.value = false;
+    } finally {
+      options.isDrawerLoading.value = false;
+    }
+  }
+
+  function setDrawerOpen(value: boolean) {
+    options.isDrawerOpen.value = value;
+    if (!value) {
+      options.isDrawerLoading.value = false;
+      options.isDrawerSubmitting.value = false;
+    }
+  }
+
+  function setFormName(value: string) {
+    options.form.name = value;
+  }
+
+  function setFormImageUrl(value: string) {
+    options.form.imageUrl = value;
+  }
+
+  function setFormRedeemType(value: PointMallProductEditorForm['redeemType']) {
+    options.form.redeemType = value;
+
+    if (value !== 'product') {
+      options.form.productId = '';
+      options.form.productName = '';
+    }
+    if (value !== 'coupon') {
+      options.form.couponTemplateId = '';
+      options.form.couponTemplateName = '';
+    }
+    if (value !== 'physical') {
+      options.form.physicalName = '';
+      options.form.pickupMethod = 'store_pickup';
+    }
+
+    if (value === 'physical') {
+      options.form.notifyChannels = ['in_app', 'sms'];
+      return;
+    }
+
+    if (!options.form.notifyChannels.includes('in_app')) {
+      options.form.notifyChannels = ['in_app'];
+    }
+  }
+
+  function setFormProduct(value: { id: string; name: string }) {
+    options.form.productId = value.id;
+    options.form.productName = value.name;
+  }
+
+  function setFormCouponTemplateId(value: string) {
+    options.form.couponTemplateId = value;
+    const selected = options.couponOptions.value.find(
+      (item) => item.value === value,
+    );
+    options.form.couponTemplateName = selected?.label ?? '';
+  }
+
+  function setFormPhysicalName(value: string) {
+    options.form.physicalName = value;
+  }
+
+  function setFormPickupMethod(
+    value: PointMallProductEditorForm['pickupMethod'],
+  ) {
+    options.form.pickupMethod = value;
+  }
+
+  function setFormDescription(value: string) {
+    options.form.description = value;
+  }
+
+  function setFormExchangeType(
+    value: PointMallProductEditorForm['exchangeType'],
+  ) {
+    options.form.exchangeType = value;
+    if (value === 'points') {
+      options.form.cashAmount = null;
+    }
+  }
+
+  function setFormRequiredPoints(value: null | number) {
+    options.form.requiredPoints = value;
+  }
+
+  function setFormCashAmount(value: null | number) {
+    options.form.cashAmount = value;
+  }
+
+  function setFormStockTotal(value: null | number) {
+    options.form.stockTotal = value;
+  }
+
+  function setFormPerMemberLimit(value: null | number) {
+    options.form.perMemberLimit = value;
+  }
+
+  function setFormStatus(value: PointMallProductEditorForm['status']) {
+    options.form.status = value;
+  }
+
+  function toggleNotifyChannel(value: 'in_app' | 'sms') {
+    if (options.form.notifyChannels.includes(value)) {
+      if (options.form.notifyChannels.length === 1) {
+        return;
+      }
+      options.form.notifyChannels = options.form.notifyChannels.filter(
+        (item) => item !== value,
+      );
+      return;
+    }
+
+    options.form.notifyChannels = [...options.form.notifyChannels, value];
+  }
+
+  async function openProductPicker() {
+    await options.openPicker(options.form.productId || undefined);
+  }
+
+  function validateForm() {
+    if (!options.form.name.trim()) {
+      message.warning('请填写展示名称');
+      return false;
+    }
+
+    if (!options.form.requiredPoints || options.form.requiredPoints <= 0) {
+      message.warning('所需积分必须大于 0');
+      return false;
+    }
+
+    if (options.form.stockTotal === null || options.form.stockTotal < 0) {
+      message.warning('库存数量不能小于 0');
+      return false;
+    }
+
+    if (options.form.redeemType === 'product' && !options.form.productId) {
+      message.warning('请选择关联商品');
+      return false;
+    }
+
+    if (
+      options.form.redeemType === 'coupon' &&
+      !options.form.couponTemplateId.trim()
+    ) {
+      message.warning('请选择关联优惠券');
+      return false;
+    }
+
+    if (
+      options.form.redeemType === 'physical' &&
+      !options.form.physicalName.trim()
+    ) {
+      message.warning('请填写实物名称');
+      return false;
+    }
+
+    if (
+      options.form.exchangeType === 'mixed' &&
+      (!options.form.cashAmount || options.form.cashAmount <= 0)
+    ) {
+      message.warning('积分+现金模式下，现金部分必须大于 0');
+      return false;
+    }
+
+    if (options.form.notifyChannels.length === 0) {
+      message.warning('请至少选择一种通知方式');
+      return false;
+    }
+
+    return true;
+  }
+
+  async function submitDrawer() {
+    if (!options.canManage.value) {
+      return;
+    }
+
+    if (!options.selectedStoreId.value) {
+      message.warning('请先选择门店');
+      return;
+    }
+
+    if (!validateForm()) {
+      return;
+    }
+
+    options.isDrawerSubmitting.value = true;
+    try {
+      await saveMemberPointMallProductApi(
+        mapProductEditorFormToSavePayload(
+          options.form,
+          options.selectedStoreId.value,
+        ),
+      );
+
+      message.success(
+        options.drawerMode.value === 'create' ? '添加成功' : '保存成功',
+      );
+      options.isDrawerOpen.value = false;
+      await options.loadProductList();
+    } catch (error) {
+      console.error(error);
+      message.error('保存失败');
+    } finally {
+      options.isDrawerSubmitting.value = false;
+    }
+  }
+
+  return {
+    loadCouponOptions,
+    openCreateDrawer,
+    openEditDrawer,
+    openProductPicker,
+    setDrawerOpen,
+    setFormCashAmount,
+    setFormCouponTemplateId,
+    setFormDescription,
+    setFormExchangeType,
+    setFormImageUrl,
+    setFormName,
+    setFormPerMemberLimit,
+    setFormPhysicalName,
+    setFormPickupMethod,
+    setFormProduct,
+    setFormRedeemType,
+    setFormRequiredPoints,
+    setFormStatus,
+    setFormStockTotal,
+    submitDrawer,
+    toggleNotifyChannel,
+  };
+}

apps/web-antd/src/views/member/points-mall/composables/points-mall-page/helpers.ts

@@ -0,0 +1,234 @@
+import type {
+  ExportMemberPointMallRecordQuery,
+  MemberPointMallProductDto,
+  MemberPointMallRecordListQuery,
+  SaveMemberPointMallProductPayload,
+  SaveMemberPointMallRulePayload,
+} from '#/api/member/points-mall';
+import type {
+  PointMallProductEditorForm,
+  PointMallRecordFilterForm,
+  PointMallRuleForm,
+} from '#/views/member/points-mall/types';
+
+import {
+  createDefaultPointMallProductEditorForm,
+  createDefaultPointMallRuleForm,
+} from '#/views/member/points-mall/types';
+
+/** 数量格式化。 */
+export function formatInteger(value: null | number | undefined) {
+  const num = Number(value ?? 0);
+  if (!Number.isFinite(num)) {
+    return '0';
+  }
+  return Math.round(num).toLocaleString('zh-CN');
+}
+
+/** 积分格式化。 */
+export function formatPoints(value: null | number | undefined) {
+  return formatInteger(value);
+}
+
+/** 金额格式化。 */
+export function formatCurrency(value: null | number | undefined) {
+  const amount = Number(value ?? 0);
+  if (Number.isNaN(amount)) {
+    return '¥0.00';
+  }
+  return `¥${amount.toFixed(2)}`;
+}
+
+/** 判断字符串是否为空。 */
+export function isBlank(value: string | undefined) {
+  return !value || value.trim().length === 0;
+}
+
+/** 规则 DTO -> 表单。 */
+export function mapRuleToForm(
+  rule: SaveMemberPointMallRulePayload,
+): PointMallRuleForm {
+  return {
+    isConsumeRewardEnabled: Boolean(rule.isConsumeRewardEnabled),
+    consumeAmountPerStep: Number(rule.consumeAmountPerStep),
+    consumeRewardPointsPerStep: Number(rule.consumeRewardPointsPerStep),
+    isReviewRewardEnabled: Boolean(rule.isReviewRewardEnabled),
+    reviewRewardPoints: Number(rule.reviewRewardPoints),
+    isRegisterRewardEnabled: Boolean(rule.isRegisterRewardEnabled),
+    registerRewardPoints: Number(rule.registerRewardPoints),
+    isSigninRewardEnabled: Boolean(rule.isSigninRewardEnabled),
+    signinRewardPoints: Number(rule.signinRewardPoints),
+    expiryMode: rule.expiryMode,
+  };
+}
+
+/** 规则表单 -> 保存 DTO。 */
+export function mapRuleFormToSavePayload(
+  form: PointMallRuleForm,
+  storeId: string,
+): SaveMemberPointMallRulePayload {
+  return {
+    storeId,
+    isConsumeRewardEnabled: form.isConsumeRewardEnabled,
+    consumeAmountPerStep: Number(form.consumeAmountPerStep ?? 0),
+    consumeRewardPointsPerStep: Number(form.consumeRewardPointsPerStep ?? 0),
+    isReviewRewardEnabled: form.isReviewRewardEnabled,
+    reviewRewardPoints: Number(form.reviewRewardPoints ?? 0),
+    isRegisterRewardEnabled: form.isRegisterRewardEnabled,
+    registerRewardPoints: Number(form.registerRewardPoints ?? 0),
+    isSigninRewardEnabled: form.isSigninRewardEnabled,
+    signinRewardPoints: Number(form.signinRewardPoints ?? 0),
+    expiryMode: form.expiryMode,
+  };
+}
+
+/** 重置规则表单。 */
+export function resetRuleForm(form: PointMallRuleForm) {
+  const defaults = createDefaultPointMallRuleForm();
+  form.isConsumeRewardEnabled = defaults.isConsumeRewardEnabled;
+  form.consumeAmountPerStep = defaults.consumeAmountPerStep;
+  form.consumeRewardPointsPerStep = defaults.consumeRewardPointsPerStep;
+  form.isReviewRewardEnabled = defaults.isReviewRewardEnabled;
+  form.reviewRewardPoints = defaults.reviewRewardPoints;
+  form.isRegisterRewardEnabled = defaults.isRegisterRewardEnabled;
+  form.registerRewardPoints = defaults.registerRewardPoints;
+  form.isSigninRewardEnabled = defaults.isSigninRewardEnabled;
+  form.signinRewardPoints = defaults.signinRewardPoints;
+  form.expiryMode = defaults.expiryMode;
+}
+
+/** 商品 DTO -> 编辑表单。 */
+export function mapProductToEditorForm(
+  source: MemberPointMallProductDto,
+): PointMallProductEditorForm {
+  return {
+    pointMallProductId: source.pointMallProductId,
+    redeemType: source.redeemType,
+    productId: source.productId ?? '',
+    productName: '',
+    couponTemplateId: source.couponTemplateId ?? '',
+    couponTemplateName: '',
+    physicalName: source.physicalName ?? '',
+    pickupMethod: source.pickupMethod ?? 'store_pickup',
+    name: source.name,
+    imageUrl: source.imageUrl ?? '',
+    exchangeType: source.exchangeType,
+    requiredPoints: source.requiredPoints,
+    cashAmount: source.exchangeType === 'mixed' ? source.cashAmount : null,
+    stockTotal: source.stockTotal,
+    perMemberLimit: source.perMemberLimit ?? null,
+    description: source.description ?? '',
+    notifyChannels: [...source.notifyChannels],
+    status: source.status,
+  };
+}
+
+/** 商品表单 -> 保存 DTO。 */
+export function mapProductEditorFormToSavePayload(
+  form: PointMallProductEditorForm,
+  storeId: string,
+): SaveMemberPointMallProductPayload {
+  return {
+    storeId,
+    pointMallProductId: form.pointMallProductId || undefined,
+    name: form.name.trim(),
+    imageUrl: form.imageUrl.trim() || undefined,
+    redeemType: form.redeemType,
+    productId: form.productId || undefined,
+    couponTemplateId: form.couponTemplateId || undefined,
+    physicalName: form.physicalName.trim() || undefined,
+    pickupMethod:
+      form.redeemType === 'physical' ? form.pickupMethod : undefined,
+    description: form.description.trim() || undefined,
+    exchangeType: form.exchangeType,
+    requiredPoints: Number(form.requiredPoints ?? 0),
+    cashAmount: Number(form.cashAmount ?? 0),
+    stockTotal: Number(form.stockTotal ?? 0),
+    perMemberLimit:
+      form.perMemberLimit && form.perMemberLimit > 0
+        ? Number(form.perMemberLimit)
+        : undefined,
+    notifyChannels: [...form.notifyChannels],
+    status: form.status,
+  };
+}
+
+/** 重置商品编辑表单。 */
+export function resetProductEditorForm(form: PointMallProductEditorForm) {
+  const defaults = createDefaultPointMallProductEditorForm();
+  form.pointMallProductId = defaults.pointMallProductId;
+  form.redeemType = defaults.redeemType;
+  form.productId = defaults.productId;
+  form.productName = defaults.productName;
+  form.couponTemplateId = defaults.couponTemplateId;
+  form.couponTemplateName = defaults.couponTemplateName;
+  form.physicalName = defaults.physicalName;
+  form.pickupMethod = defaults.pickupMethod;
+  form.name = defaults.name;
+  form.imageUrl = defaults.imageUrl;
+  form.exchangeType = defaults.exchangeType;
+  form.requiredPoints = defaults.requiredPoints;
+  form.cashAmount = defaults.cashAmount;
+  form.stockTotal = defaults.stockTotal;
+  form.perMemberLimit = defaults.perMemberLimit;
+  form.description = defaults.description;
+  form.notifyChannels = [...defaults.notifyChannels];
+  form.status = defaults.status;
+}
+
+/** 记录筛选项映射。 */
+export function mapRecordFilterToQuery(
+  filterForm: PointMallRecordFilterForm,
+): Pick<
+  ExportMemberPointMallRecordQuery & MemberPointMallRecordListQuery,
+  'endDate' | 'keyword' | 'redeemType' | 'startDate' | 'status'
+> {
+  const query: Pick<
+    ExportMemberPointMallRecordQuery & MemberPointMallRecordListQuery,
+    'endDate' | 'keyword' | 'redeemType' | 'startDate' | 'status'
+  > = {};
+
+  if (filterForm.redeemType) {
+    query.redeemType = filterForm.redeemType;
+  }
+
+  if (filterForm.status) {
+    query.status = filterForm.status;
+  }
+
+  const keyword = filterForm.keyword.trim();
+  if (keyword) {
+    query.keyword = keyword;
+  }
+
+  if (filterForm.dateRange && filterForm.dateRange.length === 2) {
+    query.startDate = filterForm.dateRange[0].format('YYYY-MM-DD');
+    query.endDate = filterForm.dateRange[1].format('YYYY-MM-DD');
+  }
+
+  return query;
+}
+
+/** base64 下载。 */
+export function downloadBase64File(
+  fileName: string,
+  fileContentBase64: string,
+) {
+  const binary = atob(fileContentBase64);
+  const length = binary.length;
+  const bytes = new Uint8Array(length);
+
+  for (let index = 0; index < length; index++) {
+    bytes[index] = binary.codePointAt(index) ?? 0;
+  }
+
+  const blob = new Blob([bytes], { type: 'text/csv;charset=utf-8;' });
+  const url = URL.createObjectURL(blob);
+  const anchor = document.createElement('a');
+  anchor.href = url;
+  anchor.download = fileName;
+  document.body.append(anchor);
+  anchor.click();
+  anchor.remove();
+  URL.revokeObjectURL(url);
+}

apps/web-antd/src/views/member/points-mall/composables/points-mall-page/picker-actions.ts

@@ -0,0 +1,83 @@
+import type { Ref } from 'vue';
+
+import type { ProductPickerItemDto } from '#/api/product';
+
+import { message } from 'ant-design-vue';
+
+import { searchProductPickerApi } from '#/api/product';
+
+interface CreatePickerActionsOptions {
+  isPickerLoading: Ref<boolean>;
+  isPickerOpen: Ref<boolean>;
+  onPicked: (item: ProductPickerItemDto | undefined) => void;
+  pickerKeyword: Ref<string>;
+  pickerRows: Ref<ProductPickerItemDto[]>;
+  pickerSelectedId: Ref<string>;
+  selectedStoreId: Ref<string>;
+}
+
+export function createPickerActions(options: CreatePickerActionsOptions) {
+  async function loadPickerProducts() {
+    if (!options.selectedStoreId.value) {
+      options.pickerRows.value = [];
+      return;
+    }
+
+    options.isPickerLoading.value = true;
+    try {
+      options.pickerRows.value = await searchProductPickerApi({
+        storeId: options.selectedStoreId.value,
+        keyword: options.pickerKeyword.value.trim() || undefined,
+        limit: 500,
+      });
+    } catch (error) {
+      console.error(error);
+      options.pickerRows.value = [];
+      message.error('加载商品失败');
+    } finally {
+      options.isPickerLoading.value = false;
+    }
+  }
+
+  async function openPicker(currentProductId?: string) {
+    options.pickerKeyword.value = '';
+    options.pickerSelectedId.value = currentProductId ?? '';
+    options.pickerRows.value = [];
+    options.isPickerOpen.value = true;
+    await loadPickerProducts();
+  }
+
+  function setPickerOpen(value: boolean) {
+    options.isPickerOpen.value = value;
+  }
+
+  function setPickerKeyword(value: string) {
+    options.pickerKeyword.value = value;
+  }
+
+  function setPickerSelectedId(value: string) {
+    options.pickerSelectedId.value = value;
+  }
+
+  function submitPicker() {
+    if (!options.pickerSelectedId.value) {
+      message.warning('请选择商品');
+      return;
+    }
+
+    const selected = options.pickerRows.value.find(
+      (item) => item.id === options.pickerSelectedId.value,
+    );
+    options.onPicked(selected);
+    options.isPickerOpen.value = false;
+  }
+
+  return {
+    loadPickerProducts,
+    openPicker,
+    setPickerKeyword,
+    setPickerOpen,
+    setPickerSelectedId,
+    submitPicker,
+  };
+}

apps/web-antd/src/views/member/points-mall/composables/points-mall-page/product-actions.ts

@@ -0,0 +1,80 @@
+import type { Ref } from 'vue';
+
+import type { PointMallProductCardViewModel } from '#/views/member/points-mall/types';
+
+import { message, Modal } from 'ant-design-vue';
+
+import {
+  changeMemberPointMallProductStatusApi,
+  deleteMemberPointMallProductApi,
+} from '#/api/member/points-mall';
+
+interface CreateProductActionsOptions {
+  canManage: Ref<boolean>;
+  loadProductList: () => Promise<void>;
+  selectedStoreId: Ref<string>;
+}
+
+export function createProductActions(options: CreateProductActionsOptions) {
+  async function toggleStatus(item: PointMallProductCardViewModel) {
+    if (!options.canManage.value) {
+      return;
+    }
+
+    if (!options.selectedStoreId.value) {
+      message.warning('请先选择门店');
+      return;
+    }
+
+    const targetStatus = item.status === 'enabled' ? 'disabled' : 'enabled';
+    try {
+      await changeMemberPointMallProductStatusApi({
+        storeId: options.selectedStoreId.value,
+        pointMallProductId: item.pointMallProductId,
+        status: targetStatus,
+      });
+      message.success(targetStatus === 'enabled' ? '商品已上架' : '商品已下架');
+      await options.loadProductList();
+    } catch (error) {
+      console.error(error);
+      message.error('状态更新失败');
+    }
+  }
+
+  function removeProduct(item: PointMallProductCardViewModel) {
+    if (!options.canManage.value) {
+      return;
+    }
+
+    if (!options.selectedStoreId.value) {
+      message.warning('请先选择门店');
+      return;
+    }
+
+    Modal.confirm({
+      title: '删除兑换商品',
+      content: `确认删除「${item.name}」吗？删除后不可恢复。`,
+      okText: '删除',
+      okType: 'danger',
+      cancelText: '取消',
+      async onOk() {
+        try {
+          await deleteMemberPointMallProductApi({
+            storeId: options.selectedStoreId.value,
+            pointMallProductId: item.pointMallProductId,
+          });
+          message.success('删除成功');
+          await options.loadProductList();
+        } catch (error) {
+          console.error(error);
+          message.error('删除失败');
+        }
+      },
+    });
+  }
+
+  return {
+    removeProduct,
+    toggleStatus,
+  };
+}

apps/web-antd/src/views/member/points-mall/composables/points-mall-page/record-actions.ts

@@ -0,0 +1,158 @@
+import type { Ref } from 'vue';
+
+import type {
+  PointMallRecordDetailViewModel,
+  PointMallVerifyForm,
+} from '#/views/member/points-mall/types';
+
+import { message } from 'ant-design-vue';
+
+import {
+  getMemberPointMallRecordDetailApi,
+  verifyMemberPointMallRecordApi,
+} from '#/api/member/points-mall';
+
+interface CreateRecordActionsOptions {
+  canManage: Ref<boolean>;
+  detailRecord: Ref<null | PointMallRecordDetailViewModel>;
+  isDetailLoading: Ref<boolean>;
+  isDetailOpen: Ref<boolean>;
+  isVerifyLoading: Ref<boolean>;
+  isVerifyOpen: Ref<boolean>;
+  isVerifySubmitting: Ref<boolean>;
+  loadRecordList: () => Promise<void>;
+  selectedRecordId: Ref<string>;
+  selectedStoreId: Ref<string>;
+  verifyForm: PointMallVerifyForm;
+}
+
+export function createRecordActions(options: CreateRecordActionsOptions) {
+  async function loadRecordDetail(recordId: string) {
+    if (!options.selectedStoreId.value || !recordId) {
+      options.detailRecord.value = null;
+      return;
+    }
+
+    const detail = await getMemberPointMallRecordDetailApi({
+      storeId: options.selectedStoreId.value,
+      recordId,
+    });
+    options.detailRecord.value = detail;
+  }
+
+  async function openDetailDrawer(recordId: string) {
+    if (!options.selectedStoreId.value) {
+      message.warning('请先选择门店');
+      return;
+    }
+
+    options.selectedRecordId.value = recordId;
+    options.isDetailLoading.value = true;
+    options.isDetailOpen.value = true;
+
+    try {
+      await loadRecordDetail(recordId);
+    } catch (error) {
+      console.error(error);
+      options.isDetailOpen.value = false;
+      message.error('加载记录详情失败');
+    } finally {
+      options.isDetailLoading.value = false;
+    }
+  }
+
+  async function openVerifyDrawer(recordId: string) {
+    if (!options.canManage.value) {
+      return;
+    }
+
+    if (!options.selectedStoreId.value) {
+      message.warning('请先选择门店');
+      return;
+    }
+
+    options.selectedRecordId.value = recordId;
+    options.isVerifyLoading.value = true;
+    options.isVerifyOpen.value = true;
+    options.verifyForm.verifyMethod = 'manual';
+    options.verifyForm.verifyRemark = '';
+
+    try {
+      await loadRecordDetail(recordId);
+    } catch (error) {
+      console.error(error);
+      options.isVerifyOpen.value = false;
+      message.error('加载核销信息失败');
+    } finally {
+      options.isVerifyLoading.value = false;
+    }
+  }
+
+  function setDetailOpen(value: boolean) {
+    options.isDetailOpen.value = value;
+    if (!value) {
+      options.isDetailLoading.value = false;
+    }
+  }
+
+  function setVerifyOpen(value: boolean) {
+    options.isVerifyOpen.value = value;
+    if (!value) {
+      options.isVerifyLoading.value = false;
+      options.isVerifySubmitting.value = false;
+    }
+  }
+
+  function setVerifyMethod(value: PointMallVerifyForm['verifyMethod']) {
+    options.verifyForm.verifyMethod = value;
+  }
+
+  function setVerifyRemark(value: string) {
+    options.verifyForm.verifyRemark = value;
+  }
+
+  async function submitVerify() {
+    if (!options.canManage.value) {
+      return;
+    }
+
+    if (!options.selectedStoreId.value) {
+      message.warning('请先选择门店');
+      return;
+    }
+
+    if (!options.selectedRecordId.value) {
+      message.warning('请选择需要核销的记录');
+      return;
+    }
+
+    options.isVerifySubmitting.value = true;
+    try {
+      await verifyMemberPointMallRecordApi({
+        storeId: options.selectedStoreId.value,
+        recordId: options.selectedRecordId.value,
+        verifyMethod: options.verifyForm.verifyMethod,
+        verifyRemark: options.verifyForm.verifyRemark.trim() || undefined,
+      });
+      message.success('核销成功');
+      options.isVerifyOpen.value = false;
+      await options.loadRecordList();
+      await loadRecordDetail(options.selectedRecordId.value);
+    } catch (error) {
+      console.error(error);
+      message.error('核销失败');
+    } finally {
+      options.isVerifySubmitting.value = false;
+    }
+  }
+
+  return {
+    openDetailDrawer,
+    openVerifyDrawer,
+    setDetailOpen,
+    setVerifyMethod,
+    setVerifyOpen,
+    setVerifyRemark,
+    submitVerify,
+  };
+}

apps/web-antd/src/views/member/points-mall/composables/useMemberPointsMallPage.ts

@@ -0,0 +1,587 @@
+import type { Dayjs } from 'dayjs';
+
+import type { ProductPickerItemDto } from '#/api/product';
+import type { StoreListItemDto } from '#/api/store';
+import type {
+  PointMallProductCardViewModel,
+  PointMallRecordDetailViewModel,
+  PointMallTabKey,
+} from '#/views/member/points-mall/types';
+
+import { computed, onMounted, reactive, ref, watch } from 'vue';
+
+import { useAccessStore } from '@vben/stores';
+
+import { message } from 'ant-design-vue';
+
+import {
+  exportMemberPointMallRecordApi,
+  saveMemberPointMallRuleApi,
+} from '#/api/member/points-mall';
+
+import {
+  createDefaultPointMallProductEditorForm,
+  createDefaultPointMallProductFilterForm,
+  createDefaultPointMallRecordFilterForm,
+  createDefaultPointMallRecordPager,
+  createDefaultPointMallRecordStats,
+  createDefaultPointMallRuleForm,
+  createDefaultPointMallRuleStats,
+  createDefaultPointMallVerifyForm,
+} from '../types';
+import {
+  MEMBER_POINTS_MALL_MANAGE_PERMISSION,
+  MEMBER_POINTS_MALL_VIEW_PERMISSION,
+  POINTS_MALL_TAB_OPTIONS,
+} from './points-mall-page/constants';
+import { createDataActions } from './points-mall-page/data-actions';
+import { createDrawerActions } from './points-mall-page/drawer-actions';
+import {
+  downloadBase64File,
+  mapRecordFilterToQuery,
+  mapRuleFormToSavePayload,
+  resetRuleForm,
+} from './points-mall-page/helpers';
+import { createPickerActions } from './points-mall-page/picker-actions';
+import { createProductActions } from './points-mall-page/product-actions';
+import { createRecordActions } from './points-mall-page/record-actions';
+
+export function useMemberPointsMallPage() {
+  const accessStore = useAccessStore();
+
+  const stores = ref<StoreListItemDto[]>([]);
+  const selectedStoreId = ref('');
+  const isStoreLoading = ref(false);
+
+  const activeTab = ref<PointMallTabKey>('rules');
+
+  const ruleForm = reactive(createDefaultPointMallRuleForm());
+  const ruleStats = ref(createDefaultPointMallRuleStats());
+  const isRuleLoading = ref(false);
+  const isRuleSubmitting = ref(false);
+
+  const productFilterForm = reactive(createDefaultPointMallProductFilterForm());
+  const productRows = ref<PointMallProductCardViewModel[]>([]);
+  const isProductLoading = ref(false);
+
+  const drawerMode = ref<'create' | 'edit'>('create');
+  const productForm = reactive(createDefaultPointMallProductEditorForm());
+  const isDrawerOpen = ref(false);
+  const isDrawerLoading = ref(false);
+  const isDrawerSubmitting = ref(false);
+  const couponOptions = ref<Array<{ label: string; value: string }>>([]);
+
+  const isPickerOpen = ref(false);
+  const isPickerLoading = ref(false);
+  const pickerKeyword = ref('');
+  const pickerRows = ref<ProductPickerItemDto[]>([]);
+  const pickerSelectedId = ref('');
+
+  const recordFilterForm = reactive(createDefaultPointMallRecordFilterForm());
+  const recordPager = ref(createDefaultPointMallRecordPager());
+  const recordStats = ref(createDefaultPointMallRecordStats());
+  const isRecordLoading = ref(false);
+  const isExporting = ref(false);
+
+  const selectedRecordId = ref('');
+  const detailRecord = ref<null | PointMallRecordDetailViewModel>(null);
+  const isDetailOpen = ref(false);
+  const isDetailLoading = ref(false);
+  const verifyForm = reactive(createDefaultPointMallVerifyForm());
+  const isVerifyOpen = ref(false);
+  const isVerifyLoading = ref(false);
+  const isVerifySubmitting = ref(false);
+
+  const accessCodeSet = computed(
+    () => new Set((accessStore.accessCodes ?? []).map(String)),
+  );
+  const canManage = computed(() =>
+    accessCodeSet.value.has(MEMBER_POINTS_MALL_MANAGE_PERMISSION),
+  );
+  const canView = computed(
+    () =>
+      canManage.value ||
+      accessCodeSet.value.has(MEMBER_POINTS_MALL_VIEW_PERMISSION),
+  );
+
+  const hasStore = computed(() => stores.value.length > 0);
+  const storeOptions = computed(() =>
+    stores.value.map((item) => ({
+      label: item.name,
+      value: item.id,
+    })),
+  );
+
+  const drawerTitle = computed(() =>
+    drawerMode.value === 'create' ? '添加兑换商品' : '编辑兑换商品',
+  );
+  const drawerSubmitText = computed(() => '保存');
+
+  const { loadStores, loadRuleDetail, loadProductList, loadRecordList } =
+    createDataActions({
+      stores,
+      selectedStoreId,
+      isStoreLoading,
+      ruleForm,
+      ruleStats,
+      isRuleLoading,
+      productFilterForm,
+      productRows,
+      isProductLoading,
+      recordFilterForm,
+      recordPager,
+      recordStats,
+      isRecordLoading,
+    });
+
+  const {
+    loadPickerProducts,
+    openPicker,
+    setPickerKeyword,
+    setPickerOpen,
+    setPickerSelectedId,
+    submitPicker,
+  } = createPickerActions({
+    isPickerOpen,
+    isPickerLoading,
+    pickerKeyword,
+    pickerRows,
+    pickerSelectedId,
+    selectedStoreId,
+    onPicked(item) {
+      if (!item) {
+        return;
+      }
+      productForm.productId = item.id;
+      productForm.productName = item.name;
+      if (!productForm.name.trim()) {
+        productForm.name = item.name;
+      }
+    },
+  });
+
+  const {
+    loadCouponOptions,
+    openCreateDrawer,
+    openEditDrawer,
+    openProductPicker,
+    setDrawerOpen,
+    setFormCashAmount,
+    setFormCouponTemplateId,
+    setFormDescription,
+    setFormExchangeType,
+    setFormImageUrl,
+    setFormName,
+    setFormPerMemberLimit,
+    setFormPhysicalName,
+    setFormPickupMethod,
+    setFormRedeemType,
+    setFormRequiredPoints,
+    setFormStatus,
+    setFormStockTotal,
+    submitDrawer,
+    toggleNotifyChannel,
+  } = createDrawerActions({
+    canManage,
+    drawerMode,
+    form: productForm,
+    isDrawerLoading,
+    isDrawerOpen,
+    isDrawerSubmitting,
+    selectedStoreId,
+    couponOptions,
+    loadProductList,
+    openPicker,
+  });
+
+  const { removeProduct, toggleStatus } = createProductActions({
+    canManage,
+    selectedStoreId,
+    loadProductList,
+  });
+
+  const {
+    openDetailDrawer,
+    openVerifyDrawer,
+    setDetailOpen,
+    setVerifyMethod,
+    setVerifyOpen,
+    setVerifyRemark,
+    submitVerify,
+  } = createRecordActions({
+    canManage,
+    selectedStoreId,
+    selectedRecordId,
+    detailRecord,
+    isDetailLoading,
+    isDetailOpen,
+    verifyForm,
+    isVerifyLoading,
+    isVerifyOpen,
+    isVerifySubmitting,
+    loadRecordList,
+  });
+
+  function setSelectedStoreId(value: string) {
+    selectedStoreId.value = value;
+  }
+
+  function setActiveTab(value: PointMallTabKey) {
+    activeTab.value = value;
+  }
+
+  function setRuleConsumeRewardEnabled(value: boolean) {
+    ruleForm.isConsumeRewardEnabled = value;
+  }
+
+  function setRuleConsumeAmountPerStep(value: null | number) {
+    ruleForm.consumeAmountPerStep = value;
+  }
+
+  function setRuleConsumeRewardPointsPerStep(value: null | number) {
+    ruleForm.consumeRewardPointsPerStep = value;
+  }
+
+  function setRuleReviewRewardEnabled(value: boolean) {
+    ruleForm.isReviewRewardEnabled = value;
+  }
+
+  function setRuleReviewRewardPoints(value: null | number) {
+    ruleForm.reviewRewardPoints = value;
+  }
+
+  function setRuleRegisterRewardEnabled(value: boolean) {
+    ruleForm.isRegisterRewardEnabled = value;
+  }
+
+  function setRuleRegisterRewardPoints(value: null | number) {
+    ruleForm.registerRewardPoints = value;
+  }
+
+  function setRuleSigninRewardEnabled(value: boolean) {
+    ruleForm.isSigninRewardEnabled = value;
+  }
+
+  function setRuleSigninRewardPoints(value: null | number) {
+    ruleForm.signinRewardPoints = value;
+  }
+
+  function setRuleExpiryMode(value: 'permanent' | 'yearly_clear') {
+    ruleForm.expiryMode = value;
+  }
+
+  function validateRuleForm() {
+    if (
+      ruleForm.isConsumeRewardEnabled &&
+      (!ruleForm.consumeAmountPerStep || ruleForm.consumeAmountPerStep <= 0)
+    ) {
+      message.warning('消费获取规则中“每消费金额”必须大于 0');
+      return false;
+    }
+
+    if (
+      ruleForm.isConsumeRewardEnabled &&
+      (!ruleForm.consumeRewardPointsPerStep ||
+        ruleForm.consumeRewardPointsPerStep <= 0)
+    ) {
+      message.warning('消费获取规则中“每步积分”必须大于 0');
+      return false;
+    }
+
+    if (
+      ruleForm.isReviewRewardEnabled &&
+      (!ruleForm.reviewRewardPoints || ruleForm.reviewRewardPoints <= 0)
+    ) {
+      message.warning('评价奖励积分必须大于 0');
+      return false;
+    }
+
+    if (
+      ruleForm.isRegisterRewardEnabled &&
+      (!ruleForm.registerRewardPoints || ruleForm.registerRewardPoints <= 0)
+    ) {
+      message.warning('注册奖励积分必须大于 0');
+      return false;
+    }
+
+    if (
+      ruleForm.isSigninRewardEnabled &&
+      (!ruleForm.signinRewardPoints || ruleForm.signinRewardPoints <= 0)
+    ) {
+      message.warning('签到奖励积分必须大于 0');
+      return false;
+    }
+
+    return true;
+  }
+
+  async function saveRule() {
+    if (!canManage.value) {
+      return;
+    }
+
+    if (!selectedStoreId.value) {
+      message.warning('请先选择门店');
+      return;
+    }
+
+    if (!validateRuleForm()) {
+      return;
+    }
+
+    isRuleSubmitting.value = true;
+    try {
+      await saveMemberPointMallRuleApi(
+        mapRuleFormToSavePayload(ruleForm, selectedStoreId.value),
+      );
+      message.success('规则已保存');
+      await loadRuleDetail();
+    } catch (error) {
+      console.error(error);
+      message.error('保存规则失败');
+    } finally {
+      isRuleSubmitting.value = false;
+    }
+  }
+
+  function setProductKeyword(value: string) {
+    productFilterForm.keyword = value;
+  }
+
+  function setProductStatusFilter(value: '' | 'disabled' | 'enabled') {
+    productFilterForm.status = value;
+  }
+
+  async function applyProductFilters() {
+    await loadProductList();
+  }
+
+  async function resetProductFilters() {
+    productFilterForm.status = '';
+    productFilterForm.keyword = '';
+    await loadProductList();
+  }
+
+  function setRecordRedeemType(value: '' | 'coupon' | 'physical' | 'product') {
+    recordFilterForm.redeemType = value;
+  }
+
+  function setRecordStatus(
+    value: '' | 'canceled' | 'completed' | 'issued' | 'pending_pickup',
+  ) {
+    recordFilterForm.status = value;
+  }
+
+  function setRecordKeyword(value: string) {
+    recordFilterForm.keyword = value;
+  }
+
+  function setRecordDateRange(value: [Dayjs, Dayjs] | null) {
+    recordFilterForm.dateRange = value ?? null;
+  }
+
+  async function applyRecordFilters() {
+    recordPager.value = {
+      ...recordPager.value,
+      page: 1,
+    };
+    await loadRecordList();
+  }
+
+  async function resetRecordFilters() {
+    recordFilterForm.redeemType = '';
+    recordFilterForm.status = '';
+    recordFilterForm.keyword = '';
+    recordFilterForm.dateRange = null;
+    recordPager.value = {
+      ...recordPager.value,
+      page: 1,
+    };
+    await loadRecordList();
+  }
+
+  async function handleRecordPageChange(page: number, pageSize: number) {
+    recordPager.value = {
+      ...recordPager.value,
+      page,
+      pageSize,
+    };
+    await loadRecordList();
+  }
+
+  async function exportRecords() {
+    if (!selectedStoreId.value) {
+      message.warning('请先选择门店');
+      return;
+    }
+
+    isExporting.value = true;
+    try {
+      const query = mapRecordFilterToQuery(recordFilterForm);
+      const result = await exportMemberPointMallRecordApi({
+        storeId: selectedStoreId.value,
+        ...query,
+      });
+      downloadBase64File(result.fileName, result.fileContentBase64);
+      message.success(`导出成功，共 ${result.totalCount} 条`);
+    } catch (error) {
+      console.error(error);
+      message.error('导出失败');
+    } finally {
+      isExporting.value = false;
+    }
+  }
+
+  function openEditProduct(item: PointMallProductCardViewModel) {
+    void openEditDrawer(item);
+  }
+
+  function openCreateProduct() {
+    void openCreateDrawer();
+  }
+
+  function openProductPickerDrawer() {
+    void openProductPicker();
+  }
+
+  function onPickedProductSelected(id: string) {
+    setPickerSelectedId(id);
+  }
+
+  function submitProductPicker() {
+    submitPicker();
+  }
+
+  function searchPickerProducts() {
+    void loadPickerProducts();
+  }
+
+  function searchCouponOptions(keyword: string) {
+    void loadCouponOptions(keyword);
+  }
+
+  watch(selectedStoreId, async () => {
+    recordPager.value = {
+      ...recordPager.value,
+      page: 1,
+      pageSize: 10,
+    };
+    await Promise.all([loadRuleDetail(), loadProductList(), loadRecordList()]);
+    await loadCouponOptions();
+  });
+
+  onMounted(async () => {
+    await loadStores();
+    if (selectedStoreId.value) {
+      await Promise.all([
+        loadRuleDetail(),
+        loadProductList(),
+        loadRecordList(),
+      ]);
+      await loadCouponOptions();
+    } else {
+      resetRuleForm(ruleForm);
+    }
+  });
+
+  return {
+    activeTab,
+    applyProductFilters,
+    applyRecordFilters,
+    canManage,
+    canView,
+    couponOptions,
+    detailRecord,
+    drawerSubmitText,
+    drawerTitle,
+    exportRecords,
+    hasStore,
+    handleRecordPageChange,
+    isDetailLoading,
+    isDetailOpen,
+    isDrawerLoading,
+    isDrawerOpen,
+    isDrawerSubmitting,
+    isExporting,
+    isPickerLoading,
+    isPickerOpen,
+    isProductLoading,
+    isRecordLoading,
+    isRuleLoading,
+    isRuleSubmitting,
+    isStoreLoading,
+    isVerifyLoading,
+    isVerifyOpen,
+    isVerifySubmitting,
+    openCreateProduct,
+    openDetailDrawer,
+    openEditProduct,
+    openProductPickerDrawer,
+    openVerifyDrawer,
+    pickerKeyword,
+    pickerRows,
+    pickerSelectedId,
+    productFilterForm,
+    productForm,
+    productRows,
+    recordFilterForm,
+    recordPager,
+    recordStats,
+    removeProduct,
+    resetProductFilters,
+    resetRecordFilters,
+    ruleForm,
+    ruleStats,
+    saveRule,
+    selectedStoreId,
+    setActiveTab,
+    setDetailOpen,
+    setDrawerOpen,
+    setFormCashAmount,
+    setFormCouponTemplateId,
+    setFormDescription,
+    setFormExchangeType,
+    setFormImageUrl,
+    setFormName,
+    setFormPerMemberLimit,
+    setFormPhysicalName,
+    setFormPickupMethod,
+    setFormRedeemType,
+    setFormRequiredPoints,
+    setFormStatus,
+    setFormStockTotal,
+    setPickedProductId: onPickedProductSelected,
+    setPickerKeyword,
+    setPickerOpen,
+    setProductKeyword,
+    setProductStatusFilter,
+    setRecordDateRange,
+    setRecordKeyword,
+    setRecordRedeemType,
+    setRecordStatus,
+    setRuleConsumeAmountPerStep,
+    setRuleConsumeRewardEnabled,
+    setRuleConsumeRewardPointsPerStep,
+    setRuleExpiryMode,
+    setRuleRegisterRewardEnabled,
+    setRuleRegisterRewardPoints,
+    setRuleReviewRewardEnabled,
+    setRuleReviewRewardPoints,
+    setRuleSigninRewardEnabled,
+    setRuleSigninRewardPoints,
+    setSelectedStoreId,
+    searchCouponOptions,
+    searchPickerProducts,
+    setVerifyMethod,
+    setVerifyOpen,
+    setVerifyRemark,
+    storeOptions,
+    submitDrawer,
+    submitProductPicker,
+    submitVerify,
+    tabOptions: POINTS_MALL_TAB_OPTIONS,
+    toggleNotifyChannel,
+    toggleStatus,
+    verifyForm,
+  };
+}

apps/web-antd/src/views/member/points-mall/index.vue

@@ -0,0 +1,309 @@
+<script setup lang="ts">
+import { Page } from '@vben/common-ui';
+
+import { Empty, Select, Spin } from 'ant-design-vue';
+
+import PointsMallProductCard from './components/PointsMallProductCard.vue';
+import PointsMallProductEditorDrawer from './components/PointsMallProductEditorDrawer.vue';
+import PointsMallProductPickerModal from './components/PointsMallProductPickerModal.vue';
+import PointsMallProductToolbar from './components/PointsMallProductToolbar.vue';
+import PointsMallRecordDetailDrawer from './components/PointsMallRecordDetailDrawer.vue';
+import PointsMallRecordStatsCards from './components/PointsMallRecordStatsCards.vue';
+import PointsMallRecordTable from './components/PointsMallRecordTable.vue';
+import PointsMallRecordToolbar from './components/PointsMallRecordToolbar.vue';
+import PointsMallRulePanel from './components/PointsMallRulePanel.vue';
+import PointsMallRuleStatsCards from './components/PointsMallRuleStatsCards.vue';
+import PointsMallVerifyDrawer from './components/PointsMallVerifyDrawer.vue';
+import { useMemberPointsMallPage } from './composables/useMemberPointsMallPage';
+
+const {
+  activeTab,
+  applyProductFilters,
+  applyRecordFilters,
+  canManage,
+  canView,
+  couponOptions,
+  detailRecord,
+  drawerSubmitText,
+  drawerTitle,
+  exportRecords,
+  hasStore,
+  handleRecordPageChange,
+  isDetailLoading,
+  isDetailOpen,
+  isDrawerLoading,
+  isDrawerOpen,
+  isDrawerSubmitting,
+  isExporting,
+  isPickerLoading,
+  isPickerOpen,
+  isProductLoading,
+  isRecordLoading,
+  isRuleLoading,
+  isRuleSubmitting,
+  isStoreLoading,
+  isVerifyLoading,
+  isVerifyOpen,
+  isVerifySubmitting,
+  openCreateProduct,
+  openDetailDrawer,
+  openEditProduct,
+  openProductPickerDrawer,
+  openVerifyDrawer,
+  pickerKeyword,
+  pickerRows,
+  pickerSelectedId,
+  productFilterForm,
+  productForm,
+  productRows,
+  recordFilterForm,
+  recordPager,
+  recordStats,
+  removeProduct,
+  resetProductFilters,
+  resetRecordFilters,
+  ruleForm,
+  ruleStats,
+  saveRule,
+  selectedStoreId,
+  setActiveTab,
+  setDetailOpen,
+  setDrawerOpen,
+  setFormCashAmount,
+  setFormCouponTemplateId,
+  setFormDescription,
+  setFormExchangeType,
+  setFormImageUrl,
+  setFormName,
+  setFormPerMemberLimit,
+  setFormPhysicalName,
+  setFormPickupMethod,
+  setFormRedeemType,
+  setFormRequiredPoints,
+  setFormStatus,
+  setFormStockTotal,
+  setPickedProductId,
+  setPickerKeyword,
+  setPickerOpen,
+  setProductKeyword,
+  setProductStatusFilter,
+  setRecordKeyword,
+  setRecordRedeemType,
+  setRecordStatus,
+  setRuleConsumeAmountPerStep,
+  setRuleConsumeRewardEnabled,
+  setRuleConsumeRewardPointsPerStep,
+  setRuleExpiryMode,
+  setRuleRegisterRewardEnabled,
+  setRuleRegisterRewardPoints,
+  setRuleReviewRewardEnabled,
+  setRuleReviewRewardPoints,
+  setRuleSigninRewardEnabled,
+  setRuleSigninRewardPoints,
+  setSelectedStoreId,
+  setVerifyMethod,
+  setVerifyOpen,
+  setVerifyRemark,
+  searchCouponOptions,
+  searchPickerProducts,
+  storeOptions,
+  submitDrawer,
+  submitProductPicker,
+  submitVerify,
+  tabOptions,
+  toggleNotifyChannel,
+  toggleStatus,
+  verifyForm,
+} = useMemberPointsMallPage();
+</script>
+
+<template>
+  <Page title="积分商城" content-class="page-member-points-mall">
+    <div class="mpm-page">
+      <div class="mpm-toolbar mpm-toolbar-top">
+        <Select
+          class="mpm-store-select"
+          :value="selectedStoreId"
+          :options="storeOptions"
+          :loading="isStoreLoading"
+          placeholder="请选择门店"
+          @update:value="(value) => setSelectedStoreId(String(value ?? ''))"
+        />
+
+        <div class="mpm-segments">
+          <button
+            v-for="item in tabOptions"
+            :key="item.value"
+            type="button"
+            class="mpm-segment-item"
+            :class="{ active: activeTab === item.value }"
+            @click="setActiveTab(item.value)"
+          >
+            {{ item.label }}
+          </button>
+        </div>
+
+        <span v-if="canView && !canManage" class="mpm-readonly-tip">
+          当前为只读权限
+        </span>
+      </div>
+
+      <Empty v-if="!canView" description="暂无积分商城页面访问权限" />
+
+      <div v-else-if="!hasStore" class="mpm-empty">
+        <Empty description="暂无门店，请先创建门店" />
+      </div>
+
+      <template v-else>
+        <section v-show="activeTab === 'rules'" class="mpm-tab-panel">
+          <Spin :spinning="isRuleLoading">
+            <PointsMallRuleStatsCards :stats="ruleStats" />
+            <PointsMallRulePanel
+              :form="ruleForm"
+              :can-manage="canManage"
+              :loading="isRuleLoading"
+              :submitting="isRuleSubmitting"
+              @set-consume-reward-enabled="setRuleConsumeRewardEnabled"
+              @set-consume-amount-per-step="setRuleConsumeAmountPerStep"
+              @set-consume-reward-points-per-step="
+                setRuleConsumeRewardPointsPerStep
+              "
+              @set-review-reward-enabled="setRuleReviewRewardEnabled"
+              @set-review-reward-points="setRuleReviewRewardPoints"
+              @set-register-reward-enabled="setRuleRegisterRewardEnabled"
+              @set-register-reward-points="setRuleRegisterRewardPoints"
+              @set-signin-reward-enabled="setRuleSigninRewardEnabled"
+              @set-signin-reward-points="setRuleSigninRewardPoints"
+              @set-expiry-mode="setRuleExpiryMode"
+              @save="saveRule"
+            />
+          </Spin>
+        </section>
+
+        <section v-show="activeTab === 'products'" class="mpm-tab-panel">
+          <PointsMallProductToolbar
+            :filters="productFilterForm"
+            :can-manage="canManage"
+            :loading="isProductLoading"
+            @set-status="setProductStatusFilter"
+            @set-keyword="setProductKeyword"
+            @search="applyProductFilters"
+            @reset="resetProductFilters"
+            @create="openCreateProduct"
+          />
+
+          <Spin :spinning="isProductLoading">
+            <div v-if="productRows.length > 0" class="mpm-product-grid">
+              <PointsMallProductCard
+                v-for="item in productRows"
+                :key="item.pointMallProductId"
+                :item="item"
+                :can-manage="canManage"
+                @edit="openEditProduct"
+                @toggle-status="toggleStatus"
+                @remove="removeProduct"
+              />
+            </div>
+            <div v-else class="mpm-empty">
+              <Empty description="暂无兑换商品" />
+            </div>
+          </Spin>
+        </section>
+
+        <section v-show="activeTab === 'records'" class="mpm-tab-panel">
+          <PointsMallRecordToolbar
+            :filters="recordFilterForm"
+            :can-manage="canManage"
+            :loading="isRecordLoading"
+            :exporting="isExporting"
+            @set-redeem-type="setRecordRedeemType"
+            @set-status="setRecordStatus"
+            @set-keyword="setRecordKeyword"
+            @search="applyRecordFilters"
+            @reset="resetRecordFilters"
+            @export="exportRecords"
+          />
+
+          <PointsMallRecordStatsCards :stats="recordStats" />
+
+          <div class="mpm-table-panel">
+            <PointsMallRecordTable
+              :can-manage="canManage"
+              :loading="isRecordLoading"
+              :pager="recordPager"
+              @page-change="handleRecordPageChange"
+              @verify="openVerifyDrawer"
+              @detail="openDetailDrawer"
+            />
+          </div>
+        </section>
+      </template>
+    </div>
+
+    <PointsMallProductEditorDrawer
+      :open="isDrawerOpen"
+      :title="drawerTitle"
+      :submit-text="drawerSubmitText"
+      :submitting="isDrawerSubmitting"
+      :loading="isDrawerLoading"
+      :can-manage="canManage"
+      :form="productForm"
+      :coupon-options="couponOptions"
+      @close="setDrawerOpen(false)"
+      @set-name="setFormName"
+      @set-image-url="setFormImageUrl"
+      @set-redeem-type="setFormRedeemType"
+      @set-coupon-template-id="setFormCouponTemplateId"
+      @set-physical-name="setFormPhysicalName"
+      @set-pickup-method="setFormPickupMethod"
+      @set-description="setFormDescription"
+      @set-exchange-type="setFormExchangeType"
+      @set-required-points="setFormRequiredPoints"
+      @set-cash-amount="setFormCashAmount"
+      @set-stock-total="setFormStockTotal"
+      @set-per-member-limit="setFormPerMemberLimit"
+      @set-status="setFormStatus"
+      @toggle-notify-channel="toggleNotifyChannel"
+      @submit="submitDrawer"
+      @open-product-picker="openProductPickerDrawer"
+      @search-coupon="searchCouponOptions"
+    />
+
+    <PointsMallProductPickerModal
+      :open="isPickerOpen"
+      :loading="isPickerLoading"
+      :keyword="pickerKeyword"
+      :rows="pickerRows"
+      :selected-id="pickerSelectedId"
+      @close="setPickerOpen(false)"
+      @set-keyword="setPickerKeyword"
+      @search="searchPickerProducts"
+      @select="setPickedProductId"
+      @submit="submitProductPicker"
+    />
+
+    <PointsMallVerifyDrawer
+      :open="isVerifyOpen"
+      :loading="isVerifyLoading"
+      :submitting="isVerifySubmitting"
+      :can-manage="canManage"
+      :record="detailRecord"
+      :form="verifyForm"
+      @close="setVerifyOpen(false)"
+      @set-verify-method="setVerifyMethod"
+      @set-verify-remark="setVerifyRemark"
+      @submit="submitVerify"
+    />
+
+    <PointsMallRecordDetailDrawer
+      :open="isDetailOpen"
+      :loading="isDetailLoading"
+      :record="detailRecord"
+      @close="setDetailOpen(false)"
+    />
+  </Page>
+</template>
+
+<style lang="less">
+@import './styles/index.less';
+</style>

apps/web-antd/src/views/member/points-mall/styles/base.less

@@ -0,0 +1,140 @@
+.page-member-points-mall {
+  --mpm-transition: 220ms cubic-bezier(0.4, 0, 0.2, 1);
+  --mpm-shadow-sm: 0 1px 2px rgb(0 0 0 / 4%);
+  --mpm-shadow-md: 0 8px 22px rgb(0 0 0 / 10%), 0 2px 6px rgb(0 0 0 / 8%);
+  --mpm-border: #e7eaf0;
+  --mpm-text: #1f2937;
+  --mpm-subtext: #6b7280;
+  --mpm-muted: #9ca3af;
+  --mpm-bg: #fff;
+
+  .g-action {
+    padding: 0;
+    font-size: 13px;
+    color: #1677ff;
+    cursor: pointer;
+    background: none;
+    border: none;
+  }
+
+  .g-action + .g-action {
+    margin-left: 12px;
+  }
+
+  .g-action-danger {
+    color: #ef4444;
+  }
+
+  .g-btn {
+    display: inline-flex;
+    gap: 6px;
+    align-items: center;
+    justify-content: center;
+    height: 34px;
+    padding: 0 14px;
+    font-size: 13px;
+    color: #374151;
+    cursor: pointer;
+    background: #fff;
+    border: 1px solid #d1d5db;
+    border-radius: 8px;
+    transition: all var(--mpm-transition);
+  }
+
+  .g-btn:hover {
+    color: #1677ff;
+    border-color: #1677ff;
+  }
+
+  .g-btn-primary {
+    color: #fff;
+    background: #1677ff;
+    border-color: #1677ff;
+  }
+
+  .g-btn-primary:hover {
+    color: #fff;
+    background: #4096ff;
+    border-color: #4096ff;
+  }
+
+  .g-btn-sm {
+    height: 30px;
+    padding: 0 12px;
+  }
+
+  .mpm-pill {
+    height: 34px;
+    padding: 0 14px;
+    font-size: 13px;
+    color: #4b5563;
+    cursor: pointer;
+    background: #fff;
+    border: 1px solid #d1d5db;
+    border-radius: 8px;
+    transition: all var(--mpm-transition);
+  }
+
+  .mpm-pill.checked {
+    color: #1677ff;
+    background: #e6f4ff;
+    border-color: #1677ff;
+  }
+
+  .mpm-pill:disabled {
+    cursor: not-allowed;
+    opacity: 0.6;
+  }
+
+  .mpm-pill-row {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 10px;
+  }
+
+  .mpm-form-hint {
+    margin-top: 6px;
+    font-size: 12px;
+    color: var(--mpm-muted);
+  }
+
+  .mpm-inline-fields {
+    display: inline-flex;
+    gap: 8px;
+    align-items: center;
+  }
+
+  .mpm-inline-fields .ant-input-number {
+    width: 140px;
+  }
+
+  .mpm-type-tag {
+    display: inline-flex;
+    align-items: center;
+    height: 22px;
+    padding: 0 8px;
+    font-size: 12px;
+    border-radius: 6px;
+  }
+
+  .mpm-type-tag.is-blue {
+    color: #1677ff;
+    background: #e6f4ff;
+  }
+
+  .mpm-type-tag.is-green {
+    color: #16a34a;
+    background: #dcfce7;
+  }
+
+  .mpm-type-tag.is-orange {
+    color: #d97706;
+    background: #fef3c7;
+  }
+
+  .mpm-drawer-footer {
+    display: flex;
+    gap: 8px;
+    justify-content: flex-end;
+  }
+}

apps/web-antd/src/views/member/points-mall/styles/drawer.less

@@ -0,0 +1,13 @@
+.page-member-points-mall {
+  .mpm-editor-drawer,
+  .mpm-verify-drawer,
+  .mpm-detail-drawer {
+    .ant-drawer-body {
+      padding: 16px 20px;
+    }
+
+    .ant-drawer-footer {
+      padding: 10px 16px;
+    }
+  }
+}

apps/web-antd/src/views/member/points-mall/styles/index.less

@@ -0,0 +1,8 @@
+@import './base.less';
+@import './layout.less';
+@import './rules.less';
+@import './products.less';
+@import './records.less';
+@import './drawer.less';
+@import './modal.less';
+@import './responsive.less';

apps/web-antd/src/views/member/points-mall/styles/layout.less

@@ -0,0 +1,154 @@
+.page-member-points-mall {
+  .mpm-page {
+    display: flex;
+    flex-direction: column;
+    gap: 16px;
+  }
+
+  .mpm-tab-panel {
+    display: flex;
+    flex-direction: column;
+    gap: 14px;
+  }
+
+  .mpm-toolbar {
+    display: flex;
+    gap: 10px;
+    align-items: center;
+    padding: 12px 14px;
+    background: var(--mpm-bg);
+    border: 1px solid var(--mpm-border);
+    border-radius: 10px;
+    box-shadow: var(--mpm-shadow-sm);
+  }
+
+  .mpm-toolbar-top {
+    gap: 12px;
+  }
+
+  .mpm-store-select {
+    width: 220px;
+  }
+
+  .mpm-filter-select {
+    width: 140px;
+  }
+
+  .mpm-search-input {
+    width: 220px;
+  }
+
+  .mpm-spacer {
+    flex: 1;
+  }
+
+  .mpm-readonly-tip {
+    margin-left: auto;
+    font-size: 12px;
+    color: #a1a1aa;
+  }
+
+  .mpm-segments {
+    display: inline-flex;
+    overflow: hidden;
+    background: #f5f5f5;
+    border: 1px solid #e7e7e7;
+    border-radius: 9px;
+  }
+
+  .mpm-segment-item {
+    min-width: 108px;
+    height: 34px;
+    padding: 0 16px;
+    font-size: 13px;
+    color: #4b5563;
+    cursor: pointer;
+    background: transparent;
+    border: 0;
+    transition: all var(--mpm-transition);
+  }
+
+  .mpm-segment-item.active {
+    font-weight: 600;
+    color: #1677ff;
+    background: #fff;
+    box-shadow: 0 1px 4px rgb(0 0 0 / 8%);
+  }
+
+  .mpm-stats {
+    display: grid;
+    grid-template-columns: repeat(4, minmax(0, 1fr));
+    gap: 12px;
+  }
+
+  .mpm-record-stats {
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+  }
+
+  .mpm-stat-card {
+    display: flex;
+    flex-direction: column;
+    justify-content: center;
+    min-height: 98px;
+    padding: 16px;
+    background: #fff;
+    border: 1px solid var(--mpm-border);
+    border-radius: 10px;
+    box-shadow: var(--mpm-shadow-sm);
+    transition: box-shadow var(--mpm-transition);
+  }
+
+  .mpm-stat-card:hover {
+    box-shadow: var(--mpm-shadow-md);
+  }
+
+  .mpm-stat-label {
+    font-size: 13px;
+    color: var(--mpm-muted);
+  }
+
+  .mpm-stat-value {
+    margin-top: 8px;
+    font-size: 24px;
+    font-weight: 700;
+    line-height: 1.1;
+    color: var(--mpm-text);
+  }
+
+  .mpm-stat-value.is-primary {
+    color: #1677ff;
+  }
+
+  .mpm-stat-value.is-green {
+    color: #16a34a;
+  }
+
+  .mpm-stat-value.is-orange {
+    color: #d97706;
+  }
+
+  .mpm-card {
+    border: 1px solid var(--mpm-border);
+    box-shadow: var(--mpm-shadow-sm);
+  }
+
+  .mpm-section-title {
+    padding-left: 10px;
+    margin-bottom: 12px;
+    font-size: 15px;
+    font-weight: 600;
+    color: var(--mpm-text);
+    border-left: 3px solid #1677ff;
+  }
+
+  .mpm-empty {
+    padding: 28px 14px;
+    font-size: 13px;
+    color: #9ca3af;
+    text-align: center;
+    background: #fff;
+    border: 1px solid var(--mpm-border);
+    border-radius: 10px;
+    box-shadow: var(--mpm-shadow-sm);
+  }
+}

apps/web-antd/src/views/member/points-mall/styles/modal.less

@@ -0,0 +1,77 @@
+.page-member-points-mall {
+  .mpm-picker-toolbar {
+    display: flex;
+    gap: 10px;
+    align-items: center;
+    margin-bottom: 12px;
+  }
+
+  .mpm-picker-empty {
+    padding: 32px 12px;
+    border: 1px dashed #e5e7eb;
+    border-radius: 10px;
+  }
+
+  .mpm-picker-table-wrap {
+    max-height: 420px;
+    overflow: auto;
+    border: 1px solid #e5e7eb;
+    border-radius: 10px;
+  }
+
+  .mpm-picker-table {
+    width: 100%;
+    min-width: 680px;
+    border-collapse: collapse;
+  }
+
+  .mpm-picker-table th,
+  .mpm-picker-table td {
+    padding: 10px 12px;
+    font-size: 13px;
+    color: #334155;
+    text-align: left;
+    white-space: nowrap;
+    border-bottom: 1px solid #f1f5f9;
+  }
+
+  .mpm-picker-table th {
+    position: sticky;
+    top: 0;
+    z-index: 1;
+    font-size: 12px;
+    color: #64748b;
+    background: #f8fafc;
+  }
+
+  .mpm-picker-table tr {
+    cursor: pointer;
+  }
+
+  .mpm-picker-table tr.checked {
+    background: #eff6ff;
+  }
+
+  .mpm-picker-table .name {
+    font-size: 13px;
+    color: #111827;
+  }
+
+  .mpm-picker-table .spu {
+    margin-top: 2px;
+    font-size: 12px;
+    color: #9ca3af;
+  }
+
+  .mpm-picker-table .col-radio {
+    width: 52px;
+  }
+
+  .mpm-picker-table .col-price {
+    width: 120px;
+  }
+
+  .mpm-picker-table .col-status {
+    width: 120px;
+  }
+}

apps/web-antd/src/views/member/points-mall/styles/products.less

@@ -0,0 +1,129 @@
+.page-member-points-mall {
+  .mpm-product-grid {
+    display: grid;
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+    gap: 16px;
+  }
+
+  .mpm-product-card {
+    overflow: hidden;
+    background: #fff;
+    border: 1px solid var(--mpm-border);
+    border-radius: 10px;
+    box-shadow: var(--mpm-shadow-sm);
+    transition: all var(--mpm-transition);
+  }
+
+  .mpm-product-card:hover {
+    box-shadow: var(--mpm-shadow-md);
+    transform: translateY(-1px);
+  }
+
+  .mpm-product-card.is-disabled {
+    opacity: 0.58;
+  }
+
+  .mpm-product-image {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    height: 140px;
+    color: #9ca3af;
+    background: #f3f4f6;
+  }
+
+  .mpm-product-image .iconify {
+    width: 32px;
+    height: 32px;
+  }
+
+  .mpm-product-image img {
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+  }
+
+  .mpm-product-body {
+    padding: 14px 16px;
+  }
+
+  .mpm-product-name {
+    display: flex;
+    gap: 6px;
+    align-items: center;
+    font-size: 14px;
+    font-weight: 600;
+    color: var(--mpm-text);
+  }
+
+  .mpm-product-price {
+    margin-top: 10px;
+    font-size: 20px;
+    font-weight: 700;
+    line-height: 1.1;
+    color: #1677ff;
+  }
+
+  .mpm-product-price .cash {
+    margin-left: 4px;
+    font-size: 13px;
+    font-weight: 500;
+    color: var(--mpm-subtext);
+  }
+
+  .mpm-product-meta {
+    display: flex;
+    gap: 12px;
+    margin-top: 8px;
+    font-size: 12px;
+    color: var(--mpm-muted);
+  }
+
+  .mpm-product-footer {
+    display: flex;
+    align-items: center;
+    padding-top: 10px;
+    margin-top: 10px;
+    border-top: 1px solid #f1f5f9;
+  }
+
+  .mpm-product-footer .ant-tag {
+    margin-left: auto;
+  }
+
+  .mpm-image-field {
+    display: flex;
+    gap: 12px;
+    align-items: center;
+  }
+
+  .mpm-image-preview {
+    width: 80px;
+    height: 80px;
+    object-fit: cover;
+    border: 1px solid #e5e7eb;
+    border-radius: 8px;
+  }
+
+  .mpm-selected-product {
+    padding: 10px 12px;
+    margin-bottom: 8px;
+    background: #f8fafc;
+    border: 1px solid #e5e7eb;
+    border-radius: 8px;
+  }
+
+  .mpm-selected-product .name {
+    display: block;
+    font-size: 13px;
+    font-weight: 600;
+    color: var(--mpm-text);
+  }
+
+  .mpm-selected-product .id {
+    display: block;
+    margin-top: 2px;
+    font-size: 12px;
+    color: var(--mpm-muted);
+  }
+}

apps/web-antd/src/views/member/points-mall/styles/records.less

@@ -0,0 +1,179 @@
+.page-member-points-mall {
+  .mpm-table-panel {
+    padding: 10px 12px;
+    background: #fff;
+    border: 1px solid var(--mpm-border);
+    border-radius: 12px;
+    box-shadow: var(--mpm-shadow-sm);
+  }
+
+  .mpm-record-table-wrap {
+    display: flex;
+    flex-direction: column;
+    gap: 12px;
+  }
+
+  .mpm-record-no {
+    font-family: ui-monospace, sfmono-regular, menlo, monospace;
+    font-size: 12px;
+    color: #334155;
+  }
+
+  .mpm-record-member {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+  }
+
+  .mpm-record-member .name {
+    font-size: 13px;
+    font-weight: 500;
+    color: var(--mpm-text);
+  }
+
+  .mpm-record-member .phone {
+    font-size: 12px;
+    color: var(--mpm-muted);
+  }
+
+  .mpm-record-points {
+    font-weight: 600;
+    color: #111827;
+  }
+
+  .mpm-record-status {
+    position: relative;
+    display: inline-flex;
+    gap: 6px;
+    align-items: center;
+    font-size: 12px;
+    color: #4b5563;
+  }
+
+  .mpm-record-status::before {
+    width: 6px;
+    height: 6px;
+    content: '';
+    background: #9ca3af;
+    border-radius: 999px;
+  }
+
+  .mpm-record-status.is-green::before {
+    background: #16a34a;
+  }
+
+  .mpm-record-status.is-orange::before {
+    background: #d97706;
+  }
+
+  .mpm-record-status.is-gray::before {
+    background: #9ca3af;
+  }
+
+  .mpm-record-status.is-red::before {
+    background: #ef4444;
+  }
+
+  .mpm-pagination {
+    display: flex;
+    justify-content: flex-end;
+  }
+
+  .mpm-verify-content {
+    display: flex;
+    flex-direction: column;
+    gap: 16px;
+  }
+
+  .mpm-verify-card {
+    padding: 14px;
+    background: #f8fafc;
+    border: 1px solid #e5e7eb;
+    border-radius: 10px;
+  }
+
+  .mpm-verify-product .name {
+    margin-bottom: 6px;
+    font-size: 15px;
+    font-weight: 600;
+    color: var(--mpm-text);
+  }
+
+  .mpm-verify-grid {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 8px;
+    margin-top: 12px;
+  }
+
+  .mpm-verify-grid .item {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+  }
+
+  .mpm-verify-grid .label {
+    font-size: 12px;
+    color: var(--mpm-muted);
+  }
+
+  .mpm-verify-grid .value {
+    font-size: 13px;
+    color: var(--mpm-text);
+  }
+
+  .mpm-verify-grid .value.mono {
+    font-family: ui-monospace, sfmono-regular, menlo, monospace;
+  }
+
+  .mpm-verify-grid .value.is-primary {
+    font-weight: 600;
+    color: #1677ff;
+  }
+
+  .mpm-detail-content {
+    display: flex;
+    flex-direction: column;
+    gap: 14px;
+  }
+
+  .mpm-detail-top .name {
+    margin-bottom: 6px;
+    font-size: 15px;
+    font-weight: 600;
+    color: var(--mpm-text);
+  }
+
+  .mpm-detail-grid {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 10px 14px;
+  }
+
+  .mpm-detail-grid .item {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+  }
+
+  .mpm-detail-grid .label {
+    font-size: 12px;
+    color: var(--mpm-muted);
+  }
+
+  .mpm-detail-grid .value {
+    font-size: 13px;
+    color: var(--mpm-text);
+  }
+
+  .mpm-detail-grid .value.mono {
+    font-family: ui-monospace, sfmono-regular, menlo, monospace;
+  }
+
+  .mpm-empty-tip {
+    padding: 20px 0;
+    font-size: 13px;
+    color: var(--mpm-muted);
+    text-align: center;
+  }
+}

apps/web-antd/src/views/member/points-mall/styles/responsive.less

@@ -0,0 +1,42 @@
+.page-member-points-mall {
+  @media (max-width: 1400px) {
+    .mpm-product-grid {
+      grid-template-columns: repeat(2, minmax(0, 1fr));
+    }
+  }
+
+  @media (max-width: 1024px) {
+    .mpm-toolbar {
+      flex-wrap: wrap;
+    }
+
+    .mpm-store-select,
+    .mpm-search-input {
+      width: 100%;
+    }
+
+    .mpm-stats,
+    .mpm-record-stats {
+      grid-template-columns: repeat(2, minmax(0, 1fr));
+    }
+
+    .mpm-product-grid {
+      grid-template-columns: repeat(1, minmax(0, 1fr));
+    }
+  }
+
+  @media (max-width: 768px) {
+    .mpm-rule-row {
+      flex-wrap: wrap;
+    }
+
+    .mpm-rule-label {
+      min-width: auto;
+    }
+
+    .mpm-verify-grid,
+    .mpm-detail-grid {
+      grid-template-columns: repeat(1, minmax(0, 1fr));
+    }
+  }
+}

apps/web-antd/src/views/member/points-mall/styles/rules.less

@@ -0,0 +1,40 @@
+.page-member-points-mall {
+  .mpm-rule-panel {
+    display: flex;
+    flex-direction: column;
+    gap: 14px;
+  }
+
+  .mpm-rule-row {
+    display: flex;
+    gap: 10px;
+    align-items: center;
+    padding: 14px 0;
+    border-bottom: 1px solid #f1f5f9;
+  }
+
+  .mpm-rule-row:last-child {
+    border-bottom: none;
+  }
+
+  .mpm-rule-label {
+    min-width: 96px;
+    font-size: 13px;
+    font-weight: 500;
+    color: var(--mpm-text);
+  }
+
+  .mpm-rule-text {
+    font-size: 13px;
+    color: var(--mpm-subtext);
+  }
+
+  .mpm-rule-input {
+    width: 86px;
+  }
+
+  .mpm-save-bar {
+    display: flex;
+    justify-content: flex-end;
+  }
+}

apps/web-antd/src/views/member/points-mall/types.ts

@@ -0,0 +1,191 @@
+import type { Dayjs } from 'dayjs';
+
+import type {
+  MemberPointMallExchangeType,
+  MemberPointMallExpiryMode,
+  MemberPointMallNotifyChannel,
+  MemberPointMallPickupMethod,
+  MemberPointMallProductDto,
+  MemberPointMallProductStatus,
+  MemberPointMallRecordDetailDto,
+  MemberPointMallRecordDto,
+  MemberPointMallRecordStatsDto,
+  MemberPointMallRecordStatus,
+  MemberPointMallRedeemType,
+  MemberPointMallRuleStatsDto,
+  MemberPointMallVerifyMethod,
+} from '#/api/member/points-mall';
+
+/** 页面主 Tab。 */
+export type PointMallTabKey = 'products' | 'records' | 'rules';
+
+/** 规则编辑表单。 */
+export interface PointMallRuleForm {
+  consumeAmountPerStep: null | number;
+  consumeRewardPointsPerStep: null | number;
+  expiryMode: MemberPointMallExpiryMode;
+  isConsumeRewardEnabled: boolean;
+  isRegisterRewardEnabled: boolean;
+  isReviewRewardEnabled: boolean;
+  isSigninRewardEnabled: boolean;
+  registerRewardPoints: null | number;
+  reviewRewardPoints: null | number;
+  signinRewardPoints: null | number;
+}
+
+/** 商品筛选表单。 */
+export interface PointMallProductFilterForm {
+  keyword: string;
+  status: '' | MemberPointMallProductStatus;
+}
+
+/** 商品编辑表单。 */
+export interface PointMallProductEditorForm {
+  cashAmount: null | number;
+  couponTemplateId: string;
+  couponTemplateName: string;
+  description: string;
+  exchangeType: MemberPointMallExchangeType;
+  imageUrl: string;
+  name: string;
+  notifyChannels: MemberPointMallNotifyChannel[];
+  perMemberLimit: null | number;
+  physicalName: string;
+  pickupMethod: MemberPointMallPickupMethod;
+  pointMallProductId: string;
+  productId: string;
+  productName: string;
+  redeemType: MemberPointMallRedeemType;
+  requiredPoints: null | number;
+  status: MemberPointMallProductStatus;
+  stockTotal: null | number;
+}
+
+/** 记录筛选表单。 */
+export interface PointMallRecordFilterForm {
+  dateRange: [Dayjs, Dayjs] | null;
+  keyword: string;
+  redeemType: '' | MemberPointMallRedeemType;
+  status: '' | MemberPointMallRecordStatus;
+}
+
+/** 记录分页状态。 */
+export interface PointMallRecordPager {
+  items: MemberPointMallRecordDto[];
+  page: number;
+  pageSize: number;
+  totalCount: number;
+}
+
+/** 核销表单。 */
+export interface PointMallVerifyForm {
+  verifyMethod: MemberPointMallVerifyMethod;
+  verifyRemark: string;
+}
+
+/** 商品卡片模型。 */
+export type PointMallProductCardViewModel = MemberPointMallProductDto;
+
+/** 规则统计模型。 */
+export type PointMallRuleStatsViewModel = MemberPointMallRuleStatsDto;
+
+/** 记录统计模型。 */
+export type PointMallRecordStatsViewModel = MemberPointMallRecordStatsDto;
+
+/** 记录详情模型。 */
+export type PointMallRecordDetailViewModel = MemberPointMallRecordDetailDto;
+
+/** 创建默认规则表单。 */
+export function createDefaultPointMallRuleForm(): PointMallRuleForm {
+  return {
+    isConsumeRewardEnabled: true,
+    consumeAmountPerStep: 1,
+    consumeRewardPointsPerStep: 1,
+    isReviewRewardEnabled: true,
+    reviewRewardPoints: 10,
+    isRegisterRewardEnabled: true,
+    registerRewardPoints: 100,
+    isSigninRewardEnabled: false,
+    signinRewardPoints: 5,
+    expiryMode: 'yearly_clear',
+  };
+}
+
+/** 创建默认商品筛选表单。 */
+export function createDefaultPointMallProductFilterForm(): PointMallProductFilterForm {
+  return {
+    status: '',
+    keyword: '',
+  };
+}
+
+/** 创建默认商品编辑表单。 */
+export function createDefaultPointMallProductEditorForm(): PointMallProductEditorForm {
+  return {
+    pointMallProductId: '',
+    redeemType: 'product',
+    productId: '',
+    productName: '',
+    couponTemplateId: '',
+    couponTemplateName: '',
+    physicalName: '',
+    pickupMethod: 'store_pickup',
+    name: '',
+    imageUrl: '',
+    exchangeType: 'points',
+    requiredPoints: null,
+    cashAmount: null,
+    stockTotal: null,
+    perMemberLimit: null,
+    description: '',
+    notifyChannels: ['in_app'],
+    status: 'enabled',
+  };
+}
+
+/** 创建默认记录筛选表单。 */
+export function createDefaultPointMallRecordFilterForm(): PointMallRecordFilterForm {
+  return {
+    redeemType: '',
+    status: '',
+    keyword: '',
+    dateRange: null,
+  };
+}
+
+/** 创建默认记录分页。 */
+export function createDefaultPointMallRecordPager(): PointMallRecordPager {
+  return {
+    items: [],
+    page: 1,
+    pageSize: 10,
+    totalCount: 0,
+  };
+}
+
+/** 创建默认规则统计。 */
+export function createDefaultPointMallRuleStats(): PointMallRuleStatsViewModel {
+  return {
+    totalIssuedPoints: 0,
+    redeemedPoints: 0,
+    pointMembers: 0,
+    redeemRate: 0,
+  };
+}
+
+/** 创建默认记录统计。 */
+export function createDefaultPointMallRecordStats(): PointMallRecordStatsViewModel {
+  return {
+    todayRedeemCount: 0,
+    pendingPhysicalCount: 0,
+    currentMonthUsedPoints: 0,
+  };
+}
+
+/** 创建默认核销表单。 */
+export function createDefaultPointMallVerifyForm(): PointMallVerifyForm {
+  return {
+    verifyMethod: 'manual',
+    verifyRemark: '',
+  };
+}

apps/web-antd/src/views/member/stored-card/composables/stored-card-page/helpers.ts

@@ -3,11 +3,12 @@ import type {
   SaveMemberStoredCardPlanPayload,
 } from '#/api/member/stored-card';
 import type {
-  createDefaultStoredCardPlanEditorForm,
   StoredCardPlanEditorForm,
-  type StoredCardRecordFilterForm,
+  StoredCardRecordFilterForm,
 } from '#/views/member/stored-card/types';
 
+import { createDefaultStoredCardPlanEditorForm } from '#/views/member/stored-card/types';
+
 /** 金额格式化。 */
 export function formatCurrency(value: null | number | undefined) {
   const amount = Number(value ?? 0);