Skip to content

Latest commit

 

History

History
48 lines (35 loc) · 2.01 KB

File metadata and controls

48 lines (35 loc) · 2.01 KB

0006. 시각화 중심 컴포넌트를 격리한다

Date: 2026-01-28 Status: Accepted, path amended by 0011

Note: ADR 0011 moves the physical visualization path from src/components/visualization/** to blog/ui/visualization/** while preserving the isolation decision.

배경

알고리즘과 인터랙티브 시각화 컴포넌트는 기술 글을 더 풍부하게 설명하기 위해 추가됐다. 이 컴포넌트들은 일반 UI와 다른 관심사를 가진다. 애니메이션 상태, canvas나 SVG 스타일 렌더링, 상호작용 타이밍, 더 무거운 클라이언트 동작이 포함된다.

이후 구조 개편에서도 이 컴포넌트들은 generic ui UI로 흡수되지 않고 전용 위치에 보존됐다.

결정

시각화 중심 UI는 src/components/visualization/**에 둔다. MDX 컴포넌트 매핑은 이 컴포넌트를 글에 노출할 수 있지만, 시각화 코드 자체는 격리된 위치에 유지한다.

결과

  • 시각화 코드는 ui UI 추상화를 오염시키지 않고 발전할 수 있다.
  • 블로그 MDX 렌더링은 풍부한 인터랙티브 위젯을 import할 명확한 위치를 가진다.
  • ui UI는 재사용 가능한 인터페이스 primitive에 집중한다.
  • 시각화 코드를 옮기려면 구체적인 아키텍처 이유가 필요하다.

검토한 대안

  • src/ui 아래에 두기: post-specific하고 무거운 동작을 reusable UI primitive처럼 보이게 만든다.
  • 각 post 옆에 두기: locality는 좋아지지만 패턴이 중복되고 테스트가 어려워진다.
  • route-local에 두기: 한 글에는 충분하지만 재사용 가능한 기술 설명에는 맞지 않는다.

관련 히스토리

  • 8787466 (2026-01-28): 알고리즘 시각화 컴포넌트 추가.
  • 5fc05c0 (2026-01-29): 시각화 컴포넌트 복구와 통합.
  • 5be50b5 (2026-02-28): FSD 마이그레이션 중 시각화 코드 분리 유지.
  • b43600b (2026-03-30): 시각화 컴포넌트의 품질 게이트 위반 정리.