Nuxt 초기 세팅 추가

docs/spec.md

@@ -6,7 +6,7 @@
 - **유형**: 커스텀 블로그/CMS
 - **목표**: 개인 블로그 중심 운영, 기존 포털성 링크와 서비스 진입점은 블로그 내부 구조에 통합
 - **참조**: Ghost(관리자 UX/글쓰기), Thred 테마(사용자 화면)
-- **현재 상태**: 코드 스캐폴딩 전 문서 기준점
+- **현재 상태**: Nuxt 3 초기 스캐폴딩 완료
 - **원격 저장소**: https://git.sori.studio/zenn/sori.studio.git
 
 ---
@@ -138,7 +138,15 @@ components/content/
 
 ## API 구조
 
-> 아직 구현 전 설계안이다. 실제 구현 시 응답 구조와 엔드포인트가 바뀌면 이 문서를 먼저 갱신한다.
+> 현재 API는 Nuxt `server/api` 내부에 샘플 데이터 기반으로 구현되어 있다. DB 연결 후 같은 응답 구조를 유지하되 저장소만 교체한다.
+
+### 백엔드 구성
+
+- 별도 `backend/` 앱을 두지 않고 Nuxt/Nitro 서버 기능을 사용
+- 공개 API는 `server/api`에 작성
+- 서버 공통 스키마와 샘플 데이터는 `server/utils`에 작성
+- 초기 단계에서는 같은 앱 배포로 관리 비용을 낮춤
+- 독립 API 서버가 필요해지는 시점에만 백엔드 분리를 재검토
 
 ### 공개 API (`/api/`)
 
@@ -193,8 +201,11 @@ UPLOAD_DIR=/uploads
 MAX_FILE_SIZE=10485760
 
 # Site
-SITE_URL=https://sori.studio
-SITE_TITLE=sori.studio
+NUXT_PUBLIC_SITE_URL=https://sori.studio
+NUXT_PUBLIC_SITE_TITLE=sori.studio
+
+# Server
+APP_PORT=43118
 ```
 
 ### 환경 파일 기준
@@ -205,10 +216,18 @@ SITE_TITLE=sori.studio
 | `.env.production` | NAS 운영 | 운영 DB |
 | `.env.example` | 공유 예시 | 실제 접속 정보 없음 |
 
+### 포트 기준
+
+| 용도 | 포트 |
+|------|------|
+| 로컬 개발 서버 | 43117 |
+| NAS Docker 외부 포트 | 43118 |
+| 컨테이너 내부 포트 | 3000 |
+
 ---
 
 ## 버전 관리
 
-- 현재 버전: v0.0.1
+- 현재 버전: v0.0.2
 - 첫 커밋 이후 변경사항을 커밋할 때마다 패치 버전 증가
 - 메이저/마이너 버전은 구조 변경 또는 기능 묶음 단위로 결정