사이트 설정 관리 추가

docs/history.md

@@ -1,5 +1,13 @@
 # 의사결정 이력
 
+## 2026-05-02 v0.0.24
+
+### 빈 줄 입력 보존과 사이트 설정 범위 결정
+
+관리자 블록 에디터는 마지막에 클릭 가능한 빈 문단을 유지하지만, 사용자가 Enter로 만든 연속 빈 문단은 자동 삭제하지 않는다. 글 작성 중 여러 줄을 띄워 생각의 구간을 나누는 행동이 자연스럽고, 보조 입력 블록 정리 로직이 사용자의 입력 의도를 지우면 안 되기 때문이다.
+
+사이트 설정은 우선 단일 `site_settings` 레코드로 관리한다. 개인 블로그 초기 단계에서는 여러 사이트나 다국어 설정보다 사이트 이름, 설명, 기본 URL, 텍스트 로고, 저작권 문구를 안정적으로 저장하고 공개 화면에 반영하는 흐름이 더 중요하다. 이미지 기반 로고와 프로필 이미지는 미디어 사용처 추적과 연결해야 하므로 이후 미디어 설정 확장 단계에서 다룬다.
+
 ## 2026-05-02 v0.0.23
 
 ### 고정 페이지 관리 구조 결정

docs/map.md

@@ -17,7 +17,7 @@
 |------|-----------|
 | components/site/SiteHeader.vue | 모든 공개 페이지 상단 |
 | components/site/LeftSidebar.vue | 메인 화면 왼쪽 |
-| components/site/RightSidebar.vue | 메인 화면 오른쪽 |
+| components/site/RightSidebar.vue | 메인 화면 오른쪽, 사이트 설정 표시 |
 | components/site/MainColumn.vue | 메인 화면 중앙 |
 | components/site/PostCard.vue | 목록의 게시물 카드, 대표 이미지 썸네일 |
 | components/site/TagHeader.vue | 태그 페이지 헤더 |
@@ -91,6 +91,7 @@
 | server/api/pages.get.js | 고정 페이지 목록 샘플 API |
 | server/api/pages/[slug].get.js | 고정 페이지 상세 샘플 API |
 | server/api/tags.get.js | 태그 목록 샘플 API |
+| server/api/site-settings.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 |
@@ -113,12 +114,16 @@
 | server/routes/admin/api/tags/[id].get.js | 관리자 태그 상세 API |
 | server/routes/admin/api/tags/[id].put.js | 관리자 태그 수정 API |
 | 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/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-tag-input.js | 관리자 태그 입력값 검증 스키마 |
+| server/utils/site-settings.js | 사이트 설정 기본값 유틸리티 |
 | server/utils/media-library.js | 업로드 미디어 파일 관리 유틸리티 |
 | server/repositories/postgres-client.js | PostgreSQL 클라이언트 |
 | server/repositories/content-repository.js | 콘텐츠 조회 저장소 |
@@ -130,6 +135,7 @@
 | db/migrations/001_initial_schema.sql | PostgreSQL 초기 테이블 스키마 |
 | db/migrations/002_seed_development.sql | 개발용 샘플 데이터 |
 | db/migrations/003_add_tag_display_fields.sql | 태그 표시 순서와 색상 필드 추가 |
+| db/migrations/004_add_site_settings.sql | 사이트 설정 테이블 추가 |
 
 ## 설정/배포
 

docs/spec.md

@@ -154,6 +154,18 @@ components/content/
 | created_at | DateTime | 생성일 |
 | updated_at | DateTime | 수정일 |
 
+### SiteSettings
+
+| 필드 | 타입 | 설명 |
+|------|------|------|
+| id | Integer | 단일 설정 레코드 ID, 항상 1 |
+| title | String | 사이트 이름 |
+| description | String | 사이트 설명 |
+| site_url | String | 사이트 기본 URL |
+| logo_text | String | 텍스트 로고 |
+| copyright_text | String | 저작권 문구 |
+| updated_at | DateTime | 수정일 |
+
 ### PostTags (다대다)
 
 | 필드 | 타입 | 설명 |
@@ -185,6 +197,7 @@ components/content/
 - `GET /api/pages` - 고정 페이지 목록
 - `GET /api/pages/:slug` - 고정 페이지 상세
 - `GET /api/tags` - 태그 목록
+- `GET /api/site-settings` - 공개 사이트 설정
 
 ### 관리자 API (`/admin/api/`)
 
@@ -210,6 +223,8 @@ components/content/
 - `GET /admin/api/tags/:id` - 태그 상세
 - `PUT /admin/api/tags/:id` - 태그 수정
 - `DELETE /admin/api/tags/:id` - 태그 삭제
+- `GET /admin/api/settings` - 사이트 설정 조회
+- `PUT /admin/api/settings` - 사이트 설정 수정
 
 > 글 발행/초안/비공개 전환은 현재 `PUT /admin/api/posts/:id`의 `status` 값으로 처리한다.
 > 태그 삭제 시 `post_tags` 연결도 데이터베이스 외래 키 규칙에 따라 함께 삭제된다.
@@ -262,6 +277,13 @@ components/content/
 - 고정 페이지는 게시물 목록과 태그 목록에 노출하지 않는다.
 - 고정 페이지 공개 보기 경로는 `/pages/:slug`를 사용한다.
 
+### 사이트 설정
+
+- 사이트 설정은 `site_settings` 테이블의 단일 레코드로 관리한다.
+- 관리자는 사이트 이름, 설명, 사이트 URL, 텍스트 로고, 저작권 문구를 수정할 수 있다.
+- 공개 헤더와 오른쪽 사이드바는 공개 사이트 설정 API 값을 사용한다.
+- DB 연결이 없는 환경에서는 환경 변수와 기본값 기반 설정을 사용한다.
+
 ### 관리자 인증
 
 - 초기 관리자 인증은 `ADMIN_EMAIL`, `ADMIN_PASSWORD` 환경 변수를 사용

docs/todo.md

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

docs/update.md

@@ -1,5 +1,15 @@
 # 업데이트 이력
 
+## v0.0.24
+
+- 관리자 블록 에디터에서 마지막 빈 문단 Enter 입력 시 연속 빈 줄이 유지되도록 수정.
+- 사이트 설정 데이터베이스 테이블 추가.
+- 공개 사이트 설정 조회 API 추가.
+- 관리자 사이트 설정 조회/수정 API 추가.
+- 관리자 사이트 설정 화면을 실제 저장 API와 연결.
+- 공개 헤더와 오른쪽 사이드바에 사이트 설정 값을 연결.
+- 패키지 버전을 0.0.24로 갱신.
+
 ## v0.0.23
 
 - 관리자 고정 페이지 목록 화면을 실제 API와 연결.