基金产品净值分析系统 (Fund Product Net Value Analysis System)

项目简介 (Project Introduction)

本项目是一个专业的基金产品净值分析与可视化平台，旨在帮助用户快速分析基金产品的业绩表现。系统支持多维度的数据对比、灵活的时间周期筛选以及深度的金融指标计算，采用了现代化的前后端分离架构，界面简洁、高端且响应迅速。

核心功能 (Key Features)

多维度数据对比
- 支持选择特定的基金产品与市场基准指数（如沪深300、中证500等）进行对比分析。
- 实时计算并展示产品与指数的相对表现。
灵活的超额收益计算
- 提供两种专业的超额收益计算模式，满足不同分析需求：
  - 几何超额 (除法)：适用于复利视角的超额收益分析。
  - 算术超额 (作差)：适用于简单收益差值的分析。
- 切换计算模式时，数据表格与可视化图表会自动同步更新。
动态时间周期筛选
- 提供快捷的时间段选择（近1月、近3月、近6月、近1年、今年以来、成立以来）。
- 支持自定义起始日期模式，满足特定区间的分析需求。
专业可视化图表 (ECharts)
- 累计收益走势图：直观展示产品、指数及超额收益的净值曲线。
- 动态回撤图：精确描绘历史回撤情况，辅助风险评估。
关键金融指标统计
- 自动计算并展示：区间收益、最大回撤、年化波动率、夏普比率 (Sharpe Ratio)、卡玛比率 (Calmar Ratio) 等核心风控指标。
现代化 UI 设计
- 基于 Element Plus 组件库构建，风格简洁大气。
- 优化了布局稳定性，采用固定宽度的控制面板设计，防止切换选项时页面跳动。
- 全面支持中文本地化显示。

技术栈 (Tech Stack)

前端 (Frontend)

核心框架: Vue 3
构建工具: Vite
UI 组件库: Element Plus
图表库: Apache ECharts
HTTP 客户端: Axios
工具库: html2canvas, jspdf (支持报表导出)

后端 (Backend)

Web 框架: Flask
数据分析: Pandas, NumPy
数据库: MySQL

快速开始 (Quick Start)

1. 一键启动 (One-Click Start - Recommended)

项目根目录包含一个便捷的启动脚本 start.sh，可自动检测环境、启动后端与前端服务，并实时输出后端日志。

# 在项目根目录下运行 (需先赋予执行权限)
chmod +x start.sh
./start.sh

功能：自动启动 Flask 后端 (Port 5000) 和 Vite 前端 (Port 20201)。
停止：在终端按 Ctrl+C 即可同时停止前后端服务。
日志：启动后会自动追踪后端日志；日志文件保存在 log/ 目录下。

2. 手动启动 (Manual Start)

如果需要分别调试前后端，可使用以下步骤：

启动后端服务

请确保已安装 Python 环境及相关依赖。

cd backend
# 安装依赖 (如果尚未安装)
# pip install -r requirements.txt

# 启动应用
python app.py

默认运行在 http://localhost:5000

启动前端服务

请确保已安装 Node.js 环境。

cd frontend
# 安装依赖
npm install

# 启动开发服务器
npm run dev

默认运行在 http://localhost:20201

目录结构 (Directory Structure)

proj20260106/
├── backend/            # 后端 Flask 项目代码
│   ├── app.py          # 后端入口文件
│   ├── data_loader.py  # 数据库连接与数据加载
│   ├── calculator.py   # 金融指标计算核心逻辑
│   └── ...
├── frontend/           # 前端 Vue 3 项目代码
│   ├── src/            # 源代码
│   │   ├── App.vue     # 主页面组件 (包含核心布局与逻辑)
│   │   └── main.js     # 入口文件 (Element Plus 配置)
│   ├── package.json    # 前端依赖配置
│   └── ...
└── README.md           # 项目说明文档

fund-weekly-report