docs(core): core·조립·빌드·플랫폼 모듈 문서를 한국어로 옮긴다

문제: core 계층(application·domain·shared-contract), app-bootstrap,
composition, registry, build-logic, optional 빌드의 모듈 문서가 영어다.
세션이 처음 읽는 지역 규칙인데 소유자는 2026-11-07에 살아 있는 문서를
모두 한국어로 쓰기로 정했다. leaf CLAUDE.md 셋은 Spring Boot 버전을
4.0.0으로 복사해 두었는데 실제 버전(libs.versions.toml)과 다르다.

방법: 뜻을 그대로 옮기고 코드·명령·경로·식별자·표 구조는 원문으로
둔다. 버전은 `src/gradle/libs.versions.toml`을 가리키는 말로 바꾼다.
다른 문서·코드가 제목으로 가리키는 절(application-core의
Naming convention·Package ownership·Canonical use case shape·Allowed
transactional shapes, shared-contract의 Responsibility·Forbidden,
messaging의 발행 재시도 절)은 영어 원제를 괄호로 남겨 그 참조가
계속 찾아지게 한다. 참조하는 쪽을 고치는 것은 이 작업 범위 밖이다.
코드와 어긋난 주장은 코드에 맞춘다: TransactionPort 구현을
`adapter-persistence`에서 `adapter:outbound:persistence-jpa`의
`SpringTransaction`으로, registry README의 빈 의존 목록 예를
persistence-mongo(실제 목록은 application-core·shared-contract)에서
domain-core·shared-contract·messaging-core-api로 고친다.
TemplatePackageOwnershipDocumentTest는 표 머리 문자열로 표를 찾으므로
머리 상수를 한국어 머리(`| 패키지 (...) |`)로 맞춘다. 표와 기계 사본을
대조하는 계약은 그대로다.

위험: 영어 원제를 괄호로 남긴 제목은 참조하는 문서가 한국어 제목으로
바뀌면 괄호를 지울 수 있다. 본문의 짧은 이력 번호(07-08, 06-01,
11-M9)는 뜻을 바꾸지 않으려고 그대로 옮겼다.

검증: python3 scripts/check-docs.py rc=0(번역한 파일의 language 줄 8개,
number 줄 3개 지움), check-work-docs.py rc=0, --links(gates.md 범위)
깨진 링크 0, unittest discover scripts/tests 43개 통과.
This commit is contained in:
DongHyeonka
2026-11-07 17:07:16 +09:00
parent 03a313ed65
commit c91cc3fb10
13 changed files with 540 additions and 583 deletions
+21 -21
View File
@@ -1,36 +1,36 @@
# domain-core — pure domain layer
# domain-core — 순수 도메인 계층
## Registered identity
## 등록 정보
- Module ID: `domain-core`
- Gradle path: `:domain-core`
- Focused test (derived from Gradle path): `./gradlew :domain-core:test --console=plain`
- Runtime baseline: Java 21; repository framework baseline: Spring Boot 4.0.0.
- Registry SSOT: `src/config/architecture/modules.json`.
- 모듈 ID: `domain-core`
- Gradle 경로: `:domain-core`
- 이 모듈만 시험(Gradle 경로에서 나온 명령): `./gradlew :domain-core:test --console=plain`
- 실행 기준: Java 21. 프레임워크 기준인 Spring Boot 버전은 `src/gradle/libs.versions.toml`이 정한다.
- registry 정본: `src/config/architecture/modules.json`.
Package root: `dev.caskeleton.domain`.
패키지 루트: `dev.caskeleton.domain`.
코드 주석에서 덜어낸 **설계 결정의 근거**는 [README.md](README.md) 가 모아둔다 (이 문서는 모듈 규칙 SSOT).
## Responsibility
## 책임
- Business concepts, entities, value objects, enums, domain events, domain services.
- Repository ports where this reference implementation still keeps domain-owned persistence contracts.
- Domain invariants and core rules.
- 업무 개념, 엔티티, 값 객체, enum, 도메인 이벤트, 도메인 서비스.
- 이 참조 구현이 아직 도메인 소유 영속 계약을 두는 곳의 repository 포트.
- 도메인 불변식과 핵심 규칙.
## Allowed
## 허용
- Java standard library.
- Value-only shared operational types only if truly needed.
- Java 표준 라이브러리.
- 값만 담은 공용 운영 타입은 정말 필요할 때만.
## Forbidden
## 금지
- Spring annotations.
- JPA annotations.
- Servlet/HTTP types.
- Adapter, application, bootstrap, or presentation DTO dependencies.
- Spring 애너테이션.
- JPA 애너테이션.
- Servlet·HTTP 타입.
- 어댑터, application, bootstrap, 표현 계층 DTO 의존.
## Test
## 테스트
```bash
cd src