Skip to content

INSTALL.md

Latest commit

 

History

History
116 lines (89 loc) · 2.58 KB

INSTALL.md

File metadata and controls

116 lines (89 loc) · 2.58 KB

MandalGraph 설치 가이드

필수 요구사항

시스템 요구사항

  • Node.js: 18.x 이상
  • npm: 9.x 이상 (Node.js와 함께 설치됨)
  • Java: 17+ (21 권장)
  • Docker: 20.x 이상 (Neo4j 실행용)
  • Maven: 3.9+ (Maven Wrapper 포함)

버전 확인

node --version   # v18.x.x 이상
npm --version    # 9.x.x 이상
java --version   # openjdk 17+ 또는 21
docker --version # Docker version 20.x 이상

Frontend 설치

1. 의존성 설치

cd frontend
npm install

2. 설치되는 패키지 목록

Production Dependencies

패키지 버전 용도
react ^18.3.1 UI 프레임워크
react-dom ^18.3.1 React DOM 렌더링
d3 ^7.9.0 방사형 그래프 시각화
zustand ^4.5.2 상태 관리
axios ^1.7.2 HTTP 클라이언트

Dev Dependencies

패키지 버전 용도
typescript ^5.4.5 TypeScript 컴파일러
vite ^5.3.1 빌드 도구
@vitejs/plugin-react ^4.3.1 Vite React 플러그인
tailwindcss ^3.4.4 CSS 프레임워크
postcss ^8.4.38 CSS 후처리
autoprefixer ^10.4.19 CSS 벤더 프리픽스
@types/react ^18.3.3 React 타입 정의
@types/react-dom ^18.3.0 React DOM 타입 정의
@types/d3 ^7.4.3 D3.js 타입 정의
eslint ^8.57.0 코드 린터
@typescript-eslint/eslint-plugin ^7.13.1 TypeScript ESLint 플러그인
@typescript-eslint/parser ^7.13.1 TypeScript ESLint 파서
eslint-plugin-react-hooks ^4.6.2 React Hooks 린트 규칙
eslint-plugin-react-refresh ^0.4.7 React Refresh 린트 규칙

3. 개발 서버 실행

npm run dev

http://localhost:5173 에서 확인

4. 프로덕션 빌드

npm run build
npm run preview  # 빌드 결과 미리보기

Backend 설치 (예정)

1. Docker로 Neo4j 실행

# 프로젝트 루트에서
docker-compose up -d

2. Neo4j 접속 정보

3. Spring Boot 실행

cd backend
./mvnw spring-boot:run

문제 해결

npm install 실패 시

# npm 캐시 정리
npm cache clean --force

# node_modules 삭제 후 재설치
rm -rf node_modules
npm install

포트 충돌 시

  • Frontend (5173): vite.config.ts에서 server.port 변경
  • Backend (8080): application.yml에서 server.port 변경
  • Neo4j (7474, 7687): docker-compose.yml에서 포트 매핑 변경