refactor: 整合财务系统到主应用并重构后端架构
主要变更: - 将独立的 web-finance 应用整合到 web-antd 主应用中 - 重命名 backend-mock 为 backend,增强后端功能 - 新增财务模块 API 端点(账户、预算、类别、交易) - 增强财务仪表板和报表功能 - 添加 SQLite 数据存储支持和财务数据导入脚本 - 优化路由结构,删除冗余的 finance-system 模块 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
woshiqp465
281
apps/web-antd/src/api/core/finance.ts
Normal file
281
apps/web-antd/src/api/core/finance.ts
Normal file
@@ -0,0 +1,281 @@
|
||||
import { requestClient } from '../request';
|
||||
|
||||
export namespace FinanceApi {
|
||||
// 货币类型
|
||||
export interface Currency {
|
||||
code: string;
|
||||
name: string;
|
||||
symbol: string;
|
||||
isBase: boolean;
|
||||
isActive: boolean;
|
||||
}
|
||||
|
||||
// 分类
|
||||
export interface Category {
|
||||
id: number;
|
||||
userId?: number | null;
|
||||
name: string;
|
||||
type: 'income' | 'expense';
|
||||
icon: string;
|
||||
color: string;
|
||||
sortOrder?: number;
|
||||
isSystem?: boolean;
|
||||
isActive?: boolean;
|
||||
}
|
||||
|
||||
// 账户
|
||||
export interface Account {
|
||||
id: number;
|
||||
userId?: number;
|
||||
name: string;
|
||||
type: 'cash' | 'bank' | 'alipay' | 'wechat' | 'virtual_wallet' | 'investment' | 'credit_card';
|
||||
currency: string;
|
||||
balance?: number;
|
||||
icon?: string;
|
||||
color?: string;
|
||||
isActive?: boolean;
|
||||
}
|
||||
|
||||
// 汇率
|
||||
export interface ExchangeRate {
|
||||
id: number;
|
||||
fromCurrency: string;
|
||||
toCurrency: string;
|
||||
rate: number;
|
||||
date: string;
|
||||
source: 'manual' | 'api' | 'system';
|
||||
}
|
||||
|
||||
// 交易
|
||||
export interface Transaction {
|
||||
id: number;
|
||||
userId: number;
|
||||
type: 'income' | 'expense' | 'transfer';
|
||||
amount: number;
|
||||
currency: string;
|
||||
exchangeRateToBase: number;
|
||||
amountInBase: number;
|
||||
categoryId?: number | null;
|
||||
accountId?: number | null;
|
||||
transactionDate: string;
|
||||
description: string;
|
||||
project?: string;
|
||||
memo?: string;
|
||||
createdAt: string;
|
||||
isDeleted?: boolean;
|
||||
deletedAt?: string;
|
||||
}
|
||||
|
||||
// 创建交易的参数
|
||||
export interface CreateTransactionParams {
|
||||
type: 'income' | 'expense' | 'transfer';
|
||||
amount: number;
|
||||
currency: string;
|
||||
categoryId?: number;
|
||||
accountId?: number;
|
||||
transactionDate: string;
|
||||
description?: string;
|
||||
project?: string;
|
||||
memo?: string;
|
||||
createdAt?: string;
|
||||
}
|
||||
|
||||
// 预算
|
||||
export interface Budget {
|
||||
id: number;
|
||||
userId: number;
|
||||
category: string;
|
||||
categoryId?: number;
|
||||
emoji: string;
|
||||
limit: number;
|
||||
spent: number;
|
||||
remaining: number;
|
||||
percentage: number;
|
||||
currency: string;
|
||||
period: 'monthly' | 'weekly' | 'quarterly' | 'yearly';
|
||||
alertThreshold: number;
|
||||
description?: string;
|
||||
autoRenew: boolean;
|
||||
overspendAlert: boolean;
|
||||
dailyReminder: boolean;
|
||||
monthlyTrend?: number;
|
||||
createdAt: string;
|
||||
isDeleted?: boolean;
|
||||
deletedAt?: string;
|
||||
}
|
||||
|
||||
// 创建预算的参数
|
||||
export interface CreateBudgetParams {
|
||||
category: string;
|
||||
categoryId?: number;
|
||||
emoji: string;
|
||||
limit: number;
|
||||
spent?: number;
|
||||
remaining?: number;
|
||||
percentage?: number;
|
||||
currency: string;
|
||||
period: 'monthly' | 'weekly' | 'quarterly' | 'yearly';
|
||||
alertThreshold: number;
|
||||
description?: string;
|
||||
autoRenew: boolean;
|
||||
overspendAlert: boolean;
|
||||
dailyReminder: boolean;
|
||||
monthlyTrend?: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取所有货币
|
||||
*/
|
||||
export async function getCurrencies() {
|
||||
return requestClient.get<Currency[]>('/finance/currencies');
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取分类
|
||||
*/
|
||||
export async function getCategories(params?: { type?: 'income' | 'expense' | 'transfer' }) {
|
||||
return requestClient.get<Category[]>('/finance/categories', { params });
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建分类
|
||||
*/
|
||||
export async function createCategory(data: {
|
||||
name: string;
|
||||
type: 'income' | 'expense';
|
||||
icon?: string;
|
||||
color?: string;
|
||||
}) {
|
||||
return requestClient.post<Category | null>('/finance/categories', data);
|
||||
}
|
||||
|
||||
/**
|
||||
* 更新分类
|
||||
*/
|
||||
export async function updateCategory(
|
||||
id: number,
|
||||
data: {
|
||||
name?: string;
|
||||
icon?: string;
|
||||
color?: string;
|
||||
sortOrder?: number;
|
||||
},
|
||||
) {
|
||||
return requestClient.put<Category | null>(`/finance/categories/${id}`, data);
|
||||
}
|
||||
|
||||
/**
|
||||
* 删除分类
|
||||
*/
|
||||
export async function deleteCategory(id: number) {
|
||||
return requestClient.delete<{ message: string }>(
|
||||
`/finance/categories/${id}`,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取账户
|
||||
*/
|
||||
export async function getAccounts(params?: { currency?: string }) {
|
||||
return requestClient.get<Account[]>('/finance/accounts', { params });
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取汇率
|
||||
*/
|
||||
export async function getExchangeRates(params?: {
|
||||
from?: string;
|
||||
to?: string;
|
||||
date?: string;
|
||||
}) {
|
||||
return requestClient.get<ExchangeRate[]>('/finance/exchange-rates', {
|
||||
params,
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取交易列表
|
||||
*/
|
||||
export async function getTransactions(params?: {
|
||||
type?: 'income' | 'expense' | 'transfer';
|
||||
}) {
|
||||
return requestClient.get<Transaction[]>('/finance/transactions', {
|
||||
params,
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建交易
|
||||
*/
|
||||
export async function createTransaction(data: CreateTransactionParams) {
|
||||
return requestClient.post<Transaction>('/finance/transactions', data);
|
||||
}
|
||||
|
||||
/**
|
||||
* 更新交易
|
||||
*/
|
||||
export async function updateTransaction(
|
||||
id: number,
|
||||
data: Partial<CreateTransactionParams>,
|
||||
) {
|
||||
return requestClient.put<Transaction>(`/finance/transactions/${id}`, data);
|
||||
}
|
||||
|
||||
/**
|
||||
* 软删除交易
|
||||
*/
|
||||
export async function deleteTransaction(id: number) {
|
||||
return requestClient.delete<{ message: string }>(
|
||||
`/finance/transactions/${id}`,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* 恢复交易
|
||||
*/
|
||||
export async function restoreTransaction(id: number) {
|
||||
return requestClient.put<Transaction>(`/finance/transactions/${id}`, {
|
||||
isDeleted: false,
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取预算列表
|
||||
*/
|
||||
export async function getBudgets() {
|
||||
return requestClient.get<Budget[]>('/finance/budgets');
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建预算
|
||||
*/
|
||||
export async function createBudget(data: CreateBudgetParams) {
|
||||
return requestClient.post<Budget>('/finance/budgets', data);
|
||||
}
|
||||
|
||||
/**
|
||||
* 更新预算
|
||||
*/
|
||||
export async function updateBudget(
|
||||
id: number,
|
||||
data: Partial<CreateBudgetParams>,
|
||||
) {
|
||||
return requestClient.put<Budget>(`/finance/budgets/${id}`, data);
|
||||
}
|
||||
|
||||
/**
|
||||
* 删除预算
|
||||
*/
|
||||
export async function deleteBudget(id: number) {
|
||||
return requestClient.delete<{ message: string }>(`/finance/budgets/${id}`);
|
||||
}
|
||||
|
||||
/**
|
||||
* 恢复预算
|
||||
*/
|
||||
export async function restoreBudget(id: number) {
|
||||
return requestClient.put<Budget>(`/finance/budgets/${id}`, {
|
||||
isDeleted: false,
|
||||
});
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user