Inventory Management

This project is an application skeleton for a Inventory Management application.

Getting Started

To get you started you can simply clone the inventory-management repository and install the dependencies:

Prerequisites

You need git to clone the inventory-management repository.

You will need Java™ SE Development Kit 8 and Maven.

Clone inventory-management

Clone the inventory-management repository using git:

git clone https://github.com/alfonsserra/inventory-management.git
cd inventory-management

Install Dependencies

In order to install the dependencies and generate the Uber jar you must run:

mvn clean install

Run

To launch the server, simply run with java -jar the generated jar file.

java -jar target/inventory-management-1.0.jar

API

You will find the swagger UI at http://localhost:8080/swagger-ui.html

First generate a token with the following command:

curl testjwtclientid:XY7kmzoNzl100@localhost:8080/oauth/token -d grant_type=password -d username=user -d password=jwtpass

After, put the Bearer into the Swagger page

Docker

Build docker image

There is an Automated Build Task in Docker Cloud in order to build the Docker Image. This task, triggers a new build with every git push to your source code repository to create a 'latest' image. There is another build rule to trigger a new tag and create a 'version-x.y.z' image

You can always manually create the image with the following command:

docker build -t alfonsserra/inventory-management . 

Run the container

docker run -e 8080:8080 alfonsserra/inventory-management

The app will be available at http://localhost:8080/swagger-ui.html

Check http://www.baeldung.com/jackson-annotations for JSON annotations