# 하눈찬송 (Hanoon Hymn)

> 한국 교회 찬송가 악보, 가사, 반주 음원을 무료로 제공하는 웹 서비스입니다.
> URL: https://hymn.hanoon.app

## 서비스 소개
하눈찬송(하나님의 눈동자 같은 찬송을)은 한국 교회에서 사용하는 찬송가의 악보, 가사, 반주 음원을
언제 어디서나 쉽게 찾아볼 수 있도록 제공하는 무료 웹 서비스입니다.

## 콘텐츠
- 새찬송가 645장 + 통일찬송가 558장 = 총 1,203장
- 각 찬송: 악보(WebP 이미지), 가사(텍스트), 반주 음원(오디오)
- 악보 버전: 4부 합창, 단선율 등 복수 버전 제공
- 음원 버전: 피아노, 오르간, 합창 등 복수 버전 제공
- MIDI 파일 제공 (반주 연습용)

## 주요 기능
- 번호/제목/초성/가사 통합 검색
- 교회력 절기별 추천 찬송 (대림절, 성탄절, 사순절, 부활절, 성령강림절 등)
- 인기 찬송 트렌딩 (일간/주간/월간)
- 주제별 분류 (예배, 헌신, 찬양, 기도, 소망, 위로 등)
- 새찬송가 ↔ 통일찬송가 교차 참조
- 좋아요, 북마크, 공유
- 은혜 나눔 (댓글로 찬송가 감상 공유)
- 악보 전체화면 모드 (화면 꺼짐 방지)

## 주요 URL 패턴
- / — 홈 (검색, 절기 추천, 인기 찬송, 주제별 찾기)
- /hymn/new/{번호}/ — 새찬송가 상세 페이지 (악보, 가사, 음원, 메타정보)
- /hymn/unified/{번호}/ — 통일찬송가 상세 페이지
- /themes/ — 주제별 찬송 목록
- /themes/{주제}/ — 특정 주제 찬송 목록
- /seasons/ — 절기별 찬송 목록
- /seasons/{절기}/ — 특정 절기 찬송 목록
- /trending/ — 인기 찬송 순위
- /community/ — 은혜 나눔 (댓글 피드)
- /about/ — 서비스 소개
- /contact/ — 연락하기

## 찬송가 메타데이터 (각 찬송별 제공 정보)
- 곡 번호, 제목
- 작곡가, 작사가
- 조성(Key), 박자(Meter)
- 성경 참조 구절
- 주제 태그, 절기 태그
- 예배 용도 (예: 경배, 헌금, 축도 등)
- 새찬송가 ↔ 통일찬송가 교차 참조 번호

## 자주 묻는 질문 (FAQ)

### 하눈찬송은 무료인가요?
네, 하눈찬송의 모든 콘텐츠(악보, 가사, 음원)는 무료로 이용할 수 있습니다.

### 새찬송가와 통일찬송가의 차이는 무엇인가요?
통일찬송가(1983년)는 이전에 사용하던 찬송가이고, 새찬송가(2006년)는 현재 대부분의 한국 교회에서 사용하는 최신 찬송가입니다. 하눈찬송에서는 두 찬송가의 교차 참조를 제공합니다.

### 예배 중에 활용할 수 있나요?
네, 악보 전체화면 모드에서는 화면 꺼짐 방지(Wake Lock)가 자동으로 활성화되어 태블릿이나 스마트폰으로 악보를 보면서 찬양할 수 있습니다.

### 오프라인에서도 사용할 수 있나요?
한번 방문한 악보와 음원은 브라우저에 캐싱되어 재방문 시 빠르게 로드됩니다.

## 기술 스택
- 프레임워크: Astro (정적 사이트 생성)
- 호스팅: Cloudflare Pages
- 미디어: Cloudflare R2 CDN
- 데이터베이스: Supabase (PostgreSQL)

## 연락처
- /contact/ 페이지를 통해 문의