# finance

**Repository Path**: crazyants/finance

## Basic Information

- **Project Name**: finance
- **Description**: 财务开支情况
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: http://finance.momen.vip/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-21
- **Last Updated**: 2026-01-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 财务管理系统

这是一个基于现代Web技术构建的个人财务管理应用。

## 功能特点

- **支出管理** - 记录和追踪个人支出
- **资产管理** - 管理您的各类资产
- **AI配置** - 支持智能财务分析配置
- **数据可视化** - 清晰展示财务状况

## 技术栈

- **前端框架**: Next.js 14
- **UI组件库**: shadcn/ui
- **样式方案**: Tailwind CSS
- **图表工具**: Recharts
- **主题系统**: 支持亮色/暗色模式

## 快速开始

### 环境要求

- Node.js 18.17+
- pnpm (推荐) 或 npm/yarn

### 安装依赖

```bash
# 使用pnpm安装
pnpm install

# 或使用npm
npm install
```

### 运行开发服务器

```bash
# 启动开发服务器
pnpm dev

# 或
npm run dev
```

打开 [http://localhost:3000](http://localhost:3000) 查看应用。

## 项目结构

```
finance/
├── app/                    # Next.js 14 App Router
│   ├── page.tsx           # 主页面
│   ├── layout.tsx         # 根布局
│   └── globals.css        # 全局样式
├── components/
│   ├── ui/                # shadcn/ui 组件库
│   ├── theme-provider.tsx # 主题提供者
│   └── ...
├── hooks/                 # 自定义Hooks
│   ├── use-mobile.ts
│   └── use-toast.ts
├── lib/                   # 工具函数
│   └── utils.ts
├── public/               # 静态资源
└── styles/               # 样式文件
```

## 主要接口定义

### Expense (支出)
```typescript
interface Expense {
  id: string;
  amount: number;
  category: string;
  date: string;
  description: string;
}
```

### Asset (资产)
```typescript
interface Asset {
  id: string;
  name: string;
  type: string;
  value: number;
  createdAt: string;
}
```

### AIConfig (AI配置)
```typescript
interface AIConfig {
  provider: string;
  model: string;
  apiKey: string;
  enabled: boolean;
}
```

### FinanceData (财务数据)
```typescript
interface FinanceData {
  expenses: Expense[];
  assets: Asset[];
  aiConfig: AIConfig;
}
```

## 可用脚本

| 命令 | 描述 |
|------|------|
| `pnpm dev` | 启动开发服务器 |
| `pnpm build` | 构建生产版本 |
| `pnpm start` | 启动生产服务器 |
| `pnpm lint` | 运行代码检查 |

## 浏览器支持

- Chrome (最新版本)
- Firefox (最新版本)
- Safari (最新版本)
- Edge (最新版本)

## 许可证

MIT License