refactor(layout)!: Gradle 루트를 저장소 루트로 옮기고 src/에는 계층 코드만 둔다 #10

Merged
donghyeon.kang merged 4 commits from claude/t2b-relayout-e435ee into main 2026-11-11 16:13:48 +00:00
Owner

무엇을, 왜

Gradle 루트가 src/라서 빌드 도구(build-logic, gradle, config, 빌드 파일)가 계층 코드 폴더 옆에 섞여 있었다. 조립 계층은 composition/과 app-bootstrap/ 두 폴더로 갈라져 있었고, application 모듈 넷은 src/ 최상위에 흩어져 있었다. 그 결과 「Gradle은 src/에서 실행」이라는 예외 규칙이 문서·스크립트·workflow 곳곳에 퍼졌다.

이 PR은 저장소 루트를 Gradle 루트로 하고 src/에는 계층 코드만 남긴다(설계 design-docs repo-structure/01-backend-layout.md 6.1절 가-2·가-3, 라이브러리 분리 뒤에 하기로 한 순서 05-library-repos.md).

저장소 루트 = Gradle 루트: settings.gradle · build.gradle · gradlew · gradle/ · build-logic/ · config/ · Dockerfile · .env.example · compose.yaml · compose/ · docs/ · scripts/
src/
├── domain/core
├── application/{core, fileserver, notification, objectstorage}
├── adapter/{inbound, outbound}/…      (그대로)
├── shared-contract                     (그대로)
└── bootstrap/{app, durable-operation, fileserver-platform, idempotency, notification-platform, outbox-relay, service-runtime}

커밋은 둘이다.

  1. refactor(layout)!: 옮기기만(git mv, R100 1541개). 내용은 바꾸지 않았다(.gitignore 합치기만). 파생 서비스가 이름 바꾸기와 내용 변경을 따로 받게 하려고 나눴다. 이 커밋만으로는 빌드되지 않는다.
  2. refactor(layout)!: 경로를 부르는 모든 곳을 고친다.

고른 방법과 버린 대안

Gradle 경로·registry id는 그대로 둔다. 폴더만 옮겼다(:application-core는 src/application/core, :app-bootstrap은 src/bootstrap/app, :composition:outbox-relay는 src/bootstrap/outbox-relay). registry가 이미 둘을 나눈다(ModuleRegistrySettingsInstaller가 source_path로 projectDir을 정한다).

안 비용(살아 있는 파일, 기록 제외) 버린 이유
폴더만 옮김 (고름) 0 —
폴더에 맞춰 경로 이름도 바꿈(:domain:core, :application:core, :bootstrap:app) :app-bootstrap 44파일 96줄, :application-* 70파일 106줄, :domain-core 25파일 38줄, :composition: 26파일 63줄 + 파생 서비스의 모든 project(':…') 프로젝트 이름 core가 둘이 된다: jar core-<ver>.jar가 boot jar BOOT-INF/lib에서 겹치고 기본 capability dev.caskeleton:core가 충돌한다. 우회(archivesName·capability) 설정을 새로 둬야 한다. jar 이름이 app-<ver>.jar로 바뀌어 이미지·문서도 따라 바뀐다
:composition:* → :bootstrap:*만 26파일 63줄. tech-log-backend에는 composition이 없어 충돌 없음 :app-bootstrap과 어긋난 채 남는다. 소유자가 원하면 따로 할 수 있는 작은 후속으로 남긴다

registry와 시험 이미지 목록은 gradle/로. gradle/modules.json(프로젝트 안 의존: leaf와 허용 edge), gradle/container-images.properties(시험이 띄우는 이미지)는 옆의 gradle/libs.versions.toml(프로젝트 밖 의존: 라이브러리 버전)과 같은 종류다 — 빌드가 고정하는 것. config/는 설계대로 코드 검사 도구 설정(checkstyle·spotbugs)만 둔다. 버린 안: config/ 그대로(설계의 「config = 코드 검사 도구 설정」과 어긋남), 루트 architecture/ 새 폴더(최상위가 늘어남), src/modules.json(src/는 코드만).

그 밖의 자리: src/README.md(빌드·env 참조) → docs/build.md(루트 README는 저장소 소개라 겹치지 않게). src/composition/AGENTS.md → src/bootstrap/AGENTS.md(조립 루트와 조립 leaf를 한 family로 다시 씀). 이미지 빌드 context는 저장소 루트이고 .dockerignore는 허용 목록(전에 context였던 것만 들어감)으로 다시 썼다.

위험과 영향

  • 파생 서비스: 거의 모든 빌드 파일과 계층 폴더의 경로가 바뀐다. 태그 pre-relayout-2026-11(main 66eaa982)까지 먼저 받고 이 PR을 두 번째로 받는다. 옛 경로 → 새 경로 표와 순서는 docs/upgrade/2026-11-relayout.md.
  • 동작 변경 둘: bootRun working dir가 저장소 루트가 됐다(.env와 상대 경로 설정이 루트 기준, /logs/를 무시). 로컬 .env가 compose.yaml 옆에 와서 Docker Compose가 보간에도 읽는다(APP_DATASOURCE_USERNAME·PASSWORD·APP_SERVER_PORT가 db·포트 매핑에 들어감). 둘 다 upgrade 문서 5절.
  • 기록 문서는 머리 블록만 고쳤다: docs/design·docs/history·docs/reviews 본문과 지난 upgrade 문서, capability-status.md 제거 표의 옛 경로는 쓴 때의 기록이라 그대로다.
  • 문서 검사 범위: check-docs.py 경로 검사가 build-logic/·gradle/로 시작하는 인라인 경로도 본다(전에는 src/build-logic/·src/gradle/로 보던 것). 그 김에 드러난 옛 경로 하나(build-logic/README.md의 config/jpa/release-registry.json)를 고쳤다.

검증

desktop 증거 실행 — 새 worktree, 트리 60838b16(= 커밋 123fc0bf의 트리. 그 뒤 커밋은 장부 한 줄뿐), Gradle --no-build-cache, 공유 잠금 아래, 2026-11-11 23:27~00:38 KST. 로그 desktop ~/t2b-logs/ev-*.log.

단계 명령 rc 시간 FROM-CACHE
docs scripts/verify.sh docs 0 4초 0
pr scripts/verify.sh pr --on here --no-cache (:prCheck, :verifyStrictLaneStages --dry-run) 0 487초 0
main scripts/verify.sh main --on here --no-cache (:mainCheck, :integrationCheck, -p build-logic test, 설정 캐시 스크립트) 0 2199초 바깥 0, 중첩 빌드 14(verifyFeatureScaffold가 띄운 복사본의 compile·checkstyle)
release scripts/verify.sh release --on here --no-cache 0 28초 0
compose smoke scripts/run-compose-runtime-smoke.sh --matrix src/bootstrap/app/compose-lanes/compose-profile-contracts.json 0 1495초 — (18/18 lane passed)
빠른 시작 scripts/verify.sh app (scripts/bootstrap-local.sh) 0 61초 — (/api/healthcheck HTTP 200, status=UP, 뒤에 docker compose down -v)

시험 결과 XML 합계: tests=8154, failures=0, errors=0, skipped=28.

runner: pr / gradle, pr / vulnerabilities, pr / done (pull_request) 모두 success — 커밋 123fc0bf(run 85)와 지금 head 97798b5a(run 88, 장부 실측 한 줄만 더함).

노트북: scripts/check-docs.py, check-work-docs.py, check-repo-layout.py, python3 -m unittest discover -s scripts/tests(148) OK.

구조 리뷰(arch-reviewer, 읽기만): 지적 5건 모두 반영 — notification API surface의 application-notification 소스 루트(놓치면 272개 타입이 surface에서 말없이 빠짐), 루트 전체를 훑는 fileTree가 .claude/worktrees를 줍는 것, src/bootstrap/AGENTS.md 시험 문구, build-logic fixture가 새 배치(Gradle 루트 = 저장소 루트, 빌드 폴더 .)를 시험하지 않던 것(시험 셋 추가), javadoc 위치.

돌리지 않은 것: performanceCheck(brief 범위 밖, nightly 몫), runner에서만 도는 nightly 행렬(PostgreSQL major, Redis topology, NFS, compose smoke runner 실행). Docker 레이어 캐시는 끄지 않았다(빌드 context와 COPY 경로가 바뀌어 옛 레이어는 다시 쓰이지 않는다).

리뷰어가 볼 곳

  • 기계적으로 만든 부분: 1번 커밋은 git mv만. 2번 커밋의 경로 치환은 스크립트(옛 경로 접두사 → 새 경로, 기록 문서 제외)로 하고, 그 뒤 손으로 고친 곳은 아래.
  • 손으로 고친 곳: build-logic의 저장소 루트 계산(ArchitectureRegistrySettingsPlugin, ArchitecturePlugin, ConfigContractPlugin), 빌드 스크립트의 rootProject.projectDir.parentFile·rootProject.file('../…'), 옛 src/ 기준 경로를 쓰던 시험(FileserverDocumentationCoverageTest는 Gradle 경로 → 폴더를 registry로 찾게 바꿈, MessagingAuthorityContractTest·NotificationPayloadAtRestContractTest처럼 없는 폴더를 조용히 건너뛰던 목록), DeveloperExperienceContractTest의 Docker 계약, .dockerignore, workflow의 working-directory: src 삭제, scripts/(verify.sh, ci/*, bootstrap-local, new-feature, verify-feature-scaffold), check-repo-layout.py 허용 목록.

관련

  • design-docs repo-structure/01-backend-layout.md 6.1절, repo-structure/05-library-repos.md
  • docs/upgrade/2026-11-relayout.md, docs/work/reference/decisions.md 「Gradle 루트 위치」
## 무엇을, 왜 Gradle 루트가 `src/`라서 빌드 도구(`build-logic`, `gradle`, `config`, 빌드 파일)가 계층 코드 폴더 옆에 섞여 있었다. 조립 계층은 `composition/`과 `app-bootstrap/` 두 폴더로 갈라져 있었고, application 모듈 넷은 `src/` 최상위에 흩어져 있었다. 그 결과 「Gradle은 `src/`에서 실행」이라는 예외 규칙이 문서·스크립트·workflow 곳곳에 퍼졌다. 이 PR은 저장소 루트를 Gradle 루트로 하고 `src/`에는 계층 코드만 남긴다(설계 design-docs `repo-structure/01-backend-layout.md` 6.1절 가-2·가-3, 라이브러리 분리 뒤에 하기로 한 순서 `05-library-repos.md`). ``` 저장소 루트 = Gradle 루트: settings.gradle · build.gradle · gradlew · gradle/ · build-logic/ · config/ · Dockerfile · .env.example · compose.yaml · compose/ · docs/ · scripts/ src/ ├── domain/core ├── application/{core, fileserver, notification, objectstorage} ├── adapter/{inbound, outbound}/… (그대로) ├── shared-contract (그대로) └── bootstrap/{app, durable-operation, fileserver-platform, idempotency, notification-platform, outbox-relay, service-runtime} ``` 커밋은 둘이다. 1. `refactor(layout)!:` 옮기기만(git mv, R100 1541개). 내용은 바꾸지 않았다(`.gitignore` 합치기만). 파생 서비스가 이름 바꾸기와 내용 변경을 따로 받게 하려고 나눴다. 이 커밋만으로는 빌드되지 않는다. 2. `refactor(layout)!:` 경로를 부르는 모든 곳을 고친다. ## 고른 방법과 버린 대안 **Gradle 경로·registry id는 그대로 둔다.** 폴더만 옮겼다(`:application-core`는 `src/application/core`, `:app-bootstrap`은 `src/bootstrap/app`, `:composition:outbox-relay`는 `src/bootstrap/outbox-relay`). registry가 이미 둘을 나눈다(`ModuleRegistrySettingsInstaller`가 `source_path`로 `projectDir`을 정한다). | 안 | 비용(살아 있는 파일, 기록 제외) | 버린 이유 | | --- | --- | --- | | **폴더만 옮김 (고름)** | 0 | — | | 폴더에 맞춰 경로 이름도 바꿈(`:domain:core`, `:application:core`, `:bootstrap:app`) | `:app-bootstrap` 44파일 96줄, `:application-*` 70파일 106줄, `:domain-core` 25파일 38줄, `:composition:` 26파일 63줄 + 파생 서비스의 모든 `project(':…')` | 프로젝트 이름 `core`가 둘이 된다: jar `core-<ver>.jar`가 boot jar `BOOT-INF/lib`에서 겹치고 기본 capability `dev.caskeleton:core`가 충돌한다. 우회(archivesName·capability) 설정을 새로 둬야 한다. jar 이름이 `app-<ver>.jar`로 바뀌어 이미지·문서도 따라 바뀐다 | | `:composition:*` → `:bootstrap:*`만 | 26파일 63줄. tech-log-backend에는 composition이 없어 충돌 없음 | `:app-bootstrap`과 어긋난 채 남는다. 소유자가 원하면 따로 할 수 있는 작은 후속으로 남긴다 | **registry와 시험 이미지 목록은 `gradle/`로.** `gradle/modules.json`(프로젝트 안 의존: leaf와 허용 edge), `gradle/container-images.properties`(시험이 띄우는 이미지)는 옆의 `gradle/libs.versions.toml`(프로젝트 밖 의존: 라이브러리 버전)과 같은 종류다 — 빌드가 고정하는 것. `config/`는 설계대로 코드 검사 도구 설정(checkstyle·spotbugs)만 둔다. 버린 안: `config/` 그대로(설계의 「config = 코드 검사 도구 설정」과 어긋남), 루트 `architecture/` 새 폴더(최상위가 늘어남), `src/modules.json`(`src/`는 코드만). 그 밖의 자리: `src/README.md`(빌드·env 참조) → `docs/build.md`(루트 README는 저장소 소개라 겹치지 않게). `src/composition/AGENTS.md` → `src/bootstrap/AGENTS.md`(조립 루트와 조립 leaf를 한 family로 다시 씀). 이미지 빌드 context는 저장소 루트이고 `.dockerignore`는 허용 목록(전에 context였던 것만 들어감)으로 다시 썼다. ## 위험과 영향 - **파생 서비스**: 거의 모든 빌드 파일과 계층 폴더의 경로가 바뀐다. 태그 `pre-relayout-2026-11`(main `66eaa982`)까지 먼저 받고 이 PR을 두 번째로 받는다. 옛 경로 → 새 경로 표와 순서는 `docs/upgrade/2026-11-relayout.md`. - **동작 변경 둘**: `bootRun` working dir가 저장소 루트가 됐다(`.env`와 상대 경로 설정이 루트 기준, `/logs/`를 무시). 로컬 `.env`가 `compose.yaml` 옆에 와서 Docker Compose가 보간에도 읽는다(`APP_DATASOURCE_USERNAME`·`PASSWORD`·`APP_SERVER_PORT`가 `db`·포트 매핑에 들어감). 둘 다 upgrade 문서 5절. - **기록 문서는 머리 블록만 고쳤다**: `docs/design`·`docs/history`·`docs/reviews` 본문과 지난 upgrade 문서, `capability-status.md` 제거 표의 옛 경로는 쓴 때의 기록이라 그대로다. - **문서 검사 범위**: `check-docs.py` 경로 검사가 `build-logic/`·`gradle/`로 시작하는 인라인 경로도 본다(전에는 `src/build-logic/`·`src/gradle/`로 보던 것). 그 김에 드러난 옛 경로 하나(`build-logic/README.md`의 `config/jpa/release-registry.json`)를 고쳤다. ## 검증 **desktop 증거 실행** — 새 worktree, 트리 `60838b16`(= 커밋 `123fc0bf`의 트리. 그 뒤 커밋은 장부 한 줄뿐), Gradle `--no-build-cache`, 공유 잠금 아래, 2026-11-11 23:27~00:38 KST. 로그 desktop `~/t2b-logs/ev-*.log`. | 단계 | 명령 | rc | 시간 | FROM-CACHE | | --- | --- | --- | --- | --- | | docs | `scripts/verify.sh docs` | 0 | 4초 | 0 | | pr | `scripts/verify.sh pr --on here --no-cache` (`:prCheck`, `:verifyStrictLaneStages --dry-run`) | 0 | 487초 | 0 | | main | `scripts/verify.sh main --on here --no-cache` (`:mainCheck`, `:integrationCheck`, `-p build-logic test`, 설정 캐시 스크립트) | 0 | 2199초 | 바깥 0, 중첩 빌드 14(`verifyFeatureScaffold`가 띄운 복사본의 compile·checkstyle) | | release | `scripts/verify.sh release --on here --no-cache` | 0 | 28초 | 0 | | compose smoke | `scripts/run-compose-runtime-smoke.sh --matrix src/bootstrap/app/compose-lanes/compose-profile-contracts.json` | 0 | 1495초 | — (18/18 lane passed) | | 빠른 시작 | `scripts/verify.sh app` (`scripts/bootstrap-local.sh`) | 0 | 61초 | — (`/api/healthcheck` HTTP 200, `status=UP`, 뒤에 `docker compose down -v`) | 시험 결과 XML 합계: tests=8154, failures=0, errors=0, skipped=28. **runner**: `pr / gradle`, `pr / vulnerabilities`, `pr / done (pull_request)` 모두 success — 커밋 `123fc0bf`(run 85)와 지금 head `97798b5a`(run 88, 장부 실측 한 줄만 더함). **노트북**: `scripts/check-docs.py`, `check-work-docs.py`, `check-repo-layout.py`, `python3 -m unittest discover -s scripts/tests`(148) OK. **구조 리뷰**(`arch-reviewer`, 읽기만): 지적 5건 모두 반영 — notification API surface의 application-notification 소스 루트(놓치면 272개 타입이 surface에서 말없이 빠짐), 루트 전체를 훑는 fileTree가 `.claude/worktrees`를 줍는 것, `src/bootstrap/AGENTS.md` 시험 문구, build-logic fixture가 새 배치(Gradle 루트 = 저장소 루트, 빌드 폴더 `.`)를 시험하지 않던 것(시험 셋 추가), javadoc 위치. 돌리지 않은 것: `performanceCheck`(brief 범위 밖, nightly 몫), runner에서만 도는 nightly 행렬(PostgreSQL major, Redis topology, NFS, compose smoke runner 실행). Docker 레이어 캐시는 끄지 않았다(빌드 context와 COPY 경로가 바뀌어 옛 레이어는 다시 쓰이지 않는다). ## 리뷰어가 볼 곳 - 기계적으로 만든 부분: 1번 커밋은 git mv만. 2번 커밋의 경로 치환은 스크립트(옛 경로 접두사 → 새 경로, 기록 문서 제외)로 하고, 그 뒤 손으로 고친 곳은 아래. - 손으로 고친 곳: `build-logic`의 저장소 루트 계산(`ArchitectureRegistrySettingsPlugin`, `ArchitecturePlugin`, `ConfigContractPlugin`), 빌드 스크립트의 `rootProject.projectDir.parentFile`·`rootProject.file('../…')`, 옛 `src/` 기준 경로를 쓰던 시험(`FileserverDocumentationCoverageTest`는 Gradle 경로 → 폴더를 registry로 찾게 바꿈, `MessagingAuthorityContractTest`·`NotificationPayloadAtRestContractTest`처럼 없는 폴더를 조용히 건너뛰던 목록), `DeveloperExperienceContractTest`의 Docker 계약, `.dockerignore`, workflow의 `working-directory: src` 삭제, `scripts/`(verify.sh, ci/*, bootstrap-local, new-feature, verify-feature-scaffold), `check-repo-layout.py` 허용 목록. ## 관련 - design-docs `repo-structure/01-backend-layout.md` 6.1절, `repo-structure/05-library-repos.md` - `docs/upgrade/2026-11-relayout.md`, `docs/work/reference/decisions.md` 「Gradle 루트 위치」
donghyeon.kang added 3 commits 2026-11-11 13:36:30 +00:00
문제: 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절
문제: 앞 커밋이 Gradle 루트를 저장소 루트로 옮기고 계층 폴더를 묶었다.
빌드 스크립트·build-logic·시험·workflow·스크립트·문서가 아직 옛 배치
(Gradle 루트 = src/)를 가정해 빌드가 되지 않는다.

고른 방법:
- Gradle 경로와 registry id는 그대로 둔다(:app-bootstrap, :application-core,
  :composition:*). registry의 source_path만 새 폴더를 가리킨다. 폴더에 맞춘
  이름(:domain:core, :application:core)은 프로젝트 이름 core가 둘이 되어
  boot jar의 BOOT-INF/lib와 기본 capability가 겹치고, 파생 서비스의 모든
  project(':…') 줄을 바꾸게 한다.
- registry는 gradle/modules.json, 시험 이미지 목록은
  gradle/container-images.properties: 버전 카탈로그 옆, 빌드가 고정하는 것.
  config/는 코드 검사 도구 설정만 둔다.
- build-logic: settings·architecture 플러그인의 저장소 루트를 Gradle 루트로
  (getParentFile 제거). config contract의 파일 트리는 src/만 훑는다(루트를
  훑으면 docs·.claude/worktrees까지 줍는다).
- 빌드 스크립트: rootProject.projectDir.parentFile → rootProject.projectDir,
  rootProject.file('../…') → rootProject.file('…'), 옛 src 기준 include에
  src/를 붙인다. notification API surface의 application-notification 소스
  루트를 새 폴더로(놓치면 272개 타입이 surface에서 말없이 빠진다).
- 시험: 옛 src 기준 모듈 목록과 ../ 개수를 고친다. 없는 폴더를 말없이
  건너뛰던 목록(MessagingAuthority, NotificationPayloadAtRest 등)을 새
  폴더로, FileserverDocumentationCoverageTest는 Gradle 경로 → 폴더를
  registry로 찾는다. Docker 계약은 WORKDIR /build, 새 jar 경로.
- Docker: 빌드 context를 저장소 루트로, .dockerignore는 허용 목록으로 다시
  써서 전에 context였던 것만 들어가게 한다. compose의 build.context는 .,
  env_file은 ./.env.
- workflow: working-directory: src 기본값과 그것을 되돌리던 줄을 지운다.
- scripts: verify.sh, ci/*, bootstrap-local, new-feature,
  verify-feature-scaffold, mongo 검증, hooks, check-repo-layout 허용 목록.
  check-docs의 경로 검사는 build-logic/·gradle/로 시작하는 경로도 본다.
- 문서: AGENTS.md 지도, README 구조 표, leaf AGENTS.md의 cd src, gates·
  operate·결정 색인, src/bootstrap/AGENTS.md를 조립 계층 family 규칙으로
  다시 쓴다. 기록 문서(docs/design·history·reviews, 지난 upgrade 안내,
  capability-status 제거 표)는 머리 블록만 고친다. 파생 서비스용 안내
  docs/upgrade/2026-11-relayout.md를 더한다.

위험: bootRun working dir가 저장소 루트가 되어 .env와 상대 경로 설정이
루트 기준이다. 루트 .env는 compose 보간에도 읽힌다(upgrade 안내 5절).
파생 서비스는 태그 pre-relayout-2026-11까지 받은 뒤 이 묶음을 받는다.

검증: desktop에서 캐시 없이 scripts/verify.sh docs·pr·main·release,
compose smoke 18 lane, 빠른 시작(scripts/verify.sh app). 결과는 PR 본문.
구조 리뷰(arch-reviewer) 지적 5건을 반영했다.

BREAKING CHANGE: Gradle은 저장소 루트에서 돈다(cd src 없음). registry는
gradle/modules.json, 이미지 빌드 context는 저장소 루트다. 옛 경로 → 새 경로
표는 docs/upgrade/2026-11-relayout.md.
Refs: design-docs repo-structure/01-backend-layout.md 6.1절 가-2·가-3
docs(ledger): Gradle 루트 재배치 작업의 착수 예측을 남긴다
pr / gradle (pull_request) Successful in 11m25s
pr / vulnerabilities (pull_request) Successful in 1m3s
pr / done (pull_request) Successful in 3s
123fc0bfae
donghyeon.kang added 1 commit 2026-11-11 15:40:00 +00:00
docs(ledger): Gradle 루트 재배치 작업의 실측을 남긴다
pr / gradle (pull_request) Successful in 11m45s
pr / vulnerabilities (pull_request) Successful in 1m1s
pr / done (pull_request) Successful in 4s
97798b5a35
donghyeon.kang marked the pull request as ready for review 2026-11-11 15:53:10 +00:00
donghyeon.kang merged commit 841a176fc9 into main 2026-11-11 16:13:48 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#10