관리자 페이지 관리 추가

docs/history.md

@@ -1,5 +1,13 @@
 # 의사결정 이력
 
+## 2026-05-02 v0.0.23
+
+### 고정 페이지 관리 구조 결정
+
+고정 페이지 작성과 수정은 게시물과 같은 블록형 에디터를 공유하되, 별도 `AdminPageForm`으로 분리한다. 페이지는 상태, 요약, 태그, 발행일이 없는 정적 콘텐츠이므로 게시물 폼을 그대로 재사용하면 불필요한 필드와 저장 조건이 섞이기 때문이다.
+
+관리자 경로는 내부 리소스 컬렉션 기준으로 `/admin/pages/:id`를 사용하고, 공개 보기 경로는 기존 고정 페이지 공개 구조인 `/pages/:slug`를 유지한다. 페이지는 목록과 태그 흐름에 노출되지 않는 독립 콘텐츠로 다루기 위해서다.
+
 ## 2026-05-02 v0.0.22
 
 ### 글쓰기 하단 빈 블록과 저장 피드백 보정

docs/map.md

@@ -27,6 +27,7 @@
 | 파일 | 화면 위치 |
 |------|-----------|
 | components/admin/AdminPostForm.vue | 관리자 글 작성/수정 폼, 대표 이미지 선택, 로컬 자동 저장 |
+| components/admin/AdminPageForm.vue | 관리자 페이지 작성/수정 폼, 대표 이미지 선택 |
 | components/admin/AdminBlockEditor.vue | 관리자 글 블록형 에디터, 이미지/갤러리/콜아웃/토글/임베드 블록, 한글 조합 입력 처리, 하단 빈 입력 블록 유지 |
 | components/admin/AdminTagForm.vue | 관리자 태그 생성/수정 폼 |
 
@@ -60,6 +61,8 @@
 | pages/admin/posts/new.vue | 글 작성, 저장 토스트 |
 | pages/admin/posts/[id].vue | 글 수정, 저장/삭제 토스트 |
 | pages/admin/pages/index.vue | 페이지 목록 |
+| pages/admin/pages/new.vue | 페이지 작성, 저장 토스트 |
+| pages/admin/pages/[id].vue | 페이지 수정, 저장/삭제 토스트 |
 | pages/admin/media/index.vue | 미디어 관리 |
 | pages/admin/tags/index.vue | 태그 관리 |
 | pages/admin/tags/new.vue | 태그 생성 |
@@ -96,6 +99,11 @@
 | server/routes/admin/api/posts/[id].get.js | 관리자 게시물 상세 API |
 | server/routes/admin/api/posts/[id].put.js | 관리자 게시물 수정 API |
 | server/routes/admin/api/posts/[id].delete.js | 관리자 게시물 삭제 API |
+| server/routes/admin/api/pages.get.js | 관리자 고정 페이지 목록 API |
+| server/routes/admin/api/pages.post.js | 관리자 고정 페이지 생성 API |
+| server/routes/admin/api/pages/[id].get.js | 관리자 고정 페이지 상세 API |
+| server/routes/admin/api/pages/[id].put.js | 관리자 고정 페이지 수정 API |
+| server/routes/admin/api/pages/[id].delete.js | 관리자 고정 페이지 삭제 API |
 | server/routes/admin/api/media.get.js | 관리자 미디어 목록 API |
 | server/routes/admin/api/media.put.js | 관리자 미디어 파일명 변경 API |
 | server/routes/admin/api/media.delete.js | 관리자 미디어 삭제 API |
@@ -109,6 +117,7 @@
 | 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-tag-input.js | 관리자 태그 입력값 검증 스키마 |
 | server/utils/media-library.js | 업로드 미디어 파일 관리 유틸리티 |
 | server/repositories/postgres-client.js | PostgreSQL 클라이언트 |

docs/spec.md

@@ -196,6 +196,11 @@ components/content/
 - `GET /admin/api/posts/:id` - 글 상세
 - `PUT /admin/api/posts/:id` - 글 수정
 - `DELETE /admin/api/posts/:id` - 글 삭제
+- `GET /admin/api/pages` - 고정 페이지 목록
+- `POST /admin/api/pages` - 고정 페이지 작성
+- `GET /admin/api/pages/:id` - 고정 페이지 상세
+- `PUT /admin/api/pages/:id` - 고정 페이지 수정
+- `DELETE /admin/api/pages/:id` - 고정 페이지 삭제
 - `GET /admin/api/media` - 업로드 미디어 목록
 - `PUT /admin/api/media` - 업로드 미디어 파일명 변경
 - `DELETE /admin/api/media` - 업로드 미디어 삭제
@@ -250,6 +255,13 @@ components/content/
 - 임베드 블록은 `:::embed` fenced block 안에 URL을 저장한다.
 - YouTube 임베드 URL은 공개 화면에서 iframe으로 렌더링하고, 그 외 URL은 외부 링크로 표시한다.
 
+### 관리자 페이지 편집
+
+- 고정 페이지 작성/수정 화면은 게시물과 같은 블록형 에디터를 사용한다.
+- 고정 페이지는 제목, 슬러그, 본문, 대표 이미지만 저장한다.
+- 고정 페이지는 게시물 목록과 태그 목록에 노출하지 않는다.
+- 고정 페이지 공개 보기 경로는 `/pages/:slug`를 사용한다.
+
 ### 관리자 인증
 
 - 초기 관리자 인증은 `ADMIN_EMAIL`, `ADMIN_PASSWORD` 환경 변수를 사용

docs/todo.md

@@ -15,7 +15,7 @@
 
 ## 2차 관리자 개발
 
-- [ ] 페이지 관리 (CRUD)
+- [ ] 페이지 관리 브라우저 수동 QA: 생성, 수정, 삭제, 공개 보기 확인
 - [ ] 사이트 설정
 - [ ] 메뉴/네비게이션 관리
 - [ ] 미디어 라이브러리 카테고리 분류

docs/update.md

@@ -1,5 +1,14 @@
 # 업데이트 이력
 
+## v0.0.23
+
+- 관리자 고정 페이지 목록 화면을 실제 API와 연결.
+- 관리자 고정 페이지 생성 화면 추가.
+- 관리자 고정 페이지 수정 화면 추가.
+- 관리자 고정 페이지 생성/수정/삭제 API 추가.
+- 고정 페이지 작성 폼에 블록 에디터와 대표 이미지 선택 기능 연결.
+- 패키지 버전을 0.0.23으로 갱신.
+
 ## v0.0.22
 
 - 관리자 블록 에디터 마지막에 클릭 가능한 빈 문단 블록을 항상 유지하도록 수정.