ReadHub 프로젝트 회고 - 01

📝 프로젝트 회고

Readhub 전자도서관 개인 프로젝트를 진행하면서
프로젝트를 하며 느낀 점을 정리하면서, 끝날 때까지 어떻게 발전할 수 있을지 회고하는 시간을 가지려고 한다!

📌 프로젝트 목표

• 써보지 않았던 새로운 스택/기술들을 적용해보기!
• 소프트웨어 설계, 개발, 테스트는 물론 배포까지 경험해 보기!
• 복잡도가 있는 프로젝트 도전!

 

🔧 진행 상황

유저

• Spring Security & JWT 기반 로그인 구현
• 카카오톡 소셜 로그인 구현 → 카카오 계정을 통한 간편 로그인 처리 및 회원 자동 생성
• Redis를 활용하여 로그아웃 시 토큰을 블랙리스트 처리 및 사용 중이던 Access Token과 Refresh Token을 무효화
• 유저/관리자 권한 분리 및 인증 처리

도서

• 도서 등록 / 수정 / 삭제 / 검색 구현
• 인기 도서 조회 (조회수 기반)
• 도서 상태 변경 (대출 불가능 도서 처리)
• 대출한 도서의 내용 조회 -> 페이지별 조회

대출 / 반납

• 도서 대출 및 반납
• 대출 취소 / 연장 신청 기능
• 대출 도서 현황 및 목록 조회 

예약

• 도서 예약 신청 / 취소
• 예약 목록 조회

리뷰

• 리뷰 등록 / 수정 / 삭제 / 상세 조회
• 도서별 리뷰 목록 조회

관리자

• 전체 개인 유저 목록 조회
• 특정 유저 정보 조회 및 상태 변경
• 전체 대출 요청 목록 조회
• 단체 유저 조회 및 관리

 

 

🎉 잘한 점 (Keep)

이번 프로젝트에서는 Spring Security & JWT 로그인뿐만 아니라 카카오톡 소셜 로그인도 함께 도입하고
JWT 기반의 로그아웃 처리를 위한 Redis 연동까지 구현했다. 카카오톡 로그인을 구현하며 OAuth2 인증의 

인증 코드 발급 -> 토큰 교환 -> 사용자 조회 흐름을 이해하며 클라이언트 - 서버의 흐름을 조금 더 이해하게 되었다.

그리고 JWT 인증 방식과 통합하여 유지보수에 좀 더 용이한 코드를 구현한 점도 잘한 점이라고 생각한다..!

 

또한 레디스를 활용하여 로그아웃을 구현하며, JWT는 상태를 가지지 않아 서버에서 무효화하지 못하고 이 부분을 

해결하기 위해 레디스를 사용해 블랙리스트 등록 방식으로 무효화한다는 사실을 알게 되었고 구현하면서 단순 캐시로

생각했던 레디스가 토큰 세션 관리 같은 인증 보안에도 쓰이는 저장소 역할도 한다는 것을 체감하게 되었다..! 

그리고 데이터 만료 처리에 대한 중요성과 예외 처리 서비스 안정성 즉 보안에 대한 이해가 한층 올라간 것 같다

 

로그인 -> 로그아웃 이 전체의 흐름을 이해하고 하나의 인증 시스템으로 통합적으로 설계하고 토큰 관리 전략을 고민하며

전의 프로젝트보다는 실제 서비스에 가깝게 구현한 배운 게 인증 시스템에 대한 깊이를 넓히고 많이 배운 좋은 경험이었다.

📍문제점 (Keep)

기술적으로 많은 배움이 있었지만 아쉬운 부분도 몇 가지 있다..!

 

첫 번째,

조금 더 세심한 깃 커밋 관리를 했었으면 하는 부분이 아쉽다.
구현에 빠져서 기능단위로 세세하게 커밋하려고 했지만 하나의 커밋에 너무 많은 변경사항과 구현이 담기게 되었다.

팀 프로젝트 시에는 다른 팀원이 볼 것이니까 하면서 조금 더 신경 썼었던 같은데 개인프로젝트 다 보니 세세히 신경을 쓰지 못한 것 같다.

이 문제를 깨닫게 된 점은 커밋 히스토리를 보며 메시지에 남겨진 부분과 다른 내용이 포함되어 있었고 어떤 기능에 대해 문제가 생겼을

때 추적하는데 파악이 힘들어 많은 시간이 소요되었다..!

 

두 번째,

새로운 기능 적용과 구현할 것이 많아 빠르게 해야지!라는 생각에 로깅이나 테스트 코드 작성은 나중에 해야지라고 생각하며 우선순위에서

밀리게 되었다. 하지만 빠르게 구현된다라고 생각했지만 에러가 생겼을 때 해결하며 느끼게 되었다.

디버깅에 많은 시간이 소요되었고 데이터베이스를 직접 확인하며 체크하다 보니 오히려 개발 효율성이 떨어졌다는 생각이 많이 들었다..!

그리고 기능을 하나씩 구현하며 포스트맨으로 확인하며 구현했지만 기능들이 많아지면서 어느 순간 이전 기능이 깨지고 수정하는 부분이 생기다 보니 테스트코드도 작성했다면 자동으로 검증하여 놓치는 부분 없이 좀 더 꼼꼼한 테스트가 되지 않았을까..!라고 생각한다.

개발 후기로 가면서 유지보수, 배포 전 검증, 안정성을 위해 예전처럼 다시 테스트 코드 작성을 습관 하지 않은 것이 아쉬웠다.. 

 

 

✏️ 시도할 부분 (Try)

• 작업 내용을 정리하며 기능별로 Git에 커밋하는 습관 들이기
• 서비스, 컨트롤러에 로그 남기기 
• 하나의 기능 구현 후 바로바로 JUnit 테스트와 Mock 객체를 활용한 서비스 단위 테스트 작성
• Artillery이나 Jmeter 테스트로 더 자세한 환경설정 고려
• 데이터 처리에 대한 고민 해왔던 것처럼 놓치지 않기
• 지금처럼 유지보수 용이한 코드 작성에 집중하기

 

🗓️ 앞으로의 계획

• 알림 기능 구현 (ApplicationEventPublisher -> 레디스저장)
• 개인별 맞춤 추천 도서 제공
• 찜하기 기능 구현 
• 통계기능 구현 → 대출 건수/ 연체도서 / 대출 상태별 도서 조회/ 가장 많이 대출된 도서 조회/ 카테고리별 인기 도서 조회
• 연체기능 구현 → 대여불가 취소 승인/연체상태 변경/연체 자동 등록
• MSA 서비스 분할 
• AWS 배포

 

 🔥마지막으로

이번 프로젝트는 단순히 기능을 구현한 것이 아니라 내가 왜 이 기능을 구현하고 왜 이 기술을 선택했는지 꼭 알면서
적용하는 게 이번 프로젝트를 하며 가장 중요하게 생각한 목표였다.!

회고글을 쓰며 이 태도를 유지하고 있는지 점검해 보며 처음에 단순하게 시작했지만 점점 확장되면서 완성되어 가는 프로젝트를 

보며 많이 성장하고 목표를 유지하고 있다는 생각이 들어 뿌듯한 마음이 들었다!

 

무조건 기능을 만들기보다는 구조를 설계하고 흐름을 파악하며 개발하는 것이 진짜 내 코드라는 느낌과 재미있다고 생각했다!!

코드를 작성하며 항상 유지보수를 위해 끊임없이 고민하고, 해결해 가며 많이 성장했다는 생각도 들고 많은 것을 느꼈다.

 

앞으로 적용해보고 싶은 기술도 많기 때문에 처음에 생각했던 태도를 잊지 말고 열심히 나아가야겠다는 다짐을 하게 한 순간이었다.

다음 회고글을 작성할 때는 조금 더 성장해 있기를 바라본다..!!