https://github.com/quynhnle135/expense-manager
Django-based Expense Management Application to keep track of your expenses.
https://github.com/quynhnle135/expense-manager
django djangorestframework python
Last synced: 3 months ago
JSON representation
Django-based Expense Management Application to keep track of your expenses.
- Host: GitHub
- URL: https://github.com/quynhnle135/expense-manager
- Owner: quynhnle135
- Created: 2023-12-01T15:14:14.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-05T02:09:28.000Z (over 1 year ago)
- Last Synced: 2025-02-14T19:32:16.958Z (5 months ago)
- Topics: django, djangorestframework, python
- Language: Python
- Homepage:
- Size: 3.83 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Expense Manager
## Introduction
- This Expense Management Application is a web-based platform designed to help users manage their expenses efficiently. Built with Django and Django REST Framework, it offers a user-friend interface for tracking and organizing expenses.
- Skills: Python, Django, Django REST Framework, HTML, CSS, Git.
- You can check the Python OOP version [here](https://github.com/quynhnle135/expense-management-oop).
## Features
* User Account Management: Users can create an account, log in, and log out, ensuring that each user's data is private and secure.
* Expense Management: Users can easily add, update, and delete expenses. The application calculates and displays the total expense amount for quick reference.
* Search Functionality: Users can search for expenses by card, category, notes, date, and amount.
## Installation
1. Clone the repository: ```git clone https://github.com/quynhnle135/expense-manager.git```
2. Navigate to the project repository: ```cd expense-manager```
3. Install the required dependencies: ```pip install -r requirements.txt```
4. Run the server: ```python3 manage.py runserver```
## Screenshots
* Register an account
* User login
* User starts with an empty expense list
* Add an expense
* After adding some expenses.
* View expense's detail
* Delete an expense
* Search for expenses with card X1
* Search for expenses with card Amex
* Search for expenses with category Coffee
* Search for expenses with notes "reload"
* Search for expenses spent on Nov 23, 2023
* Search for expenses with amount $20
---
## API Features
- User-Specific Data Management: Every user can manage their own expense records, with each user's data kept private and secure.
- Create and Manage Expenses: Users can add new expenses, view their past expense records, update details, or delete records as needed.
- Search and Filter Capabilities: Users can easily find expenses based on various criteria such as card type, category, notes, date, and amount.
- Secure Access: All endpoints require user authentication, ensuring that data is protected and only accessible by the respective user.
- You can use ```curl``` to interact with the API or view it on your web browser because Django REST Framework provides a browsable API, which is a user-friendly web interface that allows users to interact with API directly.
## Endpoints
* List expenses: GET /api/expenses/
* Create expenses: POST /api/expenses/
* Retrieve expenses: GET /api/expenses/\/
* Update expenses: PUT /api/expenses/\/
* Delete expenses: DELETE /api/expenses/\/
## Screenshots
* View all expenses
* Create new expenses
* View expense's detail
* Filter and search functionalites
* Expenses retrieved after filtering with card name "amex"
