# FundAssistant

**Repository Path**: mingeeker/fund-assistant

## Basic Information

- **Project Name**: FundAssistant
- **Description**: 实时查询基金估值，管理您的自选基金
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-02-08
- **Last Updated**: 2026-02-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基金助手 - 实时估值查询系统

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Node.js](https://img.shields.io/badge/node-%3E%3D14.0.0-brightgreen.svg)](https://nodejs.org/)
[![Vue.js](https://img.shields.io/badge/vue-3.x-brightgreen.svg)](https://vuejs.org/)

这是一个基于Vue.js前端和Node.js后端的基金实时估值查询系统，提供现代化的黑色科技风格界面，帮助用户轻松管理自选基金并获取实时估值信息。

## 🌟 功能特性

- **🔍 基金查询**：通过基金代码快速查询基金信息，包含基金名称、净值、涨跌幅等
- **⭐ 基金自选**：将关注的基金添加到自选列表，方便统一管理
- **📈 实时估值**：获取自选基金的实时估值信息和涨跌情况
- **🎨 黑色科技风格**：现代化的暗色主题设计，青色科技感配色
- **📊 涨跌标识**：红色表示上涨，绿色表示下跌（符合金融行业标准）
- **📱 响应式布局**：左侧查询区域，右侧自选展示，适配不同屏幕尺寸
- **⚡ 悬停交互**：删除按钮悬停显示，提升用户体验
- **🔄 实时刷新**：支持单个基金和全部基金估值刷新

## 🛠 技术架构

### 前端技术栈
- **Vue 3** - 渐进式JavaScript框架
- **原生JavaScript** - 无额外构建工具依赖
- **CSS3** - 现代化样式和动画效果
- **Axios** - HTTP客户端库

### 后端技术栈
- **Node.js** - JavaScript运行时环境
- **Express.js** - Web应用框架
- **天天基金网API** - 实时基金数据源
- **JSON文件存储** - 简单的本地数据存储

## 📁 项目结构

```
FundAssistant/
├── backend/                 # 后端服务
│   ├── controllers/         # 控制器
│   │   ├── fundController.js    # 基金相关控制器
│   │   └── favoriteController.js # 自选基金控制器
│   ├── data/               # 数据存储
│   │   └── favorites.json       # 自选基金数据文件
│   ├── routes/             # API路由
│   │   ├── funds.js        # 基金相关路由
│   │   └── favorites.js    # 自选基金路由
│   ├── server.js           # 服务器入口文件
│   └── package.json        # 后端依赖配置
├── frontend/               # Vue前端应用
│   ├── index.html          # 主页面文件
│   └── package.json        # 前端依赖配置
└── README.md               # 项目说明文档
```

## 🚀 快速开始

### 环境要求
- Node.js >= 14.0.0
- npm >= 6.0.0

### 后端启动

```bash
# 进入后端目录
cd FundAssistant/backend

# 安装依赖
npm install

# 启动服务
npm start
```

服务器将在 `http://localhost:3000` 启动

### 前端启动

```bash
# 进入前端目录
cd FundAssistant/frontend

# 安装依赖
npm install

# 启动前端服务（使用Python简单服务器）
python3 -m http.server 3001
```

前端将在 `http://localhost:3001` 启动

### 或者使用Node.js服务器启动前端

```bash
# 在前端目录下
npx serve -s . -p 3001
```

## 📡 API 接口文档

### 基金相关接口

| 接口 | 方法 | 描述 | 示例 |
|------|------|------|------|
| `/api/funds/search/:code` | GET | 查询基金信息 | `GET /api/funds/search/000001` |
| `/api/funds/estimate/:code` | GET | 获取基金实时估值 | `GET /api/funds/estimate/000001` |

### 自选基金接口

| 接口 | 方法 | 描述 | 示例 |
|------|------|------|------|
| `/api/favorites` | GET | 获取自选基金列表 | `GET /api/favorites` |
| `/api/favorites` | POST | 添加基金到自选 | `POST /api/favorites` |
| `/api/favorites/:code` | DELETE | 从自选中删除基金 | `DELETE /api/favorites/000001` |
| `/api/favorites/estimates` | GET | 获取自选基金实时估值 | `GET /api/favorites/estimates` |

### 响应示例

**基金查询响应：**
```json
{
  "success": true,
  "data": {
    "code": "000001",
    "name": "华夏成长混合",
    "netWorth": "1.1220",
    "date": "2026-02-08",
    "dailyGrowth": "-0.33%"
  }
}
```

**基金估值响应：**
```json
{
  "success": true,
  "data": {
    "code": "000001",
    "name": "华夏成长混合",
    "estimateValue": "1.1183",
    "estimateGrowth": "-0.33%",
    "lastUpdate": "2026-02-08T04:31:06.355Z"
  }
}
```

## 🎮 使用指南

1. **基金查询**：在左侧查询框中输入基金代码（如：000001），点击"查询基金"
2. **添加自选**：在查询结果中点击"添加到自选"按钮
3. **查看自选**：在右侧自选区域查看所有自选基金
4. **刷新估值**：使用"刷新"按钮更新单个基金估值，或使用"刷新全部估值"更新所有基金
5. **删除基金**：将鼠标悬停在自选基金卡片上，点击右上角的"删除"按钮

## 🎨 界面特色

### 设计理念
- **黑色科技风格**：深色背景配青色主题色，营造专业科技感
- **简洁直观**：去除冗余装饰，突出核心功能
- **交互友好**：悬停效果和动画过渡提升用户体验

### 配色方案
- **主色调**：青色 `#00ffff` - 科技感、现代感
- **背景色**：深黑色 `#0a0a0a` - 专业、护眼
- **文字色**：浅灰色 `#e0e0e0` - 清晰易读
- **涨跌色**：红色上涨 `#ff4444`，绿色下跌 `#44ff44`

## ⚠️ 注意事项

- 本项目使用免费的基金数据API，可能会有限流限制
- 基金实时估值仅在交易日提供准确数据
- 项目使用JSON文件存储自选列表，生产环境建议使用数据库
- 前端采用原生HTML+Vue，无需构建工具即可运行

## 📈 开发路线图

- [x] 基金自选功能
- [x] 基金查询功能  
- [x] 自选基金实时估值
- [x] 黑色科技风格界面
- [x] 响应式布局设计
- [x] 悬停交互效果
- [ ] 数据库集成
- [ ] 用户认证系统
- [ ] 基金对比功能
- [ ] 历史数据图表
- [ ] 移动端适配优化

## 🤝 贡献指南

欢迎提交Issue和Pull Request来帮助改进项目：

1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 🙏 致谢

- [天天基金网](https://fund.eastmoney.com/) - 提供基金数据API
- [Vue.js](https://vuejs.org/) - 前端框架
- [Node.js](https://nodejs.org/) - 后端运行环境
- [Express.js](https://expressjs.com/) - Web框架

---
<p align="center">
  Made with ❤️ by FundAssistant Team
</p>