띱 이벤트 관련 엔드포인트 추가 및 S3 파일 저장로직 구현

build.gradle

@@ -44,6 +44,11 @@ dependencies {
 	implementation 'org.springframework.session:spring-session-data-redis'
 	implementation 'org.redisson:redisson-spring-boot-starter:3.23.1'
 
+	// AWS S3
+	implementation 'software.amazon.awssdk:s3:2.21.29'
+	implementation 'software.amazon.awssdk:auth:2.21.29'
+	implementation 'software.amazon.awssdk:regions:2.21.29'
+
 	// Lombok
 	compileOnly 'org.projectlombok:lombok'
 	annotationProcessor 'org.projectlombok:lombok'

src/main/java/com/knu/ddip/common/config/S3Config.java

@@ -0,0 +1,32 @@
+package com.knu.ddip.common.config;
+
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import software.amazon.awssdk.auth.credentials.AwsBasicCredentials;
+import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider;
+import software.amazon.awssdk.regions.Region;
+import software.amazon.awssdk.services.s3.S3Client;
+
+@Configuration
+public class S3Config {
+
+    @Value("${cloud.aws.credentials.access-key}")
+    private String accessKey;
+
+    @Value("${cloud.aws.credentials.secret-key}")
+    private String secretKey;
+
+    @Value("${cloud.aws.region.static}")
+    private String region;
+
+    @Bean
+    public S3Client s3Client() {
+        AwsBasicCredentials awsCredentials = AwsBasicCredentials.create(accessKey, secretKey);
+
+        return S3Client.builder()
+                .region(Region.of(region))
+                .credentialsProvider(StaticCredentialsProvider.create(awsCredentials))
+                .build();
+    }
+}

src/main/java/com/knu/ddip/common/dto/StringTypeResponse.java

@@ -0,0 +1,6 @@
+package com.knu.ddip.common.dto;
+
+public record StringTypeResponse(
+        String response
+) {
+}

src/main/java/com/knu/ddip/common/exception/GlobalExceptionHandler.java

@@ -1,10 +1,13 @@
 package com.knu.ddip.common.exception;
 
 import com.knu.ddip.auth.exception.*;
+import com.knu.ddip.common.file.FileStorageException;
 import com.knu.ddip.ddipevent.exception.DdipBadRequestException;
 import com.knu.ddip.ddipevent.exception.DdipForbiddenException;
 import com.knu.ddip.ddipevent.exception.DdipNotFoundException;
 import com.knu.ddip.location.exception.LocationNotFoundException;
+import com.knu.ddip.user.exception.UserEmailDuplicateException;
+import com.knu.ddip.user.exception.UserNotFoundException;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.HttpStatusCode;
 import org.springframework.http.ProblemDetail;
@@ -103,4 +106,27 @@ public ResponseEntity<ProblemDetail> handleDdipForbiddenException(DdipForbiddenE
         return ResponseEntity.status(HttpStatus.FORBIDDEN).body(problemDetail);
     }
 
+    @ExceptionHandler(UserEmailDuplicateException.class)
+    public ResponseEntity<ProblemDetail> handleUserEmailDuplicateException(UserEmailDuplicateException e) {
+
+        ProblemDetail problemDetail = ProblemDetail.forStatusAndDetail(HttpStatus.BAD_REQUEST, e.getMessage());
+        problemDetail.setTitle("User Email Duplicate");
+        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(problemDetail);
+    }
+
+    @ExceptionHandler(UserNotFoundException.class)
+    public ResponseEntity<ProblemDetail> handleUserNotFoundException(UserNotFoundException e) {
+
+        ProblemDetail problemDetail = ProblemDetail.forStatusAndDetail(HttpStatus.NOT_FOUND, e.getMessage());
+        problemDetail.setTitle("User NotFound");
+        return ResponseEntity.status(HttpStatus.NOT_FOUND).body(problemDetail);
+    }
+
+    @ExceptionHandler(FileStorageException.class)
+    public ResponseEntity<ProblemDetail> handleFileStorageException(FileStorageException e) {
+
+        ProblemDetail problemDetail = ProblemDetail.forStatusAndDetail(HttpStatus.INTERNAL_SERVER_ERROR, e.getMessage());
+        problemDetail.setTitle("File Storage Exception");
+        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(problemDetail);
+    }
 }

src/main/java/com/knu/ddip/common/file/FileStorageException.java

@@ -0,0 +1,8 @@
+package com.knu.ddip.common.file;
+
+public class FileStorageException extends RuntimeException {
+
+    public FileStorageException(String message) {
+        super(message);
+    }
+}

src/main/java/com/knu/ddip/common/file/FileStorageService.java

@@ -0,0 +1,12 @@
+package com.knu.ddip.common.file;
+
+import org.springframework.web.multipart.MultipartFile;
+
+public interface FileStorageService {
+
+    String uploadFile(MultipartFile file, String directory);
+
+    void deleteFile(String fileUrl);
+
+    boolean exists(String fileUrl);
+}

src/main/java/com/knu/ddip/common/file/infrastructure/S3FileStorageService.java

@@ -0,0 +1,142 @@
+package com.knu.ddip.common.file.infrastructure;
+
+import com.knu.ddip.common.file.FileStorageException;
+import com.knu.ddip.common.file.FileStorageService;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Service;
+import org.springframework.web.multipart.MultipartFile;
+import software.amazon.awssdk.core.sync.RequestBody;
+import software.amazon.awssdk.services.s3.S3Client;
+import software.amazon.awssdk.services.s3.model.*;
+
+import java.io.IOException;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.UUID;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class S3FileStorageService implements FileStorageService {
+
+    private final S3Client s3Client;
+
+    @Value("${cloud.aws.s3.bucket}")
+    private String bucketName;
+
+    @Override
+    public String uploadFile(MultipartFile file, String directory) {
+        validateFile(file);
+
+        try {
+            String fileName = generateUniqueFileName(file.getOriginalFilename());
+            String dateDir = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy/MM/dd"));
+            String key = String.format("%s/%s/%s", directory, dateDir, fileName);
+
+            PutObjectRequest putObjectRequest = PutObjectRequest.builder()
+                    .bucket(bucketName)
+                    .key(key)
+                    .contentType(file.getContentType())
+                    .contentLength(file.getSize())
+                    .build();
+
+            s3Client.putObject(putObjectRequest,
+                    RequestBody.fromInputStream(file.getInputStream(), file.getSize()));
+
+            String fileUrl = String.format("https://%s.s3.amazonaws.com/%s", bucketName, key);
+
+            log.info("S3 파일 업로드 완료: {} -> {}", file.getOriginalFilename(), fileUrl);
+            return fileUrl;
+
+        } catch (IOException e) {
+            log.error("S3 파일 업로드 실패: {}", file.getOriginalFilename(), e);
+            throw new FileStorageException("파일 업로드에 실패했습니다: " + e.getMessage());
+        } catch (S3Exception e) {
+            log.error("S3 서비스 오류: {}", e.awsErrorDetails().errorMessage());
+            throw new FileStorageException("S3 업로드 중 오류가 발생했습니다: " + e.getMessage());
+        }
+    }
+
+    @Override
+    public void deleteFile(String fileUrl) {
+        try {
+            String key = extractS3Key(fileUrl);
+
+            DeleteObjectRequest deleteObjectRequest = DeleteObjectRequest.builder()
+                    .bucket(bucketName)
+                    .key(key)
+                    .build();
+
+            s3Client.deleteObject(deleteObjectRequest);
+            log.info("S3 파일 삭제 완료: {}", fileUrl);
+
+        } catch (S3Exception e) {
+            log.error("S3 파일 삭제 실패: {}", fileUrl, e);
+            throw new FileStorageException("파일 삭제에 실패했습니다: " + e.getMessage());
+        }
+    }
+
+    @Override
+    public boolean exists(String fileUrl) {
+        try {
+            String key = extractS3Key(fileUrl);
+
+            HeadObjectRequest headObjectRequest = HeadObjectRequest.builder()
+                    .bucket(bucketName)
+                    .key(key)
+                    .build();
+
+            s3Client.headObject(headObjectRequest);
+            return true;
+
+        } catch (NoSuchKeyException e) {
+            return false;
+        } catch (S3Exception e) {
+            log.error("S3 파일 존재 여부 확인 실패: {}", fileUrl, e);
+            return false;
+        }
+    }
+
+    private String generateUniqueFileName(String originalFilename) {
+        String timestamp = LocalDateTime.now().format(DateTimeFormatter.ofPattern("HHmmss"));
+        String uuid = UUID.randomUUID().toString().substring(0, 8);
+        String extension = getFileExtension(originalFilename);
+        return String.format("%s_%s%s", timestamp, uuid, extension);
+    }
+
+    private String getFileExtension(String filename) {
+        if (filename == null || filename.isEmpty()) {
+            return "";
+        }
+        int lastDotIndex = filename.lastIndexOf('.');
+        return (lastDotIndex == -1) ? "" : filename.substring(lastDotIndex);
+    }
+
+    private String extractS3Key(String fileUrl) {
+        if (fileUrl.contains(".s3.amazonaws.com/")) {
+            return fileUrl.substring(fileUrl.indexOf(".s3.amazonaws.com/") + 18);
+        }
+
+        throw new IllegalArgumentException("올바르지 않은 S3 URL 형식입니다: " + fileUrl);
+    }
+
+    private void validateFile(MultipartFile file) {
+        if (file.isEmpty()) {
+            throw new FileStorageException("빈 파일은 업로드할 수 없습니다.");
+        }
+
+        // 파일 크기 제한 (50MB)
+        long maxSize = 50 * 1024 * 1024;
+        if (file.getSize() > maxSize) {
+            throw new FileStorageException("파일 크기는 50MB를 초과할 수 없습니다.");
+        }
+
+        // 이미지 파일만 허용
+        String contentType = file.getContentType();
+        if (contentType == null || !contentType.startsWith("image/")) {
+            throw new FileStorageException("이미지 파일만 업로드 가능합니다.");
+        }
+    }
+}

src/main/java/com/knu/ddip/ddipevent/application/dto/PhotoFeedbackRequest.java

@@ -0,0 +1,9 @@
+package com.knu.ddip.ddipevent.application.dto;
+
+import com.knu.ddip.ddipevent.domain.PhotoStatus;
+
+public record PhotoFeedbackRequest(
+        PhotoStatus status,
+        String feedback
+) {
+}

src/main/java/com/knu/ddip/ddipevent/application/dto/PhotoUploadRequest.java

@@ -0,0 +1,11 @@
+package com.knu.ddip.ddipevent.application.dto;
+
+import org.springframework.web.multipart.MultipartFile;
+
+public record PhotoUploadRequest(
+        MultipartFile photo,
+        double latitude,
+        double longitude,
+        String responderComment
+) {
+}

src/main/java/com/knu/ddip/ddipevent/application/dto/SelectApplicantRequest.java

@@ -0,0 +1,8 @@
+package com.knu.ddip.ddipevent.application.dto;
+
+import java.util.UUID;
+
+public record SelectApplicantRequest(
+        UUID applicantId
+) {
+}

src/main/java/com/knu/ddip/ddipevent/application/dto/UserSummaryDto.java

@@ -10,4 +10,8 @@ public record UserSummaryDto(
         Integer responderMissionCount,
         BadgeDto representativeBadge
 ) {
+    public static UserSummaryDto fromUserId(String userId) { // TODO : 구현
+        return new UserSummaryDto(userId, null, null, null, null,
+                null, null, null);
+    }
 }