📚 Libris - 나만의 독서 관리 서비스

Libris는 개인 독서 활동을 체계적으로 관리하고 분석할 수 있는 웹 애플리케이션입니다. 독서 목표 설정, 감상문 작성, AI 코치 기능을 통해 더욱 풍부한 독서 경험을 제공합니다.

✨ 주요 기능

📖 도서 관리

• Google Books API 연동: 도서 검색 및 자동 정보 입력
• 책장 관리: 읽을 예정, 읽는 중, 완독 상태 관리
• 상세 정보: 표지, 저자, 출판사, ISBN, 페이지 수 등
• 별점 및 평가: 5점 만점 별점 시스템

📝 감상문 및 노트

• 감상문 작성: 자유로운 형식의 독서 감상 기록
• 인상 깊은 구절: 책에서 마음에 든 문장 저장
• AI 독서 코치: 감상문 분석 및 피드백 제공
• 태그 시스템: 도서 분류 및 검색

📊 독서 통계

• 연간/월간 목표: 독서 목표 설정 및 달성률 추적
• 다양한 차트: 월별 독서량, 장르별 분포, 주간 독서시간
• 독서 시간 추적: 실제 독서 시간 입력 및 분석
• 최근 독서 기록: 최근 읽은 책 목록

🔔 알림 시스템

• 브라우저 알림: 목표 달성, 책 추가 등 실시간 알림
• 앱 내 알림: 헤더에서 모든 알림 확인
• 설정 가능: 원하는 알림만 선택적으로 수신

🎯 목표 관리

• 연간 독서 목표: 올해 읽을 책 목표 설정
• 월간 독서 목표: 월별 독서량 목표
• 진행률 추적: 실시간 목표 달성률 확인
• 목표 달성 알림: 목표 달성 시 자동 알림

🚀 기술 스택

• Frontend: Next.js 15, React 19
• Styling: Tailwind CSS
• Charts: Recharts
• Icons: Lucide React
• Calendar: React Calendar
• AI: OpenAI GPT-3.5 Turbo
• Storage: LocalStorage (클라이언트 사이드)

📦 설치 및 실행

1. 저장소 클론

git clone [repository-url]
cd libris

2. 의존성 설치

npm install
# 또는
pnpm install

3. 환경 변수 설정

.env.local 파일을 생성하고 다음 내용을 추가하세요:

OPENAI_API_KEY=your_openai_api_key_here

4. 개발 서버 실행

npm run dev
# 또는
pnpm dev

브라우저에서 http://localhost:3000을 열어 확인하세요.

🏗️ 프로젝트 구조

libris/
├── src/
│   ├── app/
│   │   ├── (dashboard)/          # 대시보드 레이아웃
│   │   │   ├── add/             # 도서 추가
│   │   │   ├── bookshelf/       # 내 책장
│   │   │   ├── notes/           # 감상문 관리
│   │   │   ├── profile/         # 프로필 설정
│   │   │   ├── settings/        # 앱 설정
│   │   │   └── stats/           # 독서 통계
│   │   ├── api/                 # API 라우트
│   │   │   └── ai-coach/        # AI 코치 API
│   │   ├── components/          # 공통 컴포넌트
│   │   │   ├── header.jsx       # 헤더 (알림 포함)
│   │   │   └── sidebar.jsx      # 사이드바
│   │   └── utils/               # 유틸리티 함수
│   │       └── notifications.js # 알림 시스템
│   └── public/                  # 정적 파일
└── package.json

🎮 사용 방법

1. 도서 추가

1. 도서 추가 메뉴로 이동
2. 제목 또는 저자명으로 검색
3. 원하는 도서 선택 후 추가
4. 상세 정보 수정 및 저장

2. 독서 기록

1. 내 책장에서 도서 선택
2. 읽기 상태 변경 (읽을 예정 → 읽는 중 → 완독)
3. 감상문 작성 및 별점 평가
4. 인상 깊은 구절 저장

3. AI 코치 활용

1. 감상문이 있는 도서에서 AI 분석 클릭
2. AI가 감상문을 분석하여 피드백 제공
3. 확장 질문, 글쓰기 팁, 관련 도서 추천

4. 통계 확인

1. 통계 메뉴에서 다양한 차트 확인
2. 개요, 차트, 최근 도서 탭으로 분류
3. 월별 독서량, 장르별 분포 등 분석

5. 알림 설정

1. 설정 메뉴에서 알림 옵션 관리
2. 브라우저 알림 권한 허용
3. 원하는 알림만 선택적으로 활성화

🔧 주요 기능 상세

AI 독서 코치

• 감상문 분석: AI가 작성한 감상문을 분석
• 개선 제안: 더 나은 감상문 작성을 위한 팁 제공
• 확장 질문: 깊이 있는 사고를 위한 질문 제시
• 관련 추천: 비슷한 도서나 키워드 추천

독서 시간 추적

• 실제 시간 입력: 읽기 시작일과 완독일, 총 독서시간 입력
• 정확한 통계: 페이지당 독서시간, 평균 독서시간 계산
• 주간 분석: 요일별 독서 패턴 분석

알림 시스템

• 목표 달성 알림: 연간/월간 목표 달성 시 자동 알림
• 책 추가 알림: 새 도서 추가 시 알림
• 독서 스트릭: 연속 독서 기록 달성 알림
• 월간 리포트: 매월 독서 통계 요약

🤝 기여하기

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

📞 문의

프로젝트에 대한 질문이나 제안사항이 있으시면 이슈를 생성해 주세요.

---

Libris와 함께 더욱 풍부한 독서 경험을 만들어보세요! 📚✨