문제: High·P1을 고친 뒤에도 P2·P3 약 90건이 남았다. 연결·구독·메시지 크기 상한이 없는 전송(WebSocket·gRPC·GraphQL deadline), 낙관적 충돌의 500, upsert 경쟁, Mongo 무제한 timeout, 샘플 목록 N+1, 갈라진 복사본 (TenantId 3벌, 이벤트 ID 문법 5곳, SQLState 표 2벌), 문서를 읽는 PR 테스트와 캐시를 막는 lane 설정 등이다. 새 기능을 어디에 어떤 순서로 만드는지 알려 주는 문서와 도구가 없었다. MinIO 공식 이미지가 사라져 객체 저장소 lane이 돌지 않았다. 방법: 영역별 묶음으로 실패 테스트를 먼저 쓰고 고쳤다. 고치는 중에 찾은 결함도 함께 고쳤다(durable operation id가 UUIDv4라 이벤트가 전부 DEAD, S3 어댑터 생성·작은 chunk 읽기 실패, Redis 조건부 기록의 EVALSHA 권한). MinIO는 pgsty/minio를 digest로 고정했다(Chainguard는 태그·실행 사용자· mc 이미지 문제로 버림). docs/manual/에 작업 순서와 판단 지점을 쓰고, scripts/new-feature.sh가 5개 leaf에 뼈대를 만든다. 생성→빌드→통과 왕복을 verifyFeatureScaffold가 mainCheck에서 본다. 묶음별 결과와 결정은 리뷰 README 14절에 있다. 위험·한계: 파생 서비스 동작이 바뀐다. JDBC batch 50 기본, 운영 jar에서 H2 제거, 트랜잭션 30초 제한, 격리 수준을 Hikari에서 고정, gRPC· WebSocket·GraphQL 새 한도, correlation ID 규칙 밖이면 서버가 교체, 샘플 키 오류 코드 IDEMPOTENCY_KEY_INVALID. 새 leaf 두 개 (composition:durable-operation, adapter:inbound:messaging)와 새 마이그레이션(postgresql V20·V21, notification V11·V12, sample V8_1, grpc-ledger V002)이 생긴다. V21 유일 인덱스는 기존 중복이 있으면 실패한다(runbook에 확인 쿼리). 검증: ci, mainCheck(생성 명령 왕복 포함), integrationCheck(MinIO 포함 전 컨테이너 lane), -p optional-platforms ci integrationCheck 통과. Refs: docs/reviews/2026-11-01-maturity-review/README.md 14절 BREAKING CHANGE: JDBC batch 기본 켜짐, H2 운영 의존 제거, 트랜잭션 기본 제한 30초, gRPC·WebSocket·GraphQL 서버 한도 기본값 추가, 샘플 Idempotency-Key 오류 코드 변경.
153 lines
9.6 KiB
TOML
153 lines
9.6 KiB
TOML
# Version catalog — every dependency version this build pins itself.
|
|
#
|
|
# Versions managed by an imported BOM are NOT here: a BOM already owns them, and restating a managed
|
|
# version would create a second answer to the same question. The BOM's own coordinate is a different
|
|
# question and it is here — `awsSdk` and `grpc` below are the versions of the BOMs themselves, which
|
|
# this build does choose. What is here is the set a module used to spell out inline, once per usage.
|
|
#
|
|
# The reason is visibility, not reproducibility — `gradle.lockfile` already fixes what resolves.
|
|
# Before this file, 59 coordinate strings were scattered across 15 build files and nothing could
|
|
# show them side by side, so two artifacts had quietly reached two versions:
|
|
#
|
|
# * spock-core 2.3-groovy-4.0 and 2.4-groovy-5.0
|
|
# * protobuf-java 4.29.3 and 4.33.2
|
|
#
|
|
# Both are kept as separate aliases rather than unified. Unifying them here would change what
|
|
# resolves, in a change whose whole purpose is that it does not; the aliases make the split
|
|
# reviewable, and whoever converges them does so deliberately with the lockfiles regenerated.
|
|
#
|
|
# Tool and plugin versions live here too. They are not dependencies of any module, so they never
|
|
# appear in a gradle.lockfile and nothing but this file can show them side by side. Four of them
|
|
# (Spring Boot, spotless, spotbugs, errorprone) were spelled out in the root `plugins {}` block, and
|
|
# three more (google-java-format, the Checkstyle tool, the SpotBugs tool) inside the shared
|
|
# `configure(subprojects)` block; the errorprone *plugin* and the errorprone *checker* it runs were
|
|
# pinned in two different files, which is exactly the pair this file exists to put next to each
|
|
# other.
|
|
#
|
|
# What is deliberately NOT here: the `commons-lang3.version` override in build-logic's
|
|
# JavaConventionsPlugin (ca.java-conventions). It is not a version this build chooses but an override
|
|
# of one the Spring Boot BOM already manages, valid only next to the sentence that says what breaks
|
|
# without it (the SpotBugs worker's NoClassDefFoundError). Moving the number here would leave the
|
|
# reason behind.
|
|
|
|
[versions]
|
|
approvaltests = "31.0.0"
|
|
assertj = "3.27.7"
|
|
archunit = "1.3.0"
|
|
avro = "1.12.0"
|
|
# AWS SDK v2 BOM coordinate. Imported at MODULE scope by adapter:outbound:objectstorage,
|
|
# sample-portfolio and app-bootstrap through `ext.awsSdkVersion`, which reads this key.
|
|
awsSdk = "2.30.0"
|
|
# Checkstyle *tool* version (the `checkstyle` extension), not a plugin: Checkstyle is a Gradle
|
|
# built-in plugin with no coordinate of its own.
|
|
checkstyle = "13.5.0"
|
|
cloudevents = "4.0.1"
|
|
errorprone = "2.49.0"
|
|
# The Gradle plugin that runs the checker above. Two different artifacts, two different version
|
|
# lines, deliberately adjacent so a bump of one is visibly not a bump of the other.
|
|
errorpronePlugin = "5.1.0"
|
|
findsecbugs = "1.14.0"
|
|
# Spotless's google-java-format step. A formatter version is a repository-wide decision: a bump
|
|
# reformats every file.
|
|
googleJavaFormat = "1.35.0"
|
|
# io.grpc BOM. Read through `ext.grpcVersion`; adapter:inbound:grpc and the five grpc:* leaves
|
|
# import it at MODULE scope to keep the strict-locking blast radius off the shared platform.
|
|
grpc = "1.68.1"
|
|
jmh = "1.37"
|
|
jmhPlugin = "0.7.3"
|
|
jqwik = "1.9.1"
|
|
# Jackson 3 and the JSON-Schema validator share a number today by coincidence, not by
|
|
# contract; separate keys so bumping one cannot move the other.
|
|
jackson3 = "3.0.2"
|
|
jsonSchemaValidator = "3.0.2"
|
|
junitJupiter = "5.11.3"
|
|
junitPlatform = "1.11.3"
|
|
logstashLogbackEncoder = "8.0"
|
|
okhttp = "4.12.0"
|
|
protobuf = "4.33.2"
|
|
# The third live protobuf version, and the reason this file now shows all three. adapter:inbound:grpc
|
|
# imports protobuf-bom at this major to match the gRPC BOM above; it is read through
|
|
# `ext.protobufVersion`.
|
|
protobufGrpc = "3.25.5"
|
|
# The Gradle plugin that runs protoc for grpc:grpc-contract. protoc and the protobuf-java runtime
|
|
# the generated code links against are both `protobufGrpc` above, so generator and runtime move
|
|
# together with the gRPC BOM.
|
|
protobufPlugin = "0.10.0"
|
|
# The websocket leaf's proto contract is generated against an older runtime and has not been
|
|
# requalified; see the coordinate's own comment in that leaf.
|
|
protobufLegacy = "4.29.3"
|
|
resilience4j = "2.2.0"
|
|
# Two Groovy generations, deliberately not merged. See the header.
|
|
spockGroovy4 = "2.3-groovy-4.0"
|
|
spockGroovy5 = "2.4-groovy-5.0"
|
|
# SpotBugs *tool* version (the `spotbugs` extension). The plugin that runs it is spotbugsPlugin.
|
|
spotbugs = "4.10.2"
|
|
spotbugsPlugin = "6.5.6"
|
|
spotless = "8.6.0"
|
|
springBoot = "4.0.8"
|
|
springCloudContext = "4.1.4"
|
|
# The version that actually resolves. Spring Boot 4.0.8's own plugin brings
|
|
# dependency-management 1.1.7, so the 1.1.6 that used to be written here was a floor nothing ever
|
|
# selected (`./gradlew buildEnvironment` reported `1.1.6 -> 1.1.7`). build-logic applies the plugin
|
|
# too and has no Boot plugin to upgrade it, so a catalog stating a version nobody resolves would
|
|
# have given the convention plugins a different one from the leaves.
|
|
springDependencyManagement = "1.1.7"
|
|
springDotenv = "4.0.0"
|
|
springdoc = "3.0.0"
|
|
toxiproxy = "2.1.7"
|
|
uuidCreator = "6.1.1"
|
|
|
|
[libraries]
|
|
approvaltests = { module = "com.approvaltests:approvaltests", version.ref = "approvaltests" }
|
|
assertj-core = { module = "org.assertj:assertj-core", version.ref = "assertj" }
|
|
archunit-junit5 = { module = "com.tngtech.archunit:archunit-junit5", version.ref = "archunit" }
|
|
avro = { module = "org.apache.avro:avro", version.ref = "avro" }
|
|
cloudevents-api = { module = "io.cloudevents:cloudevents-api", version.ref = "cloudevents" }
|
|
cloudevents-core = { module = "io.cloudevents:cloudevents-core", version.ref = "cloudevents" }
|
|
errorprone-core = { module = "com.google.errorprone:error_prone_core", version.ref = "errorprone" }
|
|
findsecbugs-plugin = { module = "com.h3xstream.findsecbugs:findsecbugs-plugin", version.ref = "findsecbugs" }
|
|
jackson-databind-nullable = { module = "org.openapitools:jackson-databind-nullable", version = "0.2.6" }
|
|
jackson3-core = { module = "tools.jackson.core:jackson-core", version.ref = "jackson3" }
|
|
jackson3-databind = { module = "tools.jackson.core:jackson-databind", version.ref = "jackson3" }
|
|
jmh-core = { module = "org.openjdk.jmh:jmh-core", version.ref = "jmh" }
|
|
jmh-generator-annprocess = { module = "org.openjdk.jmh:jmh-generator-annprocess", version.ref = "jmh" }
|
|
jqwik = { module = "net.jqwik:jqwik", version.ref = "jqwik" }
|
|
json-schema-validator = { module = "com.networknt:json-schema-validator", version.ref = "jsonSchemaValidator" }
|
|
junit-jupiter = { module = "org.junit.jupiter:junit-jupiter", version.ref = "junitJupiter" }
|
|
junit-platform-launcher = { module = "org.junit.platform:junit-platform-launcher", version.ref = "junitPlatform" }
|
|
logstash-logback-encoder = { module = "net.logstash.logback:logstash-logback-encoder", version.ref = "logstashLogbackEncoder" }
|
|
mockwebserver = { module = "com.squareup.okhttp3:mockwebserver", version.ref = "okhttp" }
|
|
okhttp-tls = { module = "com.squareup.okhttp3:okhttp-tls", version.ref = "okhttp" }
|
|
protobuf-java = { module = "com.google.protobuf:protobuf-java", version.ref = "protobuf" }
|
|
protobuf-java-legacy = { module = "com.google.protobuf:protobuf-java", version.ref = "protobufLegacy" }
|
|
protobuf-java-grpc = { module = "com.google.protobuf:protobuf-java", version.ref = "protobufGrpc" }
|
|
protoc = { module = "com.google.protobuf:protoc", version.ref = "protobufGrpc" }
|
|
resilience4j-bulkhead = { module = "io.github.resilience4j:resilience4j-bulkhead", version.ref = "resilience4j" }
|
|
resilience4j-circuitbreaker = { module = "io.github.resilience4j:resilience4j-circuitbreaker", version.ref = "resilience4j" }
|
|
resilience4j-micrometer = { module = "io.github.resilience4j:resilience4j-micrometer", version.ref = "resilience4j" }
|
|
resilience4j-ratelimiter = { module = "io.github.resilience4j:resilience4j-ratelimiter", version.ref = "resilience4j" }
|
|
resilience4j-retry = { module = "io.github.resilience4j:resilience4j-retry", version.ref = "resilience4j" }
|
|
spock-core-groovy4 = { module = "org.spockframework:spock-core", version.ref = "spockGroovy4" }
|
|
spock-core-groovy5 = { module = "org.spockframework:spock-core", version.ref = "spockGroovy5" }
|
|
spring-cloud-context = { module = "org.springframework.cloud:spring-cloud-context", version.ref = "springCloudContext" }
|
|
spring-dotenv = { module = "me.paulschwarz:spring-dotenv", version.ref = "springDotenv" }
|
|
springdoc-openapi-starter-webmvc-api = { module = "org.springdoc:springdoc-openapi-starter-webmvc-api", version.ref = "springdoc" }
|
|
toxiproxy-java = { module = "eu.rekawek.toxiproxy:toxiproxy-java", version.ref = "toxiproxy" }
|
|
uuid-creator = { module = "com.github.f4b6a3:uuid-creator", version.ref = "uuidCreator" }
|
|
|
|
# Plugin coordinates for the root `plugins {}` block. Declared here so that a plugin version and the
|
|
# library version it governs cannot drift in two files — errorprone is the live example: the plugin
|
|
# (errorpronePlugin) and the checker jar it puts on the compile classpath (errorprone, referenced by
|
|
# libs.errorprone.core below) are now one screen apart.
|
|
#
|
|
# The convention plugins from the included build (`ca.*`) are NOT here and cannot be: an included
|
|
# build supplies the plugin itself, so there is no coordinate and no version to pin.
|
|
[plugins]
|
|
spring-boot = { id = "org.springframework.boot", version.ref = "springBoot" }
|
|
spring-dependency-management = { id = "io.spring.dependency-management", version.ref = "springDependencyManagement" }
|
|
spotless = { id = "com.diffplug.spotless", version.ref = "spotless" }
|
|
spotbugs = { id = "com.github.spotbugs", version.ref = "spotbugsPlugin" }
|
|
errorprone = { id = "net.ltgt.errorprone", version.ref = "errorpronePlugin" }
|
|
jmh = { id = "me.champeau.jmh", version.ref = "jmhPlugin" }
|
|
protobuf = { id = "com.google.protobuf", version.ref = "protobufPlugin" }
|