3D 모델 뷰어

이 프로젝트는 three.js와 React를 사용하여 3D 모델을 렌더링하는 웹 애플리케이션입니다. 백엔드는 FastAPI를 사용하여 모델 파일을 제공합니다.

프로젝트 구조

• frontend/: React와 three.js를 사용한 프론트엔드 애플리케이션
• backend/: FastAPI를 사용한 백엔드 API 서버

로컬 환경에서 실행하기

이 애플리케이션은 WSL(Windows Subsystem for Linux) 환경에서 테스트되었습니다.

백엔드

1. 백엔드 디렉토리로 이동합니다.

   cd backend

2. Python 가상 환경을 생성하고 활성화합니다.

   python -m venv .venv
   source .venv/bin/activate

3. uv를 사용하여 종속성을 설치합니다.

   pip install uv
   uv pip install -r requirements.txt

   참고: pyproject.toml 파일이 있으므로 uv pip install을 사용하여 종속성을 설치할 수도 있습니다.

4. 백엔드 서버를 실행합니다.

   uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

   또는

   python run.py

   서버가 http://localhost:8000에서 실행됩니다.

프론트엔드

1. 프론트엔드 디렉토리로 이동합니다.

   cd frontend

2. npm을 사용하여 종속성을 설치합니다.

   npm install

3. 프론트엔드 개발 서버를 실행합니다.

   npm run dev

   애플리케이션이 http://localhost:5173 (또는 다른 사용 가능한 포트)에서 실행됩니다.