Files
clean-architecture-backend-…/config/checkstyle/checkstyle-suppressions.xml
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

33 lines
1.8 KiB
XML

<?xml version="1.0"?>
<!DOCTYPE suppressions PUBLIC
"-//Checkstyle//DTD SuppressionFilter Configuration 1.2//EN"
"https://checkstyle.org/dtds/suppressions_1_2.dtd">
<!--
feature-static-analysis-quality-contract D2 / §3 — Checkstyle suppression filter.
Narrowly-scoped relaxations only. The contract keeps naming + logical rules
blocking on main source; this file carves out documented tool-contract exceptions.
-->
<suppressions>
<!-- ApprovalTests discovers this package setting by exact public static field name. -->
<suppress checks="StaticVariableName"
files="[\\/]src[\\/]test[\\/]java[\\/]dev[\\/]caskeleton[\\/]bootstrap[\\/]contract[\\/]PackageSettings\.java"/>
<!-- code-conventions I6 outside main source.
OneTopLevelClass and OuterTypeFilename replace the hand-rolled `verifyOneTypePerFile`
Gradle task, which read `src/main/java` and nothing else. Applying them to every source set
at the same time would be a policy change smuggled in as a tool change: 28 OneTopLevelClass
violations and 1 OuterTypeFilename violation exist today, all of them co-located test
fixtures (`...Test.java` holding a `...Fixtures` / `Fake...` / `Recording...` type below the
test class), and none of them in main source — main is clean on both rules, including the
package-private top-level types the old regex could not see.
Extending the rule to test sources is a real question with a real answer either way, and it
belongs to whoever moves those 29 fixtures into their own files or decides they should stay.
The regex matches any src/<sourceSet>/java path whose source set is not `main`. -->
<suppress checks="OneTopLevelClass|OuterTypeFilename"
files="[\\/]src[\\/](?!main[\\/])[^\\/]+[\\/]java[\\/]"/>
</suppressions>