Skip to content

About

2025 졸업 프로젝트 — 학부생을 위한 생성형 AI 기반 클라우드 학습 자료 아카이빙 플랫폼

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

📁 DriveU Server

2025 졸업 프로젝트 — 학부생을 위한 생성형 AI 기반 클라우드 학습 자료 아카이빙 플랫폼

DriveU는 강의 노트, 파일, 링크 등 학습 자료를 학기별 디렉토리 구조로 통합 관리하고, OpenAI를 연동한 생성형 AI로 노트 요약 및 문제 자동 생성을 제공하는 서비스입니다.


📐 Cloud Architecture

AWS Seoul Region(ap-northeast-2) 기반의 고가용성 인프라

image

아키텍처 구성 요소

구성 요소 설명
VPC 10.11.0.0/16 대역의 전용 네트워크 (DriveU-vpc)
Availability Zone ap-northeast-2a, ap-northeast-2c 멀티 AZ 구성
Public Subnet Bastion Host, ALB 위치 (10.11.0.0/24, 10.11.1.0/24)
Private Subnet 애플리케이션 서버 위치 (10.11.10.0/24, 10.11.11.0/24)
IGW 인터넷 트래픽 진입점
WAF ALB 앞단 웹 방화벽, 악성 트래픽 필터링
ALB (DriveU-alb) 트래픽 로드밸런싱, SSL Termination
DriveU-Server Private Subnet 내 Spring Boot 애플리케이션 (Docker 컨테이너)
Bastion Host Dev/Ops의 SSH 점프 서버 (Public Subnet)
Amazon RDS MySQL — 파일 메타데이터, 유저 정보 저장
Amazon S3 실제 파일 저장소 (Presigned URL 기반 직접 업로드)
AWS CloudFront 프론트엔드 빌드 결과물 CDN 배포
OpenAI API GPT 연동 — AI 요약 및 문제 생성

네트워크 플로우

Internet  ──▶  IGW  ──▶  WAF  ──▶  ALB (Public)  ──▶  DriveU-Server (Private)  ──▶  RDS / S3
Dev/Ops   ──▶  IGW  ──▶  Bastion (Public)  ──SSH──▶  DriveU-Server (Private)
Frontend  ──▶  CloudFront  ──▶  S3 (빌드 결과물)

📊 ERD

  • resource 테이블을 부모로 file / note / link를 분리한 JPA 조인 상속 구조
  • Closure Table 기반 디렉토리 계층 임의 깊이의 트리를 단일 쿼리로 조회 가능
image

🗄 DB Index Strategy

Repository 쿼리 패턴을 분석하여 실제 조회에 사용되는 컬럼 조합에 복합 인덱스를 적용, 풀 테이블 스캔을 제거했습니다.

5개 엔티티에 총 10개의 인덱스를 추가했습니다.

테이블 인덱스 컬럼 사용 쿼리
directory_hierarchy (ancestor_id, depth) 하위 디렉토리 탐색
directory_hierarchy (descendant_id, depth) 상위 디렉토리 탐색
resource (is_deleted, updated_at) 최근 리소스 목록 조회
resource (is_deleted, is_favorite, updated_at) 즐겨찾기 목록 조회
resource (is_deleted, deleted_at) 휴지통 자동 삭제 스케줄러
directory (user_semester_id, is_deleted) 디렉토리 트리 조회
directory (is_deleted, deleted_at) 휴지통 자동 삭제 스케줄러
user_semester (user_id, is_deleted) 학기 목록 조회
user_semester (user_id, is_current, is_deleted) 현재 학기 조회
user email (UNIQUE) 로그인 시 이메일 조회

Note: directory_hierarchy의 ancestor_id, descendant_id는 FK가 아닌 @Column으로 선언되어 인덱스가 전혀 없었습니다. 디렉토리 트리를 그리는 모든 요청에서 풀 스캔이 발생하던 문제를 해결했습니다.


🛠 Tech Stack

Backend

분류 기술
Language Java 21
Framework Spring Boot 3.4.5
ORM Spring Data JPA + Flyway
Security Spring Security, JWT (JJWT 0.11.5)
Auth OAuth2 (Google)
Async WebFlux (WebClient)
API Docs SpringDoc OpenAPI (Swagger UI)
Build Gradle

Infrastructure & Cloud

분류 기술
Cloud AWS (Seoul Region)
Compute EC2 (Docker 컨테이너)
Database Amazon RDS (MySQL 8.x)
Storage Amazon S3 (AWS SDK v1 + v2)
CDN AWS CloudFront
Load Balancer AWS ALB
Security AWS WAF, VPC, Security Group
Container Docker

AI Integration

분류 기술
LLM OpenAI GPT (Responses API)
문서 검색 OpenAI Assistants API v2 (File Search)
Prompt Injection 방어 커스텀 PromptFilter

📁 Project Structure

src/main/java/com/driveu/server/
├── domain/
│   ├── ai/            # AI 요약·문제 생성 (Facade 패턴)
│   ├── auth/          # OAuth2 Google 로그인, JWT 발급/검증
│   ├── directory/     # 디렉토리 트리 (Closure Table 패턴)
│   ├── file/          # S3 단일/멀티파트 업로드 (Strategy 패턴)
│   ├── link/          # URL 링크 자료 관리
│   ├── note/          # 마크다운 노트 CRUD
│   ├── question/      # AI 문제 생성·제출·채점
│   ├── resource/      # 파일·노트·링크 통합 Resource 관리
│   ├── semester/      # 학기(UserSemester) 관리
│   ├── summary/       # AI 노트 요약 관리
│   ├── trash/         # 휴지통 (Soft Delete + 30일 자동 삭제)
│   └── user/          # 유저 프로필, 마이페이지
├── global/
│   ├── config/        # Security, CORS, Swagger, Async, S3, WebClient 설정
│   ├── entity/        # BaseEntity (Auditing, Soft Delete)
│   ├── scheduler/     # 휴지통 자동 정리 스케줄러
│   └── util/          # JWT 토큰 추출 유틸
└── infra/
    ├── ai/            # OpenAI WebClient, PromptFilter
    └── s3/            # S3 설정

✨ Key Features

🗂 디렉토리 구조 관리

  • Closure Table 패턴으로 무한 깊이의 계층 구조 지원
  • Index 기반 최적화: FK로 선언되지 않은 컬럼에 인덱스를 직접 생성하여, 트리 탐색 시 발생하던 성능 병목 해결
  • 디렉토리 생성, 이름 변경, 부모 이동, 정렬 순서 변경
  • 학기 생성 시 기본 디렉토리 자동 생성 (학업, 과목, 대외활동 등)

📦 파일 업로드 (Strategy 패턴)

  • 단일 업로드: Presigned PUT URL 발급 → 클라이언트가 S3에 직접 업로드
  • 멀티파트 업로드: 대용량 파일 분할 업로드 (파트별 Presigned URL + ETag 조합)
  • 사용자별 저장 용량 추적 및 제한 (기본 5GB)

🤖 AI 기능 (OpenAI 연동)

  • 노트 요약: OpenAI Responses API 직접 호출 (WebFlux 비동기 처리)
  • 문제 생성: OpenAI Assistants API (File Search) 활용
    1. 파일 업로드 → Thread 생성 → Run 생성 및 상태 폴링 → 메시지 추출 → 임시 파일 삭제
  • PromptFilter: 시스템 지침 우회 시도 문자열 사전 차단

🔐 인증 및 권한

  • Google OAuth2 인증 코드 플로우 (직접 구현)
  • JWT Access/Refresh Token 발급 (HS256)
  • @IsOwner AOP 어노테이션으로 리소스 소유자 선언적 검증
  • @LoginUser 커스텀 ArgumentResolver로 컨트롤러에서 User 객체 주입
  • Request 범위 내 유저 정보 캐싱으로 중복 DB 조회 방지

🗑 휴지통 & 복구

  • Soft Delete 기반 휴지통 (30일 보관 후 자동 영구 삭제)
  • 디렉토리 삭제 시 하위 리소스 일괄 Soft Delete (동일 deletedAt 타임스탬프)
  • 개별 리소스 / 디렉토리 단위 복구, 휴지통 비우기
  • S3 파일 영구 삭제는 트랜잭션 커밋 이후 비동기 처리

📊 학기 관리

  • 현재 날짜 기반 학기 자동 감지 및 생성
  • 학기 생성·수정·삭제 시 isCurrent 플래그 자동 업데이트

🔧 Design Patterns

패턴 적용 위치 목적
Closure Table DirectoryHierarchy 계층 디렉토리 효율적 읽기/쓰기
Strategy FileUploadStrategy 단일/멀티파트 업로드 전략 분리
AOP OwnerAspect + @IsOwner 선언적 리소스 소유자 검증
Template Method RequestBodyConverter 리소스 타입(FILE/NOTE)별 AI 요청 변환

🚀 Getting Started

Prerequisites

  • Java 21
  • Docker
  • MySQL 8.x

Build & Run

# 빌드
./gradlew clean build

# Docker 이미지 빌드
docker build -t driveu-server .

# 실행
docker run -p 8080:8080 \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://<RDS_ENDPOINT>/driveu \
  -e SPRING_DATASOURCE_USERNAME=<DB_USER> \
  -e SPRING_DATASOURCE_PASSWORD=<DB_PASSWORD> \
  -e JWT_SECRET=<JWT_SECRET_BASE64> \
  -e OPENAI_SECRET_KEY=<OPENAI_KEY> \
  -e OPENAI_ASSISTANT_ID=<ASSISTANT_ID> \
  driveu-server

Required Environment Variables

변수명 설명
SPRING_DATASOURCE_URL RDS MySQL 접속 URL
JWT_SECRET JWT 서명 비밀키 (Base64 인코딩)
OPENAI_SECRET_KEY OpenAI API Key
OPENAI_ASSISTANT_ID OpenAI Assistant ID (File Search용)
AWS_ACCESS_KEY S3 접근 키
AWS_SECRET_KEY S3 시크릿 키
AWS_S3_BUCKET S3 버킷 이름
GOOGLE_CLIENT_ID Google OAuth2 클라이언트 ID
GOOGLE_CLIENT_SECRET Google OAuth2 클라이언트 시크릿

📡 API 명세

서버 실행 후 Swagger UI에서 전체 API를 확인할 수 있습니다.

  • Local: http://localhost:8080/swagger-ui.html
  • Production: https://api.driveu.site/swagger-ui.html

주요 API 엔드포인트

도메인 메서드 경로 설명
Auth GET /api/auth/google 구글 로그인 페이지 리다이렉트
Auth GET /api/auth/code/google OAuth 코드로 JWT 발급
Semester POST /api/semesters 학기 생성
Semester GET /api/semesters/{id}/mainpage 메인 페이지 조회
Directory GET /api/user-semesters/{id}/directories 디렉토리 트리 조회
Directory POST /api/user-semesters/{id}/directories 디렉토리 생성
File GET /api/file/upload 단일 업로드 Presigned URL 발급
File POST /api/file/upload/multipart/start 멀티파트 업로드 시작
File POST /api/file/upload/multipart/complete 멀티파트 업로드 완료
Resource GET /api/directories/{id}/resources 디렉토리별 자료 조회
Resource DELETE /api/resources/{id} 자료 Soft Delete
Note POST /api/directories/{id}/notes 노트 생성
Note PATCH /api/notes/{id}/content 노트 내용 수정
Summary POST /api/v2/note/{id}/summary AI 요약 생성 (v2)
Question POST /api/v2/directories/{id}/questions AI 문제 생성 (v2)
Question POST /api/questions/{id}/submit 문제 풀이 제출 및 채점
Trash GET /api/trash 휴지통 조회
Trash DELETE /api/trash 휴지통 비우기
Trash POST /api/trash/resources/{id}/restore 자료 복구
User GET /api/mypage 마이페이지 조회

♻️ 배치 시스템 - 휴지통 리소스 자동 정리

개요

trashCleanupJob은 휴지통에 30일 이상 보관된 리소스와 디렉토리를 영구 삭제하는 Spring Batch Job입니다. 두 개의 Step이 순서대로 실행되며, 각 Step은 ItemStreamReader 기반 커서 버퍼 방식으로 대용량 데이터를 처리합니다.

Job Step 처리 대상 Chunk Size
trashCleanupJob resourceCleanupStep 만료된 Resource (File / Note / Link) 100
trashCleanupJob directoryCleanupStep 만료된 Directory 100

처리 흐름

Step 1 — resourceCleanupStep

ExpiredResourceReader
  └─ DB에서 baseTime 이전에 삭제된 Resource를 100건씩 커서 조회
       │
       ▼ (no Processor)
ResourceCleanupWriter
  ├─ 1. QuestionResource 연결 삭제
  ├─ 2. Summary 삭제 (Note 타입인 경우)
  ├─ 3. ResourceDirectory 삭제
  ├─ 4. S3 파일 삭제 (CircuitBreaker: s3Delete)
  ├─ 5. Resource DB 영구 삭제
  └─ 6. 사용자 usedStorage 차감 (벌크 UPDATE)

Step 2 — directoryCleanupStep

ExpiredDirectoryReader
  └─ DB에서 baseTime 이전에 삭제된 Directory를 100건씩 커서 조회
       │
       ▼ (no Processor)
DirectoryCleanupWriter
  ├─ 1. DirectoryHierarchy 삭제 (Closure Table 연결 행 제거)
  ├─ 2. ResourceDirectory 삭제
  └─ 3. Directory DB 영구 삭제

내결함성 전략

Retry (resourceCleanupStep)

항목 값
재시도 대상 예외 AmazonS3Exception, TransientDataAccessException
최대 재시도 횟수 3회 (retryLimit = 3)
백오프 전략 Exponential Backoff — 초기 1초, 배수 2.0x, 최대 10초
리스너 S3RetryListener — 재시도 횟수·예외 로깅
.retryLimit(3)
.backOffPolicy(new ExponentialBackOffPolicy() {{
    setInitialInterval(1000);  // 1초
    setMultiplier(2.0);        // 2배씩
    setMaxInterval(10000);     // 최대 10초
}})

Skip

Step Skip 대상 예외 skipLimit 리스너
resourceCleanupStep AmazonS3Exception (retry 소진 후), CallNotPermittedException (Circuit OPEN 즉시) 50 ResourceSkipListener
directoryCleanupStep [TODO: 명시적 skip 예외 미설정] 20 DirectorySkipListener

Skip 발생 시 SkipLog 엔티티가 skip_log 테이블에 기록됩니다.

skip_log { stepName, resourceId, reason, skippedAt }
  예) stepName = "RESOURCE_WRITE_CIRCUIT_OPEN"
      stepName = "RESOURCE_WRITE"
      stepName = "RESOURCE_PROCESS"
      stepName = "DIRECTORY_WRITE"

Circuit Breaker (Resilience4j)

S3 삭제 요청에 s3Delete Circuit Breaker가 적용됩니다. Circuit이 OPEN 상태일 때 CallNotPermittedException이 발생하며, 이는 즉시 Skip 처리됩니다.

Restart (체크포인트)

두 Reader 모두 ItemStreamReader를 구현하여 청크 커밋마다 ExecutionContext에 마지막 처리 ID를 저장합니다. 장애 재시작 시 저장된 ID 이후부터 재개하므로 중복·누락이 없습니다.

Step ExecutionContext 키 저장 값
resourceCleanupStep resource.last.id 마지막으로 처리된 Resource ID
directoryCleanupStep directory.last.id 마지막으로 처리된 Directory ID

Step startLimit

두 Step 모두 startLimit = 3으로 설정되어 있어, 동일 JobInstance 내에서 Step의 무한 재시작을 방지합니다.


실행 조건

자동 실행 (스케줄러)

TrashCleanupScheduler가 매일 자정에 Job을 실행합니다.

cron = "0 0 0 * * *"   →   매일 00:00:00
baseTime = 현재 시각 - 30일  →  30일 이전에 soft delete된 항목만 대상

실패 시 즉시 1회 자동 재시작을 시도합니다 (MAX_ATTEMPTS = 2). Spring Batch는 동일 JobParameters로 재실행하면 실패한 Step부터 이어서 처리합니다.

수동 실행 (dev 프로필 전용)

BatchJobController는 @Profile("dev")로 제한되어 운영 환경에 노출되지 않습니다.

# 수동 실행 (기본 30일, 변경 가능)
POST /internal/batch/trash-cleanup?daysAgo=30

# 마지막 실패 실행 조회
GET /internal/batch/trash-cleanup/last-failed

# 마지막 실패 실행 재시작
POST /internal/batch/trash-cleanup/restart

👥 Contributors

2025 졸업 프로젝트 팀 — DriveU

About

2025 졸업 프로젝트 — 학부생을 위한 생성형 AI 기반 클라우드 학습 자료 아카이빙 플랫폼

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages