메뉴 관리 기능 추가

docs/history.md

@@ -1,5 +1,13 @@
 # 의사결정 이력
 
+## 2026-05-02 v0.0.25
+
+### 빈 문단 placeholder 표시와 네비게이션 관리 범위 결정
+
+블록 에디터의 `/` 안내 문구는 첫 빈 화면이거나 마지막 보조 입력 블록일 때만 표시한다. 사용자가 중간에 의도적으로 만든 빈 문단에도 같은 안내가 반복되면 작성 중인 여백이 오류처럼 보이고, 실제 내용보다 placeholder가 더 강하게 눈에 들어오기 때문이다.
+
+네비게이션 관리는 1차로 공개 왼쪽 사이드바의 상단 메뉴와 하단 링크를 대상으로 한다. 기존 화면에서 이미 해당 영역이 메뉴 역할을 하고 있으므로 새 UI 영역을 만들기보다 하드코딩된 항목을 `navigation_items` 테이블로 옮겨 관리자에서 라벨, URL, 위치, 순서, 표시 여부를 조정할 수 있게 한다.
+
 ## 2026-05-02 v0.0.24
 
 ### 빈 줄 입력 보존과 사이트 설정 범위 결정

docs/map.md

@@ -16,7 +16,7 @@
 | 파일 | 화면 위치 |
 |------|-----------|
 | components/site/SiteHeader.vue | 모든 공개 페이지 상단 |
-| components/site/LeftSidebar.vue | 메인 화면 왼쪽 |
+| components/site/LeftSidebar.vue | 메인 화면 왼쪽, 네비게이션과 태그 목록 |
 | components/site/RightSidebar.vue | 메인 화면 오른쪽, 사이트 설정 표시 |
 | components/site/MainColumn.vue | 메인 화면 중앙 |
 | components/site/PostCard.vue | 목록의 게시물 카드, 대표 이미지 썸네일 |
@@ -64,6 +64,7 @@
 | pages/admin/pages/new.vue | 페이지 작성, 저장 토스트 |
 | pages/admin/pages/[id].vue | 페이지 수정, 저장/삭제 토스트 |
 | pages/admin/media/index.vue | 미디어 관리 |
+| pages/admin/navigation/index.vue | 메뉴/네비게이션 관리 |
 | pages/admin/tags/index.vue | 태그 관리 |
 | pages/admin/tags/new.vue | 태그 생성 |
 | pages/admin/tags/[id].vue | 태그 수정 |
@@ -92,6 +93,7 @@
 | server/api/pages/[slug].get.js | 고정 페이지 상세 샘플 API |
 | server/api/tags.get.js | 태그 목록 샘플 API |
 | server/api/site-settings.get.js | 공개 사이트 설정 API |
+| server/api/navigation.get.js | 공개 네비게이션 API |
 | server/routes/admin/api/auth/login.post.js | 관리자 로그인 API |
 | server/routes/admin/api/auth/logout.post.js | 관리자 로그아웃 API |
 | server/routes/admin/api/auth/me.get.js | 관리자 세션 조회 API |
@@ -116,14 +118,18 @@
 | server/routes/admin/api/tags/[id].delete.js | 관리자 태그 삭제 API |
 | server/routes/admin/api/settings.get.js | 관리자 사이트 설정 조회 API |
 | server/routes/admin/api/settings.put.js | 관리자 사이트 설정 수정 API |
+| server/routes/admin/api/navigation.get.js | 관리자 네비게이션 목록 API |
+| server/routes/admin/api/navigation.put.js | 관리자 네비게이션 일괄 저장 API |
 | server/utils/content-schema.js | Zod 콘텐츠 스키마 |
 | server/utils/sample-content.js | 샘플 콘텐츠 저장소 |
 | server/utils/admin-auth.js | 관리자 세션 쿠키 인증 유틸리티 |
 | server/utils/admin-post-input.js | 관리자 게시물 입력값 검증 스키마 |
 | server/utils/admin-page-input.js | 관리자 고정 페이지 입력값 검증 스키마 |
 | server/utils/admin-site-settings-input.js | 관리자 사이트 설정 입력값 검증 스키마 |
+| server/utils/admin-navigation-input.js | 관리자 네비게이션 입력값 검증 스키마 |
 | server/utils/admin-tag-input.js | 관리자 태그 입력값 검증 스키마 |
 | server/utils/site-settings.js | 사이트 설정 기본값 유틸리티 |
+| server/utils/navigation-items.js | 네비게이션 기본값과 그룹 유틸리티 |
 | server/utils/media-library.js | 업로드 미디어 파일 관리 유틸리티 |
 | server/repositories/postgres-client.js | PostgreSQL 클라이언트 |
 | server/repositories/content-repository.js | 콘텐츠 조회 저장소 |
@@ -136,6 +142,7 @@
 | db/migrations/002_seed_development.sql | 개발용 샘플 데이터 |
 | db/migrations/003_add_tag_display_fields.sql | 태그 표시 순서와 색상 필드 추가 |
 | db/migrations/004_add_site_settings.sql | 사이트 설정 테이블 추가 |
+| db/migrations/005_add_navigation_items.sql | 네비게이션 항목 테이블 추가 |
 
 ## 설정/배포
 

docs/spec.md

@@ -166,6 +166,19 @@ components/content/
 | copyright_text | String | 저작권 문구 |
 | updated_at | DateTime | 수정일 |
 
+### NavigationItems
+
+| 필드 | 타입 | 설명 |
+|------|------|------|
+| id | UUID | Primary Key |
+| label | String | 메뉴 표시 이름 |
+| url | String | 내부 경로 또는 외부 URL |
+| location | Enum | primary/footer |
+| sort_order | Integer | 표시 순서 |
+| is_visible | Boolean | 공개 화면 표시 여부 |
+| created_at | DateTime | 생성일 |
+| updated_at | DateTime | 수정일 |
+
 ### PostTags (다대다)
 
 | 필드 | 타입 | 설명 |
@@ -198,6 +211,7 @@ components/content/
 - `GET /api/pages/:slug` - 고정 페이지 상세
 - `GET /api/tags` - 태그 목록
 - `GET /api/site-settings` - 공개 사이트 설정
+- `GET /api/navigation` - 공개 네비게이션
 
 ### 관리자 API (`/admin/api/`)
 
@@ -225,6 +239,8 @@ components/content/
 - `DELETE /admin/api/tags/:id` - 태그 삭제
 - `GET /admin/api/settings` - 사이트 설정 조회
 - `PUT /admin/api/settings` - 사이트 설정 수정
+- `GET /admin/api/navigation` - 네비게이션 항목 목록
+- `PUT /admin/api/navigation` - 네비게이션 항목 일괄 저장
 
 > 글 발행/초안/비공개 전환은 현재 `PUT /admin/api/posts/:id`의 `status` 값으로 처리한다.
 > 태그 삭제 시 `post_tags` 연결도 데이터베이스 외래 키 규칙에 따라 함께 삭제된다.
@@ -284,6 +300,14 @@ components/content/
 - 공개 헤더와 오른쪽 사이드바는 공개 사이트 설정 API 값을 사용한다.
 - DB 연결이 없는 환경에서는 환경 변수와 기본값 기반 설정을 사용한다.
 
+### 메뉴/네비게이션
+
+- 네비게이션은 `navigation_items` 테이블로 관리한다.
+- 관리자는 메뉴 라벨, URL, 위치, 순서, 표시 여부를 수정할 수 있다.
+- 공개 왼쪽 사이드바의 상단 메뉴는 `primary` 위치 항목을 사용한다.
+- 공개 왼쪽 사이드바 하단 메뉴는 `footer` 위치 항목을 사용한다.
+- URL은 `/`로 시작하는 내부 경로 또는 `http://`, `https://` 외부 URL을 허용한다.
+
 ### 관리자 인증
 
 - 초기 관리자 인증은 `ADMIN_EMAIL`, `ADMIN_PASSWORD` 환경 변수를 사용

docs/todo.md

@@ -17,7 +17,7 @@
 
 - [ ] 페이지 관리 브라우저 수동 QA: 생성, 수정, 삭제, 공개 보기 확인
 - [ ] 사이트 설정 브라우저 수동 QA: 저장, 공개 헤더/사이드바 반영, 잘못된 URL 실패 확인
-- [ ] 메뉴/네비게이션 관리
+- [ ] 메뉴/네비게이션 브라우저 수동 QA: 항목 추가, 삭제, 숨김, 정렬, 공개 사이드바 반영 확인
 - [ ] 미디어 라이브러리 카테고리 분류
 - [ ] 미디어 라이브러리 프로필/사이트 설정 이미지 사용처 추적
 

docs/update.md

@@ -1,5 +1,15 @@
 # 업데이트 이력
 
+## v0.0.25
+
+- 관리자 블록 에디터에서 빈 문단 placeholder를 마지막 보조 입력 블록에만 표시하도록 수정.
+- 네비게이션 항목 데이터베이스 테이블 추가.
+- 공개 네비게이션 조회 API 추가.
+- 관리자 네비게이션 조회/일괄 저장 API 추가.
+- 관리자 메뉴 관리 화면 추가.
+- 공개 왼쪽 사이드바 상단/하단 메뉴를 네비게이션 API와 연결.
+- 패키지 버전을 0.0.25로 갱신.
+
 ## v0.0.24
 
 - 관리자 블록 에디터에서 마지막 빈 문단 Enter 입력 시 연속 빈 줄이 유지되도록 수정.