devslab-kr · jlc488 · May 23, 2026 · May 23, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,25 @@ The source of truth for the entries below is [docs/changelog.md](docs/changelog.
 
 ## [Unreleased]
 
+## [3.0.0] — Spring-major-aligned versioning policy
+
+**Renumbering of `0.6.0`** per the new [Spring-major-aligned versioning policy](https://github.com/devslab-kr/.github/blob/main/.github/VERSIONING.md). No API, behaviour, or dependency changes — the major number is bumped from `0.6` to `3.0` to match the Spring Boot major this line targets (Spring Boot 3). The published JAR bytes are identical to `0.6.0` apart from the version coordinate in the POM.
+
+Going forward, all Spring Boot 3 releases of api-log ship on the `3.x.y` line. When a Spring Boot 4 line ships, it will be `4.x.y`. The previous `0.6.0` artifacts remain on Maven Central as historical references.
+
+### Upgrading from `0.6.0`
+
+```diff
+- implementation("kr.devslab:api-log-jpa:0.6.0")
++ implementation("kr.devslab:api-log-jpa:3.0.0")
+- implementation("kr.devslab:api-log-r2dbc:0.6.0")
++ implementation("kr.devslab:api-log-r2dbc:3.0.0")
+- implementation("kr.devslab:api-log-mybatis:0.6.0")
++ implementation("kr.devslab:api-log-mybatis:3.0.0")
+```
+
+No other changes. Same Spring Boot 3 baseline, same `ApiLogWriter` SPI, same auto-configuration.
+
 ## [0.6.0] — Multi-module split (Gradle), pluggable JPA / R2DBC / MyBatis backends
 
 ### Changed
@@ -104,7 +123,8 @@ See [docs/changelog.md](docs/changelog.md#020--schema-management-opt-in) for the
 
 First public release. See [docs/changelog.md](docs/changelog.md#010--initial-release) for details.
 
-[Unreleased]: https://github.com/devslab-kr/api-log/compare/v0.6.0...HEAD
+[Unreleased]: https://github.com/devslab-kr/api-log/compare/v3.0.0...HEAD
+[3.0.0]: https://github.com/devslab-kr/api-log/releases/tag/v3.0.0
 [0.6.0]: https://github.com/devslab-kr/api-log/releases/tag/v0.6.0
 [0.5.2]: https://github.com/devslab-kr/api-log/releases/tag/v0.5.2
 [0.5.1]: https://github.com/devslab-kr/api-log/releases/tag/v0.5.1

diff --git a/README.ko.md b/README.ko.md
@@ -112,9 +112,9 @@ v0.6.0부터 스타터가 4개 아티팩트로 분리됐습니다 — 백엔드
 ### Gradle
 
 ```kotlin
-implementation("kr.devslab:api-log-jpa:0.6.0")
-// 또는 "kr.devslab:api-log-r2dbc:0.6.0"
-// 또는 "kr.devslab:api-log-mybatis:0.6.0"
+implementation("kr.devslab:api-log-jpa:3.0.0")
+// 또는 "kr.devslab:api-log-r2dbc:3.0.0"
+// 또는 "kr.devslab:api-log-mybatis:3.0.0"
 ```
 
 ## 설정

diff --git a/README.md b/README.md
@@ -113,9 +113,9 @@ coordinate is enough.
 ### Gradle
 
 ```kotlin
-implementation("kr.devslab:api-log-jpa:0.6.0")
-// or "kr.devslab:api-log-r2dbc:0.6.0"
-// or "kr.devslab:api-log-mybatis:0.6.0"
+implementation("kr.devslab:api-log-jpa:3.0.0")
+// or "kr.devslab:api-log-r2dbc:3.0.0"
+// or "kr.devslab:api-log-mybatis:3.0.0"
 ```
 
 ## Configuration

diff --git a/docs/changelog.ko.md b/docs/changelog.ko.md
@@ -6,6 +6,25 @@
 
 ## [Unreleased]
 
+## [3.0.0] — Spring-major 정렬 버전 정책
+
+**`0.6.0`의 재번호링** — 새 [Spring-major 정렬 버전 정책](https://github.com/devslab-kr/.github/blob/main/.github/VERSIONING.md#한국어)에 따름. API / 동작 / 의존성 변경 전혀 없음 — 메이저 숫자를 `0.6` → `3.0`으로 올려서 이 라인의 타겟 Spring Boot 메이저 (Spring Boot 3)와 일치시킴. 발행된 JAR 바이트는 `0.6.0`과 동일 (POM의 버전 좌표만 다름).
+
+앞으로 모든 Spring Boot 3 릴리즈는 `3.x.y` 라인. 기존 `0.6.0` 아티팩트는 historical reference로 Maven Central에 잔존.
+
+### `0.6.0`에서 올라오기
+
+```diff
+- implementation("kr.devslab:api-log-jpa:0.6.0")
++ implementation("kr.devslab:api-log-jpa:3.0.0")
+- implementation("kr.devslab:api-log-r2dbc:0.6.0")
++ implementation("kr.devslab:api-log-r2dbc:3.0.0")
+- implementation("kr.devslab:api-log-mybatis:0.6.0")
++ implementation("kr.devslab:api-log-mybatis:3.0.0")
+```
+
+다른 변경 없음. `ApiLogWriter` SPI 동일, 자동 설정 형태 동일.
+
 ## [0.6.0] — 멀티모듈 분리 (Gradle), JPA / R2DBC / MyBatis 백엔드 선택 지원
 
 ### Changed

diff --git a/docs/changelog.md b/docs/changelog.md
@@ -6,6 +6,25 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 
 ## [Unreleased]
 
+## [3.0.0] — Spring-major-aligned versioning policy
+
+**Renumbering of `0.6.0`** per the new [Spring-major-aligned versioning policy](https://github.com/devslab-kr/.github/blob/main/.github/VERSIONING.md). No API, behaviour, or dependency changes — the major number bumps from `0.6` to `3.0` to match the Spring Boot major this line targets (Spring Boot 3). Published JAR bytes are identical to `0.6.0` apart from the version coordinate.
+
+Going forward, all Spring Boot 3 releases of api-log ship on the `3.x.y` line. The previous `0.6.0` artifacts remain on Maven Central as historical references.
+
+### Upgrading from `0.6.0`
+
+```diff
+- implementation("kr.devslab:api-log-jpa:0.6.0")
++ implementation("kr.devslab:api-log-jpa:3.0.0")
+- implementation("kr.devslab:api-log-r2dbc:0.6.0")
++ implementation("kr.devslab:api-log-r2dbc:3.0.0")
+- implementation("kr.devslab:api-log-mybatis:0.6.0")
++ implementation("kr.devslab:api-log-mybatis:3.0.0")
+```
+
+No other changes. Same `ApiLogWriter` SPI, same auto-configuration shape.
+
 ## [0.6.0] — Multi-module split (Gradle), pluggable JPA / R2DBC / MyBatis backends
 
 ### Changed

diff --git a/docs/getting-started/installation.ko.md b/docs/getting-started/installation.ko.md
@@ -48,19 +48,19 @@ v0.6.0부터 스타터가 백엔드 비종속 코어 + 영속화 백엔드 1개
     ```kotlin
     dependencies {
         // JPA — v0.5.x 드롭인
-        implementation("kr.devslab:api-log-jpa:0.6.0")
-        // 또는 "kr.devslab:api-log-r2dbc:0.6.0"
-        // 또는 "kr.devslab:api-log-mybatis:0.6.0"
+        implementation("kr.devslab:api-log-jpa:3.0.0")
+        // 또는 "kr.devslab:api-log-r2dbc:3.0.0"
+        // 또는 "kr.devslab:api-log-mybatis:3.0.0"
     }
     ```
 
 === "Gradle (Groovy)"
 
     ```groovy
     dependencies {
-        implementation 'kr.devslab:api-log-jpa:0.6.0'
-        // 또는 'kr.devslab:api-log-r2dbc:0.6.0'
-        // 또는 'kr.devslab:api-log-mybatis:0.6.0'
+        implementation 'kr.devslab:api-log-jpa:3.0.0'
+        // 또는 'kr.devslab:api-log-r2dbc:3.0.0'
+        // 또는 'kr.devslab:api-log-mybatis:3.0.0'
     }
     ```
 

diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md
@@ -48,19 +48,19 @@ backend artifact pulls in `api-log-core` transitively.**
     ```kotlin
     dependencies {
         // JPA — drop-in for v0.5.x setups
-        implementation("kr.devslab:api-log-jpa:0.6.0")
-        // or "kr.devslab:api-log-r2dbc:0.6.0"
-        // or "kr.devslab:api-log-mybatis:0.6.0"
+        implementation("kr.devslab:api-log-jpa:3.0.0")
+        // or "kr.devslab:api-log-r2dbc:3.0.0"
+        // or "kr.devslab:api-log-mybatis:3.0.0"
     }
     ```
 
 === "Gradle (Groovy)"
 
     ```groovy
     dependencies {
-        implementation 'kr.devslab:api-log-jpa:0.6.0'
-        // or 'kr.devslab:api-log-r2dbc:0.6.0'
-        // or 'kr.devslab:api-log-mybatis:0.6.0'
+        implementation 'kr.devslab:api-log-jpa:3.0.0'
+        // or 'kr.devslab:api-log-r2dbc:3.0.0'
+        // or 'kr.devslab:api-log-mybatis:3.0.0'
     }
     ```
 

diff --git a/docs/guides/jpa-backend.ko.md b/docs/guides/jpa-backend.ko.md
@@ -30,7 +30,7 @@ WebFlux + R2DBC 환경이면 [`api-log-r2dbc`](r2dbc-backend.md), MyBatis 환경
 === "Gradle (Kotlin DSL)"
 
     ```kotlin
-    implementation("kr.devslab:api-log-jpa:0.6.0")
+    implementation("kr.devslab:api-log-jpa:3.0.0")
     ```
 
 `api-log-jpa`는 `api-log-core` (이벤트, 리스너, HTTP 유틸)와

diff --git a/docs/guides/jpa-backend.md b/docs/guides/jpa-backend.md
@@ -32,7 +32,7 @@ you're on MyBatis, prefer [`api-log-mybatis`](mybatis-backend.md). The
 === "Gradle (Kotlin DSL)"
 
     ```kotlin
-    implementation("kr.devslab:api-log-jpa:0.6.0")
+    implementation("kr.devslab:api-log-jpa:3.0.0")
     ```
 
 `api-log-jpa` transitively pulls in `api-log-core` (events, listener, HTTP

diff --git a/docs/guides/mybatis-backend.ko.md b/docs/guides/mybatis-backend.ko.md
@@ -30,7 +30,7 @@ JPA를 쓰고 있으면 [`api-log-jpa`](jpa-backend.md) 선택. WebFlux + R2DBC
 === "Gradle (Kotlin DSL)"
 
     ```kotlin
-    implementation("kr.devslab:api-log-mybatis:0.6.0")
+    implementation("kr.devslab:api-log-mybatis:3.0.0")
     ```
 
 `api-log-mybatis`는 `api-log-core`, `mybatis-spring-boot-starter:3.0.4`

diff --git a/docs/guides/mybatis-backend.md b/docs/guides/mybatis-backend.md
@@ -31,7 +31,7 @@ is identical across all three.
 === "Gradle (Kotlin DSL)"
 
     ```kotlin
-    implementation("kr.devslab:api-log-mybatis:0.6.0")
+    implementation("kr.devslab:api-log-mybatis:3.0.0")
     ```
 
 `api-log-mybatis` transitively pulls in `api-log-core`,

diff --git a/docs/guides/r2dbc-backend.ko.md b/docs/guides/r2dbc-backend.ko.md
@@ -30,7 +30,7 @@ Servlet 스택이라면 JPA가 더 자연스럽습니다 — [`api-log-jpa`](jpa
 === "Gradle (Kotlin DSL)"
 
     ```kotlin
-    implementation("kr.devslab:api-log-r2dbc:0.6.0")
+    implementation("kr.devslab:api-log-r2dbc:3.0.0")
     ```
 
 `api-log-r2dbc`는 `api-log-core`와 `spring-r2dbc` (`DatabaseClient`),

diff --git a/docs/guides/r2dbc-backend.md b/docs/guides/r2dbc-backend.md
@@ -32,7 +32,7 @@ rows in `api_log`.
 === "Gradle (Kotlin DSL)"
 
     ```kotlin
-    implementation("kr.devslab:api-log-r2dbc:0.6.0")
+    implementation("kr.devslab:api-log-r2dbc:3.0.0")
     ```
 
 `api-log-r2dbc` transitively pulls in `api-log-core` plus `spring-r2dbc`

diff --git a/gradle.properties b/gradle.properties
@@ -1,6 +1,6 @@
 # Project coordinates
 GROUP=kr.devslab
-VERSION=0.6.0-SNAPSHOT
+VERSION=3.0.0
 
 # Project metadata for Maven Central POM
 POM_NAME=API Log Spring Boot Starter