Skip to content

IvanHayel/cash-control-application

Repository files navigation

TeachMeSkills Final Project

πŸ’΅ Cash Control Application

Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public. GitHub Codacy Badge contributions welcome HitCount GitHub

Table of Contents
  1. About The Project
  2. Getting Started
  3. Demo
  4. Future updates

πŸ“„ About The Project

Full Stack web application to control the cash flow.

Home page view

πŸ“ Main Technologies

Database Postgresql
Backend Java Spring
Frontend JavaScript React MUI
Security JWT

βš™οΈ Getting Started

To get a local copy up and running follow these simple steps.

  • Clone the repository
git clone https://github.com/IvanHayel/cash-control-application.git
  • Create PostgreSQL database
CREATE DATABASE cash_control
    WITH 
    OWNER = postgres
    ENCODING = 'UTF8'
    LC_COLLATE = 'English_World.1252'
    LC_CTYPE = 'English_World.1252'
    TABLESPACE = pg_default
    CONNECTION LIMIT = -1;

Basic

Frontend

You can use npm or yarn.

  1. Move to the cash-control-client folder and install dependencies
yarn install
  1. Run the application
yarn run start

Backend

Java version 17+ is required.

  1. Move to the cash-control-server folder and just run spring-boot application
mvn spring-boot:run

πŸ‹ Docker

Application can be run in Docker container.

  1. Package the application with Maven to jar file
mvn clean package

or with skipping tests

mvn clean package -DskipTests
  1. Use docker-compose in root folder to run the application
docker-compose up

πŸ”‘ Root credentials

Username: root

Password: root3301


πŸͺ„ Demo

Sign in

Sign in

Sign up

Sign up

Side menu

Side menu

Admin board

Admin board

Wallets

Wallets

Incomes

Incomes

Expenses

Expenses

Transfers

Transfers

Helpful toasts

Toasts

Reports BETA VERSION

Reports


πŸ’‘ Future updates

  • Full reports
  • Code refactoring
  • Test coverage
  • Email notifications
  • Heroku deployment