如何使用OnTrack：开源预算管理工具的完整入门指南

【免费下载链接】ontrack :money_with_wings: A simple self-hosted budgeting app 项目地址: https://gitcode.com/gh_mirrors/on/ontrack

OnTrack是一款简单易用的自托管预算应用，专为希望掌控个人财务的用户设计。通过直观的界面和强大的数据分析功能，你可以轻松跟踪支出、设定预算目标，并通过可视化报告了解自己的财务状况。本文将带你从零开始，快速掌握OnTrack的核心功能和使用方法。

🚀 快速开始：安装与配置

1. 获取项目代码

首先，克隆OnTrack的官方仓库到本地：

git clone https://gitcode.com/gh_mirrors/on/ontrack

2. 环境准备

项目提供了多种安装方式，你可以根据自己的操作系统选择合适的指南：

• Docker安装指南
• Homebrew安装指南
• Ubuntu安装指南

💡 核心功能介绍

直观的仪表盘：总览财务状况

登录后，你将看到OnTrack的仪表盘界面，这里集中展示了你的月度支出概况、分类消费情况和预算进度。通过色彩分明的进度条和卡片式布局，你可以快速了解当前的财务健康状况。

图1：OnTrack仪表盘展示月度支出总览和分类消费情况

支出历史管理：记录每一笔消费

在"History"页面，你可以查看所有历史支出记录，包括日期、类别、金额和描述。系统支持按时间范围和类别筛选，帮助你快速定位特定支出。

图2：支出历史页面展示详细的消费记录和筛选功能

数据导入：轻松迁移现有财务数据

OnTrack支持通过CSV文件批量导入支出数据，特别适合从其他财务软件迁移的用户。你可以在app/assets/images/readme/csv_import.png中看到导入界面，只需选择文件、配置导入规则，即可快速完成数据迁移。

图3：CSV导入功能支持批量导入和规则配置

财务洞察：深度分析消费模式

"Insights"页面提供了强大的数据分析功能，通过柱状图、饼图等可视化方式展示你的消费趋势和类别占比。你可以按年、月查看消费变化，识别潜在的节省机会。

图4：财务洞察页面提供多维度的消费数据分析

🔧 高级使用技巧

自定义预算类别

OnTrack允许你根据个人需求创建和管理支出类别。通过修改app/models/category.rb文件，你可以添加自定义类别，让预算管理更贴合你的生活方式。

设置预算目标

在仪表盘上，你可以为每个支出类别设置月度预算目标。系统会自动跟踪实际支出与目标的差距，并通过颜色提示超支情况，帮助你更好地控制消费。

数据导出与备份

为了确保财务数据安全，OnTrack提供了数据导出功能。你可以在app/controllers/exports_controller.rb中找到相关实现，定期导出数据进行备份。

🛠️ 技术架构概览

OnTrack采用现代化的Web应用架构，主要技术栈包括：

• 后端：Ruby on Rails
• 前端：React.js和SCSS
• 数据库：SQLite（开发环境）/ PostgreSQL（生产环境）
• 构建工具：Webpack

核心业务逻辑主要集中在以下目录：

• app/controllers/：处理HTTP请求
• app/models/：数据模型定义
• app/javascript/：前端组件和交互逻辑

🤝 参与贡献

如果你发现bug或有功能改进建议，欢迎通过项目的Issue系统提交反馈。代码贡献请遵循项目的贡献指南，提交Pull Request前请确保通过所有测试。

📚 相关资源

• 项目配置文件：config/application.rb
• 数据库迁移脚本：db/migrate/
• 前端组件：app/javascript/components/

通过本指南，你已经掌握了OnTrack的基本使用方法和高级技巧。开始使用这款开源预算工具，让你的财务管理变得简单而高效！

【免费下载链接】ontrack :money_with_wings: A simple self-hosted budgeting app 项目地址: https://gitcode.com/gh_mirrors/on/ontrack