# 구스팜 위키독스 스타일 블로그 시나리오

**작성일**: 2025-01-23
**작성자**: happybell80
**상태**: 시나리오 설계 중

---

## 1. 독자 시나리오

### 순차 학습
- 목차에서 다음 글 클릭 → 진행률 표시 → 완독 후 다음 장 자동 추천
- 시리즈 시작부터 순서대로 읽으며 학습 흐름 유지

### 검색/탐색
- 검색어 입력 → 관련 장/절 하이라이트 → 클릭으로 바로 이동
- 내부 링크 `[[다른 문서]]` 클릭 → 관련 시리즈 추천

### 북마크/이어보기
- 중간 저장 → 재방문 시 "이어보기" 버튼 → 마지막 읽은 위치로 복귀
- 여러 시리즈 동시 진행 시 각각의 진행률 표시

### 관련 콘텐츠 발견
- 본문 내부 링크 클릭 → 관련 시리즈 추천
- 태그 기반 유사 콘텐츠 자동 추천

---

## 2. 작성자 시나리오

### 시리즈 기획
- 새 책 생성 → 장/절 구조 미리 설계 → 빈 틀 생성 후 순차 작성
- 목차 구조만 먼저 만들고 나중에 콘텐츠 채우기

### 협업 편집
- 여러 작성자가 동시 편집 → 변경 이력 추적 → 리뷰 후 병합
- 실시간 편집 충돌 방지 및 해결

### 콘텐츠 재구성
- 장 순서 변경(drag & drop) → 자동으로 목차/네비게이션 업데이트
- 장/절 이동 시 내부 링크 자동 업데이트

---

## 3. 관리자 시나리오

### 통계 분석
- 시리즈별 조회수/완독률 → 인기 장/절 파악 → 콘텐츠 전략 조정
- 사용자 행동 패턴 분석 (어디서 이탈하는지, 어떤 경로로 탐색하는지)

### A/B 테스트
- 목차 위치(좌측/우측), 검색 UI 비교 → 전환율 측정
- 레이아웃 최적화를 위한 데이터 기반 의사결정

---

## 4. 핵심 UX 요소

### 좌측 트리 목차
- 현재 위치 하이라이트
- 접기/펼치기 기능
- 진행률 표시 (읽은 장/절 표시)

### 우측 본문
- 제목/저자/날짜 정보
- 마크다운 렌더링 (KaTeX 수식 지원)
- 이전/다음 네비게이션

### 상단 헤더
- 시리즈명 + 저자
- 진행률 프로그레스바
- 검색 기능

---

## 5. 기술적 요구사항

### 데이터 구조
- Book (시리즈) → Chapter (장) → Section (절/포스트) 계층 구조
- 기존 `blog` 테이블 확장 또는 `books`, `chapters` 테이블 신설

### 레이아웃
- 좌측 목차 250px 고정 (sticky)
- 우측 본문 반응형 (모바일에서는 목차 토글)

### 내부 링크
- `[[문서명]]` 형식 자동 변환
- 링크된 문서 존재 여부 검증

---

*위키독스 스타일의 계층적 문서 관리 시스템으로 구스팜 블로그를 확장*