feat: scaffold initial loyalty-agent-service project with OpenAPI specifications and OAuth2-enabled API client configuration

2026-07-17 01:49:30 +07:00
commit c3861d6476
30 changed files with 6991 additions and 0 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1,39 @@
+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/
+
+### Mac OS ###
+.DS_Store
+
+### Others ###
+*.log
--- 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.9.9/apache-maven-3.9.9-bin.zip
+wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.3.2/maven-wrapper-3.3.2.jar
--- a/README.md
+++ b/README.md
@@ -0,0 +1,4 @@
+ ./mvnw package -Pgen
+
+ 
+ ./mvnw compile spring-boot:run
--- a/download-specs.ps1
+++ b/download-specs.ps1
@@ -0,0 +1,38 @@
+$baseUrl = "http://192.168.99.242:8081"
+$specs = @(
+    @{ name="attribute"; url="/attribute/v3/api-docs" },
+    @{ name="batch-scheduler"; url="/batch-scheduler/v3/api-docs" },
+    @{ name="catalogue"; url="/catalogue/v3/api-docs" },
+    @{ name="customer"; url="/customer/v3/api-docs" },
+    @{ name="identity"; url="/identity/v3/api-docs" },
+    @{ name="marketing"; url="/marketing/v3/api-docs" },
+    @{ name="master"; url="/master/v3/api-docs" },
+    @{ name="notification"; url="/notification/v3/api-docs" },
+    @{ name="reward"; url="/reward/v3/api-docs" },
+    @{ name="transaction"; url="/transaction/v3/api-docs" }
+)
+
+$targetDir = "src/main/resources/specs"
+if (-not (Test-Path $targetDir)) {
+    New-Item -ItemType Directory -Force -Path $targetDir | Out-Null
+}
+
+foreach ($spec in $specs) {
+    $fullUrl = $baseUrl + $spec.url
+    $outputPath = Join-Path $targetDir ($spec.name + ".json")
+    Write-Host "Downloading $($spec.name) from $fullUrl ..."
+    try {
+        Invoke-WebRequest -Uri $fullUrl -OutFile $outputPath -UseBasicParsing
+        Write-Host "[OK] $($spec.name) saved to $outputPath"
+    } catch {
+        Write-Host "[WARNING] Failed to download from $fullUrl, trying alternative path..."
+        $altUrl = $baseUrl + "/v3/api-docs/" + $spec.name
+        try {
+            Invoke-WebRequest -Uri $altUrl -OutFile $outputPath -UseBasicParsing
+            Write-Host "[OK] $($spec.name) saved to $outputPath (alternative path)"
+        } catch {
+            Write-Host "[ERROR] Failed to download $($spec.name)"
+        }
+    }
+}
+Write-Host "Done downloading specs."
--- a/332
+++ b/332
@@ -0,0 +1,332 @@
+#!/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
+#
+#    http://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.
+# ----------------------------------------------------------------------------
+
+# ----------------------------------------------------------------------------
+# Apache Maven Wrapper startup batch script, version 3.3.2
+#
+# Required ENV vars:
+# ------------------
+#   JAVA_HOME - location of a JDK home dir
+#
+# Optional ENV vars
+# -----------------
+#   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 /usr/local/etc/mavenrc ]; then
+    . /usr/local/etc/mavenrc
+  fi
+
+  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
+      JAVA_HOME="$(/usr/libexec/java_home)"
+      export JAVA_HOME
+    else
+      JAVA_HOME="/Library/Java/Home"
+      export JAVA_HOME
+    fi
+  fi
+  ;;
+esac
+
+if [ -z "$JAVA_HOME" ]; then
+  if [ -r /etc/gentoo-release ]; then
+    JAVA_HOME=$(java-config --jre-home)
+  fi
+fi
+
+# For Cygwin, ensure paths are in UNIX format before anything is touched
+if $cygwin; then
+  [ -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 "$JAVA_HOME" ] && [ -d "$JAVA_HOME" ] \
+    && JAVA_HOME="$(
+      cd "$JAVA_HOME" || (
+        echo "cannot cd into $JAVA_HOME." >&2
+        exit 1
+      )
+      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="$(
+      \unset -f command 2>/dev/null
+      \command -v 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." >&2
+fi
+
+# 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" >&2
+    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/.." || exit 1
+        pwd
+      )
+    fi
+    # end of workaround
+  done
+  printf '%s' "$(
+    cd "$basedir" || exit 1
+    pwd
+  )"
+}
+
+# concatenates all lines of a file
+concat_lines() {
+  if [ -f "$1" ]; then
+    # Remove \r in case we run on Windows within Git Bash
+    # and check out the repository with auto CRLF management
+    # enabled. Otherwise, we may read lines that are delimited with
+    # \r\n and produce $'-Xarg\r' rather than -Xarg due to word
+    # splitting rules.
+    tr -s '\r\n' ' ' <"$1"
+  fi
+}
+
+log() {
+  if [ "$MVNW_VERBOSE" = true ]; then
+    printf '%s\n' "$1"
+  fi
+}
+
+BASE_DIR=$(find_maven_basedir "$(dirname "$0")")
+if [ -z "$BASE_DIR" ]; then
+  exit 1
+fi
+
+MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"}
+export MAVEN_PROJECTBASEDIR
+log "$MAVEN_PROJECTBASEDIR"
+
+##########################################################################################
+# 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.
+##########################################################################################
+wrapperJarPath="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar"
+if [ -r "$wrapperJarPath" ]; then
+  log "Found $wrapperJarPath"
+else
+  log "Couldn't find $wrapperJarPath, downloading it ..."
+
+  if [ -n "$MVNW_REPOURL" ]; then
+    wrapperUrl="$MVNW_REPOURL/org/apache/maven/wrapper/maven-wrapper/3.3.2/maven-wrapper-3.3.2.jar"
+  else
+    wrapperUrl="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.3.2/maven-wrapper-3.3.2.jar"
+  fi
+  while IFS="=" read -r key value; do
+    # Remove '\r' from value to allow usage on windows as IFS does not consider '\r' as a separator ( considers space, tab, new line ('\n'), and custom '=' )
+    safeValue=$(echo "$value" | tr -d '\r')
+    case "$key" in wrapperUrl)
+      wrapperUrl="$safeValue"
+      break
+      ;;
+    esac
+  done <"$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.properties"
+  log "Downloading from: $wrapperUrl"
+
+  if $cygwin; then
+    wrapperJarPath=$(cygpath --path --windows "$wrapperJarPath")
+  fi
+
+  if command -v wget >/dev/null; then
+    log "Found wget ... using wget"
+    [ "$MVNW_VERBOSE" = true ] && QUIET="" || QUIET="--quiet"
+    if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then
+      wget $QUIET "$wrapperUrl" -O "$wrapperJarPath" || rm -f "$wrapperJarPath"
+    else
+      wget $QUIET --http-user="$MVNW_USERNAME" --http-password="$MVNW_PASSWORD" "$wrapperUrl" -O "$wrapperJarPath" || rm -f "$wrapperJarPath"
+    fi
+  elif command -v curl >/dev/null; then
+    log "Found curl ... using curl"
+    [ "$MVNW_VERBOSE" = true ] && QUIET="" || QUIET="--silent"
+    if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then
+      curl $QUIET -o "$wrapperJarPath" "$wrapperUrl" -f -L || rm -f "$wrapperJarPath"
+    else
+      curl $QUIET --user "$MVNW_USERNAME:$MVNW_PASSWORD" -o "$wrapperJarPath" "$wrapperUrl" -f -L || rm -f "$wrapperJarPath"
+    fi
+  else
+    log "Falling back to using Java to download"
+    javaSource="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/MavenWrapperDownloader.java"
+    javaClass="$MAVEN_PROJECTBASEDIR/.mvn/wrapper/MavenWrapperDownloader.class"
+    # For Cygwin, switch paths to Windows format before running javac
+    if $cygwin; then
+      javaSource=$(cygpath --path --windows "$javaSource")
+      javaClass=$(cygpath --path --windows "$javaClass")
+    fi
+    if [ -e "$javaSource" ]; then
+      if [ ! -e "$javaClass" ]; then
+        log " - Compiling MavenWrapperDownloader.java ..."
+        ("$JAVA_HOME/bin/javac" "$javaSource")
+      fi
+      if [ -e "$javaClass" ]; then
+        log " - Running MavenWrapperDownloader.java ..."
+        ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$wrapperUrl" "$wrapperJarPath") || rm -f "$wrapperJarPath"
+      fi
+    fi
+  fi
+fi
+##########################################################################################
+# End of extension
+##########################################################################################
+
+# If specified, validate the SHA-256 sum of the Maven wrapper jar file
+wrapperSha256Sum=""
+while IFS="=" read -r key value; do
+  case "$key" in wrapperSha256Sum)
+    wrapperSha256Sum=$value
+    break
+    ;;
+  esac
+done <"$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.properties"
+if [ -n "$wrapperSha256Sum" ]; then
+  wrapperSha256Result=false
+  if command -v sha256sum >/dev/null; then
+    if echo "$wrapperSha256Sum  $wrapperJarPath" | sha256sum -c >/dev/null 2>&1; then
+      wrapperSha256Result=true
+    fi
+  elif command -v shasum >/dev/null; then
+    if echo "$wrapperSha256Sum  $wrapperJarPath" | shasum -a 256 -c >/dev/null 2>&1; then
+      wrapperSha256Result=true
+    fi
+  else
+    echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." >&2
+    echo "Please install either command, or disable validation by removing 'wrapperSha256Sum' from your maven-wrapper.properties." >&2
+    exit 1
+  fi
+  if [ $wrapperSha256Result = false ]; then
+    echo "Error: Failed to validate Maven wrapper SHA-256, your Maven wrapper might be compromised." >&2
+    echo "Investigate or delete $wrapperJarPath to attempt a clean download." >&2
+    echo "If you updated your Maven version, you need to update the specified wrapperSha256Sum property." >&2
+    exit 1
+  fi
+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 "$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
+
+# shellcheck disable=SC2086 # safe args
+exec "$JAVACMD" \
+  $MAVEN_OPTS \
+  $MAVEN_DEBUG_OPTS \
+  -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \
+  "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \
+  ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@"
--- a/mvnw.cmd
+++ b/mvnw.cmd
@@ -0,0 +1,206 @@
+@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    http://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 Apache Maven Wrapper startup batch script, version 3.3.2
+@REM
+@REM Required ENV vars:
+@REM JAVA_HOME - location of a JDK home dir
+@REM
+@REM Optional ENV vars
+@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 "%USERPROFILE%\mavenrc_pre.bat" call "%USERPROFILE%\mavenrc_pre.bat" %*
+if exist "%USERPROFILE%\mavenrc_pre.cmd" call "%USERPROFILE%\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. >&2
+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. >&2
+goto error
+
+:OkJHome
+if exist "%JAVA_HOME%\bin\java.exe" goto init
+
+echo. >&2
+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. >&2
+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 WRAPPER_URL="https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.3.2/maven-wrapper-3.3.2.jar"
+
+FOR /F "usebackq tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO (
+    IF "%%A"=="wrapperUrl" SET WRAPPER_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 WRAPPER_URL="%MVNW_REPOURL%/org/apache/maven/wrapper/maven-wrapper/3.3.2/maven-wrapper-3.3.2.jar"
+    )
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Couldn't find %WRAPPER_JAR%, downloading it ...
+        echo Downloading from: %WRAPPER_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('%WRAPPER_URL%', '%WRAPPER_JAR%')"^
+		"}"
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Finished downloading %WRAPPER_JAR%
+    )
+)
+@REM End of extension
+
+@REM If specified, validate the SHA-256 sum of the Maven wrapper jar file
+SET WRAPPER_SHA_256_SUM=""
+FOR /F "usebackq tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO (
+    IF "%%A"=="wrapperSha256Sum" SET WRAPPER_SHA_256_SUM=%%B
+)
+IF NOT %WRAPPER_SHA_256_SUM%=="" (
+    powershell -Command "&{"^
+       "Import-Module $PSHOME\Modules\Microsoft.PowerShell.Utility -Function Get-FileHash;"^
+       "$hash = (Get-FileHash \"%WRAPPER_JAR%\" -Algorithm SHA256).Hash.ToLower();"^
+       "If('%WRAPPER_SHA_256_SUM%' -ne $hash){"^
+       "  Write-Error 'Error: Failed to validate Maven wrapper SHA-256, your Maven wrapper might be compromised.';"^
+       "  Write-Error 'Investigate or delete %WRAPPER_JAR% to attempt a clean download.';"^
+       "  Write-Error 'If you updated your Maven version, you need to update the specified wrapperSha256Sum property.';"^
+       "  exit 1;"^
+       "}"^
+       "}"
+    if ERRORLEVEL 1 goto error
+)
+
+@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 "%USERPROFILE%\mavenrc_post.bat" call "%USERPROFILE%\mavenrc_post.bat"
+if exist "%USERPROFILE%\mavenrc_post.cmd" call "%USERPROFILE%\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%
+
+cmd /C exit /B %ERROR_CODE%
--- a/pom.xml
+++ b/pom.xml
@@ -0,0 +1,349 @@
+<?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>4.1.0</version>
+        <relativePath/> <!-- lookup parent from repository -->
+    </parent>
+
+    <groupId>dev.sonpx.loyalty</groupId>
+    <artifactId>loyalty-agent-service</artifactId>
+    <version>0.0.1-SNAPSHOT</version>
+    <name>loyalty-agent-service</name>
+    <description>AI Agent Service to orchestrate Loyalty core system</description>
+
+    <properties>
+        <java.version>25</java.version>
+        <spring-ai.version>2.0.0</spring-ai.version>
+    </properties>
+
+    <dependencies>
+        <!-- Spring Boot Web -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+
+        <!-- Spring AI Ollama -->
+        <dependency>
+            <groupId>org.springframework.ai</groupId>
+            <artifactId>spring-ai-starter-model-ollama</artifactId>
+        </dependency>
+
+        <!-- WebClient (needed for generated API client if library is webclient) -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-webflux</artifactId>
+        </dependency>
+
+        <!-- OAuth2 Client -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-oauth2-client</artifactId>
+        </dependency>
+
+        <!-- Lombok -->
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <optional>true</optional>
+        </dependency>
+
+        <!-- Springdoc OpenAPI -->
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+            <version>2.7.0</version>
+        </dependency>
+
+        <!-- Dependencies for generated OpenAPI clients -->
+        <dependency>
+            <groupId>org.openapitools</groupId>
+            <artifactId>jackson-databind-nullable</artifactId>
+            <version>0.2.6</version>
+        </dependency>
+        <dependency>
+            <groupId>jakarta.annotation</groupId>
+            <artifactId>jakarta.annotation-api</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.httpcomponents</groupId>
+            <artifactId>httpclient</artifactId>
+            <version>4.5.14</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.httpcomponents</groupId>
+            <artifactId>httpmime</artifactId>
+            <version>4.5.14</version>
+        </dependency>
+
+        <!-- Testing -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>org.springframework.ai</groupId>
+                <artifactId>spring-ai-bom</artifactId>
+                <version>${spring-ai.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+
+    <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>
+            <!-- Add generated sources to compile path even when not running gen profile -->
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>build-helper-maven-plugin</artifactId>
+                <version>3.5.0</version>
+                <executions>
+                    <execution>
+                        <id>add-source</id>
+                        <phase>generate-sources</phase>
+                        <goals>
+                            <goal>add-source</goal>
+                        </goals>
+                        <configuration>
+                            <sources>
+                                <source>${project.build.directory}/generated-sources/openapi/src/main/java</source>
+                            </sources>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+
+    <profiles>
+        <profile>
+            <id>gen</id>
+            <build>
+                <plugins>
+            
+            <!-- OpenAPI Generator Plugin -->
+            <plugin>
+                <groupId>org.openapitools</groupId>
+                <artifactId>openapi-generator-maven-plugin</artifactId>
+                <version>7.23.0</version>
+                <configuration>
+                    <skipValidateSpec>true</skipValidateSpec>
+                    <typeMappings>
+                        <MultiValueMapStringString>org.springframework.util.MultiValueMap</MultiValueMapStringString>
+                    </typeMappings>
+                    <importMappings>
+                        <MultiValueMapStringString>org.springframework.util.MultiValueMap</MultiValueMapStringString>
+                    </importMappings>
+                    <nameMappings>user_name=user_name_raw,setAttributeId=set_attribute_id_val</nameMappings>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>generate-attribute</id>
+                        <goals><goal>generate</goal></goals>
+                        <configuration>
+                            <inputSpec>${project.basedir}/src/main/resources/specs/attribute.json</inputSpec>
+                            <generatorName>java</generatorName>
+                            <library>native</library>
+                            <apiPackage>dev.sonpx.loyalty.agent.client.api.attribute</apiPackage>
+                            <modelPackage>dev.sonpx.loyalty.agent.client.model.attribute</modelPackage>
+                            <generateApiTests>false</generateApiTests>
+                            <generateModelTests>false</generateModelTests>
+                            <configOptions>
+                                <useJakartaEe>true</useJakartaEe>
+                                <useSpringBoot3>true</useSpringBoot3>
+                            </configOptions>
+                        </configuration>
+                    </execution>
+
+                    <execution>
+                        <id>generate-catalogue</id>
+                        <goals><goal>generate</goal></goals>
+                        <configuration>
+                            <inputSpec>${project.basedir}/src/main/resources/specs/catalogue.json</inputSpec>
+                            <generatorName>java</generatorName>
+                            <library>native</library>
+                            <apiPackage>dev.sonpx.loyalty.agent.client.api.catalogue</apiPackage>
+                            <modelPackage>dev.sonpx.loyalty.agent.client.model.catalogue</modelPackage>
+                            <generateApiTests>false</generateApiTests>
+                            <generateModelTests>false</generateModelTests>
+                            <configOptions>
+                                <useJakartaEe>true</useJakartaEe>
+                                <useSpringBoot3>true</useSpringBoot3>
+                            </configOptions>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>generate-customer</id>
+                        <goals><goal>generate</goal></goals>
+                        <configuration>
+                            <inputSpec>${project.basedir}/src/main/resources/specs/customer.json</inputSpec>
+                            <generatorName>java</generatorName>
+                            <library>native</library>
+                            <apiPackage>dev.sonpx.loyalty.agent.client.api.customer</apiPackage>
+                            <modelPackage>dev.sonpx.loyalty.agent.client.model.customer</modelPackage>
+                            <generateApiTests>false</generateApiTests>
+                            <generateModelTests>false</generateModelTests>
+                            <configOptions>
+                                <useJakartaEe>true</useJakartaEe>
+                                <useSpringBoot3>true</useSpringBoot3>
+                            </configOptions>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>generate-identity</id>
+                        <goals><goal>generate</goal></goals>
+                        <configuration>
+                            <inputSpec>${project.basedir}/src/main/resources/specs/identity.json</inputSpec>
+                            <generatorName>java</generatorName>
+                            <library>native</library>
+                            <apiPackage>dev.sonpx.loyalty.agent.client.api.identity</apiPackage>
+                            <modelPackage>dev.sonpx.loyalty.agent.client.model.identity</modelPackage>
+                            <generateApiTests>false</generateApiTests>
+                            <generateModelTests>false</generateModelTests>
+                            <configOptions>
+                                <useJakartaEe>true</useJakartaEe>
+                                <useSpringBoot3>true</useSpringBoot3>
+                            </configOptions>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>generate-marketing</id>
+                        <goals><goal>generate</goal></goals>
+                        <configuration>
+                            <inputSpec>${project.basedir}/src/main/resources/specs/marketing.json</inputSpec>
+                            <generatorName>java</generatorName>
+                            <library>native</library>
+                            <apiPackage>dev.sonpx.loyalty.agent.client.api.marketing</apiPackage>
+                            <modelPackage>dev.sonpx.loyalty.agent.client.model.marketing</modelPackage>
+                            <generateApiTests>false</generateApiTests>
+                            <generateModelTests>false</generateModelTests>
+                            <configOptions>
+                                <useJakartaEe>true</useJakartaEe>
+                                <useSpringBoot3>true</useSpringBoot3>
+                            </configOptions>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>generate-master</id>
+                        <goals><goal>generate</goal></goals>
+                        <configuration>
+                            <inputSpec>${project.basedir}/src/main/resources/specs/master.json</inputSpec>
+                            <generatorName>java</generatorName>
+                            <library>native</library>
+                            <apiPackage>dev.sonpx.loyalty.agent.client.api.master</apiPackage>
+                            <modelPackage>dev.sonpx.loyalty.agent.client.model.master</modelPackage>
+                            <generateApiTests>false</generateApiTests>
+                            <generateModelTests>false</generateModelTests>
+                            <configOptions>
+                                <useJakartaEe>true</useJakartaEe>
+                                <useSpringBoot3>true</useSpringBoot3>
+                            </configOptions>
+                        </configuration>
+                    </execution>
+
+                    <execution>
+                        <id>generate-reward</id>
+                        <goals><goal>generate</goal></goals>
+                        <configuration>
+                            <inputSpec>${project.basedir}/src/main/resources/specs/reward.json</inputSpec>
+                            <generatorName>java</generatorName>
+                            <library>native</library>
+                            <apiPackage>dev.sonpx.loyalty.agent.client.api.reward</apiPackage>
+                            <modelPackage>dev.sonpx.loyalty.agent.client.model.reward</modelPackage>
+                            <generateApiTests>false</generateApiTests>
+                            <generateModelTests>false</generateModelTests>
+                            <configOptions>
+                                <useJakartaEe>true</useJakartaEe>
+                                <useSpringBoot3>true</useSpringBoot3>
+                            </configOptions>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>generate-transaction</id>
+                        <goals><goal>generate</goal></goals>
+                        <configuration>
+                            <inputSpec>${project.basedir}/src/main/resources/specs/transaction.json</inputSpec>
+                            <generatorName>java</generatorName>
+                            <library>native</library>
+                            <apiPackage>dev.sonpx.loyalty.agent.client.api.transaction</apiPackage>
+                            <modelPackage>dev.sonpx.loyalty.agent.client.model.transaction</modelPackage>
+                            <generateApiTests>false</generateApiTests>
+                            <generateModelTests>false</generateModelTests>
+                            <configOptions>
+                                <useJakartaEe>true</useJakartaEe>
+                                <useSpringBoot3>true</useSpringBoot3>
+                            </configOptions>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+
+            <!-- Replacer plugin to fix missing import of MultiValueMapStringString in openapi generated code -->
+            <plugin>
+                <groupId>com.google.code.maven-replacer-plugin</groupId>
+                <artifactId>replacer</artifactId>
+                <version>1.5.3</version>
+                <executions>
+                    <execution>
+                        <phase>process-sources</phase>
+                        <goals>
+                            <goal>replace</goal>
+                        </goals>
+                    </execution>
+                </executions>
+                <configuration>
+                    <includes>
+                        <include>${project.basedir}/target/generated-sources/openapi/src/main/java/**/*Api.java</include>
+                    </includes>
+                    <replacements>
+                        <replacement>
+                            <token>(?&lt;!\.)MultiValueMapStringString</token>
+                            <value>dev.sonpx.loyalty.agent.client.model.transaction.MultiValueMapStringString</value>
+                        </replacement>
+                    </replacements>
+                </configuration>
+            </plugin>
+                </plugins>
+            </build>
+        </profile>
+    </profiles>
+
+    <repositories>
+        <repository>
+            <id>spring-milestones</id>
+            <name>Spring Milestones</name>
+            <url>https://repo.spring.io/milestone</url>
+            <snapshots>
+                <enabled>false</enabled>
+            </snapshots>
+        </repository>
+    </repositories>
+</project>
--- a/src/main/java/dev/sonpx/loyalty/agent/LoyaltyAgentApplication.java
+++ b/src/main/java/dev/sonpx/loyalty/agent/LoyaltyAgentApplication.java
@@ -0,0 +1,12 @@
+package dev.sonpx.loyalty.agent;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class LoyaltyAgentApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(LoyaltyAgentApplication.class, args);
+    }
+}
--- a/src/main/java/dev/sonpx/loyalty/agent/client/api/CampaignApi.java
+++ b/src/main/java/dev/sonpx/loyalty/agent/client/api/CampaignApi.java
@@ -0,0 +1,19 @@
+package dev.sonpx.loyalty.agent.client.api;
+
+import com.example.loyalty.agent.client.model.Campaign;
+import com.example.loyalty.agent.client.model.CreateCampaignRequest;
+
+import java.util.UUID;
+
+public class CampaignApi {
+    public Campaign createCampaign(CreateCampaignRequest request) {
+        // Mock behavior
+        return new Campaign(
+                UUID.randomUUID().toString(),
+                request.name(),
+                request.targetTierId(),
+                request.rewardPoolId(),
+                "ACTIVE"
+        );
+    }
+}
--- a/src/main/java/dev/sonpx/loyalty/agent/client/api/MemberTierApi.java
+++ b/src/main/java/dev/sonpx/loyalty/agent/client/api/MemberTierApi.java
@@ -0,0 +1,12 @@
+package dev.sonpx.loyalty.agent.client.api;
+
+import com.example.loyalty.agent.client.model.MemberTier;
+
+import java.util.List;
+
+public class MemberTierApi {
+    public List<MemberTier> listMemberTiers() {
+        // Mock data to ensure it compiles and works before OpenAPI generation
+        return List.of(new MemberTier("TIER_GOLD", "Gold", 1000));
+    }
+}
--- a/src/main/java/dev/sonpx/loyalty/agent/client/api/PointPoolApi.java
+++ b/src/main/java/dev/sonpx/loyalty/agent/client/api/PointPoolApi.java
@@ -0,0 +1,13 @@
+package dev.sonpx.loyalty.agent.client.api;
+
+import com.example.loyalty.agent.client.model.PointPool;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+public class PointPoolApi {
+    public List<PointPool> listPointPools() {
+        // Mock data
+        return List.of(new PointPool("POOL_1", "Main Pool", new BigDecimal("1000000")));
+    }
+}
--- a/src/main/java/dev/sonpx/loyalty/agent/client/model/Campaign.java
+++ b/src/main/java/dev/sonpx/loyalty/agent/client/model/Campaign.java
@@ -0,0 +1,3 @@
+package com.example.loyalty.agent.client.model;
+
+public record Campaign(String campaignId, String name, String targetTierId, String rewardPoolId, String status) {}
--- a/src/main/java/dev/sonpx/loyalty/agent/client/model/CreateCampaignRequest.java
+++ b/src/main/java/dev/sonpx/loyalty/agent/client/model/CreateCampaignRequest.java
@@ -0,0 +1,3 @@
+package com.example.loyalty.agent.client.model;
+
+public record CreateCampaignRequest(String name, String targetTierId, String rewardPoolId) {}
--- a/src/main/java/dev/sonpx/loyalty/agent/client/model/MemberTier.java
+++ b/src/main/java/dev/sonpx/loyalty/agent/client/model/MemberTier.java
@@ -0,0 +1,3 @@
+package com.example.loyalty.agent.client.model;
+
+public record MemberTier(String tierId, String tierName, Integer requiredPoints) {}
--- a/src/main/java/dev/sonpx/loyalty/agent/client/model/PointPool.java
+++ b/src/main/java/dev/sonpx/loyalty/agent/client/model/PointPool.java
@@ -0,0 +1,5 @@
+package com.example.loyalty.agent.client.model;
+
+import java.math.BigDecimal;
+
+public record PointPool(String poolId, String poolName, BigDecimal balance) {}
--- a/src/main/java/dev/sonpx/loyalty/agent/config/ApiClientConfig.java
+++ b/src/main/java/dev/sonpx/loyalty/agent/config/ApiClientConfig.java
@@ -0,0 +1,105 @@
+package dev.sonpx.loyalty.agent.config;
+
+import dev.sonpx.loyalty.agent.client.api.CampaignApi;
+import dev.sonpx.loyalty.agent.client.api.MemberTierApi;
+import dev.sonpx.loyalty.agent.client.api.PointPoolApi;
+import dev.sonpx.loyalty.agent.client.api.ApiClient;
+import dev.sonpx.loyalty.agent.client.api.attribute.StaticAttributeResourceApi;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.security.oauth2.client.OAuth2AuthorizeRequest;
+import org.springframework.security.oauth2.client.OAuth2AuthorizedClient;
+import org.springframework.security.oauth2.client.OAuth2AuthorizedClientManager;
+
+/**
+ * Configures the generated API clients.
+ * This class mocks the configuration that will wrap the actual classes 
+ * generated by openapi-generator-maven-plugin.
+ */
+@Configuration
+public class ApiClientConfig {
+
+    @Value("${loyalty.core.base-url}")
+    private String coreBaseUrl;
+
+    private ApiClient createApiClient(OAuth2AuthorizedClientManager authorizedClientManager, String servicePrefix) {
+        ApiClient apiClient = new ApiClient();
+        apiClient.updateBaseUri(coreBaseUrl + servicePrefix);
+        
+        apiClient.setRequestInterceptor(builder -> {
+            System.out.println("Executing API Client Interceptor for keycloak...");
+            org.springframework.security.core.Authentication principal = 
+                new org.springframework.security.authentication.AnonymousAuthenticationToken(
+                    "key", "loyalty-agent-service", 
+                    org.springframework.security.core.authority.AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS"));
+            OAuth2AuthorizeRequest authorizeRequest = OAuth2AuthorizeRequest
+                    .withClientRegistrationId("keycloak")
+                    .principal(principal)
+                    .build();
+            try {
+                OAuth2AuthorizedClient authorizedClient = authorizedClientManager.authorize(authorizeRequest);
+                if (authorizedClient != null && authorizedClient.getAccessToken() != null) {
+                    System.out.println("Successfully fetched OAuth2 Token! Token length: " + authorizedClient.getAccessToken().getTokenValue().length());
+                    builder.header("Authorization", "Bearer " + authorizedClient.getAccessToken().getTokenValue());
+                } else {
+                    System.out.println("WARNING: authorizedClient is null or accessToken is null!");
+                }
+            } catch (Exception e) {
+                System.out.println("ERROR during OAuth2 authorize: " + e.getMessage());
+                e.printStackTrace();
+            }
+        });
+        
+        return apiClient;
+    }
+
+    @Bean
+    public StaticAttributeResourceApi staticAttributeResourceApi(OAuth2AuthorizedClientManager authorizedClientManager) {
+        return new StaticAttributeResourceApi(createApiClient(authorizedClientManager, "/svc/attribute"));
+    }
+
+    @Bean
+    public org.springframework.web.client.RestClient loyaltyRestClient(OAuth2AuthorizedClientManager authorizedClientManager) {
+        return org.springframework.web.client.RestClient.builder()
+                .baseUrl(coreBaseUrl + "/svc/attribute")
+                .requestInterceptor((request, body, execution) -> {
+                    org.springframework.security.core.Authentication principal = 
+                        new org.springframework.security.authentication.AnonymousAuthenticationToken(
+                            "key", "loyalty-agent-service", 
+                            org.springframework.security.core.authority.AuthorityUtils.createAuthorityList("ROLE_ANONYMOUS"));
+                    OAuth2AuthorizeRequest authorizeRequest = OAuth2AuthorizeRequest
+                            .withClientRegistrationId("keycloak")
+                            .principal(principal)
+                            .build();
+                    try {
+                        OAuth2AuthorizedClient authorizedClient = authorizedClientManager.authorize(authorizeRequest);
+                        if (authorizedClient != null && authorizedClient.getAccessToken() != null) {
+                            request.getHeaders().setBearerAuth(authorizedClient.getAccessToken().getTokenValue());
+                        }
+                    } catch (Exception e) {
+                        e.printStackTrace();
+                    }
+                    return execution.execute(request, body);
+                })
+                .build();
+    }
+
+    @Bean
+    public MemberTierApi memberTierApi() {
+        // In reality: return new MemberTierApi(apiClient());
+        return new MemberTierApi(); 
+    }
+
+    @Bean
+    public PointPoolApi pointPoolApi() {
+        // In reality: return new PointPoolApi(apiClient());
+        return new PointPoolApi();
+    }
+
+    @Bean
+    public CampaignApi campaignApi() {
+        // In reality: return new CampaignApi(apiClient());
+        return new CampaignApi();
+    }
+}
--- a/src/main/java/dev/sonpx/loyalty/agent/config/LoyaltyAgentTools.java
+++ b/src/main/java/dev/sonpx/loyalty/agent/config/LoyaltyAgentTools.java
@@ -0,0 +1,64 @@
+package dev.sonpx.loyalty.agent.config;
+
+import dev.sonpx.loyalty.agent.client.api.CampaignApi;
+import dev.sonpx.loyalty.agent.client.api.MemberTierApi;
+import dev.sonpx.loyalty.agent.client.api.PointPoolApi;
+import dev.sonpx.loyalty.agent.client.api.attribute.StaticAttributeResourceApi;
+import dev.sonpx.loyalty.agent.client.model.attribute.StaticAttributeViewCriteria;
+import dev.sonpx.loyalty.agent.client.model.attribute.StaticAttributeDto;
+import dev.sonpx.loyalty.agent.client.model.attribute.StringFilter;
+import dev.sonpx.loyalty.agent.client.model.attribute.Pageable;
+import com.example.loyalty.agent.client.model.Campaign;
+import com.example.loyalty.agent.client.model.CreateCampaignRequest;
+import com.example.loyalty.agent.client.model.MemberTier;
+import com.example.loyalty.agent.client.model.PointPool;
+import org.springframework.ai.tool.annotation.Tool;
+
+import java.util.Arrays;
+import java.util.List;
+
+public class LoyaltyAgentTools {
+
+    private final MemberTierApi memberTierApi;
+    private final PointPoolApi pointPoolApi;
+    private final CampaignApi campaignApi;
+    private final StaticAttributeResourceApi staticAttributeApi;
+    private final org.springframework.web.client.RestClient restClient;
+
+    public LoyaltyAgentTools(MemberTierApi memberTierApi, PointPoolApi pointPoolApi, CampaignApi campaignApi, StaticAttributeResourceApi staticAttributeApi, org.springframework.web.client.RestClient restClient) {
+        this.memberTierApi = memberTierApi;
+        this.pointPoolApi = pointPoolApi;
+        this.campaignApi = campaignApi;
+        this.staticAttributeApi = staticAttributeApi;
+        this.restClient = restClient;
+    }
+
+    @Tool(description = "List all available Member Tiers. Always use this to verify a Tier exists before creating a Campaign.")
+    public List<MemberTier> listMemberTiers() {
+        return memberTierApi.listMemberTiers();
+    }
+
+    @Tool(description = "List all available Point Pools. Always use this to verify a Pool exists and has sufficient balance before creating a Campaign.")
+    public List<PointPool> listPointPools() {
+        return pointPoolApi.listPointPools();
+    }
+
+    @Tool(description = "Create a new Campaign. This requires a valid targetTierId and rewardPoolId, which MUST be verified beforehand using listMemberTiers and listPointPools.")
+    public Campaign createCampaign(CreateCampaignRequest request) {
+        return campaignApi.createCampaign(request);
+    }
+
+    @Tool(description = "List all available Static Attributes. Use this tool when you need to find configurations, properties, or static values like tier types or currencies.")
+    public List<StaticAttributeDto> listStaticAttributes() {
+        try {
+            String url = "/api/static-attribute/csr/view/list?sort=lastApproveDate,desc&sort=lastUpdateDate,desc&page=0&size=10&status.in=A";
+            return restClient.get()
+                    .uri(url)
+                    .retrieve()
+                    .body(new org.springframework.core.ParameterizedTypeReference<List<StaticAttributeDto>>() {});
+        } catch (Exception e) {
+            e.printStackTrace();
+            throw new RuntimeException("Failed to fetch static attributes", e);
+        }
+    }
+}
--- a/src/main/java/dev/sonpx/loyalty/agent/config/SecurityConfig.java
+++ b/src/main/java/dev/sonpx/loyalty/agent/config/SecurityConfig.java
@@ -0,0 +1,44 @@
+package dev.sonpx.loyalty.agent.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.security.config.annotation.web.builders.HttpSecurity;
+import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
+import org.springframework.security.oauth2.client.AuthorizedClientServiceOAuth2AuthorizedClientManager;
+import org.springframework.security.oauth2.client.OAuth2AuthorizedClientManager;
+import org.springframework.security.oauth2.client.OAuth2AuthorizedClientProvider;
+import org.springframework.security.oauth2.client.OAuth2AuthorizedClientProviderBuilder;
+import org.springframework.security.oauth2.client.OAuth2AuthorizedClientService;
+import org.springframework.security.oauth2.client.registration.ClientRegistrationRepository;
+import org.springframework.security.web.SecurityFilterChain;
+
+@Configuration
+@EnableWebSecurity
+public class SecurityConfig {
+
+    @Bean
+    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
+        http
+            .csrf(csrf -> csrf.disable())
+            .authorizeHttpRequests(auth -> auth.anyRequest().permitAll());
+        return http.build();
+    }
+
+    @Bean
+    public OAuth2AuthorizedClientManager authorizedClientManager(
+            ClientRegistrationRepository clientRegistrationRepository,
+            OAuth2AuthorizedClientService authorizedClientService) {
+
+        OAuth2AuthorizedClientProvider authorizedClientProvider =
+                OAuth2AuthorizedClientProviderBuilder.builder()
+                        .clientCredentials()
+                        .build();
+
+        AuthorizedClientServiceOAuth2AuthorizedClientManager authorizedClientManager =
+                new AuthorizedClientServiceOAuth2AuthorizedClientManager(
+                        clientRegistrationRepository, authorizedClientService);
+        authorizedClientManager.setAuthorizedClientProvider(authorizedClientProvider);
+
+        return authorizedClientManager;
+    }
+}
--- a/src/main/java/dev/sonpx/loyalty/agent/controller/AgentController.java
+++ b/src/main/java/dev/sonpx/loyalty/agent/controller/AgentController.java
@@ -0,0 +1,27 @@
+package dev.sonpx.loyalty.agent.controller;
+
+import dev.sonpx.loyalty.agent.service.LoyaltyAgentService;
+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;
+
+@RestController
+@RequestMapping("/api/v1/agent")
+public class AgentController {
+
+    private final LoyaltyAgentService agentService;
+
+    public AgentController(LoyaltyAgentService agentService) {
+        this.agentService = agentService;
+    }
+
+    public record ChatRequest(String prompt) {}
+    public record ChatResponse(String answer) {}
+
+    @PostMapping("/chat")
+    public ChatResponse chat(@RequestBody ChatRequest request) {
+        String answer = agentService.chat(request.prompt());
+        return new ChatResponse(answer);
+    }
+}
--- a/src/main/java/dev/sonpx/loyalty/agent/service/LoyaltyAgentService.java
+++ b/src/main/java/dev/sonpx/loyalty/agent/service/LoyaltyAgentService.java
@@ -0,0 +1,48 @@
+package dev.sonpx.loyalty.agent.service;
+
+import org.springframework.ai.chat.client.ChatClient;
+import org.springframework.stereotype.Service;
+
+import dev.sonpx.loyalty.agent.client.api.CampaignApi;
+import dev.sonpx.loyalty.agent.client.api.MemberTierApi;
+import dev.sonpx.loyalty.agent.client.api.PointPoolApi;
+import dev.sonpx.loyalty.agent.client.api.attribute.StaticAttributeResourceApi;
+import dev.sonpx.loyalty.agent.config.LoyaltyAgentTools;
+
+@Service
+public class LoyaltyAgentService {
+
+    private final ChatClient chatClient;
+
+    public LoyaltyAgentService(ChatClient.Builder chatClientBuilder,
+                               MemberTierApi memberTierApi, PointPoolApi pointPoolApi,
+                               CampaignApi campaignApi, StaticAttributeResourceApi staticAttributeApi,
+                               org.springframework.web.client.RestClient loyaltyRestClient) {
+        
+        LoyaltyAgentTools tools = new LoyaltyAgentTools(memberTierApi, pointPoolApi, campaignApi, staticAttributeApi, loyaltyRestClient);
+
+        this.chatClient = chatClientBuilder
+                .defaultSystem("""
+                    You are an expert Loyalty System AI Assistant.
+                    Your primary job is to orchestrate operations for our Loyalty core system.
+                    
+                    CRITICAL RULES:
+                    1. DO NOT create a model.client.dev.sonpx.loyalty.agent.Campaign unless you verify that Member Tiers and Point Pools exist first.
+                    2. Use the `listMemberTiers` tool to check for valid tier IDs.
+                    3. Use the `listPointPools` tool to check for valid pool IDs and ensure they have a sufficient balance.
+                    4. Use the `listStaticAttributes` tool when asked about configurations, properties, or static values.
+                    5. Only use the `createCampaign` tool once verification is complete.
+                    6. IMPORTANT: You must use the native tool calling capability to execute tools. NEVER output raw JSON tool calls as your text response. After receiving the tool's result, provide a natural language summary to the user.
+                    7. Always answer the user in the language they used (e.g., Vietnamese).
+                    """)
+                .defaultTools(tools)
+                .build();
+    }
+
+    public String chat(String userMessage) {
+        return this.chatClient.prompt()
+                .user(userMessage)
+                .call()
+                .content();
+    }
+}
--- a/src/main/resources/application.yml
+++ b/src/main/resources/application.yml
@@ -0,0 +1,34 @@
+server:
+  port: 8085
+
+spring:
+  application:
+    name: loyalty-agent-service
+  ai:
+    ollama:
+      base-url: http://192.168.10.112:11434
+      chat:
+        options:
+          model: qwen3.5:9b
+          temperature: 0.3
+  security:
+    oauth2:
+      client:
+        registration:
+          keycloak:
+            client-id: ols-cli
+            client-secret: 1jV8NSAeybIqmUK0AWhI8hgdo1q5itj7
+            authorization-grant-type: client_credentials
+        provider:
+          keycloak:
+            token-uri: http://192.168.99.235/auth/realms/ols-cn-sit/protocol/openid-connect/token
+
+loyalty:
+  core:
+    base-url: http://192.168.99.242:8081
+
+logging:
+  level:
+    org.springframework.ai: DEBUG
+    org.springframework.web: DEBUG
+    dev.sonpx.loyalty: DEBUG
--- a/src/main/resources/specs/attribute.json
+++ b/src/main/resources/specs/attribute.json
--- a/src/main/resources/specs/catalogue.json
+++ b/src/main/resources/specs/catalogue.json
--- a/src/main/resources/specs/customer.json
+++ b/src/main/resources/specs/customer.json
--- a/src/main/resources/specs/identity.json
+++ b/src/main/resources/specs/identity.json
--- a/src/main/resources/specs/marketing.json
+++ b/src/main/resources/specs/marketing.json
--- a/src/main/resources/specs/master.json
+++ b/src/main/resources/specs/master.json
--- a/src/main/resources/specs/reward.json
+++ b/src/main/resources/specs/reward.json
--- a/src/main/resources/specs/transaction.json
+++ b/src/main/resources/specs/transaction.json