프로젝트 개요 및 목적

• 인원: 1명
• 기간: 2025.06~2025.08 (10주)
• 목적: 흩어진 공부 환경을 하나로 통합하여 계획-실천-기록-성취 사이클을 만들어 학습 효율을 높이는 학습 관리 서비스입니다. 학습 및 성과 분석이 가능해, 보다 편리하고 효율적인 학습 환경을 경험할 수 있습니다.

현재 백엔드 API만 개발해 자체 도메인에서 테스트 운영 중이며, 추후 보안 강화와 프론트엔드를 구현해 서비스 고도화를 계획하고 있습니다.

사용 기술 및 이유

• 백엔드
  • Java 17, Spring Boot 3.2.5: 프로젝트 환경에 맞춰 안정적으로 사용 가능한 버전을 선택했습니다.
  • Spring Security, JWT, Redis: 사용자 인증/인가 및 토큰 상태 관리에 사용됩니다.
  • JPA, QueryDSL: 기본적인 CRUD와 연관관계 쿼리는 JPA Repository 쿼리 메서드로 구현했으며, 날짜/카테고리/키워드 등 복합 조건이 필요한 조회 로직은 QueryDSL을 활용해 효율적으로 처리했습니다.
  • JavaMailSender: 메일 전송 라이브러리로, SMTP 서버와 통신해 이메일 인증 코드를 발송했습니다.
  • SSE: 간단한 구현으로 서버에서 클라이언트로 단방향 실시간 이벤트 전송이 가능하여 계획 자동 완료 알림 기능에 사용했습니다.
• 프론트 (개발 예정)
  • React
• DB
  • MariaDB: 이전 프로젝트에서 사용한 경험이 있어 익숙하고, AWS RDS를 통해 운영할 수 있어 선택했습니다.
  • Redis: 메모리 기반으로 매우 빠른 속도와 TTL 설정이 가능해 이메일 인증 코드 저장(2분), 토큰 관리에 활용했습니다.
• Infra/DevOps
  • EC2, RDS: EC2에 배치한 웹 서버와 DB 서버를 분리하고 RDS로 관리해 서버 간의 통신 보안을 강화했습니다.
  • Nginx, Certbot: 구매한 도메인에 HTTPS 인증서를 적용하고, Nginx 리버스 프록시로 HTTPS 요청을 처리했습니다.
  • Github Actions: CI/CD 파이프라인을 구축하여 코드 변경 시 자동으로 배포되도록 했습니다.
• Monitoring
  • Prometheus, Grafana: Prometheus로 메트릭을 수집하고 Grafana로 시각화해 모니터링했습니다.

문서화, 설계 도구

• Swagger + Github Pages: Swagger를 통해 API를 자동 문서화하고, Github Pages에 배포하여 외부에서 문서를 확인하고 테스트할 수 있도록 했습니다.
• Draw.io, Canva: 다이어그램과 플로우 차트, 시스템 구조를 시각 자료로 정리했습니다.
• VS code: ERD Editor 확장자를 활용하여 데이터베이스 구조를 시각적으로 설계했습니다.

API 명세서 및 ERD

• Swagger API 문서

  Swagger UI

• DB ERD

  

  User 테이블: 회원 정보 테이블. Lap 테이블을 제외한 모든 테이블과 1:N 관계

  Category 테이블: 카테고리 저장 테이블. 회원가입 시 <기타> 카테고리가 자동 생성되며 삭제가 불가합니다. Board, Plan, Timer 테이블과 1:N 관계

  Board 테이블: 게시글 저장 테이블. 파일 등록 기능을 제공해 File 테이블과 1:N 관계

  File 테이블: 게시글에 업로드한 파일 저장 테이블.

  Plan 테이블: 계획 저장 테이블. Timer 테이블과 0:1 관계 (양방향 모두 선택적 관계로 서로가 없어도 존재할 수 있음)

  Timer 테이블: 타이머 사용 기록 저장 테이블. 계획 설정 시 계획의 카테고리와 타이머에 등록하려는 카테고리가 일치해야 함. Lap, Notification 테이블과 1:N 관계

  Lap 테이블: 타이머 랩 기록 저장 테이블

  Notification 테이블: 계획 완료 처리로 수신한 알림을 담는 테이블. 알림을 수신한 조건에 따라 timer 값이 null이 될 수 있음

시스템 구조