Skip to content

Latest commit

 

History

History
147 lines (113 loc) · 3.85 KB

README.md

File metadata and controls

147 lines (113 loc) · 3.85 KB
Raw

基金持仓分析系统

基金持仓分析系统

功能特性 • 快速开始 • 技术架构 • API文档 • 开发计划

License Version Python

Windows MacOS Linux

## 📖 项目介绍

基金持仓分析系统是一个基于 Dash 构建的基金投资组合可视化分析工具。本项目旨在帮助投资者更好地管理和分析其基金投资组合。

⚠️ 注意：这是一个用于学习 Dash 的练手项目，目前还在开发中，请勿用于生产环境。

系统界面

账户与组合管理

账户与组合管理界面

✨ 功能特性

  • 📊 基金投资组合可视化分析
  • 💼 多账户管理与切换
  • 📈 持仓分析与收益计算
  • 🔄 自动数据同步更新
  • 📱 响应式界面设计

🚀 快速开始

环境要求

  • Python 3.8+
  • SQLite3

安装步骤

  1. 克隆仓库
git clone https://github.com/yourusername/fund-analysis.git
cd fund-analysis
  1. 运行应用
./start.sh
基金选择器

启动脚本

访问 http://localhost:8050 即可使用系统。API文档地址: http://localhost:8050/api/doc

🏗️ 技术架构

前端技术栈

  • Dash Framework - 构建交互式 Web 应用
  • Feffery Ant Design Components - UI 组件库

后端技术栈

  • Flask - Web 框架
  • Flask-RESTX - RESTful API 框架
  • SQLite3 - 数据存储
  • Peewee ORM - 对象关系映射

📁 项目结构

fund-analysis/
├── app.py # 主应用程序入口
├── backend/ # 后端API实现
├── components/ # 前端可复用组件
├── models/ # 数据模型定义
├── pages/ # 页面组件
├── utils/ # 工具函数
├── config.py # 配置文件
└── requirements.txt # 项目依赖

📚 API 文档

运行时 API

接口 方法 描述
/api/runtime/status GET 获取系统运行状态

账户管理 API

接口 方法 描述
/api/accounts GET 获取账户列表
/api/accounts POST 创建新账户
/api/accounts/<id> GET 获取账户详情

更多 API 详情请参考 API 文档

📋 开发计划

  • 基础框架搭建
  • 数据模型设计
  • RESTful API 实现
  • 统一响应格式
  • ORM 集成
  • 账户管理功能
  • 数据库迁移
  • vscode/cursor 调试配置
  • 业务组件：基金代码选择器
  • 数据源管理
  • 任务管理
  • 完善日志功能
  • 单元测试
  • 基金数据导入
  • 持仓分析功能
  • 收益分析功能
  • 风险评估模块

🤝 贡献指南

欢迎贡献代码！请查看 CONTRIBUTING.md 了解如何参与项目开发。

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 了解详情

📮 联系方式

如有问题或建议，欢迎提 Issue 或 PR。

如果这个项目对你有帮助，欢迎 star ⭐️