Initial commit

2021-12-05 18:41:41 +01:00
commit d85140a300
41 changed files with 1517 additions and 0 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1,33 @@
+HELP.md
+target/
+!.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/
--- a/.mvn/wrapper/MavenWrapperDownloader.java
+++ b/.mvn/wrapper/MavenWrapperDownloader.java
@@ -0,0 +1,118 @@
+/*
+ * Copyright 2007-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import java.net.*;
+import java.io.*;
+import java.nio.channels.*;
+import java.util.Properties;
+
+public class MavenWrapperDownloader {
+
+    private static final String WRAPPER_VERSION = "0.5.6";
+    /**
+     * Default URL to download the maven-wrapper.jar from, if no 'downloadUrl' is provided.
+     */
+    private static final String DEFAULT_DOWNLOAD_URL = "https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/"
+            + WRAPPER_VERSION + "/maven-wrapper-" + WRAPPER_VERSION + ".jar";
+
+    /**
+     * Path to the maven-wrapper.properties file, which might contain a downloadUrl property to
+     * use instead of the default one.
+     */
+    private static final String MAVEN_WRAPPER_PROPERTIES_PATH =
+            ".mvn/wrapper/maven-wrapper.properties";
+
+    /**
+     * Path where the maven-wrapper.jar will be saved to.
+     */
+    private static final String MAVEN_WRAPPER_JAR_PATH =
+            ".mvn/wrapper/maven-wrapper.jar";
+
+    /**
+     * Name of the property which should be used to override the default download url for the wrapper.
+     */
+    private static final String PROPERTY_NAME_WRAPPER_URL = "wrapperUrl";
+
+    public static void main(String args[]) {
+        System.out.println("- Downloader started");
+        File baseDirectory = new File(args[0]);
+        System.out.println("- Using base directory: " + baseDirectory.getAbsolutePath());
+
+        // If the maven-wrapper.properties exists, read it and check if it contains a custom
+        // wrapperUrl parameter.
+        File mavenWrapperPropertyFile = new File(baseDirectory, MAVEN_WRAPPER_PROPERTIES_PATH);
+        String url = DEFAULT_DOWNLOAD_URL;
+        if (mavenWrapperPropertyFile.exists()) {
+            FileInputStream mavenWrapperPropertyFileInputStream = null;
+            try {
+                mavenWrapperPropertyFileInputStream = new FileInputStream(mavenWrapperPropertyFile);
+                Properties mavenWrapperProperties = new Properties();
+                mavenWrapperProperties.load(mavenWrapperPropertyFileInputStream);
+                url = mavenWrapperProperties.getProperty(PROPERTY_NAME_WRAPPER_URL, url);
+            } catch (IOException e) {
+                System.out.println("- ERROR loading '" + MAVEN_WRAPPER_PROPERTIES_PATH + "'");
+            } finally {
+                try {
+                    if (mavenWrapperPropertyFileInputStream != null) {
+                        mavenWrapperPropertyFileInputStream.close();
+                    }
+                } catch (IOException e) {
+                    // Ignore ...
+                }
+            }
+        }
+        System.out.println("- Downloading from: " + url);
+
+        File outputFile = new File(baseDirectory.getAbsolutePath(), MAVEN_WRAPPER_JAR_PATH);
+        if (!outputFile.getParentFile().exists()) {
+            if (!outputFile.getParentFile().mkdirs()) {
+                System.out.println(
+                        "- ERROR creating output directory '" + outputFile.getParentFile().getAbsolutePath() + "'");
+            }
+        }
+        System.out.println("- Downloading to: " + outputFile.getAbsolutePath());
+        try {
+            downloadFileFromURL(url, outputFile);
+            System.out.println("Done");
+            System.exit(0);
+        } catch (Throwable e) {
+            System.out.println("- Error downloading");
+            e.printStackTrace();
+            System.exit(1);
+        }
+    }
+
+    private static void downloadFileFromURL(String urlString, File destination) throws Exception {
+        if (System.getenv("MVNW_USERNAME") != null && System.getenv("MVNW_PASSWORD") != null) {
+            String username = System.getenv("MVNW_USERNAME");
+            char[] password = System.getenv("MVNW_PASSWORD").toCharArray();
+            Authenticator.setDefault(new Authenticator() {
+                @Override
+                protected PasswordAuthentication getPasswordAuthentication() {
+                    return new PasswordAuthentication(username, password);
+                }
+            });
+        }
+        URL website = new URL(urlString);
+        ReadableByteChannel rbc;
+        rbc = Channels.newChannel(website.openStream());
+        FileOutputStream fos = new FileOutputStream(destination);
+        fos.getChannel().transferFrom(rbc, 0, Long.MAX_VALUE);
+        fos.close();
+        rbc.close();
+    }
+
+}
--- a/.mvn/wrapper/maven-wrapper.jar
+++ b/.mvn/wrapper/maven-wrapper.jar
--- a/.mvn/wrapper/maven-wrapper.properties
+++ b/.mvn/wrapper/maven-wrapper.properties
@@ -0,0 +1,2 @@
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.3/apache-maven-3.8.3-bin.zip
+wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar
--- a/README.md
+++ b/README.md
@@ -0,0 +1,60 @@
+## Spring Hexagonal Architecture
+This project illustrates usage of Hexagonal Architecture in Spring Boot.
+
+The hexagonal architecture is based on three principles and techniques:
+
+- Explicitly separate User-Side, Business Logic, and Server-Side
+- Dependencies are going from User-Side and Server-Side to the Business Logic
+- We isolate the boundaries by using Ports and Adapters
+
+Outside the hexagon we have any real world thing that the application interacts with. 
+These things include humans, other applications, or any hardware/software device. They are the actors. 
+We could say that actors are the environment of the application.
+
+Actors are arranged around the hexagon depending on who triggers the interaction between the application and the actor.
+
+### Hexagonal architecture schema
+![alt text](https://github.com/hedza06/hexagonal-spring/resources/data/hex-schema.png)
+
+### Ports
+The interactions between actors and the application are organized at the hexagon boundary by the reason why they 
+are interacting with the application. Each group of interactions with a given purpose/intention is a port.
+
+Ports should be named according to what they are for, not according to any technology. 
+So, in order to name a port, we should use a verb ending with “ing” and we should say “this port is for …ing something”.
+For example:
+
+- This driver port is for “adding products to the shopping cart”;
+- This driven port (repository) is “for obtaining information about products”;
+- This driven port (recipient) is for “sending notifications”.
+
+Ports are the application boundary, in the picture a port is an edge of the hexagon. From the outside world, actors 
+can only interact with the hexagon ports, they shouldn’t be able to access the inside of the hexagon. 
+
+Ports are interfaces that the application offers to the outside world for allowing actors interact with the application.
+
+### Adapters
+Actors interact with hexagon ports through adapters using a specific technology. An adapter is a software component 
+that allows a technology to interact with a port of the hexagon. Given a port, there may be an adapter for each desired 
+technology that we want to use. Adapters are outside the application.
+
+A driver adapter uses a driver port interface, converting a specific technology request into a technology 
+agnostic request to a driver port.
+
+A driven adapter implements a driven port interface, converting the technology agnostic methods of the port into 
+specific technology methods.
+
+### Contribution/Suggestions
+If someone is interested for contribution or have some suggestions please contact me on e-mail `hedzaprog@gmail.com`.
+There are more to come from hexagonal architecture and first I'm planing to write tests for given examples in project.
+
+### Author
+Heril Muratović  
+Software Engineer  
+<br>
+**Mobile**: +38269657962  
+**E-mail**: hedzaprog@gmail.com  
+**Skype**: hedza06  
+**Twitter**: hedzakirk  
+**LinkedIn**: https://www.linkedin.com/in/heril-muratovi%C4%87-021097132/  
+**StackOverflow**: https://stackoverflow.com/users/4078505/heril-muratovic
--- a/310
+++ b/310
@@ -0,0 +1,310 @@
+#!/bin/sh
+# ----------------------------------------------------------------------------
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#    https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# ----------------------------------------------------------------------------
+
+# ----------------------------------------------------------------------------
+# Maven Start Up Batch script
+#
+# Required ENV vars:
+# ------------------
+#   JAVA_HOME - location of a JDK home dir
+#
+# Optional ENV vars
+# -----------------
+#   M2_HOME - location of maven2's installed home dir
+#   MAVEN_OPTS - parameters passed to the Java VM when running Maven
+#     e.g. to debug Maven itself, use
+#       set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
+#   MAVEN_SKIP_RC - flag to disable loading of mavenrc files
+# ----------------------------------------------------------------------------
+
+if [ -z "$MAVEN_SKIP_RC" ] ; then
+
+  if [ -f /etc/mavenrc ] ; then
+    . /etc/mavenrc
+  fi
+
+  if [ -f "$HOME/.mavenrc" ] ; then
+    . "$HOME/.mavenrc"
+  fi
+
+fi
+
+# OS specific support.  $var _must_ be set to either true or false.
+cygwin=false;
+darwin=false;
+mingw=false
+case "`uname`" in
+  CYGWIN*) cygwin=true ;;
+  MINGW*) mingw=true;;
+  Darwin*) darwin=true
+    # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home
+    # See https://developer.apple.com/library/mac/qa/qa1170/_index.html
+    if [ -z "$JAVA_HOME" ]; then
+      if [ -x "/usr/libexec/java_home" ]; then
+        export JAVA_HOME="`/usr/libexec/java_home`"
+      else
+        export JAVA_HOME="/Library/Java/Home"
+      fi
+    fi
+    ;;
+esac
+
+if [ -z "$JAVA_HOME" ] ; then
+  if [ -r /etc/gentoo-release ] ; then
+    JAVA_HOME=`java-config --jre-home`
+  fi
+fi
+
+if [ -z "$M2_HOME" ] ; then
+  ## resolve links - $0 may be a link to maven's home
+  PRG="$0"
+
+  # need this for relative symlinks
+  while [ -h "$PRG" ] ; do
+    ls=`ls -ld "$PRG"`
+    link=`expr "$ls" : '.*-> \(.*\)$'`
+    if expr "$link" : '/.*' > /dev/null; then
+      PRG="$link"
+    else
+      PRG="`dirname "$PRG"`/$link"
+    fi
+  done
+
+  saveddir=`pwd`
+
+  M2_HOME=`dirname "$PRG"`/..
+
+  # make it fully qualified
+  M2_HOME=`cd "$M2_HOME" && pwd`
+
+  cd "$saveddir"
+  # echo Using m2 at $M2_HOME
+fi
+
+# For Cygwin, ensure paths are in UNIX format before anything is touched
+if $cygwin ; then
+  [ -n "$M2_HOME" ] &&
+    M2_HOME=`cygpath --unix "$M2_HOME"`
+  [ -n "$JAVA_HOME" ] &&
+    JAVA_HOME=`cygpath --unix "$JAVA_HOME"`
+  [ -n "$CLASSPATH" ] &&
+    CLASSPATH=`cygpath --path --unix "$CLASSPATH"`
+fi
+
+# For Mingw, ensure paths are in UNIX format before anything is touched
+if $mingw ; then
+  [ -n "$M2_HOME" ] &&
+    M2_HOME="`(cd "$M2_HOME"; pwd)`"
+  [ -n "$JAVA_HOME" ] &&
+    JAVA_HOME="`(cd "$JAVA_HOME"; pwd)`"
+fi
+
+if [ -z "$JAVA_HOME" ]; then
+  javaExecutable="`which javac`"
+  if [ -n "$javaExecutable" ] && ! [ "`expr \"$javaExecutable\" : '\([^ ]*\)'`" = "no" ]; then
+    # readlink(1) is not available as standard on Solaris 10.
+    readLink=`which readlink`
+    if [ ! `expr "$readLink" : '\([^ ]*\)'` = "no" ]; then
+      if $darwin ; then
+        javaHome="`dirname \"$javaExecutable\"`"
+        javaExecutable="`cd \"$javaHome\" && pwd -P`/javac"
+      else
+        javaExecutable="`readlink -f \"$javaExecutable\"`"
+      fi
+      javaHome="`dirname \"$javaExecutable\"`"
+      javaHome=`expr "$javaHome" : '\(.*\)/bin'`
+      JAVA_HOME="$javaHome"
+      export JAVA_HOME
+    fi
+  fi
+fi
+
+if [ -z "$JAVACMD" ] ; then
+  if [ -n "$JAVA_HOME"  ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+      # IBM's JDK on AIX uses strange locations for the executables
+      JAVACMD="$JAVA_HOME/jre/sh/java"
+    else
+      JAVACMD="$JAVA_HOME/bin/java"
+    fi
+  else
+    JAVACMD="`which java`"
+  fi
+fi
+
+if [ ! -x "$JAVACMD" ] ; then
+  echo "Error: JAVA_HOME is not defined correctly." >&2
+  echo "  We cannot execute $JAVACMD" >&2
+  exit 1
+fi
+
+if [ -z "$JAVA_HOME" ] ; then
+  echo "Warning: JAVA_HOME environment variable is not set."
+fi
+
+CLASSWORLDS_LAUNCHER=org.codehaus.plexus.classworlds.launcher.Launcher
+
+# traverses directory structure from process work directory to filesystem root
+# first directory with .mvn subdirectory is considered project base directory
+find_maven_basedir() {
+
+  if [ -z "$1" ]
+  then
+    echo "Path not specified to find_maven_basedir"
+    return 1
+  fi
+
+  basedir="$1"
+  wdir="$1"
+  while [ "$wdir" != '/' ] ; do
+    if [ -d "$wdir"/.mvn ] ; then
+      basedir=$wdir
+      break
+    fi
+    # workaround for JBEAP-8937 (on Solaris 10/Sparc)
+    if [ -d "${wdir}" ]; then
+      wdir=`cd "$wdir/.."; pwd`
+    fi
+    # end of workaround
+  done
+  echo "${basedir}"
+}
+
+# concatenates all lines of a file
+concat_lines() {
+  if [ -f "$1" ]; then
+    echo "$(tr -s '\n' ' ' < "$1")"
+  fi
+}
+
+BASE_DIR=`find_maven_basedir "$(pwd)"`
+if [ -z "$BASE_DIR" ]; then
+  exit 1;
+fi
+
+##########################################################################################
+# Extension to allow automatically downloading the maven-wrapper.jar from Maven-central
+# This allows using the maven wrapper in projects that prohibit checking in binary data.
+##########################################################################################
+if [ -r "$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" ]; then
+    if [ "$MVNW_VERBOSE" = true ]; then
+      echo "Found .mvn/wrapper/maven-wrapper.jar"
+    fi
+else
+    if [ "$MVNW_VERBOSE" = true ]; then
+      echo "Couldn't find .mvn/wrapper/maven-wrapper.jar, downloading it ..."
+    fi
+    if [ -n "$MVNW_REPOURL" ]; then
+      jarUrl="$MVNW_REPOURL/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar"
+    else
+      jarUrl="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar"
+    fi
+    while IFS="=" read key value; do
+      case "$key" in (wrapperUrl) jarUrl="$value"; break ;;
+      esac
+    done < "$BASE_DIR/.mvn/wrapper/maven-wrapper.properties"
+    if [ "$MVNW_VERBOSE" = true ]; then
+      echo "Downloading from: $jarUrl"
+    fi
+    wrapperJarPath="$BASE_DIR/.mvn/wrapper/maven-wrapper.jar"
+    if $cygwin; then
+      wrapperJarPath=`cygpath --path --windows "$wrapperJarPath"`
+    fi
+
+    if command -v wget > /dev/null; then
+        if [ "$MVNW_VERBOSE" = true ]; then
+          echo "Found wget ... using wget"
+        fi
+        if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then
+            wget "$jarUrl" -O "$wrapperJarPath"
+        else
+            wget --http-user=$MVNW_USERNAME --http-password=$MVNW_PASSWORD "$jarUrl" -O "$wrapperJarPath"
+        fi
+    elif command -v curl > /dev/null; then
+        if [ "$MVNW_VERBOSE" = true ]; then
+          echo "Found curl ... using curl"
+        fi
+        if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then
+            curl -o "$wrapperJarPath" "$jarUrl" -f
+        else
+            curl --user $MVNW_USERNAME:$MVNW_PASSWORD -o "$wrapperJarPath" "$jarUrl" -f
+        fi
+
+    else
+        if [ "$MVNW_VERBOSE" = true ]; then
+          echo "Falling back to using Java to download"
+        fi
+        javaClass="$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.java"
+        # For Cygwin, switch paths to Windows format before running javac
+        if $cygwin; then
+          javaClass=`cygpath --path --windows "$javaClass"`
+        fi
+        if [ -e "$javaClass" ]; then
+            if [ ! -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then
+                if [ "$MVNW_VERBOSE" = true ]; then
+                  echo " - Compiling MavenWrapperDownloader.java ..."
+                fi
+                # Compiling the Java class
+                ("$JAVA_HOME/bin/javac" "$javaClass")
+            fi
+            if [ -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then
+                # Running the downloader
+                if [ "$MVNW_VERBOSE" = true ]; then
+                  echo " - Running MavenWrapperDownloader.java ..."
+                fi
+                ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$MAVEN_PROJECTBASEDIR")
+            fi
+        fi
+    fi
+fi
+##########################################################################################
+# End of extension
+##########################################################################################
+
+export MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"}
+if [ "$MVNW_VERBOSE" = true ]; then
+  echo $MAVEN_PROJECTBASEDIR
+fi
+MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS"
+
+# For Cygwin, switch paths to Windows format before running java
+if $cygwin; then
+  [ -n "$M2_HOME" ] &&
+    M2_HOME=`cygpath --path --windows "$M2_HOME"`
+  [ -n "$JAVA_HOME" ] &&
+    JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"`
+  [ -n "$CLASSPATH" ] &&
+    CLASSPATH=`cygpath --path --windows "$CLASSPATH"`
+  [ -n "$MAVEN_PROJECTBASEDIR" ] &&
+    MAVEN_PROJECTBASEDIR=`cygpath --path --windows "$MAVEN_PROJECTBASEDIR"`
+fi
+
+# Provide a "standardized" way to retrieve the CLI args that will
+# work with both Windows and non-Windows executions.
+MAVEN_CMD_LINE_ARGS="$MAVEN_CONFIG $@"
+export MAVEN_CMD_LINE_ARGS
+
+WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
+
+exec "$JAVACMD" \
+  $MAVEN_OPTS \
+  -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \
+  "-Dmaven.home=${M2_HOME}" "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \
+  ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@"
--- a/mvnw.cmd
+++ b/mvnw.cmd
@@ -0,0 +1,182 @@
+@REM ----------------------------------------------------------------------------
+@REM Licensed to the Apache Software Foundation (ASF) under one
+@REM or more contributor license agreements.  See the NOTICE file
+@REM distributed with this work for additional information
+@REM regarding copyright ownership.  The ASF licenses this file
+@REM to you under the Apache License, Version 2.0 (the
+@REM "License"); you may not use this file except in compliance
+@REM with the License.  You may obtain a copy of the License at
+@REM
+@REM    https://www.apache.org/licenses/LICENSE-2.0
+@REM
+@REM Unless required by applicable law or agreed to in writing,
+@REM software distributed under the License is distributed on an
+@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+@REM KIND, either express or implied.  See the License for the
+@REM specific language governing permissions and limitations
+@REM under the License.
+@REM ----------------------------------------------------------------------------
+
+@REM ----------------------------------------------------------------------------
+@REM Maven Start Up Batch script
+@REM
+@REM Required ENV vars:
+@REM JAVA_HOME - location of a JDK home dir
+@REM
+@REM Optional ENV vars
+@REM M2_HOME - location of maven2's installed home dir
+@REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands
+@REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a keystroke before ending
+@REM MAVEN_OPTS - parameters passed to the Java VM when running Maven
+@REM     e.g. to debug Maven itself, use
+@REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
+@REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files
+@REM ----------------------------------------------------------------------------
+
+@REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on'
+@echo off
+@REM set title of command window
+title %0
+@REM enable echoing by setting MAVEN_BATCH_ECHO to 'on'
+@if "%MAVEN_BATCH_ECHO%" == "on"  echo %MAVEN_BATCH_ECHO%
+
+@REM set %HOME% to equivalent of $HOME
+if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%")
+
+@REM Execute a user defined script before this one
+if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre
+@REM check for pre script, once with legacy .bat ending and once with .cmd ending
+if exist "%HOME%\mavenrc_pre.bat" call "%HOME%\mavenrc_pre.bat"
+if exist "%HOME%\mavenrc_pre.cmd" call "%HOME%\mavenrc_pre.cmd"
+:skipRcPre
+
+@setlocal
+
+set ERROR_CODE=0
+
+@REM To isolate internal variables from possible post scripts, we use another setlocal
+@setlocal
+
+@REM ==== START VALIDATION ====
+if not "%JAVA_HOME%" == "" goto OkJHome
+
+echo.
+echo Error: JAVA_HOME not found in your environment. >&2
+echo Please set the JAVA_HOME variable in your environment to match the >&2
+echo location of your Java installation. >&2
+echo.
+goto error
+
+:OkJHome
+if exist "%JAVA_HOME%\bin\java.exe" goto init
+
+echo.
+echo Error: JAVA_HOME is set to an invalid directory. >&2
+echo JAVA_HOME = "%JAVA_HOME%" >&2
+echo Please set the JAVA_HOME variable in your environment to match the >&2
+echo location of your Java installation. >&2
+echo.
+goto error
+
+@REM ==== END VALIDATION ====
+
+:init
+
+@REM Find the project base dir, i.e. the directory that contains the folder ".mvn".
+@REM Fallback to current working directory if not found.
+
+set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR%
+IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir
+
+set EXEC_DIR=%CD%
+set WDIR=%EXEC_DIR%
+:findBaseDir
+IF EXIST "%WDIR%"\.mvn goto baseDirFound
+cd ..
+IF "%WDIR%"=="%CD%" goto baseDirNotFound
+set WDIR=%CD%
+goto findBaseDir
+
+:baseDirFound
+set MAVEN_PROJECTBASEDIR=%WDIR%
+cd "%EXEC_DIR%"
+goto endDetectBaseDir
+
+:baseDirNotFound
+set MAVEN_PROJECTBASEDIR=%EXEC_DIR%
+cd "%EXEC_DIR%"
+
+:endDetectBaseDir
+
+IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig
+
+@setlocal EnableExtensions EnableDelayedExpansion
+for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a
+@endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS%
+
+:endReadAdditionalConfig
+
+SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe"
+set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar"
+set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
+
+set DOWNLOAD_URL="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar"
+
+FOR /F "tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO (
+    IF "%%A"=="wrapperUrl" SET DOWNLOAD_URL=%%B
+)
+
+@REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central
+@REM This allows using the maven wrapper in projects that prohibit checking in binary data.
+if exist %WRAPPER_JAR% (
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Found %WRAPPER_JAR%
+    )
+) else (
+    if not "%MVNW_REPOURL%" == "" (
+        SET DOWNLOAD_URL="%MVNW_REPOURL%/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar"
+    )
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Couldn't find %WRAPPER_JAR%, downloading it ...
+        echo Downloading from: %DOWNLOAD_URL%
+    )
+
+    powershell -Command "&{"^
+		"$webclient = new-object System.Net.WebClient;"^
+		"if (-not ([string]::IsNullOrEmpty('%MVNW_USERNAME%') -and [string]::IsNullOrEmpty('%MVNW_PASSWORD%'))) {"^
+		"$webclient.Credentials = new-object System.Net.NetworkCredential('%MVNW_USERNAME%', '%MVNW_PASSWORD%');"^
+		"}"^
+		"[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $webclient.DownloadFile('%DOWNLOAD_URL%', '%WRAPPER_JAR%')"^
+		"}"
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Finished downloading %WRAPPER_JAR%
+    )
+)
+@REM End of extension
+
+@REM Provide a "standardized" way to retrieve the CLI args that will
+@REM work with both Windows and non-Windows executions.
+set MAVEN_CMD_LINE_ARGS=%*
+
+%MAVEN_JAVA_EXE% %JVM_CONFIG_MAVEN_PROPS% %MAVEN_OPTS% %MAVEN_DEBUG_OPTS% -classpath %WRAPPER_JAR% "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %*
+if ERRORLEVEL 1 goto error
+goto end
+
+:error
+set ERROR_CODE=1
+
+:end
+@endlocal & set ERROR_CODE=%ERROR_CODE%
+
+if not "%MAVEN_SKIP_RC%" == "" goto skipRcPost
+@REM check for post script, once with legacy .bat ending and once with .cmd ending
+if exist "%HOME%\mavenrc_post.bat" call "%HOME%\mavenrc_post.bat"
+if exist "%HOME%\mavenrc_post.cmd" call "%HOME%\mavenrc_post.cmd"
+:skipRcPost
+
+@REM pause the script if MAVEN_BATCH_PAUSE is set to 'on'
+if "%MAVEN_BATCH_PAUSE%" == "on" pause
+
+if "%MAVEN_TERMINATE_CMD%" == "on" exit %ERROR_CODE%
+
+exit /B %ERROR_CODE%
--- a/pom.xml
+++ b/pom.xml
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>2.6.1</version>
+        <relativePath/> <!-- lookup parent from repository -->
+    </parent>
+    <groupId>com.hedza06</groupId>
+    <artifactId>hexagonal-spring</artifactId>
+    <version>0.0.1-SNAPSHOT</version>
+    <name>hexagonal-spring</name>
+    <description>Hexagonal Architecture With Spring Boot</description>
+    <properties>
+        <java.version>11</java.version>
+    </properties>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-jpa</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>mysql</groupId>
+            <artifactId>mysql-connector-java</artifactId>
+            <scope>runtime</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-configuration-processor</artifactId>
+            <optional>true</optional>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <optional>true</optional>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.httpcomponents</groupId>
+            <artifactId>httpclient</artifactId>
+            <version>4.5.12</version> <!-- 4.4 -->
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <configuration>
+                    <excludes>
+                        <exclude>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok</artifactId>
+                        </exclude>
+                    </excludes>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>
--- a/src/main/java/com/hedza06/hexagonalspring/HexagonalSpringApplication.java
+++ b/src/main/java/com/hedza06/hexagonalspring/HexagonalSpringApplication.java
@@ -0,0 +1,13 @@
+package com.hedza06.hexagonalspring;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class HexagonalSpringApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(HexagonalSpringApplication.class, args);
+    }
+
+}
--- a/src/main/java/com/hedza06/hexagonalspring/config/RestTemplateConfiguration.java
+++ b/src/main/java/com/hedza06/hexagonalspring/config/RestTemplateConfiguration.java
@@ -0,0 +1,43 @@
+package com.hedza06.hexagonalspring.config;
+
+import org.apache.http.conn.ssl.SSLConnectionSocketFactory;
+import org.apache.http.impl.client.CloseableHttpClient;
+import org.apache.http.impl.client.HttpClients;
+import org.apache.http.ssl.TrustStrategy;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;
+import org.springframework.web.client.RestTemplate;
+
+import javax.net.ssl.SSLContext;
+import java.security.KeyManagementException;
+import java.security.KeyStoreException;
+import java.security.NoSuchAlgorithmException;
+import java.security.cert.X509Certificate;
+
+@Configuration
+public class RestTemplateConfiguration {
+
+    public RestTemplate restTemplate() {
+        return new RestTemplate();
+    }
+
+    @Bean(name = "restHttpsTemplate")
+    public RestTemplate restHttpsTemplate() throws KeyStoreException, NoSuchAlgorithmException, KeyManagementException
+    {
+        TrustStrategy acceptingTrustStrategy = (X509Certificate[] chain, String authType) -> true;
+        SSLContext sslContext = org.apache.http.ssl.SSLContexts.custom()
+                .loadTrustMaterial(null, acceptingTrustStrategy)
+                .build();
+
+        SSLConnectionSocketFactory csf = new SSLConnectionSocketFactory(sslContext);
+        CloseableHttpClient httpClient = HttpClients.custom()
+            .setSSLSocketFactory(csf)
+            .build();
+
+        HttpComponentsClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory();
+        requestFactory.setHttpClient(httpClient);
+
+        return new RestTemplate(requestFactory);
+    }
+}
--- a/src/main/java/com/hedza06/hexagonalspring/customer/adapter/persistence/CustomerAdapter.java
+++ b/src/main/java/com/hedza06/hexagonalspring/customer/adapter/persistence/CustomerAdapter.java
@@ -0,0 +1,25 @@
+package com.hedza06.hexagonalspring.customer.adapter.persistence;
+
+import com.hedza06.hexagonalspring.customer.application.port.out.CustomerPort;
+import com.hedza06.hexagonalspring.customer.domain.Customer;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+
+@Component
+@RequiredArgsConstructor
+class CustomerAdapter implements CustomerPort {
+
+    private final CustomerRepository customerRepository;
+
+    @Override
+    public Customer save(Customer customer) {
+        return customerRepository.save(customer);
+    }
+
+    @Override
+    public List<Customer> findByFirstNameStartingWith(String pattern) {
+        return customerRepository.findByFirstNameStartingWith(pattern);
+    }
+}
--- a/src/main/java/com/hedza06/hexagonalspring/customer/adapter/persistence/CustomerRepository.java
+++ b/src/main/java/com/hedza06/hexagonalspring/customer/adapter/persistence/CustomerRepository.java
@@ -0,0 +1,13 @@
+package com.hedza06.hexagonalspring.customer.adapter.persistence;
+
+import com.hedza06.hexagonalspring.customer.domain.Customer;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+
+@Repository
+public interface CustomerRepository extends JpaRepository<Customer, Integer>
+{
+    List<Customer> findByFirstNameStartingWith(String pattern);
+}
--- a/src/main/java/com/hedza06/hexagonalspring/customer/adapter/web/CustomerController.java
+++ b/src/main/java/com/hedza06/hexagonalspring/customer/adapter/web/CustomerController.java
@@ -0,0 +1,37 @@
+package com.hedza06.hexagonalspring.customer.adapter.web;
+
+import com.hedza06.hexagonalspring.customer.application.port.in.CustomerUseCase;
+import com.hedza06.hexagonalspring.customer.domain.Customer;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping(value = "/customer")
+class CustomerController {
+
+    private final CustomerUseCase customerUseCase;
+
+    @PostMapping
+    public ResponseEntity<Customer> persist(@RequestBody Customer customer)
+    {
+        Customer persistedCustomer = customerUseCase.save(customer);
+        return new ResponseEntity<>(persistedCustomer, HttpStatus.CREATED);
+    }
+
+    @GetMapping(value = "/by-first-name-starting-with")
+    public ResponseEntity<List<Customer>> findByNameStartingWith(@RequestParam(value = "pattern") String pattern)
+    {
+        List<Customer> customers = customerUseCase.findByFirstNameStartingWith(pattern);
+        return new ResponseEntity<>(customers, HttpStatus.OK);
+    }
+}
--- a/src/main/java/com/hedza06/hexagonalspring/customer/application/port/in/CustomerUseCase.java
+++ b/src/main/java/com/hedza06/hexagonalspring/customer/application/port/in/CustomerUseCase.java
@@ -0,0 +1,11 @@
+package com.hedza06.hexagonalspring.customer.application.port.in;
+
+import com.hedza06.hexagonalspring.customer.domain.Customer;
+
+import java.util.List;
+
+public interface CustomerUseCase
+{
+    Customer save(Customer customer);
+    List<Customer> findByFirstNameStartingWith(String pattern);
+}
--- a/src/main/java/com/hedza06/hexagonalspring/customer/application/port/out/CustomerPort.java
+++ b/src/main/java/com/hedza06/hexagonalspring/customer/application/port/out/CustomerPort.java
@@ -0,0 +1,11 @@
+package com.hedza06.hexagonalspring.customer.application.port.out;
+
+import com.hedza06.hexagonalspring.customer.domain.Customer;
+
+import java.util.List;
+
+public interface CustomerPort
+{
+    Customer save(Customer customer);
+    List<Customer> findByFirstNameStartingWith(String pattern);
+}
--- a/src/main/java/com/hedza06/hexagonalspring/customer/application/service/CustomerService.java
+++ b/src/main/java/com/hedza06/hexagonalspring/customer/application/service/CustomerService.java
@@ -0,0 +1,28 @@
+package com.hedza06.hexagonalspring.customer.application.service;
+
+import com.hedza06.hexagonalspring.customer.application.port.in.CustomerUseCase;
+import com.hedza06.hexagonalspring.customer.application.port.out.CustomerPort;
+import com.hedza06.hexagonalspring.customer.domain.Customer;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+
+@Service
+@Transactional
+@RequiredArgsConstructor
+public class CustomerService implements CustomerUseCase {
+
+    private final CustomerPort customerPort;
+
+    @Override
+    public Customer save(Customer customer) {
+        return customerPort.save(customer);
+    }
+
+    @Override
+    public List<Customer> findByFirstNameStartingWith(String pattern) {
+        return customerPort.findByFirstNameStartingWith(pattern);
+    }
+}
--- a/src/main/java/com/hedza06/hexagonalspring/customer/config/.gitkeep
+++ b/src/main/java/com/hedza06/hexagonalspring/customer/config/.gitkeep
--- a/src/main/java/com/hedza06/hexagonalspring/customer/domain/Customer.java
+++ b/src/main/java/com/hedza06/hexagonalspring/customer/domain/Customer.java
@@ -0,0 +1,39 @@
+package com.hedza06.hexagonalspring.customer.domain;
+
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.GeneratedValue;
+import javax.persistence.GenerationType;
+import javax.persistence.Id;
+import javax.persistence.Table;
+import javax.persistence.Temporal;
+import javax.persistence.TemporalType;
+import java.util.Date;
+
+@Data
+@Entity
+@NoArgsConstructor
+@Table(name = "customer")
+public class Customer {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Integer id;
+
+    @Column(name = "first_name")
+    private String firstName;
+
+    @Column(name = "last_name")
+    private String lastName;
+
+    @Column
+    private String address;
+
+    @Column(name = "created_at")
+    @Temporal(TemporalType.TIMESTAMP)
+    private Date createdAt;
+
+}
--- a/src/main/java/com/hedza06/hexagonalspring/customer/dto/.gitkeep
+++ b/src/main/java/com/hedza06/hexagonalspring/customer/dto/.gitkeep
--- a/src/main/java/com/hedza06/hexagonalspring/customer/mapper/.gitkeep
+++ b/src/main/java/com/hedza06/hexagonalspring/customer/mapper/.gitkeep
--- a/src/main/java/com/hedza06/hexagonalspring/customer/validator/.gitkeep
+++ b/src/main/java/com/hedza06/hexagonalspring/customer/validator/.gitkeep
--- a/src/main/java/com/hedza06/hexagonalspring/product/adapter/api/ExternalProductAdapter.java
+++ b/src/main/java/com/hedza06/hexagonalspring/product/adapter/api/ExternalProductAdapter.java
@@ -0,0 +1,49 @@
+package com.hedza06.hexagonalspring.product.adapter.api;
+
+import com.hedza06.hexagonalspring.product.application.port.out.ExternalFakeProductPort;
+import com.hedza06.hexagonalspring.product.dto.FakeProductDTO;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.http.HttpMethod;
+import org.springframework.http.ResponseEntity;
+import org.springframework.stereotype.Component;
+import org.springframework.web.client.RestClientException;
+import org.springframework.web.client.RestTemplate;
+
+import java.util.Collections;
+import java.util.List;
+
+@Slf4j
+@Component
+@RequiredArgsConstructor
+public class ExternalProductAdapter implements ExternalFakeProductPort {
+
+    @Qualifier("restHttpsTemplate")
+    private final RestTemplate restTemplate;
+
+    @Override
+    public List<FakeProductDTO> fetchAllFakeProducts()
+    {
+        log.info("Getting fake products from external API...");
+
+        String url = "https://fakestoreapi.com/products";
+        try
+        {
+            ParameterizedTypeReference<List<FakeProductDTO>> typeReference = new ParameterizedTypeReference<>(){};
+            ResponseEntity<List<FakeProductDTO>> responseEntity = restTemplate.exchange(
+                url, HttpMethod.GET, null, typeReference
+            );
+            log.info("Http status code: {}", responseEntity.getStatusCodeValue());
+            log.info("Sending back to client fetched fake products...");
+
+            return responseEntity.getBody();
+        }
+        catch (RestClientException e)
+        {
+            log.error("Error occurred while fetching fake products. Error message: {}", e.getMessage());
+            return Collections.emptyList();
+        }
+    }
+}
--- a/src/main/java/com/hedza06/hexagonalspring/product/adapter/persistence/ProductAdapter.java
+++ b/src/main/java/com/hedza06/hexagonalspring/product/adapter/persistence/ProductAdapter.java
@@ -0,0 +1,25 @@
+package com.hedza06.hexagonalspring.product.adapter.persistence;
+
+import com.hedza06.hexagonalspring.product.application.port.out.ProductPort;
+import com.hedza06.hexagonalspring.product.domain.Product;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+import java.util.Optional;
+
+@Component
+@RequiredArgsConstructor
+public class ProductAdapter implements ProductPort {
+
+    private final ProductRepository productRepository;
+
+    @Override
+    public Product save(Product product) {
+        return productRepository.save(product);
+    }
+
+    @Override
+    public Optional<Product> findById(Integer id) {
+        return productRepository.findById(id);
+    }
+}
--- a/src/main/java/com/hedza06/hexagonalspring/product/adapter/persistence/ProductRepository.java
+++ b/src/main/java/com/hedza06/hexagonalspring/product/adapter/persistence/ProductRepository.java
@@ -0,0 +1,8 @@
+package com.hedza06.hexagonalspring.product.adapter.persistence;
+
+import com.hedza06.hexagonalspring.product.domain.Product;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface ProductRepository extends JpaRepository<Product, Integer> { }
--- a/src/main/java/com/hedza06/hexagonalspring/product/adapter/web/ProductController.java
+++ b/src/main/java/com/hedza06/hexagonalspring/product/adapter/web/ProductController.java
@@ -0,0 +1,50 @@
+package com.hedza06.hexagonalspring.product.adapter.web;
+
+import com.hedza06.hexagonalspring.product.application.port.in.ExternalFakeProductUseCase;
+import com.hedza06.hexagonalspring.product.application.port.in.ProductUseCase;
+import com.hedza06.hexagonalspring.product.domain.Product;
+import com.hedza06.hexagonalspring.product.dto.FakeProductDTO;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.Optional;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping(value = "/product")
+public class ProductController {
+
+    private final ProductUseCase productUseCase;
+    private final ExternalFakeProductUseCase fakeProductUseCase;
+
+    @PostMapping
+    public ResponseEntity<Product> persist(@RequestBody Product product)
+    {
+        Product persistedProduct = productUseCase.save(product);
+        return new ResponseEntity<>(persistedProduct, HttpStatus.CREATED);
+    }
+
+    @GetMapping(value = "/{id}")
+    public ResponseEntity<Product> findOne(@PathVariable Integer id)
+    {
+        Optional<Product> optionalProduct = productUseCase.findById(id);
+        return optionalProduct
+            .map(product -> new ResponseEntity<>(product, HttpStatus.OK))
+            .orElse(new ResponseEntity<>(HttpStatus.NOT_FOUND));
+    }
+
+    @GetMapping(value = "/fake")
+    public ResponseEntity<List<FakeProductDTO>> getFakeProducts()
+    {
+        List<FakeProductDTO> fakeProducts = fakeProductUseCase.fetchAllFakeProducts();
+        return new ResponseEntity<>(fakeProducts, HttpStatus.OK);
+    }
+}
--- a/src/main/java/com/hedza06/hexagonalspring/product/application/port/in/ExternalFakeProductUseCase.java
+++ b/src/main/java/com/hedza06/hexagonalspring/product/application/port/in/ExternalFakeProductUseCase.java
@@ -0,0 +1,10 @@
+package com.hedza06.hexagonalspring.product.application.port.in;
+
+import com.hedza06.hexagonalspring.product.dto.FakeProductDTO;
+
+import java.util.List;
+
+public interface ExternalFakeProductUseCase
+{
+    List<FakeProductDTO> fetchAllFakeProducts();
+}
--- a/src/main/java/com/hedza06/hexagonalspring/product/application/port/in/ProductUseCase.java
+++ b/src/main/java/com/hedza06/hexagonalspring/product/application/port/in/ProductUseCase.java
@@ -0,0 +1,11 @@
+package com.hedza06.hexagonalspring.product.application.port.in;
+
+import com.hedza06.hexagonalspring.product.domain.Product;
+
+import java.util.Optional;
+
+public interface ProductUseCase
+{
+    Product save(Product product);
+    Optional<Product> findById(Integer id);
+}
--- a/src/main/java/com/hedza06/hexagonalspring/product/application/port/out/ExternalFakeProductPort.java
+++ b/src/main/java/com/hedza06/hexagonalspring/product/application/port/out/ExternalFakeProductPort.java
@@ -0,0 +1,10 @@
+package com.hedza06.hexagonalspring.product.application.port.out;
+
+import com.hedza06.hexagonalspring.product.dto.FakeProductDTO;
+
+import java.util.List;
+
+public interface ExternalFakeProductPort
+{
+    List<FakeProductDTO> fetchAllFakeProducts();
+}
--- a/src/main/java/com/hedza06/hexagonalspring/product/application/port/out/ProductPort.java
+++ b/src/main/java/com/hedza06/hexagonalspring/product/application/port/out/ProductPort.java
@@ -0,0 +1,11 @@
+package com.hedza06.hexagonalspring.product.application.port.out;
+
+import com.hedza06.hexagonalspring.product.domain.Product;
+
+import java.util.Optional;
+
+public interface ProductPort
+{
+    Product save(Product product);
+    Optional<Product> findById(Integer id);
+}
--- a/src/main/java/com/hedza06/hexagonalspring/product/application/service/ProductService.java
+++ b/src/main/java/com/hedza06/hexagonalspring/product/application/service/ProductService.java
@@ -0,0 +1,38 @@
+package com.hedza06.hexagonalspring.product.application.service;
+
+import com.hedza06.hexagonalspring.product.application.port.in.ExternalFakeProductUseCase;
+import com.hedza06.hexagonalspring.product.application.port.in.ProductUseCase;
+import com.hedza06.hexagonalspring.product.application.port.out.ExternalFakeProductPort;
+import com.hedza06.hexagonalspring.product.application.port.out.ProductPort;
+import com.hedza06.hexagonalspring.product.domain.Product;
+import com.hedza06.hexagonalspring.product.dto.FakeProductDTO;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+import java.util.Optional;
+
+@Service
+@Transactional
+@RequiredArgsConstructor
+public class ProductService implements ProductUseCase, ExternalFakeProductUseCase {
+
+    private final ProductPort productPort;
+    private final ExternalFakeProductPort fakeProductPort;
+
+    @Override
+    public Product save(Product product) {
+        return productPort.save(product);
+    }
+
+    @Override
+    public Optional<Product> findById(Integer id) {
+        return productPort.findById(id);
+    }
+
+    @Override
+    public List<FakeProductDTO> fetchAllFakeProducts() {
+        return fakeProductPort.fetchAllFakeProducts();
+    }
+}
--- a/src/main/java/com/hedza06/hexagonalspring/product/config/.gitkeep
+++ b/src/main/java/com/hedza06/hexagonalspring/product/config/.gitkeep
--- a/src/main/java/com/hedza06/hexagonalspring/product/domain/Product.java
+++ b/src/main/java/com/hedza06/hexagonalspring/product/domain/Product.java
@@ -0,0 +1,44 @@
+package com.hedza06.hexagonalspring.product.domain;
+
+import com.hedza06.hexagonalspring.customer.domain.Customer;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.GeneratedValue;
+import javax.persistence.GenerationType;
+import javax.persistence.Id;
+import javax.persistence.JoinColumn;
+import javax.persistence.ManyToOne;
+import javax.persistence.Table;
+import javax.persistence.Temporal;
+import javax.persistence.TemporalType;
+import java.math.BigDecimal;
+import java.util.Date;
+
+@Data
+@Entity
+@NoArgsConstructor
+@Table(name = "product")
+public class Product {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Integer id;
+
+    @Column(name = "catalog_name")
+    private String catalogName;
+
+    @Column
+    private BigDecimal price;
+
+    @Temporal(TemporalType.DATE)
+    @Column(name = "created_at")
+    private Date createdAt;
+
+    @ManyToOne
+    @JoinColumn(name = "customer_id")
+    private Customer customer;
+
+}
--- a/src/main/java/com/hedza06/hexagonalspring/product/dto/FakeProductDTO.java
+++ b/src/main/java/com/hedza06/hexagonalspring/product/dto/FakeProductDTO.java
@@ -0,0 +1,18 @@
+package com.hedza06.hexagonalspring.product.dto;
+
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+
+@Data
+@NoArgsConstructor
+public class FakeProductDTO {
+
+    private Integer id;
+    private String title;
+    private BigDecimal price;
+    private String description;
+    private String category;
+
+}
--- a/src/main/java/com/hedza06/hexagonalspring/product/dto/ProductDTO.java
+++ b/src/main/java/com/hedza06/hexagonalspring/product/dto/ProductDTO.java
@@ -0,0 +1,18 @@
+package com.hedza06.hexagonalspring.product.dto;
+
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+import java.util.Date;
+
+@Data
+@NoArgsConstructor
+public class ProductDTO {
+
+    private Integer id;
+    private String catalogName;
+    private BigDecimal price;
+    private Date createdAt;
+
+}
--- a/src/main/java/com/hedza06/hexagonalspring/product/mapper/.gitkeep
+++ b/src/main/java/com/hedza06/hexagonalspring/product/mapper/.gitkeep
--- a/src/main/java/com/hedza06/hexagonalspring/product/validator/.gitkeep
+++ b/src/main/java/com/hedza06/hexagonalspring/product/validator/.gitkeep
--- a/src/main/resources/application.yml
+++ b/src/main/resources/application.yml
@@ -0,0 +1,43 @@
+spring:
+  # Jackson Configuration
+  jackson:
+    serialization.indent_output: true
+  # Datasource Configuration
+  datasource:
+    name: MySQL RDBMS Database Connection
+    driver-class-name: com.mysql.jdbc.Driver
+    #    driver-class-name: com.mysql.cj.jdbc.Driver
+    url: jdbc:mysql://localhost:3306/hex_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=CET&allowPublicKeyRetrieval=true
+    username: root
+    password: root
+    # Hikari CP Configuration
+    hikari:
+      data-source-properties:
+        cachePrepStmts: true
+        prepStmtCacheSize: 250
+        prepStmtCacheSqlLimit: 2048
+        useServerPrepStmts: true
+  # Java Persistence API Configuration
+  jpa:
+    database-platform: org.hibernate.dialect.MySQLInnoDBDialect
+    database: MYSQL
+    show-sql: true
+    open-in-view: false
+    # Hibernate Properties
+    properties:
+      hibernate.cache.use_second_level_cache: false
+      hibernate.cache.use_query_cache: false
+      hibernate.generate_statistics: false
+      hibernate.show_sql: true
+      hibernate.SQL: true
+# API context path configuration
+server:
+  servlet:
+    context-path: /api
+
+# Logging configuration
+logging:
+  level:
+    com.hedza06.hexagonalspring: DEBUG
+
+debug: false
--- a/src/main/resources/data/hex-schema.png
+++ b/src/main/resources/data/hex-schema.png
--- a/src/main/resources/data/hexagonal-apis.postman_collection.json
+++ b/src/main/resources/data/hexagonal-apis.postman_collection.json
@@ -0,0 +1,136 @@
+{
+	"info": {
+		"_postman_id": "169461dd-f7db-45e9-a9a7-9fe1fbaf3bd3",
+		"name": "hexagonal-apis",
+		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
+	},
+	"item": [
+		{
+			"name": "Get customers by first name term",
+			"request": {
+				"method": "GET",
+				"header": [],
+				"url": {
+					"raw": "http://localhost:8080/api/customer/by-first-name-starting-with?pattern=John",
+					"protocol": "http",
+					"host": [
+						"localhost"
+					],
+					"port": "8080",
+					"path": [
+						"api",
+						"customer",
+						"by-first-name-starting-with"
+					],
+					"query": [
+						{
+							"key": "pattern",
+							"value": "John"
+						}
+					]
+				}
+			},
+			"response": []
+		},
+		{
+			"name": "Persist Customer",
+			"request": {
+				"method": "POST",
+				"header": [],
+				"body": {
+					"mode": "raw",
+					"raw": "{\n    \"firstName\": \"Marc\",\n    \"lastName\": \"Anothony\",\n    \"address\": \"Test address\",\n    \"createdAt\": \"2021-01-01T12:12:47.105+01:00\"\n}",
+					"options": {
+						"raw": {
+							"language": "json"
+						}
+					}
+				},
+				"url": {
+					"raw": "http://localhost:8080/api/customer",
+					"protocol": "http",
+					"host": [
+						"localhost"
+					],
+					"port": "8080",
+					"path": [
+						"api",
+						"customer"
+					]
+				}
+			},
+			"response": []
+		},
+		{
+			"name": "Find product by id",
+			"request": {
+				"method": "GET",
+				"header": [],
+				"url": {
+					"raw": "http://localhost:8080/api/product/1",
+					"protocol": "http",
+					"host": [
+						"localhost"
+					],
+					"port": "8080",
+					"path": [
+						"api",
+						"product",
+						"1"
+					]
+				}
+			},
+			"response": []
+		},
+		{
+			"name": "Persist Product",
+			"request": {
+				"method": "POST",
+				"header": [],
+				"body": {
+					"mode": "raw",
+					"raw": "{\n    \"catalogName\": \"Test catalog name 1\",\n    \"price\": 100.00,\n    \"createdAt\": \"2021-02-02T10:12:00.97+02:00\",\n    \"customer\": {\n        \"id\": 1\n    }\n}",
+					"options": {
+						"raw": {
+							"language": "json"
+						}
+					}
+				},
+				"url": {
+					"raw": "http://localhost:8080/api/product",
+					"protocol": "http",
+					"host": [
+						"localhost"
+					],
+					"port": "8080",
+					"path": [
+						"api",
+						"product"
+					]
+				}
+			},
+			"response": []
+		},
+		{
+			"name": "Get fake products",
+			"request": {
+				"method": "GET",
+				"header": [],
+				"url": {
+					"raw": "http://localhost:8080/api/product/fake",
+					"protocol": "http",
+					"host": [
+						"localhost"
+					],
+					"port": "8080",
+					"path": [
+						"api",
+						"product",
+						"fake"
+					]
+				}
+			},
+			"response": []
+		}
+	]
+}
--- a/src/main/resources/data/schema_and_data.sql
+++ b/src/main/resources/data/schema_and_data.sql
@@ -0,0 +1,35 @@
+-- DATABASE
+CREATE DATABASE IF NOT EXISTS hex_db;
+USE hex_db;
+
+-- TABLES
+CREATE TABLE `customer` (
+  `id` INT UNSIGNED NOT NULL AUTO_INCREMENT,
+  `first_name` VARCHAR(32) NOT NULL,
+  `last_name` VARCHAR(64) NOT NULL,
+  `address` VARCHAR(255) NULL,
+  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  PRIMARY KEY (`id`));
+
+CREATE TABLE `product` (
+  `id` INT UNSIGNED NOT NULL AUTO_INCREMENT,
+  `customer_id` INT UNSIGNED NOT NULL,
+  `catalog_name` VARCHAR(255) NOT NULL,
+  `price` DECIMAL(15,2) NOT NULL,
+  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  PRIMARY KEY (`id`),
+  INDEX `fk_product_customer_id_key_idx` (`customer_id` ASC),
+  CONSTRAINT `fk_product_customer_id_key`
+    FOREIGN KEY (`customer_id`)
+    REFERENCES `hex_db`.`customer` (`id`)
+    ON DELETE NO ACTION
+    ON UPDATE NO ACTION);
+
+-- SEEDS
+INSERT INTO `customer` (first_name, last_name, address) VALUES
+('Heril', 'Muratovic', 'Test address 01'),
+('John', 'Wick', '121 Mill Neck in Long Island, NY');
+
+INSERT INTO `product` (customer_id, catalog_name, price) VALUES
+((SELECT id FROM customer WHERE first_name = 'Heril' AND last_name = 'Muratovic' LIMIT 1), 'SIG-Sauer P320', 1560.12),
+((SELECT id FROM customer WHERE first_name = 'John' AND last_name = 'Wick' LIMIT 1), 'Coharie Arms CA-415', 3500.00);
--- a/src/test/java/com/hedza06/hexagonalspring/HexagonalSpringApplicationTests.java
+++ b/src/test/java/com/hedza06/hexagonalspring/HexagonalSpringApplicationTests.java
@@ -0,0 +1,13 @@
+package com.hedza06.hexagonalspring;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest
+class HexagonalSpringApplicationTests {
+
+    @Test
+    void contextLoads() {
+    }
+
+}