initial commit

README.md

@@ -1,3 +1,69 @@
-# threejs-redering-test
+# 3D 모델 뷰어
 
-.obj redering by threeJS+React+FastAPI
+이 프로젝트는 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` (또는 다른 사용 가능한 포트)에서 실행됩니다.