Skip to content

문서 구조를 책임과 실제 모듈·Usage·제품 관계에 맞춘다 - #778

Open
developer-1px wants to merge 6 commits into
feat/768-markdown-bindingfrom
feat/777-documentation-architecture
Open

문서 구조를 책임과 실제 모듈·Usage·제품 관계에 맞춘다#778
developer-1px wants to merge 6 commits into
feat/768-markdown-bindingfrom
feat/777-documentation-architecture

Conversation

@developer-1px

@developer-1px developer-1px commented Sep 12, 2026

Copy link
Copy Markdown
Owner

문서의 책임 분류와 실제 제공 패키지·Usage·제품 관계가 서로 달라 모듈을 찾기 어려웠습니다. /docs/architecture에서 현재 저장소의 35개 패키지를 책임별로 탐색하고 API → Usage·Source → API 및 확인된 제품 조합으로 이동하도록 문서 구조를 재구성했습니다.

  • 기존 Concept Map을 Architecture로 바꾸고 문서 파일·라우트·내부 링크를 갱신했습니다. URL 호환보다 저장소와 아키텍처의 투영을 우선한다는 합의를 반영했습니다.
  • 사이트 라우트 등록에 책임·소스 디렉터리·Usage·대표 제품 관계를 기록합니다. 책임 개요, API 관계 안내, Source의 API 링크, API 문서 생성기의 탐색 분류가 이를 함께 소비합니다. 별도의 Adapter·Connector 목록과 분류 중복을 제거했습니다.
  • React 연결 모듈은 Connector, 협업 Contenteditable은 Adapter와 Collaboration, 파일 내용 계약은 Document Types에 표시합니다. Editing·Rich Text의 혼합 책임과 미완료 소유권은 명시하며, 기존 감사 데이터에서 9개 Document Type 후보의 상태를 표시합니다.
  • API를 메뉴에서 일괄 숨기는 규칙을 제거하고 Streaming Markdown Usage를 발견할 수 있게 했습니다. API → 두 Markdown Usage 및 정본 Source 연결을 검증했습니다.
  • AI Agent의 실제 입력이 Composer가 아닌 textarea·UI Primitives인 점을 소개와 소비 관계에 반영했습니다. Artifact와 Hands의 안내도 현재 구현과 완료 기준을 구분합니다.
  • 모바일 Markdown grid에서 표를 자체 스크롤 영역에 유지하고, 중복된 긴 후보 나열을 감사 데이터 기반 안내로 정리했습니다.

검증:

  • 관련 단위 테스트 150개 통과(문서·메뉴 149개와 Markdown Source 등록 1개, 재검증 결과 포함).
  • 라우트 관계 검사 4개, 문서 평가, 사이트 타입 검사, 정본 모듈·문서 가드, 사이트 production 빌드 통과.
  • Chrome 문서·사이트 검사 24개 모두 통과(설정 포함, 이전 실행과 수정 후 대상 재검증을 합산). 지도 → API → Usage → Source → API, 후보 상태 탐색, 모바일 가로 넘침과 데스크톱 표시를 확인했습니다.
  • 기존 Database 색상 검사의 비교 항목 불일치를 수정했습니다. 정본 Content Interaction의 선택 음영 유지와 포커스 outline을 각각 검증하며, 대상 Chrome 재실행은 설정을 포함해 2개 통과했습니다.
  • 중간 검증은 디스크 부족(ENOSPC)으로 중단됐으나 임시 프로세스 종료 후 여유 공간을 확인하고 재검증했습니다. production 빌드의 기존 chunk 크기 경고는 유지됩니다.

#771의 최신 Bear 편집 변경 위에 쌓인 문서 후속 PR입니다. base는 feat/768-markdown-binding이며 패키지 동작이나 소유권 재배치를 수행하지 않습니다.

Closes #777

유용태 and others added 3 commits September 12, 2026 22:42
사이트맵을 모듈·제품과 설계 현황으로 재편한다
아키텍처 정본과 실제 소스로 문서 drift를 검증한다
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant