Aimed towards consumers who strive for budget management, the Budget Web App wants to elevate understanding of income and spending, resulting in a higher control over finance. Unlike other apps which often automatically and arbitrarily categorize purchases, we allow users to define their budget and how they want to view their spending. This will allow for both the presence of "intelligent" suggestions per say, as well as user-defined categories in the event that more accuracy is required/desired.
View our deployed website here: http://167.172.252.106/
Extra Credit Notes:
- Extra credit is given to teams that have deployed to a Docker container, although a non-containerized deployment to a Droplet is fine.
- We have a non-containerized deployment to a droplet.
- Extra credit is given to teams that have a Continuous Deployment setup, although a manual deployment is fine.
- We have Continuous Deployment set up. We have updated the CircleCI script to kick off a deploy job each time when new changes are merged into the master branch. In this script, CircleCI will SSH into our deployment server and run another script to pull the latest changes and deploy on deployment server.
- CircleCI script
deploy
workflow anddeploy-prod
job - deploy script on deployment server
- Check here for Continuous Deployment in action
-
Enjoy our presentation here!
-
Featuring ...
- Jennifer as Jennifer
- Tomer as Tomer
- Alan as Alan
- Sebastian as Sebastian
- Michelle as Michelle
The Budget Web App came to fruition when team member Jennifer Zeng mentioned how most popular budget apps fail to allow you to customized your categorizes when giving statistics towards your spending. This can often lead to an inaccurate portrayal of your spending. If you buy food and drinks from CVS, budget apps are likely to categorize this as a purchase under health because CVS is a pharmacy. Jennifer suggested we create a new app that would allow users to personalize their categorizes, giving a more accurate and personal reflection of someone's finances. This idea was later expanded to involve concepts of how we could use ML to predict future spending patterns and use known APIs to sync banking information.
View our contributing page on how to contribute!
Run the program:
-
Clone the repo
git clone git@github.com:software-students-fall2021/project-setup-sneaky-seven.git
-
Make sure you have node and npm installed: learn more!
-
Run the front-end: Go to that directory:
cd front-end/
Download dependencies:npm install
Run the programnpm run start
-
Run the back-end (separate terminal):
Go to that directory:
cd back-end/
Download dependencies:
npm install
Add the
.env
file:(Please contact any member for this as we don't want this on version control)
Run the program
npm start
-
Application should pop up here!
Test the program:
-
Download the necessary dependencies:
Unit Testing:
npm install --save-dev mocha chai sinon mocha-sinon chai-http
Code Coverage:
npm i -D nyc
-
Run the following command in the back-end folder:
Go to backend:
cd back-end/
Run for unit test and code coverage:
npm test