1. 서비스 개요

1.1 이름

• CODE VIEW (코드뷰)

1.2 한줄소개

• 개발자가 프로젝트 구조를 빠르게 이해할 수 있도록 폴더 구조와 아키텍처 관계를 자동으로 분석해서 시각화하는 도구

1.3 목적(서비스가 존재하는 방향성과 목표)

• 프로젝트 구조를 아키텍처 관점에서 직관적으로 이해할 수 있게 지원한다.
• 협업·코드 리뷰·온보딩 환경에서 구조 파악 시간을 크게 단축한다.
• 프로젝트 구조와 AI 분석 결과를 저장·비교할 수 있는 아카이빙 환경을 제공한다.
• CLI 또는 수동 문서화 방식과 달리, 항상 통일된 UI 형태의 시각 자료를 제공해 공유와 재사용성을 높인다.

1.4 해결하려는 문제(pain point)

1. 아키텍처 파악 과정이 분산되어 있음

• 구조를 파악하기까지 “코드 읽기 → 폴더 구조 확인 → 문서 찾기 → 직접 다이어그램 제작“ 같은 여러 단계를 각각 다른 곳에서 반복해야 한다.
• 즉, 프로젝트 구조 파악을 위한 작업이 여러 도구와 파일에 분산되어 있다.

1. 기존 시각화 방식의 한계

   방법	한계
   디렉토리 직접 탐색	큰 레포에서는 전체 구조 파악 어려움, 시간이 많이 듦
   README/Wiki 문서	최신 코드와 쉽게 불일치함, 문서가 흩어져 있어 찾기 어려움
   의존성 분석 도구(Madge, Nx Graph 등)	import level 그래프라 너무 복잡하고, 아키텍처 관점의 레이어 구조가 드러나지 않음
   다이어그램 툴(FigJam, Draw.io)	직접 그려야 해서 반복적이고, 시간이 많이 들며 코드 수정 시 유지보수가 어려움

2. AI CLI 기반 도구의 한계

   • 프로젝트마다 생성되는 이미지 스타일이 일관적이지 않다.
   • CLI 중심이라 구조 파악 결과를 팀과 공유하거나 아카이브하기 어렵다.

3. 문서가 코드 변화와 쉽게 불일치함

   • 수동 작성 및 수정 방식의 한계로 구조가 바뀌면 문서 업데이트가 누락되기 쉽고, 지속 가능한 문서화가 어렵다.

1.5 필요성(유저 관점에서 존재하는 문제점)

• 새로운 프로젝트에 투입될 때 가장 먼저 폴더 구조와 레이어 구조를 파악하는 시간이 오래 걸린다.
• 문서가 낡거나 불완전할 경우, 실제 코드의 구조를 이해하기 어렵다.
• 여러 프로젝트의 아키텍처를 일관된 UI 형태의 시각 자료를 매번 만들기 어렵고, 보관이 흩어진다.