Files
clean-architecture-frontend…/config/contracts/backend-contract-pin.json
DongHyeonka 309631e419 docs(config): 설정 파일의 사람이 읽는 설명 칸을 한국어로 옮긴다
문제: recipe 카탈로그(config/recipes/frontend-capability-recipes.json),
runbook 등록(config/runbooks/runbooks.json), 규모 상한
(config/scale/feature-shape-ceilings.json), 짝 백엔드 pin의 `fact`,
secret scan 허용 이유의 설명 칸이 영어다. 소유자 결정(2026-11-07):
레지스트리의 설명 칸은 번역하되 그 칸을 읽는 테스트를 먼저 찾는다.

고른 방법: 칸마다 읽는 코드를 찾아, 비었는지만 보거나 자유 문자열로
산출물에 복사하는 칸만 옮긴다. 키, 배열 길이, 순서, 식별자·상태·경로·
명령·숫자는 그대로다.
- 옮기지 않은 칸: registry-baseline.json의 `trigger`·`compatibilityRole`
  (승인 파일이 그 사본의 digest를 고정한다), 승인·변경 증거 파일의
  `reason`(쓴 때의 기록), benchmark-baseline.json의 승인 이유,
  feature-shape-ceilings의 `axes[].axis`(테스트가 영어 리터럴로
  비교한다), 값이나 이름뿐인 칸. config/ci/는 정리 3단계·CI 세션
  범위라 보지 않았다.

위험: scripts/drill-runbook.ts의 복구 확인 항목 이름은 아직 영어라 설정과
코드의 언어가 다르다. 비교하지는 않는다.

검증: 다섯 파일 모두 HEAD와 키 경로·순서·배열 길이가 같다.
json-schema·runbook-contract·feature-shape-growth·backend-contract-pin
시험을 desktop에서 돌렸다.
2026-11-08 21:57:47 +09:00

54 lines
2.7 KiB
JSON

{
"schemaVersion": 1,
"backend": {
"repository": "clean-architecture-backend-template",
"commit": "45d2a478b800586f1d84151723629a560265d58e",
"document": "docs/web/http-contract.md",
"sectionsCompared": ["1", "2", "4"],
"scaffoldSources": [
{
"path": "scripts/new-feature.sh",
"fact": "경로 segment: camel-case 이름 뒤에 es, ies 또는 s를 붙인다",
"copiedTo": { "file": "scripts/create-feature.ts", "symbol": "backendPathSegment" }
},
{
"path": "scripts/feature-scaffold/templates/src/domain-core/src/main/java/dev/caskeleton/domain/__feature__/__Feature__.java.tmpl",
"fact": "NAME_MAX_LENGTH 100",
"copiedTo": { "file": "scripts/create-feature-write-slice.ts", "symbol": "BACKEND_NAME_MAX_LENGTH" }
},
{
"path": "scripts/feature-scaffold/templates/src/application-core/src/main/java/dev/caskeleton/application/__feature__/__Feature__ErrorCode.java.tmpl",
"fact": "오류 코드 <FEATURE>_INVALID와 <FEATURE>_NOT_FOUND",
"copiedTo": { "file": "scripts/create-feature-write-slice.ts", "symbol": "invalidCode" }
},
{
"path": "scripts/feature-scaffold/templates/src/adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/__feature__/__Feature__ControllerTest.java.tmpl",
"fact": "400 <FEATURE>_INVALID와 404 <FEATURE>_NOT_FOUND 응답 본문",
"copiedTo": { "file": "scripts/create-feature-write-slice.ts", "symbol": "notFoundCode" }
},
{
"path": "scripts/feature-scaffold/templates/src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/__feature__/__Feature__Controller.java.tmpl",
"fact": "POST /<plural>은 201로 답하고, GET /<plural>/{id}는 하나를 읽는다",
"copiedTo": { "file": "scripts/create-feature-write-slice.ts", "symbol": "renderWriteDescriptors" }
},
{
"path": "scripts/feature-scaffold/templates/src/application-core/src/main/java/dev/caskeleton/application/__feature__/Create__Feature__UseCase.java.tmpl",
"fact": "권한, 이름 검사, 쓰기 순서다. 거절은 쓰기 전에 일어난다",
"copiedTo": { "file": "scripts/create-feature-write-slice.ts", "symbol": "refusedBeforeWrite" }
}
]
},
"frontend": {
"contractDocument": "docs/architecture/backend-api-and-server-state-contract.md",
"contractSections": ["4.1", "6", "6.1"],
"readers": ["src/adapters/http/backend-envelope.ts"]
},
"tables": {
"idempotencyAnswers": "config/contracts/backend-idempotency-answers.json",
"backendExcerpt": "config/contracts/backend-http-contract-excerpt.json"
},
"notCopied": [],
"owner": "frontend-platform",
"comparedOn": "2026-11-05"
}