优化财务相关功能

MIGRATION-VUE3.md

@@ -0,0 +1,200 @@
+# Lilishop UI — Vue 3 迁移与上线前检查清单
+
+四个子项目（buyer / seller / manager / im）已完成 **Vue 3 + Element Plus** 迁移，并完成依赖小版本对齐。本文档供上线前统一回归使用。
+
+## 技术栈（四端一致）
+
+| 类别 | 包 | 版本（package.json） |
+|------|-----|---------------------|
+| 框架 | vue | ^3.5.35 |
+| 编译 | @vue/compiler-sfc | ^3.5.35 |
+| 路由 | vue-router | ^4.6.4 |
+| 状态 | vuex | ^4.1.0 |
+| UI | element-plus | ^2.14.1 |
+| 图标 | @element-plus/icons-vue | ^2.3.2 |
+| 请求 | axios | ^1.7.9 |
+| 兼容 | core-js | ^3.49.0 |
+| 构建 | @vue/cli-service | ^5.0.9 |
+
+> 使用 `^` 范围，实际安装版本以各目录 `yarn.lock` 为准。  
+> 要求 **Node >= 16**，包管理统一 **yarn**。
+
+## 本地启动
+
+```bash
+# 买家端
+cd buyer && yarn install && yarn dev    # 端口 10000
+
+# 商家端
+cd seller && yarn install && yarn dev   # 端口 10002
+
+# 管理端
+cd manager && yarn install && yarn dev  # 端口 10003
+
+# IM 客服
+cd im && yarn install && yarn dev       # 端口 8000
+```
+
+生产构建（上线前必跑）：
+
+```bash
+cd buyer   && yarn build
+cd seller  && yarn build
+cd manager && yarn build
+cd im      && yarn build
+```
+
+---
+
+## 一、通用检查（四端都要过）
+
+### 1. 认证与请求（axios 1.x 重点）
+
+各端请求封装位置：
+
+| 端 | 文件 |
+|----|------|
+| buyer | `buyer/src/plugins/request.js` |
+| seller | `seller/src/libs/axios.js` |
+| manager | `manager/src/libs/axios.js` |
+| im | `im/src/utils/request.js` |
+
+- [ ] **登录**：账号密码登录成功，token 写入正常
+- [ ] **登出**：清除 token，跳转登录页
+- [ ] **401**：token 过期后跳转登录 / 刷新 token（buyer/manager/seller 有刷新逻辑）
+- [ ] **403**：无权限时提示文案正确、不白屏
+- [ ] **400 / 5xx**：接口报错能弹出 `Message` / `ElMessage` / `Notification`
+- [ ] **网络超时**：断网或超时后有错误提示，页面不卡死
+- [ ] **GET 带参**：列表筛选、分页参数序列化正常
+- [ ] **POST JSON**：`Content-Type: application/json` 请求体正确
+- [ ] **POST 表单**：`application/x-www-form-urlencoded` 提交正常（im 等）
+
+### 2. Element Plus UI（2.6 → 2.14 重点）
+
+- [ ] **表格** `el-table`：列展示、排序、空数据、加载态
+- [ ] **分页** `el-pagination`：翻页、每页条数切换
+- [ ] **表单** `el-form`：必填校验、错误提示位置
+- [ ] **弹窗** `el-dialog` / `ElMessageBox`：打开、确认、取消、关闭
+- [ ] **下拉** `el-select` / `el-dropdown`：选项、点击外部关闭
+- [ ] **消息** `ElMessage` / `$Message` 兼容层：success / error / warning
+- [ ] **加载** `ElLoading` / `v-loading`：请求期间遮罩正常消失
+- [ ] **日期** `el-date-picker`：选择、清空、范围选择
+- [ ] **上传** `el-upload`：选文件、进度、成功 / 失败回调
+
+### 3. 路由与页面
+
+- [ ] 浏览器 **刷新** 当前路由不 404（history 模式 + 服务端配置）
+- [ ] **动态路由** 加载正常（seller / manager 菜单权限路由）
+- [ ] 浏览器 **前进 / 后退** 正常
+- [ ] 各端 **404 页** 可回到首页
+
+### 4. 构建与部署
+
+- [ ] 四端 `yarn build` 无 error（warning 可记录，不阻断）
+- [ ] 生产环境 API 地址配置正确（`config` / 环境变量）
+- [ ] 静态资源 `publicPath` 与 Nginx / CDN 路径一致
+- [ ] gzip 压缩包（如有）可正常访问
+
+---
+
+## 二、分端专项检查
+
+### Buyer 买家端（10000）
+
+详见 [buyer/MIGRATION-VUE3.md](./buyer/MIGRATION-VUE3.md)
+
+- [ ] 首页装修模块渲染（轮播、商品列表、秒杀区等）
+- [ ] 商品详情：规格选择、加购、收藏、`el-image` 预览
+- [ ] 购物车 → 结算 → 支付流程
+- [ ] 用户中心：订单列表、地址、优惠券、售后
+- [ ] 登录 / 注册 / 忘记密码
+- [ ] 店铺入驻、商户页
+- [ ] 地图（高德 `@amap/amap-jsapi-loader`）定位与选点
+- [ ] 侧边栏 `el-menu`、头部 `el-dropdown`、动态图标 `iconMap.js`
+
+### Seller 商家端（10002）
+
+详见 [seller/MIGRATION-VUE3.md](./seller/MIGRATION-VUE3.md)
+
+- [ ] 商家登录、店铺信息
+- [ ] 商品发布三步流程（`goodsOperation` 步骤条）
+- [ ] 订单管理：发货、退款、详情
+- [ ] 促销 / 分销 / 统计图表（`@antv/g2`）
+- [ ] 页面装修（wap / modelList，从 manager 同步部分）
+- [ ] 图片懒加载 `vue-lazyload`
+- [ ] Excel 导出 `vue-json-excel`
+
+### Manager 管理端（10003）
+
+详见 [manager/MIGRATION-VUE3.md](./manager/MIGRATION-VUE3.md)
+
+- [ ] 管理员登录、权限菜单、动态路由
+- [ ] 系统设置（`sys/setting-manage` 各 Tab）
+- [ ] 菜单 / 部门管理
+- [ ] 页面装修（PC + H5）
+- [ ] 文章管理
+- [ ] 商品 / 订单 / 会员 / 促销等核心列表 CRUD
+- [ ] 富文本 TinyMCE 编辑、图片上传
+- [ ] 多语言 `vue-i18n` 切换（如有启用）
+
+### IM 客服端（8000）
+
+详见 [im/MIGRATION-VUE3.md](./im/MIGRATION-VUE3.md)
+
+- [ ] 带 token 参数进入会话页
+- [ ] 对话列表加载、切换会话、未读数
+- [ ] 发送文字、表情、图片消息
+- [ ] 商品 / 订单卡片链接跳转（`linkToGoods` / `linkToOrders`）
+- [ ] 右键菜单（复制、撤回、删除等）
+- [ ] WebSocket 连接 / 断线重连 / 新消息通知
+- [ ] 最近浏览、订单列表侧栏（商家场景）
+- [ ] 用户名片弹层 `$user()`
+
+---
+
+## 三、已知可忽略项
+
+| 项 | 说明 |
+|----|------|
+| `vue-awesome-swiper` peer warning | 历史依赖，Vue 3 下仍有 peer 告警，功能正常可暂忽略 |
+| im 内 `<i class="el-icon-*">` | Element Plus 无字体图标，部分旧图标可能不显示，不影响核心功能 |
+| `vue-prism-editor@2.0.0-alpha.2` | im 代码块编辑器刻意锁定 alpha 版 |
+| 打包体积 warning | chunk-vendors 偏大，属 Element Plus 全量引入，可后续做按需优化 |
+
+---
+
+## 四、问题记录模板
+
+上线测试时建议按端记录：
+
+```markdown
+### [端名] 问题标题
+- 页面/路由：
+- 操作步骤：
+- 预期：
+- 实际：
+- 控制台报错：
+- 优先级：P0 / P1 / P2
+```
+
+---
+
+## 五、子项目文档索引
+
+| 端 | 迁移说明 |
+|----|----------|
+| buyer | [buyer/MIGRATION-VUE3.md](./buyer/MIGRATION-VUE3.md) |
+| seller | [seller/MIGRATION-VUE3.md](./seller/MIGRATION-VUE3.md) |
+| manager | [manager/MIGRATION-VUE3.md](./manager/MIGRATION-VUE3.md) |
+| im | [im/MIGRATION-VUE3.md](./im/MIGRATION-VUE3.md) |
+
+---
+
+## 六、建议上线顺序
+
+1. **manager**（后台配置源头）
+2. **seller**（商家经营）
+3. **buyer**（C 端流量最大）
+4. **im**（客服，依赖前后端 WebSocket）
+
+每上一端，至少完成本文 **第一节通用检查** + 对应 **第二节分端检查** 后再切下一端。

buyer/MIGRATION-VUE3.md

@@ -37,3 +37,7 @@ yarn build
 - `scripts/replace-icon.js` — 静态 `<Icon type>` → `el-icon`
 - `scripts/fix-el-icon-click.js` — 修复 `@click` 绑定
 - `scripts/fix-broken-tags.js` — 闭合标签修复
+
+## 上线前检查
+
+四端统一清单（认证、axios、Element Plus、分端专项）：[../MIGRATION-VUE3.md](../MIGRATION-VUE3.md)

im/MIGRATION-VUE3.md

@@ -0,0 +1,32 @@
+# IM 客服端 Vue 3 迁移说明
+
+## 技术栈
+
+- Vue 3.5 + Vue Router 4 + Vuex 4
+- Element Plus（替代 element-ui）
+- 自研右键菜单 `src/plugins/contextmenu.js`（替代 vue-contextmenujs）
+- `vue-virtual-scroller@3`、`vue-cropper@1.x`、`vue-prism-editor@2.0.0-alpha.2`
+
+## 启动
+
+```bash
+cd im
+yarn install
+yarn dev    # 端口 8000
+yarn build
+```
+
+## 迁移要点
+
+1. **入口** `src/main.js` — `createApp`，全局过滤器 `$filters`
+2. **路由** `createRouter` + `createWebHistory`，404 路由 `/:pathMatch(.*)*`
+3. **通知** `im-server/event/talk.js` 通过 `app-bridge` 发 `ElNotification`，避免循环引用
+4. **用户卡片** `$user()` 插件用 `createApp` 挂载
+5. **指令** `v-focus` / `v-paste` / `v-drag` / `v-outside` 已改为 Vue 3 钩子
+6. **SVG** `svg-sprite-loader` + `svg-icon` 全局组件
+7. **生命周期** `destroyed` → `beforeUnmount`；`$set` / `$delete` 已移除
+
+## 上线前检查
+
+统一清单见仓库根目录：[../MIGRATION-VUE3.md](../MIGRATION-VUE3.md)  
+IM 专项见该文档 **「IM 客服端」** 一节。

manager/MIGRATION-VUE3.md

@@ -56,4 +56,8 @@ yarn install
 yarn run dev
 ```
 
-Node **18+**，包管理统一 **yarn**。
+Node **16+**，包管理统一 **yarn**。
+
+## 上线前检查
+
+四端统一清单（认证、axios、Element Plus、分端专项）：[../MIGRATION-VUE3.md](../MIGRATION-VUE3.md)

manager/src/api/finance.js

@@ -0,0 +1,75 @@
+/**
+ * 管理端财务中心 API。
+ * 导出类接口返回 blob，需配合 downloadBlob 触发浏览器下载。
+ */
+import { getRequest, postBlobRequest } from "@/libs/axios";
+
+/** 导出支付流水（筛选条件同 paymentLog 列表） */
+export const exportPaymentFlow = (params) => {
+  return getRequest("/finance/payment-flow/export", params, "blob");
+};
+
+/** 导出退款流水 */
+export const exportRefundFlow = (params) => {
+  return getRequest("/finance/refund-flow/export", params, "blob");
+};
+
+/** 导出钱包流水 */
+export const exportWalletLog = (params) => {
+  return getRequest("/finance/wallet-log/export", params, "blob");
+};
+
+/** 导出结算单列表（仅汇总行） */
+export const exportBillList = (params) => {
+  return getRequest("/finance/bill-list/export", params, "blob");
+};
+
+/** 批量下载结算单 ZIP */
+export const batchDownloadBills = (billIds) => {
+  return postBlobRequest("/finance/bill/batchDownload", billIds);
+};
+
+/** 平台经营报表查询 */
+export const getPlatformReport = (params) => {
+  return getRequest("/finance/report/platform", params);
+};
+
+/** 导出平台经营报表 */
+export const exportPlatformReport = (params) => {
+  return getRequest("/finance/report/platform/export", params, "blob");
+};
+
+/** 店铺结算汇总查询 */
+export const getStoreSettlementReport = (params) => {
+  return getRequest("/finance/report/store-settlement", params);
+};
+
+/** 导出店铺结算汇总 */
+export const exportStoreSettlementReport = (params) => {
+  return getRequest("/finance/report/store-settlement/export", params, "blob");
+};
+
+/** 支付方式汇总查询 */
+export const getPaymentMethodReport = (params) => {
+  return getRequest("/finance/report/payment-method", params);
+};
+
+/** 导出支付方式汇总 */
+export const exportPaymentMethodReport = (params) => {
+  return getRequest("/finance/report/payment-method/export", params, "blob");
+};
+
+/** 结算台账查询 */
+export const getSettlementLedger = (params) => {
+  return getRequest("/finance/report/settlement-ledger", params);
+};
+
+/** 导出结算台账 */
+export const exportSettlementLedger = (params) => {
+  return getRequest("/finance/report/settlement-ledger/export", params, "blob");
+};
+
+/** 退款流水分页（财务中心页面复用） */
+export const refundLogPage = (params) => {
+  return getRequest("/order/refundLog", params);
+};

manager/src/libs/axios.js

@@ -189,6 +189,20 @@ export const getRequest = (url, params, resBlob) => {
 };
 
 
+export const postBlobRequest = (url, data) => {
+  let accessToken = getStore("accessToken");
+  return service({
+    method: "post",
+    url: `${url}`,
+    data: data,
+    responseType: "blob",
+    headers: {
+      "Content-Type": "application/json",
+      accessToken: accessToken
+    }
+  });
+};
+
 export const postRequest = (url, params, headers) => {
   let accessToken = getStore("accessToken");
   return service({

manager/src/router/router.js

@@ -348,6 +348,42 @@ export const otherRouter = {
       title: "查看直播",
       name: "live-detail",
       component: () => import("@/views/promotions/live/live-detail.vue")
+    },
+    {
+      path: "finance-platform-report",
+      title: "平台经营报表",
+      name: "finance-platform-report",
+      component: () => import("@/views/finance/platform-report.vue")
+    },
+    {
+      path: "finance-store-settlement",
+      title: "店铺结算汇总",
+      name: "finance-store-settlement",
+      component: () => import("@/views/finance/store-settlement.vue")
+    },
+    {
+      path: "finance-payment-method",
+      title: "支付方式汇总",
+      name: "finance-payment-method",
+      component: () => import("@/views/finance/payment-method.vue")
+    },
+    {
+      path: "finance-settlement-ledger",
+      title: "结算台账",
+      name: "finance-settlement-ledger",
+      component: () => import("@/views/finance/settlement-ledger.vue")
+    },
+    {
+      path: "finance-refund-log",
+      title: "退款流水",
+      name: "finance-refund-log",
+      component: () => import("@/views/finance/refundLog.vue")
+    },
+    {
+      path: "finance-wallet-log",
+      title: "钱包流水",
+      name: "finance-wallet-log",
+      component: () => import("@/views/finance/walletLog.vue")
     }
   ]
 };

manager/src/utils/downloadBlob.js

@@ -0,0 +1,15 @@
+/**
+ * 触发浏览器下载 blob 响应
+ */
+export function downloadBlob(blob, filename) {
+  if (!blob) return;
+  const link = document.createElement("a");
+  link.style.display = "none";
+  const url = window.URL.createObjectURL(new Blob([blob]));
+  link.href = url;
+  link.download = filename;
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
+  window.URL.revokeObjectURL(url);
+}

manager/src/utils/filters.js

@@ -184,8 +184,6 @@ export function unixSellerBillStatus(status_code) {
       return '已出账'
     case 'CHECK':
       return '已对账'
-    case 'EXAMINE':
-      return '已审核'
     case 'PAY':
       return '已结算'
     case 'COMPLETE':

manager/src/views/finance/payment-method.vue

@@ -0,0 +1,62 @@
+<template>
+  <div class="search">
+    <el-card>
+      <el-form inline>
+        <el-form-item label="日期范围">
+          <el-date-picker v-model="dateRange" type="daterange" value-format="YYYY-MM-DD" />
+        </el-form-item>
+        <el-form-item>
+          <el-button type="primary" @click="loadData">查询</el-button>
+          <el-button @click="handleExport">导出</el-button>
+        </el-form-item>
+      </el-form>
+    </el-card>
+    <el-card class="mt_10">
+      <el-table v-loading="loading" border :data="data">
+        <el-table-column prop="period" label="日期" width="120" />
+        <el-table-column prop="paymentName" label="支付方式" width="140" />
+        <el-table-column prop="payCount" label="支付笔数" width="100" />
+        <el-table-column prop="payAmount" label="支付金额" width="120" />
+        <el-table-column prop="refundCount" label="退款笔数" width="100" />
+        <el-table-column prop="refundAmount" label="退款金额" width="120" />
+      </el-table>
+    </el-card>
+  </div>
+</template>
+
+<script>
+import * as API_Finance from "@/api/finance";
+import { downloadBlob } from "@/utils/downloadBlob";
+
+export default {
+  name: "finance-payment-method",
+  data() {
+    return { loading: false, dateRange: [], data: [] };
+  },
+  mounted() {
+    this.loadData();
+  },
+  methods: {
+    buildParams() {
+      const p = {};
+      if (this.dateRange?.length === 2) {
+        p.startDate = this.dateRange[0];
+        p.endDate = this.dateRange[1];
+      }
+      return p;
+    },
+    loadData() {
+      this.loading = true;
+      API_Finance.getPaymentMethodReport(this.buildParams()).then((res) => {
+        this.loading = false;
+        if (res.success) this.data = res.result || [];
+      });
+    },
+    handleExport() {
+      API_Finance.exportPaymentMethodReport(this.buildParams()).then((blob) => {
+        downloadBlob(blob, "支付方式汇总.xlsx");
+      });
+    },
+  },
+};
+</script>

manager/src/views/finance/platform-report.vue

@@ -0,0 +1,82 @@
+<template>
+  <div class="search">
+    <el-card>
+      <el-form inline>
+        <el-form-item label="日期范围">
+          <el-date-picker
+            v-model="dateRange"
+            type="daterange"
+            value-format="YYYY-MM-DD"
+            start-placeholder="开始"
+            end-placeholder="结束"
+          />
+        </el-form-item>
+        <el-form-item label="粒度">
+          <el-select v-model="params.granularity" style="width: 120px">
+            <el-option label="按日" value="DAY" />
+            <el-option label="按月" value="MONTH" />
+          </el-select>
+        </el-form-item>
+        <el-form-item>
+          <el-button type="primary" @click="loadData">查询</el-button>
+          <el-button @click="handleExport">导出</el-button>
+        </el-form-item>
+      </el-form>
+    </el-card>
+    <el-card class="mt_10">
+      <el-table v-loading="loading" border :data="data" style="width: 100%">
+        <el-table-column prop="period" label="周期" width="120" />
+        <el-table-column prop="gmv" label="GMV" width="110" />
+        <el-table-column prop="refundAmount" label="退款" width="110" />
+        <el-table-column prop="netGmv" label="净GMV" width="110" />
+        <el-table-column prop="commissionIncome" label="佣金收入" width="110" />
+        <el-table-column prop="couponSubsidy" label="券补贴" width="110" />
+        <el-table-column prop="giftCardSubsidy" label="礼品卡补贴" width="120" />
+        <el-table-column prop="distributionExpense" label="分销支出" width="110" />
+        <el-table-column prop="storeSettlementTotal" label="商家应结" width="120" />
+      </el-table>
+    </el-card>
+  </div>
+</template>
+
+<script>
+import * as API_Finance from "@/api/finance";
+import { downloadBlob } from "@/utils/downloadBlob";
+
+export default {
+  name: "finance-platform-report",
+  data() {
+    return {
+      loading: false,
+      dateRange: [],
+      params: { granularity: "DAY" },
+      data: [],
+    };
+  },
+  mounted() {
+    this.loadData();
+  },
+  methods: {
+    buildParams() {
+      const p = { ...this.params };
+      if (this.dateRange && this.dateRange.length === 2) {
+        p.startDate = this.dateRange[0];
+        p.endDate = this.dateRange[1];
+      }
+      return p;
+    },
+    loadData() {
+      this.loading = true;
+      API_Finance.getPlatformReport(this.buildParams()).then((res) => {
+        this.loading = false;
+        if (res.success) this.data = res.result || [];
+      });
+    },
+    handleExport() {
+      API_Finance.exportPlatformReport(this.buildParams()).then((blob) => {
+        downloadBlob(blob, "平台经营报表.xlsx");
+      });
+    },
+  },
+};
+</script>

manager/src/views/finance/refundLog.vue

@@ -0,0 +1,77 @@
+<template>
+  <div class="search">
+    <el-card>
+      <el-form inline @keyup.enter="handleSearch">
+        <el-form-item label="订单号">
+          <el-input v-model="searchForm.orderSn" clearable style="width: 200px" />
+        </el-form-item>
+        <el-form-item>
+          <el-button type="primary" @click="handleSearch">搜索</el-button>
+          <el-button @click="handleExport">导出</el-button>
+        </el-form-item>
+      </el-form>
+    </el-card>
+    <el-card class="mt_10">
+      <el-table v-loading="loading" border :data="data">
+        <el-table-column prop="afterSaleNo" label="售后单号" min-width="160" />
+        <el-table-column prop="orderSn" label="订单号" min-width="160" />
+        <el-table-column prop="totalAmount" label="退款金额" width="110" />
+        <el-table-column prop="paymentName" label="退款方式" width="120" />
+        <el-table-column prop="isRefund" label="已退款" width="90" />
+        <el-table-column prop="createTime" label="创建时间" width="170" />
+      </el-table>
+      <div class="mt_10" style="display: flex; justify-content: flex-end">
+        <el-pagination
+          v-model:current-page="searchForm.pageNumber"
+          v-model:page-size="searchForm.pageSize"
+          :total="total"
+          layout="total, prev, pager, next"
+          size="small"
+          @current-change="getDataList"
+        />
+      </div>
+    </el-card>
+  </div>
+</template>
+
+<script>
+import * as API_Finance from "@/api/finance";
+import { downloadBlob } from "@/utils/downloadBlob";
+
+export default {
+  name: "finance-refund-log",
+  data() {
+    return {
+      loading: false,
+      searchForm: { pageNumber: 1, pageSize: 20, orderSn: "" },
+      data: [],
+      total: 0,
+    };
+  },
+  mounted() {
+    this.getDataList();
+  },
+  methods: {
+    handleSearch() {
+      this.searchForm.pageNumber = 1;
+      this.getDataList();
+    },
+    getDataList() {
+      this.loading = true;
+      API_Finance.refundLogPage(this.searchForm).then((res) => {
+        this.loading = false;
+        if (res.success) {
+          this.data = res.result.records;
+          this.total = res.result.total;
+        }
+      });
+    },
+    handleExport() {
+      const { pageNumber, pageSize, ...rest } = this.searchForm;
+      API_Finance.exportRefundFlow(rest).then((blob) => {
+        downloadBlob(blob, "退款流水.xlsx");
+      });
+    },
+  },
+};
+</script>

manager/src/views/finance/settlement-ledger.vue

@@ -0,0 +1,46 @@
+<template>
+  <div class="search">
+    <el-card>
+      <el-button type="primary" @click="loadData">刷新</el-button>
+      <el-button @click="handleExport">导出</el-button>
+    </el-card>
+    <el-card class="mt_10">
+      <el-table v-loading="loading" border :data="data">
+        <el-table-column prop="storeName" label="店铺" min-width="140" />
+        <el-table-column prop="pendingFlowAmount" label="待结算流水" width="130" />
+        <el-table-column prop="outUnpaidAmount" label="已出账未付" width="130" />
+        <el-table-column prop="checkUnpaidAmount" label="已对账未付" width="130" />
+        <el-table-column prop="paidAmount" label="已付款累计" width="130" />
+      </el-table>
+    </el-card>
+  </div>
+</template>
+
+<script>
+import * as API_Finance from "@/api/finance";
+import { downloadBlob } from "@/utils/downloadBlob";
+
+export default {
+  name: "finance-settlement-ledger",
+  data() {
+    return { loading: false, data: [] };
+  },
+  mounted() {
+    this.loadData();
+  },
+  methods: {
+    loadData() {
+      this.loading = true;
+      API_Finance.getSettlementLedger({}).then((res) => {
+        this.loading = false;
+        if (res.success) this.data = res.result || [];
+      });
+    },
+    handleExport() {
+      API_Finance.exportSettlementLedger({}).then((blob) => {
+        downloadBlob(blob, "结算台账.xlsx");
+      });
+    },
+  },
+};
+</script>

manager/src/views/finance/store-settlement.vue

@@ -0,0 +1,64 @@
+<template>
+  <div class="search">
+    <el-card>
+      <el-form inline>
+        <el-form-item label="日期范围">
+          <el-date-picker v-model="dateRange" type="daterange" value-format="YYYY-MM-DD" />
+        </el-form-item>
+        <el-form-item>
+          <el-button type="primary" @click="loadData">查询</el-button>
+          <el-button @click="handleExport">导出</el-button>
+        </el-form-item>
+      </el-form>
+    </el-card>
+    <el-card class="mt_10">
+      <el-table v-loading="loading" border :data="data">
+        <el-table-column prop="storeName" label="店铺" min-width="140" />
+        <el-table-column prop="orderPrice" label="订单实付" width="110" />
+        <el-table-column prop="refundPrice" label="退款" width="110" />
+        <el-table-column prop="commissionPrice" label="佣金" width="100" />
+        <el-table-column prop="billPrice" label="应结" width="110" />
+        <el-table-column prop="outBillAmount" label="已出账" width="110" />
+        <el-table-column prop="checkBillAmount" label="已对账" width="110" />
+        <el-table-column prop="completeBillAmount" label="已付款" width="110" />
+      </el-table>
+    </el-card>
+  </div>
+</template>
+
+<script>
+import * as API_Finance from "@/api/finance";
+import { downloadBlob } from "@/utils/downloadBlob";
+
+export default {
+  name: "finance-store-settlement",
+  data() {
+    return { loading: false, dateRange: [], data: [] };
+  },
+  mounted() {
+    this.loadData();
+  },
+  methods: {
+    buildParams() {
+      const p = {};
+      if (this.dateRange?.length === 2) {
+        p.startDate = this.dateRange[0];
+        p.endDate = this.dateRange[1];
+      }
+      return p;
+    },
+    loadData() {
+      this.loading = true;
+      API_Finance.getStoreSettlementReport(this.buildParams()).then((res) => {
+        this.loading = false;
+        if (res.success) this.data = res.result || [];
+      });
+    },
+    handleExport() {
+      API_Finance.exportStoreSettlementReport(this.buildParams()).then((blob) => {
+        downloadBlob(blob, "店铺结算汇总.xlsx");
+      });
+    },
+  },
+};
+</script>

manager/src/views/finance/walletLog.vue

@@ -0,0 +1,94 @@
+<template>
+  <div class="search">
+    <el-card>
+      <el-form inline>
+        <el-form-item label="会员">
+          <el-input v-model="searchForm.memberName" clearable style="width: 160px" />
+        </el-form-item>
+        <el-form-item label="日期">
+          <el-date-picker v-model="dateRange" type="daterange" value-format="YYYY-MM-DD" />
+        </el-form-item>
+        <el-form-item>
+          <el-button type="primary" @click="handleSearch">搜索</el-button>
+          <el-button @click="handleExport">导出</el-button>
+        </el-form-item>
+      </el-form>
+    </el-card>
+    <el-card class="mt_10">
+      <el-table v-loading="loading" border :data="data">
+        <el-table-column prop="memberName" label="会员" width="140" />
+        <el-table-column prop="money" label="金额" width="110" />
+        <el-table-column prop="serviceType" label="业务类型" width="140" />
+        <el-table-column prop="detail" label="明细" min-width="200" show-overflow-tooltip />
+        <el-table-column prop="createTime" label="时间" width="170" />
+      </el-table>
+      <div class="mt_10" style="display: flex; justify-content: flex-end">
+        <el-pagination
+          v-model:current-page="pageNumber"
+          v-model:page-size="pageSize"
+          :total="total"
+          layout="total, prev, pager, next"
+          size="small"
+          @current-change="getDataList"
+        />
+      </div>
+    </el-card>
+  </div>
+</template>
+
+<script>
+import * as API_Finance from "@/api/finance";
+import { getRequest } from "@/libs/axios";
+import { downloadBlob } from "@/utils/downloadBlob";
+
+export default {
+  name: "finance-wallet-log",
+  data() {
+    return {
+      loading: false,
+      searchForm: { memberName: "" },
+      dateRange: [],
+      pageNumber: 1,
+      pageSize: 20,
+      data: [],
+      total: 0,
+    };
+  },
+  mounted() {
+    this.getDataList();
+  },
+  methods: {
+    handleSearch() {
+      this.pageNumber = 1;
+      this.getDataList();
+    },
+    getDataList() {
+      this.loading = true;
+      const params = {
+        pageNumber: this.pageNumber,
+        pageSize: this.pageSize,
+        memberName: this.searchForm.memberName,
+      };
+      getRequest("/wallet/log", params).then((res) => {
+        this.loading = false;
+        if (res.success) {
+          this.data = res.result.records;
+          this.total = res.result.total;
+        }
+      }).catch(() => {
+        this.loading = false;
+      });
+    },
+    handleExport() {
+      const params = { memberName: this.searchForm.memberName };
+      if (this.dateRange?.length === 2) {
+        params.startDate = this.dateRange[0];
+        params.endDate = this.dateRange[1];
+      }
+      API_Finance.exportWalletLog(params).then((blob) => {
+        downloadBlob(blob, "钱包流水.xlsx");
+      });
+    },
+  },
+};
+</script>

manager/src/views/order/flow/paymentLog.vue

@@ -34,6 +34,7 @@
         </el-form-item>
         <el-form-item>
           <el-button type="primary" class="search-btn" @click="handleSearch">搜索</el-button>
+          <el-button class="search-btn" @click="handleExport">导出</el-button>
         </el-form-item>
       </el-form>
     </el-card>
@@ -113,6 +114,8 @@
 
 <script>
 import * as API_Order from "@/api/order";
+import * as API_Finance from "@/api/finance";
+import { downloadBlob } from "@/utils/downloadBlob";
 
 export default {
   name: "paymentLog",
@@ -164,6 +167,11 @@ export default {
         }
       });
     },
+    handleExport() {
+      API_Finance.exportPaymentFlow(this.searchForm).then((blob) => {
+        downloadBlob(blob, "支付流水.xlsx");
+      });
+    },
   },
   mounted() {
     this.init();

manager/src/views/seller/bill/accountStatementBill.vue

@@ -19,6 +19,8 @@
         </el-form-item>
         <el-form-item>
           <el-button type="primary" class="search-btn" @click="handleSearch">搜索</el-button>
+          <el-button class="search-btn" @click="handleExportList">导出列表</el-button>
+          <el-button class="search-btn" :disabled="selectCount === 0" @click="handleBatchDownload">批量下载</el-button>
         </el-form-item>
       </el-form>
     </el-card>
@@ -77,6 +79,8 @@
 
 <script>
 import * as API_Shop from "@/api/shops";
+import * as API_Finance from "@/api/finance";
+import { downloadBlob } from "@/utils/downloadBlob";
 
 export default {
   name: "bill",
@@ -100,11 +104,11 @@ export default {
   },
   methods: {
     billStatusText(v) {
-      const map = { OUT: "已出账", CHECK: "已对账", EXAMINE: "已审核", COMPLETE: "已付款" };
+      const map = { OUT: "已出账", CHECK: "已对账", COMPLETE: "已付款" };
       return map[v] || "已付款";
     },
     billStatusTagType(v) {
-      const map = { OUT: "primary", CHECK: "", EXAMINE: "warning", COMPLETE: "success" };
+      const map = { OUT: "primary", CHECK: "warning", COMPLETE: "success" };
       return map[v] || "success";
     },
     init() {
@@ -163,6 +167,23 @@ export default {
         query: { id: v.id },
       });
     },
+    handleExportList() {
+      const params = { ...this.searchForm };
+      delete params.billStatus;
+      API_Finance.exportBillList(params).then((blob) => {
+        downloadBlob(blob, "结算单列表.xlsx");
+      });
+    },
+    handleBatchDownload() {
+      if (this.selectCount <= 0) {
+        this.$Message.warning("请先选择结算单");
+        return;
+      }
+      const billIds = this.selectList.map((item) => item.id);
+      API_Finance.batchDownloadBills(billIds).then((blob) => {
+        downloadBlob(blob, "结算单批量下载.zip");
+      });
+    },
   },
   mounted() {
     this.init();

manager/src/views/seller/bill/bill-detail.vue

@@ -436,11 +436,11 @@ export default {
       API_Shop.downloadBill(this.id)
         .then((res) => {
           const blob = new Blob([res], {
-            type: "application/vnd.ms-excel;charset=utf-8",
+            type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
           });
           if ("download" in document.createElement("a")) {
             const link = document.createElement("a");
-            link.download = "结算单-" + this.id + ".xls";
+            link.download = "结算单-" + this.id + ".xlsx";
             link.style.display = "none";
             link.href = URL.createObjectURL(blob);
             document.body.appendChild(link);
@@ -448,7 +448,7 @@ export default {
             URL.revokeObjectURL(link.href);
             document.body.removeChild(link);
           } else {
-            navigator.msSaveBlob(blob, "结算单-" + this.id + ".xls");
+            navigator.msSaveBlob(blob, "结算单-" + this.id + ".xlsx");
           }
         })
         .catch((err) => {

manager/src/views/seller/bill/bill.vue

@@ -1,6 +1,10 @@
 <template>
   <div class="search">
     <el-card>
+      <div class="mb_10">
+        <el-button type="primary" @click="handleExportList">导出列表</el-button>
+        <el-button :disabled="selectCount === 0" @click="handleBatchDownload">批量下载</el-button>
+      </div>
       <el-table
         ref="table"
         v-loading="loading"
@@ -54,6 +58,8 @@
 
 <script>
 import * as API_Shop from "@/api/shops";
+import * as API_Finance from "@/api/finance";
+import { downloadBlob } from "@/utils/downloadBlob";
 
 export default {
   name: "bill",
@@ -74,11 +80,11 @@ export default {
   },
   methods: {
     billStatusText(v) {
-      const map = { OUT: "已出账", CHECK: "已对账", EXAMINE: "已审核", COMPLETE: "已付款" };
+      const map = { OUT: "已出账", CHECK: "已对账", COMPLETE: "已付款" };
-      return map[v] || "已付款";
+      return map[v] || v;
     },
     billStatusTagType(v) {
-      const map = { OUT: "primary", CHECK: "", EXAMINE: "warning", COMPLETE: "success" };
+      const map = { OUT: "primary", CHECK: "warning", COMPLETE: "success" };
       return map[v] || "success";
     },
     init() {
@@ -118,6 +124,21 @@ export default {
         query: { id: v.id },
       });
     },
+    handleExportList() {
+      API_Finance.exportBillList({ ...this.searchForm }).then((blob) => {
+        downloadBlob(blob, "结算单列表.xlsx");
+      });
+    },
+    handleBatchDownload() {
+      if (this.selectCount <= 0) {
+        this.$Message.warning("请先选择结算单");
+        return;
+      }
+      const billIds = this.selectList.map((item) => item.id);
+      API_Finance.batchDownloadBills(billIds).then((blob) => {
+        downloadBlob(blob, "结算单批量下载.zip");
+      });
+    },
     remove(v) {
       this.$Modal.confirm({
         title: "确认删除",

seller/MIGRATION-VUE3.md

@@ -38,3 +38,7 @@ Node **16+**，包管理统一 **yarn**。商家后台默认端口见 `src/confi
 
 - `scripts/migrate-iview-to-element.js` — 从 manager 复制装修模板 + 批量替换
 - `scripts/copy-manager-migrations.js` — 从 manager 复制已迁移业务页
+
+## 上线前检查
+
+四端统一清单（认证、axios、Element Plus、分端专项）：[../MIGRATION-VUE3.md](../MIGRATION-VUE3.md)

seller/src/api/finance.js

@@ -0,0 +1,25 @@
+/**
+ * 商家端财务 API。
+ * 所有接口由后端强制限定为当前登录店铺，无需前端传 storeId。
+ */
+import { getRequest } from "@/libs/axios";
+
+/** 导出本店流水明细 */
+export const exportStoreFlow = (params) => {
+  return getRequest("/finance/store-flow/export", params, "blob");
+};
+
+/** 导出本店结算单列表 */
+export const exportBillList = (params) => {
+  return getRequest("/finance/bill-list/export", params, "blob");
+};
+
+/** 本店周期财务汇总查询 */
+export const getStoreSummary = (params) => {
+  return getRequest("/finance/report/store-summary", params);
+};
+
+/** 导出本店周期财务汇总 */
+export const exportStoreSummary = (params) => {
+  return getRequest("/finance/report/store-summary/export", params, "blob");
+};

seller/src/router/router.js

@@ -169,14 +169,12 @@ export const otherRouter = {
       name: "coupon-receive",
       component: () => import("@/views/promotion/coupon/coupon-receive.vue"),
     },
-    // {
+    {
-    //   path: "/*",
+      path: "shop-finance-summary",
-    //   name: "error-404",
+      title: "财务汇总",
-    //   meta: {
+      name: "shop-finance-summary",
-    //     title: "404-页面不存在"
+      component: () => import("@/views/shop/finance/summary.vue")
-    //   },
+    }
-    //   component: () => import("@/views/error-page/404.vue")
-    // }
   ]
 };
 

seller/src/utils/downloadBlob.js

@@ -0,0 +1,15 @@
+/**
+ * 触发浏览器下载 blob 响应
+ */
+export function downloadBlob(blob, filename) {
+  if (!blob) return;
+  const link = document.createElement("a");
+  link.style.display = "none";
+  const url = window.URL.createObjectURL(new Blob([blob]));
+  link.href = url;
+  link.download = filename;
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
+  window.URL.revokeObjectURL(url);
+}

seller/src/utils/filters.js

@@ -126,8 +126,6 @@ export function unixSellerBillStatus(status_code) {
       return "已出账";
     case "CHECK":
       return "已对账";
-    case "EXAMINE":
-      return "已审核";
     case "PAY":
       return "已结算";
     case "COMPLETE":

seller/src/views/shop/bill/accountStatementBill.vue

@@ -109,11 +109,11 @@ export default {
   },
   methods: {
     billStatusText(v) {
-      const map = { OUT: "已出账", CHECK: "已对账", EXAMINE: "已审核", COMPLETE: "已付款" };
+      const map = { OUT: "已出账", CHECK: "已对账", COMPLETE: "已付款" };
       return map[v] || "已付款";
     },
     billStatusTagType(v) {
-      const map = { OUT: "primary", CHECK: "", EXAMINE: "warning", COMPLETE: "success" };
+      const map = { OUT: "primary", CHECK: "warning", COMPLETE: "success" };
       return map[v] || "success";
     },
     init() {

seller/src/views/shop/bill/billDetail.vue

@@ -436,11 +436,11 @@ export default {
       API_Shop.downloadBill(this.id)
         .then((res) => {
           const blob = new Blob([res], {
-            type: "application/vnd.ms-excel;charset=utf-8",
+            type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
           });
           if ("download" in document.createElement("a")) {
             const link = document.createElement("a");
-            link.download = "结算单-" + this.id + ".xls";
+            link.download = "结算单-" + this.id + ".xlsx";
             link.style.display = "none";
             link.href = URL.createObjectURL(blob);
             document.body.appendChild(link);
@@ -448,7 +448,7 @@ export default {
             URL.revokeObjectURL(link.href);
             document.body.removeChild(link);
           } else {
-            navigator.msSaveBlob(blob, "结算单-" + this.id + ".xls");
+            navigator.msSaveBlob(blob, "结算单-" + this.id + ".xlsx");
           }
         })
         .catch((err) => {

seller/src/views/shop/bill/storeBill.vue

@@ -39,6 +39,7 @@
         <el-form-item>
           <el-button type="primary" class="search-btn" @click="handleSearch">搜索</el-button>
           <el-button class="search-btn" @click="handleReset">重置</el-button>
+          <el-button class="search-btn" @click="handleExport">导出列表</el-button>
         </el-form-item>
       </el-form>
     </el-card>
@@ -59,7 +60,6 @@
           <template #default="{ row }">
             <el-tag v-if="row.billStatus === 'OUT'" type="primary">已出账</el-tag>
             <el-tag v-else-if="row.billStatus === 'CHECK'" type="info">已对账</el-tag>
-            <el-tag v-else-if="row.billStatus === 'EXAMINE'" type="warning">已审核</el-tag>
             <el-tag v-else type="success">已付款</el-tag>
           </template>
         </el-table-column>
@@ -88,6 +88,8 @@
 
 <script>
 import * as API_Shop from "@/api/shops";
+import * as API_Finance from "@/api/finance";
+import { downloadBlob } from "@/utils/downloadBlob";
 
 export default {
   name: "storeBill",
@@ -149,6 +151,12 @@ export default {
         query: { id: v.id },
       });
     },
+    handleExport() {
+      const params = { ...this.searchForm };
+      API_Finance.exportBillList(params).then((blob) => {
+        downloadBlob(blob, "结算单列表.xlsx");
+      });
+    },
   },
   mounted() {
     this.init();

seller/src/views/shop/finance/summary.vue

@@ -0,0 +1,71 @@
+<template>
+  <div class="search">
+    <el-card>
+      <el-form inline>
+        <el-form-item label="日期范围">
+          <el-date-picker v-model="dateRange" type="daterange" value-format="YYYY-MM-DD" />
+        </el-form-item>
+        <el-form-item>
+          <el-button type="primary" @click="loadData">查询</el-button>
+          <el-button @click="handleExport">导出</el-button>
+          <el-button @click="exportFlow">导出流水</el-button>
+        </el-form-item>
+      </el-form>
+    </el-card>
+    <el-card class="mt_10" v-if="summary">
+      <el-descriptions title="本店周期汇总" :column="2" border>
+        <el-descriptions-item label="店铺">{{ summary.storeName }}</el-descriptions-item>
+        <el-descriptions-item label="订单实付">{{ summary.orderPrice }}</el-descriptions-item>
+        <el-descriptions-item label="退款">{{ summary.refundPrice }}</el-descriptions-item>
+        <el-descriptions-item label="平台服务费">{{ summary.commissionPrice }}</el-descriptions-item>
+        <el-descriptions-item label="分销佣金">{{ summary.distributionCommission }}</el-descriptions-item>
+        <el-descriptions-item label="券补贴">{{ summary.siteCouponCommission }}</el-descriptions-item>
+        <el-descriptions-item label="礼品卡补贴">{{ summary.giftCardSubsidy }}</el-descriptions-item>
+        <el-descriptions-item label="应结金额">{{ summary.billPrice }}</el-descriptions-item>
+      </el-descriptions>
+    </el-card>
+  </div>
+</template>
+
+<script>
+import * as API_Finance from "@/api/finance";
+import { downloadBlob } from "@/utils/downloadBlob";
+
+export default {
+  name: "shop-finance-summary",
+  data() {
+    return {
+      dateRange: [],
+      summary: null,
+    };
+  },
+  mounted() {
+    this.loadData();
+  },
+  methods: {
+    buildParams() {
+      const p = {};
+      if (this.dateRange?.length === 2) {
+        p.startDate = this.dateRange[0];
+        p.endDate = this.dateRange[1];
+      }
+      return p;
+    },
+    loadData() {
+      API_Finance.getStoreSummary(this.buildParams()).then((res) => {
+        if (res.success) this.summary = res.result;
+      });
+    },
+    handleExport() {
+      API_Finance.exportStoreSummary(this.buildParams()).then((blob) => {
+        downloadBlob(blob, "店铺周期汇总.xlsx");
+      });
+    },
+    exportFlow() {
+      API_Finance.exportStoreFlow(this.buildParams()).then((blob) => {
+        downloadBlob(blob, "店铺流水.xlsx");
+      });
+    },
+  },
+};
+</script>