docs(architecture): 현재 계약 문서와 매뉴얼의 영어 부분을 한국어로 옮긴다

문제: docs/architecture의 현재 계약 문서 가운데 scale-architecture.md,
starter-experience.md, capability-consumer-experience.md,
contract-ownership.md, static-delivery.md, review-evidence.md는 본문이
영어이고, backend-api-and-server-state-contract.md와
optional-adapter-recipes.md에는 영어 문단이 남아 있다.

고른 방법: 뜻을 바꾸지 않고 옮긴다. 백틱 안, 링크 대상, 절 번호(코드
주석이 `scale-architecture.md §N`으로 인용한다), 표 구조, 코드 블록은
그대로 둔다. 문서를 읽는 테스트와 절 이름을 인용한 곳을 같은 변경에서
고친다.
- tests/unit/feature-tracked-files.test.ts: starter-experience.md 표를
  자르는 시작·끝 문장과 표 행마다 찾는 낱말(`병합 충돌`)
- 「Ownership declarations」「Adding a feature」를 인용한 주석
  (create-feature.ts, generate-product-feature-index.ts, app-module.ts)과
  docs/manual의 절 이름 인용
- optional-adapter-recipes.md의 recipe 개수 복사를 카탈로그를 가리키게
  바꾼다(number 검사)

위험: create-feature.ts 417줄은 생성하는 context-module.ts의 JSDoc이라
새로 만드는 기능의 주석 글자가 바뀐다. 그 글자를 비교하는 테스트는 없다.
review-evidence.md는 산문만 옮겼고 해시·점수 칸은 그대로다.

검증: 백틱 span·링크 대상·코드 블록·번호 제목을 옮기기 전과 python으로
비교해 같다. 문서 검사의 language 줄이 이 문서들에서 0이 되어 예외
목록에서 지웠다.
This commit is contained in:
DongHyeonka
2026-11-08 21:57:47 +09:00
parent 7a9aefdf25
commit af10cae9a6
18 changed files with 1094 additions and 1157 deletions
+2 -2
View File
@@ -414,7 +414,7 @@ const GENERATED = "Generated by `pnpm create:feature`.";
function renderContextModule(contextId: string, appId: string, root: string): string {
return `/**
* Ownership declaration of the ${contextId} bounded context
* (docs/architecture/starter-experience.md, "Ownership declarations"): the
* (docs/architecture/starter-experience.md, "소유 선언"): the
* app that owns it, its route root and its direct-feature budget.
* ${GENERATED}
*/
@@ -1697,7 +1697,7 @@ async function readInstalledFacts(root: string): Promise<InstalledFacts> {
* and the command that writes each. A feature branch commits them with the
* feature; two feature branches change the same lines, and the merge takes
* the command again instead of a hand-merged value. docs/manual/03 (A) and
* the "Adding a feature" table in docs/architecture/starter-experience.md
* the "feature 추가" table in docs/architecture/starter-experience.md
* list them (tests/unit/feature-tracked-files.test.ts).
*/
export const FEATURE_TRACKED_FILE_REWRITES = Object.freeze([
-7
View File
@@ -8,12 +8,6 @@
# - 2026-11-08 문서 체계를 켤 때의 기준선이다. 문서를 고쳐 더는 걸리지 않으면 그 줄을 지운다.
language docs/accessibility/manual-checklist.md
language docs/architecture/capability-consumer-experience.md
language docs/architecture/contract-ownership.md
language docs/architecture/review-evidence.md
language docs/architecture/scale-architecture.md
language docs/architecture/starter-experience.md
language docs/architecture/static-delivery.md
language docs/contracts/compatibility.md
language docs/operations/adapter-remediation-ledger.md
language docs/operations/release-cache-rollback.md
@@ -27,7 +21,6 @@ language docs/security/supply-chain.md
language docs/styling/design-tokens.md
language docs/testing/taxonomy.md
language src/adapters/browser-transfer/image-cdn/README.md
number docs/architecture/optional-adapter-recipes.md 12개 recipe
number docs/operations/ci-quality-gates.md 4.4.3
style PRODUCT.md - **템플릿을 가져다 쓰는 개발자**: 이 템플릿으로 새 서비스를 빠르게 시작하는 사람입니다. 기본 화면(홈, 플랫폼 구성)과 Storyboo
style PRODUCT.md - **파생 서비스의 최종 사용자**: 디자인 시스템(토큰, 프리미티브, 패턴, 레이아웃, 페이지 템플릿)은 이 템플릿으로 만든 서비스를 실제로
+1 -1
View File
@@ -112,7 +112,7 @@ export function renderContextIndex(entries: readonly FeatureIndexEntry[]): strin
/**
* Ownership declarations the generator reads, documented in
* docs/architecture/starter-experience.md ("Ownership declarations"). Each boundary
* docs/architecture/starter-experience.md ("소유 선언"). Each boundary
* declares only its parent:
*
* src/apps/<app>/app-module.ts APP_MODULE_ID, APP_MAX_CONTEXTS
-7
View File
@@ -61,12 +61,6 @@ export const EXCEPTIONS_FILE = "scripts/docs-system-exceptions.txt";
*/
export const FROZEN: ReadonlySet<string> = new Set<string>([
"cd62292c1faf9312",
"9ebf8141a4434f32",
"64bb8316aafc4fcc",
"80ca3b198759492f",
"89616e7ca7b409d5",
"021ee3958bdd58af",
"1f94ecba91dcd1df",
"0ea431405727b1ba",
"29d6b489d280d464",
"f0eed09117035063",
@@ -80,7 +74,6 @@ export const FROZEN: ReadonlySet<string> = new Set<string>([
"07db060102714081",
"a42bc30fb525d6c9",
"59569b9b066cffcc",
"cac81d51afa3db95",
"33ba6f03c95bd8e7",
"dce0f0c48d3876a4",
"e1e286fae81074d4",