# 3D 모델 뷰어

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

## 프로젝트 구조

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

## 로컬 환경에서 실행하기

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

### 백엔드

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

    ```bash
    cd backend
    ```

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

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

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

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

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

    ```bash
    uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
    ```
    또는
    ```bash
    python run.py
    ```

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

### 프론트엔드

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

    ```bash
    cd frontend
    ```

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

    ```bash
    npm install
    ```

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

    ```bash
    npm run dev
    ```

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