작성일(2025.04.18)

기술 스택

Backend

• Java 17
• Spring Boot 3
• Spring Data JPA
• Redis (검색 캐싱)
• MySQL (RDBMS)
• Jsoup (크롤링)

Frontend

• React + Vite
• Tailwind CSS
• Shadcn UI
• Lucide Icons

DevOps

• Docker Compose
• GitHub Actions (CI/CD //현재 CD부분 설계중)

---

🔖 커밋 타입(Type)

타입	설명
feat	새로운 기능 추가
fix	버그 수정
docs	문서 수정 (README 등)
style	코드 스타일 변경 (공백, 세미콜론 등)
refactor	코드 리팩토링 (기능 변화 없음)
test	테스트 코드 추가 및 수정
chore	빌드 설정, 패키지 관리, 기타 잡작업
ci	CI 설정 관련 변경
perf	성능 개선

---

데이터 모델

엔티티 관계

• User
  • 사용자 정보 (현재는 마스터 계정 기반 테스트)
• Album
  • 앨범 기본 정보 (title, artist, releaseDate 등)
• AlbumStock
  • 사이트별 판매 정보 (siteName, productUrl, price, soldOut 등)
• Favorite
  • 사용자-앨범 즐겨찾기 관계

---

REST API 명세 (일부)

[POST] /api/search

• LP 앨범 키워드 검색 (Redis 캐싱 우선)

[POST] /api/favorites/toggle

• 즐겨찾기 토글 (등록/해제)

[GET] /api/favorites/{userId}

• 특정 유저의 즐겨찾기 앨범 목록 조회

[POST] /api/auth/signup

• 회원가입

[POST] /api/auth/login

• 로그인 / 세션 생성

---

크롤링 전략

• Jsoup 기반 HTML 파싱
• TowerRecordsCrawler, Yes24Crawler 각각 구현(+추후 추가예쩡)
• CrawlingService에서 병렬 실행
• 검색어 기반 크롤링 후 Redis에 저장 (TTL 설정)
• Batch Scheduling을 이용하여 Redis 데이터를 주기적으로 DB에 이관

---

프론트엔드 주요 기능

• LP 앨범 검색창
• 사이트별 탭 필터링 및 강조 애니메이션
• 재고 있음/절판 상태 표시
• 절판 숨기기 체크박스
• 즐겨찾기 토글 및 강조
• productUrl 바로가기 링크
• 무한 스크롤 로딩

---

시퀀스 다이어그램

---

향후 개선사항

• 사용자 로그인 및 세션 기반 즐겨찾기 저장
• 검색 결과 무한 스크롤 API 및 UI 구현
• 모바일 UI 대응
• 실시간 검색어
• 다국어 대응(영어/한국어)
• 앨범별 출시일/발매가 데이터 확보

---

스크린샷

메인화면

크롤링검색

나의 즐겨찾기 화면

마이페이지 화면

---

개발자

• 김유민 (Yumin Kim)
• GitHub: github.com/minyou2675
• 기술 스택: Java, Spring Boot, React, Docker, MySQL, Redis