🦄Change Log

v2.1.0 - 2025.07.14

✨ 새로운 기능 (Features)

• Spring-boot-admin client 도입

  • 모니터링 기능을 구현하였습니다.

v2.0.0 - 2025.06.01

BookMeta Entity를 새롭게 도입하여 Collection을 본연의 기능에 충실 할 수 있도록 개선

✨ 새로운 기능 (Features)

• BookMeta 도입

  • 기존 Book 엔티티에 기입되었던 Book의 Meta 정보를 BookMeta라는 별도의 엔티티에 기입하도록 개선하였습니다.

  • 이를 통해 Book은 Book 본연의 기능에 충실할 수 있게 되었습니다.

• BookMetaCollection Entity 도입

  • 기존 BookCollection 엔티티를 제거하고 BookMetaCollection 엔티티를 도입하였습니다.

  • Collection은 책의 기본정보만을 보여주도록 개선하였습니다. 이를 통해 컬렉션은 본연의 기능에 충실할 수 있게 되었습니다.

🚀 개선사항 (Improvements)

• Collection API spec 개선

  • collection의 api 엔드포인트네이밍이 RESTful하게 변경되었습니다.

  • create/add/delete 등의 네이밍 사용을 지양함으로써 RESTful하게 변경되었습니다.

📝 기타 변경사항 (Other Changes)

• springdoc-openapi-starter-webmvc-ui 도입

  • api reference를 웹페이지에서 손쉽게 파악할 수 있게 되었습니다.

v1.0.0 - 2025.05.23

Gomdolbook 백엔드의 첫 번째 정식 릴리즈입니다! 이 버전에서는 사용자의 독서 경험을 풍부하게 하고, 효율적인 책 관리를 돕는 핵심 기능들을 제공합니다.

✨ 새로운 기능 (Features)

• 독서 기록 관리:

  • 책의 독서 상태(READING, FINISHED, TO_READ, NEW)를 저장하고 관리할 수 있습니다.

  • 각 책에 대한 세 가지 개인 노트(note1, note2, note3)를 작성하고 수정할 수 있습니다.

  • 책에 대한 별점(rating)을 기록하고 업데이트할 수 있습니다.

  • 책의 독서 시작일(startedAt)과 완료일(finishedAt)을 기록하여 독서 습관을 추적할 수 있습니다.

  • 완료된 책들의 월별 목록을 캘린더 형식으로 조회하여 독서 현황을 파악할 수 있습니다 (GET /v1/book/calendar/finished)

  • 특정 독서 상태에 해당하는 내 서재 목록을 조회할 수 있습니다 (GET /v1/book/Library)

• 책 컬렉션 기능:

  • 사용자 정의 이름으로 책 컬렉션을 생성할 수 있습니다 (POST /v1/collection/create)

  • 생성된 컬렉션에 책을 추가하거나 (POST /v1/collection/{name}/book/add) 컬렉션에서 책을 제거할 수 있습니다 (DELETE /v1/collection/{name}/book/remove)

  • 자신이 만든 모든 컬렉션 목록과 각 컬렉션에 포함된 책들의 커버 이미지를 조회할 수 있습니다 (GET /v1/collection/list)

  • 특정 컬렉션에 포함된 모든 책의 상세정보를 조회할 수 있습니다 (GET /v1/collection/{name})

  • 특정 컬렉션을 삭제할 수 있습니다 (DELETE /v1/collection/delete)

• 알라딘 API 연동:

  • ISBN 또는 검색어(query)를 통해 알라딘 API에서 도서 정보를 검색하고 상세정보를 가져올 수 있습니다.

  • 알라딘 API로부터 가져온 도서 정보는 Caffeine 기반의 비동기 캐시를 사용하여 응답 속도를 향상시키고 API 호출을 최소화합니다.

• 사용자 인증 및 인가:

  • OAuth2 Resource Server (JWT)를 사용하여 사용자 인증 및 인가를 처리합니다. email 클레임을 기반으로 사용자를 식별합니다.

  • @UserCheckAndSave 어노테이션과 AOP(EmailUserValidationAspect)를 통해 새로운 사용자의 경우 자동으로 시스템에 등록합니다.

🚀 개선사항 (Improvements)

• 시스템 아키텍처:

  • Spring Boot (Java 17+, Jakarta EE 사용) 기반으로 견고하고 확장 가능한 백엔드 구축

  • Spring Data JPA와 QueryDSL을 활용한 효율적인 데이터 접근 및 복잡한 쿼리 구현

  • Caffeine 기반의 로컬 캐시 적용 (readingLogCache, statusCache, bookByIsbnCache, libraryCache, collectionListCache, collectionCache, finishedBookCalendarData)으로 반복적인 데이터 조회 성능 최적화

  • AOP (TraceAspect)를 통한 서비스 및 리포지토리 메소드 로깅

  • 전역 예외 처리 (CustomExceptionHandler)를 통해 일관된 오류 응답 제공

  • CQRS 패턴 적용을 위한 Command 및 Handler 인터페이스/클래스 분리 (예: BookSaveCommand, BookSaveHandler)

  • API 응답 통일: ApiResponse 래퍼 클래스를 사용하여 일관된 API 응답 구조 제공

  • CORS 설정: 특정 오리진(https://www.gomdolbook.kr)에 대한 CORS 요청 허용

🛠️ 버그 수정 (Bug Fixes)

📝 기타 변경사항 (Other Changes)

• Gradle 버전 8.11.1 사용

• 데이터베이스 스키마 정의 (schema.sql)

• 단위 테스트 및 통합 테스트 코드 작성 (src/test/java 경로)