feat(@vben/web-antd): 新增 ERP API 接口并符合 Vben 项目标准

- 将所有 ERP API 文件从旧的 axios 配置迁移到新的 requestClient
- 使用 namespace 组织接口类型定义,提高代码可维护性
- 将对象方法改为独立的导出函数,符合现代 JavaScript 最佳实践
- 为所有 API 函数添加完整的 TypeScript 类型定义
- 统一分页查询参数和状态更新参数的接口定义
- 涵盖财务、采购、销售、库存等所有 ERP 业务模块
This commit is contained in:
nehc
2025-07-21 19:07:47 +08:00
committed by xingyu
parent 7b7402b986
commit f763ad2855
26 changed files with 2031 additions and 19 deletions

View File

@@ -1,7 +1,50 @@
<script lang="ts" setup>
import type { ErpPurchaseStatisticsApi } from '#/api/erp/statistics/purchase';
import type { ErpSaleStatisticsApi } from '#/api/erp/statistics/sale';
import { onMounted, ref } from 'vue';
import { DocAlert, Page } from '@vben/common-ui';
import { Button } from 'ant-design-vue';
import { Col, Row, Spin } from 'ant-design-vue';
import {
getPurchaseSummary,
getPurchaseTimeSummary,
} from '#/api/erp/statistics/purchase';
import { getSaleSummary, getSaleTimeSummary } from '#/api/erp/statistics/sale';
import SummaryCard from './components/SummaryCard.vue';
import TimeSummaryChart from './components/TimeSummaryChart.vue';
/** ERP首页 */
defineOptions({ name: 'ErpHome' });
const loading = ref(true); // 加载中
/** 获得销售统计 */
const saleSummary = ref<ErpSaleStatisticsApi.SaleSummary>(); // 销售概况统计
const saleTimeSummaryList = ref<ErpSaleStatisticsApi.SaleTimeSummary[]>(); // 销售时段统计
const getSaleStatistics = async () => {
saleSummary.value = await getSaleSummary();
saleTimeSummaryList.value = await getSaleTimeSummary();
};
/** 获得采购统计 */
const purchaseSummary = ref<ErpPurchaseStatisticsApi.PurchaseSummary>(); // 采购概况统计
const purchaseTimeSummaryList =
ref<ErpPurchaseStatisticsApi.PurchaseTimeSummary[]>(); // 采购时段统计
const getPurchaseStatistics = async () => {
purchaseSummary.value = await getPurchaseSummary();
purchaseTimeSummaryList.value = await getPurchaseTimeSummary();
};
/** 初始化 */
onMounted(async () => {
loading.value = true;
await Promise.all([getSaleStatistics(), getPurchaseStatistics()]);
loading.value = false;
});
</script>
<template>
@@ -12,23 +55,64 @@ import { Button } from 'ant-design-vue';
url="https://doc.iocoder.cn/erp/build/"
/>
</template>
<Button
danger
type="link"
target="_blank"
href="https://github.com/yudaocode/yudao-ui-admin-vue3"
>
该功能支持 Vue3 + element-plus 版本
</Button>
<br />
<Button
type="link"
target="_blank"
href="https://github.com/yudaocode/yudao-ui-admin-vue3/blob/master/src/views/erp/home/index.vue"
>
可参考
https://github.com/yudaocode/yudao-ui-admin-vue3/blob/master/src/views/erp/home/index.vue
代码pull request 贡献给我们
</Button>
<Spin :spinning="loading">
<div class="flex flex-col gap-4">
<!-- 销售/采购的全局统计 -->
<Row :gutter="16">
<Col :md="6" :sm="12" :xs="24">
<SummaryCard title="今日销售" :value="saleSummary?.todayPrice" />
</Col>
<Col :md="6" :sm="12" :xs="24">
<SummaryCard
title="昨日销售"
:value="saleSummary?.yesterdayPrice"
/>
</Col>
<Col :md="6" :sm="12" :xs="24">
<SummaryCard
title="今日采购"
:value="purchaseSummary?.todayPrice"
/>
</Col>
<Col :md="6" :sm="12" :xs="24">
<SummaryCard
title="昨日采购"
:value="purchaseSummary?.yesterdayPrice"
/>
</Col>
<Col :md="6" :sm="12" :xs="24">
<SummaryCard title="本月销售" :value="saleSummary?.monthPrice" />
</Col>
<Col :md="6" :sm="12" :xs="24">
<SummaryCard title="今年销售" :value="saleSummary?.yearPrice" />
</Col>
<Col :md="6" :sm="12" :xs="24">
<SummaryCard
title="本月采购"
:value="purchaseSummary?.monthPrice"
/>
</Col>
<Col :md="6" :sm="12" :xs="24">
<SummaryCard title="今年采购" :value="purchaseSummary?.yearPrice" />
</Col>
</Row>
<!-- 销售/采购的时段统计 -->
<Row :gutter="16">
<!-- 销售统计 -->
<Col :md="12" :sm="12" :xs="24">
<TimeSummaryChart title="销售统计" :value="saleTimeSummaryList" />
</Col>
<!-- 采购统计 -->
<Col :md="12" :sm="12" :xs="24">
<TimeSummaryChart
title="采购统计"
:value="purchaseTimeSummaryList"
/>
</Col>
</Row>
</div>
</Spin>
</Page>
</template>