ShoppingCart

What is this?

This repo is a dockerized full stack example of simple shopping cart application. This project leverages MySQL for the database, Node (Express) for the api layer, and React for the UI. Each layer has its own Dockerfile so it can be worked on in a development environment independent of the other layers.

How do you use the production application?

• If you don't have Docker installed on your machine please get that installed first! https://docs.docker.com/get-started/

• Open a terminal window

• Navigate to a directory you want the project to reside in

git clone https://github.com/JamesFranc/ShoppingCart.git

Once the repository has been cloned run the following:

cd ShoppingCart/ && docker-compose up --build

Wait for the following to display:

web_1    | wait-for-it.sh: mysql:3306 is available after 1 seconds
web_1    | 
web_1    | > server@1.0.0 start /usr/src/app/server
web_1    | > node server.js
web_1    | 
web_1    | Visit http://localhost:8080 in your browser to use the shopping cart

Enjoy using the shopping cart!

Mysql admin

If you are so inclined and want to do some database administration on a running docker instance here is what you'll need to do.

Open a terminal window and enter:

docker exec -it aucc-db bash

Once in the container run:

mysql -u root -p aucc

At the Enter password: prompt use: aucc as the password

Finally enter:

USE aucc;

You are now in the database for the application and can perform maintenance (add/remove items/users to the catalog, get schemas, etc etc...)

Client unit testing and coverage reporting

We test the React + Redux client using Jest and Enzyme. To run tests and check coverage for the client open a terminal window and navigate to the client directory. Once in the client directory enter:

npm install && npm run test -- --coverage --watchAll=false -u

Tests will be run and a coverage report will be generated for you.

Server unit testing

We test the Node + Express server using Mocha. To run tests and check coverage for the client open a terminal window and navigate to the server directory. Once in the server directory enter:

mocha

Tests will be run and the results will be reported.

This project still has room for refinement.