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

- 将所有 ERP API 文件从旧的 axios 配置迁移到新的 requestClient - 使用 namespace 组织接口类型定义，提高代码可维护性 - 将对象方法改为独立的导出函数，符合现代 JavaScript 最佳实践 - 为所有 API 函数添加完整的 TypeScript 类型定义 - 统一分页查询参数和状态更新参数的接口定义 - 涵盖财务、采购、销售、库存等所有 ERP 业务模块
2025-07-21 19:07:47 +08:00
parent 7b7402b986
commit f763ad2855
26 changed files with 2031 additions and 19 deletions
--- a/apps/web-antd/src/api/erp/finance/account/index.ts
+++ b/apps/web-antd/src/api/erp/finance/account/index.ts
@@ -0,0 +1,68 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ErpAccountApi {
+  /** ERP 结算账户信息 */
+  export interface Account {
+    id?: number; // 结算账户编号
+    no: string; // 账户编码
+    remark: string; // 备注
+    status: number; // 开启状态
+    sort: number; // 排序
+    defaultStatus: boolean; // 是否默认
+    name: string; // 账户名称
+  }
+
+  /** 结算账户分页查询参数 */
+  export interface AccountPageParam extends PageParam {
+    name?: string;
+    no?: string;
+    status?: number;
+  }
+}
+
+/** 查询结算账户分页 */
+export function getAccountPage(params: ErpAccountApi.AccountPageParam) {
+  return requestClient.get<PageResult<ErpAccountApi.Account>>(
+    '/erp/account/page',
+    { params },
+  );
+}
+
+/** 查询结算账户精简列表 */
+export function getAccountSimpleList() {
+  return requestClient.get<ErpAccountApi.Account[]>('/erp/account/simple-list');
+}
+
+/** 查询结算账户详情 */
+export function getAccount(id: number) {
+  return requestClient.get<ErpAccountApi.Account>(`/erp/account/get?id=${id}`);
+}
+
+/** 新增结算账户 */
+export function createAccount(data: ErpAccountApi.Account) {
+  return requestClient.post('/erp/account/create', data);
+}
+
+/** 修改结算账户 */
+export function updateAccount(data: ErpAccountApi.Account) {
+  return requestClient.put('/erp/account/update', data);
+}
+
+/** 修改结算账户默认状态 */
+export function updateAccountDefaultStatus(id: number, defaultStatus: boolean) {
+  return requestClient.put('/erp/account/update-default-status', null, {
+    params: { id, defaultStatus },
+  });
+}
+
+/** 删除结算账户 */
+export function deleteAccount(id: number) {
+  return requestClient.delete(`/erp/account/delete?id=${id}`);
+}
+
+/** 导出结算账户 Excel */
+export function exportAccount(params: any) {
+  return requestClient.download('/erp/account/export-excel', { params });
+}
--- a/apps/web-antd/src/api/erp/finance/payment/index.ts
+++ b/apps/web-antd/src/api/erp/finance/payment/index.ts
@@ -0,0 +1,103 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+namespace ErpFinancePaymentApi {
+  /** 付款单信息 */
+  export interface FinancePayment {
+    id?: number; // 付款单编号
+    no: string; // 付款单号
+    supplierId: number; // 供应商编号
+    paymentTime: Date; // 付款时间
+    totalPrice: number; // 合计金额，单位：元
+    status: number; // 状态
+    remark: string; // 备注
+  }
+
+  /** 付款单分页查询参数 */
+  export interface FinancePaymentPageParams extends PageParam {
+    no?: string;
+    supplierId?: number;
+    status?: number;
+  }
+
+  /** 付款单状态更新参数 */
+  export interface FinancePaymentStatusParams {
+    id: number;
+    status: number;
+  }
+}
+
+/**
+ * 查询付款单分页
+ */
+export function getFinancePaymentPage(
+  params: ErpFinancePaymentApi.FinancePaymentPageParams,
+) {
+  return requestClient.get<PageResult<ErpFinancePaymentApi.FinancePayment>>(
+    '/erp/finance-payment/page',
+    {
+      params,
+    },
+  );
+}
+
+/**
+ * 查询付款单详情
+ */
+export function getFinancePayment(id: number) {
+  return requestClient.get<ErpFinancePaymentApi.FinancePayment>(
+    `/erp/finance-payment/get?id=${id}`,
+  );
+}
+
+/**
+ * 新增付款单
+ */
+export function createFinancePayment(
+  data: ErpFinancePaymentApi.FinancePayment,
+) {
+  return requestClient.post('/erp/finance-payment/create', data);
+}
+
+/**
+ * 修改付款单
+ */
+export function updateFinancePayment(
+  data: ErpFinancePaymentApi.FinancePayment,
+) {
+  return requestClient.put('/erp/finance-payment/update', data);
+}
+
+/**
+ * 更新付款单的状态
+ */
+export function updateFinancePaymentStatus(
+  params: ErpFinancePaymentApi.FinancePaymentStatusParams,
+) {
+  return requestClient.put('/erp/finance-payment/update-status', null, {
+    params,
+  });
+}
+
+/**
+ * 删除付款单
+ */
+export function deleteFinancePayment(ids: number[]) {
+  return requestClient.delete('/erp/finance-payment/delete', {
+    params: {
+      ids: ids.join(','),
+    },
+  });
+}
+
+/**
+ * 导出付款单 Excel
+ */
+export function exportFinancePayment(
+  params: ErpFinancePaymentApi.FinancePaymentPageParams,
+) {
+  return requestClient.download('/erp/finance-payment/export-excel', {
+    params,
+  });
+}
--- a/apps/web-antd/src/api/erp/finance/receipt/index.ts
+++ b/apps/web-antd/src/api/erp/finance/receipt/index.ts
@@ -0,0 +1,103 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+namespace ErpFinanceReceiptApi {
+  /** 收款单信息 */
+  export interface FinanceReceipt {
+    id?: number; // 收款单编号
+    no: string; // 收款单号
+    customerId: number; // 客户编号
+    receiptTime: Date; // 收款时间
+    totalPrice: number; // 合计金额，单位：元
+    status: number; // 状态
+    remark: string; // 备注
+  }
+
+  /** 收款单分页查询参数 */
+  export interface FinanceReceiptPageParams extends PageParam {
+    no?: string;
+    customerId?: number;
+    status?: number;
+  }
+
+  /** 收款单状态更新参数 */
+  export interface FinanceReceiptStatusParams {
+    id: number;
+    status: number;
+  }
+}
+
+/**
+ * 查询收款单分页
+ */
+export function getFinanceReceiptPage(
+  params: ErpFinanceReceiptApi.FinanceReceiptPageParams,
+) {
+  return requestClient.get<PageResult<ErpFinanceReceiptApi.FinanceReceipt>>(
+    '/erp/finance-receipt/page',
+    {
+      params,
+    },
+  );
+}
+
+/**
+ * 查询收款单详情
+ */
+export function getFinanceReceipt(id: number) {
+  return requestClient.get<ErpFinanceReceiptApi.FinanceReceipt>(
+    `/erp/finance-receipt/get?id=${id}`,
+  );
+}
+
+/**
+ * 新增收款单
+ */
+export function createFinanceReceipt(
+  data: ErpFinanceReceiptApi.FinanceReceipt,
+) {
+  return requestClient.post('/erp/finance-receipt/create', data);
+}
+
+/**
+ * 修改收款单
+ */
+export function updateFinanceReceipt(
+  data: ErpFinanceReceiptApi.FinanceReceipt,
+) {
+  return requestClient.put('/erp/finance-receipt/update', data);
+}
+
+/**
+ * 更新收款单的状态
+ */
+export function updateFinanceReceiptStatus(
+  params: ErpFinanceReceiptApi.FinanceReceiptStatusParams,
+) {
+  return requestClient.put('/erp/finance-receipt/update-status', null, {
+    params,
+  });
+}
+
+/**
+ * 删除收款单
+ */
+export function deleteFinanceReceipt(ids: number[]) {
+  return requestClient.delete('/erp/finance-receipt/delete', {
+    params: {
+      ids: ids.join(','),
+    },
+  });
+}
+
+/**
+ * 导出收款单 Excel
+ */
+export function exportFinanceReceipt(
+  params: ErpFinanceReceiptApi.FinanceReceiptPageParams,
+) {
+  return requestClient.download('/erp/finance-receipt/export-excel', {
+    params,
+  });
+}