init

README.md

@@ -83,10 +83,18 @@ npm run dev       # 개발 서버 (http://localhost:5173)
 
 ## 빌드 & 미리보기
 ```bash
+nvm use 20
+npm ci    # (처음/의존성 변경 시 권장) 이미 설치돼 있으면 npm install도 OK
+npm run build
+```
+
+## 재빌드
+```bash
 npm run build
 npm run preview   # http://localhost:4173
 ```
 
+
 ## 프로덕션 배포 (Apache)
 이 프로젝트는 기본적으로 API 호출을 `API_BASE_URL` 기준으로 수행합니다.
 
@@ -138,6 +146,17 @@ sudo systemctl reload apache2
 </VirtualHost>
 ```
 
+### 404로 무한 요청이 날 때(중요 체크)
+브라우저 콘솔에 아래처럼 뜨면:
+
+- `GET https://talk.ncue.net/community/ai_news ... 404`
+
+대부분은 **Apache가 `/community`를 백엔드로 프록시하지 않고**, 프론트 정적 파일에서 해당 경로를 찾으려다 404를 내는 상황입니다.
+
+- Apache 설정에 `ProxyPass /community ...`가 **:443 가상호스트에 실제로 적용**되었는지 확인
+- `a2enmod proxy proxy_http` 적용 후 `systemctl reload apache2`
+- SPA rewrite(.htaccess)와 함께 쓴다면, **프록시가 rewrite보다 먼저 적용**되도록 VirtualHost에 ProxyPass를 두는 것을 권장
+
 백엔드 엔드포인트가 더 있다면 동일 패턴으로 `ProxyPass`를 추가하거나, `/api` prefix로 백엔드를 묶어 프론트 코드에서 `VITE_API_BASE_URL=/api`로 통일하는 것도 가능합니다.
 
 ## 빌드 산출물 구조