develop -> main

src/main/java/gg/agit/konect/domain/club/controller/ClubRegistrationRequestApi.java

@@ -0,0 +1,20 @@
+package gg.agit.konect.domain.club.controller;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PathVariable;
+
+import gg.agit.konect.domain.club.dto.ClubInformationUpdateRequestDto;
+import gg.agit.konect.domain.club.dto.ClubRegistrationRequestDto;
+import io.swagger.v3.oas.annotations.parameters.RequestBody;
+
+public interface ClubRegistrationRequestApi {
+
+    ResponseEntity<Void> registerClub(
+        @RequestBody ClubRegistrationRequestDto request
+    );
+
+    ResponseEntity<Void> requestClubInformationUpdate(
+        @PathVariable(name = "clubId") Integer clubId,
+        @RequestBody ClubInformationUpdateRequestDto request
+    );
+}

src/main/java/gg/agit/konect/domain/club/controller/ClubRegistrationRequestController.java

@@ -0,0 +1,56 @@
+package gg.agit.konect.domain.club.controller;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import gg.agit.konect.domain.club.dto.ClubInformationUpdateRequestDto;
+import gg.agit.konect.domain.club.dto.ClubRegistrationRequestDto;
+import gg.agit.konect.domain.club.service.ClubRegistrationRequestService;
+import gg.agit.konect.global.auth.annotation.PublicApi;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+
+@Tag(name = "Club Registration", description = "동아리 등록 요청 API")
+@RestController
+@RequestMapping("/clubs")
+@RequiredArgsConstructor
+public class ClubRegistrationRequestController implements ClubRegistrationRequestApi {
+
+    private final ClubRegistrationRequestService clubRegistrationRequestService;
+
+    @Override
+    @Operation(
+        summary = "동아리 등록 요청",
+        description = "비로그인 사용자가 새 동아리 등록을 요청합니다."
+    )
+    @PostMapping("/registration-requests")
+    @PublicApi
+    public ResponseEntity<Void> registerClub(
+        @Valid @RequestBody ClubRegistrationRequestDto request
+    ) {
+        clubRegistrationRequestService.register(request);
+        return ResponseEntity.status(HttpStatus.CREATED).build();
+    }
+
+    @Override
+    @Operation(
+        summary = "동아리 정보 수정 요청",
+        description = "비로그인 사용자가 기존 동아리 정보 수정을 요청합니다."
+    )
+    @PostMapping("/{clubId}/information-update-requests")
+    @PublicApi
+    public ResponseEntity<Void> requestClubInformationUpdate(
+        @PathVariable(name = "clubId") Integer clubId,
+        @Valid @RequestBody ClubInformationUpdateRequestDto request
+    ) {
+        clubRegistrationRequestService.requestInformationUpdate(clubId, request);
+        return ResponseEntity.status(HttpStatus.CREATED).build();
+    }
+}

src/main/java/gg/agit/konect/domain/club/dto/ClubInformationUpdateRequestDto.java

@@ -0,0 +1,67 @@
+package gg.agit.konect.domain.club.dto;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+import java.util.List;
+
+import gg.agit.konect.domain.club.enums.ClubCategory;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+
+@Schema(name = "ClubInformationUpdateRequest", description = "동아리 정보 수정 요청")
+public record ClubInformationUpdateRequestDto(
+
+    @Schema(description = "대학교 명", example = "한국기술교육대학교", requiredMode = REQUIRED)
+    @NotBlank(message = "대학교 명은 필수입니다.")
+    String universityName,
+
+    @Schema(description = "동아리 명", example = "BCSD Lab", requiredMode = REQUIRED)
+    @NotBlank(message = "동아리 명은 필수입니다.")
+    @Size(max = 50, message = "동아리 명은 최대 50자입니다.")
+    String clubName,
+
+    @Schema(description = "동아리 분과", example = "ACADEMIC", requiredMode = REQUIRED)
+    @NotNull(message = "동아리 분과는 필수입니다.")
+    ClubCategory clubCategory,
+
+    @Schema(description = "동아리 주제", example = "코딩", requiredMode = REQUIRED)
+    @NotBlank(message = "동아리 주제는 필수입니다.")
+    @Size(max = 20, message = "동아리 주제는 최대 20자입니다.")
+    String clubTopic,
+
+    @Schema(description = "동아리 이모지", example = "💻", requiredMode = REQUIRED)
+    @NotBlank(message = "동아리 이모지는 필수입니다.")
+    @Size(max = 10, message = "동아리 이모지는 최대 10자입니다.")
+    String clubEmoji,
+
+    @Schema(
+        description = "한 줄 소개 (최대 30자)",
+        example = "코딩 동아리입니다.",
+        requiredMode = REQUIRED
+    )
+    @NotBlank(message = "한 줄 소개는 필수입니다.")
+    @Size(max = 30, message = "한 줄 소개는 최대 30자입니다.")
+    String shortDescription,
+
+    @Schema(
+        description = "동아리 소개 (최대 2000자)",
+        example = "상세한 동아리 소개 내용...",
+        requiredMode = REQUIRED
+    )
+    @NotBlank(message = "동아리 소개는 필수입니다.")
+    @Size(max = 2000, message = "동아리 소개는 최대 2000자입니다.")
+    String fullIntroduction,
+
+    @Schema(
+        description = "사진 및 영상 URL 목록 (최대 5개)",
+        example = "[\"https://example.com/image1.jpg\"]"
+    )
+    @Size(max = 5, message = "사진 및 영상은 최대 5개까지 업로드 가능합니다.")
+    List<
+        @NotBlank(message = "이미지 URL은 필수입니다.")
+        @Size(max = 500, message = "이미지 URL은 최대 500자입니다.")
+            String> imageUrls
+) {
+}

src/main/java/gg/agit/konect/domain/club/dto/ClubRegistrationRequestDto.java

@@ -0,0 +1,58 @@
+package gg.agit.konect.domain.club.dto;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.NOT_REQUIRED;
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+import java.util.List;
+
+import gg.agit.konect.domain.club.enums.ClubCategory;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+
+@Schema(name = "ClubRegistrationRequest", description = "동아리 등록 요청")
+public record ClubRegistrationRequestDto(
+
+    @Schema(description = "대학교 명", example = "한국기술교육대학교", requiredMode = REQUIRED)
+    @NotBlank(message = "대학교 명은 필수입니다.")
+    String universityName,
+
+    @Schema(description = "동아리 명", example = "BCSD Lab", requiredMode = REQUIRED)
+    @NotBlank(message = "동아리 명은 필수입니다.")
+    @Size(max = 50, message = "동아리 명은 최대 50자입니다.")
+    String clubName,
+
+    @Schema(description = "동아리 분과", example = "ACADEMIC", requiredMode = REQUIRED)
+    @NotNull(message = "동아리 분과는 필수입니다.")
+    ClubCategory clubCategory,
+
+    @Schema(description = "동아리 주제", example = "코딩", requiredMode = REQUIRED)
+    @NotBlank(message = "동아리 주제는 필수입니다.")
+    @Size(max = 20, message = "동아리 주제는 최대 20자입니다.")
+    String clubTopic,
+
+    @Schema(description = "동아리 이모지", example = "💻", requiredMode = REQUIRED)
+    @NotBlank(message = "동아리 이모지는 필수입니다.")
+    @Size(max = 10, message = "동아리 이모지는 최대 10자입니다.")
+    String clubEmoji,
+
+    @Schema(description = "한 줄 소개 (최대 30자)", example = "코딩 동아리입니다.", requiredMode = REQUIRED)
+    @NotBlank(message = "한 줄 소개는 필수입니다.")
+    @Size(max = 30, message = "한 줄 소개는 최대 30자입니다.")
+    String shortDescription,
+
+    @Schema(description = "동아리 소개 (최대 2000자)", example = "상세한 동아리 소개 내용...", requiredMode = REQUIRED)
+    @NotBlank(message = "동아리 소개는 필수입니다.")
+    @Size(max = 2000, message = "동아리 소개는 최대 2000자입니다.")
+    String fullIntroduction,
+
+    @Schema(
+        description = "사진 및 영상 URL 목록 (최대 5개)",
+        example = "[\"https://example.com/image1.jpg\"]",
+        requiredMode = NOT_REQUIRED
+    )
+    @Size(max = 5, message = "사진 및 영상은 최대 5개까지 업로드 가능합니다.")
+    List<String> imageUrls
+) {
+}

src/main/java/gg/agit/konect/domain/club/enums/ClubCategory.java

@@ -1,18 +1,30 @@
 package gg.agit.konect.domain.club.enums;
 
+import java.util.Arrays;
+import java.util.Comparator;
+import java.util.List;
+
 import lombok.Getter;
 import lombok.RequiredArgsConstructor;
 
-@Getter
 @RequiredArgsConstructor
 public enum ClubCategory {
-    ACADEMIC("학술"),
-    SPORTS("운동"),
-    HOBBY("취미"),
-    RELIGION("종교"),
-    PERFORMANCE("공연"),
-    JUNIOR("준동아리")
-    ;
+    PERFORMANCE("공연", 1),
+    SOCIAL_SERVICE("사회/봉사", 2),
+    EXHIBITION_CREATION("전시/창작", 3),
+    RELIGION("종교", 4),
+    SPORTS("체육(운동)", 5),
+    HOBBY("취미", 6),
+    ACADEMIC("학술", 7),
+    ETC("기타", 8);
 
+    @Getter
     private final String description;
+    private final int displayOrder;
+
+    public static List<ClubCategory> sortedForDisplay() {
+        return Arrays.stream(values())
+            .sorted(Comparator.comparingInt(category -> category.displayOrder))
+            .toList();
+    }
 }

src/main/java/gg/agit/konect/domain/club/event/ClubInformationUpdateRequestedEvent.java

@@ -0,0 +1,50 @@
+package gg.agit.konect.domain.club.event;
+
+import java.util.List;
+
+import gg.agit.konect.domain.club.model.ClubInformationUpdateRequest;
+
+public record ClubInformationUpdateRequestedEvent(
+    Integer requestId,
+    Integer clubId,
+    String currentUniversityName,
+    String requestedUniversityName,
+    String currentClubName,
+    String requestedClubName,
+    String currentCategory,
+    String requestedCategory,
+    String currentTopic,
+    String requestedTopic,
+    String requestedEmoji,
+    String currentDescription,
+    String requestedDescription,
+    String currentFullIntroduction,
+    String requestedFullIntroduction,
+    String currentImageUrl,
+    List<String> requestedImageUrls
+) {
+
+    public static ClubInformationUpdateRequestedEvent from(ClubInformationUpdateRequest request) {
+        return new ClubInformationUpdateRequestedEvent(
+            request.getId(),
+            request.getClub().getId(),
+            request.getClub().getUniversity().getKoreanName(),
+            request.getUniversityName(),
+            request.getClub().getName(),
+            request.getClubName(),
+            request.getClub().getClubCategory().getDescription(),
+            request.getClubCategory().getDescription(),
+            request.getClub().getTopic(),
+            request.getClubTopic(),
+            request.getClubEmoji(),
+            request.getClub().getDescription(),
+            request.getShortDescription(),
+            request.getClub().getIntroduce(),
+            request.getFullIntroduction(),
+            request.getClub().getImageUrl(),
+            request.getImages().stream()
+                .map(image -> image.getImageUrl())
+                .toList()
+        );
+    }
+}

src/main/java/gg/agit/konect/domain/club/event/ClubRegistrationRequestedEvent.java

@@ -0,0 +1,38 @@
+package gg.agit.konect.domain.club.event;
+
+import java.util.List;
+
+import gg.agit.konect.domain.club.model.ClubRegistrationRequest;
+
+public record ClubRegistrationRequestedEvent(
+    Integer requestId,
+    String universityName,
+    String clubName,
+    String category,
+    String topic,
+    String emoji,
+    String description,
+    String fullIntroduction,
+    List<String> imageUrls
+) {
+
+    public static ClubRegistrationRequestedEvent from(ClubRegistrationRequest request) {
+        return new ClubRegistrationRequestedEvent(
+            request.getId(),
+            request.getUniversityName(),
+            request.getClubName(),
+            request.getClubCategory().getDescription(),
+            request.getClubTopic(),
+            request.getClubEmoji(),
+            request.getShortDescription(),
+            request.getFullIntroduction(),
+            request.getImages().stream()
+                .map(image -> image.getImageUrl())
+                .toList()
+        );
+    }
+
+    public int imageCount() {
+        return imageUrls.size();
+    }
+}