Skip to content

WangOldSIX/personal_financial_system

Repository files navigation

个人财务管理系统

一个基于Flask开发的全功能个人财务管理系统,支持多源数据导入、专业财务报表分析和智能理财规划。

✨ 核心功能

📊 多源数据导入

  • 微信支付 - 支持微信账单CSV格式导入
  • 支付宝 - 支持支付宝交易记录导入
  • 银行卡 - 支持银行流水Excel/CSV导入
  • 手动录入 - 灵活的交易数据手动录入
  • 智能分类 - 基于AI算法的自动交易分类

📈 专业财务报表

  • 资产负债表 - 全面展示个人资产与负债状况
  • 利润表(损益表) - 详细分析收入支出结构
  • 现金流量表 - 追踪现金流入流出情况
  • 月度对比 - 历史数据趋势分析

🎯 智能财务分析

  • 财务健康评分 - 基于多维度指标的综合评估
  • 支出结构分析 - 可视化支出分布和异常检测
  • 收入稳定性 - 收入波动性和可预测性分析
  • 预算差异分析 - 实际支出与预算的对比

🚀 个性化理财规划

  • 现金流预测 - 基于历史数据的未来现金流预测
  • 投资建议 - 个性化的投资组合建议
  • 储蓄规划 - 定制化的储蓄目标和达成计划
  • 债务管理 - 智能的债务偿还策略建议

🛠️ 技术架构

后端技术栈

  • 框架: Flask 2.3.3
  • 数据库: SQLAlchemy + SQLite
  • 数据处理: Pandas + NumPy
  • 图表: Chart.js + Plotly

前端技术栈

  • UI框架: Bootstrap 5
  • 图标: Font Awesome 6
  • 图表: Chart.js
  • 交互: jQuery + 原生JavaScript

系统架构

个人财务系统/
├── app.py              # Flask主应用
├── database.py         # 数据库配置
├── run.py             # 启动脚本
├── config.py          # 系统配置
├── requirements.txt   # 依赖管理
├── models/            # 数据模型
│   ├── account.py     # 账户模型
│   ├── transaction.py # 交易模型
│   └── category.py    # 分类模型
├── services/          # 业务服务
│   ├── data_importer.py      # 数据导入
│   ├── financial_reports.py  # 财务报表
│   └── financial_planner.py  # 财务规划
├── templates/         # HTML模板
├── static/           # 静态资源
└── utils/            # 工具函数

🚀 快速开始

环境要求

  • Python 3.8+
  • 现代浏览器 (Chrome/Firefox/Safari/Edge)

安装步骤

  1. 克隆项目
git clone https://github.com/your-repo/personal-financial-system.git
cd personal-financial-system
  1. 安装依赖
pip install -r requirements.txt
  1. 启动系统
# 启动系统(不含示例数据)
python run.py

# 启动系统并创建示例数据
python run.py --sample
  1. 访问系统 打开浏览器访问 http://localhost:5000

📚 使用指南

第一次使用

  1. 导入数据

    • 进入"数据导入"页面
    • 选择数据源(微信/支付宝/银行卡)
    • 上传对应的账单文件
    • 系统自动解析并分类交易数据
  2. 查看报表

    • 进入"财务报表"页面
    • 查看资产负债表了解财务状况
    • 分析利润表掌握收支结构
    • 追踪现金流量表监控资金流动
  3. 财务规划

    • 进入"财务规划"页面
    • 查看财务健康评分
    • 获取个性化理财建议
    • 设定财务目标和储蓄计划

数据导入格式

微信支付

导出的CSV文件应包含以下字段:

  • 交易时间
  • 交易类型
  • 交易对方
  • 商品
  • 收/支
  • 金额(元)
  • 支付方式
  • 当前状态
  • 交易单号

支付宝

导出的CSV文件应包含以下字段:

  • 交易号
  • 商家订单号
  • 交易创建时间
  • 付款时间
  • 交易对方
  • 商品名称
  • 金额(元)
  • 收/支
  • 交易状态

银行卡

Excel/CSV文件应包含以下字段:

  • 交易日期
  • 交易描述/摘要
  • 交易金额
  • 余额
  • 备注

🎨 界面预览

仪表板

  • 关键财务指标概览
  • 收支趋势图表
  • 账户状况展示
  • 最近交易记录

财务报表

  • 专业的三大财务报表
  • 可视化图表分析
  • 历史数据对比
  • 一键导出功能

财务规划

  • 财务健康评分
  • 智能理财建议
  • 现金流预测
  • 目标设定工具

🔒 数据安全

  • 本地存储: 所有数据存储在本地SQLite数据库
  • 隐私保护: 不会上传任何敏感信息到外部服务器
  • 数据加密: 可配置数据库加密保护
  • 访问控制: 支持用户认证和权限管理

🛡️ 系统特性

稳定性

  • 完善的错误处理机制
  • 数据备份和恢复功能
  • 系统日志记录

可扩展性

  • 模块化设计
  • 插件化架构
  • API接口支持

用户体验

  • 响应式设计
  • 直观的操作界面
  • 丰富的数据可视化

📋 开发计划

v1.1 (计划中)

  • 移动端App
  • 数据导出功能
  • 多用户支持
  • 云端同步

v1.2 (计划中)

  • 投资组合管理
  • 定期报告邮件
  • API接口开放
  • 第三方集成

🤝 贡献指南

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

开发环境搭建

# 安装开发依赖
pip install -r requirements-dev.txt

# 运行测试
python -m pytest tests/

# 代码格式化
black .

# 类型检查
mypy .

📄 许可证

MIT License - 详见 LICENSE 文件

🙏 致谢

感谢以下开源项目的支持:

  • Flask - Web框架
  • SQLAlchemy - ORM框架
  • Bootstrap - UI框架
  • Chart.js - 图表库
  • Font Awesome - 图标库

📞 联系方式

如有问题或建议,请通过以下方式联系:


⭐ 如果这个项目对您有帮助,请给我们一个Star!

About

个人财务管理系统

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors