아키텍처 정본과 실제 소스로 문서 drift를 검증한다 - #780
Merged
developer-1px merged 3 commits intoSep 13, 2026
Merged
Conversation
사이트맵을 모듈·제품과 설계 현황으로 재편한다
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
사이트와 Architecture가 같은 라우트 등록을 읽어도 실제 저장소와 맞는다는 보장은 없었습니다. 책임·위치·공개 source를 저장소의 아키텍처 등록으로 옮기고, 사이트 등록 및 제품 소비 근거를 실제 파일·exports·import 경로와 대조합니다.
architecture/modules.json이 35개 패키지의 책임·위치·진입점·API 문서 위치를 소유합니다. 사이트 메뉴·Architecture·Source의 API 링크·API 생성기가 이를 소비하며, 사이트의 중복 책임 정의를 거절합니다.packages/*/docs/api-reference.md로 이동했습니다. 기존 공개 URL과 Usage 탐색을 유지하고 소유 문서와 생성기를 연결합니다. 변경 파일 다수는 문서 이동입니다.check:architecture가 workspace 분모·package 이름·types export에 대응하는 실제 source·API 소유 위치를 검증합니다. 3개 Application의 대표 연결 17개는 해당 route에서 출발하는 정적 import 경로로 대조합니다.--evidence로 경로를 출력합니다.?raw·?url은 소비 근거에서 제외합니다. 다른 제품 route를 근거로 등록하거나 비공개 subpath를 참조하면 실패합니다.검증:
npm run docs:evaluate에서 API 35개·공개 export 1,249개와 문서 링크를 확인했습니다.정적 import 그래프에는 type import와 barrel re-export가 포함됩니다. 실제 runtime 호출, 전체 제품 의존성, 책임 분류의 의미적 정당성을 증명하지 않습니다. Editing·Rich Text 혼합 책임과 미완료 Hands/Profile·Artifact는 별도 소유권·동작 감사 대상으로 남기고
architecture/README.md에 조사 결과와 한계를 기록했습니다.#778 위의 후속 PR입니다. base는
feat/777-documentation-architecture입니다.Closes #779