템플릿 repo 안에 프로젝트 계층이 아닌 라이브러리가 있었다. gRPC 플랫폼 (src/platforms/grpc, grpc-advanced)과 그것만을 위한 두 번째 Gradle 빌드 (src/platforms/optional-build)는 템플릿 어느 leaf도 쓰지 않는데, registry 9행, workflow job 넷과 단계 하나, build-logic 플러그인 둘, 카탈로그·SpotBugs 항목, 문서 열두 개를 템플릿이 함께 지고 있었다. 소유자 결정(2026-11-07, design-docs repo-structure/README.md 3.5절, 05-library-repos.md Q1~Q17 승인)대로 라이브러리마다 별도 repo로 옮긴다. gRPC는 템플릿 소비자가 없어 먼저 옮기고, 템플릿은 지우기만 한다(Q13). 코드와 이력은 grpc-library repo에 filter-repo로 옮겼다(옮긴 폴더의 트리 해시가 이 기준 커밋 22df3525와 같다). 지운 것: - src/platforms/grpc, grpc-advanced, optional-build(343파일) - registry의 "build": "optional-grpc" 9행 - ci-quality-gates.yml job optional-platforms·grpc-proto-buf와 그 needs, integration-main.yml optional 성능 단계와 job grpc-optional-platform-integration, release.yml job grpc-stable-release-gate와 이미지 job의 needs 한 줄 - build-logic ca.grpc-platform-module·ca.optional-architecture-registry, MainBuild(두 번째 빌드에서 주 빌드를 찾던 것)와 ArchitecturePlugin의 optional 분기. 도구 설정·이미지 목록·registry는 Gradle 루트에서 찾는다 - 카탈로그 protobufPlugin·protobuf-java-grpc·protoc·plugin protobuf(Q14: 채택 전이라 grpc-library 좌표도 넣지 않는다), SpotBugs 제외의 gRPC 줄 - 옮긴 문서: ADR-GRPC 7개, docs/compatibility/(폴더째), gRPC runbook 둘, gRPC 설계서. 리뷰·기록 본문은 고치지 않았다(Q15). 기록 하나의 머리 블록 「현재 정본」만 새 자리를 말하게 했다 - DeveloperExperienceContractTest의 optional 빌드 lane 계약 시험, adopter API 표면 검사의 optional-build 제외 경로 남긴 것: adapter:inbound:grpc(io.grpc를 직접 쓰고 플랫폼을 쓰지 않는다), src/platforms/messaging(다음 분리 작업), registry의 build 칸 지원 (ModuleRegistry, 일반 기능). 살아 있는 문서: README, docs 지도, capability-status, work/delegate· gates·decisions(새 행 「라이브러리 repo」)·defect-patterns· review-criteria(경계 밖 파일을 경로로 읽는 결합을 결함 후보로), manual 04, jpa migration-guide, build-logic AGENTS·README, testkit 주석. 새 docs/work/reference/related-repos.md가 라이브러리 repo 목록과 같이 고치는 법을 둔다. 파생 서비스 안내는 docs/upgrade 3.8절 B-55·B-56. 위험: 파생 서비스가 이 경로를 고쳤으면 수정 대 삭제 충돌이 난다 (tech-log-backend는 플랫폼을 받은 적이 없다, 설계 12절). 분리 직전 커밋 태그 pre-library-split(설계 12.2절)은 이 브랜치 권한 밖이라 달지 않았다. 검증: desktop 게이트 결과는 PR 본문(ci, mainCheck 계열, releaseCheck, compose smoke, 빠른 시작). 문서 검사 셋 rc=0. BREAKING CHANGE: src/platforms/grpc*·optional-build, :grpc:*·:grpc-advanced:* 프로젝트, ca.grpc-platform-module, 카탈로그 protoc·protobuf-java-grpc·plugin protobuf가 없다. 쓰던 서비스는 grpc-library 좌표 com.hyeonworks.grpc로 받는다(docs/upgrade/2026-11-maturity-review.md 3.8절). Refs: design-docs repo-structure/05-library-repos.md 13.1절 1·2단계
558 lines
32 KiB
Groovy
558 lines
32 KiB
Groovy
plugins {
|
|
id 'ca.spring-library'
|
|
id 'ca.spring-config'
|
|
id 'org.springframework.boot'
|
|
id 'ca.config-contract'
|
|
id 'ca.bootrun-dotenv'
|
|
}
|
|
|
|
// Application entry point. Wires the default runtime module set and runs Spring Boot.
|
|
// Optional leaves require an explicit registry allowance plus a composition-root dependency.
|
|
// The infrastructure lane. Testcontainers-backed tests boot a real PostgreSQL, so they belong to a
|
|
// source set of their own rather than to `test`: the ordinary focused command for this leaf —
|
|
// `./gradlew :app-bootstrap:test` — must not require a Docker daemon, and a leaf whose fastest
|
|
// feedback loop starts a database is a leaf nobody runs the fast loop on. This is the same shape
|
|
// persistence-jpa, web, websocket and objectstorage already use, declared through the repository's
|
|
// own strictTestLanes DSL rather than by hand.
|
|
// The suites see main (and two of them the test classes) as class directories rather than through
|
|
// `implementation project()`: this is a Spring Boot application project, and its lanes have always
|
|
// run on main's output, not on the plain jar.
|
|
testing {
|
|
suites {
|
|
integrationTest(JvmTestSuite)
|
|
architectureTest(JvmTestSuite)
|
|
// No test runtime and no inherited test dependencies: the full-boot lane runs on the
|
|
// composition bootJar packages (see the configurations block below).
|
|
systemTest(JvmTestSuite)
|
|
}
|
|
}
|
|
configurations {
|
|
integrationTestImplementation.extendsFrom testImplementation
|
|
integrationTestCompileOnly.extendsFrom testCompileOnly
|
|
integrationTestRuntimeOnly.extendsFrom testRuntimeOnly
|
|
integrationTestAnnotationProcessor.extendsFrom testAnnotationProcessor
|
|
architectureTestImplementation.extendsFrom testImplementation
|
|
architectureTestCompileOnly.extendsFrom testCompileOnly
|
|
architectureTestRuntimeOnly.extendsFrom testRuntimeOnly
|
|
architectureTestAnnotationProcessor.extendsFrom testAnnotationProcessor
|
|
systemTestAnnotationProcessor.extendsFrom testAnnotationProcessor
|
|
}
|
|
sourceSets {
|
|
integrationTest {
|
|
compileClasspath += main.output
|
|
runtimeClasspath += main.output
|
|
}
|
|
architectureTest {
|
|
compileClasspath += main.output + test.output
|
|
}
|
|
systemTest {
|
|
compileClasspath += main.output + test.output
|
|
runtimeClasspath += main.output + test.output
|
|
}
|
|
}
|
|
|
|
strictTestLanes {
|
|
lane('integrationTest') {
|
|
integration()
|
|
description = 'Runs composition-root integration checks against real required providers.'
|
|
sourceSet = 'integrationTest'
|
|
requires 'dev.caskeleton.bootstrap.integration.fileserver.FileserverCompositionIntegrationTest'
|
|
requires 'dev.caskeleton.bootstrap.integration.objectstorage.ObjectStorageCompositionIntegrationTest'
|
|
requires 'dev.caskeleton.bootstrap.integration.idempotency.PostgreSqlIdempotencyProviderIntegrationTest'
|
|
requires 'dev.caskeleton.bootstrap.integration.operation.DurableOperationCompositionIntegrationTest'
|
|
}
|
|
lane('architectureTest') {
|
|
architecture()
|
|
description = 'Runs the whole-repository ArchUnit and architecture contract source set.'
|
|
sourceSet = 'architectureTest'
|
|
maxHeapSize = '2g'
|
|
shouldRunAfter 'test'
|
|
}
|
|
lane('systemTest') {
|
|
system()
|
|
description = 'Runs full-application startup and shipped-profile characterization tests.'
|
|
sourceSet = 'systemTest'
|
|
maxHeapSize = '1g'
|
|
shouldRunAfter 'test'
|
|
}
|
|
lane('conditionalTransportBuildContractTest') {
|
|
description = 'Proves the explicit test-only GraphQL/gRPC/WebSocket opt-in classpath.'
|
|
sourceSet = 'conditionalTransportBuildContractTest'
|
|
requires 'dev.caskeleton.bootstrap.transport.ConditionalTransportBuildContractTest'
|
|
rejectSkipped = true
|
|
shouldRunAfter 'test'
|
|
}
|
|
}
|
|
|
|
tasks.named('check') {
|
|
dependsOn tasks.named('systemTestLaneCheck')
|
|
}
|
|
|
|
// architectureTest runs on the `test` runtime plus its own configuration, so the capability leaves
|
|
// declared `architectureTestRuntimeOnly` reach the whole-repository ArchUnit import without reaching
|
|
// the default composition that `test` and `systemTest` boot. Its compile classpath (test fixtures,
|
|
// testCompileOnly analysis dependencies) is deliberately not its runtime.
|
|
sourceSets.architectureTest.runtimeClasspath = sourceSets.architectureTest.output +
|
|
sourceSets.test.runtimeClasspath + configurations.architectureTestRuntimeClasspath
|
|
|
|
// The full-boot lane boots the composition bootJar packages. It compiles against everything the
|
|
// test lane sees, but it runs on the main runtime graph plus the test frameworks — not on the test
|
|
// lane's extra modules (persistence-jpa, the slice-test starters).
|
|
// A module on the classpath is on, and the shipped artifact contains none of those, so running the
|
|
// full boot on the test classpath would open a pool the artifact cannot open.
|
|
configurations {
|
|
systemTestCompileOnly.extendsFrom testImplementation, testCompileOnly
|
|
systemTestImplementation.extendsFrom implementation
|
|
systemTestRuntimeOnly.extendsFrom runtimeOnly
|
|
}
|
|
dependencies {
|
|
systemTestImplementation 'org.junit.jupiter:junit-jupiter'
|
|
systemTestImplementation 'org.assertj:assertj-core'
|
|
systemTestImplementation 'org.springframework.boot:spring-boot-starter-test'
|
|
systemTestRuntimeOnly 'org.junit.platform:junit-platform-launcher'
|
|
}
|
|
|
|
sourceSets {
|
|
conditionalTransportBuildContractTest {
|
|
java.srcDir 'src/conditionalTransportBuildContractTest/java'
|
|
resources.srcDir 'src/conditionalTransportBuildContractTest/resources'
|
|
compileClasspath += sourceSets.main.output
|
|
runtimeClasspath += sourceSets.main.output
|
|
}
|
|
}
|
|
|
|
// Every capability a service can select — the commented runtimeOnly lines below — listed once.
|
|
// Three consumers read it — the environment contract's metadata classpath (verifyEnvKeys, below)
|
|
// and these two: the whole-repository ArchUnit import (spec §7: the architecture suite sees
|
|
// every module of this build, the shipped runtime only the selected ones) and the qualification artifact the
|
|
// Compose lanes boot (qualificationBootJar, below). None of them reaches `bootJar`, `test` or
|
|
// `systemTest`, because a capability on a classpath is switched on there by its mere presence.
|
|
// A new capability leaf is added here and as a commented line below; nowhere else.
|
|
def capabilityProjects = [
|
|
':adapter:outbound:persistence-jpa',
|
|
':adapter:outbound:cache-redis',
|
|
':adapter:outbound:messaging-kafka',
|
|
':adapter:outbound:persistence-mongo',
|
|
':adapter:inbound:graphql',
|
|
':adapter:outbound:httpclient',
|
|
':adapter:outbound:objectstorage',
|
|
':adapter:inbound:websocket',
|
|
':adapter:inbound:grpc',
|
|
':composition:fileserver-platform',
|
|
':composition:notification-platform',
|
|
]
|
|
|
|
dependencies {
|
|
implementation project(':domain-core')
|
|
implementation project(':application-core')
|
|
// Test sources name the JPA capability types (the JPA rule pack, the persistence failure
|
|
// contract). Test scope only: systemTest runs on the main runtime graph, so the full-boot lane
|
|
// still boots the composition this build ships.
|
|
testImplementation project(':adapter:outbound:persistence-jpa')
|
|
integrationTestImplementation project(':adapter:outbound:persistence-jpa')
|
|
|
|
// 이 서비스가 쓰는 부가 기능 — 필요한 줄의 주석을 푼다.
|
|
// 각 모듈은 있으면 켜지고(자기 AutoConfiguration.imports와 설정 기본값을 가진다), 줄을 지우면
|
|
// 기능·설정·의존성이 함께 빠진다. 켠 뒤 필요한 env 키는 각 모듈 README에 있다.
|
|
// 줄을 바꾼 뒤 strict lock을 갱신한다: ./gradlew :app-bootstrap:resolveAndLockAll --write-locks
|
|
// runtimeOnly project(':adapter:outbound:persistence-jpa') // JPA·Flyway·outbox·lock
|
|
// runtimeOnly project(':adapter:outbound:cache-redis') // Redis (캐시·rate limit·idempotency)
|
|
// runtimeOnly project(':adapter:outbound:messaging-kafka') // Kafka 발행
|
|
// runtimeOnly project(':adapter:outbound:persistence-mongo') // Mongo
|
|
// runtimeOnly project(':adapter:inbound:graphql') // GraphQL
|
|
// runtimeOnly project(':adapter:outbound:httpclient') // 외부 HTTP 호출
|
|
// runtimeOnly project(':adapter:outbound:objectstorage') // 객체 저장소 (S3/로컬)
|
|
// runtimeOnly project(':adapter:inbound:websocket') // WebSocket (STOMP push)
|
|
// runtimeOnly project(':adapter:inbound:grpc') // gRPC 서버
|
|
// runtimeOnly project(':composition:fileserver-platform') // 파일 서버
|
|
// runtimeOnly project(':composition:notification-platform') // 알림 (persistence-jpa·persistence-notification을 함께 가져온다)
|
|
|
|
// 기본 조립에 있는 application composition. 셋 다 포트만 보고, 필요한 것(outbox store, 멱등성
|
|
// provider)이 없으면 아무것도 만들지 않는다.
|
|
runtimeOnly project(':composition:outbox-relay') // outbox relay (store·발행 포트가 있을 때만)
|
|
runtimeOnly project(':composition:idempotency') // 요청 멱등성 executor (provider≠disabled)
|
|
runtimeOnly project(':composition:durable-operation') // /operations (operation store·outbox가 있을 때만)
|
|
// 모든 서비스가 받는 runtime 배선: tracing, metrics 계약 filter, domain context, user principal
|
|
// 가명화, actuator 보안 chain.
|
|
runtimeOnly project(':composition:service-runtime')
|
|
// Contract tests pin those pieces by type (tracing gauge, metrics filters, actuator chain).
|
|
testImplementation project(':composition:service-runtime')
|
|
integrationTestImplementation project(':composition:service-runtime')
|
|
|
|
capabilityProjects.each { architectureTestRuntimeOnly project(it) }
|
|
|
|
// The capability integration lane selects Fileserver and object storage together, as a service
|
|
// would, and turns off whichever one a test is not about.
|
|
integrationTestImplementation project(':composition:fileserver-platform')
|
|
integrationTestImplementation project(':adapter:inbound:web-fileserver')
|
|
// PostgreSqlIdempotencyProviderIntegrationTest composes the executor module over the real store.
|
|
integrationTestImplementation project(':composition:idempotency')
|
|
|
|
testImplementation(testFixtures(project(':adapter:outbound:persistence-jpa')))
|
|
testImplementation(testFixtures(project(':adapter:inbound:web')))
|
|
// The idempotency composition tests drive the executor over the port owner's shared fake store.
|
|
testImplementation(testFixtures(project(':application-core')))
|
|
// A feature's composition test registers the domain ports' fakes (scripts/new-feature.sh).
|
|
testImplementation(testFixtures(project(':domain-core')))
|
|
testImplementation(testFixtures(project(':shared-contract')))
|
|
// The opt-in web library is in no shipped composition. Runtime-only for the tests so the
|
|
// whole-repository ArchUnit import (architectureTest runs on the test runtime classpath) still
|
|
// reads its classes; no test source may name one of its types. It cannot reach a shipped
|
|
// composition: no module in modules.json may depend on it, so the direction gate refuses the edge.
|
|
testRuntimeOnly project(':adapter:inbound:web-advanced')
|
|
implementation project(':adapter:outbound:support')
|
|
implementation project(':adapter:outbound:identifier')
|
|
implementation project(':adapter:inbound:web')
|
|
implementation project(':shared-contract')
|
|
implementation 'org.springframework.boot:spring-boot-starter'
|
|
implementation 'org.springframework.boot:spring-boot-starter-validation'
|
|
implementation libs.spring.dotenv
|
|
// Micrometer core for the bootstrap meters (no-op without a MeterRegistry). See README.
|
|
implementation 'io.micrometer:micrometer-core'
|
|
|
|
// The Micrometer Tracing API the tracing contract tests name. The tracer runtime itself — Boot's
|
|
// tracing auto-configuration and the OTLP exporter — is composition:service-runtime's.
|
|
implementation 'io.micrometer:micrometer-tracing-bridge-otel'
|
|
|
|
// Actuator + Prometheus registry (health/info/prometheus/loggers endpoints).
|
|
implementation 'org.springframework.boot:spring-boot-starter-actuator'
|
|
implementation 'io.micrometer:micrometer-registry-prometheus'
|
|
// Spring Security on the runtime graph (the actuator chain itself is composition:service-runtime's). See README.
|
|
implementation 'org.springframework.boot:spring-boot-starter-security'
|
|
|
|
// test-only: ArchUnit needs actuator types to verify the health-shape guardrail. See README.
|
|
testImplementation 'org.springframework.boot:spring-boot-starter-actuator'
|
|
// test-only: @WithMockUser for the actuator security authorization tests. See README.
|
|
testImplementation 'org.springframework.security:spring-security-test'
|
|
|
|
// integration-lane-only: Testcontainers PostgreSQL. Declared here and NOT on testImplementation
|
|
// so `:app-bootstrap:test` cannot start a container — the source-set boundary is what enforces
|
|
// BOOT-014, and a dependency left on the test classpath would let the boundary be crossed back
|
|
// by a single import.
|
|
integrationTestImplementation project(':adapter:outbound:objectstorage')
|
|
integrationTestImplementation project(':application-objectstorage')
|
|
// objectstorage intentionally imports the AWS SDK BOM only at its own module scope. This
|
|
// qualification composition consumes the leaf from a separate source set, so it repeats the
|
|
// platform here rather than widening app-bootstrap's production dependency-management surface.
|
|
integrationTestImplementation platform("software.amazon.awssdk:bom:${libs.versions.awsSdk.get()}")
|
|
integrationTestImplementation 'org.testcontainers:testcontainers'
|
|
integrationTestImplementation 'org.testcontainers:testcontainers-postgresql'
|
|
integrationTestImplementation 'org.testcontainers:testcontainers-junit-jupiter'
|
|
// test-only, compile-only: TestcontainersUsingFixture declares a PostgreSQLContainer *field type*
|
|
// as the non-vacuity positive control for the Testcontainers-ban ArchUnit rule. ClassFileImporter
|
|
// reads its bytecode without resolving or constructing the field, so the type is never needed at
|
|
// runtime — the same compileOnly shape the other violation fixtures use.
|
|
testCompileOnly 'org.testcontainers:testcontainers-postgresql'
|
|
// test-only: Boot 4 split JPA slice annotations into dedicated test modules.
|
|
testImplementation 'org.springframework.boot:spring-boot-data-jpa-test'
|
|
// test-only: PG JDBC driver (the vendor module's runtimeOnly does not leak here). See README.
|
|
testRuntimeOnly 'org.postgresql:postgresql'
|
|
// test-only: Boot's relational auto-configuration types, which a few context tests exclude by name.
|
|
testImplementation 'org.springframework.boot:spring-boot-starter-data-jpa'
|
|
testImplementation 'org.springframework.boot:spring-boot-flyway'
|
|
// The integration lane drives Flyway itself and names Boot's Flyway auto-configuration.
|
|
integrationTestImplementation 'org.springframework.boot:spring-boot-flyway'
|
|
integrationTestImplementation 'org.flywaydb:flyway-core'
|
|
testImplementation 'com.zaxxer:HikariCP'
|
|
|
|
testImplementation libs.archunit.junit5
|
|
// test-only: jackson-databind for the deserialization-policy boundary test. See README.
|
|
testImplementation 'org.springframework.boot:spring-boot-starter-json'
|
|
// test-only: parses the checked-in YAML registries (error codes and the like) in contract tests.
|
|
testImplementation 'org.yaml:snakeyaml'
|
|
// test-only: ArchUnit violation fixtures intentionally import forbidden types. See README.
|
|
testCompileOnly 'org.springframework:spring-tx'
|
|
// test-only: streaming/websocket violation fixtures import these forbidden packages. See README.
|
|
testCompileOnly 'org.springframework:spring-webmvc' // SseEmitter, ResponseBodyEmitter, StreamingResponseBody
|
|
testCompileOnly 'org.springframework:spring-websocket' // org.springframework.web.socket..
|
|
testCompileOnly 'jakarta.websocket:jakarta.websocket-api' // jakarta.websocket..
|
|
// architecture-only: positive-control fixture imports Kafka TopicPartition to prove domain code
|
|
// cannot depend on broker SDK types. The shipped main/test compile classpaths must not inherit it.
|
|
architectureTestCompileOnly 'org.apache.kafka:kafka-clients'
|
|
// architecture-only: the system-caller fixture for the `graphql..` entry of the user-transport
|
|
// type list is a raw graphql-java data fetcher. The adapter brings graphql-java onto this source
|
|
// set's runtime already (capabilityProjects); compile-only here so no shipped graph changes.
|
|
architectureTestCompileOnly 'com.graphql-java:graphql-java'
|
|
// architecture-only: the STOMP fixtures for the channel-interceptor entries of the user-transport
|
|
// type list implement spring-messaging's ChannelInterceptor. The websocket adapter brings it onto
|
|
// this source set's runtime already (capabilityProjects); compile-only here so no shipped graph
|
|
// changes.
|
|
architectureTestCompileOnly 'org.springframework:spring-messaging'
|
|
// Kafka producer ownership lives in adapter:outbound:messaging. The composition root sees only
|
|
// the adapter module; it no longer implements the broker seam itself.
|
|
testCompileOnly 'jakarta.ws.rs:jakarta.ws.rs-api' // jakarta.ws.rs..
|
|
// test-only: @RefreshScope for the no-refresh-scope violation fixture (version pinned; not in the BOM). See README.
|
|
testCompileOnly libs.spring.cloud.context // org.springframework.cloud.context..
|
|
// analysis-only: SpotBugs resolves the full type hierarchy of everything on the auxiliary
|
|
// classpath, and spring-beans/spring-context/spring-web each ship an optional Groovy integration
|
|
// class (GroovyBeanDefinitionReader, GenericGroovyApplicationContext, GroovyWebApplicationContext).
|
|
// Groovy itself is optional to Spring and absent here, so the analysis reported "missing class
|
|
// groovy.lang.GroovyObject" and verifySpotBugsAnalysisFailureContract failed closed — correctly,
|
|
// since an incomplete analysis finds fewer bugs while still reporting success. It surfaced when
|
|
// the messaging platform's leaves widened the classpath enough to reach those classes.
|
|
//
|
|
// compileOnly, so it resolves for analysis and reaches no runtime.
|
|
testCompileOnly 'org.apache.groovy:groovy' // groovy.lang.GroovyObject
|
|
|
|
// JSON log encoder; implementation (not runtimeOnly) because StartupFailures uses StructuredArguments at compile time. See README.
|
|
implementation libs.logstash.logback.encoder
|
|
|
|
// test-only: ApprovalTests JSON snapshot verification for the contract-verification suite
|
|
// (feature-contract-verification-test-suite D7 — envelope/error shape snapshots). See README.
|
|
testImplementation libs.approvaltests
|
|
// test-only: JUnit Platform Test Kit — proves optional-adapter tests report SKIPPED (never FAILED)
|
|
// when their enable-flag env var is unset (feature-contract-verification-test-suite D3, Claims #7). See README.
|
|
testImplementation 'org.junit.platform:junit-platform-testkit'
|
|
// Explicit qualification-only composition. These projects remain absent from main
|
|
// api/implementation/compileOnly/runtimeOnly and therefore from both shipped runtime graphs.
|
|
conditionalTransportBuildContractTestImplementation project(':adapter:inbound:graphql')
|
|
conditionalTransportBuildContractTestImplementation project(':adapter:inbound:grpc')
|
|
conditionalTransportBuildContractTestImplementation project(':adapter:inbound:websocket')
|
|
conditionalTransportBuildContractTestImplementation 'org.junit.jupiter:junit-jupiter'
|
|
conditionalTransportBuildContractTestImplementation 'org.assertj:assertj-core'
|
|
conditionalTransportBuildContractTestImplementation 'org.yaml:snakeyaml'
|
|
conditionalTransportBuildContractTestRuntimeOnly 'org.junit.platform:junit-platform-launcher'
|
|
}
|
|
|
|
// Tests that read the repository itself — registries, runbooks, guidance documents, build scripts,
|
|
// workflows, Compose files, other leaves' sources — run in two tagged lanes, and only those lanes
|
|
// receive the repository root (`ca.repository.root`) and declare what they read as inputs. The plain
|
|
// `test` lane gets neither: a repository-reading test left untagged fails there for want of a root
|
|
// instead of turning `test` into a task that every document edit invalidates (review 2026-11-01
|
|
// 08-03; the inputs are what keeps O-4a's "the lane reruns when a file it reads changes").
|
|
//
|
|
// documentContractTest tag document-contract main stage docs/**, the guidance documents,
|
|
// and the files the same classes
|
|
// cross-check them with
|
|
// repositoryContractTest tag repository-contract pull request build, configuration, workflow and
|
|
// Compose files and leaf sources;
|
|
// no document, so a docs/** edit
|
|
// leaves it up to date
|
|
//
|
|
// The pull-request lane exists because some of those contracts are release and security
|
|
// properties — the signing job's OIDC scope, the Docker staging contract, the request-logging body
|
|
// capture ban — that must stop a merge, not be found after one.
|
|
def repositoryRootForContractTests = rootProject.projectDir.parentFile
|
|
def repositoryContractExcludes = ['**/build/**', '**/.gradle/**', '**/node_modules/**']
|
|
def repositoryContractInputs = files(
|
|
fileTree(repositoryRootForContractTests) {
|
|
include '.github/**', 'compose/**', 'scripts/**', '*.yml', '*.yaml', '*.example', '.tool-versions'
|
|
exclude '**/*.md'
|
|
exclude repositoryContractExcludes
|
|
},
|
|
fileTree(rootProject.projectDir) {
|
|
include 'config/**', '**/*.gradle', 'gradle/*.toml', 'Dockerfile*', '.env*', '**/src/main/**'
|
|
// The compose lane fixtures this leaf owns (the lane contract, overlays, smoke clients).
|
|
include 'app-bootstrap/compose-lanes/**'
|
|
// The release data a capability leaf owns (readiness cards, release registries).
|
|
include 'adapter/outbound/*/release/**'
|
|
exclude '**/*.md'
|
|
exclude repositoryContractExcludes
|
|
})
|
|
def documentContractInputs = files(
|
|
repositoryContractInputs,
|
|
fileTree(repositoryRootForContractTests) {
|
|
include 'docs/**', '*.md', '.github/**/*.md'
|
|
},
|
|
fileTree(rootProject.projectDir) {
|
|
include '**/*.md'
|
|
exclude repositoryContractExcludes
|
|
})
|
|
strictTestLanes {
|
|
lane('documentContractTest') {
|
|
tag = 'document-contract'
|
|
description = 'Holds the composition to the repository documents and registries it promises.'
|
|
rejectSkipped = true
|
|
mainStage()
|
|
systemProperty 'ca.repository.root', repositoryRootForContractTests.absolutePath
|
|
customize { Test task ->
|
|
task.inputs.files(documentContractInputs)
|
|
.withPathSensitivity(PathSensitivity.RELATIVE)
|
|
.withPropertyName('documentContractInputs')
|
|
}
|
|
}
|
|
lane('repositoryContractTest') {
|
|
tag = 'repository-contract'
|
|
description = 'Holds the composition to the build, configuration and workflow files it does not own.'
|
|
systemProperty 'ca.repository.root', repositoryRootForContractTests.absolutePath
|
|
customize { Test task ->
|
|
task.inputs.files(repositoryContractInputs)
|
|
.withPathSensitivity(PathSensitivity.RELATIVE)
|
|
.withPropertyName('repositoryContractInputs')
|
|
}
|
|
}
|
|
}
|
|
tasks.named('test', Test) {
|
|
useJUnitPlatform { excludeTags 'repository-contract' }
|
|
}
|
|
tasks.named('check') {
|
|
dependsOn 'repositoryContractTest'
|
|
}
|
|
|
|
// The other suites find the repository themselves and read what Gradle cannot otherwise see: the
|
|
// architecture suite scans every leaf's production sources and its own rule sources as text, the
|
|
// opt-in classpath contract reads this build script, and the Compose characterization reads the
|
|
// Compose files.
|
|
tasks.named('architectureTest', Test) {
|
|
inputs.files(fileTree(rootProject.projectDir) {
|
|
include '**/src/main/java/**/*.java', 'app-bootstrap/src/architectureTest/java/**'
|
|
exclude repositoryContractExcludes
|
|
}).withPathSensitivity(PathSensitivity.RELATIVE).withPropertyName('scannedSources')
|
|
}
|
|
tasks.named('conditionalTransportBuildContractTest', Test) {
|
|
inputs.file('build.gradle').withPathSensitivity(PathSensitivity.RELATIVE).withPropertyName('buildScript')
|
|
}
|
|
tasks.named('integrationTest', Test) {
|
|
inputs.files(fileTree(repositoryRootForContractTests) {
|
|
include 'compose.yaml', 'compose/**', 'scripts/*compose*.sh', 'src/app-bootstrap/compose-lanes/**'
|
|
exclude repositoryContractExcludes
|
|
}).withPathSensitivity(PathSensitivity.RELATIVE).withPropertyName('composeFiles')
|
|
}
|
|
|
|
// Fast developer test lane. Whole-repository ArchUnit graphs and full composition-root boot
|
|
// characterizations have their own source sets, so the ordinary lane does not compile or execute
|
|
// them. CI still runs both through architectureCheck / qualificationCheck.
|
|
tasks.named('test', Test) {
|
|
// Two forks are the measured sweet spot after moving whole-repository ArchUnit and full boot
|
|
// composition tests out of the fast lane. More forks duplicate Spring contexts for little gain.
|
|
maxParallelForks = 2
|
|
}
|
|
|
|
|
|
bootJar {
|
|
mainClass = 'dev.caskeleton.bootstrap.CaSkeletonApplication'
|
|
}
|
|
|
|
// The deployable artifact names the release and the commit it was built from in
|
|
// META-INF/build-info.properties (review BUILD-O3-5: provenance through Spring Boot's build info
|
|
// rather than a revision in every leaf's jar name). `time` is excluded so an unchanged commit still
|
|
// produces an unchanged resource and cached tasks stay cached.
|
|
springBoot {
|
|
buildInfo {
|
|
excludes = ['time']
|
|
properties {
|
|
additional = ['revision': project.sourceRevision] // set by ca.java-conventions
|
|
}
|
|
}
|
|
}
|
|
|
|
// The deny-by-default public path baseline (docs/security/public-paths-snapshot.txt) is an approval
|
|
// test beside the security configuration it pins, not a build-logic plugin (review BUILD-O3-5). The
|
|
// root `verifyPublicPathSnapshot` names this lane; `-PapprovePublicPathChange` rewrites the baseline
|
|
// after review instead of comparing it.
|
|
strictTestLanes {
|
|
lane('publicPathSnapshotTest') {
|
|
tag = 'public-path-snapshot'
|
|
description = 'Compares the shipped public path default with the reviewed baseline.'
|
|
rejectSkipped = true
|
|
mainStage()
|
|
systemProperty 'publicpath.snapshot.write', project.hasProperty('approvePublicPathChange') ? 'true' : 'false'
|
|
}
|
|
}
|
|
|
|
tasks.register('stageDockerJar', Sync) {
|
|
dependsOn tasks.named('bootJar')
|
|
from(tasks.named('bootJar').flatMap { it.archiveFile })
|
|
into(layout.buildDirectory.dir('docker'))
|
|
rename { 'application.jar' }
|
|
}
|
|
|
|
// A runtime classpath of this composition plus extra leaves, resolved the way Boot resolves
|
|
// runtimeClasspath. Used by the H2 convenience below and by the qualification artifact.
|
|
def compositionRuntimeClasspath = { String name ->
|
|
configurations.create(name) {
|
|
canBeConsumed = false
|
|
canBeResolved = true
|
|
extendsFrom configurations.implementation, configurations.runtimeOnly
|
|
attributes {
|
|
attribute(Usage.USAGE_ATTRIBUTE, objects.named(Usage, Usage.JAVA_RUNTIME))
|
|
attribute(Category.CATEGORY_ATTRIBUTE, objects.named(Category, Category.LIBRARY))
|
|
attribute(LibraryElements.LIBRARY_ELEMENTS_ATTRIBUTE, objects.named(LibraryElements, LibraryElements.JAR))
|
|
attribute(Bundling.BUNDLING_ATTRIBUTE, objects.named(Bundling, Bundling.EXTERNAL))
|
|
}
|
|
}
|
|
}
|
|
|
|
// The qualification artifact: this composition with every capability on the classpath. It is what
|
|
// the Compose lanes (compose-lanes/compose-profile-contracts.json) boot, because a lane that turns
|
|
// JPA or Kafka on needs the module in the image, and `bootJar` — the default composition a service
|
|
// ships — carries none of them. It is never released: `release.yml` builds `stageDockerJar`.
|
|
// Each capability is on while present, so a lane switches off what it is not about.
|
|
def qualificationClasspath = compositionRuntimeClasspath('qualificationRuntimeClasspath')
|
|
dependencies {
|
|
capabilityProjects.each { qualificationRuntimeClasspath project(it) }
|
|
}
|
|
// The environment contract reads every selectable capability's configuration metadata from this
|
|
// classpath, so a module that ships typed settings is checked because it can be selected, and the
|
|
// task names no leaf (review 2026-11-03 RR-06-10).
|
|
tasks.named('verifyEnvKeys') {
|
|
metadataClasspath.from(qualificationClasspath)
|
|
}
|
|
def qualificationBootJar = tasks.register('qualificationBootJar', org.springframework.boot.gradle.tasks.bundling.BootJar) {
|
|
group = 'build'
|
|
description = 'Assembles the Compose qualification jar: the default composition plus every capability.'
|
|
mainClass = 'dev.caskeleton.bootstrap.CaSkeletonApplication'
|
|
classpath = sourceSets.main.output + qualificationClasspath
|
|
resolvedArtifacts(qualificationClasspath.incoming.artifacts.resolvedArtifacts)
|
|
targetJavaVersion = java.targetCompatibility
|
|
archiveClassifier = 'qualification'
|
|
}
|
|
// Same staging path as stageDockerJar, so src/Dockerfile's extract step is one path; its
|
|
// COMPOSITION build argument picks which of the two tasks writes it.
|
|
tasks.register('stageQualificationDockerJar', Sync) {
|
|
dependsOn qualificationBootJar
|
|
from(qualificationBootJar.flatMap { it.archiveFile })
|
|
into(layout.buildDirectory.dir('docker'))
|
|
rename { 'application.jar' }
|
|
}
|
|
|
|
// `ca.bootrun-dotenv` owns root working-directory and .env injection for bootRun.
|
|
// Boot 4 initializes profiles/logging before spring-dotenv can reliably contribute these values.
|
|
|
|
// JPA-INT-003 — the H2 developer convenience, which now has to be asked for by name.
|
|
//
|
|
// `local` used to default to H2, so "it works locally" was a statement about a different database
|
|
// from the one every other environment runs: Flyway never applied, ddl-auto wrote the schema from
|
|
// the entities, and a mapping that disagreed with the migration tree could not be discovered until a
|
|
// real PostgreSQL saw it. It was not discovered, twice, until a Compose lane did — fs_cleanup_item
|
|
// and idempotency_record.request_hash.
|
|
//
|
|
// So local now defaults to the Compose PostgreSQL and this task is the opt-out. It is deliberately a
|
|
// separate, named task rather than a property: choosing a datastore whose schema comes from
|
|
// somewhere else should look like a choice in the command somebody typed. It is not part of `check`,
|
|
// `build`, or any release lane.
|
|
//
|
|
// H2 needs relational persistence, which this composition does not ship, so the task adds the
|
|
// module to its own classpath. The artifact is unchanged; choosing H2 is still a choice in the
|
|
// command somebody typed.
|
|
def h2RunClasspath = compositionRuntimeClasspath('bootRunH2Classpath')
|
|
dependencies {
|
|
bootRunH2Classpath project(':adapter:outbound:persistence-jpa')
|
|
// The driver is not a runtime dependency of persistence-jpa (review 09-09), so the task that
|
|
// chose H2 brings it.
|
|
bootRunH2Classpath 'com.h2database:h2'
|
|
}
|
|
tasks.register('bootRunH2', org.springframework.boot.gradle.tasks.run.BootRun) {
|
|
group = 'application'
|
|
description = 'Runs the application on an in-memory H2, for development without a container. ' +
|
|
'Not a release lane: H2 has no migration tree and Hibernate owns its schema.'
|
|
classpath = sourceSets.main.output + h2RunClasspath
|
|
mainClass = 'dev.caskeleton.bootstrap.CaSkeletonApplication'
|
|
workingDir = rootProject.projectDir
|
|
environment 'SPRING_PROFILES_ACTIVE', 'local'
|
|
// A .env copied before the module became opt-in may still say false.
|
|
environment 'APP_PERSISTENCE_JPA_ENABLED', 'true'
|
|
environment 'APP_PERSISTENCE_VENDOR', 'h2'
|
|
environment 'APP_DATASOURCE_URL',
|
|
'jdbc:h2:mem:ca_skeleton;MODE=PostgreSQL;DATABASE_TO_LOWER=TRUE;DB_CLOSE_DELAY=-1'
|
|
environment 'APP_DATASOURCE_USERNAME', 'sa'
|
|
environment 'APP_DATASOURCE_PASSWORD', ''
|
|
environment 'APP_DATASOURCE_DRIVER', 'org.h2.Driver'
|
|
// Both are load-bearing for H2 and wrong everywhere else: the migration tree is PostgreSQL DDL,
|
|
// and DB_CLOSE_DELAY=-1 above is what keeps the in-memory schema alive when the pool goes idle.
|
|
environment 'APP_FLYWAY_ENABLED', 'false'
|
|
environment 'APP_DATASOURCE_DDL_AUTO', 'create-drop'
|
|
// The PostgreSQL idempotency store refuses H2, and a .env copied from .env.example may select it.
|
|
environment 'APP_IDEMPOTENCY_PROVIDER', 'disabled'
|
|
}
|