docs(TechLog): 남은 주제를 다시 쓰고 SSOT 를 저장소 실물로 더 보강한다

주제 11~13 을 다시 쓰고, Case 가 얇은 것들을 저장소에서 실물을 확인해 채웠다. §13.4 ManagementClientSafeMessages — 삭제 관련 코드 여섯의 고정 문구와 원문 메시지를 내보내지 않는 이유(javadoc) §16.1 다섯 참조가 전부 DOCUMENT_IN_USE 하나로 나가고, SSOT 가 인용한 영어 문장은 DeleteDocumentDraftUseCase 안에 남는 진단 메시지라 밖으로 나가지 않는다 §13.6 romanizeSyllable 실물과 음운 변동을 뺀 이유, 문서 slug 와 같은 정규식을 쓰는 이유 §15.4 check:types 가 도는 tsconfig 여섯 — app·node·test·recipes·web-worker·service-worker SSOT 62,643 → 67,526 자. 인용한 코드는 전부 저장소에서 찾아 대조했다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-07 19:12:37 +09:00
parent b1653dbba8
commit 6917ce2420
14 changed files with 279 additions and 99 deletions
@@ -64,17 +64,32 @@ tsconfig : 루트가 project references 만 나열

 이 저장소의 루트 tsconfig 는 컴파일 대상을 갖지 않는다. `"files": []` 에 project references 만 나열하고, 각 프로젝트는 자기 tsconfig 를 갖는다.

-`npx tsc --noEmit` 은 references 를 따라가지 않는다. 루트가 지목한 파일 집합만 보고, 그 집합이 비어 있으므로 아무것도 검사하지 않은 채 0 으로 끝난다. references 를 따라가려면 그 모드로 부르는 별도 명령이 필요하다.
+`npx tsc --noEmit` 은 references 를 따라가지 않는다. 루트가 지목한 파일 집합만 보고, 그 집합이 비어 있으므로 아무것도 검사하지 않은 채 0 으로 끝난다.
+
+## 실제 검사는 여섯 번 돈다
+
+`check:types` 는 tsconfig 여섯 개를 차례로 돌린다.
+
+| tsconfig | 무엇을 검사하나 |
+|---|---|
+| app | 애플리케이션 소스 |
+| node | 빌드·스크립트 |
+| test | 테스트 |
+| recipes | 선택 레시피 |
+| web-worker | 웹 워커 |
+| service-worker | 서비스 워커 |
+
+여섯을 따로 두는 이유는 각각 다른 런타임 타입 정의를 쓰기 때문이다. 워커는 DOM 을 갖지 않고 node 는 브라우저 전역을 갖지 않는다.

 ## 통과가 무엇을 뜻했나

-이 명령이 성공했을 때 확인된 것은 「루트 tsconfig 가 유효하다」까지다. 코드가 컴파일되는지는 묻지 않았다.
+짧은 명령이 성공했을 때 확인된 것은 「루트 tsconfig 가 유효하다」까지다. 코드가 컴파일되는지는 묻지 않았다.

 운영에서 릴리즈 목록 화면이 비었고 콘솔에 `ReferenceError` 가 났다. 링크 컴포넌트 import 가 빠졌고, 이동 함수는 정의된 적이 없었다. 둘 다 컴파일이 잡는 종류의 오류인데 컴파일이 돌지 않았다.

 ## 올바른 명령으로 돌렸을 때

-여섯 프로젝트를 각각 돌리는 명령으로 바꾸자 릴리즈 목록의 두 오류에 더해 네 가지가 함께 나왔다.
+여섯을 다 돌리자 릴리즈 목록의 두 오류에 더해 네 가지가 함께 나왔다.

 | 무엇이 나왔나 | 어떤 종류인가 |
 |---|---|