Spring Boot를 활용한 공동 도서관 대출 반납 관리 시스템 구축 및 운영 가이드

기술적 배경

Spring Boot는 Java 기반 애플리케이션 개발에서 널리 사용되는 경량화 프레임워크로, 자동화된 설정 및 내장형 웹 서버(Tomcat)를 통해 개발 효율성을 극대화합니다. 특히, 중소형 규모의 시스템 개발에 이상적인데, 도서관 대출 반납 시스템과 같은 비즈니스 로직 집중형 애플리케이션에 특히 유용합니다.

비즈니스 요구사항

현존하는 도서관 시스템은 종이 기반의 기록 방식이나 단일 머신에 구축된 시스템을 주로 사용하며, 이로 인해 데이터 손실, 정보 공유 어려움, 운영 효율성 저하等问题가 있습니다. 대출 반납 관리 시스템은 다음과 같은 핵심 기능을 제공해야 합니다:

도서 정보의 디지털화
대출 반납 프로세스의 자동화
사용자와 관리자 간의 역할 분리 및 협업

실질적 운영 효용

운영 효율성 향상: 온라인 대출 시스템은 사용자 중심의 편리한 UI를 제공하고,자동화된 알림 기능(예: 반납 마감일 통지)을 통해 운영 비용을 절감합니다.
데이터 보안 강화: 데이터베이스를 활용한 구조화된 데이터 저장으로 종이 기록의 손실 위험을 방지하고, 사용자 권한 제어로 개인정보 보호를 강화합니다.
확장성: Spring Boot를 기반으로 한 시스템은 새로운 기능(예: 온라인 예약,전자도서자원 통합)을 쉽게 추가할 수 있어 도서관 운영의 다변화에 대응할 수 있습니다.

사회적 가치

도서관의 자원을 효율적으로 관리하고 공유하는 것은 지식 공유와 문화 확산에 기여합니다. 특히,학교나 지역 커뮤니티 도서관에서 유용하게 활용될 수 있습니다. 또한,시스템의 통계 분석 기능은 도서 구입 계획 수립에 데이터 기반의 의사결정을 가능하게 합니다.

기술 스택 및 아키텍처

대출 반납 시스템은 다음과 같이 구성됩니다:

웹 서버 및 API

Spring Boot: 3.x 버전 사용
REST API: RESTful 인터페이스 구현
데이터 직렬화: JSON 형식으로 데이터 전송

데이터베이스

관계형 데이터베이스: MySQL 8.x
데이터 접근 계층: Spring Data JPA
데이터 검색: Elasticsearch를 통한 텍스트 검색

사용자 인터페이스

웹 프레임워크: Vue.js 3.x
UI 컴포넌트: Element UI
상태 관리: Vuex

보안 및 인증

인증 기반: JWT 토큰을 활용한 무상태 인증
권한 관리: Role-based 접근 제어
암호화: Bcrypt를 통한 강력한 암호 저장

핵심 코드 예시

도서 정보 엔티티

@Entity
public class Book {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long bookId;
    
    @NotBlank
    private String bookTitle;
    
    @ManyToOne
    private Author author;
    
    @Enumerated(EnumType.STRING)
    private BookStatus status; // 사용가능, 대출중

    // Getters and Setters
}

대출 기록 엔티티

@Entity
public class BorrowRecord {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long recordId;
    
    @ManyToOne
    private Book book;
    
    @ManyToOne
    private User user;
    
    private LocalDate borrowDate;
    private LocalDate returnDate;

    // Getters and Setters
}

데이터 접근 인터페이스

public interface BookRepository extends JpaRepository<Book, Long> {
    List<Book> findByTitleContaining(String keyword);
}

public interface BorrowRecordRepository extends JpaRepository<BorrowRecord, Long> {
    List<BorrowRecord> findByUser(User user);
}

비즈니스 로직 서비스

@Service
public class BookService {
    @Autowired
    private BookRepository bookRepository;

    public Book borrowBook(Long bookId, User user) {
        Book book = bookRepository.findById(bookId)
            .orElseThrow(() -> new ResourceNotFoundException("도서를 찾을 수 없습니다."));
        
        if (!book.isAvailable()) {
            throw new ResourceNotFoundException("이 도서는 이미 대출되었습니다.");
        }
        
        book.setStatus(BookStatus.ON_LOAN);
        return bookRepository.save(book);
    }
}

API 컨트롤러

@RestController
@RequestMapping("/api/books")
public class BookController {
    @Autowired
    private BookService bookService;

    @PostMapping("/{id}/borrow")
    public ResponseEntity<?> borrowBook(@PathVariable Long id, 
                                       @AuthenticationPrincipal User user) {
        bookService.borrowBook(id, user);
        return ResponseEntity.ok().body("도서를 대출했습니다.");
    }
}

데이터베이스 설계

다음은 시스템을 지원하기 위한 데이터베이스 스킴마입니다:

도서 테이블 (Books)

id: 도서 고유 ID
title: 도서명
author: 저자
isbn: ISBN 번호
status: 상태 (대출 중, 사용 가능)

대출 기록 테이블 (BorrowRecords)

id: 대출 기록 ID
book_id: 대출된 도서 ID
user_id: 대출자 ID
borrow_date: 대출일자
return_date: 반납일자

시스템 테스트

단위 테스트

@Test
public void testBorrowBook() {
    Book book = new Book();
    book.setStatus(BookStatus.AVAILABLE);
    when(bookRepository.findById(anyLong())).thenReturn(Optional.of(book));
    
    borrowService.borrowBook(1L, 1L);
    verify(bookRepository).save(book);
    assertEquals(BookStatus.ON_LOAN, book.getStatus());
}

통합 테스트

@Test
public void testBorrowApi() throws Exception {
    mockMvc.perform(post("/api/books/1/borrow")
            .param("userId", "1"))
            .andExpect(status().isOk());
}

태그: Spring Boot java REST API 데이터베이스 보안

6월 5일 22:45에 게시됨

괴물 클럽