From e80383aa0cfa6b2e50872daf829f2eafb24fd989 Mon Sep 17 00:00:00 2001 From: hponte Date: Sun, 1 Mar 2026 23:29:19 -0500 Subject: [PATCH] feat: add transaction and fraud microservices with kafka async validation --- README.md | 5 + solution/README.md | 186 +++++++++++ solution/docker-compose.yml | 47 +++ solution/fraud-service/.gitattributes | 2 + solution/fraud-service/.gitignore | 33 ++ .../.mvn/wrapper/maven-wrapper.properties | 3 + solution/fraud-service/Dockerfile | 19 ++ solution/fraud-service/mvnw | 295 ++++++++++++++++++ solution/fraud-service/mvnw.cmd | 189 +++++++++++ solution/fraud-service/pom.xml | 96 ++++++ .../FraudServiceApplication.java | 13 + .../config/FraudRulesConfig.java | 15 + .../config/KafkaErrorConfig.java | 23 ++ .../event/TransactionCreatedEvent.java | 6 + .../event/TransactionValidatedEvent.java | 5 + .../messaging/listener/FraudListener.java | 34 ++ .../codeh/fraud_service/util/Constants.java | 7 + .../src/main/resources/application.yaml | 32 ++ .../FraudServiceApplicationTests.java | 13 + solution/transaction-service/.gitattributes | 2 + solution/transaction-service/.gitignore | 33 ++ .../.mvn/wrapper/maven-wrapper.properties | 3 + solution/transaction-service/Dockerfile | 19 ++ solution/transaction-service/mvnw | 295 ++++++++++++++++++ solution/transaction-service/mvnw.cmd | 189 +++++++++++ solution/transaction-service/pom.xml | 110 +++++++ .../TransactionServiceApplication.java | 13 + .../config/KafkaErrorConfig.java | 23 ++ .../controller/TransactionController.java | 31 ++ .../dto/request/CreateTransactionRequest.java | 30 ++ .../dto/response/ApiError.java | 11 + .../dto/response/TransactionResponse.java | 30 ++ .../exception/GlobalExceptionHandler.java | 58 ++++ .../mapper/TransactionMapper.java | 27 ++ .../event/TransactionCreatedEvent.java | 7 + .../event/TransactionValidatedEvent.java | 5 + .../TransactionValidatedListener.java | 38 +++ .../publisher/TransactionEventPublisher.java | 21 ++ .../model/Transaction.java | 49 +++ .../model/TransactionStatus.java | 25 ++ .../model/TransactionType.java | 25 ++ .../repository/TransactionRepository.java | 14 + .../TransactionStatusRepository.java | 13 + .../repository/TransactionTypeRepository.java | 9 + .../service/TransactionService.java | 62 ++++ .../src/main/resources/application.yaml | 53 ++++ .../src/main/resources/data.sql | 5 + .../TransactionServiceApplicationTests.java | 13 + 48 files changed, 2236 insertions(+) create mode 100644 solution/README.md create mode 100644 solution/docker-compose.yml create mode 100644 solution/fraud-service/.gitattributes create mode 100644 solution/fraud-service/.gitignore create mode 100644 solution/fraud-service/.mvn/wrapper/maven-wrapper.properties create mode 100644 solution/fraud-service/Dockerfile create mode 100644 solution/fraud-service/mvnw create mode 100644 solution/fraud-service/mvnw.cmd create mode 100644 solution/fraud-service/pom.xml create mode 100644 solution/fraud-service/src/main/java/com/codeh/fraud_service/FraudServiceApplication.java create mode 100644 solution/fraud-service/src/main/java/com/codeh/fraud_service/config/FraudRulesConfig.java create mode 100644 solution/fraud-service/src/main/java/com/codeh/fraud_service/config/KafkaErrorConfig.java create mode 100644 solution/fraud-service/src/main/java/com/codeh/fraud_service/messaging/event/TransactionCreatedEvent.java create mode 100644 solution/fraud-service/src/main/java/com/codeh/fraud_service/messaging/event/TransactionValidatedEvent.java create mode 100644 solution/fraud-service/src/main/java/com/codeh/fraud_service/messaging/listener/FraudListener.java create mode 100644 solution/fraud-service/src/main/java/com/codeh/fraud_service/util/Constants.java create mode 100644 solution/fraud-service/src/main/resources/application.yaml create mode 100644 solution/fraud-service/src/test/java/com/codeh/fraud_service/FraudServiceApplicationTests.java create mode 100644 solution/transaction-service/.gitattributes create mode 100644 solution/transaction-service/.gitignore create mode 100644 solution/transaction-service/.mvn/wrapper/maven-wrapper.properties create mode 100644 solution/transaction-service/Dockerfile create mode 100644 solution/transaction-service/mvnw create mode 100644 solution/transaction-service/mvnw.cmd create mode 100644 solution/transaction-service/pom.xml create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/TransactionServiceApplication.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/config/KafkaErrorConfig.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/controller/TransactionController.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/dto/request/CreateTransactionRequest.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/dto/response/ApiError.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/dto/response/TransactionResponse.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/exception/GlobalExceptionHandler.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/mapper/TransactionMapper.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/event/TransactionCreatedEvent.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/event/TransactionValidatedEvent.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/listener/TransactionValidatedListener.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/publisher/TransactionEventPublisher.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/model/Transaction.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/model/TransactionStatus.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/model/TransactionType.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/repository/TransactionRepository.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/repository/TransactionStatusRepository.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/repository/TransactionTypeRepository.java create mode 100644 solution/transaction-service/src/main/java/com/codeh/transaction_service/service/TransactionService.java create mode 100644 solution/transaction-service/src/main/resources/application.yaml create mode 100644 solution/transaction-service/src/main/resources/data.sql create mode 100644 solution/transaction-service/src/test/java/com/codeh/transaction_service/TransactionServiceApplicationTests.java diff --git a/README.md b/README.md index b067a71026..2f0fd41f37 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,7 @@ +## Candidate Solution + +The implementation can be found in the `/solution` directory. + # Yape Code Challenge :rocket: Our code challenge will let you marvel us with your Jedi coding skills :smile:. @@ -80,3 +84,4 @@ You can use Graphql; When you finish your challenge, after forking a repository, you **must** open a pull request to our repository. There are no limitations to the implementation, you can follow the programming paradigm, modularization, and style that you feel is the most appropriate solution. If you have any questions, please let us know. + diff --git a/solution/README.md b/solution/README.md new file mode 100644 index 0000000000..29cb4ad617 --- /dev/null +++ b/solution/README.md @@ -0,0 +1,186 @@ +# Yape Code Challenge โ€” Event-Driven Transaction System + +This project implements an **asynchronous transaction processing system** using a microservices architecture and Apache Kafka. + +The system validates financial transactions through an anti-fraud service and updates their status asynchronously. + +--- + +## ๐Ÿงฑ Architecture + +Two independent microservices communicate using Kafka events: + +``` +Client โ†’ Transaction Service โ†’ Kafka โ†’ Fraud Service โ†’ Kafka โ†’ Transaction Service โ†’ DB Update +``` + +### Services + +| Service | Responsibility | +| ------------------- | --------------------------------------------------- | +| transaction-service | Creates transactions and updates their status | +| fraud-service | Evaluates fraud rules and returns validation result | + +--- + +## ๐Ÿ”„ Transaction Flow + +1. Client creates a transaction โ†’ stored as **PENDING** +2. transaction-service publishes `transaction-created` +3. fraud-service consumes and evaluates rule +4. fraud-service publishes `transaction-validated` +5. transaction-service consumes and updates โ†’ `APPROVED` or `REJECTED` + +--- + +## ๐Ÿ“ก Kafka Topics + +| Topic | Description | +| --------------------- | -------------------------------------- | +| transaction-created | New transaction event | +| transaction-validated | Fraud validation result | +| *.DLT | Dead Letter Topic for invalid messages | + +--- + +## โš™๏ธ Fraud Rule + +Transactions greater than configured value are rejected: + +``` +fraud.rules.max-amount = 1000 +``` + +--- + +## ๐Ÿ›ก๏ธ Reliability Features + +### Idempotent Consumer + +The transaction service ignores duplicated validation events. + +### Optimistic Locking + +`@Version` is used to prevent concurrent updates. + +### Poison Message Handling + +Invalid messages are redirected to a Dead Letter Topic (DLT) instead of stopping the consumer. + +### Decoupled Serialization + +Kafka type headers are disabled to avoid coupling services to Java classpaths. + +--- + +## ๐Ÿš€ Running the Project + +### Requirements + +* Docker +* Docker Compose + +### Start system + +```bash +docker compose up --build +``` + +Services: + +* transaction-service โ†’ http://localhost:8080 +* fraud-service โ†’ http://localhost:8081 +* kafka โ†’ localhost:9092 +* postgres โ†’ localhost:5433 + +--- + +## ๐Ÿงช API Usage + +### Create Transaction + +POST `/transactions` + +```json +{ + "accountExternalIdDebit": "11111111-1111-1111-1111-111111111111", + "accountExternalIdCredit": "22222222-2222-2222-2222-222222222222", + "transferTypeId": 1, + "value": 120 +} +``` + +Response (initial): + +```json +{ + "transactionExternalId": "uuid", + "transactionStatus": { "name": "PENDING" } +} +``` + +After async processing: + +```json +{ + "transactionExternalId": "uuid", + "transactionStatus": { "name": "APPROVED" } +} +``` + +If value > 1000: + +```json +{ + "transactionStatus": { "name": "REJECTED" } +} +``` + +--- + +### Get Transaction + +GET `/transactions/{transactionExternalId}` + +--- + +## ๐Ÿ” Testing DLT + +Send invalid message: + +```bash +kafka-console-producer --bootstrap-server kafka:9092 --topic transaction-validated +{"transactionExternalId":"abc","status":123} +``` + +Consume DLT: + +```bash +kafka-console-consumer --bootstrap-server kafka:9092 --topic transaction-validated.DLT --from-beginning +``` + +--- + +## ๐Ÿง  Design Decisions + +* Event-driven architecture for loose coupling +* At-least-once processing semantics +* Idempotent consumers to handle retries +* Dead Letter Topic for resilience +* Externalized fraud rules configuration + +--- + +## ๐Ÿ“Œ Possible Improvements + +* Add auditing fields such as updatedAt to track status changes and provide full transaction lifecycle visibility. +* Outbox Pattern for transactional publishing +* Schema Registry (Avro/Protobuf) +* Retry topics strategy +* Metrics and tracing (OpenTelemetry) + +--- + +## Author + +Hans Ponte diff --git a/solution/docker-compose.yml b/solution/docker-compose.yml new file mode 100644 index 0000000000..4fae3ffe75 --- /dev/null +++ b/solution/docker-compose.yml @@ -0,0 +1,47 @@ +services: + + postgres: + image: postgres:15 + container_name: postgres + environment: + POSTGRES_DB: transaction_db + POSTGRES_USER: postgres + POSTGRES_PASSWORD: postgres + ports: + - "5433:5432" + + zookeeper: + image: confluentinc/cp-zookeeper:7.5.0 + container_name: zookeeper + environment: + ZOOKEEPER_CLIENT_PORT: 2181 + + kafka: + image: confluentinc/cp-kafka:7.5.0 + container_name: kafka + depends_on: + - zookeeper + ports: + - "9092:9092" + environment: + KAFKA_BROKER_ID: 1 + KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181 + KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://kafka:9092 + KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1 + + transaction-service: + build: ./transaction-service + container_name: transaction-service + depends_on: + - postgres + - kafka + ports: + - "8080:8080" + + fraud-service: + build: ./fraud-service + container_name: fraud-service + depends_on: + - kafka + ports: + - "8081:8081" \ No newline at end of file diff --git a/solution/fraud-service/.gitattributes b/solution/fraud-service/.gitattributes new file mode 100644 index 0000000000..3b41682ac5 --- /dev/null +++ b/solution/fraud-service/.gitattributes @@ -0,0 +1,2 @@ +/mvnw text eol=lf +*.cmd text eol=crlf diff --git a/solution/fraud-service/.gitignore b/solution/fraud-service/.gitignore new file mode 100644 index 0000000000..667aaef0c8 --- /dev/null +++ b/solution/fraud-service/.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/ diff --git a/solution/fraud-service/.mvn/wrapper/maven-wrapper.properties b/solution/fraud-service/.mvn/wrapper/maven-wrapper.properties new file mode 100644 index 0000000000..8dea6c227c --- /dev/null +++ b/solution/fraud-service/.mvn/wrapper/maven-wrapper.properties @@ -0,0 +1,3 @@ +wrapperVersion=3.3.4 +distributionType=only-script +distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.12/apache-maven-3.9.12-bin.zip diff --git a/solution/fraud-service/Dockerfile b/solution/fraud-service/Dockerfile new file mode 100644 index 0000000000..aa1639201e --- /dev/null +++ b/solution/fraud-service/Dockerfile @@ -0,0 +1,19 @@ +# ---------- BUILD STAGE ---------- +FROM maven:3.9.9-eclipse-temurin-17 AS build +WORKDIR /workspace + +COPY pom.xml . +COPY src ./src + +RUN mvn -q -DskipTests clean package + +# ---------- RUN STAGE ---------- +FROM eclipse-temurin:17-jdk-alpine + +WORKDIR /app + +COPY --from=build /workspace/target/*.jar app.jar + +EXPOSE 8081 + +ENTRYPOINT ["java","-jar","app.jar"] \ No newline at end of file diff --git a/solution/fraud-service/mvnw b/solution/fraud-service/mvnw new file mode 100644 index 0000000000..bd8896bf22 --- /dev/null +++ b/solution/fraud-service/mvnw @@ -0,0 +1,295 @@ +#!/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.4 +# +# Optional ENV vars +# ----------------- +# JAVA_HOME - location of a JDK home dir, required when download maven via java source +# MVNW_REPOURL - repo url base for downloading maven distribution +# MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven +# MVNW_VERBOSE - true: enable verbose log; debug: trace the mvnw script; others: silence the output +# ---------------------------------------------------------------------------- + +set -euf +[ "${MVNW_VERBOSE-}" != debug ] || set -x + +# OS specific support. +native_path() { printf %s\\n "$1"; } +case "$(uname)" in +CYGWIN* | MINGW*) + [ -z "${JAVA_HOME-}" ] || JAVA_HOME="$(cygpath --unix "$JAVA_HOME")" + native_path() { cygpath --path --windows "$1"; } + ;; +esac + +# set JAVACMD and JAVACCMD +set_java_home() { + # For Cygwin and MinGW, ensure paths are in Unix format before anything is touched + 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" + JAVACCMD="$JAVA_HOME/jre/sh/javac" + else + JAVACMD="$JAVA_HOME/bin/java" + JAVACCMD="$JAVA_HOME/bin/javac" + + if [ ! -x "$JAVACMD" ] || [ ! -x "$JAVACCMD" ]; then + echo "The JAVA_HOME environment variable is not defined correctly, so mvnw cannot run." >&2 + echo "JAVA_HOME is set to \"$JAVA_HOME\", but \"\$JAVA_HOME/bin/java\" or \"\$JAVA_HOME/bin/javac\" does not exist." >&2 + return 1 + fi + fi + else + JAVACMD="$( + 'set' +e + 'unset' -f command 2>/dev/null + 'command' -v java + )" || : + JAVACCMD="$( + 'set' +e + 'unset' -f command 2>/dev/null + 'command' -v javac + )" || : + + if [ ! -x "${JAVACMD-}" ] || [ ! -x "${JAVACCMD-}" ]; then + echo "The java/javac command does not exist in PATH nor is JAVA_HOME set, so mvnw cannot run." >&2 + return 1 + fi + fi +} + +# hash string like Java String::hashCode +hash_string() { + str="${1:-}" h=0 + while [ -n "$str" ]; do + char="${str%"${str#?}"}" + h=$(((h * 31 + $(LC_CTYPE=C printf %d "'$char")) % 4294967296)) + str="${str#?}" + done + printf %x\\n $h +} + +verbose() { :; } +[ "${MVNW_VERBOSE-}" != true ] || verbose() { printf %s\\n "${1-}"; } + +die() { + printf %s\\n "$1" >&2 + exit 1 +} + +trim() { + # MWRAPPER-139: + # Trims trailing and leading whitespace, carriage returns, tabs, and linefeeds. + # Needed for removing poorly interpreted newline sequences when running in more + # exotic environments such as mingw bash on Windows. + printf "%s" "${1}" | tr -d '[:space:]' +} + +scriptDir="$(dirname "$0")" +scriptName="$(basename "$0")" + +# parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties +while IFS="=" read -r key value; do + case "${key-}" in + distributionUrl) distributionUrl=$(trim "${value-}") ;; + distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;; + esac +done <"$scriptDir/.mvn/wrapper/maven-wrapper.properties" +[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties" + +case "${distributionUrl##*/}" in +maven-mvnd-*bin.*) + MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ + case "${PROCESSOR_ARCHITECTURE-}${PROCESSOR_ARCHITEW6432-}:$(uname -a)" in + *AMD64:CYGWIN* | *AMD64:MINGW*) distributionPlatform=windows-amd64 ;; + :Darwin*x86_64) distributionPlatform=darwin-amd64 ;; + :Darwin*arm64) distributionPlatform=darwin-aarch64 ;; + :Linux*x86_64*) distributionPlatform=linux-amd64 ;; + *) + echo "Cannot detect native platform for mvnd on $(uname)-$(uname -m), use pure java version" >&2 + distributionPlatform=linux-amd64 + ;; + esac + distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip" + ;; +maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;; +*) MVN_CMD="mvn${scriptName#mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;; +esac + +# apply MVNW_REPOURL and calculate MAVEN_HOME +# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ +[ -z "${MVNW_REPOURL-}" ] || distributionUrl="$MVNW_REPOURL$_MVNW_REPO_PATTERN${distributionUrl#*"$_MVNW_REPO_PATTERN"}" +distributionUrlName="${distributionUrl##*/}" +distributionUrlNameMain="${distributionUrlName%.*}" +distributionUrlNameMain="${distributionUrlNameMain%-bin}" +MAVEN_USER_HOME="${MAVEN_USER_HOME:-${HOME}/.m2}" +MAVEN_HOME="${MAVEN_USER_HOME}/wrapper/dists/${distributionUrlNameMain-}/$(hash_string "$distributionUrl")" + +exec_maven() { + unset MVNW_VERBOSE MVNW_USERNAME MVNW_PASSWORD MVNW_REPOURL || : + exec "$MAVEN_HOME/bin/$MVN_CMD" "$@" || die "cannot exec $MAVEN_HOME/bin/$MVN_CMD" +} + +if [ -d "$MAVEN_HOME" ]; then + verbose "found existing MAVEN_HOME at $MAVEN_HOME" + exec_maven "$@" +fi + +case "${distributionUrl-}" in +*?-bin.zip | *?maven-mvnd-?*-?*.zip) ;; +*) die "distributionUrl is not valid, must match *-bin.zip or maven-mvnd-*.zip, but found '${distributionUrl-}'" ;; +esac + +# prepare tmp dir +if TMP_DOWNLOAD_DIR="$(mktemp -d)" && [ -d "$TMP_DOWNLOAD_DIR" ]; then + clean() { rm -rf -- "$TMP_DOWNLOAD_DIR"; } + trap clean HUP INT TERM EXIT +else + die "cannot create temp dir" +fi + +mkdir -p -- "${MAVEN_HOME%/*}" + +# Download and Install Apache Maven +verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." +verbose "Downloading from: $distributionUrl" +verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" + +# select .zip or .tar.gz +if ! command -v unzip >/dev/null; then + distributionUrl="${distributionUrl%.zip}.tar.gz" + distributionUrlName="${distributionUrl##*/}" +fi + +# verbose opt +__MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR='' +[ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v + +# normalize http auth +case "${MVNW_PASSWORD:+has-password}" in +'') MVNW_USERNAME='' MVNW_PASSWORD='' ;; +has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;; +esac + +if [ -z "${MVNW_USERNAME-}" ] && command -v wget >/dev/null; then + verbose "Found wget ... using wget" + wget ${__MVNW_QUIET_WGET:+"$__MVNW_QUIET_WGET"} "$distributionUrl" -O "$TMP_DOWNLOAD_DIR/$distributionUrlName" || die "wget: Failed to fetch $distributionUrl" +elif [ -z "${MVNW_USERNAME-}" ] && command -v curl >/dev/null; then + verbose "Found curl ... using curl" + curl ${__MVNW_QUIET_CURL:+"$__MVNW_QUIET_CURL"} -f -L -o "$TMP_DOWNLOAD_DIR/$distributionUrlName" "$distributionUrl" || die "curl: Failed to fetch $distributionUrl" +elif set_java_home; then + verbose "Falling back to use Java to download" + javaSource="$TMP_DOWNLOAD_DIR/Downloader.java" + targetZip="$TMP_DOWNLOAD_DIR/$distributionUrlName" + cat >"$javaSource" <<-END + public class Downloader extends java.net.Authenticator + { + protected java.net.PasswordAuthentication getPasswordAuthentication() + { + return new java.net.PasswordAuthentication( System.getenv( "MVNW_USERNAME" ), System.getenv( "MVNW_PASSWORD" ).toCharArray() ); + } + public static void main( String[] args ) throws Exception + { + setDefault( new Downloader() ); + java.nio.file.Files.copy( java.net.URI.create( args[0] ).toURL().openStream(), java.nio.file.Paths.get( args[1] ).toAbsolutePath().normalize() ); + } + } + END + # For Cygwin/MinGW, switch paths to Windows format before running javac and java + verbose " - Compiling Downloader.java ..." + "$(native_path "$JAVACCMD")" "$(native_path "$javaSource")" || die "Failed to compile Downloader.java" + verbose " - Running Downloader.java ..." + "$(native_path "$JAVACMD")" -cp "$(native_path "$TMP_DOWNLOAD_DIR")" Downloader "$distributionUrl" "$(native_path "$targetZip")" +fi + +# If specified, validate the SHA-256 sum of the Maven distribution zip file +if [ -n "${distributionSha256Sum-}" ]; then + distributionSha256Result=false + if [ "$MVN_CMD" = mvnd.sh ]; then + echo "Checksum validation is not supported for maven-mvnd." >&2 + echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2 + exit 1 + elif command -v sha256sum >/dev/null; then + if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c - >/dev/null 2>&1; then + distributionSha256Result=true + fi + elif command -v shasum >/dev/null; then + if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | shasum -a 256 -c >/dev/null 2>&1; then + distributionSha256Result=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 'distributionSha256Sum' from your maven-wrapper.properties." >&2 + exit 1 + fi + if [ $distributionSha256Result = false ]; then + echo "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised." >&2 + echo "If you updated your Maven version, you need to update the specified distributionSha256Sum property." >&2 + exit 1 + fi +fi + +# unzip and move +if command -v unzip >/dev/null; then + unzip ${__MVNW_QUIET_UNZIP:+"$__MVNW_QUIET_UNZIP"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -d "$TMP_DOWNLOAD_DIR" || die "failed to unzip" +else + tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar" +fi + +# Find the actual extracted directory name (handles snapshots where filename != directory name) +actualDistributionDir="" + +# First try the expected directory name (for regular distributions) +if [ -d "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" ]; then + if [ -f "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/bin/$MVN_CMD" ]; then + actualDistributionDir="$distributionUrlNameMain" + fi +fi + +# If not found, search for any directory with the Maven executable (for snapshots) +if [ -z "$actualDistributionDir" ]; then + # enable globbing to iterate over items + set +f + for dir in "$TMP_DOWNLOAD_DIR"/*; do + if [ -d "$dir" ]; then + if [ -f "$dir/bin/$MVN_CMD" ]; then + actualDistributionDir="$(basename "$dir")" + break + fi + fi + done + set -f +fi + +if [ -z "$actualDistributionDir" ]; then + verbose "Contents of $TMP_DOWNLOAD_DIR:" + verbose "$(ls -la "$TMP_DOWNLOAD_DIR")" + die "Could not find Maven distribution directory in extracted archive" +fi + +verbose "Found extracted Maven distribution directory: $actualDistributionDir" +printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$actualDistributionDir/mvnw.url" +mv -- "$TMP_DOWNLOAD_DIR/$actualDistributionDir" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME" + +clean || : +exec_maven "$@" diff --git a/solution/fraud-service/mvnw.cmd b/solution/fraud-service/mvnw.cmd new file mode 100644 index 0000000000..92450f9327 --- /dev/null +++ b/solution/fraud-service/mvnw.cmd @@ -0,0 +1,189 @@ +<# : batch portion +@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.4 +@REM +@REM Optional ENV vars +@REM MVNW_REPOURL - repo url base for downloading maven distribution +@REM MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven +@REM MVNW_VERBOSE - true: enable verbose log; others: silence the output +@REM ---------------------------------------------------------------------------- + +@IF "%__MVNW_ARG0_NAME__%"=="" (SET __MVNW_ARG0_NAME__=%~nx0) +@SET __MVNW_CMD__= +@SET __MVNW_ERROR__= +@SET __MVNW_PSMODULEP_SAVE=%PSModulePath% +@SET PSModulePath= +@FOR /F "usebackq tokens=1* delims==" %%A IN (`powershell -noprofile "& {$scriptDir='%~dp0'; $script='%__MVNW_ARG0_NAME__%'; icm -ScriptBlock ([Scriptblock]::Create((Get-Content -Raw '%~f0'))) -NoNewScope}"`) DO @( + IF "%%A"=="MVN_CMD" (set __MVNW_CMD__=%%B) ELSE IF "%%B"=="" (echo %%A) ELSE (echo %%A=%%B) +) +@SET PSModulePath=%__MVNW_PSMODULEP_SAVE% +@SET __MVNW_PSMODULEP_SAVE= +@SET __MVNW_ARG0_NAME__= +@SET MVNW_USERNAME= +@SET MVNW_PASSWORD= +@IF NOT "%__MVNW_CMD__%"=="" ("%__MVNW_CMD__%" %*) +@echo Cannot start maven from wrapper >&2 && exit /b 1 +@GOTO :EOF +: end batch / begin powershell #> + +$ErrorActionPreference = "Stop" +if ($env:MVNW_VERBOSE -eq "true") { + $VerbosePreference = "Continue" +} + +# calculate distributionUrl, requires .mvn/wrapper/maven-wrapper.properties +$distributionUrl = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionUrl +if (!$distributionUrl) { + Write-Error "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties" +} + +switch -wildcard -casesensitive ( $($distributionUrl -replace '^.*/','') ) { + "maven-mvnd-*" { + $USE_MVND = $true + $distributionUrl = $distributionUrl -replace '-bin\.[^.]*$',"-windows-amd64.zip" + $MVN_CMD = "mvnd.cmd" + break + } + default { + $USE_MVND = $false + $MVN_CMD = $script -replace '^mvnw','mvn' + break + } +} + +# apply MVNW_REPOURL and calculate MAVEN_HOME +# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ +if ($env:MVNW_REPOURL) { + $MVNW_REPO_PATTERN = if ($USE_MVND -eq $False) { "/org/apache/maven/" } else { "/maven/mvnd/" } + $distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace "^.*$MVNW_REPO_PATTERN",'')" +} +$distributionUrlName = $distributionUrl -replace '^.*/','' +$distributionUrlNameMain = $distributionUrlName -replace '\.[^.]*$','' -replace '-bin$','' + +$MAVEN_M2_PATH = "$HOME/.m2" +if ($env:MAVEN_USER_HOME) { + $MAVEN_M2_PATH = "$env:MAVEN_USER_HOME" +} + +if (-not (Test-Path -Path $MAVEN_M2_PATH)) { + New-Item -Path $MAVEN_M2_PATH -ItemType Directory | Out-Null +} + +$MAVEN_WRAPPER_DISTS = $null +if ((Get-Item $MAVEN_M2_PATH).Target[0] -eq $null) { + $MAVEN_WRAPPER_DISTS = "$MAVEN_M2_PATH/wrapper/dists" +} else { + $MAVEN_WRAPPER_DISTS = (Get-Item $MAVEN_M2_PATH).Target[0] + "/wrapper/dists" +} + +$MAVEN_HOME_PARENT = "$MAVEN_WRAPPER_DISTS/$distributionUrlNameMain" +$MAVEN_HOME_NAME = ([System.Security.Cryptography.SHA256]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join '' +$MAVEN_HOME = "$MAVEN_HOME_PARENT/$MAVEN_HOME_NAME" + +if (Test-Path -Path "$MAVEN_HOME" -PathType Container) { + Write-Verbose "found existing MAVEN_HOME at $MAVEN_HOME" + Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" + exit $? +} + +if (! $distributionUrlNameMain -or ($distributionUrlName -eq $distributionUrlNameMain)) { + Write-Error "distributionUrl is not valid, must end with *-bin.zip, but found $distributionUrl" +} + +# prepare tmp dir +$TMP_DOWNLOAD_DIR_HOLDER = New-TemporaryFile +$TMP_DOWNLOAD_DIR = New-Item -Itemtype Directory -Path "$TMP_DOWNLOAD_DIR_HOLDER.dir" +$TMP_DOWNLOAD_DIR_HOLDER.Delete() | Out-Null +trap { + if ($TMP_DOWNLOAD_DIR.Exists) { + try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } + catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } + } +} + +New-Item -Itemtype Directory -Path "$MAVEN_HOME_PARENT" -Force | Out-Null + +# Download and Install Apache Maven +Write-Verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." +Write-Verbose "Downloading from: $distributionUrl" +Write-Verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" + +$webclient = New-Object System.Net.WebClient +if ($env:MVNW_USERNAME -and $env:MVNW_PASSWORD) { + $webclient.Credentials = New-Object System.Net.NetworkCredential($env:MVNW_USERNAME, $env:MVNW_PASSWORD) +} +[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 +$webclient.DownloadFile($distributionUrl, "$TMP_DOWNLOAD_DIR/$distributionUrlName") | Out-Null + +# If specified, validate the SHA-256 sum of the Maven distribution zip file +$distributionSha256Sum = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionSha256Sum +if ($distributionSha256Sum) { + if ($USE_MVND) { + Write-Error "Checksum validation is not supported for maven-mvnd. `nPlease disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." + } + Import-Module $PSHOME\Modules\Microsoft.PowerShell.Utility -Function Get-FileHash + if ((Get-FileHash "$TMP_DOWNLOAD_DIR/$distributionUrlName" -Algorithm SHA256).Hash.ToLower() -ne $distributionSha256Sum) { + Write-Error "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised. If you updated your Maven version, you need to update the specified distributionSha256Sum property." + } +} + +# unzip and move +Expand-Archive "$TMP_DOWNLOAD_DIR/$distributionUrlName" -DestinationPath "$TMP_DOWNLOAD_DIR" | Out-Null + +# Find the actual extracted directory name (handles snapshots where filename != directory name) +$actualDistributionDir = "" + +# First try the expected directory name (for regular distributions) +$expectedPath = Join-Path "$TMP_DOWNLOAD_DIR" "$distributionUrlNameMain" +$expectedMvnPath = Join-Path "$expectedPath" "bin/$MVN_CMD" +if ((Test-Path -Path $expectedPath -PathType Container) -and (Test-Path -Path $expectedMvnPath -PathType Leaf)) { + $actualDistributionDir = $distributionUrlNameMain +} + +# If not found, search for any directory with the Maven executable (for snapshots) +if (!$actualDistributionDir) { + Get-ChildItem -Path "$TMP_DOWNLOAD_DIR" -Directory | ForEach-Object { + $testPath = Join-Path $_.FullName "bin/$MVN_CMD" + if (Test-Path -Path $testPath -PathType Leaf) { + $actualDistributionDir = $_.Name + } + } +} + +if (!$actualDistributionDir) { + Write-Error "Could not find Maven distribution directory in extracted archive" +} + +Write-Verbose "Found extracted Maven distribution directory: $actualDistributionDir" +Rename-Item -Path "$TMP_DOWNLOAD_DIR/$actualDistributionDir" -NewName $MAVEN_HOME_NAME | Out-Null +try { + Move-Item -Path "$TMP_DOWNLOAD_DIR/$MAVEN_HOME_NAME" -Destination $MAVEN_HOME_PARENT | Out-Null +} catch { + if (! (Test-Path -Path "$MAVEN_HOME" -PathType Container)) { + Write-Error "fail to move MAVEN_HOME" + } +} finally { + try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } + catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } +} + +Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" diff --git a/solution/fraud-service/pom.xml b/solution/fraud-service/pom.xml new file mode 100644 index 0000000000..3fbd95e244 --- /dev/null +++ b/solution/fraud-service/pom.xml @@ -0,0 +1,96 @@ + + + 4.0.0 + + org.springframework.boot + spring-boot-starter-parent + 3.5.3 + + + com.codeh + fraud-service + 01.00.00 + fraud-service + Demo project for Spring Boot + + 17 + + + + org.springframework.boot + spring-boot-starter-web + + + org.springframework.kafka + spring-kafka + + + + org.projectlombok + lombok + true + + + org.springframework.boot + spring-boot-starter-test + test + + + org.springframework.kafka + spring-kafka-test + test + + + + + + + org.apache.maven.plugins + maven-compiler-plugin + + + + org.projectlombok + lombok + ${lombok.version} + + + + + + org.springframework.boot + spring-boot-maven-plugin + + + + org.projectlombok + lombok + + + + + + + + + spring-snapshots + Spring Snapshots + https://repo.spring.io/snapshot + + false + + + + + + spring-snapshots + Spring Snapshots + https://repo.spring.io/snapshot + + false + + + + + diff --git a/solution/fraud-service/src/main/java/com/codeh/fraud_service/FraudServiceApplication.java b/solution/fraud-service/src/main/java/com/codeh/fraud_service/FraudServiceApplication.java new file mode 100644 index 0000000000..bd1ab2c5ad --- /dev/null +++ b/solution/fraud-service/src/main/java/com/codeh/fraud_service/FraudServiceApplication.java @@ -0,0 +1,13 @@ +package com.codeh.fraud_service; + +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; + +@SpringBootApplication +public class FraudServiceApplication { + + public static void main(String[] args) { + SpringApplication.run(FraudServiceApplication.class, args); + } + +} diff --git a/solution/fraud-service/src/main/java/com/codeh/fraud_service/config/FraudRulesConfig.java b/solution/fraud-service/src/main/java/com/codeh/fraud_service/config/FraudRulesConfig.java new file mode 100644 index 0000000000..4ee9a2f39b --- /dev/null +++ b/solution/fraud-service/src/main/java/com/codeh/fraud_service/config/FraudRulesConfig.java @@ -0,0 +1,15 @@ +package com.codeh.fraud_service.config; + +import lombok.Getter; +import lombok.Setter; +import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.stereotype.Component; +import java.math.BigDecimal; + +@Getter +@Setter +@Component +@ConfigurationProperties(prefix = "fraud.rules") +public class FraudRulesConfig { + private BigDecimal maxAmount; +} diff --git a/solution/fraud-service/src/main/java/com/codeh/fraud_service/config/KafkaErrorConfig.java b/solution/fraud-service/src/main/java/com/codeh/fraud_service/config/KafkaErrorConfig.java new file mode 100644 index 0000000000..7074bddf30 --- /dev/null +++ b/solution/fraud-service/src/main/java/com/codeh/fraud_service/config/KafkaErrorConfig.java @@ -0,0 +1,23 @@ +package com.codeh.fraud_service.config; + +import org.apache.kafka.common.TopicPartition; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.kafka.core.KafkaTemplate; +import org.springframework.kafka.listener.DeadLetterPublishingRecoverer; +import org.springframework.kafka.listener.DefaultErrorHandler; +import org.springframework.util.backoff.FixedBackOff; + +@Configuration +public class KafkaErrorConfig { + + @Bean + public DefaultErrorHandler kafkaErrorHandler(KafkaTemplate template) { + + DeadLetterPublishingRecoverer recoverer = + new DeadLetterPublishingRecoverer(template, + (record, ex) -> new TopicPartition(record.topic() + ".DLT", record.partition())); + + return new DefaultErrorHandler(recoverer, new FixedBackOff(0L, 0)); + } +} \ No newline at end of file diff --git a/solution/fraud-service/src/main/java/com/codeh/fraud_service/messaging/event/TransactionCreatedEvent.java b/solution/fraud-service/src/main/java/com/codeh/fraud_service/messaging/event/TransactionCreatedEvent.java new file mode 100644 index 0000000000..f3d1326385 --- /dev/null +++ b/solution/fraud-service/src/main/java/com/codeh/fraud_service/messaging/event/TransactionCreatedEvent.java @@ -0,0 +1,6 @@ +package com.codeh.fraud_service.messaging.event; + +import java.math.BigDecimal; +import java.util.UUID; + +public record TransactionCreatedEvent(UUID transactionExternalId, BigDecimal value) {} \ No newline at end of file diff --git a/solution/fraud-service/src/main/java/com/codeh/fraud_service/messaging/event/TransactionValidatedEvent.java b/solution/fraud-service/src/main/java/com/codeh/fraud_service/messaging/event/TransactionValidatedEvent.java new file mode 100644 index 0000000000..951d484740 --- /dev/null +++ b/solution/fraud-service/src/main/java/com/codeh/fraud_service/messaging/event/TransactionValidatedEvent.java @@ -0,0 +1,5 @@ +package com.codeh.fraud_service.messaging.event; + +import java.util.UUID; + +public record TransactionValidatedEvent(UUID transactionExternalId, String status) {} \ No newline at end of file diff --git a/solution/fraud-service/src/main/java/com/codeh/fraud_service/messaging/listener/FraudListener.java b/solution/fraud-service/src/main/java/com/codeh/fraud_service/messaging/listener/FraudListener.java new file mode 100644 index 0000000000..d4ce195bfe --- /dev/null +++ b/solution/fraud-service/src/main/java/com/codeh/fraud_service/messaging/listener/FraudListener.java @@ -0,0 +1,34 @@ +package com.codeh.fraud_service.messaging.listener; + +import com.codeh.fraud_service.config.FraudRulesConfig; +import com.codeh.fraud_service.messaging.event.TransactionCreatedEvent; +import com.codeh.fraud_service.messaging.event.TransactionValidatedEvent; +import lombok.RequiredArgsConstructor; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.kafka.annotation.KafkaListener; +import org.springframework.kafka.core.KafkaTemplate; +import org.springframework.stereotype.Component; +import static com.codeh.fraud_service.util.Constants.*; + +@Component +@RequiredArgsConstructor +public class FraudListener { + + @Value("${kafka.topics.transaction-validated}") + private String validatedTopic; + + private final KafkaTemplate kafkaTemplate; + private final FraudRulesConfig rules; + + @KafkaListener(topics = "${kafka.topics.transaction-created}", groupId = "${spring.kafka.consumer.group-id}") + public void onTransactionCreated(TransactionCreatedEvent event) { + + String status = event.value().compareTo(rules.getMaxAmount()) > ZERO ? STATUS_REJECTED : STATUS_APPROVED; + + TransactionValidatedEvent validated = + new TransactionValidatedEvent(event.transactionExternalId(), status); + + kafkaTemplate.send(validatedTopic, event.transactionExternalId().toString(), validated); + } + +} diff --git a/solution/fraud-service/src/main/java/com/codeh/fraud_service/util/Constants.java b/solution/fraud-service/src/main/java/com/codeh/fraud_service/util/Constants.java new file mode 100644 index 0000000000..4b61cab7b3 --- /dev/null +++ b/solution/fraud-service/src/main/java/com/codeh/fraud_service/util/Constants.java @@ -0,0 +1,7 @@ +package com.codeh.fraud_service.util; + +public class Constants { + public static final String STATUS_REJECTED = "REJECTED"; + public static final String STATUS_APPROVED = "APPROVED"; + public static final int ZERO = 0; +} diff --git a/solution/fraud-service/src/main/resources/application.yaml b/solution/fraud-service/src/main/resources/application.yaml new file mode 100644 index 0000000000..08ac9874aa --- /dev/null +++ b/solution/fraud-service/src/main/resources/application.yaml @@ -0,0 +1,32 @@ +server: + port: 8081 + +fraud: + rules: + max-amount: 1000 + +kafka: + topics: + transaction-created: transaction-created + transaction-validated: transaction-validated + +spring: + application: + name: fraud-service + kafka: + bootstrap-servers: kafka:9092 + consumer: + group-id: fraud-group + auto-offset-reset: earliest + key-deserializer: org.springframework.kafka.support.serializer.ErrorHandlingDeserializer + value-deserializer: org.springframework.kafka.support.serializer.ErrorHandlingDeserializer + properties: + spring.deserializer.key.delegate.class: org.apache.kafka.common.serialization.StringDeserializer + spring.deserializer.value.delegate.class: org.springframework.kafka.support.serializer.JsonDeserializer + spring.json.trusted.packages: "*" + spring.json.value.default.type: com.codeh.fraud_service.messaging.event.TransactionCreatedEvent + producer: + key-serializer: org.apache.kafka.common.serialization.StringSerializer + value-serializer: org.springframework.kafka.support.serializer.JsonSerializer + properties: + spring.json.add.type.headers: false diff --git a/solution/fraud-service/src/test/java/com/codeh/fraud_service/FraudServiceApplicationTests.java b/solution/fraud-service/src/test/java/com/codeh/fraud_service/FraudServiceApplicationTests.java new file mode 100644 index 0000000000..363fea68b3 --- /dev/null +++ b/solution/fraud-service/src/test/java/com/codeh/fraud_service/FraudServiceApplicationTests.java @@ -0,0 +1,13 @@ +package com.codeh.fraud_service; + +import org.junit.jupiter.api.Test; +import org.springframework.boot.test.context.SpringBootTest; + +@SpringBootTest +class FraudServiceApplicationTests { + + @Test + void contextLoads() { + } + +} diff --git a/solution/transaction-service/.gitattributes b/solution/transaction-service/.gitattributes new file mode 100644 index 0000000000..3b41682ac5 --- /dev/null +++ b/solution/transaction-service/.gitattributes @@ -0,0 +1,2 @@ +/mvnw text eol=lf +*.cmd text eol=crlf diff --git a/solution/transaction-service/.gitignore b/solution/transaction-service/.gitignore new file mode 100644 index 0000000000..667aaef0c8 --- /dev/null +++ b/solution/transaction-service/.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/ diff --git a/solution/transaction-service/.mvn/wrapper/maven-wrapper.properties b/solution/transaction-service/.mvn/wrapper/maven-wrapper.properties new file mode 100644 index 0000000000..8dea6c227c --- /dev/null +++ b/solution/transaction-service/.mvn/wrapper/maven-wrapper.properties @@ -0,0 +1,3 @@ +wrapperVersion=3.3.4 +distributionType=only-script +distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.12/apache-maven-3.9.12-bin.zip diff --git a/solution/transaction-service/Dockerfile b/solution/transaction-service/Dockerfile new file mode 100644 index 0000000000..de058f3016 --- /dev/null +++ b/solution/transaction-service/Dockerfile @@ -0,0 +1,19 @@ +# ---------- BUILD STAGE ---------- +FROM maven:3.9.9-eclipse-temurin-17 AS build +WORKDIR /workspace + +COPY pom.xml . +COPY src ./src + +RUN mvn -q -DskipTests clean package + +# ---------- RUN STAGE ---------- +FROM eclipse-temurin:17-jdk-alpine + +WORKDIR /app + +COPY --from=build /workspace/target/*.jar app.jar + +EXPOSE 8080 + +ENTRYPOINT ["java","-jar","app.jar"] \ No newline at end of file diff --git a/solution/transaction-service/mvnw b/solution/transaction-service/mvnw new file mode 100644 index 0000000000..bd8896bf22 --- /dev/null +++ b/solution/transaction-service/mvnw @@ -0,0 +1,295 @@ +#!/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.4 +# +# Optional ENV vars +# ----------------- +# JAVA_HOME - location of a JDK home dir, required when download maven via java source +# MVNW_REPOURL - repo url base for downloading maven distribution +# MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven +# MVNW_VERBOSE - true: enable verbose log; debug: trace the mvnw script; others: silence the output +# ---------------------------------------------------------------------------- + +set -euf +[ "${MVNW_VERBOSE-}" != debug ] || set -x + +# OS specific support. +native_path() { printf %s\\n "$1"; } +case "$(uname)" in +CYGWIN* | MINGW*) + [ -z "${JAVA_HOME-}" ] || JAVA_HOME="$(cygpath --unix "$JAVA_HOME")" + native_path() { cygpath --path --windows "$1"; } + ;; +esac + +# set JAVACMD and JAVACCMD +set_java_home() { + # For Cygwin and MinGW, ensure paths are in Unix format before anything is touched + 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" + JAVACCMD="$JAVA_HOME/jre/sh/javac" + else + JAVACMD="$JAVA_HOME/bin/java" + JAVACCMD="$JAVA_HOME/bin/javac" + + if [ ! -x "$JAVACMD" ] || [ ! -x "$JAVACCMD" ]; then + echo "The JAVA_HOME environment variable is not defined correctly, so mvnw cannot run." >&2 + echo "JAVA_HOME is set to \"$JAVA_HOME\", but \"\$JAVA_HOME/bin/java\" or \"\$JAVA_HOME/bin/javac\" does not exist." >&2 + return 1 + fi + fi + else + JAVACMD="$( + 'set' +e + 'unset' -f command 2>/dev/null + 'command' -v java + )" || : + JAVACCMD="$( + 'set' +e + 'unset' -f command 2>/dev/null + 'command' -v javac + )" || : + + if [ ! -x "${JAVACMD-}" ] || [ ! -x "${JAVACCMD-}" ]; then + echo "The java/javac command does not exist in PATH nor is JAVA_HOME set, so mvnw cannot run." >&2 + return 1 + fi + fi +} + +# hash string like Java String::hashCode +hash_string() { + str="${1:-}" h=0 + while [ -n "$str" ]; do + char="${str%"${str#?}"}" + h=$(((h * 31 + $(LC_CTYPE=C printf %d "'$char")) % 4294967296)) + str="${str#?}" + done + printf %x\\n $h +} + +verbose() { :; } +[ "${MVNW_VERBOSE-}" != true ] || verbose() { printf %s\\n "${1-}"; } + +die() { + printf %s\\n "$1" >&2 + exit 1 +} + +trim() { + # MWRAPPER-139: + # Trims trailing and leading whitespace, carriage returns, tabs, and linefeeds. + # Needed for removing poorly interpreted newline sequences when running in more + # exotic environments such as mingw bash on Windows. + printf "%s" "${1}" | tr -d '[:space:]' +} + +scriptDir="$(dirname "$0")" +scriptName="$(basename "$0")" + +# parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties +while IFS="=" read -r key value; do + case "${key-}" in + distributionUrl) distributionUrl=$(trim "${value-}") ;; + distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;; + esac +done <"$scriptDir/.mvn/wrapper/maven-wrapper.properties" +[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties" + +case "${distributionUrl##*/}" in +maven-mvnd-*bin.*) + MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ + case "${PROCESSOR_ARCHITECTURE-}${PROCESSOR_ARCHITEW6432-}:$(uname -a)" in + *AMD64:CYGWIN* | *AMD64:MINGW*) distributionPlatform=windows-amd64 ;; + :Darwin*x86_64) distributionPlatform=darwin-amd64 ;; + :Darwin*arm64) distributionPlatform=darwin-aarch64 ;; + :Linux*x86_64*) distributionPlatform=linux-amd64 ;; + *) + echo "Cannot detect native platform for mvnd on $(uname)-$(uname -m), use pure java version" >&2 + distributionPlatform=linux-amd64 + ;; + esac + distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip" + ;; +maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;; +*) MVN_CMD="mvn${scriptName#mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;; +esac + +# apply MVNW_REPOURL and calculate MAVEN_HOME +# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ +[ -z "${MVNW_REPOURL-}" ] || distributionUrl="$MVNW_REPOURL$_MVNW_REPO_PATTERN${distributionUrl#*"$_MVNW_REPO_PATTERN"}" +distributionUrlName="${distributionUrl##*/}" +distributionUrlNameMain="${distributionUrlName%.*}" +distributionUrlNameMain="${distributionUrlNameMain%-bin}" +MAVEN_USER_HOME="${MAVEN_USER_HOME:-${HOME}/.m2}" +MAVEN_HOME="${MAVEN_USER_HOME}/wrapper/dists/${distributionUrlNameMain-}/$(hash_string "$distributionUrl")" + +exec_maven() { + unset MVNW_VERBOSE MVNW_USERNAME MVNW_PASSWORD MVNW_REPOURL || : + exec "$MAVEN_HOME/bin/$MVN_CMD" "$@" || die "cannot exec $MAVEN_HOME/bin/$MVN_CMD" +} + +if [ -d "$MAVEN_HOME" ]; then + verbose "found existing MAVEN_HOME at $MAVEN_HOME" + exec_maven "$@" +fi + +case "${distributionUrl-}" in +*?-bin.zip | *?maven-mvnd-?*-?*.zip) ;; +*) die "distributionUrl is not valid, must match *-bin.zip or maven-mvnd-*.zip, but found '${distributionUrl-}'" ;; +esac + +# prepare tmp dir +if TMP_DOWNLOAD_DIR="$(mktemp -d)" && [ -d "$TMP_DOWNLOAD_DIR" ]; then + clean() { rm -rf -- "$TMP_DOWNLOAD_DIR"; } + trap clean HUP INT TERM EXIT +else + die "cannot create temp dir" +fi + +mkdir -p -- "${MAVEN_HOME%/*}" + +# Download and Install Apache Maven +verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." +verbose "Downloading from: $distributionUrl" +verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" + +# select .zip or .tar.gz +if ! command -v unzip >/dev/null; then + distributionUrl="${distributionUrl%.zip}.tar.gz" + distributionUrlName="${distributionUrl##*/}" +fi + +# verbose opt +__MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR='' +[ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v + +# normalize http auth +case "${MVNW_PASSWORD:+has-password}" in +'') MVNW_USERNAME='' MVNW_PASSWORD='' ;; +has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;; +esac + +if [ -z "${MVNW_USERNAME-}" ] && command -v wget >/dev/null; then + verbose "Found wget ... using wget" + wget ${__MVNW_QUIET_WGET:+"$__MVNW_QUIET_WGET"} "$distributionUrl" -O "$TMP_DOWNLOAD_DIR/$distributionUrlName" || die "wget: Failed to fetch $distributionUrl" +elif [ -z "${MVNW_USERNAME-}" ] && command -v curl >/dev/null; then + verbose "Found curl ... using curl" + curl ${__MVNW_QUIET_CURL:+"$__MVNW_QUIET_CURL"} -f -L -o "$TMP_DOWNLOAD_DIR/$distributionUrlName" "$distributionUrl" || die "curl: Failed to fetch $distributionUrl" +elif set_java_home; then + verbose "Falling back to use Java to download" + javaSource="$TMP_DOWNLOAD_DIR/Downloader.java" + targetZip="$TMP_DOWNLOAD_DIR/$distributionUrlName" + cat >"$javaSource" <<-END + public class Downloader extends java.net.Authenticator + { + protected java.net.PasswordAuthentication getPasswordAuthentication() + { + return new java.net.PasswordAuthentication( System.getenv( "MVNW_USERNAME" ), System.getenv( "MVNW_PASSWORD" ).toCharArray() ); + } + public static void main( String[] args ) throws Exception + { + setDefault( new Downloader() ); + java.nio.file.Files.copy( java.net.URI.create( args[0] ).toURL().openStream(), java.nio.file.Paths.get( args[1] ).toAbsolutePath().normalize() ); + } + } + END + # For Cygwin/MinGW, switch paths to Windows format before running javac and java + verbose " - Compiling Downloader.java ..." + "$(native_path "$JAVACCMD")" "$(native_path "$javaSource")" || die "Failed to compile Downloader.java" + verbose " - Running Downloader.java ..." + "$(native_path "$JAVACMD")" -cp "$(native_path "$TMP_DOWNLOAD_DIR")" Downloader "$distributionUrl" "$(native_path "$targetZip")" +fi + +# If specified, validate the SHA-256 sum of the Maven distribution zip file +if [ -n "${distributionSha256Sum-}" ]; then + distributionSha256Result=false + if [ "$MVN_CMD" = mvnd.sh ]; then + echo "Checksum validation is not supported for maven-mvnd." >&2 + echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2 + exit 1 + elif command -v sha256sum >/dev/null; then + if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c - >/dev/null 2>&1; then + distributionSha256Result=true + fi + elif command -v shasum >/dev/null; then + if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | shasum -a 256 -c >/dev/null 2>&1; then + distributionSha256Result=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 'distributionSha256Sum' from your maven-wrapper.properties." >&2 + exit 1 + fi + if [ $distributionSha256Result = false ]; then + echo "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised." >&2 + echo "If you updated your Maven version, you need to update the specified distributionSha256Sum property." >&2 + exit 1 + fi +fi + +# unzip and move +if command -v unzip >/dev/null; then + unzip ${__MVNW_QUIET_UNZIP:+"$__MVNW_QUIET_UNZIP"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -d "$TMP_DOWNLOAD_DIR" || die "failed to unzip" +else + tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar" +fi + +# Find the actual extracted directory name (handles snapshots where filename != directory name) +actualDistributionDir="" + +# First try the expected directory name (for regular distributions) +if [ -d "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" ]; then + if [ -f "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/bin/$MVN_CMD" ]; then + actualDistributionDir="$distributionUrlNameMain" + fi +fi + +# If not found, search for any directory with the Maven executable (for snapshots) +if [ -z "$actualDistributionDir" ]; then + # enable globbing to iterate over items + set +f + for dir in "$TMP_DOWNLOAD_DIR"/*; do + if [ -d "$dir" ]; then + if [ -f "$dir/bin/$MVN_CMD" ]; then + actualDistributionDir="$(basename "$dir")" + break + fi + fi + done + set -f +fi + +if [ -z "$actualDistributionDir" ]; then + verbose "Contents of $TMP_DOWNLOAD_DIR:" + verbose "$(ls -la "$TMP_DOWNLOAD_DIR")" + die "Could not find Maven distribution directory in extracted archive" +fi + +verbose "Found extracted Maven distribution directory: $actualDistributionDir" +printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$actualDistributionDir/mvnw.url" +mv -- "$TMP_DOWNLOAD_DIR/$actualDistributionDir" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME" + +clean || : +exec_maven "$@" diff --git a/solution/transaction-service/mvnw.cmd b/solution/transaction-service/mvnw.cmd new file mode 100644 index 0000000000..92450f9327 --- /dev/null +++ b/solution/transaction-service/mvnw.cmd @@ -0,0 +1,189 @@ +<# : batch portion +@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.4 +@REM +@REM Optional ENV vars +@REM MVNW_REPOURL - repo url base for downloading maven distribution +@REM MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven +@REM MVNW_VERBOSE - true: enable verbose log; others: silence the output +@REM ---------------------------------------------------------------------------- + +@IF "%__MVNW_ARG0_NAME__%"=="" (SET __MVNW_ARG0_NAME__=%~nx0) +@SET __MVNW_CMD__= +@SET __MVNW_ERROR__= +@SET __MVNW_PSMODULEP_SAVE=%PSModulePath% +@SET PSModulePath= +@FOR /F "usebackq tokens=1* delims==" %%A IN (`powershell -noprofile "& {$scriptDir='%~dp0'; $script='%__MVNW_ARG0_NAME__%'; icm -ScriptBlock ([Scriptblock]::Create((Get-Content -Raw '%~f0'))) -NoNewScope}"`) DO @( + IF "%%A"=="MVN_CMD" (set __MVNW_CMD__=%%B) ELSE IF "%%B"=="" (echo %%A) ELSE (echo %%A=%%B) +) +@SET PSModulePath=%__MVNW_PSMODULEP_SAVE% +@SET __MVNW_PSMODULEP_SAVE= +@SET __MVNW_ARG0_NAME__= +@SET MVNW_USERNAME= +@SET MVNW_PASSWORD= +@IF NOT "%__MVNW_CMD__%"=="" ("%__MVNW_CMD__%" %*) +@echo Cannot start maven from wrapper >&2 && exit /b 1 +@GOTO :EOF +: end batch / begin powershell #> + +$ErrorActionPreference = "Stop" +if ($env:MVNW_VERBOSE -eq "true") { + $VerbosePreference = "Continue" +} + +# calculate distributionUrl, requires .mvn/wrapper/maven-wrapper.properties +$distributionUrl = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionUrl +if (!$distributionUrl) { + Write-Error "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties" +} + +switch -wildcard -casesensitive ( $($distributionUrl -replace '^.*/','') ) { + "maven-mvnd-*" { + $USE_MVND = $true + $distributionUrl = $distributionUrl -replace '-bin\.[^.]*$',"-windows-amd64.zip" + $MVN_CMD = "mvnd.cmd" + break + } + default { + $USE_MVND = $false + $MVN_CMD = $script -replace '^mvnw','mvn' + break + } +} + +# apply MVNW_REPOURL and calculate MAVEN_HOME +# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-,maven-mvnd--}/ +if ($env:MVNW_REPOURL) { + $MVNW_REPO_PATTERN = if ($USE_MVND -eq $False) { "/org/apache/maven/" } else { "/maven/mvnd/" } + $distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace "^.*$MVNW_REPO_PATTERN",'')" +} +$distributionUrlName = $distributionUrl -replace '^.*/','' +$distributionUrlNameMain = $distributionUrlName -replace '\.[^.]*$','' -replace '-bin$','' + +$MAVEN_M2_PATH = "$HOME/.m2" +if ($env:MAVEN_USER_HOME) { + $MAVEN_M2_PATH = "$env:MAVEN_USER_HOME" +} + +if (-not (Test-Path -Path $MAVEN_M2_PATH)) { + New-Item -Path $MAVEN_M2_PATH -ItemType Directory | Out-Null +} + +$MAVEN_WRAPPER_DISTS = $null +if ((Get-Item $MAVEN_M2_PATH).Target[0] -eq $null) { + $MAVEN_WRAPPER_DISTS = "$MAVEN_M2_PATH/wrapper/dists" +} else { + $MAVEN_WRAPPER_DISTS = (Get-Item $MAVEN_M2_PATH).Target[0] + "/wrapper/dists" +} + +$MAVEN_HOME_PARENT = "$MAVEN_WRAPPER_DISTS/$distributionUrlNameMain" +$MAVEN_HOME_NAME = ([System.Security.Cryptography.SHA256]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join '' +$MAVEN_HOME = "$MAVEN_HOME_PARENT/$MAVEN_HOME_NAME" + +if (Test-Path -Path "$MAVEN_HOME" -PathType Container) { + Write-Verbose "found existing MAVEN_HOME at $MAVEN_HOME" + Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" + exit $? +} + +if (! $distributionUrlNameMain -or ($distributionUrlName -eq $distributionUrlNameMain)) { + Write-Error "distributionUrl is not valid, must end with *-bin.zip, but found $distributionUrl" +} + +# prepare tmp dir +$TMP_DOWNLOAD_DIR_HOLDER = New-TemporaryFile +$TMP_DOWNLOAD_DIR = New-Item -Itemtype Directory -Path "$TMP_DOWNLOAD_DIR_HOLDER.dir" +$TMP_DOWNLOAD_DIR_HOLDER.Delete() | Out-Null +trap { + if ($TMP_DOWNLOAD_DIR.Exists) { + try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } + catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } + } +} + +New-Item -Itemtype Directory -Path "$MAVEN_HOME_PARENT" -Force | Out-Null + +# Download and Install Apache Maven +Write-Verbose "Couldn't find MAVEN_HOME, downloading and installing it ..." +Write-Verbose "Downloading from: $distributionUrl" +Write-Verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName" + +$webclient = New-Object System.Net.WebClient +if ($env:MVNW_USERNAME -and $env:MVNW_PASSWORD) { + $webclient.Credentials = New-Object System.Net.NetworkCredential($env:MVNW_USERNAME, $env:MVNW_PASSWORD) +} +[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 +$webclient.DownloadFile($distributionUrl, "$TMP_DOWNLOAD_DIR/$distributionUrlName") | Out-Null + +# If specified, validate the SHA-256 sum of the Maven distribution zip file +$distributionSha256Sum = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionSha256Sum +if ($distributionSha256Sum) { + if ($USE_MVND) { + Write-Error "Checksum validation is not supported for maven-mvnd. `nPlease disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." + } + Import-Module $PSHOME\Modules\Microsoft.PowerShell.Utility -Function Get-FileHash + if ((Get-FileHash "$TMP_DOWNLOAD_DIR/$distributionUrlName" -Algorithm SHA256).Hash.ToLower() -ne $distributionSha256Sum) { + Write-Error "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised. If you updated your Maven version, you need to update the specified distributionSha256Sum property." + } +} + +# unzip and move +Expand-Archive "$TMP_DOWNLOAD_DIR/$distributionUrlName" -DestinationPath "$TMP_DOWNLOAD_DIR" | Out-Null + +# Find the actual extracted directory name (handles snapshots where filename != directory name) +$actualDistributionDir = "" + +# First try the expected directory name (for regular distributions) +$expectedPath = Join-Path "$TMP_DOWNLOAD_DIR" "$distributionUrlNameMain" +$expectedMvnPath = Join-Path "$expectedPath" "bin/$MVN_CMD" +if ((Test-Path -Path $expectedPath -PathType Container) -and (Test-Path -Path $expectedMvnPath -PathType Leaf)) { + $actualDistributionDir = $distributionUrlNameMain +} + +# If not found, search for any directory with the Maven executable (for snapshots) +if (!$actualDistributionDir) { + Get-ChildItem -Path "$TMP_DOWNLOAD_DIR" -Directory | ForEach-Object { + $testPath = Join-Path $_.FullName "bin/$MVN_CMD" + if (Test-Path -Path $testPath -PathType Leaf) { + $actualDistributionDir = $_.Name + } + } +} + +if (!$actualDistributionDir) { + Write-Error "Could not find Maven distribution directory in extracted archive" +} + +Write-Verbose "Found extracted Maven distribution directory: $actualDistributionDir" +Rename-Item -Path "$TMP_DOWNLOAD_DIR/$actualDistributionDir" -NewName $MAVEN_HOME_NAME | Out-Null +try { + Move-Item -Path "$TMP_DOWNLOAD_DIR/$MAVEN_HOME_NAME" -Destination $MAVEN_HOME_PARENT | Out-Null +} catch { + if (! (Test-Path -Path "$MAVEN_HOME" -PathType Container)) { + Write-Error "fail to move MAVEN_HOME" + } +} finally { + try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null } + catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" } +} + +Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD" diff --git a/solution/transaction-service/pom.xml b/solution/transaction-service/pom.xml new file mode 100644 index 0000000000..20f1de77a9 --- /dev/null +++ b/solution/transaction-service/pom.xml @@ -0,0 +1,110 @@ + + + 4.0.0 + + org.springframework.boot + spring-boot-starter-parent + 3.5.3 + + + com.codeh + transaction-service + 01.00.00 + transaction-service + Demo project for Spring Boot + + + 17 + + + + org.springframework.boot + spring-boot-starter-data-jpa + + + org.springframework.boot + spring-boot-starter-validation + + + org.springframework.boot + spring-boot-starter-web + + + org.springframework.kafka + spring-kafka + + + + org.postgresql + postgresql + runtime + + + org.projectlombok + lombok + provided + + + org.springframework.boot + spring-boot-starter-test + test + + + org.springframework.kafka + spring-kafka-test + test + + + + + + + org.apache.maven.plugins + maven-compiler-plugin + + + + org.projectlombok + lombok + ${lombok.version} + + + + + + org.springframework.boot + spring-boot-maven-plugin + + + + org.projectlombok + lombok + + + + + + + + + spring-snapshots + Spring Snapshots + https://repo.spring.io/snapshot + + false + + + + + + spring-snapshots + Spring Snapshots + https://repo.spring.io/snapshot + + false + + + + + diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/TransactionServiceApplication.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/TransactionServiceApplication.java new file mode 100644 index 0000000000..9a17a90e6a --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/TransactionServiceApplication.java @@ -0,0 +1,13 @@ +package com.codeh.transaction_service; + +import org.springframework.boot.SpringApplication; +import org.springframework.boot.autoconfigure.SpringBootApplication; + +@SpringBootApplication +public class TransactionServiceApplication { + + public static void main(String[] args) { + SpringApplication.run(TransactionServiceApplication.class, args); + } + +} diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/config/KafkaErrorConfig.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/config/KafkaErrorConfig.java new file mode 100644 index 0000000000..2b0f57f416 --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/config/KafkaErrorConfig.java @@ -0,0 +1,23 @@ +package com.codeh.transaction_service.config; + +import org.apache.kafka.common.TopicPartition; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.kafka.core.KafkaTemplate; +import org.springframework.kafka.listener.DeadLetterPublishingRecoverer; +import org.springframework.kafka.listener.DefaultErrorHandler; +import org.springframework.util.backoff.FixedBackOff; + +@Configuration +public class KafkaErrorConfig { + + @Bean + public DefaultErrorHandler kafkaErrorHandler(KafkaTemplate template) { + + DeadLetterPublishingRecoverer recoverer = + new DeadLetterPublishingRecoverer(template, + (record, ex) -> new TopicPartition(record.topic() + ".DLT", record.partition())); + + return new DefaultErrorHandler(recoverer, new FixedBackOff(0L, 0)); + } +} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/controller/TransactionController.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/controller/TransactionController.java new file mode 100644 index 0000000000..0f98b20f1b --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/controller/TransactionController.java @@ -0,0 +1,31 @@ +package com.codeh.transaction_service.controller; + +import com.codeh.transaction_service.dto.request.CreateTransactionRequest; +import com.codeh.transaction_service.dto.response.TransactionResponse; +import com.codeh.transaction_service.service.TransactionService; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +import org.springframework.http.HttpStatus; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.*; +import java.util.UUID; + +@RestController +@RequestMapping("/transactions") +@RequiredArgsConstructor +public class TransactionController { + + private final TransactionService transactionService; + + @PostMapping + public ResponseEntity createTransaction(@Valid @RequestBody CreateTransactionRequest request) { + return ResponseEntity + .status(HttpStatus.CREATED) + .body(transactionService.createTransaction(request)); + } + + @GetMapping("/{externalId}") + public ResponseEntity getTransaction(@PathVariable UUID externalId) { + return ResponseEntity.ok(transactionService.getByExternalId(externalId)); + } +} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/dto/request/CreateTransactionRequest.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/dto/request/CreateTransactionRequest.java new file mode 100644 index 0000000000..ed9d1467bc --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/dto/request/CreateTransactionRequest.java @@ -0,0 +1,30 @@ +package com.codeh.transaction_service.dto.request; + +import jakarta.validation.constraints.NotNull; +import jakarta.validation.constraints.Positive; +import lombok.AllArgsConstructor; +import lombok.Getter; +import lombok.NoArgsConstructor; +import lombok.Setter; +import java.math.BigDecimal; +import java.util.UUID; + +@Getter +@Setter +@NoArgsConstructor +@AllArgsConstructor +public class CreateTransactionRequest { + + @NotNull + private UUID accountExternalIdDebit; + + @NotNull + private UUID accountExternalIdCredit; + + @NotNull + private Long transferTypeId; + + @NotNull + @Positive + private BigDecimal value; +} diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/dto/response/ApiError.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/dto/response/ApiError.java new file mode 100644 index 0000000000..41c03dcd00 --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/dto/response/ApiError.java @@ -0,0 +1,11 @@ +package com.codeh.transaction_service.dto.response; + +import java.time.LocalDateTime; + +public record ApiError( + LocalDateTime timestamp, + int status, + String error, + String message, + String path +) {} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/dto/response/TransactionResponse.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/dto/response/TransactionResponse.java new file mode 100644 index 0000000000..e7f6d0800f --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/dto/response/TransactionResponse.java @@ -0,0 +1,30 @@ +package com.codeh.transaction_service.dto.response; + +import lombok.Builder; +import lombok.Data; +import java.math.BigDecimal; +import java.time.LocalDateTime; +import java.util.UUID; + +@Data +@Builder +public class TransactionResponse { + + private UUID transactionExternalId; + private TransactionTypeResponse transactionType; + private TransactionStatusResponse transactionStatus; + private BigDecimal value; + private LocalDateTime createdAt; + + @Data + @Builder + public static class TransactionTypeResponse { + private String name; + } + + @Data + @Builder + public static class TransactionStatusResponse { + private String name; + } +} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/exception/GlobalExceptionHandler.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/exception/GlobalExceptionHandler.java new file mode 100644 index 0000000000..0eab892f37 --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/exception/GlobalExceptionHandler.java @@ -0,0 +1,58 @@ +package com.codeh.transaction_service.exception; + +import com.codeh.transaction_service.dto.response.ApiError; +import jakarta.persistence.EntityNotFoundException; +import jakarta.servlet.http.HttpServletRequest; +import org.springframework.http.HttpStatus; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.MethodArgumentNotValidException; +import org.springframework.web.bind.annotation.ExceptionHandler; +import org.springframework.web.bind.annotation.RestControllerAdvice; + +import java.time.LocalDateTime; + +@RestControllerAdvice +public class GlobalExceptionHandler { + + @ExceptionHandler(MethodArgumentNotValidException.class) + public ResponseEntity handleValidation(MethodArgumentNotValidException ex, HttpServletRequest request) { + + String message = ex.getBindingResult() + .getFieldErrors() + .stream() + .map(err -> err.getField() + " " + err.getDefaultMessage()) + .findFirst() + .orElse("Invalid request"); + + return build(HttpStatus.BAD_REQUEST, message, request); + } + + @ExceptionHandler(IllegalArgumentException.class) + public ResponseEntity handleBusiness(IllegalArgumentException ex, + HttpServletRequest request) { + return build(HttpStatus.BAD_REQUEST, ex.getMessage(), request); + } + + @ExceptionHandler(EntityNotFoundException.class) + public ResponseEntity handleNotFound(EntityNotFoundException ex, + HttpServletRequest request) { + return build(HttpStatus.NOT_FOUND, ex.getMessage(), request); + } + + @ExceptionHandler(Exception.class) + public ResponseEntity handleGeneric(Exception ex, + HttpServletRequest request) { + return build(HttpStatus.INTERNAL_SERVER_ERROR, "Unexpected error", request); + } + + private ResponseEntity build(HttpStatus status, String message, HttpServletRequest request) { + ApiError error = new ApiError( + LocalDateTime.now(), + status.value(), + status.getReasonPhrase(), + message, + request.getRequestURI() + ); + return ResponseEntity.status(status).body(error); + } +} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/mapper/TransactionMapper.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/mapper/TransactionMapper.java new file mode 100644 index 0000000000..ecb330ed69 --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/mapper/TransactionMapper.java @@ -0,0 +1,27 @@ +package com.codeh.transaction_service.mapper; + +import com.codeh.transaction_service.dto.response.TransactionResponse; +import com.codeh.transaction_service.model.Transaction; +import org.springframework.stereotype.Component; + +@Component +public class TransactionMapper { + + public TransactionResponse mapToResponse(Transaction transaction) { + return TransactionResponse.builder() + .transactionExternalId(transaction.getTransactionExternalId()) + .transactionType( + TransactionResponse.TransactionTypeResponse.builder() + .name(transaction.getTransactionType().getName()) + .build() + ) + .transactionStatus( + TransactionResponse.TransactionStatusResponse.builder() + .name(transaction.getStatus().getName()) + .build() + ) + .value(transaction.getValue()) + .createdAt(transaction.getCreatedAt()) + .build(); + } +} diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/event/TransactionCreatedEvent.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/event/TransactionCreatedEvent.java new file mode 100644 index 0000000000..9c69eee43b --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/event/TransactionCreatedEvent.java @@ -0,0 +1,7 @@ +package com.codeh.transaction_service.messaging.event; + +import java.math.BigDecimal; +import java.util.UUID; + +public record TransactionCreatedEvent(UUID transactionExternalId, BigDecimal value) { +} diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/event/TransactionValidatedEvent.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/event/TransactionValidatedEvent.java new file mode 100644 index 0000000000..97443d8e60 --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/event/TransactionValidatedEvent.java @@ -0,0 +1,5 @@ +package com.codeh.transaction_service.messaging.event; + +import java.util.UUID; + +public record TransactionValidatedEvent(UUID transactionExternalId, String status) {} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/listener/TransactionValidatedListener.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/listener/TransactionValidatedListener.java new file mode 100644 index 0000000000..dddefe9fe4 --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/listener/TransactionValidatedListener.java @@ -0,0 +1,38 @@ +package com.codeh.transaction_service.messaging.listener; + +import com.codeh.transaction_service.messaging.event.TransactionValidatedEvent; +import com.codeh.transaction_service.model.Transaction; +import com.codeh.transaction_service.model.TransactionStatus; +import com.codeh.transaction_service.repository.TransactionRepository; +import com.codeh.transaction_service.repository.TransactionStatusRepository; +import lombok.RequiredArgsConstructor; +import org.springframework.kafka.annotation.KafkaListener; +import org.springframework.stereotype.Component; +import org.springframework.transaction.annotation.Transactional; + +@Component +@RequiredArgsConstructor +public class TransactionValidatedListener { + + private final TransactionRepository transactionRepository; + private final TransactionStatusRepository statusRepository; + + @Transactional + @KafkaListener(topics = "${kafka.topics.transaction-validated}", groupId = "${spring.kafka.consumer.group-id}") + public void onValidated(TransactionValidatedEvent event) { + + Transaction tx = transactionRepository.findByTransactionExternalId(event.transactionExternalId()) + .orElseThrow(() -> new RuntimeException("Transaction not found: " + event.transactionExternalId())); + + if (tx.getStatus().getName().equals(event.status())) { + return; + } + + TransactionStatus newStatus = statusRepository.findByName(event.status()) + .orElseThrow(() -> new RuntimeException("Status not found: " + event.status())); + + + tx.setStatus(newStatus); + transactionRepository.save(tx); + } +} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/publisher/TransactionEventPublisher.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/publisher/TransactionEventPublisher.java new file mode 100644 index 0000000000..009cc00f0c --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/messaging/publisher/TransactionEventPublisher.java @@ -0,0 +1,21 @@ +package com.codeh.transaction_service.messaging.publisher; + +import com.codeh.transaction_service.messaging.event.TransactionCreatedEvent; +import lombok.RequiredArgsConstructor; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.kafka.core.KafkaTemplate; +import org.springframework.stereotype.Component; + +@Component +@RequiredArgsConstructor +public class TransactionEventPublisher { + + @Value("${kafka.topics.transaction-created}") + private String createdTopic; + + private final KafkaTemplate kafkaTemplate; + + public void publishTransactionCreated(TransactionCreatedEvent event) { + kafkaTemplate.send(createdTopic, event.transactionExternalId().toString(), event); + } +} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/model/Transaction.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/model/Transaction.java new file mode 100644 index 0000000000..78c5b7d41f --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/model/Transaction.java @@ -0,0 +1,49 @@ +package com.codeh.transaction_service.model; + +import jakarta.persistence.*; +import lombok.AllArgsConstructor; +import lombok.Getter; +import lombok.NoArgsConstructor; +import lombok.Setter; +import java.math.BigDecimal; +import java.time.LocalDateTime; +import java.util.UUID; + +@Entity +@Table(name = "transactions") +@Getter +@Setter +@NoArgsConstructor +@AllArgsConstructor +public class Transaction { + + @Id + @GeneratedValue(strategy = GenerationType.UUID) + private UUID id; + + @Column(nullable = false, unique = true) + private UUID transactionExternalId; + + @Column(nullable = false) + private UUID accountExternalIdDebit; + + @Column(nullable = false) + private UUID accountExternalIdCredit; + + @ManyToOne + @JoinColumn(name = "transaction_type_id", nullable = false) + private TransactionType transactionType; + + @ManyToOne + @JoinColumn(name = "status_id", nullable = false) + private TransactionStatus status; + + @Column(nullable = false) + private BigDecimal value; + + @Column(nullable = false) + private LocalDateTime createdAt; + + @Version + private Long version; +} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/model/TransactionStatus.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/model/TransactionStatus.java new file mode 100644 index 0000000000..d47810b588 --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/model/TransactionStatus.java @@ -0,0 +1,25 @@ +package com.codeh.transaction_service.model; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import lombok.AllArgsConstructor; +import lombok.Getter; +import lombok.NoArgsConstructor; +import lombok.Setter; + +@Entity +@Table(name = "transaction_status") +@Getter +@Setter +@NoArgsConstructor +@AllArgsConstructor +public class TransactionStatus { + + @Id + private Long id; + + @Column(nullable = false, unique = true) + private String name; +} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/model/TransactionType.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/model/TransactionType.java new file mode 100644 index 0000000000..b9ad8252d6 --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/model/TransactionType.java @@ -0,0 +1,25 @@ +package com.codeh.transaction_service.model; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import lombok.AllArgsConstructor; +import lombok.Getter; +import lombok.NoArgsConstructor; +import lombok.Setter; + +@Entity +@Table(name = "transaction_type") +@Getter +@Setter +@NoArgsConstructor +@AllArgsConstructor +public class TransactionType { + + @Id + private Long id; + + @Column(nullable = false, unique = true) + private String name; +} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/repository/TransactionRepository.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/repository/TransactionRepository.java new file mode 100644 index 0000000000..bdb47c7337 --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/repository/TransactionRepository.java @@ -0,0 +1,14 @@ +package com.codeh.transaction_service.repository; + +import com.codeh.transaction_service.model.Transaction; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; +import java.util.Optional; +import java.util.UUID; + +@Repository +public interface TransactionRepository extends JpaRepository { + + Optional findByTransactionExternalId(UUID transactionExternalId); + +} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/repository/TransactionStatusRepository.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/repository/TransactionStatusRepository.java new file mode 100644 index 0000000000..264a165b4f --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/repository/TransactionStatusRepository.java @@ -0,0 +1,13 @@ +package com.codeh.transaction_service.repository; + +import com.codeh.transaction_service.model.TransactionStatus; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; +import java.util.Optional; + +@Repository +public interface TransactionStatusRepository extends JpaRepository { + + Optional findByName(String name); + +} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/repository/TransactionTypeRepository.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/repository/TransactionTypeRepository.java new file mode 100644 index 0000000000..d9c1dc9a4a --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/repository/TransactionTypeRepository.java @@ -0,0 +1,9 @@ +package com.codeh.transaction_service.repository; + +import com.codeh.transaction_service.model.TransactionType; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +@Repository +public interface TransactionTypeRepository extends JpaRepository { +} \ No newline at end of file diff --git a/solution/transaction-service/src/main/java/com/codeh/transaction_service/service/TransactionService.java b/solution/transaction-service/src/main/java/com/codeh/transaction_service/service/TransactionService.java new file mode 100644 index 0000000000..3a20b508a8 --- /dev/null +++ b/solution/transaction-service/src/main/java/com/codeh/transaction_service/service/TransactionService.java @@ -0,0 +1,62 @@ +package com.codeh.transaction_service.service; + +import com.codeh.transaction_service.dto.request.CreateTransactionRequest; +import com.codeh.transaction_service.dto.response.TransactionResponse; +import com.codeh.transaction_service.mapper.TransactionMapper; +import com.codeh.transaction_service.model.Transaction; +import com.codeh.transaction_service.model.TransactionStatus; +import com.codeh.transaction_service.model.TransactionType; +import com.codeh.transaction_service.messaging.publisher.TransactionEventPublisher; +import com.codeh.transaction_service.messaging.event.TransactionCreatedEvent; +import com.codeh.transaction_service.repository.TransactionRepository; +import com.codeh.transaction_service.repository.TransactionStatusRepository; +import com.codeh.transaction_service.repository.TransactionTypeRepository; +import jakarta.persistence.EntityNotFoundException; +import jakarta.transaction.Transactional; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import java.time.LocalDateTime; +import java.util.UUID; + + +@Service +@RequiredArgsConstructor +public class TransactionService { + + private final TransactionRepository transactionRepository; + private final TransactionStatusRepository statusRepository; + private final TransactionTypeRepository typeRepository; + private final TransactionMapper transactionMapper; + private final TransactionEventPublisher transactionEventPublisher; + + + @Transactional + public TransactionResponse createTransaction(CreateTransactionRequest request) { + + TransactionType type = typeRepository.findById(request.getTransferTypeId()) + .orElseThrow(() -> new EntityNotFoundException("Transaction type not found")); + + TransactionStatus pendingStatus = statusRepository.findByName("PENDING") + .orElseThrow(() -> new EntityNotFoundException("Status not found")); + + Transaction transaction = new Transaction(); + transaction.setTransactionExternalId(UUID.randomUUID()); + transaction.setAccountExternalIdDebit(request.getAccountExternalIdDebit()); + transaction.setAccountExternalIdCredit(request.getAccountExternalIdCredit()); + transaction.setTransactionType(type); + transaction.setStatus(pendingStatus); + transaction.setValue(request.getValue()); + transaction.setCreatedAt(LocalDateTime.now()); + Transaction save = transactionRepository.save(transaction); + transactionEventPublisher.publishTransactionCreated(new TransactionCreatedEvent(save.getTransactionExternalId(),save.getValue())); + return transactionMapper.mapToResponse(save); + } + + @Transactional + public TransactionResponse getByExternalId(UUID externalId) { + return transactionMapper.mapToResponse( + transactionRepository.findByTransactionExternalId(externalId) + .orElseThrow(() -> new EntityNotFoundException("Transaction not found")) + ); + } +} diff --git a/solution/transaction-service/src/main/resources/application.yaml b/solution/transaction-service/src/main/resources/application.yaml new file mode 100644 index 0000000000..5d5cb97fdf --- /dev/null +++ b/solution/transaction-service/src/main/resources/application.yaml @@ -0,0 +1,53 @@ +server: + port: 8080 + +kafka: + topics: + transaction-created: transaction-created + transaction-validated: transaction-validated + +spring: + application: + name: transaction-service + + datasource: + url: jdbc:postgresql://postgres:5432/transaction_db + username: postgres + password: postgres + driver-class-name: org.postgresql.Driver + + jpa: + defer-datasource-initialization: true + hibernate: + ddl-auto: create-drop + show-sql: true + properties: + hibernate: + format_sql: true + database-platform: org.hibernate.dialect.PostgreSQLDialect + + sql: + init: + mode: always + + kafka: + bootstrap-servers: kafka:9092 + producer: + key-serializer: org.apache.kafka.common.serialization.StringSerializer + value-serializer: org.springframework.kafka.support.serializer.JsonSerializer + properties: + spring.json.add.type.headers: false + consumer: + group-id: transaction-group + auto-offset-reset: earliest + key-deserializer: org.springframework.kafka.support.serializer.ErrorHandlingDeserializer + value-deserializer: org.springframework.kafka.support.serializer.ErrorHandlingDeserializer + properties: + spring.deserializer.key.delegate.class: org.apache.kafka.common.serialization.StringDeserializer + spring.deserializer.value.delegate.class: org.springframework.kafka.support.serializer.JsonDeserializer + spring.json.trusted.packages: "*" + spring.json.value.default.type: com.codeh.transaction_service.messaging.event.TransactionValidatedEvent + +logging: + level: + org.hibernate.SQL: DEBUG \ No newline at end of file diff --git a/solution/transaction-service/src/main/resources/data.sql b/solution/transaction-service/src/main/resources/data.sql new file mode 100644 index 0000000000..8ba88b9bcf --- /dev/null +++ b/solution/transaction-service/src/main/resources/data.sql @@ -0,0 +1,5 @@ +INSERT INTO transaction_status (id, name) VALUES (1, 'PENDING'); +INSERT INTO transaction_status (id, name) VALUES (2, 'APPROVED'); +INSERT INTO transaction_status (id, name) VALUES (3, 'REJECTED'); + +INSERT INTO transaction_type (id, name) VALUES (1, 'TRANSFER'); \ No newline at end of file diff --git a/solution/transaction-service/src/test/java/com/codeh/transaction_service/TransactionServiceApplicationTests.java b/solution/transaction-service/src/test/java/com/codeh/transaction_service/TransactionServiceApplicationTests.java new file mode 100644 index 0000000000..cff9668757 --- /dev/null +++ b/solution/transaction-service/src/test/java/com/codeh/transaction_service/TransactionServiceApplicationTests.java @@ -0,0 +1,13 @@ +package com.codeh.transaction_service; + +import org.junit.jupiter.api.Test; +import org.springframework.boot.test.context.SpringBootTest; + +@SpringBootTest +class TransactionServiceApplicationTests { + + @Test + void contextLoads() { + } + +}