문제: 소유자 결정(2026-11-07, design-docs `repo-structure/README.md` 3.2절)은 레지스트리
yaml의 설명 칸을 번역하라고 한다. 지금 값 칸 중 영어 산문은 env-keys `required_when`
7개, metrics `alert_severity_thresholds` 51개, object-storage-readiness `limitations`
15개이고, 주석은 약 940줄이 영어다. 주석 하나는 없는 파일
`docs/notification/configuration.md`를 가리킨다(있는 것은
`configuration-reference.md`).
고른 방법:
- 값 칸: 뜻을 그대로 옮기고 속성 이름·지표 이름·연산자·기간(5m, 1h)·식별자는 원문으로
둔다. `required_when`의 `<속성>=<값>` 꼴(공백 없음)은 `RequiredWhenIsEnforcedTest`가
기계로 읽으므로 그대로 두고, 공백이 든 설명 꼴만 옮긴다. 옮긴 값도 공백을 가져 그
테스트가 계속 건너뛴다.
- 주석: 파일 머리의 설명 블록과 행마다의 설명·출처 주석을 옮긴다. `# source:`는
`# 출처:`로 바꾸고, 설계 문서에서 따온 인용("...")은 원문으로 둔다.
- 그대로 둔 것: `RegistryGovernanceCatalog`가 글자 그대로 비교하는 머리 줄
(`# Schema owner: ...`, object-storage-readiness 머리 넷)과 `# Registry:` 등 메타
줄.
- 없는 문서 경로는 `docs/notification/configuration-reference.md`로 고친다.
이 칸을 읽는 테스트(먼저 찾음):
- `RegistryGovernanceCatalog`(ContractRegistrySchemaGovernanceTest): 머리 주석 줄을 글자
그대로 본다 — 해당 줄은 바꾸지 않았다.
- `RequiredWhenIsEnforcedTest`(redis-runtime): 공백 없는 `required_when`만 조건으로 쓴다.
- `SecretsClassificationRegistryTest`: `required_when`이 null인지만 본다.
- `MetricsAlertingContractTest`: 경보 키가 `AlertSeverity`로 풀리는지와 값이 비어 있지
않은지만 본다.
- `ObjectStorageReadinessRegistryTest`: `limitations`가 비어 있지 않은지만 본다.
- `NotificationModeSsotTest`: `name: APP_NOTIFICATION_PLATFORM_MODE` 뒤 첫 `default: `를
찾는다 — 옮긴 주석에 `default: ` 글자를 넣지 않았다.
위험·한계: 행마다의 주석은 설계 문서 ID와 날짜를 그대로 둔다. 남은 영어는 인용과
식별자뿐이다.
검증: 바꾸기 전후 여덟 파일을 `yaml.safe_load`로 읽은 데이터가 값 칸 말고는 같다(주석만
바꾼 파일은 완전히 같다). `python3 scripts/check-docs.py` rc=0.
119 lines
4.4 KiB
YAML
119 lines
4.4 KiB
YAML
# Repository owner test: dev.caskeleton.bootstrap.contract.ContractRegistrySchemaGovernanceTest
|
|
# Owner Gradle path: :app-bootstrap:test
|
|
# Semantic owner test: dev.caskeleton.adapter.outbound.objectstorage.readiness.ObjectStorageReadinessRegistryTest
|
|
# Semantic owner Gradle path: :adapter:outbound:objectstorage:test
|
|
schema_version: 1
|
|
claims:
|
|
- card_id: object-storage-managed-upload-single
|
|
provider_type: filesystem-local-dev
|
|
provider_version: jdk-21
|
|
destination_profile: local-managed-integrity
|
|
claimed_level: R1
|
|
evidence_revision: batch-b-local-r1
|
|
evidence_expires_on: ""
|
|
required_tasks:
|
|
- ":adapter:outbound:objectstorage:check"
|
|
limitations:
|
|
- 한 프로세스 안의 control CAS만 보장한다. 여러 노드의 선형성(linearizability)은 없다
|
|
- fsync·atomic move 시험은 전원이 꺼져도 남는다는 것을 증명하지 않는다
|
|
- 로컬 개발용 제공자는 production profile에서 쓸 수 없다
|
|
|
|
- card_id: object-storage-managed-upload-multipart
|
|
provider_type: filesystem-local-dev
|
|
provider_version: jdk-21
|
|
destination_profile: local-unimplemented
|
|
claimed_level: R0
|
|
evidence_revision: batch-b-contract-r0
|
|
evidence_expires_on: ""
|
|
required_tasks:
|
|
- ":application-core:check"
|
|
limitations:
|
|
- multipart 게시 프로토콜은 구현하지 않았다
|
|
|
|
- card_id: object-storage-managed-download
|
|
provider_type: filesystem-local-dev
|
|
provider_version: jdk-21
|
|
destination_profile: local-managed-integrity
|
|
claimed_level: R1
|
|
evidence_revision: batch-b-local-r1
|
|
evidence_expires_on: ""
|
|
required_tasks:
|
|
- ":adapter:outbound:objectstorage:check"
|
|
limitations:
|
|
- 로컬의 전체·범위 읽기 기능 시험은 운영 제공자 qualification이 아니다
|
|
- 여러 노드나 전원 손실에 대한 내구성은 주장하지 않는다
|
|
|
|
- card_id: object-storage-direct-upload-single
|
|
provider_type: filesystem-local-dev
|
|
provider_version: jdk-21
|
|
destination_profile: local-unimplemented
|
|
claimed_level: R0
|
|
evidence_revision: batch-b-contract-r0
|
|
evidence_expires_on: ""
|
|
required_tasks:
|
|
- ":application-core:check"
|
|
limitations:
|
|
- 직접 grant 제공자와 공개 inbound endpoint는 구현하지 않았다
|
|
|
|
- card_id: object-storage-direct-upload-multipart
|
|
provider_type: filesystem-local-dev
|
|
provider_version: jdk-21
|
|
destination_profile: local-unimplemented
|
|
claimed_level: R0
|
|
evidence_revision: batch-b-contract-r0
|
|
evidence_expires_on: ""
|
|
required_tasks:
|
|
- ":application-core:check"
|
|
limitations:
|
|
- 직접 multipart session과 공개 inbound endpoint는 구현하지 않았다
|
|
|
|
- card_id: object-storage-direct-download
|
|
provider_type: filesystem-local-dev
|
|
provider_version: jdk-21
|
|
destination_profile: local-unimplemented
|
|
claimed_level: R0
|
|
evidence_revision: batch-b-contract-r0
|
|
evidence_expires_on: ""
|
|
required_tasks:
|
|
- ":application-core:check"
|
|
limitations:
|
|
- 직접 download grant와 공개 inbound endpoint는 구현하지 않았다
|
|
|
|
- card_id: object-storage-quarantine-publication
|
|
provider_type: filesystem-local-dev
|
|
provider_version: jdk-21
|
|
destination_profile: local-unimplemented
|
|
claimed_level: R0
|
|
evidence_revision: batch-b-contract-r0
|
|
evidence_expires_on: ""
|
|
required_tasks:
|
|
- ":application-core:check"
|
|
limitations:
|
|
- scanner 인계와 판정 fencing은 구현하지 않았다
|
|
|
|
- card_id: object-storage-retention
|
|
provider_type: filesystem-local-dev
|
|
provider_version: jdk-21
|
|
destination_profile: local-unimplemented
|
|
claimed_level: R0
|
|
evidence_revision: batch-b-contract-r0
|
|
evidence_expires_on: ""
|
|
required_tasks:
|
|
- ":application-core:check"
|
|
limitations:
|
|
- 보존(retention)·법적 보존(legal hold)의 제공자 쪽 강제는 구현하지 않았다
|
|
- 특권 purge 조립은 일부러 비워 두었다
|
|
|
|
- card_id: object-storage-reconciliation
|
|
provider_type: filesystem-local-dev
|
|
provider_version: jdk-21
|
|
destination_profile: local-unimplemented
|
|
claimed_level: R0
|
|
evidence_revision: batch-b-contract-r0
|
|
evidence_expires_on: ""
|
|
required_tasks:
|
|
- ":application-core:check"
|
|
limitations:
|
|
- 로컬 create 해소는 한 프로세스 안의 기능 증거일 뿐이다
|
|
- 운영 환경의 응답 유실과 여러 노드 사이의 맞춤(reconciliation)은 구현하지 않았다
|