Files
clean-architecture-backend-…/build-logic/src/main/java/dev/caskeleton/buildlogic/redis/RedisTopologyContract.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

94 lines
3.5 KiB
Java

package dev.caskeleton.buildlogic.redis;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import java.util.Set;
public final class RedisTopologyContract {
private static final Set<String> SUPPORTED_MODES =
Set.of("standalone", "sentinel", "cluster", "tls");
private static final Map<String, String> DEPLOYMENT_MODES =
Map.of(
"standalone", "standalone",
"sentinel", "sentinel",
"cluster", "cluster",
"tls", "standalone");
private RedisTopologyContract() {}
public static String deploymentMode(String declaredMode) {
return DEPLOYMENT_MODES.getOrDefault(declaredMode, declaredMode);
}
public static boolean tlsEnabled(String declaredMode) {
return "tls".equals(declaredMode);
}
public static void validateInvocation(
String declaredMode, Set<String> declaredModes, Set<String> availableProperties) {
if (!SUPPORTED_MODES.contains(declaredMode)) {
List<String> supported = new ArrayList<>(SUPPORTED_MODES);
supported.sort(String::compareTo);
throw new IllegalStateException(
"redisTopologyTest was selected with redis.topology.mode='"
+ declaredMode
+ "'; the supported modes are "
+ String.join(", ", supported)
+ ". An unrecognised mode selects no test and would otherwise report success.");
}
if (!declaredModes.contains(declaredMode)) {
List<String> declared = new ArrayList<>(declaredModes);
declared.sort(String::compareTo);
throw new IllegalStateException(
"redisTopologyTest of this leaf has no "
+ declaredMode
+ " lane; it declares "
+ (declared.isEmpty() ? "none" : String.join(", ", declared))
+ ". Run the leaves that declare it instead of a lane that would execute nothing.");
}
List<String> required = new ArrayList<>(List.of("redis.topology.host", "redis.topology.port"));
if ("sentinel".equals(declaredMode)) {
required.add("redis.topology.master");
}
if ("tls".equals(declaredMode)) {
required.add("redis.topology.trust-material");
}
List<String> missing = required.stream().filter(key -> !availableProperties.contains(key)).toList();
if (!missing.isEmpty()) {
throw new IllegalStateException(
"redisTopologyTest was selected without "
+ String.join(", ", missing)
+ "; start a lane from src/adapter/outbound/redis-sdk/compose and pass -P<key>=<value>.");
}
}
public static void verifyExecution(
String declaredMode,
List<String> requiredClasses,
Set<String> executedClasses,
int skippedCount) {
List<String> absent =
requiredClasses.stream()
.filter(required -> !executedClasses.contains(required))
.toList();
if (!absent.isEmpty()) {
throw new IllegalStateException(
"redisTopologyTest ran the "
+ declaredMode
+ " lane without "
+ String.join(", ", absent)
+ ". These classes are what the lane qualifies; a run that skipped them proves less than the lane claims.");
}
if (skippedCount > 0) {
throw new IllegalStateException(
"redisTopologyTest skipped "
+ skippedCount
+ " test(s) on the "
+ declaredMode
+ " lane. A qualification lane has no conditional coverage: what it cannot prove must not be selected, and what is selected must run.");
}
}
}