Merge pull request #22 from msumshk/feature/finance-report-1to1

feat(@vben/web-antd): implement finance business report module

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

@@ -1,161 +1,8 @@
 /**
- * 文件职责：财务中心交易流水 API 契约与请求封装。
+ * 文件职责：财务中心 API 聚合导出。
  */
-import { requestClient } from '#/api/request';
+export * from './cost';
-
+export * from './invoice';
+export * from './report';
 export * from './settlement';
-
+export * from './transaction';
-/** 交易类型筛选值。 */
-export type FinanceTransactionTypeFilter =
-  | 'all'
-  | 'income'
-  | 'point_redeem'
-  | 'refund'
-  | 'stored_card_recharge';
-
-/** 交易渠道筛选值。 */
-export type FinanceTransactionChannelFilter =
-  | 'all'
-  | 'delivery'
-  | 'dine_in'
-  | 'pickup';
-
-/** 交易支付方式筛选值。 */
-export type FinanceTransactionPaymentFilter =
-  | 'alipay'
-  | 'all'
-  | 'balance'
-  | 'card'
-  | 'cash'
-  | 'wechat';
-
-/** 交易流水筛选参数。 */
-export interface FinanceTransactionFilterQuery {
-  channel?: FinanceTransactionChannelFilter;
-  endDate?: string;
-  keyword?: string;
-  paymentMethod?: FinanceTransactionPaymentFilter;
-  startDate?: string;
-  storeId: string;
-  type?: FinanceTransactionTypeFilter;
-}
-
-/** 交易流水列表查询参数。 */
-export interface FinanceTransactionListQuery extends FinanceTransactionFilterQuery {
-  page: number;
-  pageSize: number;
-}
-
-/** 交易流水列表行。 */
-export interface FinanceTransactionListItemDto {
-  amount: number;
-  channel: string;
-  isIncome: boolean;
-  occurredAt: string;
-  orderNo?: string;
-  paymentMethod: string;
-  remark: string;
-  transactionId: string;
-  transactionNo: string;
-  type: string;
-  typeText: string;
-}
-
-/** 交易流水列表结果。 */
-export interface FinanceTransactionListResultDto {
-  items: FinanceTransactionListItemDto[];
-  page: number;
-  pageIncomeAmount: number;
-  pageRefundAmount: number;
-  pageSize: number;
-  total: number;
-}
-
-/** 交易流水统计结果。 */
-export interface FinanceTransactionStatsDto {
-  totalCount: number;
-  totalIncome: number;
-  totalRefund: number;
-}
-
-/** 交易流水详情。 */
-export interface FinanceTransactionDetailDto {
-  amount: number;
-  arrivedAmount?: number;
-  channel: string;
-  customerName: string;
-  customerPhone: string;
-  giftAmount?: number;
-  memberMobileMasked?: string;
-  memberName?: string;
-  occurredAt: string;
-  orderNo?: string;
-  paymentMethod: string;
-  pointBalanceAfterChange?: number;
-  pointChangeAmount?: number;
-  rechargeAmount?: number;
-  refundNo?: string;
-  refundReason?: string;
-  remark: string;
-  storeId: string;
-  transactionId: string;
-  transactionNo: string;
-  type: string;
-  typeText: string;
-}
-
-/** 交易流水导出结果。 */
-export interface FinanceTransactionExportDto {
-  fileContentBase64: string;
-  fileName: string;
-  totalCount: number;
-}
-
-/** 查询交易流水列表。 */
-export async function getFinanceTransactionListApi(
-  params: FinanceTransactionListQuery,
-) {
-  return requestClient.get<FinanceTransactionListResultDto>(
-    '/finance/transaction/list',
-    {
-      params,
-    },
-  );
-}
-
-/** 查询交易流水统计。 */
-export async function getFinanceTransactionStatsApi(
-  params: FinanceTransactionFilterQuery,
-) {
-  return requestClient.get<FinanceTransactionStatsDto>(
-    '/finance/transaction/stats',
-    {
-      params,
-    },
-  );
-}
-
-/** 查询交易流水详情。 */
-export async function getFinanceTransactionDetailApi(params: {
-  storeId: string;
-  transactionId: string;
-}) {
-  return requestClient.get<FinanceTransactionDetailDto>(
-    '/finance/transaction/detail',
-    {
-      params,
-    },
-  );
-}
-
-/** 导出交易流水 CSV。 */
-export async function exportFinanceTransactionCsvApi(
-  params: FinanceTransactionFilterQuery,
-) {
-  return requestClient.get<FinanceTransactionExportDto>(
-    '/finance/transaction/export',
-    {
-      params,
-    },
-  );
-}

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

@@ -0,0 +1,206 @@
+/**
+ * 文件职责：财务中心发票管理 API 契约与请求封装。
+ */
+import { requestClient } from '#/api/request';
+
+/** 发票状态筛选值。 */
+export type FinanceInvoiceStatusFilter = 'all' | 'issued' | 'pending' | 'voided';
+
+/** 发票类型筛选值。 */
+export type FinanceInvoiceTypeFilter = 'all' | 'normal' | 'special';
+
+/** 发票设置详情。 */
+export interface FinanceInvoiceSettingDto {
+  autoIssueMaxAmount: number;
+  bankAccount?: string;
+  bankName?: string;
+  companyName: string;
+  enableAutoIssue: boolean;
+  enableElectronicNormalInvoice: boolean;
+  enableElectronicSpecialInvoice: boolean;
+  registeredAddress?: string;
+  registeredPhone?: string;
+  taxpayerNumber: string;
+}
+
+/** 保存发票设置请求。 */
+export interface SaveFinanceInvoiceSettingPayload
+  extends FinanceInvoiceSettingDto {}
+
+/** 发票记录列表查询参数。 */
+export interface FinanceInvoiceRecordListQuery {
+  endDate?: string;
+  invoiceType?: Exclude<FinanceInvoiceTypeFilter, 'all'>;
+  keyword?: string;
+  page: number;
+  pageSize: number;
+  startDate?: string;
+  status?: Exclude<FinanceInvoiceStatusFilter, 'all'>;
+}
+
+/** 发票统计结果。 */
+export interface FinanceInvoiceStatsDto {
+  currentMonthIssuedAmount: number;
+  currentMonthIssuedCount: number;
+  pendingCount: number;
+  voidedCount: number;
+}
+
+/** 发票记录列表项。 */
+export interface FinanceInvoiceRecordListItemDto {
+  amount: number;
+  applicantName: string;
+  appliedAt: string;
+  companyName: string;
+  invoiceNo: string;
+  invoiceType: string;
+  invoiceTypeText: string;
+  orderNo: string;
+  recordId: string;
+  status: string;
+  statusText: string;
+}
+
+/** 发票记录分页结果。 */
+export interface FinanceInvoiceRecordListResultDto {
+  items: FinanceInvoiceRecordListItemDto[];
+  page: number;
+  pageSize: number;
+  stats: FinanceInvoiceStatsDto;
+  totalCount: number;
+}
+
+/** 发票记录详情。 */
+export interface FinanceInvoiceRecordDetailDto {
+  amount: number;
+  applicantName: string;
+  appliedAt: string;
+  applyRemark?: string;
+  companyName: string;
+  contactEmail?: string;
+  contactPhone?: string;
+  invoiceNo: string;
+  invoiceType: string;
+  invoiceTypeText: string;
+  issueRemark?: string;
+  issuedAt?: string;
+  issuedByUserId?: string;
+  orderNo: string;
+  recordId: string;
+  status: string;
+  statusText: string;
+  taxpayerNumber?: string;
+  voidReason?: string;
+  voidedAt?: string;
+  voidedByUserId?: string;
+}
+
+/** 发票开票请求。 */
+export interface FinanceInvoiceIssuePayload {
+  contactEmail?: string;
+  issueRemark?: string;
+  recordId: string;
+}
+
+/** 发票开票结果。 */
+export interface FinanceInvoiceIssueResultDto {
+  amount: number;
+  companyName: string;
+  contactEmail?: string;
+  invoiceNo: string;
+  issuedAt: string;
+  recordId: string;
+  status: string;
+  statusText: string;
+}
+
+/** 发票作废请求。 */
+export interface FinanceInvoiceVoidPayload {
+  recordId: string;
+  voidReason: string;
+}
+
+/** 发票申请请求。 */
+export interface FinanceInvoiceApplyPayload {
+  amount: number;
+  applicantName: string;
+  appliedAt?: string;
+  applyRemark?: string;
+  companyName: string;
+  contactEmail?: string;
+  contactPhone?: string;
+  invoiceType: Exclude<FinanceInvoiceTypeFilter, 'all'>;
+  orderNo: string;
+  taxpayerNumber?: string;
+}
+
+/** 查询发票设置。 */
+export async function getFinanceInvoiceSettingDetailApi() {
+  return requestClient.get<FinanceInvoiceSettingDto>(
+    '/finance/invoice/settings/detail',
+  );
+}
+
+/** 保存发票设置。 */
+export async function saveFinanceInvoiceSettingApi(
+  payload: SaveFinanceInvoiceSettingPayload,
+) {
+  return requestClient.post<FinanceInvoiceSettingDto>(
+    '/finance/invoice/settings/save',
+    payload,
+  );
+}
+
+/** 查询发票记录列表。 */
+export async function getFinanceInvoiceRecordListApi(
+  params: FinanceInvoiceRecordListQuery,
+) {
+  return requestClient.get<FinanceInvoiceRecordListResultDto>(
+    '/finance/invoice/record/list',
+    {
+      params,
+    },
+  );
+}
+
+/** 查询发票记录详情。 */
+export async function getFinanceInvoiceRecordDetailApi(params: {
+  recordId: string;
+}) {
+  return requestClient.get<FinanceInvoiceRecordDetailDto>(
+    '/finance/invoice/record/detail',
+    {
+      params,
+    },
+  );
+}
+
+/** 执行发票开票。 */
+export async function issueFinanceInvoiceRecordApi(
+  payload: FinanceInvoiceIssuePayload,
+) {
+  return requestClient.post<FinanceInvoiceIssueResultDto>(
+    '/finance/invoice/record/issue',
+    payload,
+  );
+}
+
+/** 执行发票作废。 */
+export async function voidFinanceInvoiceRecordApi(
+  payload: FinanceInvoiceVoidPayload,
+) {
+  return requestClient.post<FinanceInvoiceRecordDetailDto>(
+    '/finance/invoice/record/void',
+    payload,
+  );
+}
+
+/** 发起发票申请。 */
+export async function applyFinanceInvoiceRecordApi(
+  payload: FinanceInvoiceApplyPayload,
+) {
+  return requestClient.post<FinanceInvoiceRecordDetailDto>(
+    '/finance/invoice/record/apply',
+    payload,
+  );
+}

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

@@ -0,0 +1,156 @@
+/**
+ * 文件职责：财务中心经营报表 API 契约与请求封装。
+ */
+import { requestClient } from '#/api/request';
+
+/** 报表周期筛选值。 */
+export type FinanceBusinessReportPeriodType = 'daily' | 'monthly' | 'weekly';
+
+/** 经营报表状态值。 */
+export type FinanceBusinessReportStatus =
+  | 'failed'
+  | 'queued'
+  | 'running'
+  | 'succeeded';
+
+/** 经营报表列表查询参数。 */
+export interface FinanceBusinessReportListQuery {
+  page: number;
+  pageSize: number;
+  periodType?: FinanceBusinessReportPeriodType;
+  storeId: string;
+}
+
+/** 经营报表详情查询参数。 */
+export interface FinanceBusinessReportDetailQuery {
+  reportId: string;
+  storeId: string;
+}
+
+/** 经营报表批量导出查询参数。 */
+export interface FinanceBusinessReportBatchExportQuery {
+  page: number;
+  pageSize: number;
+  periodType?: FinanceBusinessReportPeriodType;
+  storeId: string;
+}
+
+/** 经营报表列表行。 */
+export interface FinanceBusinessReportListItemDto {
+  averageOrderValue: number;
+  canDownload: boolean;
+  costTotalAmount: number;
+  dateText: string;
+  netProfitAmount: number;
+  orderCount: number;
+  profitRatePercent: number;
+  refundRatePercent: number;
+  reportId: string;
+  revenueAmount: number;
+  status: FinanceBusinessReportStatus;
+  statusText: string;
+}
+
+/** 经营报表列表结果。 */
+export interface FinanceBusinessReportListResultDto {
+  items: FinanceBusinessReportListItemDto[];
+  page: number;
+  pageSize: number;
+  total: number;
+}
+
+/** 经营报表 KPI 项。 */
+export interface FinanceBusinessReportKpiDto {
+  key: string;
+  label: string;
+  momChangeRate: number;
+  valueText: string;
+  yoyChangeRate: number;
+}
+
+/** 经营报表明细项。 */
+export interface FinanceBusinessReportBreakdownItemDto {
+  amount: number;
+  key: string;
+  label: string;
+  ratioPercent: number;
+}
+
+/** 经营报表详情。 */
+export interface FinanceBusinessReportDetailDto {
+  costBreakdowns: FinanceBusinessReportBreakdownItemDto[];
+  incomeBreakdowns: FinanceBusinessReportBreakdownItemDto[];
+  kpis: FinanceBusinessReportKpiDto[];
+  periodType: FinanceBusinessReportPeriodType;
+  reportId: string;
+  status: FinanceBusinessReportStatus;
+  statusText: string;
+  title: string;
+}
+
+/** 经营报表导出结果。 */
+export interface FinanceBusinessReportExportDto {
+  fileContentBase64: string;
+  fileName: string;
+  totalCount: number;
+}
+
+/** 查询经营报表列表。 */
+export async function getFinanceBusinessReportListApi(
+  params: FinanceBusinessReportListQuery,
+) {
+  return requestClient.get<FinanceBusinessReportListResultDto>(
+    '/finance/report/list',
+    {
+      params,
+    },
+  );
+}
+
+/** 查询经营报表详情。 */
+export async function getFinanceBusinessReportDetailApi(
+  params: FinanceBusinessReportDetailQuery,
+) {
+  return requestClient.get<FinanceBusinessReportDetailDto>(
+    '/finance/report/detail',
+    {
+      params,
+    },
+  );
+}
+
+/** 导出经营报表 PDF。 */
+export async function exportFinanceBusinessReportPdfApi(
+  params: FinanceBusinessReportDetailQuery,
+) {
+  return requestClient.get<FinanceBusinessReportExportDto>(
+    '/finance/report/export/pdf',
+    {
+      params,
+    },
+  );
+}
+
+/** 导出经营报表 Excel。 */
+export async function exportFinanceBusinessReportExcelApi(
+  params: FinanceBusinessReportDetailQuery,
+) {
+  return requestClient.get<FinanceBusinessReportExportDto>(
+    '/finance/report/export/excel',
+    {
+      params,
+    },
+  );
+}
+
+/** 批量导出经营报表（ZIP）。 */
+export async function exportFinanceBusinessReportBatchApi(
+  params: FinanceBusinessReportBatchExportQuery,
+) {
+  return requestClient.get<FinanceBusinessReportExportDto>(
+    '/finance/report/export/batch',
+    {
+      params,
+    },
+  );
+}

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

@@ -0,0 +1,159 @@
+/**
+ * 文件职责：财务中心交易流水 API 契约与请求封装。
+ */
+import { requestClient } from '#/api/request';
+
+/** 交易类型筛选值。 */
+export type FinanceTransactionTypeFilter =
+  | 'all'
+  | 'income'
+  | 'point_redeem'
+  | 'refund'
+  | 'stored_card_recharge';
+
+/** 交易渠道筛选值。 */
+export type FinanceTransactionChannelFilter =
+  | 'all'
+  | 'delivery'
+  | 'dine_in'
+  | 'pickup';
+
+/** 交易支付方式筛选值。 */
+export type FinanceTransactionPaymentFilter =
+  | 'alipay'
+  | 'all'
+  | 'balance'
+  | 'card'
+  | 'cash'
+  | 'wechat';
+
+/** 交易流水筛选参数。 */
+export interface FinanceTransactionFilterQuery {
+  channel?: FinanceTransactionChannelFilter;
+  endDate?: string;
+  keyword?: string;
+  paymentMethod?: FinanceTransactionPaymentFilter;
+  startDate?: string;
+  storeId: string;
+  type?: FinanceTransactionTypeFilter;
+}
+
+/** 交易流水列表查询参数。 */
+export interface FinanceTransactionListQuery extends FinanceTransactionFilterQuery {
+  page: number;
+  pageSize: number;
+}
+
+/** 交易流水列表行。 */
+export interface FinanceTransactionListItemDto {
+  amount: number;
+  channel: string;
+  isIncome: boolean;
+  occurredAt: string;
+  orderNo?: string;
+  paymentMethod: string;
+  remark: string;
+  transactionId: string;
+  transactionNo: string;
+  type: string;
+  typeText: string;
+}
+
+/** 交易流水列表结果。 */
+export interface FinanceTransactionListResultDto {
+  items: FinanceTransactionListItemDto[];
+  page: number;
+  pageIncomeAmount: number;
+  pageRefundAmount: number;
+  pageSize: number;
+  total: number;
+}
+
+/** 交易流水统计结果。 */
+export interface FinanceTransactionStatsDto {
+  totalCount: number;
+  totalIncome: number;
+  totalRefund: number;
+}
+
+/** 交易流水详情。 */
+export interface FinanceTransactionDetailDto {
+  amount: number;
+  arrivedAmount?: number;
+  channel: string;
+  customerName: string;
+  customerPhone: string;
+  giftAmount?: number;
+  memberMobileMasked?: string;
+  memberName?: string;
+  occurredAt: string;
+  orderNo?: string;
+  paymentMethod: string;
+  pointBalanceAfterChange?: number;
+  pointChangeAmount?: number;
+  rechargeAmount?: number;
+  refundNo?: string;
+  refundReason?: string;
+  remark: string;
+  storeId: string;
+  transactionId: string;
+  transactionNo: string;
+  type: string;
+  typeText: string;
+}
+
+/** 交易流水导出结果。 */
+export interface FinanceTransactionExportDto {
+  fileContentBase64: string;
+  fileName: string;
+  totalCount: number;
+}
+
+/** 查询交易流水列表。 */
+export async function getFinanceTransactionListApi(
+  params: FinanceTransactionListQuery,
+) {
+  return requestClient.get<FinanceTransactionListResultDto>(
+    '/finance/transaction/list',
+    {
+      params,
+    },
+  );
+}
+
+/** 查询交易流水统计。 */
+export async function getFinanceTransactionStatsApi(
+  params: FinanceTransactionFilterQuery,
+) {
+  return requestClient.get<FinanceTransactionStatsDto>(
+    '/finance/transaction/stats',
+    {
+      params,
+    },
+  );
+}
+
+/** 查询交易流水详情。 */
+export async function getFinanceTransactionDetailApi(params: {
+  storeId: string;
+  transactionId: string;
+}) {
+  return requestClient.get<FinanceTransactionDetailDto>(
+    '/finance/transaction/detail',
+    {
+      params,
+    },
+  );
+}
+
+/** 导出交易流水 CSV。 */
+export async function exportFinanceTransactionCsvApi(
+  params: FinanceTransactionFilterQuery,
+) {
+  return requestClient.get<FinanceTransactionExportDto>(
+    '/finance/transaction/export',
+    {
+      params,
+    },
+  );
+}

apps/web-antd/src/views/finance/invoice/components/InvoiceDetailDrawer.vue

@@ -0,0 +1,136 @@
+<script setup lang="ts">
+/**
+ * 文件职责：发票记录详情抽屉。
+ */
+import type { FinanceInvoiceRecordDetailDto } from '#/api/finance';
+
+import { Button, Drawer, Empty, Spin, Tag } from 'ant-design-vue';
+
+import {
+  formatCurrency,
+  resolveInvoiceStatusTagColor,
+  resolveInvoiceTypeTagColor,
+} from '../composables/invoice-page/helpers';
+
+interface Props {
+  detail: FinanceInvoiceRecordDetailDto | null;
+  loading: boolean;
+  open: boolean;
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'close'): void;
+}>();
+</script>
+
+<template>
+  <Drawer
+    :open="props.open"
+    width="620"
+    :title="`发票详情 ${props.detail?.invoiceNo ?? ''}`"
+    @close="emit('close')"
+  >
+    <Spin :spinning="props.loading">
+      <template v-if="props.detail">
+        <div class="fi-section">
+          <div class="fi-section-title">基本信息</div>
+          <div class="fi-info-grid">
+            <div>
+              <span class="label">发票号码：</span>
+              <span class="fi-mono">{{ props.detail.invoiceNo }}</span>
+            </div>
+            <div>
+              <span class="label">状态：</span>
+              <Tag :color="resolveInvoiceStatusTagColor(props.detail.status)">
+                {{ props.detail.statusText }}
+              </Tag>
+            </div>
+            <div>
+              <span class="label">申请人：</span>
+              <span>{{ props.detail.applicantName || '--' }}</span>
+            </div>
+            <div>
+              <span class="label">发票类型：</span>
+              <Tag :color="resolveInvoiceTypeTagColor(props.detail.invoiceType)">
+                {{ props.detail.invoiceTypeText || '--' }}
+              </Tag>
+            </div>
+            <div class="full">
+              <span class="label">公司抬头：</span>
+              <span>{{ props.detail.companyName || '--' }}</span>
+            </div>
+            <div>
+              <span class="label">纳税人识别号：</span>
+              <span class="fi-mono">{{ props.detail.taxpayerNumber || '--' }}</span>
+            </div>
+            <div>
+              <span class="label">开票金额：</span>
+              <span class="fi-amount-strong">{{ formatCurrency(props.detail.amount) }}</span>
+            </div>
+            <div class="full">
+              <span class="label">关联订单：</span>
+              <span class="fi-mono">{{ props.detail.orderNo || '--' }}</span>
+            </div>
+          </div>
+        </div>
+
+        <div class="fi-section">
+          <div class="fi-section-title">联系信息</div>
+          <div class="fi-info-grid">
+            <div>
+              <span class="label">接收邮箱：</span>
+              <span>{{ props.detail.contactEmail || '--' }}</span>
+            </div>
+            <div>
+              <span class="label">联系电话：</span>
+              <span>{{ props.detail.contactPhone || '--' }}</span>
+            </div>
+          </div>
+        </div>
+
+        <div class="fi-section">
+          <div class="fi-section-title">状态记录</div>
+          <div class="fi-timeline">
+            <div class="fi-timeline-item">
+              <span class="text">提交申请</span>
+              <span class="time">{{ props.detail.appliedAt }}</span>
+            </div>
+            <div v-if="props.detail.issuedAt" class="fi-timeline-item">
+              <span class="text">开票完成</span>
+              <span class="time">{{ props.detail.issuedAt }}</span>
+            </div>
+            <div v-if="props.detail.voidedAt" class="fi-timeline-item">
+              <span class="text">发票作废</span>
+              <span class="time">{{ props.detail.voidedAt }}</span>
+            </div>
+          </div>
+        </div>
+
+        <div class="fi-section">
+          <div class="fi-section-title">备注信息</div>
+          <div class="fi-remark-box">
+            <div class="fi-remark-line">
+              <span class="label">申请备注：</span>
+              <span>{{ props.detail.applyRemark || '无' }}</span>
+            </div>
+            <div class="fi-remark-line">
+              <span class="label">开票备注：</span>
+              <span>{{ props.detail.issueRemark || '无' }}</span>
+            </div>
+            <div class="fi-remark-line">
+              <span class="label">作废原因：</span>
+              <span>{{ props.detail.voidReason || '无' }}</span>
+            </div>
+          </div>
+        </div>
+      </template>
+      <Empty v-else description="暂无发票详情" />
+    </Spin>
+
+    <template #footer>
+      <Button @click="emit('close')">关闭</Button>
+    </template>
+  </Drawer>
+</template>

apps/web-antd/src/views/finance/invoice/components/InvoiceFilterBar.vue

@@ -0,0 +1,101 @@
+<script setup lang="ts">
+/**
+ * 文件职责：发票记录筛选工具栏。
+ */
+import type { FinanceInvoiceFilterState } from '../types';
+
+import { IconifyIcon } from '@vben/icons';
+
+import { Input, Select } from 'ant-design-vue';
+
+import {
+  INVOICE_STATUS_OPTIONS,
+  INVOICE_TYPE_OPTIONS,
+} from '../composables/invoice-page/constants';
+
+interface Props {
+  filters: FinanceInvoiceFilterState;
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'search'): void;
+  (event: 'update:endDate', value: string): void;
+  (event: 'update:invoiceType', value: string): void;
+  (event: 'update:keyword', value: string): void;
+  (event: 'update:startDate', value: string): void;
+  (event: 'update:status', value: string): void;
+}>();
+
+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 handleStatusChange(value: unknown) {
+  emit('update:status', String(value ?? 'all'));
+  emit('search');
+}
+
+function handleInvoiceTypeChange(value: unknown) {
+  emit('update:invoiceType', String(value ?? 'all'));
+  emit('search');
+}
+
+function handleKeywordChange(value: string | undefined) {
+  emit('update:keyword', String(value ?? ''));
+}
+</script>
+
+<template>
+  <div class="fi-toolbar">
+    <Input
+      class="fi-date-input"
+      type="date"
+      :value="props.filters.startDate"
+      @update:value="(value) => handleStartDateChange(value)"
+    />
+    <span class="fi-date-sep">至</span>
+    <Input
+      class="fi-date-input"
+      type="date"
+      :value="props.filters.endDate"
+      @update:value="(value) => handleEndDateChange(value)"
+    />
+
+    <Select
+      class="fi-status-select"
+      :value="props.filters.status"
+      :options="INVOICE_STATUS_OPTIONS"
+      @update:value="(value) => handleStatusChange(value)"
+    />
+
+    <Select
+      class="fi-type-select"
+      :value="props.filters.invoiceType"
+      :options="INVOICE_TYPE_OPTIONS"
+      @update:value="(value) => handleInvoiceTypeChange(value)"
+    />
+
+    <div class="fi-toolbar-spacer" />
+
+    <Input
+      class="fi-search"
+      :value="props.filters.keyword"
+      placeholder="搜索发票号码/公司名"
+      allow-clear
+      @update:value="(value) => handleKeywordChange(value)"
+      @press-enter="emit('search')"
+    >
+      <template #prefix>
+        <IconifyIcon icon="lucide:search" class="fi-search-icon" />
+      </template>
+    </Input>
+  </div>
+</template>

apps/web-antd/src/views/finance/invoice/components/InvoiceIssueDrawer.vue

@@ -0,0 +1,121 @@
+<script setup lang="ts">
+/**
+ * 文件职责：发票开票抽屉。
+ */
+import type {
+  FinanceInvoiceRecordDetailDto,
+  FinanceInvoiceRecordListItemDto,
+} from '#/api/finance';
+import type { FinanceInvoiceIssueFormState } from '../types';
+
+import { Button, Drawer, Form, Input, Spin, Tag } from 'ant-design-vue';
+
+import {
+  formatCurrency,
+  resolveInvoiceTypeTagColor,
+} from '../composables/invoice-page/helpers';
+
+interface Props {
+  detail: FinanceInvoiceRecordDetailDto | null;
+  form: FinanceInvoiceIssueFormState;
+  loadingDetail: boolean;
+  open: boolean;
+  submitting: boolean;
+  targetRecord: FinanceInvoiceRecordListItemDto | null;
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'close'): void;
+  (event: 'submit'): void;
+  (event: 'update:contactEmail', value: string): void;
+  (event: 'update:issueRemark', value: string): void;
+}>();
+
+function toStringValue(value: string | undefined) {
+  return String(value ?? '');
+}
+</script>
+
+<template>
+  <Drawer
+    :open="props.open"
+    width="560"
+    title="发票开票"
+    @close="emit('close')"
+  >
+    <Spin :spinning="props.loadingDetail">
+      <div class="fi-section">
+        <div class="fi-section-title">开票信息</div>
+        <div class="fi-info-grid">
+          <div>
+            <span class="label">发票号码：</span>
+            <span class="fi-mono">{{ props.targetRecord?.invoiceNo || '--' }}</span>
+          </div>
+          <div>
+            <span class="label">发票类型：</span>
+            <Tag
+              :color="resolveInvoiceTypeTagColor(props.targetRecord?.invoiceType || '')"
+            >
+              {{ props.targetRecord?.invoiceTypeText || '--' }}
+            </Tag>
+          </div>
+          <div>
+            <span class="label">申请人：</span>
+            <span>{{ props.targetRecord?.applicantName || '--' }}</span>
+          </div>
+          <div>
+            <span class="label">开票金额：</span>
+            <span class="fi-amount-strong">{{ formatCurrency(Number(props.targetRecord?.amount || 0)) }}</span>
+          </div>
+          <div class="full">
+            <span class="label">公司抬头：</span>
+            <span>{{ props.targetRecord?.companyName || '--' }}</span>
+          </div>
+          <div class="full">
+            <span class="label">关联订单：</span>
+            <span class="fi-mono">{{ props.targetRecord?.orderNo || '--' }}</span>
+          </div>
+          <div class="full">
+            <span class="label">纳税人识别号：</span>
+            <span class="fi-mono">{{ props.detail?.taxpayerNumber || '--' }}</span>
+          </div>
+        </div>
+      </div>
+
+      <div class="fi-section">
+        <div class="fi-section-title">开票补充信息</div>
+        <Form layout="vertical">
+          <Form.Item label="接收邮箱">
+            <Input
+              :value="props.form.contactEmail"
+              placeholder="请输入开票接收邮箱"
+              @update:value="(value) => emit('update:contactEmail', toStringValue(value))"
+            />
+          </Form.Item>
+
+          <Form.Item label="开票备注">
+            <Input.TextArea
+              :value="props.form.issueRemark"
+              placeholder="请输入开票备注（选填）"
+              :maxlength="200"
+              :rows="4"
+              show-count
+              @update:value="(value) => emit('update:issueRemark', toStringValue(value))"
+            />
+          </Form.Item>
+        </Form>
+      </div>
+    </Spin>
+
+    <template #footer>
+      <div class="fi-drawer-footer">
+        <Button @click="emit('close')">取消</Button>
+        <Button type="primary" :loading="props.submitting" @click="emit('submit')">
+          确认开票
+        </Button>
+      </div>
+    </template>
+  </Drawer>
+</template>

apps/web-antd/src/views/finance/invoice/components/InvoiceIssueResultModal.vue

@@ -0,0 +1,62 @@
+<script setup lang="ts">
+/**
+ * 文件职责：发票开票成功结果弹窗。
+ */
+import type { FinanceInvoiceIssueResultDto } from '#/api/finance';
+
+import { Button } from 'ant-design-vue';
+import { Modal } from 'ant-design-vue';
+
+import { formatCurrency } from '../composables/invoice-page/helpers';
+
+interface Props {
+  open: boolean;
+  result: FinanceInvoiceIssueResultDto | null;
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'close'): void;
+}>();
+</script>
+
+<template>
+  <Modal
+    :open="props.open"
+    title="开票完成"
+    :footer="null"
+    @cancel="emit('close')"
+  >
+    <div class="fi-issue-result">
+      <div class="fi-result-title">发票已成功开具</div>
+
+      <div class="fi-result-list">
+        <div class="fi-result-line">
+          <span class="label">发票号码</span>
+          <span class="value fi-mono">{{ props.result?.invoiceNo || '--' }}</span>
+        </div>
+        <div class="fi-result-line">
+          <span class="label">公司抬头</span>
+          <span class="value">{{ props.result?.companyName || '--' }}</span>
+        </div>
+        <div class="fi-result-line">
+          <span class="label">开票金额</span>
+          <span class="value">{{ formatCurrency(Number(props.result?.amount || 0)) }}</span>
+        </div>
+        <div class="fi-result-line">
+          <span class="label">接收邮箱</span>
+          <span class="value">{{ props.result?.contactEmail || '--' }}</span>
+        </div>
+        <div class="fi-result-line">
+          <span class="label">开票时间</span>
+          <span class="value">{{ props.result?.issuedAt || '--' }}</span>
+        </div>
+      </div>
+
+      <div class="fi-result-footer">
+        <Button type="primary" @click="emit('close')">我知道了</Button>
+      </div>
+    </div>
+  </Modal>
+</template>

apps/web-antd/src/views/finance/invoice/components/InvoiceSegmentTabs.vue

@@ -0,0 +1,29 @@
+<script setup lang="ts">
+/**
+ * 文件职责：发票管理分段切换栏。
+ */
+import type { FinanceInvoiceTabKey } from '../types';
+
+import { Segmented } from 'ant-design-vue';
+
+interface Props {
+  activeTab: FinanceInvoiceTabKey;
+  options: Array<{ label: string; value: FinanceInvoiceTabKey }>;
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'update:activeTab', value: FinanceInvoiceTabKey): void;
+}>();
+</script>
+
+<template>
+  <div v-if="props.options.length > 0" class="fi-seg-wrap">
+    <Segmented
+      :value="props.activeTab"
+      :options="props.options"
+      @update:value="(value) => emit('update:activeTab', value as FinanceInvoiceTabKey)"
+    />
+  </div>
+</template>

apps/web-antd/src/views/finance/invoice/components/InvoiceSettingsConfirmModal.vue

@@ -0,0 +1,72 @@
+<script setup lang="ts">
+/**
+ * 文件职责：保存发票设置确认弹窗。
+ */
+import type { FinanceInvoiceSettingFormState } from '../types';
+
+import { Modal } from 'ant-design-vue';
+
+import { formatCurrency } from '../composables/invoice-page/helpers';
+
+interface Props {
+  form: FinanceInvoiceSettingFormState;
+  open: boolean;
+  submitting: boolean;
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'close'): void;
+  (event: 'confirm'): void;
+}>();
+
+function resolveEnabledText(value: boolean) {
+  return value ? '已开启' : '已关闭';
+}
+</script>
+
+<template>
+  <Modal
+    :open="props.open"
+    title="确认保存发票设置"
+    ok-text="确认保存"
+    cancel-text="取消"
+    :confirm-loading="props.submitting"
+    @ok="emit('confirm')"
+    @cancel="emit('close')"
+  >
+    <div class="fi-settings-confirm">
+      <p class="fi-settings-desc">
+        即将更新企业开票信息与开票规则，请确认以下关键配置：
+      </p>
+
+      <div class="fi-settings-list">
+        <div class="fi-settings-line">
+          <span class="label">企业名称</span>
+          <span class="value">{{ props.form.companyName || '--' }}</span>
+        </div>
+        <div class="fi-settings-line">
+          <span class="label">纳税人识别号</span>
+          <span class="value fi-mono">{{ props.form.taxpayerNumber || '--' }}</span>
+        </div>
+        <div class="fi-settings-line">
+          <span class="label">电子普通发票</span>
+          <span class="value">{{ resolveEnabledText(props.form.enableElectronicNormalInvoice) }}</span>
+        </div>
+        <div class="fi-settings-line">
+          <span class="label">电子专用发票</span>
+          <span class="value">{{ resolveEnabledText(props.form.enableElectronicSpecialInvoice) }}</span>
+        </div>
+        <div class="fi-settings-line">
+          <span class="label">自动开票</span>
+          <span class="value">{{ resolveEnabledText(props.form.enableAutoIssue) }}</span>
+        </div>
+        <div class="fi-settings-line">
+          <span class="label">自动开票上限</span>
+          <span class="value">{{ formatCurrency(Number(props.form.autoIssueMaxAmount || 0)) }}</span>
+        </div>
+      </div>
+    </div>
+  </Modal>
+</template>

apps/web-antd/src/views/finance/invoice/components/InvoiceSettingsPanel.vue

@@ -0,0 +1,171 @@
+<script setup lang="ts">
+/**
+ * 文件职责：发票设置表单区域。
+ */
+import type { FinanceInvoiceSettingFormState } from '../types';
+
+import { Button, Card, Divider, Form, Input, InputNumber, Switch } from 'ant-design-vue';
+
+interface Props {
+  canManageSettings: boolean;
+  form: FinanceInvoiceSettingFormState;
+  saving: boolean;
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'reset'): void;
+  (event: 'save'): void;
+  (event: 'update:autoIssueMaxAmount', value: number): void;
+  (event: 'update:bankAccount', value: string): void;
+  (event: 'update:bankName', value: string): void;
+  (event: 'update:companyName', value: string): void;
+  (event: 'update:enableAutoIssue', value: boolean): void;
+  (event: 'update:enableElectronicNormalInvoice', value: boolean): void;
+  (event: 'update:enableElectronicSpecialInvoice', value: boolean): void;
+  (event: 'update:registeredAddress', value: string): void;
+  (event: 'update:registeredPhone', value: string): void;
+  (event: 'update:taxpayerNumber', value: string): void;
+}>();
+
+function toStringValue(value: string | undefined) {
+  return String(value ?? '');
+}
+
+function toNumberValue(value: null | number | string) {
+  const numeric = Number(value ?? 0);
+  return Number.isFinite(numeric) ? numeric : 0;
+}
+</script>
+
+<template>
+  <div class="fi-settings">
+    <Card>
+      <div class="fi-section-hd">企业开票信息</div>
+      <Form layout="vertical">
+        <div class="fi-form-grid">
+          <Form.Item label="企业名称" required>
+            <Input
+              :value="props.form.companyName"
+              placeholder="请输入企业全称"
+              :disabled="!props.canManageSettings"
+              @update:value="(value) => emit('update:companyName', toStringValue(value))"
+            />
+          </Form.Item>
+
+          <Form.Item label="纳税人识别号" required>
+            <Input
+              :value="props.form.taxpayerNumber"
+              placeholder="请输入统一社会信用代码"
+              :disabled="!props.canManageSettings"
+              @update:value="(value) => emit('update:taxpayerNumber', toStringValue(value))"
+            />
+          </Form.Item>
+
+          <Form.Item label="注册地址">
+            <Input
+              :value="props.form.registeredAddress"
+              placeholder="请输入注册地址"
+              :disabled="!props.canManageSettings"
+              @update:value="(value) => emit('update:registeredAddress', toStringValue(value))"
+            />
+          </Form.Item>
+
+          <Form.Item label="注册电话">
+            <Input
+              :value="props.form.registeredPhone"
+              placeholder="请输入注册电话"
+              :disabled="!props.canManageSettings"
+              @update:value="(value) => emit('update:registeredPhone', toStringValue(value))"
+            />
+          </Form.Item>
+
+          <Form.Item label="开户银行">
+            <Input
+              :value="props.form.bankName"
+              placeholder="请输入开户银行名称"
+              :disabled="!props.canManageSettings"
+              @update:value="(value) => emit('update:bankName', toStringValue(value))"
+            />
+          </Form.Item>
+
+          <Form.Item label="银行账号">
+            <Input
+              :value="props.form.bankAccount"
+              placeholder="请输入银行账号"
+              :disabled="!props.canManageSettings"
+              @update:value="(value) => emit('update:bankAccount', toStringValue(value))"
+            />
+          </Form.Item>
+        </div>
+      </Form>
+    </Card>
+
+    <Card>
+      <div class="fi-section-hd">发票类型设置</div>
+      <div class="fi-toggle-row">
+        <Switch
+          :checked="props.form.enableElectronicNormalInvoice"
+          :disabled="!props.canManageSettings"
+          @update:checked="(value) => emit('update:enableElectronicNormalInvoice', Boolean(value))"
+        />
+        <span class="fi-toggle-label">电子普通发票</span>
+      </div>
+
+      <div class="fi-toggle-row">
+        <Switch
+          :checked="props.form.enableElectronicSpecialInvoice"
+          :disabled="!props.canManageSettings"
+          @update:checked="(value) => emit('update:enableElectronicSpecialInvoice', Boolean(value))"
+        />
+        <span class="fi-toggle-label">电子专用发票</span>
+        <span class="fi-toggle-hint">（需先完成税务资质认证）</span>
+      </div>
+    </Card>
+
+    <Card>
+      <div class="fi-section-hd">自动开票设置</div>
+      <div class="fi-toggle-row">
+        <Switch
+          :checked="props.form.enableAutoIssue"
+          :disabled="!props.canManageSettings"
+          @update:checked="(value) => emit('update:enableAutoIssue', Boolean(value))"
+        />
+        <span class="fi-toggle-label">自动开票</span>
+        <span class="fi-toggle-hint">开启后，顾客申请发票将自动开具</span>
+      </div>
+
+      <Divider />
+
+      <Form layout="vertical" class="fi-auto-form">
+        <Form.Item label="单张发票最大金额">
+          <InputNumber
+            class="fi-max-amount-input"
+            :value="props.form.autoIssueMaxAmount"
+            :min="0"
+            :precision="2"
+            :step="100"
+            :disabled="!props.canManageSettings"
+            :formatter="(value) => `￥ ${value}`"
+            :parser="(value) => String(value || '').replace(/￥\s?/g, '')"
+            @update:value="(value) => emit('update:autoIssueMaxAmount', toNumberValue(value))"
+          />
+          <div class="fi-toggle-hint">超过此金额的发票需人工审核后开具</div>
+        </Form.Item>
+      </Form>
+    </Card>
+
+    <div class="fi-save-bar">
+      <Button :disabled="!props.canManageSettings" @click="emit('reset')">重置</Button>
+      <Button
+        type="primary"
+        :disabled="!props.canManageSettings"
+        :loading="props.saving"
+        @click="emit('save')"
+      >
+        保存设置
+      </Button>
+    </div>
+  </div>
+</template>

apps/web-antd/src/views/finance/invoice/components/InvoiceStatsBar.vue

@@ -0,0 +1,47 @@
+<script setup lang="ts">
+/**
+ * 文件职责：发票记录统计卡片栏。
+ */
+import type { FinanceInvoiceStatsDto } from '#/api/finance';
+
+import { IconifyIcon } from '@vben/icons';
+
+import { formatCurrency } from '../composables/invoice-page/helpers';
+
+interface Props {
+  stats: FinanceInvoiceStatsDto;
+}
+
+const props = defineProps<Props>();
+</script>
+
+<template>
+  <div class="fi-stats">
+    <div class="fi-stat-card">
+      <div class="fi-stat-label">
+        <IconifyIcon icon="lucide:receipt-text" class="fi-stat-icon" />
+        <span>本月开票</span>
+      </div>
+      <div class="fi-stat-val">{{ formatCurrency(props.stats.currentMonthIssuedAmount) }}</div>
+      <div class="fi-stat-sub">共 {{ props.stats.currentMonthIssuedCount }} 张</div>
+    </div>
+
+    <div class="fi-stat-card warn">
+      <div class="fi-stat-label">
+        <IconifyIcon icon="lucide:clock" class="fi-stat-icon" />
+        <span>待开票</span>
+      </div>
+      <div class="fi-stat-val">{{ props.stats.pendingCount }}</div>
+      <div class="fi-stat-sub">张待处理</div>
+    </div>
+
+    <div class="fi-stat-card danger">
+      <div class="fi-stat-label">
+        <IconifyIcon icon="lucide:ban" class="fi-stat-icon" />
+        <span>已作废</span>
+      </div>
+      <div class="fi-stat-val">{{ props.stats.voidedCount }}</div>
+      <div class="fi-stat-sub">张已作废</div>
+    </div>
+  </div>
+</template>

apps/web-antd/src/views/finance/invoice/components/InvoiceTableCard.vue

@@ -0,0 +1,206 @@
+<script setup lang="ts">
+/**
+ * 文件职责：发票记录表格与分页。
+ */
+import type { TablePaginationConfig, TableProps } from 'ant-design-vue';
+
+import type { FinanceInvoiceRecordListItemDto } from '#/api/finance';
+import type { VNode } from 'vue';
+
+import { h } from 'vue';
+
+import { Button, Table, Tag } from 'ant-design-vue';
+
+import {
+  formatCurrency,
+  isIssuedInvoice,
+  isPendingInvoice,
+  resolveInvoiceStatusTagColor,
+  resolveInvoiceTypeTagColor,
+} from '../composables/invoice-page/helpers';
+
+interface PaginationState {
+  page: number;
+  pageSize: number;
+  totalCount: number;
+}
+
+interface Props {
+  canIssue: boolean;
+  canVoid: boolean;
+  loading: boolean;
+  pagination: PaginationState;
+  rows: FinanceInvoiceRecordListItemDto[];
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'detail', recordId: string): void;
+  (event: 'issue', row: FinanceInvoiceRecordListItemDto): void;
+  (event: 'pageChange', page: number, pageSize: number): void;
+  (event: 'void', row: FinanceInvoiceRecordListItemDto): void;
+}>();
+
+function renderActionButtons(row: FinanceInvoiceRecordListItemDto) {
+  const buttons: VNode[] = [];
+
+  if (isPendingInvoice(row.status)) {
+    if (props.canIssue) {
+      buttons.push(
+        h(
+          Button,
+          {
+            type: 'link',
+            class: 'fi-link-action',
+            onClick: () => emit('issue', row),
+          },
+          () => '开票',
+        ),
+      );
+    } else {
+      buttons.push(
+        h(
+          Button,
+          {
+            type: 'link',
+            class: 'fi-link-action',
+            onClick: () => emit('detail', row.recordId),
+          },
+          () => '查看',
+        ),
+      );
+    }
+
+    return h('div', { class: 'fi-action-wrap' }, buttons);
+  }
+
+  buttons.push(
+    h(
+      Button,
+      {
+        type: 'link',
+        class: 'fi-link-action',
+        onClick: () => emit('detail', row.recordId),
+      },
+      () => '查看',
+    ),
+  );
+
+  if (isIssuedInvoice(row.status) && props.canVoid) {
+    buttons.push(
+      h(
+        Button,
+        {
+          type: 'link',
+          danger: true,
+          class: 'fi-link-action',
+          onClick: () => emit('void', row),
+        },
+        () => '作废',
+      ),
+    );
+  }
+
+  return h('div', { class: 'fi-action-wrap' }, buttons);
+}
+
+const columns: TableProps['columns'] = [
+  {
+    title: '发票号码',
+    dataIndex: 'invoiceNo',
+    width: 190,
+    customRender: ({ record }) =>
+      h(
+        'span',
+        {
+          class: 'fi-mono',
+        },
+        String(record.invoiceNo || '--'),
+      ),
+  },
+  {
+    title: '申请人 / 公司名',
+    dataIndex: 'companyName',
+    width: 220,
+    customRender: ({ record }) =>
+      h('div', { class: 'fi-company-cell' }, [
+        h('div', { class: 'fi-applicant' }, String(record.applicantName || '--')),
+        h('div', { class: 'fi-company' }, String(record.companyName || '--')),
+      ]),
+  },
+  {
+    title: '发票类型',
+    dataIndex: 'invoiceTypeText',
+    width: 110,
+    customRender: ({ record }) =>
+      h(
+        Tag,
+        { color: resolveInvoiceTypeTagColor(String(record.invoiceType || '')) },
+        () => String(record.invoiceTypeText || '--'),
+      ),
+  },
+  {
+    title: '金额',
+    dataIndex: 'amount',
+    width: 130,
+    align: 'right',
+    customRender: ({ record }) =>
+      h('span', { class: 'fi-amount' }, formatCurrency(Number(record.amount || 0))),
+  },
+  {
+    title: '关联订单',
+    dataIndex: 'orderNo',
+    width: 170,
+    customRender: ({ text }) =>
+      h('span', { class: 'fi-mono' }, String(text || '--')),
+  },
+  {
+    title: '状态',
+    dataIndex: 'statusText',
+    width: 100,
+    customRender: ({ record }) =>
+      h(
+        Tag,
+        { color: resolveInvoiceStatusTagColor(String(record.status || '')) },
+        () => String(record.statusText || '--'),
+      ),
+  },
+  {
+    title: '申请时间',
+    dataIndex: 'appliedAt',
+    width: 180,
+    customRender: ({ text }) => h('span', { class: 'fi-time' }, String(text || '--')),
+  },
+  {
+    title: '操作',
+    key: 'actions',
+    width: 150,
+    customRender: ({ record }) => renderActionButtons(record),
+  },
+];
+
+function handleTableChange(next: TablePaginationConfig) {
+  emit('pageChange', Number(next.current || 1), Number(next.pageSize || 10));
+}
+</script>
+
+<template>
+  <div class="fi-table-card">
+    <Table
+      row-key="recordId"
+      :columns="columns"
+      :data-source="props.rows"
+      :loading="props.loading"
+      :pagination="{
+        current: props.pagination.page,
+        pageSize: props.pagination.pageSize,
+        total: props.pagination.totalCount,
+        showSizeChanger: true,
+        pageSizeOptions: ['10', '20', '50'],
+        showTotal: (total: number) => `共 ${total} 条`,
+      }"
+      @change="handleTableChange"
+    />
+  </div>
+</template>

apps/web-antd/src/views/finance/invoice/components/InvoiceVoidConfirmModal.vue

@@ -0,0 +1,71 @@
+<script setup lang="ts">
+/**
+ * 文件职责：发票作废确认弹窗。
+ */
+import type { FinanceInvoiceRecordListItemDto } from '#/api/finance';
+import type { FinanceInvoiceVoidFormState } from '../types';
+
+import { Modal, Input } from 'ant-design-vue';
+
+import { formatCurrency } from '../composables/invoice-page/helpers';
+
+interface Props {
+  form: FinanceInvoiceVoidFormState;
+  open: boolean;
+  submitting: boolean;
+  targetRecord: FinanceInvoiceRecordListItemDto | null;
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'close'): void;
+  (event: 'submit'): void;
+  (event: 'update:voidReason', value: string): void;
+}>();
+
+function toStringValue(value: string | undefined) {
+  return String(value ?? '');
+}
+</script>
+
+<template>
+  <Modal
+    :open="props.open"
+    title="确认作废发票"
+    ok-text="确认作废"
+    cancel-text="取消"
+    ok-type="danger"
+    :confirm-loading="props.submitting"
+    @ok="emit('submit')"
+    @cancel="emit('close')"
+  >
+    <div class="fi-void-modal">
+      <p class="fi-void-warning">发票作废后不可恢复，请确认本次操作。</p>
+
+      <div class="fi-void-summary">
+        <div class="fi-void-line">
+          <span class="label">发票号码</span>
+          <span class="value fi-mono">{{ props.targetRecord?.invoiceNo || '--' }}</span>
+        </div>
+        <div class="fi-void-line">
+          <span class="label">公司抬头</span>
+          <span class="value">{{ props.targetRecord?.companyName || '--' }}</span>
+        </div>
+        <div class="fi-void-line">
+          <span class="label">开票金额</span>
+          <span class="value">{{ formatCurrency(Number(props.targetRecord?.amount || 0)) }}</span>
+        </div>
+      </div>
+
+      <Input.TextArea
+        :value="props.form.voidReason"
+        :rows="4"
+        :maxlength="200"
+        show-count
+        placeholder="请输入作废原因"
+        @update:value="(value) => emit('update:voidReason', toStringValue(value))"
+      />
+    </div>
+  </Modal>
+</template>

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

@@ -0,0 +1,108 @@
+import type {
+  FinanceInvoiceSettingFormState,
+  FinanceInvoiceTabKey,
+  OptionItem,
+} from '../../types';
+
+/**
+ * 文件职责：发票管理页面常量定义。
+ */
+import type { FinanceInvoiceStatsDto } from '#/api/finance';
+
+import { getMonthFirstDateString, getTodayDateString } from './helpers';
+
+/** 发票管理页面查看权限。 */
+export const FINANCE_INVOICE_VIEW_PERMISSION = 'tenant:finance:invoice:view';
+
+/** 发票开票权限。 */
+export const FINANCE_INVOICE_ISSUE_PERMISSION = 'tenant:finance:invoice:issue';
+
+/** 发票作废权限。 */
+export const FINANCE_INVOICE_VOID_PERMISSION = 'tenant:finance:invoice:void';
+
+/** 发票设置权限。 */
+export const FINANCE_INVOICE_SETTINGS_PERMISSION =
+  'tenant:finance:invoice:settings';
+
+/** 分段选项。 */
+export const INVOICE_TAB_OPTIONS: Array<{
+  label: string;
+  value: FinanceInvoiceTabKey;
+}> = [
+  { label: '开票记录', value: 'records' },
+  { label: '发票设置', value: 'settings' },
+];
+
+/** 发票状态筛选项。 */
+export const INVOICE_STATUS_OPTIONS: OptionItem[] = [
+  { label: '全部状态', value: 'all' },
+  { label: '待开票', value: 'pending' },
+  { label: '已开票', value: 'issued' },
+  { label: '已作废', value: 'voided' },
+];
+
+/** 发票类型筛选项。 */
+export const INVOICE_TYPE_OPTIONS: OptionItem[] = [
+  { label: '全部类型', value: 'all' },
+  { label: '普通发票', value: 'normal' },
+  { label: '专用发票', value: 'special' },
+];
+
+/** 默认统计数据。 */
+export const DEFAULT_INVOICE_STATS: FinanceInvoiceStatsDto = {
+  currentMonthIssuedAmount: 0,
+  currentMonthIssuedCount: 0,
+  pendingCount: 0,
+  voidedCount: 0,
+};
+
+/** 创建默认筛选条件。 */
+export function createDefaultFilters() {
+  return {
+    startDate: getMonthFirstDateString(),
+    endDate: getTodayDateString(),
+    status: 'all',
+    invoiceType: 'all',
+    keyword: '',
+  };
+}
+
+/** 创建默认分页。 */
+export function createDefaultPagination() {
+  return {
+    page: 1,
+    pageSize: 10,
+    totalCount: 0,
+  };
+}
+
+/** 创建默认设置表单。 */
+export function createDefaultSettingsForm(): FinanceInvoiceSettingFormState {
+  return {
+    companyName: '',
+    taxpayerNumber: '',
+    registeredAddress: '',
+    registeredPhone: '',
+    bankName: '',
+    bankAccount: '',
+    enableElectronicNormalInvoice: true,
+    enableElectronicSpecialInvoice: false,
+    enableAutoIssue: false,
+    autoIssueMaxAmount: 10_000,
+  };
+}
+
+/** 创建默认开票表单。 */
+export function createDefaultIssueForm() {
+  return {
+    contactEmail: '',
+    issueRemark: '',
+  };
+}
+
+/** 创建默认作废表单。 */
+export function createDefaultVoidForm() {
+  return {
+    voidReason: '',
+  };
+}

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

@@ -0,0 +1,126 @@
+import type {
+  FinanceInvoiceRecordListItemDto,
+  FinanceInvoiceSettingDto,
+  FinanceInvoiceStatsDto,
+} from '#/api/finance';
+import type {
+  FinanceInvoiceFilterState,
+  FinanceInvoicePaginationState,
+  FinanceInvoiceSettingFormState,
+} from '../../types';
+
+/**
+ * 文件职责：发票管理页面数据加载动作。
+ */
+import {
+  getFinanceInvoiceRecordListApi,
+  getFinanceInvoiceSettingDetailApi,
+} from '#/api/finance';
+
+import {
+  applySettingDtoToForm,
+  buildInvoiceListQuery,
+  cloneSettingsForm,
+} from './helpers';
+
+interface DataActionOptions {
+  canViewRecords: { value: boolean };
+  canViewSettings: { value: boolean };
+  createDefaultSettingsForm: () => FinanceInvoiceSettingFormState;
+  filters: FinanceInvoiceFilterState;
+  isListLoading: { value: boolean };
+  isSettingsLoading: { value: boolean };
+  pagination: FinanceInvoicePaginationState;
+  rows: { value: FinanceInvoiceRecordListItemDto[] };
+  settingForm: FinanceInvoiceSettingFormState;
+  settingSnapshot: { value: FinanceInvoiceSettingFormState };
+  stats: FinanceInvoiceStatsDto;
+}
+
+/** 创建页面数据动作。 */
+export function createDataActions(options: DataActionOptions) {
+  function resetStats() {
+    options.stats.currentMonthIssuedAmount = 0;
+    options.stats.currentMonthIssuedCount = 0;
+    options.stats.pendingCount = 0;
+    options.stats.voidedCount = 0;
+  }
+
+  function clearRecordData() {
+    options.rows.value = [];
+    options.pagination.totalCount = 0;
+    resetStats();
+  }
+
+  function resetSettings() {
+    const defaults = options.createDefaultSettingsForm();
+    Object.assign(options.settingForm, defaults);
+    options.settingSnapshot.value = cloneSettingsForm(defaults);
+  }
+
+  function applySettingsResult(result: FinanceInvoiceSettingDto) {
+    applySettingDtoToForm(options.settingForm, result);
+    options.settingSnapshot.value = cloneSettingsForm(options.settingForm);
+  }
+
+  async function loadRecordList() {
+    if (!options.canViewRecords.value) {
+      clearRecordData();
+      return;
+    }
+
+    options.isListLoading.value = true;
+    try {
+      const result = await getFinanceInvoiceRecordListApi(
+        buildInvoiceListQuery(options.filters, options.pagination),
+      );
+
+      options.rows.value = result.items;
+      options.pagination.page = result.page;
+      options.pagination.pageSize = result.pageSize;
+      options.pagination.totalCount = result.totalCount;
+
+      options.stats.currentMonthIssuedAmount =
+        result.stats.currentMonthIssuedAmount;
+      options.stats.currentMonthIssuedCount = result.stats.currentMonthIssuedCount;
+      options.stats.pendingCount = result.stats.pendingCount;
+      options.stats.voidedCount = result.stats.voidedCount;
+    } finally {
+      options.isListLoading.value = false;
+    }
+  }
+
+  async function loadSettings() {
+    if (!options.canViewSettings.value) {
+      resetSettings();
+      return;
+    }
+
+    options.isSettingsLoading.value = true;
+    try {
+      const result = await getFinanceInvoiceSettingDetailApi();
+      applySettingsResult(result);
+    } finally {
+      options.isSettingsLoading.value = false;
+    }
+  }
+
+  function clearByPermission() {
+    if (!options.canViewRecords.value) {
+      clearRecordData();
+    }
+
+    if (!options.canViewSettings.value) {
+      resetSettings();
+    }
+  }
+
+  return {
+    applySettingsResult,
+    clearByPermission,
+    clearRecordData,
+    loadRecordList,
+    loadSettings,
+    resetSettings,
+  };
+}

apps/web-antd/src/views/finance/invoice/composables/invoice-page/drawer-actions.ts

@@ -0,0 +1,253 @@
+import type {
+  FinanceInvoiceIssueResultDto,
+  FinanceInvoiceRecordDetailDto,
+  FinanceInvoiceRecordListItemDto,
+} from '#/api/finance';
+import type {
+  FinanceInvoiceIssueFormState,
+  FinanceInvoiceVoidFormState,
+} from '../../types';
+
+/**
+ * 文件职责：发票管理页面抽屉与弹窗动作。
+ */
+import {
+  getFinanceInvoiceRecordDetailApi,
+  issueFinanceInvoiceRecordApi,
+  voidFinanceInvoiceRecordApi,
+} from '#/api/finance';
+
+import { message } from 'ant-design-vue';
+
+import { isPendingInvoice, toOptionalTrimmed } from './helpers';
+
+interface DrawerActionOptions {
+  canIssue: { value: boolean };
+  canVoid: { value: boolean };
+  detail: { value: FinanceInvoiceRecordDetailDto | null };
+  isDetailDrawerOpen: { value: boolean };
+  isDetailLoading: { value: boolean };
+  isIssueDetailLoading: { value: boolean };
+  isIssueDrawerOpen: { value: boolean };
+  isIssueResultModalOpen: { value: boolean };
+  isIssueSubmitting: { value: boolean };
+  isVoidModalOpen: { value: boolean };
+  isVoidSubmitting: { value: boolean };
+  issueDetail: { value: FinanceInvoiceRecordDetailDto | null };
+  issueForm: FinanceInvoiceIssueFormState;
+  issueResult: { value: FinanceInvoiceIssueResultDto | null };
+  issueTargetRecord: { value: FinanceInvoiceRecordListItemDto | null };
+  reloadRecordList: () => Promise<void>;
+  voidForm: FinanceInvoiceVoidFormState;
+  voidTargetRecord: { value: FinanceInvoiceRecordListItemDto | null };
+}
+
+/** 创建抽屉与弹窗动作。 */
+export function createDrawerActions(options: DrawerActionOptions) {
+  async function loadDetail(recordId: string) {
+    const result = await getFinanceInvoiceRecordDetailApi({ recordId });
+    options.detail.value = result;
+    return result;
+  }
+
+  function setDetailDrawerOpen(value: boolean) {
+    options.isDetailDrawerOpen.value = value;
+    if (!value) {
+      options.detail.value = null;
+    }
+  }
+
+  function setIssueDrawerOpen(value: boolean) {
+    options.isIssueDrawerOpen.value = value;
+    if (!value) {
+      options.issueTargetRecord.value = null;
+      options.issueDetail.value = null;
+      options.issueForm.contactEmail = '';
+      options.issueForm.issueRemark = '';
+    }
+  }
+
+  function setVoidModalOpen(value: boolean) {
+    options.isVoidModalOpen.value = value;
+    if (!value) {
+      options.voidTargetRecord.value = null;
+      options.voidForm.voidReason = '';
+    }
+  }
+
+  function setIssueResultModalOpen(value: boolean) {
+    options.isIssueResultModalOpen.value = value;
+    if (!value) {
+      options.issueResult.value = null;
+    }
+  }
+
+  async function openDetail(recordId: string) {
+    if (!recordId) {
+      return;
+    }
+
+    options.isDetailDrawerOpen.value = true;
+    options.isDetailLoading.value = true;
+    try {
+      await loadDetail(recordId);
+    } finally {
+      options.isDetailLoading.value = false;
+    }
+  }
+
+  async function openIssue(record: FinanceInvoiceRecordListItemDto) {
+    if (!options.canIssue.value) {
+      message.warning('当前账号暂无开票权限');
+      return;
+    }
+
+    if (!isPendingInvoice(record.status)) {
+      message.warning('仅待开票记录可执行开票');
+      return;
+    }
+
+    options.issueTargetRecord.value = record;
+    options.issueForm.contactEmail = '';
+    options.issueForm.issueRemark = '';
+    options.issueDetail.value = null;
+    options.isIssueDrawerOpen.value = true;
+
+    options.isIssueDetailLoading.value = true;
+    try {
+      const detail = await getFinanceInvoiceRecordDetailApi({
+        recordId: record.recordId,
+      });
+      options.issueDetail.value = detail;
+      options.issueForm.contactEmail = detail.contactEmail ?? '';
+    } finally {
+      options.isIssueDetailLoading.value = false;
+    }
+  }
+
+  async function refreshOpenDetailAfterMutation(recordId: string) {
+    if (!options.isDetailDrawerOpen.value) {
+      return;
+    }
+
+    if (options.detail.value?.recordId !== recordId) {
+      return;
+    }
+
+    options.isDetailLoading.value = true;
+    try {
+      await loadDetail(recordId);
+    } finally {
+      options.isDetailLoading.value = false;
+    }
+  }
+
+  async function submitIssue() {
+    if (!options.canIssue.value) {
+      message.warning('当前账号暂无开票权限');
+      return;
+    }
+
+    const target = options.issueTargetRecord.value;
+    if (!target?.recordId) {
+      message.warning('请选择待开票记录');
+      return;
+    }
+
+    if (!isPendingInvoice(target.status)) {
+      message.warning('当前记录状态不可开票');
+      return;
+    }
+
+    const email = options.issueForm.contactEmail.trim();
+    if (email && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
+      message.warning('请填写正确的邮箱地址');
+      return;
+    }
+
+    options.isIssueSubmitting.value = true;
+    try {
+      const result = await issueFinanceInvoiceRecordApi({
+        recordId: target.recordId,
+        contactEmail: toOptionalTrimmed(options.issueForm.contactEmail),
+        issueRemark: toOptionalTrimmed(options.issueForm.issueRemark),
+      });
+
+      options.issueResult.value = result;
+      options.isIssueDrawerOpen.value = false;
+      options.isIssueResultModalOpen.value = true;
+      message.success('发票开具成功');
+
+      await options.reloadRecordList();
+      await refreshOpenDetailAfterMutation(target.recordId);
+    } finally {
+      options.isIssueSubmitting.value = false;
+    }
+  }
+
+  function openVoid(record: FinanceInvoiceRecordListItemDto) {
+    if (!options.canVoid.value) {
+      message.warning('当前账号暂无作废权限');
+      return;
+    }
+
+    options.voidTargetRecord.value = record;
+    options.voidForm.voidReason = '';
+    options.isVoidModalOpen.value = true;
+  }
+
+  async function submitVoid() {
+    if (!options.canVoid.value) {
+      message.warning('当前账号暂无作废权限');
+      return;
+    }
+
+    const target = options.voidTargetRecord.value;
+    if (!target?.recordId) {
+      message.warning('请选择需要作废的发票');
+      return;
+    }
+
+    const reason = options.voidForm.voidReason.trim();
+    if (!reason) {
+      message.warning('请填写作废原因');
+      return;
+    }
+
+    options.isVoidSubmitting.value = true;
+    try {
+      const detail = await voidFinanceInvoiceRecordApi({
+        recordId: target.recordId,
+        voidReason: reason,
+      });
+
+      message.success('发票已作废');
+      options.isVoidModalOpen.value = false;
+      options.voidTargetRecord.value = null;
+      options.voidForm.voidReason = '';
+
+      if (
+        options.isDetailDrawerOpen.value &&
+        options.detail.value?.recordId === detail.recordId
+      ) {
+        options.detail.value = detail;
+      }
+
+      await options.reloadRecordList();
+    } finally {
+      options.isVoidSubmitting.value = false;
+    }
+  }
+
+  return {
+    openDetail,
+    openIssue,
+    openVoid,
+    setDetailDrawerOpen,
+    setIssueDrawerOpen,
+    setIssueResultModalOpen,
+    setVoidModalOpen,
+    submitIssue,
+    submitVoid,
+  };
+}

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

@@ -0,0 +1,173 @@
+import type {
+  FinanceInvoiceRecordListQuery,
+  FinanceInvoiceSettingDto,
+  FinanceInvoiceStatusFilter,
+  FinanceInvoiceTypeFilter,
+} from '#/api/finance';
+import type {
+  FinanceInvoiceFilterState,
+  FinanceInvoicePaginationState,
+  FinanceInvoiceSettingFormState,
+} from '../../types';
+
+/**
+ * 文件职责：发票管理页面纯函数工具。
+ */
+
+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 normalizeStatus(
+  status: FinanceInvoiceStatusFilter,
+): Exclude<FinanceInvoiceStatusFilter, 'all'> | undefined {
+  return status === 'all' ? undefined : status;
+}
+
+function normalizeInvoiceType(
+  invoiceType: FinanceInvoiceTypeFilter,
+): Exclude<FinanceInvoiceTypeFilter, 'all'> | undefined {
+  return invoiceType === 'all' ? undefined : invoiceType;
+}
+
+/** 获取今天日期字符串（yyyy-MM-dd）。 */
+export function getTodayDateString() {
+  return formatDate(new Date());
+}
+
+/** 获取当月第一天日期字符串（yyyy-MM-dd）。 */
+export function getMonthFirstDateString() {
+  const now = new Date();
+  return formatDate(new Date(now.getFullYear(), now.getMonth(), 1));
+}
+
+/** 构建发票记录列表查询参数。 */
+export function buildInvoiceListQuery(
+  filters: FinanceInvoiceFilterState,
+  pagination: FinanceInvoicePaginationState,
+): FinanceInvoiceRecordListQuery {
+  return {
+    page: pagination.page,
+    pageSize: pagination.pageSize,
+    startDate: filters.startDate || undefined,
+    endDate: filters.endDate || undefined,
+    status: normalizeStatus(filters.status),
+    invoiceType: normalizeInvoiceType(filters.invoiceType),
+    keyword: filters.keyword.trim() || undefined,
+  };
+}
+
+/** 判断日期范围是否合法。 */
+export function isDateRangeInvalid(filters: FinanceInvoiceFilterState) {
+  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 resolveInvoiceTypeTagColor(type: string) {
+  if (type === 'normal') return 'blue';
+  if (type === 'special') return 'purple';
+  return 'default';
+}
+
+/** 发票状态标签颜色。 */
+export function resolveInvoiceStatusTagColor(status: string) {
+  if (status === 'pending') return 'orange';
+  if (status === 'issued') return 'green';
+  if (status === 'voided') return 'default';
+  return 'default';
+}
+
+/** 是否为待开票状态。 */
+export function isPendingInvoice(status: string) {
+  return status === 'pending';
+}
+
+/** 是否为已开票状态。 */
+export function isIssuedInvoice(status: string) {
+  return status === 'issued';
+}
+
+/** 应用设置 DTO 到表单。 */
+export function applySettingDtoToForm(
+  target: FinanceInvoiceSettingFormState,
+  source: FinanceInvoiceSettingDto,
+) {
+  target.companyName = source.companyName || '';
+  target.taxpayerNumber = source.taxpayerNumber || '';
+  target.registeredAddress = source.registeredAddress || '';
+  target.registeredPhone = source.registeredPhone || '';
+  target.bankName = source.bankName || '';
+  target.bankAccount = source.bankAccount || '';
+  target.enableElectronicNormalInvoice = Boolean(
+    source.enableElectronicNormalInvoice,
+  );
+  target.enableElectronicSpecialInvoice = Boolean(
+    source.enableElectronicSpecialInvoice,
+  );
+  target.enableAutoIssue = Boolean(source.enableAutoIssue);
+  target.autoIssueMaxAmount = Number(source.autoIssueMaxAmount || 0);
+}
+
+/** 深拷贝设置表单快照。 */
+export function cloneSettingsForm(
+  source: FinanceInvoiceSettingFormState,
+): FinanceInvoiceSettingFormState {
+  return {
+    companyName: source.companyName,
+    taxpayerNumber: source.taxpayerNumber,
+    registeredAddress: source.registeredAddress,
+    registeredPhone: source.registeredPhone,
+    bankName: source.bankName,
+    bankAccount: source.bankAccount,
+    enableElectronicNormalInvoice: source.enableElectronicNormalInvoice,
+    enableElectronicSpecialInvoice: source.enableElectronicSpecialInvoice,
+    enableAutoIssue: source.enableAutoIssue,
+    autoIssueMaxAmount: source.autoIssueMaxAmount,
+  };
+}
+
+/** 比较设置表单是否发生变化。 */
+export function isSettingsChanged(
+  current: FinanceInvoiceSettingFormState,
+  snapshot: FinanceInvoiceSettingFormState,
+) {
+  return JSON.stringify(current) !== JSON.stringify(snapshot);
+}
+
+/** 生成保存设置请求体。 */
+export function buildSettingSavePayload(form: FinanceInvoiceSettingFormState) {
+  return {
+    companyName: form.companyName.trim(),
+    taxpayerNumber: form.taxpayerNumber.trim(),
+    registeredAddress: form.registeredAddress.trim() || undefined,
+    registeredPhone: form.registeredPhone.trim() || undefined,
+    bankName: form.bankName.trim() || undefined,
+    bankAccount: form.bankAccount.trim() || undefined,
+    enableElectronicNormalInvoice: form.enableElectronicNormalInvoice,
+    enableElectronicSpecialInvoice: form.enableElectronicSpecialInvoice,
+    enableAutoIssue: form.enableAutoIssue,
+    autoIssueMaxAmount: Number(form.autoIssueMaxAmount || 0),
+  };
+}
+
+/** 文本转空值。 */
+export function toOptionalTrimmed(value: string) {
+  const normalized = value.trim();
+  return normalized ? normalized : undefined;
+}

apps/web-antd/src/views/finance/invoice/composables/invoice-page/settings-actions.ts

@@ -0,0 +1,120 @@
+import type { FinanceInvoiceSettingFormState } from '../../types';
+
+/**
+ * 文件职责：发票设置保存与确认动作。
+ */
+import type { FinanceInvoiceSettingDto } from '#/api/finance';
+
+import { saveFinanceInvoiceSettingApi } from '#/api/finance';
+
+import { message } from 'ant-design-vue';
+
+import {
+  buildSettingSavePayload,
+  cloneSettingsForm,
+  isSettingsChanged,
+} from './helpers';
+
+interface SettingsActionOptions {
+  applySettingsResult: (result: FinanceInvoiceSettingDto) => void;
+  canManageSettings: { value: boolean };
+  isSettingsConfirmModalOpen: { value: boolean };
+  isSettingsSaving: { value: boolean };
+  settingForm: FinanceInvoiceSettingFormState;
+  settingSnapshot: { value: FinanceInvoiceSettingFormState };
+}
+
+/** 创建发票设置动作。 */
+export function createSettingsActions(options: SettingsActionOptions) {
+  function setSettingsConfirmModalOpen(value: boolean) {
+    options.isSettingsConfirmModalOpen.value = value;
+  }
+
+  function resetSettings() {
+    Object.assign(options.settingForm, cloneSettingsForm(options.settingSnapshot.value));
+  }
+
+  function hasSettingsChanged() {
+    return isSettingsChanged(options.settingForm, options.settingSnapshot.value);
+  }
+
+  function validateSettings() {
+    if (!options.settingForm.companyName.trim()) {
+      message.warning('请输入企业名称');
+      return false;
+    }
+
+    if (!options.settingForm.taxpayerNumber.trim()) {
+      message.warning('请输入纳税人识别号');
+      return false;
+    }
+
+    if (
+      !options.settingForm.enableElectronicNormalInvoice &&
+      !options.settingForm.enableElectronicSpecialInvoice
+    ) {
+      message.warning('请至少启用一种发票类型');
+      return false;
+    }
+
+    if (options.settingForm.enableAutoIssue) {
+      const maxAmount = Number(options.settingForm.autoIssueMaxAmount || 0);
+      if (!Number.isFinite(maxAmount) || maxAmount <= 0) {
+        message.warning('自动开票最大金额必须大于 0');
+        return false;
+      }
+    }
+
+    return true;
+  }
+
+  function openSettingsConfirmModal() {
+    if (!options.canManageSettings.value) {
+      message.warning('当前账号暂无发票设置权限');
+      return;
+    }
+
+    if (!validateSettings()) {
+      return;
+    }
+
+    if (!hasSettingsChanged()) {
+      message.info('未检测到设置变更');
+      return;
+    }
+
+    options.isSettingsConfirmModalOpen.value = true;
+  }
+
+  async function submitSettings() {
+    if (!options.canManageSettings.value) {
+      message.warning('当前账号暂无发票设置权限');
+      return;
+    }
+
+    if (!validateSettings()) {
+      return;
+    }
+
+    options.isSettingsSaving.value = true;
+    try {
+      const result = await saveFinanceInvoiceSettingApi(
+        buildSettingSavePayload(options.settingForm),
+      );
+      options.applySettingsResult(result);
+      options.isSettingsConfirmModalOpen.value = false;
+      message.success('发票设置已保存');
+    } finally {
+      options.isSettingsSaving.value = false;
+    }
+  }
+
+  return {
+    hasSettingsChanged,
+    openSettingsConfirmModal,
+    resetSettings,
+    setSettingsConfirmModalOpen,
+    submitSettings,
+    validateSettings,
+  };
+}

apps/web-antd/src/views/finance/invoice/composables/useFinanceInvoicePage.ts

@@ -0,0 +1,397 @@
+/**
+ * 文件职责：发票管理页面状态与动作编排。
+ */
+import type {
+  FinanceInvoiceIssueResultDto,
+  FinanceInvoiceRecordDetailDto,
+  FinanceInvoiceRecordListItemDto,
+  FinanceInvoiceStatsDto,
+} from '#/api/finance';
+import type {
+  FinanceInvoiceFilterState,
+  FinanceInvoiceIssueFormState,
+  FinanceInvoicePaginationState,
+  FinanceInvoiceSettingFormState,
+  FinanceInvoiceTabKey,
+  FinanceInvoiceVoidFormState,
+} from '../types';
+
+import { computed, onActivated, onMounted, reactive, ref, watch } from 'vue';
+
+import { useAccessStore } from '@vben/stores';
+
+import { message } from 'ant-design-vue';
+
+import {
+  createDefaultFilters,
+  createDefaultIssueForm,
+  createDefaultPagination,
+  createDefaultSettingsForm,
+  createDefaultVoidForm,
+  DEFAULT_INVOICE_STATS,
+  FINANCE_INVOICE_ISSUE_PERMISSION,
+  FINANCE_INVOICE_SETTINGS_PERMISSION,
+  FINANCE_INVOICE_VIEW_PERMISSION,
+  FINANCE_INVOICE_VOID_PERMISSION,
+  INVOICE_TAB_OPTIONS,
+} from './invoice-page/constants';
+import { createDataActions } from './invoice-page/data-actions';
+import { createDrawerActions } from './invoice-page/drawer-actions';
+import { isDateRangeInvalid } from './invoice-page/helpers';
+import { createSettingsActions } from './invoice-page/settings-actions';
+
+/** 创建发票管理页面组合状态。 */
+export function useFinanceInvoicePage() {
+  const accessStore = useAccessStore();
+
+  const activeTab = ref<FinanceInvoiceTabKey>('records');
+
+  const filters = reactive<FinanceInvoiceFilterState>(
+    createDefaultFilters() as FinanceInvoiceFilterState,
+  );
+  const pagination = reactive<FinanceInvoicePaginationState>(
+    createDefaultPagination(),
+  );
+  const rows = ref<FinanceInvoiceRecordListItemDto[]>([]);
+
+  const stats = reactive<FinanceInvoiceStatsDto>({ ...DEFAULT_INVOICE_STATS });
+
+  const settingForm = reactive<FinanceInvoiceSettingFormState>(
+    createDefaultSettingsForm(),
+  );
+  const settingSnapshot = ref<FinanceInvoiceSettingFormState>(
+    createDefaultSettingsForm(),
+  );
+
+  const issueForm = reactive<FinanceInvoiceIssueFormState>(
+    createDefaultIssueForm(),
+  );
+  const voidForm = reactive<FinanceInvoiceVoidFormState>(createDefaultVoidForm());
+
+  const detail = ref<FinanceInvoiceRecordDetailDto | null>(null);
+  const issueDetail = ref<FinanceInvoiceRecordDetailDto | null>(null);
+  const issueResult = ref<FinanceInvoiceIssueResultDto | null>(null);
+
+  const issueTargetRecord = ref<FinanceInvoiceRecordListItemDto | null>(null);
+  const voidTargetRecord = ref<FinanceInvoiceRecordListItemDto | null>(null);
+
+  const isListLoading = ref(false);
+  const isSettingsLoading = ref(false);
+  const isDetailLoading = ref(false);
+  const isIssueDetailLoading = ref(false);
+  const isIssueSubmitting = ref(false);
+  const isVoidSubmitting = ref(false);
+  const isSettingsSaving = ref(false);
+
+  const isDetailDrawerOpen = ref(false);
+  const isIssueDrawerOpen = ref(false);
+  const isVoidModalOpen = ref(false);
+  const isIssueResultModalOpen = ref(false);
+  const isSettingsConfirmModalOpen = ref(false);
+
+  const accessCodeSet = computed(
+    () => new Set((accessStore.accessCodes ?? []).map(String)),
+  );
+
+  const canViewRecords = computed(() => {
+    const accessCodes = accessCodeSet.value;
+    return (
+      accessCodes.has(FINANCE_INVOICE_VIEW_PERMISSION) ||
+      accessCodes.has(FINANCE_INVOICE_ISSUE_PERMISSION) ||
+      accessCodes.has(FINANCE_INVOICE_VOID_PERMISSION)
+    );
+  });
+
+  const canIssue = computed(() =>
+    accessCodeSet.value.has(FINANCE_INVOICE_ISSUE_PERMISSION),
+  );
+
+  const canVoid = computed(() =>
+    accessCodeSet.value.has(FINANCE_INVOICE_VOID_PERMISSION),
+  );
+
+  const canViewSettings = computed(() => {
+    const accessCodes = accessCodeSet.value;
+    return (
+      accessCodes.has(FINANCE_INVOICE_VIEW_PERMISSION) ||
+      accessCodes.has(FINANCE_INVOICE_SETTINGS_PERMISSION)
+    );
+  });
+
+  const canManageSettings = computed(() =>
+    accessCodeSet.value.has(FINANCE_INVOICE_SETTINGS_PERMISSION),
+  );
+
+  const canViewPage = computed(
+    () => canViewRecords.value || canViewSettings.value,
+  );
+
+  const tabOptions = computed(() =>
+    INVOICE_TAB_OPTIONS.filter((item) => {
+      if (item.value === 'records') {
+        return canViewRecords.value;
+      }
+      if (item.value === 'settings') {
+        return canViewSettings.value;
+      }
+      return false;
+    }),
+  );
+
+  const {
+    applySettingsResult,
+    clearByPermission,
+    clearRecordData,
+    loadRecordList,
+    loadSettings,
+  } = createDataActions({
+    canViewRecords,
+    canViewSettings,
+    createDefaultSettingsForm,
+    filters,
+    isListLoading,
+    isSettingsLoading,
+    pagination,
+    rows,
+    settingForm,
+    settingSnapshot,
+    stats,
+  });
+
+  const {
+    openDetail,
+    openIssue,
+    openVoid,
+    setDetailDrawerOpen,
+    setIssueDrawerOpen,
+    setIssueResultModalOpen,
+    setVoidModalOpen,
+    submitIssue,
+    submitVoid,
+  } = createDrawerActions({
+    canIssue,
+    canVoid,
+    detail,
+    isDetailDrawerOpen,
+    isDetailLoading,
+    isIssueDetailLoading,
+    isIssueDrawerOpen,
+    isIssueResultModalOpen,
+    isIssueSubmitting,
+    isVoidModalOpen,
+    isVoidSubmitting,
+    issueDetail,
+    issueForm,
+    issueResult,
+    issueTargetRecord,
+    reloadRecordList: loadRecordList,
+    voidForm,
+    voidTargetRecord,
+  });
+
+  const {
+    hasSettingsChanged,
+    openSettingsConfirmModal,
+    resetSettings,
+    setSettingsConfirmModalOpen,
+    submitSettings,
+  } = createSettingsActions({
+    applySettingsResult,
+    canManageSettings,
+    isSettingsConfirmModalOpen,
+    isSettingsSaving,
+    settingForm,
+    settingSnapshot,
+  });
+
+  function setActiveTab(value: FinanceInvoiceTabKey) {
+    activeTab.value = value;
+  }
+
+  function setStartDate(value: string) {
+    filters.startDate = value;
+  }
+
+  function setEndDate(value: string) {
+    filters.endDate = value;
+  }
+
+  function setStatus(value: string) {
+    filters.status = (value || 'all') as FinanceInvoiceFilterState['status'];
+  }
+
+  function setInvoiceType(value: string) {
+    filters.invoiceType = (value || 'all') as FinanceInvoiceFilterState['invoiceType'];
+  }
+
+  function setKeyword(value: string) {
+    filters.keyword = value;
+  }
+
+  function setIssueFormContactEmail(value: string) {
+    issueForm.contactEmail = value;
+  }
+
+  function setIssueFormRemark(value: string) {
+    issueForm.issueRemark = value;
+  }
+
+  function setVoidReason(value: string) {
+    voidForm.voidReason = value;
+  }
+
+  function setSettingsField<K extends keyof FinanceInvoiceSettingFormState>(
+    field: K,
+    value: FinanceInvoiceSettingFormState[K],
+  ) {
+    settingForm[field] = value;
+  }
+
+  async function handleSearch() {
+    if (isDateRangeInvalid(filters)) {
+      message.warning('开始日期不能晚于结束日期');
+      return;
+    }
+
+    pagination.page = 1;
+    await loadRecordList();
+  }
+
+  async function handlePageChange(page: number, pageSize: number) {
+    pagination.page = page;
+    pagination.pageSize = pageSize;
+    await loadRecordList();
+  }
+
+  function closeTransientPanels() {
+    setDetailDrawerOpen(false);
+    setIssueDrawerOpen(false);
+    setVoidModalOpen(false);
+    setIssueResultModalOpen(false);
+    setSettingsConfirmModalOpen(false);
+  }
+
+  async function loadByPermission() {
+    const tasks: Array<Promise<void>> = [];
+
+    if (canViewRecords.value) {
+      tasks.push(loadRecordList());
+    } else {
+      clearRecordData();
+    }
+
+    if (canViewSettings.value) {
+      tasks.push(loadSettings());
+    }
+
+    await Promise.all(tasks);
+  }
+
+  watch(tabOptions, (next) => {
+    const values = next.map((item) => item.value);
+    if (values.length === 0) {
+      return;
+    }
+
+    if (!values.includes(activeTab.value)) {
+      activeTab.value = values[0] as FinanceInvoiceTabKey;
+    }
+  });
+
+  watch(
+    canViewPage,
+    async (value, oldValue) => {
+      if (value === oldValue) {
+        return;
+      }
+
+      if (!value) {
+        clearByPermission();
+        closeTransientPanels();
+        return;
+      }
+
+      await loadByPermission();
+    },
+    { immediate: false },
+  );
+
+  onMounted(async () => {
+    if (!canViewPage.value) {
+      clearByPermission();
+      closeTransientPanels();
+      return;
+    }
+
+    await loadByPermission();
+  });
+
+  onActivated(() => {
+    if (!canViewPage.value) {
+      return;
+    }
+
+    void loadByPermission();
+  });
+
+  return {
+    activeTab,
+    canIssue,
+    canManageSettings,
+    canViewPage,
+    canViewRecords,
+    canViewSettings,
+    canVoid,
+    detail,
+    filters,
+    handlePageChange,
+    handleSearch,
+    hasSettingsChanged,
+    isDetailDrawerOpen,
+    isDetailLoading,
+    isIssueDetailLoading,
+    isIssueDrawerOpen,
+    isIssueResultModalOpen,
+    isIssueSubmitting,
+    isListLoading,
+    isSettingsConfirmModalOpen,
+    isSettingsLoading,
+    isSettingsSaving,
+    isVoidModalOpen,
+    isVoidSubmitting,
+    issueDetail,
+    issueForm,
+    issueResult,
+    issueTargetRecord,
+    openDetail,
+    openIssue,
+    openSettingsConfirmModal,
+    openVoid,
+    pagination,
+    resetSettings,
+    rows,
+    setActiveTab,
+    setDetailDrawerOpen,
+    setEndDate,
+    setInvoiceType,
+    setIssueDrawerOpen,
+    setIssueFormContactEmail,
+    setIssueFormRemark,
+    setIssueResultModalOpen,
+    setKeyword,
+    setSettingsConfirmModalOpen,
+    setSettingsField,
+    setStartDate,
+    setStatus,
+    setVoidModalOpen,
+    setVoidReason,
+    settingForm,
+    stats,
+    submitIssue,
+    submitSettings,
+    submitVoid,
+    tabOptions,
+    voidForm,
+    voidTargetRecord,
+  };
+}

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

@@ -0,0 +1,198 @@
+<script setup lang="ts">
+/**
+ * 文件职责：财务中心发票管理页面入口编排。
+ */
+import { Page } from '@vben/common-ui';
+
+import { Empty, Spin } from 'ant-design-vue';
+
+import InvoiceDetailDrawer from './components/InvoiceDetailDrawer.vue';
+import InvoiceFilterBar from './components/InvoiceFilterBar.vue';
+import InvoiceIssueDrawer from './components/InvoiceIssueDrawer.vue';
+import InvoiceIssueResultModal from './components/InvoiceIssueResultModal.vue';
+import InvoiceSegmentTabs from './components/InvoiceSegmentTabs.vue';
+import InvoiceSettingsConfirmModal from './components/InvoiceSettingsConfirmModal.vue';
+import InvoiceSettingsPanel from './components/InvoiceSettingsPanel.vue';
+import InvoiceStatsBar from './components/InvoiceStatsBar.vue';
+import InvoiceTableCard from './components/InvoiceTableCard.vue';
+import InvoiceVoidConfirmModal from './components/InvoiceVoidConfirmModal.vue';
+import { useFinanceInvoicePage } from './composables/useFinanceInvoicePage';
+
+const {
+  activeTab,
+  canIssue,
+  canManageSettings,
+  canViewPage,
+  canViewRecords,
+  canViewSettings,
+  canVoid,
+  detail,
+  filters,
+  handlePageChange,
+  handleSearch,
+  isDetailDrawerOpen,
+  isDetailLoading,
+  isIssueDetailLoading,
+  isIssueDrawerOpen,
+  isIssueResultModalOpen,
+  isIssueSubmitting,
+  isListLoading,
+  isSettingsConfirmModalOpen,
+  isSettingsLoading,
+  isSettingsSaving,
+  isVoidModalOpen,
+  isVoidSubmitting,
+  issueDetail,
+  issueForm,
+  issueResult,
+  issueTargetRecord,
+  openDetail,
+  openIssue,
+  openSettingsConfirmModal,
+  openVoid,
+  pagination,
+  resetSettings,
+  rows,
+  setActiveTab,
+  setDetailDrawerOpen,
+  setEndDate,
+  setInvoiceType,
+  setIssueDrawerOpen,
+  setIssueFormContactEmail,
+  setIssueFormRemark,
+  setIssueResultModalOpen,
+  setKeyword,
+  setSettingsConfirmModalOpen,
+  setSettingsField,
+  setStartDate,
+  setStatus,
+  setVoidModalOpen,
+  setVoidReason,
+  settingForm,
+  stats,
+  submitIssue,
+  submitSettings,
+  submitVoid,
+  tabOptions,
+  voidForm,
+  voidTargetRecord,
+} = useFinanceInvoicePage();
+</script>
+
+<template>
+  <Page title="发票管理" content-class="page-finance-invoice">
+    <div class="fi-page">
+      <Empty v-if="!canViewPage" description="暂无发票管理页面访问权限" />
+
+      <template v-else>
+        <InvoiceSegmentTabs
+          :active-tab="activeTab"
+          :options="tabOptions"
+          @update:active-tab="setActiveTab"
+        />
+
+        <section v-show="activeTab === 'records'" class="fi-tab-panel">
+          <template v-if="canViewRecords">
+            <InvoiceStatsBar :stats="stats" />
+
+            <InvoiceFilterBar
+              :filters="filters"
+              @update:start-date="setStartDate"
+              @update:end-date="setEndDate"
+              @update:status="setStatus"
+              @update:invoice-type="setInvoiceType"
+              @update:keyword="setKeyword"
+              @search="handleSearch"
+            />
+
+            <InvoiceTableCard
+              :rows="rows"
+              :loading="isListLoading"
+              :pagination="pagination"
+              :can-issue="canIssue"
+              :can-void="canVoid"
+              @page-change="handlePageChange"
+              @detail="openDetail"
+              @issue="openIssue"
+              @void="openVoid"
+            />
+          </template>
+          <Empty v-else description="暂无开票记录访问权限" />
+        </section>
+
+        <section v-show="activeTab === 'settings'" class="fi-tab-panel">
+          <template v-if="canViewSettings">
+            <Spin :spinning="isSettingsLoading">
+              <InvoiceSettingsPanel
+                :form="settingForm"
+                :can-manage-settings="canManageSettings"
+                :saving="isSettingsSaving"
+                @update:company-name="(value) => setSettingsField('companyName', value)"
+                @update:taxpayer-number="(value) => setSettingsField('taxpayerNumber', value)"
+                @update:registered-address="(value) => setSettingsField('registeredAddress', value)"
+                @update:registered-phone="(value) => setSettingsField('registeredPhone', value)"
+                @update:bank-name="(value) => setSettingsField('bankName', value)"
+                @update:bank-account="(value) => setSettingsField('bankAccount', value)"
+                @update:enable-electronic-normal-invoice="(value) => setSettingsField('enableElectronicNormalInvoice', value)"
+                @update:enable-electronic-special-invoice="(value) => setSettingsField('enableElectronicSpecialInvoice', value)"
+                @update:enable-auto-issue="(value) => setSettingsField('enableAutoIssue', value)"
+                @update:auto-issue-max-amount="(value) => setSettingsField('autoIssueMaxAmount', value)"
+                @reset="resetSettings"
+                @save="openSettingsConfirmModal"
+              />
+            </Spin>
+          </template>
+          <Empty v-else description="暂无发票设置访问权限" />
+        </section>
+      </template>
+    </div>
+
+    <InvoiceIssueDrawer
+      :open="isIssueDrawerOpen"
+      :submitting="isIssueSubmitting"
+      :loading-detail="isIssueDetailLoading"
+      :target-record="issueTargetRecord"
+      :detail="issueDetail"
+      :form="issueForm"
+      @close="setIssueDrawerOpen(false)"
+      @update:contact-email="setIssueFormContactEmail"
+      @update:issue-remark="setIssueFormRemark"
+      @submit="submitIssue"
+    />
+
+    <InvoiceDetailDrawer
+      :open="isDetailDrawerOpen"
+      :loading="isDetailLoading"
+      :detail="detail"
+      @close="setDetailDrawerOpen(false)"
+    />
+
+    <InvoiceVoidConfirmModal
+      :open="isVoidModalOpen"
+      :submitting="isVoidSubmitting"
+      :target-record="voidTargetRecord"
+      :form="voidForm"
+      @close="setVoidModalOpen(false)"
+      @update:void-reason="setVoidReason"
+      @submit="submitVoid"
+    />
+
+    <InvoiceIssueResultModal
+      :open="isIssueResultModalOpen"
+      :result="issueResult"
+      @close="setIssueResultModalOpen(false)"
+    />
+
+    <InvoiceSettingsConfirmModal
+      :open="isSettingsConfirmModalOpen"
+      :submitting="isSettingsSaving"
+      :form="settingForm"
+      @close="setSettingsConfirmModalOpen(false)"
+      @confirm="submitSettings"
+    />
+  </Page>
+</template>
+
+<style lang="less">
+@import './styles/index.less';
+</style>

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

@@ -0,0 +1,24 @@
+/**
+ * 文件职责：发票管理页面基础样式。
+ */
+.page-finance-invoice {
+  .ant-card {
+    border-radius: 10px;
+  }
+}
+
+.fi-page {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.fi-tab-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.fi-mono {
+  font-family: ui-monospace, sfmono-regular, menlo, consolas, monospace;
+}

apps/web-antd/src/views/finance/invoice/styles/drawer.less

@@ -0,0 +1,135 @@
+/**
+ * 文件职责：发票抽屉样式。
+ */
+.page-finance-invoice {
+  .ant-drawer {
+    .ant-drawer-header {
+      padding: 14px 18px;
+      border-bottom: 1px solid #f0f0f0;
+    }
+
+    .ant-drawer-body {
+      padding: 16px 20px;
+    }
+
+    .ant-drawer-footer {
+      padding: 12px 20px;
+      border-top: 1px solid #f0f0f0;
+    }
+  }
+}
+
+.fi-section {
+  margin-bottom: 20px;
+}
+
+.fi-section-title {
+  padding-left: 10px;
+  margin-bottom: 14px;
+  font-size: 14px;
+  font-weight: 600;
+  color: rgb(0 0 0 / 88%);
+  border-left: 3px solid #1677ff;
+}
+
+.fi-info-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 10px 20px;
+  font-size: 13px;
+
+  .label {
+    color: rgb(0 0 0 / 45%);
+  }
+
+  .full {
+    grid-column: 1 / -1;
+  }
+}
+
+.fi-amount-strong {
+  font-weight: 600;
+  color: rgb(0 0 0 / 88%);
+}
+
+.fi-drawer-footer {
+  display: flex;
+  gap: 8px;
+  justify-content: flex-end;
+}
+
+.fi-timeline {
+  position: relative;
+  padding-left: 22px;
+}
+
+.fi-timeline-item {
+  position: relative;
+  display: flex;
+  gap: 8px;
+  align-items: center;
+  padding-bottom: 18px;
+  font-size: 13px;
+
+  &::before {
+    position: absolute;
+    top: 5px;
+    left: -22px;
+    width: 10px;
+    height: 10px;
+    content: '';
+    background: #1677ff;
+    border: 2px solid #d6e4ff;
+    border-radius: 50%;
+  }
+
+  &::after {
+    position: absolute;
+    top: 17px;
+    left: -18px;
+    width: 2px;
+    height: calc(100% - 12px);
+    content: '';
+    background: #e8e8e8;
+  }
+
+  &:last-child {
+    padding-bottom: 0;
+
+    &::after {
+      display: none;
+    }
+  }
+
+  .text {
+    font-weight: 500;
+    color: rgb(0 0 0 / 88%);
+  }
+
+  .time {
+    color: rgb(0 0 0 / 45%);
+  }
+}
+
+.fi-remark-box {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 10px 14px;
+  font-size: 13px;
+  color: rgb(0 0 0 / 65%);
+  background: #fafafa;
+  border: 1px solid #f0f0f0;
+  border-radius: 8px;
+}
+
+.fi-remark-line {
+  display: flex;
+  gap: 8px;
+
+  .label {
+    width: 70px;
+    flex-shrink: 0;
+    color: rgb(0 0 0 / 45%);
+  }
+}

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

@@ -0,0 +1,9 @@
+/**
+ * 文件职责：发票管理页面样式聚合入口。
+ */
+@import './base.less';
+@import './layout.less';
+@import './table.less';
+@import './drawer.less';
+@import './modal.less';
+@import './responsive.less';

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

@@ -0,0 +1,166 @@
+/**
+ * 文件职责：发票管理页面布局样式。
+ */
+.fi-seg-wrap {
+  margin-bottom: 2px;
+}
+
+.fi-stats {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 12px;
+}
+
+.fi-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);
+  }
+
+  &.warn .fi-stat-val {
+    color: #fa8c16;
+  }
+
+  &.danger .fi-stat-val {
+    color: #ff4d4f;
+  }
+}
+
+.fi-stat-label {
+  display: flex;
+  gap: 6px;
+  align-items: center;
+  margin-bottom: 8px;
+  font-size: 13px;
+  color: rgb(0 0 0 / 45%);
+}
+
+.fi-stat-icon {
+  width: 16px;
+  height: 16px;
+}
+
+.fi-stat-val {
+  font-size: 24px;
+  font-weight: 700;
+  line-height: 1.2;
+  color: rgb(0 0 0 / 88%);
+}
+
+.fi-stat-sub {
+  margin-top: 4px;
+  font-size: 12px;
+  color: rgb(0 0 0 / 45%);
+}
+
+.fi-toolbar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 10px;
+  align-items: center;
+  padding: 14px 16px;
+  background: #fff;
+  border: 1px solid #f0f0f0;
+  border-radius: 10px;
+  box-shadow: 0 2px 8px rgb(15 23 42 / 6%);
+
+  .fi-date-input {
+    width: 146px;
+  }
+
+  .fi-status-select,
+  .fi-type-select {
+    width: 124px;
+  }
+
+  .fi-date-sep {
+    font-size: 13px;
+    line-height: 32px;
+    color: rgb(0 0 0 / 45%);
+  }
+
+  .fi-toolbar-spacer {
+    flex: 1;
+  }
+
+  .fi-search {
+    width: 220px;
+  }
+
+  .fi-search-icon {
+    width: 14px;
+    height: 14px;
+    color: rgb(0 0 0 / 45%);
+  }
+
+  .ant-select-selector,
+  .ant-input,
+  .ant-input-affix-wrapper {
+    height: 32px;
+    font-size: 13px;
+  }
+
+  .ant-input-affix-wrapper .ant-input {
+    height: 100%;
+  }
+}
+
+.fi-settings {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.fi-section-hd {
+  padding-left: 10px;
+  margin-bottom: 16px;
+  font-size: 15px;
+  font-weight: 600;
+  color: rgb(0 0 0 / 88%);
+  border-left: 3px solid #1677ff;
+}
+
+.fi-form-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 8px 24px;
+}
+
+.fi-toggle-row {
+  display: flex;
+  gap: 10px;
+  align-items: center;
+  margin-bottom: 14px;
+}
+
+.fi-toggle-label {
+  font-size: 13px;
+  font-weight: 500;
+  color: rgb(0 0 0 / 88%);
+}
+
+.fi-toggle-hint {
+  font-size: 12px;
+  color: rgb(0 0 0 / 45%);
+}
+
+.fi-auto-form {
+  max-width: 340px;
+}
+
+.fi-max-amount-input {
+  width: 100%;
+}
+
+.fi-save-bar {
+  display: flex;
+  gap: 8px;
+  justify-content: flex-end;
+}

apps/web-antd/src/views/finance/invoice/styles/modal.less

@@ -0,0 +1,63 @@
+/**
+ * 文件职责：发票弹窗样式。
+ */
+.fi-void-modal,
+.fi-issue-result,
+.fi-settings-confirm {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.fi-void-warning {
+  margin: 0;
+  font-size: 13px;
+  color: #cf1322;
+}
+
+.fi-void-summary,
+.fi-result-list,
+.fi-settings-list {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 12px 14px;
+  background: #fafafa;
+  border: 1px solid #f0f0f0;
+  border-radius: 8px;
+}
+
+.fi-void-line,
+.fi-result-line,
+.fi-settings-line {
+  display: flex;
+  gap: 16px;
+  justify-content: space-between;
+  font-size: 13px;
+
+  .label {
+    color: rgb(0 0 0 / 45%);
+  }
+
+  .value {
+    color: rgb(0 0 0 / 88%);
+    text-align: right;
+  }
+}
+
+.fi-result-title {
+  font-size: 15px;
+  font-weight: 600;
+  color: #1677ff;
+}
+
+.fi-result-footer {
+  display: flex;
+  justify-content: flex-end;
+}
+
+.fi-settings-desc {
+  margin: 0;
+  font-size: 13px;
+  color: rgb(0 0 0 / 65%);
+}

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

@@ -0,0 +1,47 @@
+/**
+ * 文件职责：发票管理页面响应式样式。
+ */
+@media (max-width: 1600px) {
+  .fi-stats {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+}
+
+@media (max-width: 768px) {
+  .fi-stats {
+    grid-template-columns: 1fr;
+  }
+
+  .fi-toolbar {
+    padding: 14px 12px;
+
+    .fi-date-input,
+    .fi-status-select,
+    .fi-type-select,
+    .fi-search {
+      width: 100%;
+    }
+
+    .fi-date-sep,
+    .fi-toolbar-spacer {
+      display: none;
+    }
+  }
+
+  .fi-form-grid,
+  .fi-info-grid {
+    grid-template-columns: 1fr;
+
+    .full {
+      grid-column: auto;
+    }
+  }
+
+  .fi-save-bar {
+    justify-content: stretch;
+
+    .ant-btn {
+      flex: 1;
+    }
+  }
+}

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

@@ -0,0 +1,62 @@
+/**
+ * 文件职责：发票记录表格样式。
+ */
+.fi-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-pagination {
+    margin: 14px 16px;
+  }
+}
+
+.fi-company-cell {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+
+  .fi-applicant {
+    font-weight: 500;
+    color: rgb(0 0 0 / 88%);
+  }
+
+  .fi-company {
+    font-size: 12px;
+    color: rgb(0 0 0 / 45%);
+  }
+}
+
+.fi-amount {
+  font-weight: 600;
+  color: rgb(0 0 0 / 88%);
+}
+
+.fi-time {
+  font-size: 12px;
+  color: rgb(0 0 0 / 45%);
+  white-space: nowrap;
+}
+
+.fi-link-action {
+  padding-inline: 0;
+}
+
+.fi-action-wrap {
+  display: inline-flex;
+  gap: 8px;
+  align-items: center;
+}

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

@@ -0,0 +1,57 @@
+/**
+ * 文件职责：发票管理页面本地状态类型定义。
+ */
+import type {
+  FinanceInvoiceStatusFilter,
+  FinanceInvoiceTypeFilter,
+} from '#/api/finance';
+
+/** 页面分段键。 */
+export type FinanceInvoiceTabKey = 'records' | 'settings';
+
+/** 发票记录筛选状态。 */
+export interface FinanceInvoiceFilterState {
+  endDate: string;
+  invoiceType: FinanceInvoiceTypeFilter;
+  keyword: string;
+  startDate: string;
+  status: FinanceInvoiceStatusFilter;
+}
+
+/** 发票记录分页状态。 */
+export interface FinanceInvoicePaginationState {
+  page: number;
+  pageSize: number;
+  totalCount: number;
+}
+
+/** 发票设置表单状态。 */
+export interface FinanceInvoiceSettingFormState {
+  autoIssueMaxAmount: number;
+  bankAccount: string;
+  bankName: string;
+  companyName: string;
+  enableAutoIssue: boolean;
+  enableElectronicNormalInvoice: boolean;
+  enableElectronicSpecialInvoice: boolean;
+  registeredAddress: string;
+  registeredPhone: string;
+  taxpayerNumber: string;
+}
+
+/** 发票开票抽屉表单状态。 */
+export interface FinanceInvoiceIssueFormState {
+  contactEmail: string;
+  issueRemark: string;
+}
+
+/** 发票作废弹窗表单状态。 */
+export interface FinanceInvoiceVoidFormState {
+  voidReason: string;
+}
+
+/** 通用选项项。 */
+export interface OptionItem {
+  label: string;
+  value: string;
+}

apps/web-antd/src/views/finance/report/components/ReportBatchExportModal.vue

@@ -0,0 +1,96 @@
+<script setup lang="ts">
+/**
+ * 文件职责：经营报表批量导出确认弹窗。
+ */
+import type { FinanceBusinessReportPeriodType } from '#/api/finance';
+
+import { computed } from 'vue';
+
+import { Modal } from 'ant-design-vue';
+
+import { resolvePeriodTypeLabel } from '../composables/report-page/helpers';
+
+interface PaginationState {
+  page: number;
+  pageSize: number;
+  total: number;
+}
+
+interface Props {
+  currentPageCount: number;
+  open: boolean;
+  pagination: PaginationState;
+  periodType: FinanceBusinessReportPeriodType;
+  selectedStoreName: string;
+  submitting: boolean;
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'close'): void;
+  (event: 'confirm'): void;
+}>();
+
+const periodText = computed(() => resolvePeriodTypeLabel(props.periodType));
+const pageSizeText = computed(() => `${props.pagination.pageSize} 条/页`);
+
+const pageRangeText = computed(() => {
+  const pageSize = Math.max(1, Number(props.pagination.pageSize || 20));
+  const page = Math.max(1, Number(props.pagination.page || 1));
+  const currentCount = Math.max(0, Number(props.currentPageCount || 0));
+
+  if (currentCount === 0) {
+    return '当前页暂无数据';
+  }
+
+  const start = (page - 1) * pageSize + 1;
+  const end = start + currentCount - 1;
+  return `${start}-${end}`;
+});
+</script>
+
+<template>
+  <Modal
+    :open="props.open"
+    title="批量导出经营报表"
+    ok-text="确认导出"
+    cancel-text="取消"
+    :confirm-loading="props.submitting"
+    @ok="emit('confirm')"
+    @cancel="emit('close')"
+  >
+    <div class="frp-batch-modal">
+      <p class="frp-batch-desc">
+        将按当前门店、当前周期和当前分页范围导出 ZIP 文件（包含 PDF 与 Excel）。
+      </p>
+
+      <div class="frp-batch-list">
+        <div class="frp-batch-line">
+          <span class="frp-batch-label">门店</span>
+          <span class="frp-batch-value">{{ props.selectedStoreName }}</span>
+        </div>
+        <div class="frp-batch-line">
+          <span class="frp-batch-label">报表周期</span>
+          <span class="frp-batch-value">{{ periodText }}</span>
+        </div>
+        <div class="frp-batch-line">
+          <span class="frp-batch-label">当前页</span>
+          <span class="frp-batch-value">第 {{ props.pagination.page }} 页</span>
+        </div>
+        <div class="frp-batch-line">
+          <span class="frp-batch-label">分页大小</span>
+          <span class="frp-batch-value">{{ pageSizeText }}</span>
+        </div>
+        <div class="frp-batch-line">
+          <span class="frp-batch-label">导出范围</span>
+          <span class="frp-batch-value">{{ pageRangeText }}</span>
+        </div>
+        <div class="frp-batch-line is-total">
+          <span class="frp-batch-label">总报表数</span>
+          <span class="frp-batch-value">{{ props.pagination.total }} 条</span>
+        </div>
+      </div>
+    </div>
+  </Modal>
+</template>

apps/web-antd/src/views/finance/report/components/ReportPreviewDrawer.vue

@@ -0,0 +1,208 @@
+<script setup lang="ts">
+/**
+ * 文件职责：经营报表预览抽屉。
+ */
+import type { FinanceBusinessReportDetailDto } from '#/api/finance';
+
+import { computed } from 'vue';
+
+import { IconifyIcon } from '@vben/icons';
+
+import { Button, Drawer, Empty, Spin } from 'ant-design-vue';
+
+import {
+  formatCurrency,
+  formatPercent,
+  formatSignedRate,
+} from '../composables/report-page/helpers';
+
+interface Props {
+  canExport: boolean;
+  detail: FinanceBusinessReportDetailDto | null;
+  isDownloadingExcel: boolean;
+  isDownloadingPdf: boolean;
+  loading: boolean;
+  open: boolean;
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'close'): void;
+  (event: 'downloadExcel'): void;
+  (event: 'downloadPdf'): void;
+}>();
+
+const drawerTitle = computed(() => props.detail?.title || '经营报表预览');
+
+const canDownload = computed(
+  () => props.canExport && Boolean(props.detail?.reportId),
+);
+
+const incomeIconMap: Record<string, { icon: string; tone: string }> = {
+  delivery: { icon: 'lucide:bike', tone: 'primary' },
+  dine_in: { icon: 'lucide:utensils', tone: 'warning' },
+  pickup: { icon: 'lucide:shopping-bag', tone: 'success' },
+};
+
+const costIconMap: Record<string, { icon: string; tone: string }> = {
+  fixed_expense: { icon: 'lucide:building-2', tone: 'muted' },
+  food_material: { icon: 'lucide:carrot', tone: 'warning' },
+  labor: { icon: 'lucide:users', tone: 'primary' },
+  packaging_consumable: { icon: 'lucide:package', tone: 'success' },
+};
+
+function resolveBreakdownMeta(type: 'cost' | 'income', key: string) {
+  const map = type === 'income' ? incomeIconMap : costIconMap;
+  return map[key] || { icon: 'lucide:circle', tone: 'muted' };
+}
+
+function isPositiveMetric(key: string) {
+  return key !== 'refund_rate';
+}
+
+function resolveKpiChangeTone(key: string, value: number) {
+  if (!Number.isFinite(value) || value === 0) {
+    return 'neutral';
+  }
+
+  const increaseGood = isPositiveMetric(key);
+  const isGood = (value > 0 && increaseGood) || (value < 0 && !increaseGood);
+  return isGood ? 'positive' : 'negative';
+}
+
+function formatKpiChangeText(prefix: '同比' | '环比', value: number) {
+  return `${prefix} ${formatSignedRate(value)}`;
+}
+</script>
+
+<template>
+  <Drawer
+    :open="props.open"
+    class="frp-preview-drawer"
+    width="560"
+    :title="drawerTitle"
+    @close="emit('close')"
+  >
+    <Spin :spinning="props.loading">
+      <template v-if="props.detail">
+        <div class="frp-section">
+          <div class="frp-section-hd">关键指标</div>
+          <div class="frp-kpi-grid">
+            <div
+              v-for="item in props.detail.kpis"
+              :key="`kpi-${item.key}`"
+              class="frp-kpi-item"
+            >
+              <div class="frp-kpi-label">{{ item.label }}</div>
+              <div
+                class="frp-kpi-val"
+                :class="{ 'is-profit': item.key === 'net_profit' }"
+              >
+                {{ item.valueText }}
+              </div>
+              <div class="frp-kpi-change">
+                <span
+                  :class="`frp-kpi-change-${resolveKpiChangeTone(item.key, item.yoyChangeRate)}`"
+                >
+                  {{ formatKpiChangeText('同比', item.yoyChangeRate) }}
+                </span>
+                <span
+                  :class="`frp-kpi-change-${resolveKpiChangeTone(item.key, item.momChangeRate)}`"
+                >
+                  {{ formatKpiChangeText('环比', item.momChangeRate) }}
+                </span>
+              </div>
+            </div>
+          </div>
+        </div>
+
+        <div class="frp-divider"></div>
+
+        <div class="frp-section">
+          <div class="frp-section-hd">收入明细（按渠道）</div>
+          <div
+            v-for="item in props.detail.incomeBreakdowns"
+            :key="`income-${item.key}`"
+            class="frp-detail-row"
+          >
+            <span class="frp-detail-name">
+              <IconifyIcon
+                :icon="resolveBreakdownMeta('income', item.key).icon"
+                class="frp-breakdown-icon"
+                :class="`is-${resolveBreakdownMeta('income', item.key).tone}`"
+              />
+              {{ item.label }}
+            </span>
+            <div class="frp-detail-right">
+              <span class="frp-detail-pct">{{
+                formatPercent(item.ratioPercent)
+              }}</span>
+              <span class="frp-detail-amount">{{
+                formatCurrency(item.amount)
+              }}</span>
+            </div>
+          </div>
+        </div>
+
+        <div class="frp-divider"></div>
+
+        <div class="frp-section">
+          <div class="frp-section-hd">成本明细（按类别）</div>
+          <div
+            v-for="item in props.detail.costBreakdowns"
+            :key="`cost-${item.key}`"
+            class="frp-detail-row"
+          >
+            <span class="frp-detail-name">
+              <IconifyIcon
+                :icon="resolveBreakdownMeta('cost', item.key).icon"
+                class="frp-breakdown-icon"
+                :class="`is-${resolveBreakdownMeta('cost', item.key).tone}`"
+              />
+              {{ item.label }}
+            </span>
+            <div class="frp-detail-right">
+              <span class="frp-detail-pct">{{
+                formatPercent(item.ratioPercent)
+              }}</span>
+              <span class="frp-detail-amount">{{
+                formatCurrency(item.amount)
+              }}</span>
+            </div>
+          </div>
+        </div>
+      </template>
+      <Empty v-else description="暂无报表详情" />
+    </Spin>
+
+    <template #footer>
+      <div class="frp-drawer-footer">
+        <Button @click="emit('close')">关闭</Button>
+        <Button
+          type="primary"
+          class="frp-drawer-btn"
+          :disabled="!canDownload"
+          :loading="props.isDownloadingPdf"
+          @click="emit('downloadPdf')"
+        >
+          <template #icon>
+            <IconifyIcon icon="lucide:file-text" />
+          </template>
+          下载PDF
+        </Button>
+        <Button
+          class="frp-drawer-btn"
+          :disabled="!canDownload"
+          :loading="props.isDownloadingExcel"
+          @click="emit('downloadExcel')"
+        >
+          <template #icon>
+            <IconifyIcon icon="lucide:table" />
+          </template>
+          下载Excel
+        </Button>
+      </div>
+    </template>
+  </Drawer>
+</template>

apps/web-antd/src/views/finance/report/components/ReportTableCard.vue

@@ -0,0 +1,205 @@
+<script setup lang="ts">
+import type { TablePaginationConfig, TableProps } from 'ant-design-vue';
+
+/**
+ * 文件职责：经营报表列表表格与分页。
+ */
+import type { FinanceBusinessReportListItemDto } from '#/api/finance';
+
+import { h } from 'vue';
+
+import { Button, Table, Tag } from 'ant-design-vue';
+
+import {
+  formatAverageOrderValue,
+  formatCurrency,
+  formatOrderCount,
+  formatPercent,
+  resolveReportStatusTagColor,
+} from '../composables/report-page/helpers';
+
+interface PaginationState {
+  page: number;
+  pageSize: number;
+  total: number;
+}
+
+interface Props {
+  canExport: boolean;
+  loading: boolean;
+  pagination: PaginationState;
+  rows: FinanceBusinessReportListItemDto[];
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'downloadExcel', reportId: string): void;
+  (event: 'downloadPdf', reportId: string): void;
+  (event: 'pageChange', page: number, pageSize: number): void;
+  (event: 'preview', reportId: string): void;
+}>();
+
+const columns: TableProps['columns'] = [
+  {
+    title: '日期',
+    dataIndex: 'dateText',
+    width: 160,
+    customRender: ({ text }) => h('span', { class: 'frp-date' }, String(text)),
+  },
+  {
+    title: '营业额',
+    dataIndex: 'revenueAmount',
+    width: 130,
+    align: 'right',
+    customRender: ({ record }) =>
+      h('span', { class: 'frp-amount' }, formatCurrency(record.revenueAmount)),
+  },
+  {
+    title: '订单数',
+    dataIndex: 'orderCount',
+    width: 100,
+    align: 'right',
+    customRender: ({ record }) =>
+      h('span', { class: 'frp-value' }, formatOrderCount(record.orderCount)),
+  },
+  {
+    title: '客单价',
+    dataIndex: 'averageOrderValue',
+    width: 120,
+    align: 'right',
+    customRender: ({ record }) =>
+      h(
+        'span',
+        { class: 'frp-value' },
+        formatAverageOrderValue(record.averageOrderValue),
+      ),
+  },
+  {
+    title: '退款率',
+    dataIndex: 'refundRatePercent',
+    width: 100,
+    align: 'right',
+    customRender: ({ record }) =>
+      h(
+        'span',
+        { class: 'frp-value' },
+        formatPercent(record.refundRatePercent),
+      ),
+  },
+  {
+    title: '成本总额',
+    dataIndex: 'costTotalAmount',
+    width: 130,
+    align: 'right',
+    customRender: ({ record }) =>
+      h('span', { class: 'frp-value' }, formatCurrency(record.costTotalAmount)),
+  },
+  {
+    title: '净利润',
+    dataIndex: 'netProfitAmount',
+    width: 130,
+    align: 'right',
+    customRender: ({ record }) => {
+      const amount = Number(record.netProfitAmount || 0);
+      return h(
+        'span',
+        {
+          class: ['frp-amount', amount >= 0 ? 'is-profit' : 'is-loss'],
+        },
+        formatCurrency(amount),
+      );
+    },
+  },
+  {
+    title: '利润率',
+    dataIndex: 'profitRatePercent',
+    width: 100,
+    align: 'right',
+    customRender: ({ record }) =>
+      h(
+        'span',
+        { class: 'frp-value' },
+        formatPercent(record.profitRatePercent),
+      ),
+  },
+  {
+    title: '状态',
+    dataIndex: 'statusText',
+    width: 96,
+    customRender: ({ record }) =>
+      h(
+        Tag,
+        {
+          color: resolveReportStatusTagColor(record.status),
+        },
+        () => String(record.statusText || '--'),
+      ),
+  },
+  {
+    title: '操作',
+    dataIndex: 'action',
+    width: 210,
+    customRender: ({ record }) => {
+      const reportId = String(record.reportId || '');
+      const canDownload = props.canExport && Boolean(record.canDownload);
+
+      return h('div', { class: 'frp-action-group' }, [
+        h(
+          Button,
+          {
+            type: 'link',
+            class: 'frp-action-link',
+            onClick: () => emit('preview', reportId),
+          },
+          () => '预览',
+        ),
+        h(
+          Button,
+          {
+            type: 'link',
+            class: 'frp-action-link',
+            disabled: !canDownload,
+            onClick: () => emit('downloadPdf', reportId),
+          },
+          () => '下载PDF',
+        ),
+        h(
+          Button,
+          {
+            type: 'link',
+            class: 'frp-action-link',
+            disabled: !canDownload,
+            onClick: () => emit('downloadExcel', reportId),
+          },
+          () => '下载Excel',
+        ),
+      ]);
+    },
+  },
+];
+
+function handleTableChange(next: TablePaginationConfig) {
+  emit('pageChange', Number(next.current || 1), Number(next.pageSize || 20));
+}
+</script>
+
+<template>
+  <div class="frp-table-card">
+    <Table
+      row-key="reportId"
+      :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} 条`,
+      }"
+      @change="handleTableChange"
+    />
+  </div>
+</template>

apps/web-antd/src/views/finance/report/components/ReportToolbar.vue

@@ -0,0 +1,80 @@
+<script setup lang="ts">
+import type { OptionItem } from '../types';
+
+/**
+ * 文件职责：经营报表工具栏（周期切换、门店选择、批量导出）。
+ */
+import type { FinanceBusinessReportPeriodType } from '#/api/finance';
+
+import { IconifyIcon } from '@vben/icons';
+
+import { Button, Segmented, Select } from 'ant-design-vue';
+
+import { REPORT_PERIOD_OPTIONS } from '../composables/report-page/constants';
+
+interface Props {
+  canExport: boolean;
+  isBatchExporting: boolean;
+  isStoreLoading: boolean;
+  periodType: FinanceBusinessReportPeriodType;
+  selectedStoreId: string;
+  storeOptions: OptionItem[];
+}
+
+const props = defineProps<Props>();
+
+const emit = defineEmits<{
+  (event: 'batchExport'): void;
+  (event: 'update:periodType', value: FinanceBusinessReportPeriodType): void;
+  (event: 'update:selectedStoreId', value: string): void;
+}>();
+
+function handleStoreChange(value: unknown) {
+  if (typeof value === 'number' || typeof value === 'string') {
+    emit('update:selectedStoreId', String(value));
+    return;
+  }
+
+  emit('update:selectedStoreId', '');
+}
+
+function handlePeriodChange(value: unknown) {
+  const period = String(value || 'daily') as FinanceBusinessReportPeriodType;
+  emit('update:periodType', period);
+}
+</script>
+
+<template>
+  <div class="frp-toolbar">
+    <Segmented
+      class="frp-period-segment"
+      :value="props.periodType"
+      :options="REPORT_PERIOD_OPTIONS"
+      @update:value="(value) => handlePeriodChange(value)"
+    />
+
+    <Select
+      class="frp-store-select"
+      :value="props.selectedStoreId"
+      placeholder="选择门店"
+      :loading="props.isStoreLoading"
+      :options="props.storeOptions"
+      :disabled="props.isStoreLoading || props.storeOptions.length === 0"
+      @update:value="(value) => handleStoreChange(value)"
+    />
+
+    <div class="frp-toolbar-right">
+      <Button
+        class="frp-batch-export-btn"
+        :disabled="!props.canExport || !props.selectedStoreId"
+        :loading="props.isBatchExporting"
+        @click="emit('batchExport')"
+      >
+        <template #icon>
+          <IconifyIcon icon="lucide:download" />
+        </template>
+        批量导出
+      </Button>
+    </div>
+  </div>
+</template>

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

@@ -0,0 +1,32 @@
+import type {
+  FinanceBusinessReportPaginationState,
+  FinanceBusinessReportPeriodOption,
+} from '../../types';
+
+/**
+ * 文件职责：经营报表页面常量与默认状态定义。
+ */
+
+/** 经营报表查看权限。 */
+export const FINANCE_REPORT_VIEW_PERMISSION = 'tenant:statistics:report:view';
+
+/** 经营报表导出权限。 */
+export const FINANCE_REPORT_EXPORT_PERMISSION =
+  'tenant:statistics:report:export';
+
+/** 报表周期选项。 */
+export const REPORT_PERIOD_OPTIONS: FinanceBusinessReportPeriodOption[] = [
+  { label: '日报', value: 'daily' },
+  { label: '周报', value: 'weekly' },
+  { label: '月报', value: 'monthly' },
+];
+
+/** 默认报表周期。 */
+export const DEFAULT_PERIOD_TYPE = 'daily' as const;
+
+/** 默认分页状态。 */
+export const DEFAULT_PAGINATION: FinanceBusinessReportPaginationState = {
+  page: 1,
+  pageSize: 20,
+  total: 0,
+};

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

@@ -0,0 +1,84 @@
+import type { FinanceBusinessReportPaginationState } from '../../types';
+
+/**
+ * 文件职责：经营报表页面数据加载动作。
+ */
+import type { FinanceBusinessReportListItemDto } from '#/api/finance';
+import type { StoreListItemDto } from '#/api/store';
+
+import { getFinanceBusinessReportListApi } from '#/api/finance';
+import { getStoreListApi } from '#/api/store';
+
+import { buildReportListQueryPayload } from './helpers';
+
+interface DataActionOptions {
+  isListLoading: { value: boolean };
+  isStoreLoading: { value: boolean };
+  pagination: FinanceBusinessReportPaginationState;
+  periodType: { value: 'daily' | 'monthly' | 'weekly' };
+  rows: { value: FinanceBusinessReportListItemDto[] };
+  selectedStoreId: { value: string };
+  stores: { value: StoreListItemDto[] };
+}
+
+/** 创建数据相关动作。 */
+export function createDataActions(options: DataActionOptions) {
+  function clearPageData() {
+    options.rows.value = [];
+    options.pagination.total = 0;
+  }
+
+  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 loadReportList() {
+    if (!options.selectedStoreId.value) {
+      clearPageData();
+      return;
+    }
+
+    options.isListLoading.value = true;
+    try {
+      const payload = buildReportListQueryPayload(
+        options.selectedStoreId.value,
+        options.periodType.value,
+        options.pagination.page,
+        options.pagination.pageSize,
+      );
+      const result = await getFinanceBusinessReportListApi(payload);
+
+      options.rows.value = result.items;
+      options.pagination.total = result.total;
+      options.pagination.page = result.page;
+      options.pagination.pageSize = result.pageSize;
+    } finally {
+      options.isListLoading.value = false;
+    }
+  }
+
+  return {
+    clearPageData,
+    loadReportList,
+    loadStores,
+  };
+}

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

@@ -0,0 +1,136 @@
+/**
+ * 文件职责：经营报表预览抽屉与单条导出动作。
+ */
+import type { FinanceBusinessReportDetailDto } from '#/api/finance';
+
+import { message } from 'ant-design-vue';
+
+import {
+  exportFinanceBusinessReportExcelApi,
+  exportFinanceBusinessReportPdfApi,
+  getFinanceBusinessReportDetailApi,
+} from '#/api/finance';
+
+import { buildReportDetailQueryPayload, downloadBase64File } from './helpers';
+
+interface DetailActionOptions {
+  canExport: { value: boolean };
+  currentPreviewReportId: { value: string };
+  isDownloadingExcel: { value: boolean };
+  isDownloadingPdf: { value: boolean };
+  isPreviewDrawerOpen: { value: boolean };
+  isPreviewLoading: { value: boolean };
+  previewDetail: { value: FinanceBusinessReportDetailDto | null };
+  selectedStoreId: { value: string };
+}
+
+/** 创建预览与单条导出动作。 */
+export function createDetailActions(options: DetailActionOptions) {
+  function setPreviewDrawerOpen(value: boolean) {
+    options.isPreviewDrawerOpen.value = value;
+    if (!value) {
+      options.previewDetail.value = null;
+      options.currentPreviewReportId.value = '';
+    }
+  }
+
+  async function openPreview(reportId: string) {
+    if (!options.selectedStoreId.value || !reportId) {
+      return;
+    }
+
+    options.currentPreviewReportId.value = reportId;
+    options.isPreviewDrawerOpen.value = true;
+    options.previewDetail.value = null;
+    options.isPreviewLoading.value = true;
+    try {
+      const payload = buildReportDetailQueryPayload(
+        options.selectedStoreId.value,
+        reportId,
+      );
+      options.previewDetail.value =
+        await getFinanceBusinessReportDetailApi(payload);
+      options.currentPreviewReportId.value =
+        options.previewDetail.value.reportId || reportId;
+    } finally {
+      options.isPreviewLoading.value = false;
+    }
+  }
+
+  function resolveTargetReportId(reportId?: string) {
+    const explicit = String(reportId ?? '').trim();
+    if (explicit) {
+      return explicit;
+    }
+
+    const current = String(options.currentPreviewReportId.value || '').trim();
+    if (current) {
+      return current;
+    }
+
+    return String(options.previewDetail.value?.reportId ?? '').trim();
+  }
+
+  async function downloadPdf(reportId?: string) {
+    if (!options.canExport.value || !options.selectedStoreId.value) {
+      return;
+    }
+
+    const targetReportId = resolveTargetReportId(reportId);
+    if (!targetReportId) {
+      return;
+    }
+
+    options.isDownloadingPdf.value = true;
+    try {
+      const payload = buildReportDetailQueryPayload(
+        options.selectedStoreId.value,
+        targetReportId,
+      );
+      const result = await exportFinanceBusinessReportPdfApi(payload);
+      downloadBase64File(
+        result.fileName,
+        result.fileContentBase64,
+        'application/pdf',
+      );
+      message.success('PDF 下载成功');
+    } finally {
+      options.isDownloadingPdf.value = false;
+    }
+  }
+
+  async function downloadExcel(reportId?: string) {
+    if (!options.canExport.value || !options.selectedStoreId.value) {
+      return;
+    }
+
+    const targetReportId = resolveTargetReportId(reportId);
+    if (!targetReportId) {
+      return;
+    }
+
+    options.isDownloadingExcel.value = true;
+    try {
+      const payload = buildReportDetailQueryPayload(
+        options.selectedStoreId.value,
+        targetReportId,
+      );
+      const result = await exportFinanceBusinessReportExcelApi(payload);
+      downloadBase64File(
+        result.fileName,
+        result.fileContentBase64,
+        'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+      );
+      message.success('Excel 下载成功');
+    } finally {
+      options.isDownloadingExcel.value = false;
+    }
+  }
+
+  return {
+    downloadExcel,
+    downloadPdf,
+    openPreview,
+    setPreviewDrawerOpen,
+  };
+}

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

@@ -0,0 +1,71 @@
+import type { FinanceBusinessReportPaginationState } from '../../types';
+
+/**
+ * 文件职责：经营报表批量导出弹窗与导出动作。
+ */
+import type { FinanceBusinessReportPeriodType } from '#/api/finance';
+
+import { message } from 'ant-design-vue';
+
+import { exportFinanceBusinessReportBatchApi } from '#/api/finance';
+
+import {
+  buildReportBatchExportQueryPayload,
+  downloadBase64File,
+} from './helpers';
+
+interface ExportActionOptions {
+  canExport: { value: boolean };
+  isBatchExportModalOpen: { value: boolean };
+  isBatchExporting: { value: boolean };
+  pagination: FinanceBusinessReportPaginationState;
+  periodType: { value: FinanceBusinessReportPeriodType };
+  selectedStoreId: { value: string };
+}
+
+/** 创建批量导出动作。 */
+export function createExportActions(options: ExportActionOptions) {
+  function setBatchExportModalOpen(value: boolean) {
+    options.isBatchExportModalOpen.value = value;
+  }
+
+  function openBatchExportModal() {
+    if (!options.canExport.value || !options.selectedStoreId.value) {
+      return;
+    }
+
+    options.isBatchExportModalOpen.value = true;
+  }
+
+  async function handleConfirmBatchExport() {
+    if (!options.canExport.value || !options.selectedStoreId.value) {
+      return;
+    }
+
+    options.isBatchExporting.value = true;
+    try {
+      const payload = buildReportBatchExportQueryPayload(
+        options.selectedStoreId.value,
+        options.periodType.value,
+        options.pagination.page,
+        options.pagination.pageSize,
+      );
+      const result = await exportFinanceBusinessReportBatchApi(payload);
+      downloadBase64File(
+        result.fileName,
+        result.fileContentBase64,
+        'application/zip',
+      );
+      message.success(`批量导出成功，共 ${result.totalCount} 份报表`);
+      setBatchExportModalOpen(false);
+    } finally {
+      options.isBatchExporting.value = false;
+    }
+  }
+
+  return {
+    handleConfirmBatchExport,
+    openBatchExportModal,
+    setBatchExportModalOpen,
+  };
+}

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

@@ -0,0 +1,30 @@
+import type { FinanceBusinessReportPaginationState } from '../../types';
+
+/**
+ * 文件职责：经营报表页面筛选与分页行为。
+ */
+import type { FinanceBusinessReportPeriodType } from '#/api/finance';
+
+interface FilterActionOptions {
+  loadReportList: () => Promise<void>;
+  pagination: FinanceBusinessReportPaginationState;
+  periodType: { value: FinanceBusinessReportPeriodType };
+}
+
+/** 创建筛选与分页行为。 */
+export function createFilterActions(options: FilterActionOptions) {
+  function setPeriodType(value: FinanceBusinessReportPeriodType) {
+    options.periodType.value = value || 'daily';
+  }
+
+  async function handlePageChange(page: number, pageSize: number) {
+    options.pagination.page = page;
+    options.pagination.pageSize = pageSize;
+    await options.loadReportList();
+  }
+
+  return {
+    handlePageChange,
+    setPeriodType,
+  };
+}

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

@@ -0,0 +1,130 @@
+import type {
+  FinanceBusinessReportBatchExportQuery,
+  FinanceBusinessReportDetailQuery,
+  FinanceBusinessReportPeriodType,
+  FinanceBusinessReportStatus,
+} from '#/api/finance';
+
+/**
+ * 文件职责：经营报表页面纯函数与数据转换工具。
+ */
+
+/** 构建经营报表列表查询请求。 */
+export function buildReportListQueryPayload(
+  storeId: string,
+  periodType: FinanceBusinessReportPeriodType,
+  page: number,
+  pageSize: number,
+) {
+  return {
+    storeId,
+    periodType,
+    page,
+    pageSize,
+  };
+}
+
+/** 构建经营报表详情查询请求。 */
+export function buildReportDetailQueryPayload(
+  storeId: string,
+  reportId: string,
+): FinanceBusinessReportDetailQuery {
+  return {
+    storeId,
+    reportId,
+  };
+}
+
+/** 构建经营报表批量导出查询请求。 */
+export function buildReportBatchExportQueryPayload(
+  storeId: string,
+  periodType: FinanceBusinessReportPeriodType,
+  page: number,
+  pageSize: number,
+): FinanceBusinessReportBatchExportQuery {
+  return {
+    storeId,
+    periodType,
+    page,
+    pageSize,
+  };
+}
+
+/** 报表周期文案。 */
+export function resolvePeriodTypeLabel(value: FinanceBusinessReportPeriodType) {
+  if (value === 'weekly') return '周报';
+  if (value === 'monthly') return '月报';
+  return '日报';
+}
+
+/** 报表状态标签色。 */
+export function resolveReportStatusTagColor(
+  status: FinanceBusinessReportStatus,
+) {
+  if (status === 'succeeded') return 'green';
+  if (status === 'failed') return 'red';
+  if (status === 'running' || status === 'queued') return 'blue';
+  return 'default';
+}
+
+/** 货币格式化（人民币）。 */
+export function formatCurrency(value: number, fractionDigits = 0) {
+  const digits = Math.max(0, Math.min(2, fractionDigits));
+  return new Intl.NumberFormat('zh-CN', {
+    style: 'currency',
+    currency: 'CNY',
+    minimumFractionDigits: digits,
+    maximumFractionDigits: digits,
+  }).format(Number.isFinite(value) ? value : 0);
+}
+
+/** 订单数格式化。 */
+export function formatOrderCount(value: number) {
+  return `${Math.max(0, Math.round(value || 0))}单`;
+}
+
+/** 客单价格式化。 */
+export function formatAverageOrderValue(value: number) {
+  return formatCurrency(value, 1);
+}
+
+/** 百分比格式化。 */
+export function formatPercent(value: number, digits = 1) {
+  const safeDigits = Math.max(0, Math.min(2, digits));
+  const normalized = Number.isFinite(value) ? value : 0;
+  return `${normalized.toFixed(safeDigits)}%`;
+}
+
+/** 数值符号格式化。 */
+export function formatSignedRate(value: number, digits = 1) {
+  const normalized = Number.isFinite(value) ? value : 0;
+  if (normalized === 0) {
+    return `${normalized.toFixed(digits)}%`;
+  }
+
+  return `${normalized > 0 ? '↑' : '↓'}${Math.abs(normalized).toFixed(digits)}%`;
+}
+
+function decodeBase64ToBlob(base64: string, mimeType: 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: mimeType });
+}
+
+/** 下载 Base64 编码文件。 */
+export function downloadBase64File(
+  fileName: string,
+  fileContentBase64: string,
+  mimeType = 'application/octet-stream',
+) {
+  const blob = decodeBase64ToBlob(fileContentBase64, mimeType);
+  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/report/composables/useFinanceReportPage.ts

@@ -0,0 +1,219 @@
+/**
+ * 文件职责：经营报表页面状态与动作编排。
+ */
+import type {
+  FinanceBusinessReportDetailDto,
+  FinanceBusinessReportListItemDto,
+  FinanceBusinessReportPeriodType,
+} from '#/api/finance';
+import type { StoreListItemDto } from '#/api/store';
+
+import { computed, onActivated, onMounted, reactive, ref, watch } from 'vue';
+
+import { useAccessStore } from '@vben/stores';
+
+import {
+  DEFAULT_PAGINATION,
+  DEFAULT_PERIOD_TYPE,
+  FINANCE_REPORT_EXPORT_PERMISSION,
+  FINANCE_REPORT_VIEW_PERMISSION,
+} from './report-page/constants';
+import { createDataActions } from './report-page/data-actions';
+import { createDetailActions } from './report-page/detail-actions';
+import { createExportActions } from './report-page/export-actions';
+import { createFilterActions } from './report-page/filter-actions';
+
+/** 创建经营报表页面组合状态。 */
+export function useFinanceReportPage() {
+  const accessStore = useAccessStore();
+
+  const stores = ref<StoreListItemDto[]>([]);
+  const selectedStoreId = ref('');
+  const isStoreLoading = ref(false);
+
+  const periodType = ref<FinanceBusinessReportPeriodType>(DEFAULT_PERIOD_TYPE);
+  const rows = ref<FinanceBusinessReportListItemDto[]>([]);
+  const pagination = reactive({ ...DEFAULT_PAGINATION });
+  const isListLoading = ref(false);
+
+  const previewDetail = ref<FinanceBusinessReportDetailDto | null>(null);
+  const currentPreviewReportId = ref('');
+  const isPreviewDrawerOpen = ref(false);
+  const isPreviewLoading = ref(false);
+  const isDownloadingPdf = ref(false);
+  const isDownloadingExcel = ref(false);
+
+  const isBatchExportModalOpen = ref(false);
+  const isBatchExporting = ref(false);
+
+  const storeOptions = computed(() =>
+    stores.value.map((item) => ({
+      label: item.name,
+      value: item.id,
+    })),
+  );
+
+  const selectedStoreName = computed(
+    () =>
+      storeOptions.value.find((item) => item.value === selectedStoreId.value)
+        ?.label ?? '--',
+  );
+
+  const accessCodeSet = computed(
+    () => new Set((accessStore.accessCodes ?? []).map(String)),
+  );
+
+  const canView = computed(() =>
+    accessCodeSet.value.has(FINANCE_REPORT_VIEW_PERMISSION),
+  );
+
+  const canExport = computed(() =>
+    accessCodeSet.value.has(FINANCE_REPORT_EXPORT_PERMISSION),
+  );
+
+  const { clearPageData, loadReportList, loadStores } = createDataActions({
+    stores,
+    selectedStoreId,
+    periodType,
+    rows,
+    pagination,
+    isStoreLoading,
+    isListLoading,
+  });
+
+  const { handlePageChange, setPeriodType } = createFilterActions({
+    periodType,
+    pagination,
+    loadReportList,
+  });
+
+  const { downloadExcel, downloadPdf, openPreview, setPreviewDrawerOpen } =
+    createDetailActions({
+      canExport,
+      selectedStoreId,
+      previewDetail,
+      currentPreviewReportId,
+      isPreviewDrawerOpen,
+      isPreviewLoading,
+      isDownloadingPdf,
+      isDownloadingExcel,
+    });
+
+  const {
+    handleConfirmBatchExport,
+    openBatchExportModal,
+    setBatchExportModalOpen,
+  } = createExportActions({
+    canExport,
+    selectedStoreId,
+    periodType,
+    pagination,
+    isBatchExportModalOpen,
+    isBatchExporting,
+  });
+
+  function setSelectedStoreId(value: string) {
+    selectedStoreId.value = value;
+  }
+
+  function clearByPermission() {
+    stores.value = [];
+    selectedStoreId.value = '';
+    clearPageData();
+    setPreviewDrawerOpen(false);
+    setBatchExportModalOpen(false);
+  }
+
+  watch(selectedStoreId, async (storeId) => {
+    setPreviewDrawerOpen(false);
+    setBatchExportModalOpen(false);
+
+    if (!storeId) {
+      clearPageData();
+      return;
+    }
+
+    pagination.page = 1;
+    await loadReportList();
+  });
+
+  watch(periodType, async (value, oldValue) => {
+    if (value === oldValue) {
+      return;
+    }
+
+    setPreviewDrawerOpen(false);
+    setBatchExportModalOpen(false);
+
+    if (!selectedStoreId.value) {
+      clearPageData();
+      return;
+    }
+
+    pagination.page = 1;
+    await loadReportList();
+  });
+
+  watch(canView, async (value, oldValue) => {
+    if (value === oldValue) {
+      return;
+    }
+
+    if (!value) {
+      clearByPermission();
+      return;
+    }
+
+    await loadStores();
+  });
+
+  onMounted(async () => {
+    if (!canView.value) {
+      clearByPermission();
+      return;
+    }
+
+    await loadStores();
+  });
+
+  onActivated(() => {
+    if (!canView.value) {
+      return;
+    }
+
+    if (stores.value.length === 0 || !selectedStoreId.value) {
+      void loadStores();
+    }
+  });
+
+  return {
+    canExport,
+    canView,
+    currentPreviewReportId,
+    downloadPreviewExcel: downloadExcel,
+    downloadPreviewPdf: downloadPdf,
+    handleConfirmBatchExport,
+    handlePageChange,
+    isBatchExportModalOpen,
+    isBatchExporting,
+    isDownloadingExcel,
+    isDownloadingPdf,
+    isListLoading,
+    isPreviewDrawerOpen,
+    isPreviewLoading,
+    isStoreLoading,
+    openBatchExportModal,
+    openPreview,
+    pagination,
+    periodType,
+    previewDetail,
+    rows,
+    selectedStoreId,
+    selectedStoreName,
+    setBatchExportModalOpen,
+    setPeriodType,
+    setPreviewDrawerOpen,
+    setSelectedStoreId,
+    storeOptions,
+  };
+}

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

@@ -0,0 +1,104 @@
+<script setup lang="ts">
+/**
+ * 文件职责：财务中心经营报表页面入口编排。
+ */
+import { Page } from '@vben/common-ui';
+
+import { Empty } from 'ant-design-vue';
+
+import ReportBatchExportModal from './components/ReportBatchExportModal.vue';
+import ReportPreviewDrawer from './components/ReportPreviewDrawer.vue';
+import ReportTableCard from './components/ReportTableCard.vue';
+import ReportToolbar from './components/ReportToolbar.vue';
+import { useFinanceReportPage } from './composables/useFinanceReportPage';
+
+const {
+  canExport,
+  canView,
+  downloadPreviewExcel,
+  downloadPreviewPdf,
+  handleConfirmBatchExport,
+  handlePageChange,
+  isBatchExportModalOpen,
+  isBatchExporting,
+  isDownloadingExcel,
+  isDownloadingPdf,
+  isListLoading,
+  isPreviewDrawerOpen,
+  isPreviewLoading,
+  isStoreLoading,
+  openBatchExportModal,
+  openPreview,
+  pagination,
+  periodType,
+  previewDetail,
+  rows,
+  selectedStoreId,
+  selectedStoreName,
+  setBatchExportModalOpen,
+  setPeriodType,
+  setPreviewDrawerOpen,
+  setSelectedStoreId,
+  storeOptions,
+} = useFinanceReportPage();
+</script>
+
+<template>
+  <Page title="经营报表" content-class="page-finance-report">
+    <div class="frp-page">
+      <template v-if="canView">
+        <ReportToolbar
+          :period-type="periodType"
+          :selected-store-id="selectedStoreId"
+          :store-options="storeOptions"
+          :is-store-loading="isStoreLoading"
+          :can-export="canExport"
+          :is-batch-exporting="isBatchExporting"
+          @update:period-type="setPeriodType"
+          @update:selected-store-id="setSelectedStoreId"
+          @batch-export="openBatchExportModal"
+        />
+
+        <ReportTableCard
+          :rows="rows"
+          :loading="isListLoading"
+          :pagination="pagination"
+          :can-export="canExport"
+          @page-change="handlePageChange"
+          @preview="openPreview"
+          @download-pdf="downloadPreviewPdf"
+          @download-excel="downloadPreviewExcel"
+        />
+      </template>
+
+      <Empty v-else description="暂无经营报表页面访问权限" />
+    </div>
+
+    <ReportPreviewDrawer
+      :open="isPreviewDrawerOpen"
+      :loading="isPreviewLoading"
+      :detail="previewDetail"
+      :can-export="canExport"
+      :is-downloading-pdf="isDownloadingPdf"
+      :is-downloading-excel="isDownloadingExcel"
+      @close="setPreviewDrawerOpen(false)"
+      @download-pdf="downloadPreviewPdf"
+      @download-excel="downloadPreviewExcel"
+    />
+
+    <ReportBatchExportModal
+      :open="isBatchExportModalOpen"
+      :submitting="isBatchExporting"
+      :selected-store-name="selectedStoreName"
+      :period-type="periodType"
+      :pagination="pagination"
+      :current-page-count="rows.length"
+      @close="setBatchExportModalOpen(false)"
+      @confirm="handleConfirmBatchExport"
+    />
+  </Page>
+</template>
+
+<style lang="less">
+@import './styles/index.less';
+</style>

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

@@ -0,0 +1,14 @@
+/**
+ * 文件职责：经营报表页面基础容器样式。
+ */
+.page-finance-report {
+  .ant-card {
+    border-radius: 10px;
+  }
+}
+
+.frp-page {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}

apps/web-antd/src/views/finance/report/styles/drawer.less

@@ -0,0 +1,162 @@
+/**
+ * 文件职责：经营报表预览抽屉样式。
+ */
+.page-finance-report {
+  .ant-drawer {
+    .ant-drawer-header {
+      padding: 14px 18px;
+      border-bottom: 1px solid #f0f0f0;
+    }
+
+    .ant-drawer-body {
+      padding: 16px 20px;
+    }
+
+    .ant-drawer-footer {
+      padding: 12px 20px;
+      border-top: 1px solid #f0f0f0;
+    }
+  }
+}
+
+.frp-section {
+  margin-bottom: 22px;
+}
+
+.frp-section-hd {
+  padding-left: 10px;
+  margin-bottom: 14px;
+  font-size: 15px;
+  font-weight: 600;
+  color: rgb(0 0 0 / 88%);
+  border-left: 3px solid #1677ff;
+}
+
+.frp-kpi-grid {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 12px;
+}
+
+.frp-kpi-item {
+  padding: 14px 16px;
+  background: #f8f9fb;
+  border: 1px solid #f0f0f0;
+  border-radius: 8px;
+}
+
+.frp-kpi-label {
+  margin-bottom: 6px;
+  font-size: 12px;
+  color: rgb(0 0 0 / 45%);
+}
+
+.frp-kpi-val {
+  font-size: 20px;
+  font-weight: 700;
+  line-height: 1.3;
+  color: rgb(0 0 0 / 88%);
+
+  &.is-profit {
+    color: #52c41a;
+  }
+}
+
+.frp-kpi-change {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+  margin-top: 4px;
+  font-size: 12px;
+}
+
+.frp-kpi-change-positive {
+  color: #52c41a;
+}
+
+.frp-kpi-change-negative {
+  color: #ff4d4f;
+}
+
+.frp-kpi-change-neutral {
+  color: rgb(0 0 0 / 45%);
+}
+
+.frp-divider {
+  height: 1px;
+  margin: 20px 0;
+  background: linear-gradient(90deg, #f0f0f0, transparent);
+}
+
+.frp-detail-row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 10px 0;
+  font-size: 13px;
+  border-bottom: 1px solid #f5f5f5;
+
+  &:last-child {
+    border-bottom: none;
+  }
+}
+
+.frp-detail-name {
+  display: inline-flex;
+  gap: 6px;
+  align-items: center;
+  color: rgb(0 0 0 / 88%);
+}
+
+.frp-breakdown-icon {
+  width: 14px;
+  height: 14px;
+
+  &.is-primary {
+    color: #1677ff;
+  }
+
+  &.is-success {
+    color: #52c41a;
+  }
+
+  &.is-warning {
+    color: #faad14;
+  }
+
+  &.is-muted {
+    color: rgb(0 0 0 / 45%);
+  }
+}
+
+.frp-detail-right {
+  display: flex;
+  gap: 16px;
+  align-items: center;
+}
+
+.frp-detail-amount {
+  min-width: 80px;
+  font-weight: 600;
+  color: rgb(0 0 0 / 88%);
+  text-align: right;
+}
+
+.frp-detail-pct {
+  min-width: 50px;
+  font-size: 12px;
+  color: rgb(0 0 0 / 45%);
+  text-align: right;
+}
+
+.frp-drawer-footer {
+  display: flex;
+  gap: 8px;
+  justify-content: flex-end;
+}
+
+.frp-drawer-btn {
+  display: inline-flex;
+  gap: 4px;
+  align-items: center;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * 文件职责：经营报表页面样式聚合入口。
+ */
+@import './base.less';
+@import './layout.less';
+@import './table.less';
+@import './drawer.less';
+@import './modal.less';
+@import './responsive.less';

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

@@ -0,0 +1,39 @@
+/**
+ * 文件职责：经营报表页面布局与工具栏样式。
+ */
+.frp-toolbar {
+  display: flex;
+  gap: 12px;
+  align-items: center;
+  padding: 16px 20px;
+  background: #fff;
+  border: 1px solid #f0f0f0;
+  border-radius: 10px;
+  box-shadow: 0 2px 8px rgb(15 23 42 / 6%);
+
+  .frp-period-segment {
+    --ant-segmented-item-selected-bg: #fff;
+    --ant-segmented-item-selected-color: #1677ff;
+  }
+
+  .frp-store-select {
+    width: 200px;
+    min-width: 200px;
+  }
+
+  .frp-toolbar-right {
+    margin-left: auto;
+  }
+
+  .frp-batch-export-btn {
+    display: inline-flex;
+    gap: 4px;
+    align-items: center;
+    height: 32px;
+  }
+
+  .ant-select-selector {
+    height: 32px;
+    font-size: 13px;
+  }
+}

apps/web-antd/src/views/finance/report/styles/modal.less

@@ -0,0 +1,51 @@
+/**
+ * 文件职责：经营报表批量导出弹窗样式。
+ */
+.frp-batch-modal {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.frp-batch-desc {
+  margin: 0;
+  font-size: 13px;
+  color: rgb(0 0 0 / 65%);
+}
+
+.frp-batch-list {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 12px 14px;
+  background: #fafafa;
+  border: 1px solid #f0f0f0;
+  border-radius: 8px;
+}
+
+.frp-batch-line {
+  display: flex;
+  gap: 16px;
+  justify-content: space-between;
+  font-size: 13px;
+
+  .frp-batch-label {
+    color: rgb(0 0 0 / 45%);
+  }
+
+  .frp-batch-value {
+    color: rgb(0 0 0 / 88%);
+    text-align: right;
+  }
+
+  &.is-total {
+    padding-top: 8px;
+    margin-top: 4px;
+    font-weight: 600;
+    border-top: 1px solid #f0f0f0;
+
+    .frp-batch-value {
+      color: #1677ff;
+    }
+  }
+}

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

@@ -0,0 +1,58 @@
+/**
+ * 文件职责：经营报表页面响应式样式。
+ */
+@media (max-width: 1200px) {
+  .frp-kpi-grid {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+}
+
+@media (max-width: 768px) {
+  .frp-toolbar {
+    flex-wrap: wrap;
+    padding: 14px 12px;
+
+    .frp-period-segment,
+    .frp-store-select {
+      width: 100%;
+      min-width: 100%;
+    }
+
+    .frp-toolbar-right {
+      width: 100%;
+      margin-left: 0;
+    }
+
+    .frp-batch-export-btn {
+      justify-content: center;
+      width: 100%;
+    }
+  }
+
+  .frp-table-card {
+    .ant-table-wrapper {
+      overflow-x: auto;
+    }
+  }
+
+  .frp-kpi-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .page-finance-report {
+    .ant-drawer {
+      .ant-drawer-content-wrapper {
+        width: 100% !important;
+        max-width: 100%;
+      }
+
+      .ant-drawer-body {
+        padding: 14px 12px;
+      }
+
+      .ant-drawer-footer {
+        padding: 12px;
+      }
+    }
+  }
+}

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

@@ -0,0 +1,59 @@
+/**
+ * 文件职责：经营报表表格区域样式。
+ */
+.frp-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;
+      white-space: nowrap;
+    }
+  }
+
+  .ant-pagination {
+    margin: 14px 16px;
+  }
+}
+
+.frp-date {
+  white-space: nowrap;
+}
+
+.frp-value {
+  color: rgb(0 0 0 / 88%);
+  white-space: nowrap;
+}
+
+.frp-amount {
+  font-weight: 600;
+  white-space: nowrap;
+
+  &.is-profit {
+    color: #52c41a;
+  }
+
+  &.is-loss {
+    color: #ff4d4f;
+  }
+}
+
+.frp-action-group {
+  display: flex;
+  gap: 2px;
+  align-items: center;
+}
+
+.frp-action-link {
+  padding-inline: 0;
+  white-space: nowrap;
+}

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

@@ -0,0 +1,23 @@
+/**
+ * 文件职责：经营报表页面本地状态类型定义。
+ */
+import type { FinanceBusinessReportPeriodType } from '#/api/finance';
+
+/** 通用选项项。 */
+export interface OptionItem {
+  label: string;
+  value: string;
+}
+
+/** 报表周期选项。 */
+export interface FinanceBusinessReportPeriodOption {
+  label: string;
+  value: FinanceBusinessReportPeriodType;
+}
+
+/** 经营报表分页状态。 */
+export interface FinanceBusinessReportPaginationState {
+  page: number;
+  pageSize: number;
+  total: number;
+}

pnpm-lock.yaml

@@ -48,6 +48,9 @@ catalogs:
     '@manypkg/get-packages':
       specifier: ^3.1.0
       version: 3.1.0
+    '@microsoft/signalr':
+      specifier: ^8.0.7
+      version: 8.0.17
     '@nolebase/vitepress-plugin-git-changelog':
       specifier: ^2.18.2
       version: 2.18.2
@@ -615,7 +618,7 @@ importers:
   apps/web-antd:
     dependencies:
       '@microsoft/signalr':
-        specifier: ^8.0.7
+        specifier: 'catalog:'
         version: 8.0.17
       '@vben/access':
         specifier: workspace:*