Skip to content

A web app that allows multiple users to maintain an expense tracker.

Notifications You must be signed in to change notification settings

Trakeregy/Trakergy-app

Repository files navigation


Logo

Trakergy

A web tracker expense platform.
Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Tests
  5. Contributing
  6. Contact
  7. Acknowledgments

About The Project

This platform allows multiple users to maintain an expense tracker. The user should register first to access the application. The platform allows users to add trips and provides the possibility to calculate all the expenses done by each member in the group for a specific trip. When creating a trip the user should specify the group size and will have the option to add other users to the trip. Each member of the trip will have the possibility to add expenses, update expenses and add other members. There are two types of expenses: personal and group expenses. Group Expenses should be divided between all members or specific subsets. When a user adds a group expense, the system will notify the other users the amount they have to pay to the user registering the expense. Expense tracking application will generate reports as and when required to show the expenses.

(back to top)

Built With

This section should list any major frameworks/libraries used to bootstrap your project.

(back to top)

Getting Started

Prerequisites

  • python3
  • npm
  • npx
  • Node.js - at least v. 15.0

Documentation and diagrams

Installation

Use a terminal for the following steps:

  1. Clone the repo
    git clone [email protected]:Homeify/Home-management-platform.git

Open backend django app

  1. Install pip packages
    pip install -r requirements.txt
  2. Run migrations
     python manage.py makemigrations
    python manage.py migrate
  3. Open django admin app
    python manage.py runserver
    Open server in a browser (optional).
    To access adminhomeify pannel (contains info about all modules) access /admin from django server and add admin credentials.

Open frontend app

  1.  cd frontend
  2. Install NPM packages
    npm install
  3. Open react app
    npm run start

(back to top)

Usage

API Documentation:

Visit swagger folder for HTML documentation for each endpoint.

Useful phyton commands:

  • python manage.py create superuser - creates an admin that can access administration backend platform (can see/add/edit entities)
  • pip freeze > requirements.txt - add local requirements in requirements.txt file

(back to top)

Run tests

  • python manage.py tests
  • coverage run manage.py test
  • coverage run manage.py test

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

Contact

Iuga Paula - [email protected]

Project Link: https://github.com/Homeify/Home-management-platform

(back to top)

Acknowledgments

Use this space to list resources you find helpful and would like to give credit to. I've included a few of my favorites to kick things off!

(back to top)

About

A web app that allows multiple users to maintain an expense tracker.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •