https://github.com/vishwa-glitch/finance-manager

A robust backend for a Finance Manager application built with Django, offering budget tracking, income management, expense monitoring, and advanced financial insights.
https://github.com/vishwa-glitch/finance-manager

celery django django-rest-framework expense-tracking finance-management income-management personal-finance-manager python

Last synced: 3 months ago
JSON representation

A robust backend for a Finance Manager application built with Django, offering budget tracking, income management, expense monitoring, and advanced financial insights.

• Host: GitHub
• URL: https://github.com/vishwa-glitch/finance-manager
• Owner: vishwa-glitch
• Created: 2024-12-22T15:12:19.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2025-01-07T15:48:21.000Z (5 months ago)
• Last Synced: 2025-03-13T10:18:58.282Z (3 months ago)
• Topics: celery, django, django-rest-framework, expense-tracking, finance-management, income-management, personal-finance-manager, python
• Language: Python
• Homepage:
• Size: 35.2 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Financial Manager App - Backend 💰📊

## Overview

The **Financial Manager App** provides a backend solution for managing budgets, tracking income, and monitoring expenses. The app empowers users to effectively control their financial health by offering budget tracking, income management, and expense monitoring, along with analytics and notifications.

## Key Features

### 1. **Budget Management** 💵

   - **Create, View, Update, and Delete Budgets**: Users can manage their personal or family budgets for different periods (e.g., monthly, annually).

   - **Budget Tracking**: Automatically calculates total spending and remaining balance by aggregating expenses across various categories.

   - **Budget Status**: Users can check the overall status of each budget, including the total spent and remaining amounts.

   - **Rollover Feature** 🔄: Users can enable the rollover option to transfer remaining funds from one budget period to the next, along with category adjustments.

   - **Category Allocation** 📂: Assign budgets to different categories (e.g., groceries, entertainment) with specific spending limits.

### 2. **Income Management** 💸

   - **Track Income**: Users can add and manage income entries, including different types such as salary, freelance earnings, or investment returns.

   - **Recurring Income** 🔄: Supports tracking of recurring income sources (e.g., monthly salary), making it easy to automate income tracking.

   - **Income Analytics** 📈: Provides insights into income trends, allowing users to analyze earnings over a specified period.

   - **Income Summary** 📊: Users can get a summarized view of their income by month or year to evaluate their financial progress.

### 3. **Expense Management** 🧾

   - **Track Expenses**: Users can add expenses that are categorized under specific budget categories.

   - **Expense Monitoring** 📉: Automatically calculates the amount spent within each budget category and updates the remaining budget accordingly.

   - **Expense Insights** 🔍: Provides detailed views of spending habits and trends, helping users understand where they are overspending or saving.

   - **Expense Alerts** 🚨: Future plans include alerting users when they are nearing or exceeding budget limits in any category.

### 4. **Budget Notifications** 🔔

   - **Notification System**: Users receive notifications related to their budgets and categories (e.g., when nearing a budget limit).

   - **Mark Notifications as Read** ✔️: Users can mark individual notifications as read or mark all notifications in bulk to keep track of alerts.

## Future Enhancements 🚀

The following features are planned for future releases:

   - **Budget Alerts** 🔔: Automatic notifications when the user is approaching or exceeding budget limits.

   - **Advanced Analytics** 📊: Detailed insights on income and spending with year-over-year and month-over-month comparisons.

   - **Expense Logging** 🧾: Real-time expense tracking and updates for user convenience.

   - **Multi-currency Support** 🌍: Support for managing finances in different currencies with automatic currency conversion.

   - **External Integrations** 🔗: Future integration with financial services to automatically track bank transactions and external income/expenses.

   - **Custom User Themes** 🎨: Ability for users to personalize the app’s appearance.

   - **AI-driven Budgeting** 🤖: Personalized budgeting suggestions based on past spending habits and trends.

## Setup and Installation 🛠️

1. Clone this repository.

2. Set up the environment variables according to your database and project configuration.

3. Install dependencies:

   ```

   pip install -r requirements.txt

   ```

4. Run migrations:

   ```

   python manage.py migrate

   ```

5. Start the development server:

   ```

   python manage.py runserver

   ```

## Technologies Used 💻

- **Django**: Web framework for building the backend.

- **Django REST Framework**: For API development.

- **PostgreSQL**: Database for storing user data and financial records.

- **Celery**: (Planned for future) Task queue for handling background processes, such as sending notifications.

- **Docker**: (Planned for future) Containerization of the app to simplify deployment.

---