Files
clean-architecture-backend-…/build-logic/src/main/java/dev/caskeleton/buildlogic/apisurface/VerifyApiSurfaceTask.java
T
DongHyeonka 1388c06a9f refactor(layout)!: Gradle 루트와 계층 폴더를 옮긴다(옮기기만)
문제: Gradle 루트가 src/라서 빌드 도구(build-logic, gradle, config, 빌드
파일)가 계층 코드 폴더 옆에 섞여 있다. composition과 app-bootstrap은 같은
조립 계층인데 폴더가 따로이고, application 모듈 넷은 최상위에 흩어져 있다.
「Gradle은 src/에서 실행」이라는 예외 규칙이 모든 문서와 스크립트에 퍼졌다.

고른 방법: 저장소 루트를 Gradle 루트로 하고 src/에는 계층 코드만 둔다
(design-docs repo-structure/01-backend-layout.md 6.1절 가-2·가-3, 소유자
승인 2026-11-07). 이 커밋은 git mv만 한다. 이름 바꾸기 감지가 1541개
파일 모두를 R100으로 잡도록 내용을 바꾸지 않았다. 바뀐 곳은 둘뿐이다:
src/.gitignore의 줄을 루트 .gitignore로 옮겼다.

- 빌드 파일, gradle/, build-logic/ → 저장소 루트
- config/checkstyle·spotbugs → config/ (코드 검사 도구 설정만)
- registry config/architecture/modules.json → gradle/modules.json,
  시험 이미지 config/testing/container-images.properties
  → gradle/container-images.properties, registry 설명 → gradle/README.md
- Dockerfile, .dockerignore, .env*.example → 저장소 루트
- src/README.md(빌드·env 참조) → docs/build.md
- src/domain-core → src/domain/core,
  src/application-* → src/application/*,
  src/app-bootstrap → src/bootstrap/app,
  src/composition/* → src/bootstrap/*
- 기능 생성 템플릿 scripts/feature-scaffold/{templates,probes}/src/ 아래도
  같은 모양으로(domain/core, application/core, bootstrap/app)

위험: 이 커밋만으로는 빌드되지 않는다. 경로를 부르는 곳은 다음 커밋이
고친다. 두 커밋을 나눈 것은 파생 서비스가 merge할 때 이름 바꾸기와 내용
변경을 따로 보게 하려는 것이다.

검증: git diff --cached -M --name-status 에서 R100 1541개, 그 밖은
.gitignore 수정과 src/.gitignore 삭제뿐.

BREAKING CHANGE: 모든 빌드 파일과 계층 폴더의 경로가 바뀐다. 옛 경로 →
새 경로 표와 받는 순서는 docs/upgrade/2026-11-relayout.md에 있다.
Refs: design-docs repo-structure/01-backend-layout.md 6.1절
2026-11-11 21:04:21 +09:00

93 lines
3.3 KiB
Java

package dev.caskeleton.buildlogic.apisurface;
import dev.caskeleton.buildlogic.ApiSurfacePolicy;
import dev.caskeleton.buildlogic.JavaPublicTypes;
import java.io.File;
import java.util.List;
import org.gradle.api.DefaultTask;
import org.gradle.api.GradleException;
import org.gradle.api.file.ConfigurableFileCollection;
import org.gradle.api.file.RegularFileProperty;
import org.gradle.api.provider.ListProperty;
import org.gradle.api.provider.Property;
import org.gradle.api.tasks.Input;
import org.gradle.api.tasks.InputFile;
import org.gradle.api.tasks.InputFiles;
import org.gradle.api.tasks.Internal;
import org.gradle.api.tasks.Optional;
import org.gradle.api.tasks.PathSensitive;
import org.gradle.api.tasks.PathSensitivity;
import org.gradle.api.tasks.TaskAction;
import org.gradle.work.DisableCachingByDefault;
@DisableCachingByDefault(because = "Verification task has no reusable outputs")
public abstract class VerifyApiSurfaceTask extends DefaultTask {
@InputFiles
public abstract ConfigurableFileCollection getSourceRoots();
@Internal
public abstract RegularFileProperty getBaseline();
@Input
public String getBaselinePath() {
return getBaseline().get().getAsFile().getAbsolutePath();
}
@Input public abstract Property<String> getLabel();
@Input public abstract Property<String> getSurfaceDescription();
@Input public abstract ListProperty<String> getRationale();
@Input public abstract Property<String> getOwningProjectPath();
@Input public abstract Property<String> getUpdateTaskName();
@Input public abstract Property<String> getApprovalProperty();
@Input public abstract Property<Boolean> getUpdateApproved();
/** Other leaves' production sources, held to the adopter baseline when one is declared. */
@InputFiles
@PathSensitive(PathSensitivity.RELATIVE)
public abstract ConfigurableFileCollection getAdopterSources();
@Optional
@InputFile
public abstract RegularFileProperty getAdopterBaseline();
@TaskAction
public void verifySurface() {
if (getUpdateApproved().get()) {
throw new GradleException(
getName()
+ " is read-only; use "
+ getUpdateTaskName().get()
+ " to record an approved change.");
}
List<File> roots = getSourceRoots().getFiles().stream().sorted().toList();
try {
String rendered =
ApiSurfacePolicy.render(
roots,
getLabel().get(),
getSurfaceDescription().get(),
getRationale().get(),
getOwningProjectPath().get(),
getUpdateTaskName().get(),
getApprovalProperty().get());
ApiSurfacePolicy.verify(
getName(),
getUpdateTaskName().get(),
getOwningProjectPath().get(),
getApprovalProperty().get(),
getBaseline().get().getAsFile(),
rendered);
if (getAdopterBaseline().isPresent()) {
ApiSurfacePolicy.verifyAdopters(
getName(),
rendered,
getAdopterBaseline().get().getAsFile(),
JavaPublicTypes.imports(getAdopterSources().getFiles()));
}
} catch (IllegalStateException invalidSurface) {
throw new GradleException(invalidSurface.getMessage(), invalidSurface);
}
getLogger().lifecycle("{}: OK — the committed public API surface is unchanged.", getName());
}
}