testing GHA pipelines

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/custom.md

@@ -0,0 +1,10 @@
+---
+name: Custom issue template
+about: Describe this issue template's purpose here.
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/build-and-publish-develop.yaml

@@ -0,0 +1,66 @@
+name: SNAPSHOT - Build and Publish Maven Artifacts
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - develop
+
+env:
+  NEXUS_USERNAME: 'edward'
+  NEXUS_PASSWORD: ${{ secrets.NEXUS_PASSWORD }}
+  MAVEN_PUBLIC_REPOSITORY_URL: ${{ secrets.MAVEN_PUBLIC_REPOSITORY_URL }}
+  SNAPSHOT_DEPLOYMENT_REPOSITORY_URL: ${{ secrets.SNAPSHOT_DEPLOYMENT_REPOSITORY_URL }}
+  RELEASE_DEPLOYMENT_REPOSITORY_URL: ${{ secrets.RELEASE_DEPLOYMENT_REPOSITORY_URL }}
+
+jobs:
+  build-java:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: write
+      packages: write
+    name: Build Java Package and Publish
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-java@v4.2.2
+        if: ${{ hashFiles('**/pom.xml') }}
+        with:
+          java-version: 17
+          distribution: zulu
+          cache: 'maven'
+      - name: maven-settings-xml-action
+        uses: whelk-io/maven-settings-xml-action@v22
+        with:
+          profiles: >
+            [{
+              "id": "homelab",
+              "properties": {
+                "altSnapshotDeploymentRepository": "nexus-snapshot::${env.SNAPSHOT_DEPLOYMENT_REPOSITORY_URL}",
+                "altReleaseDeploymentRepository": "nexus-release::${env.RELEASE_DEPLOYMENT_REPOSITORY_URL}"
+              }
+            }]
+          repositories: >
+            [{
+              "id": "maven-public",
+              "url": "${env.MAVEN_PUBLIC_REPOSITORY_URL}",
+              "snapshots": {
+                "enabled": "true"
+              }
+            }]
+          servers: >
+            [{
+              "id": "nexus-snapshot",
+              "username": "${env.NEXUS_USERNAME}",
+              "password": "${env.NEXUS_PASSWORD}"
+            },
+            {
+              "id": "nexus-release",
+              "username": "${env.NEXUS_USERNAME}",
+              "password": "${env.NEXUS_PASSWORD}"
+            }]
+      - name: Maven Publish
+        run: |
+          mvn -B deploy -P homelab

.github/workflows/build-and-publish-release.yml

@@ -0,0 +1,80 @@
+name: RELEASE - Build and Publish Maven Artifacts
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+
+env:
+  NEXUS_USERNAME: 'edward'
+  NEXUS_PASSWORD: ${{ secrets.NEXUS_PASSWORD }}
+  MAVEN_PUBLIC_REPOSITORY_URL: ${{ secrets.MAVEN_PUBLIC_REPOSITORY_URL }}
+  SNAPSHOT_DEPLOYMENT_REPOSITORY_URL: ${{ secrets.SNAPSHOT_DEPLOYMENT_REPOSITORY_URL }}
+  RELEASE_DEPLOYMENT_REPOSITORY_URL: ${{ secrets.RELEASE_DEPLOYMENT_REPOSITORY_URL }}
+
+jobs:
+  build-java:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: write
+      packages: write
+    name: Build Java Package and Publish
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-java@v4.2.2
+        if: ${{ hashFiles('**/pom.xml') }}
+        with:
+          java-version: 17
+          distribution: zulu
+          cache: 'maven'
+      - name: maven-settings-xml-action
+        uses: whelk-io/maven-settings-xml-action@v22
+        with:
+          profiles: >
+            [{
+              "id": "homelab",
+              "properties": {
+                "altSnapshotDeploymentRepository": "nexus-snapshot::${env.SNAPSHOT_DEPLOYMENT_REPOSITORY_URL}",
+                "altReleaseDeploymentRepository": "nexus-release::${env.RELEASE_DEPLOYMENT_REPOSITORY_URL}"
+              }
+            }]
+          repositories: >
+            [{
+              "id": "maven-public",
+              "url": "${env.MAVEN_PUBLIC_REPOSITORY_URL}",
+              "snapshots": {
+                "enabled": "true"
+              }
+            }]
+          servers: >
+            [{
+              "id": "nexus-snapshot",
+              "username": "${env.NEXUS_USERNAME}",
+              "password": "${env.NEXUS_PASSWORD}"
+            },
+            {
+              "id": "nexus-release",
+              "username": "${env.NEXUS_USERNAME}",
+              "password": "${env.NEXUS_PASSWORD}"
+            }]
+      - name: Config Git
+        run: |
+          git config --global user.email "edward@cheng.sydney"
+          git config --global user.name "3dwardch3ng"
+          git config --global core.autocrlf input
+      - name: Start release
+        run: |
+          mvn gitflow:release-start -B -DpushRemote=true -DallowSnapshots=true -P homelab
+      - name: Maven Publish
+        run: |
+          mvn -B deploy -P homelab
+      - name: Finish release
+        env:
+          GITHUB_ACTOR: 3dwardch3ng
+          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
+        run: |
+          mvn gitflow:release-finish -B -DpushRemote=true -DallowSnapshots=true -P homelab

configuration/pom.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>sydney.cheng</groupId>
+        <artifactId>ec-microservice-commons</artifactId>
+        <version>1.0.0-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>ec-microservice-commons-configuration</artifactId>
+
+    <properties>
+        <maven.compiler.source>17</maven.compiler.source>
+        <maven.compiler.target>17</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-jpa</artifactId>
+        </dependency>
+    </dependencies>
+</project>

configuration/src/main/java/sydney/cheng/microservice/commons/configuration/properties/AppConfiguration.java

@@ -0,0 +1,26 @@
+package sydney.cheng.microservice.commons.configuration.properties;
+
+import lombok.AccessLevel;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.boot.context.properties.ConfigurationPropertiesScan;
+import org.springframework.context.annotation.Configuration;
+import sydney.cheng.microservice.commons.configuration.properties.auth.SecurityProperties;
+import sydney.cheng.microservice.commons.configuration.properties.database.DatabaseProperties;
+
+@Data
+@ConfigurationPropertiesScan(basePackages = {"sydney.cheng.**.properties"})
+@ConfigurationProperties("app")
+@Configuration
+public class AppConfiguration {
+    private ApplicationConfiguration application;
+    private SecurityProperties security;
+    private DatabaseProperties database;
+
+    @Data
+    @NoArgsConstructor(access = AccessLevel.PRIVATE)
+    public static class ApplicationConfiguration {
+        private String deploymentTarget;
+    }
+}

configuration/src/main/java/sydney/cheng/microservice/commons/configuration/properties/auth/CorsProperties.java

@@ -0,0 +1,32 @@
+package sydney.cheng.microservice.commons.configuration.properties.auth;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+
+import java.util.Arrays;
+import java.util.List;
+
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@ConfigurationProperties(prefix = "app.security.cors")
+public class CorsProperties {
+    private String allowedUrls;
+    private String allowedOrigins;
+    private List<String> allowedHeaders;
+    private List<String> allowedMethods;
+    private long allowedMaxAge = 3600;
+    private boolean allowCredentials = true;
+
+    public List<String> getAllowedUrlList() {
+        return Arrays.asList(allowedUrls.split(","));
+    }
+
+    public List<String> getAllowedOriginList() {
+        return Arrays.asList(allowedOrigins.split(","));
+    }
+}

configuration/src/main/java/sydney/cheng/microservice/commons/configuration/properties/auth/OAuth2Properties.java

@@ -0,0 +1,24 @@
+package sydney.cheng.microservice.commons.configuration.properties.auth;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+@ConfigurationProperties(prefix = "app.security.oauth2")
+public class OAuth2Properties {
+    private RemoteTokenCheckProperties remoteTokenCheck;
+
+    @Getter
+    @Setter
+    public static class RemoteTokenCheckProperties {
+        String checkTokenUrl;
+        String clientId;
+        String clientSecret;
+    }
+}

configuration/src/main/java/sydney/cheng/microservice/commons/configuration/properties/auth/SecurityProperties.java

@@ -0,0 +1,12 @@
+package sydney.cheng.microservice.commons.configuration.properties.auth;
+
+import lombok.Data;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+
+@Data
+@ConfigurationProperties("app.security")
+public class SecurityProperties {
+    private UrlProperties url;
+    private CorsProperties cors;
+    private OAuth2Properties oauth2;
+}

configuration/src/main/java/sydney/cheng/microservice/commons/configuration/properties/auth/UrlProperties.java

@@ -0,0 +1,13 @@
+package sydney.cheng.microservice.commons.configuration.properties.auth;
+
+import lombok.Data;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+
+@Data
+@ConfigurationProperties(prefix = "app.security.url")
+public class UrlProperties {
+    private String frontend;
+    private String backend;
+    private String gateway;
+    private String frontendDefaultLogin;
+}

configuration/src/main/java/sydney/cheng/microservice/commons/configuration/properties/database/DataSourceProperties.java

@@ -0,0 +1,18 @@
+package sydney.cheng.microservice.commons.configuration.properties.database;
+
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.springframework.context.annotation.Profile;
+
+import java.io.Serializable;
+
+@Profile("database")
+@EqualsAndHashCode(callSuper = true)
+@Data
+public class DataSourceProperties extends org.springframework.boot.autoconfigure.jdbc.DataSourceProperties implements Serializable {
+    private HikariDataSourceProperties hikari;
+
+    public DataSourceProperties() {
+        super();
+    }
+}

configuration/src/main/java/sydney/cheng/microservice/commons/configuration/properties/database/DatabaseNodeProperties.java

@@ -0,0 +1,12 @@
+package sydney.cheng.microservice.commons.configuration.properties.database;
+
+import lombok.Data;
+import org.springframework.context.annotation.Profile;
+
+import java.io.Serializable;
+
+@Profile("database")
+@Data
+public class DatabaseNodeProperties implements Serializable {
+    DataSourceProperties datasource;
+}

configuration/src/main/java/sydney/cheng/microservice/commons/configuration/properties/database/DatabaseProperties.java

@@ -0,0 +1,25 @@
+package sydney.cheng.microservice.commons.configuration.properties.database;
+
+import lombok.Data;
+import org.springframework.boot.autoconfigure.orm.jpa.JpaProperties;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.context.annotation.Profile;
+import org.springframework.context.annotation.PropertySource;
+
+import java.io.Serializable;
+
+@Profile("database")
+@Data
+@PropertySource("classpath:application.yml")
+@ConfigurationProperties(prefix = "app.database")
+public class DatabaseProperties {
+    EntityManagerProperties entityManager;
+    JpaProperties jpa;
+    DatabaseNodeProperties master;
+    DatabaseNodeProperties replica;
+
+    @Data
+    public static class EntityManagerProperties implements Serializable {
+        String packages;
+    }
+}

configuration/src/main/java/sydney/cheng/microservice/commons/configuration/properties/database/HikariDataSourceProperties.java

@@ -0,0 +1,28 @@
+package sydney.cheng.microservice.commons.configuration.properties.database;
+
+import com.zaxxer.hikari.HikariConfig;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.springframework.context.annotation.Profile;
+
+import java.io.Serializable;
+import java.util.Properties;
+
+@Profile(value = {"database & hikari"})
+@EqualsAndHashCode(callSuper = true)
+@Data
+public class HikariDataSourceProperties extends HikariConfig implements Serializable {
+    private String urlPrefix;
+
+    public HikariDataSourceProperties() {
+        super();
+    }
+
+    public HikariDataSourceProperties(Properties properties) {
+        super(properties);
+    }
+
+    public HikariDataSourceProperties(String propertyFileName) {
+        super(propertyFileName);
+    }
+}

configuration/src/main/java/sydney/cheng/microservice/commons/configuration/properties/database/PrimaryHikariDataSourceProperties.java

@@ -0,0 +1,22 @@
+package sydney.cheng.microservice.commons.configuration.properties.database;
+
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.context.annotation.Profile;
+
+import java.util.Properties;
+
+@Profile(value = {"database & hikari"})
+@ConfigurationProperties("app.database.primary.datasource.hikari")
+public class PrimaryHikariDataSourceProperties extends HikariDataSourceProperties {
+    public PrimaryHikariDataSourceProperties() {
+        super();
+    }
+
+    public PrimaryHikariDataSourceProperties(Properties properties) {
+        super(properties);
+    }
+
+    public PrimaryHikariDataSourceProperties(String propertyFileName) {
+        super(propertyFileName);
+    }
+}

configuration/src/main/java/sydney/cheng/microservice/commons/configuration/properties/database/ReplicaHikariDataSourceProperties.java

@@ -0,0 +1,22 @@
+package sydney.cheng.microservice.commons.configuration.properties.database;
+
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.context.annotation.Profile;
+
+import java.util.Properties;
+
+@Profile(value = {"database & hikari"})
+@ConfigurationProperties("app.database.replica.datasource.hikari")
+public class ReplicaHikariDataSourceProperties extends HikariDataSourceProperties {
+    public ReplicaHikariDataSourceProperties() {
+        super();
+    }
+
+    public ReplicaHikariDataSourceProperties(String propertyFileName) {
+        super(propertyFileName);
+    }
+
+    public ReplicaHikariDataSourceProperties(Properties properties) {
+        super(properties);
+    }
+}

database/pom.xml

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>sydney.cheng</groupId>
+        <artifactId>ec-microservice-commons</artifactId>
+        <version>1.0.0-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>ec-microservice-commons-database</artifactId>
+
+    <properties>
+        <maven.compiler.source>17</maven.compiler.source>
+        <maven.compiler.target>17</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>sydney.cheng</groupId>
+            <artifactId>ec-microservice-commons-configuration</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-cache</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.github.ben-manes.caffeine</groupId>
+            <artifactId>caffeine</artifactId>
+            <version>${caffeine.version}</version>
+        </dependency>
+    </dependencies>
+</project>

database/src/main/java/sydney/cheng/microservice/commons/database/annotation/DatabaseTransactional.java

@@ -0,0 +1,22 @@
+package sydney.cheng.microservice.commons.database.annotation;
+
+import org.springframework.context.annotation.Profile;
+import org.springframework.transaction.annotation.Propagation;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Profile("database")
+@Target({ElementType.METHOD, ElementType.TYPE})
+@Retention(RetentionPolicy.RUNTIME)
+@Transactional("ecTransactionManager")
+public @interface DatabaseTransactional {
+    boolean readOnly() default false;
+
+    Propagation propagation() default Propagation.REQUIRED;
+
+    Class<? extends Throwable>[] noRollbackFor() default {};
+}

database/src/main/java/sydney/cheng/microservice/commons/database/annotation/ReadOnlyConnection.java

@@ -0,0 +1,12 @@
+package sydney.cheng.microservice.commons.database.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target({ElementType.METHOD, ElementType.TYPE})
+@Retention(RetentionPolicy.RUNTIME)
+public @interface ReadOnlyConnection {
+
+}

database/src/main/java/sydney/cheng/microservice/commons/database/annotation/ReadOnlyConnectionInterceptor.java

@@ -0,0 +1,52 @@
+package sydney.cheng.microservice.commons.database.annotation;
+
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+import org.aspectj.lang.ProceedingJoinPoint;
+import org.aspectj.lang.annotation.Around;
+import org.aspectj.lang.annotation.Aspect;
+import org.aspectj.lang.annotation.Pointcut;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.core.Ordered;
+import org.springframework.stereotype.Component;
+import sydney.cheng.microservice.commons.database.constant.DbType;
+import sydney.cheng.microservice.commons.database.datasource.DbContextHolder;
+
+@Aspect
+@ToString
+@NoArgsConstructor
+@Component
+public class ReadOnlyConnectionInterceptor implements Ordered {
+    private int order;
+
+    @Override
+    public int getOrder() {
+        return order;
+    }
+
+    @Value("20")
+    public void setOrder(int order) {
+        this.order = order;
+    }
+
+    /*
+     * handle interceptor for any public method execution
+     */
+    @Pointcut(value = "execution(public * *(..))")
+    public void anyPublicMethod() {
+        throw new UnsupportedOperationException();
+    }
+
+    @Around("@annotation(readOnlyConnection)")
+    public Object proceed(ProceedingJoinPoint pjp, ReadOnlyConnection readOnlyConnection) throws Throwable {
+        try {
+            DbContextHolder.setDbType(DbType.REPLICA);
+            Object result = pjp.proceed();
+            DbContextHolder.clearDbType();
+            return result;
+        } finally {
+            // restore state
+            DbContextHolder.clearDbType();
+        }
+    }
+}

database/src/main/java/sydney/cheng/microservice/commons/database/config/CacheManagerConfiguration.java

@@ -0,0 +1,26 @@
+package sydney.cheng.microservice.commons.database.config;
+
+import com.github.benmanes.caffeine.cache.Caffeine;
+import org.springframework.cache.CacheManager;
+import org.springframework.cache.annotation.EnableCaching;
+import org.springframework.cache.caffeine.CaffeineCacheManager;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+import java.util.concurrent.TimeUnit;
+
+@EnableCaching
+@Configuration
+public class CacheManagerConfiguration {
+    @Bean
+    public Caffeine<Object, Object> caffeineConfig() {
+        return Caffeine.newBuilder().expireAfterWrite(12, TimeUnit.HOURS);
+    }
+
+    @Bean
+    public CacheManager cacheManager(Caffeine<Object, Object> caffeine) {
+        CaffeineCacheManager caffeineCacheManager = new CaffeineCacheManager();
+        caffeineCacheManager.setCaffeine(caffeine);
+        return caffeineCacheManager;
+    }
+}

database/src/main/java/sydney/cheng/microservice/commons/database/config/HikariDataSourceConfiguration.java

@@ -0,0 +1,57 @@
+package sydney.cheng.microservice.commons.database.config;
+
+import com.zaxxer.hikari.HikariDataSource;
+import lombok.*;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.context.annotation.Profile;
+import sydney.cheng.microservice.commons.configuration.properties.database.PrimaryHikariDataSourceProperties;
+import sydney.cheng.microservice.commons.configuration.properties.database.ReplicaHikariDataSourceProperties;
+import sydney.cheng.microservice.commons.database.constant.DbType;
+import sydney.cheng.microservice.commons.database.datasource.RoutingDataSource;
+
+import javax.sql.DataSource;
+import java.util.Map;
+
+import static sydney.cheng.microservice.commons.database.constant.DatabaseBeanConstant.*;
+
+@Profile(value = {"database & hikari"})
+@Getter
+@Setter
+@ToString
+@AllArgsConstructor
+@NoArgsConstructor(access = AccessLevel.PRIVATE, force = true)
+@Configuration
+public class HikariDataSourceConfiguration {
+    private final PrimaryHikariDataSourceProperties primaryHikariDataSourceProperties;
+    private final ReplicaHikariDataSourceProperties replicaHikariDataSourceProperties;
+
+    @Bean(name = PRIMARY_DS_BEAN_NAME)
+    public DataSource primaryDataSource() {
+        if (this.primaryHikariDataSourceProperties == null) throw new AssertionError();
+        this.primaryHikariDataSourceProperties.setPoolName(PRIMARY_DS_BEAN_NAME);
+        return new HikariDataSource(this.primaryHikariDataSourceProperties);
+    }
+
+    @Bean(name = REPLICA_DS_BEAN_NAME)
+    public DataSource replicaDataSource() {
+        if (this.replicaHikariDataSourceProperties == null) throw new AssertionError();
+        this.replicaHikariDataSourceProperties.setPoolName(REPLICA_DS_BEAN_NAME);
+        return new HikariDataSource(this.replicaHikariDataSourceProperties);
+    }
+
+    /**
+     * Configure data source routing for MRCENTRAL.
+     *
+     * @return data source
+     * @see RoutingDataSource
+     */
+    @Bean(name = {"dataSource", DS_BEAN_NAME})
+    public DataSource centralDataSource() {
+        RoutingDataSource rds = new RoutingDataSource();
+        rds.setTargetDataSources(Map
+                .of(DbType.PRIMARY, this.primaryDataSource(), DbType.REPLICA, this.replicaDataSource()));
+        rds.setDefaultTargetDataSource(this.primaryDataSource());
+        return rds;
+    }
+}

database/src/main/java/sydney/cheng/microservice/commons/database/config/JPAPersistenceConfiguration.java

@@ -0,0 +1,70 @@
+package sydney.cheng.microservice.commons.database.config;
+
+import jakarta.persistence.EntityManagerFactory;
+import org.hibernate.cfg.AvailableSettings;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.beans.factory.config.ConfigurableListableBeanFactory;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.context.annotation.Profile;
+import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
+import org.springframework.orm.hibernate5.SpringBeanContainer;
+import org.springframework.orm.jpa.JpaTransactionManager;
+import org.springframework.orm.jpa.JpaVendorAdapter;
+import org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean;
+import org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter;
+import sydney.cheng.microservice.commons.configuration.properties.database.DatabaseProperties;
+
+import javax.sql.DataSource;
+import java.util.HashMap;
+import java.util.Map;
+
+import static sydney.cheng.microservice.commons.database.constant.DatabaseBeanConstant.*;
+
+@Profile(value = {"database & hikari"})
+@Configuration
+@EnableJpaRepositories(
+        basePackages = "sydney.cheng.**.repository",
+        entityManagerFactoryRef = "entityManagerFactory",
+        transactionManagerRef = "transactionManager"
+)
+public class JPAPersistenceConfiguration {
+    private final ConfigurableListableBeanFactory beanFactory;
+
+    private final DatabaseProperties databaseProperties;
+
+    public JPAPersistenceConfiguration(
+            ConfigurableListableBeanFactory beanFactory,
+            DatabaseProperties databaseProperties
+    ) {
+        this.beanFactory = beanFactory;
+        this.databaseProperties = databaseProperties;
+    }
+
+    @Bean
+    public LocalContainerEntityManagerFactoryBean entityManagerFactory(@Qualifier(DS_BEAN_NAME) DataSource dataSource) {
+        LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
+
+        em.setPersistenceUnitName("persistence-unit");
+        em.setPackagesToScan(this.databaseProperties.getEntityManager().getPackages());
+        em.setDataSource(dataSource);
+
+        JpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
+        em.setJpaVendorAdapter(vendorAdapter);
+
+        Map<String, Object> properties = new HashMap<>(this.databaseProperties.getJpa().getProperties());
+        properties.put(AvailableSettings.PHYSICAL_NAMING_STRATEGY, "org.hibernate.boot.model.naming.CamelCaseToUnderscoresNamingStrategy");
+        properties.put(AvailableSettings.IMPLICIT_NAMING_STRATEGY, "org.springframework.boot.orm.jpa.hibernate.SpringImplicitNamingStrategy");
+        properties.put(AvailableSettings.BEAN_CONTAINER, new SpringBeanContainer(this.beanFactory));
+        em.setJpaPropertyMap(properties);
+
+        return em;
+    }
+
+    @Bean
+    public JpaTransactionManager transactionManager(@Qualifier("entityManagerFactory") EntityManagerFactory emf) {
+        JpaTransactionManager transactionManager = new JpaTransactionManager();
+        transactionManager.setEntityManagerFactory(emf);
+        return transactionManager;
+    }
+}

database/src/main/java/sydney/cheng/microservice/commons/database/constant/DatabaseBeanConstant.java

@@ -0,0 +1,10 @@
+package sydney.cheng.microservice.commons.database.constant;
+
+import lombok.NoArgsConstructor;
+
+@NoArgsConstructor(access = lombok.AccessLevel.PRIVATE)
+public class DatabaseBeanConstant {
+    public static final String DS_BEAN_NAME = "databaseDataSource";
+    public static final String PRIMARY_DS_BEAN_NAME = "databaseDataSourcePrimary";
+    public static final String REPLICA_DS_BEAN_NAME = "databaseDataSourceReplica";
+}

database/src/main/java/sydney/cheng/microservice/commons/database/constant/DbType.java

@@ -0,0 +1,5 @@
+package sydney.cheng.microservice.commons.database.constant;
+
+public enum DbType {
+    PRIMARY, REPLICA
+}

database/src/main/java/sydney/cheng/microservice/commons/database/datasource/DbContextHolder.java

@@ -0,0 +1,27 @@
+package sydney.cheng.microservice.commons.database.datasource;
+
+import sydney.cheng.microservice.commons.database.constant.DbType;
+
+public class DbContextHolder {
+
+    private static final ThreadLocal<DbType> contextHolder = new ThreadLocal<>();
+
+    private DbContextHolder() {
+        super();
+    }
+
+    public static DbType getDbType() {
+        return contextHolder.get();
+    }
+
+    public static void setDbType(DbType dbType) {
+        if (dbType == null) {
+            throw new NullPointerException();
+        }
+        contextHolder.set(dbType);
+    }
+
+    public static void clearDbType() {
+        contextHolder.remove();
+    }
+}

database/src/main/java/sydney/cheng/microservice/commons/database/datasource/RoutingDataSource.java

@@ -0,0 +1,11 @@
+package sydney.cheng.microservice.commons.database.datasource;
+
+import org.springframework.jdbc.datasource.lookup.AbstractRoutingDataSource;
+
+public class RoutingDataSource extends AbstractRoutingDataSource {
+
+    @Override
+    protected Object determineCurrentLookupKey() {
+        return DbContextHolder.getDbType();
+    }
+}

entity/pom.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>sydney.cheng</groupId>
+        <artifactId>ec-microservice-commons</artifactId>
+        <version>1.0.0-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>ec-microservice-commons-entity</artifactId>
+
+    <properties>
+        <maven.compiler.source>17</maven.compiler.source>
+        <maven.compiler.target>17</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-jpa</artifactId>
+        </dependency>
+    </dependencies>
+</project>

entity/src/main/java/sydney/cheng/entity/AbstractUser.java

@@ -0,0 +1,31 @@
+package sydney.cheng.entity;
+
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+import org.hibernate.annotations.UuidGenerator;
+
+import java.io.Serializable;
+
+@MappedSuperclass
+@Getter
+@Setter
+@AllArgsConstructor
+@NoArgsConstructor
+public abstract class AbstractUser implements Serializable {
+    @Id
+    @UuidGenerator(style = UuidGenerator.Style.TIME)
+    @Column(name = "id")
+    private String id;
+
+    @Column(name = "username", nullable = false)
+    private String username;
+
+    @Column(name = "email", nullable = false, unique = true)
+    private String email;
+
+    @Column(name = "password", nullable = false)
+    private String password;
+}

pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>sydney.cheng</groupId>
         <artifactId>ec-super-pom</artifactId>
-        <version>1.0.1</version>
+        <version>1.0.4</version>
     </parent>
 
     <artifactId>ec-microservice-commons</artifactId>
@@ -40,9 +40,20 @@
 
     <modules>
         <module>swagger</module>
+        <module>entity</module>
+        <module>configuration</module>
+        <module>database</module>
     </modules>
 
     <properties>
+        <maven.compiler.source>17</maven.compiler.source>
+        <maven.compiler.target>17</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <!-- Dependency Versions -->
+        <spring-context-support.version>6.1.12</spring-context-support.version>
+        <springdoc-openapi-starter-common.version>2.6.0</springdoc-openapi-starter-common.version>
+        <atomikos.version>6.0.0</atomikos.version>
+        <caffeine.version>3.1.8</caffeine.version>
         <!-- Sonar Properties -->
         <sonar.java.coveragePlugin>jacoco</sonar.java.coveragePlugin>
         <sonar.dynamicAnalysis>reuseReports</sonar.dynamicAnalysis>
@@ -52,4 +63,43 @@
         <sonar.organization>3dwardch3ng</sonar.organization>
         <sonar.host.url>https://sonarqube.cluster.edward.sydney</sonar.host.url>
     </properties>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-source-plugin</artifactId>
+                <version>${maven-source-plugin.version}</version>
+                <executions>
+                    <execution>
+                        <id>attach-sources</id>
+                        <goals>
+                            <goal>jar</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </build>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter</artifactId>
+        </dependency>
+        <!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-autoconfigure -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-autoconfigure</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <scope>provided</scope>
+        </dependency>
+    </dependencies>
 </project>

renovate.json

@@ -2,5 +2,15 @@
   "$schema": "https://docs.renovatebot.com/renovate-schema.json",
   "extends": [
     "local>3dwardch3ng/renovate-config"
+  ],
+  "packageRules": [
+    {
+      "matchDatasources": ["maven"],
+      "registryUrls": [
+        "https://nexus.cluster.edward.sydney/repository/maven-releases",
+        "https://nexus.cluster.edward.sydney/repository/maven-snapshots",
+        "https://repo.maven.apache.org/maven2"
+      ]
+    }
   ]
 }

swagger/pom.xml

@@ -18,8 +18,6 @@
         <maven.compiler.source>17</maven.compiler.source>
         <maven.compiler.target>17</maven.compiler.target>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-        <!-- Dependency Versions -->
-        <springdoc-openapi-starter-common.version>2.6.0</springdoc-openapi-starter-common.version>
     </properties>
 
     <dependencies>