# AI 어시스턴트 API (VEXPLOR 내장) VEXPLOR와 **같은 서비스**로 동작하도록 이 API는 포트 3100에서 구동되고, backend-node가 `/api/ai/v1` 요청을 여기로 프록시합니다. ## 동작 방식 - **프론트(9771)** → `/api/ai/v1/*` 호출 - **Next.js** → `8080/api/ai/v1/*` 로 rewrite - **backend-node(8080)** → `3100/api/v1/*` 로 프록시 → **이 서비스** 따라서 사용자는 **다른 포트를 쓰지 않고** VEXPLOR만 켜도 AI 기능을 사용할 수 있습니다. ## 서비스 올리는 순서 (한 번에 동작하게) 1. **AI 어시스턴트 API (이 폴더, 포트 3100)** ```bash cd ai-assistant npm install cp .env.example .env # 필요 시 DB, JWT, GEMINI_API_KEY 등 수정 npm start ``` 2. **backend-node (포트 8080)** ```bash cd backend-node npm run dev ``` 3. **프론트 (포트 9771)** ```bash cd frontend npm run dev ``` 브라우저에서는 `http://localhost:9771` 만 사용하면 되고, AI API는 같은 오리진의 `/api/ai/v1` 로 호출됩니다. ## 환경 변수 - `.env.example` 을 `.env` 로 복사 후 수정 - `PORT=3100` (기본값) - PostgreSQL: `DB_*` - JWT: `JWT_SECRET`, `JWT_REFRESH_SECRET` - LLM: `GEMINI_API_KEY` 등