[Feat] 새 그룹 생성 API 개발 (#62)

soonge2 · web-flow · commit b97d9dfb7ac1 · 2025-05-06T22:40:52.000+09:00
* feat: 새그룹 생성 요청 및 응답 DTO 구현 (#52) * feat: 그룹 생성 입력값 유효성 검증 로직 및 커스텀 예외 추가 (#52) * fix: 그룹/투표 이미지 URL에 도메인 prefix 검증 로직 추가 (#52) - VoteValidator.validateUrl() 로직을 도메인 기반으로 변경 - application.yml에 file.upload-url-prefix 추가 * feat: 새그룹 생성 서비스 로직 구현 (#52) * feat: 초대 코드 생성 로직 추가 (#52) * feat: 새그룹 생성 컨트롤러 구현 (#52) * fix: 투표/그룹 이미지 URL prefix를 application 설정 대신 하드코딩으로 변경 (#52) * feat: 그룹 생성 시 이름 중복 방지 로직 추가 (#52)
diff --git a/build.gradle b/build.gradle
@@ -29,6 +29,7 @@ dependencies {
 	implementation 'org.springframework.boot:spring-boot-starter-web'
 	implementation 'com.mysql:mysql-connector-j'
 	implementation 'io.jsonwebtoken:jjwt-api:0.12.6'
+	implementation 'org.apache.commons:commons-lang3:3.12.0'
 	runtimeOnly 'io.jsonwebtoken:jjwt-impl:0.12.6'
 	runtimeOnly 'io.jsonwebtoken:jjwt-jackson:0.12.6'
 	compileOnly 'org.projectlombok:lombok'
diff --git a/src/main/java/com/moa/moa_server/domain/group/controller/GroupController.java b/src/main/java/com/moa/moa_server/domain/group/controller/GroupController.java
@@ -1,10 +1,11 @@
 package com.moa.moa_server.domain.group.controller;
 
 import com.moa.moa_server.domain.global.dto.ApiResponse;
+import com.moa.moa_server.domain.group.dto.request.GroupCreateRequest;
 import com.moa.moa_server.domain.group.dto.request.GroupJoinRequest;
+import com.moa.moa_server.domain.group.dto.response.GroupCreateResponse;
 import com.moa.moa_server.domain.group.dto.response.GroupJoinResponse;
 import com.moa.moa_server.domain.group.service.GroupService;
-import com.moa.moa_server.domain.vote.dto.request.VoteCreateRequest;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.ResponseEntity;
 import org.springframework.security.core.annotation.AuthenticationPrincipal;
@@ -30,4 +31,15 @@ public ResponseEntity<ApiResponse> joinGroup(
                 .status(201)
                 .body(new ApiResponse("SUCCESS", response));
     }
+
+    @PostMapping
+    public ResponseEntity<ApiResponse> createGroup(
+            @AuthenticationPrincipal Long userId,
+            @RequestBody GroupCreateRequest request
+    ) {
+        GroupCreateResponse response = groupService.createGroup(userId, request);
+        return ResponseEntity
+                .status(201)
+                .body(new ApiResponse("SUCCESS", response));
+    }
 }
diff --git a/src/main/java/com/moa/moa_server/domain/group/dto/request/GroupCreateRequest.java b/src/main/java/com/moa/moa_server/domain/group/dto/request/GroupCreateRequest.java
@@ -0,0 +1,7 @@
+package com.moa.moa_server.domain.group.dto.request;
+
+public record GroupCreateRequest(
+        String name,
+        String description,
+        String imageUrl
+) {}
diff --git a/src/main/java/com/moa/moa_server/domain/group/dto/response/GroupCreateResponse.java b/src/main/java/com/moa/moa_server/domain/group/dto/response/GroupCreateResponse.java
@@ -0,0 +1,12 @@
+package com.moa.moa_server.domain.group.dto.response;
+
+import java.time.LocalDateTime;
+
+public record GroupCreateResponse(
+        Long groupId,
+        String name,
+        String description,
+        String imageUrl,
+        String inviteCode,
+        LocalDateTime createdAt
+) {}
diff --git a/src/main/java/com/moa/moa_server/domain/group/entity/Group.java b/src/main/java/com/moa/moa_server/domain/group/entity/Group.java
@@ -29,7 +29,7 @@ public class Group extends BaseTimeEntity {
     @JoinColumn(name = "user_id", nullable = false)
     private User user;
 
-    @Column(name = "name", length = 50, nullable = false)
+    @Column(name = "name", length = 50, nullable = false, unique = true)
     private String name;
 
     @Column(name = "description", length = 100, nullable = false)
@@ -44,11 +44,12 @@ public class Group extends BaseTimeEntity {
     @Column(name = "deleted_at")
     private java.time.LocalDateTime deletedAt;
 
-    public static Group create(User user, String name, String description, String inviteCode) {
+    public static Group create(User user, String name, String description, String imageUrl, String inviteCode) {
         return Group.builder()
                 .user(user)
                 .name(name)
                 .description(description)
+                .imageUrl(imageUrl)
                 .inviteCode(inviteCode)
                 .build();
     }
diff --git a/src/main/java/com/moa/moa_server/domain/group/entity/GroupMember.java b/src/main/java/com/moa/moa_server/domain/group/entity/GroupMember.java
@@ -65,4 +65,13 @@ public void rejoin() {
         this.joinedAt = LocalDateTime.now();
         this.role = Role.MEMBER;
     }
+
+    public static GroupMember createAsOwner(User user, Group group) {
+        return GroupMember.builder()
+                .user(user)
+                .group(group)
+                .role(Role.OWNER)
+                .joinedAt(LocalDateTime.now())
+                .build();
+    }
 }
diff --git a/src/main/java/com/moa/moa_server/domain/group/handler/GroupErrorCode.java b/src/main/java/com/moa/moa_server/domain/group/handler/GroupErrorCode.java
@@ -8,7 +8,10 @@ public enum GroupErrorCode implements BaseErrorCode {
     INVALID_CODE_FORMAT(HttpStatus.BAD_REQUEST),
     INVITE_CODE_NOT_FOUND(HttpStatus.NOT_FOUND),
     ALREADY_JOINED(HttpStatus.CONFLICT),
-    CANNOT_JOIN_PUBLIC_GROUP(HttpStatus.BAD_REQUEST),;
+    CANNOT_JOIN_PUBLIC_GROUP(HttpStatus.BAD_REQUEST),
+    INVALID_INPUT(HttpStatus.BAD_REQUEST),
+    INVITE_CODE_GENERATION_FAILED(HttpStatus.INTERNAL_SERVER_ERROR),
+    DUPLICATE_NAME(HttpStatus.CONFLICT);
 
     private final HttpStatus status;
 
diff --git a/src/main/java/com/moa/moa_server/domain/group/repository/GroupRepository.java b/src/main/java/com/moa/moa_server/domain/group/repository/GroupRepository.java
@@ -7,4 +7,6 @@
 
 public interface GroupRepository extends JpaRepository<Group, Long> {
     Optional<Group> findByInviteCode(String inviteCode);
+    boolean existsByInviteCode(String inviteCode);
+    boolean existsByName(String groupName);
 }
diff --git a/src/main/java/com/moa/moa_server/domain/group/service/GroupService.java b/src/main/java/com/moa/moa_server/domain/group/service/GroupService.java
@@ -1,6 +1,8 @@
 package com.moa.moa_server.domain.group.service;
 
+import com.moa.moa_server.domain.group.dto.request.GroupCreateRequest;
 import com.moa.moa_server.domain.group.dto.request.GroupJoinRequest;
+import com.moa.moa_server.domain.group.dto.response.GroupCreateResponse;
 import com.moa.moa_server.domain.group.dto.response.GroupJoinResponse;
 import com.moa.moa_server.domain.group.entity.Group;
 import com.moa.moa_server.domain.group.entity.GroupMember;
@@ -17,6 +19,7 @@
 import com.moa.moa_server.domain.vote.handler.VoteErrorCode;
 import com.moa.moa_server.domain.vote.handler.VoteException;
 import lombok.RequiredArgsConstructor;
+import org.apache.commons.lang3.RandomStringUtils;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
@@ -26,6 +29,8 @@
 @RequiredArgsConstructor
 public class GroupService {
 
+    private static final int MAX_INVITE_CODE_RETRY = 10;
+
     private final GroupRepository groupRepository;
     private final UserRepository userRepository;
     private final GroupMemberRepository groupMemberRepository;
@@ -78,4 +83,55 @@ public GroupJoinResponse joinGroup(Long userId, GroupJoinRequest request) {
 
         return new GroupJoinResponse(group.getId(), group.getName(), member.getRole().name());
     }
+
+    @Transactional
+    public GroupCreateResponse createGroup(Long userId, GroupCreateRequest request) {
+        // 유저 조회 및 검증
+        User user = userRepository.findById(userId)
+                .orElseThrow(() -> new UserException(UserErrorCode.USER_NOT_FOUND));
+        AuthUserValidator.validateActive(user);
+
+        // 입력 검증
+        GroupValidator.validateGroupName(request.name());
+        GroupValidator.validateDescription(request.description());
+        if (!request.imageUrl().isBlank()) {
+            GroupValidator.validateImageUrl(request.imageUrl()); // 업로드 도메인 검증
+        }
+        String imageUrl = request.imageUrl().isBlank() ? null : request.imageUrl().trim();
+
+        // 그룹 이름 중복 검사
+        if (groupRepository.existsByName(request.name())) {
+            throw new GroupException(GroupErrorCode.DUPLICATE_NAME);
+        }
+
+        // 초대 코드 생성
+        String inviteCode = generateUniqueInviteCode();
+
+        // 그룹 생성
+        Group group = Group.create(user, request.name(), request.description(), imageUrl, inviteCode);
+        groupRepository.save(group);
+
+        // 그룹 멤버 등록
+        GroupMember member = GroupMember.createAsOwner(user, group);
+        groupMemberRepository.save(member);
+
+        return new GroupCreateResponse(
+                group.getId(),
+                group.getName(),
+                group.getDescription(),
+                group.getImageUrl(),
+                group.getInviteCode(),
+                group.getCreatedAt()
+        );
+    }
+
+    private String generateUniqueInviteCode() {
+        for (int i = 0; i < MAX_INVITE_CODE_RETRY; i++) {
+            String code = RandomStringUtils.randomAlphanumeric(6, 8).toUpperCase();
+            if (!groupRepository.existsByInviteCode(code)) {
+                return code;
+            }
+        }
+        throw new GroupException(GroupErrorCode.INVITE_CODE_GENERATION_FAILED);
+    }
 }
diff --git a/src/main/java/com/moa/moa_server/domain/group/util/GroupValidator.java b/src/main/java/com/moa/moa_server/domain/group/util/GroupValidator.java
@@ -8,6 +8,8 @@
 public class GroupValidator {
 
     private static final Pattern INVITE_CODE_PATTERN = Pattern.compile("^[A-Z0-9]{6,8}$");
+    private static final Pattern NAME_PATTERN = Pattern.compile("^(?![\\d\\s])[가-힣a-zA-Z0-9 ]{2,12}$");
+    private static final String UPLOAD_URL_PREFIX = "https://upload-domain/group";
 
     private GroupValidator() {
         throw new AssertionError("유틸 클래스는 인스턴스화할 수 없습니다.");
@@ -18,4 +20,23 @@ public static void validateInviteCode(String inviteCode) {
             throw new GroupException(GroupErrorCode.INVALID_CODE_FORMAT);
         }
     }
+
+    public static void validateGroupName(String name) {
+        if (name == null || name.isBlank() || !NAME_PATTERN.matcher(name).matches()) {
+            throw new GroupException(GroupErrorCode.INVALID_INPUT);
+        }
+    }
+
+
+    public static void validateDescription(String description) {
+        if (description == null || description.isBlank() || description.length() < 2 || description.length() > 50) {
+            throw new GroupException(GroupErrorCode.INVALID_INPUT);
+        }
+    }
+
+    public static void validateImageUrl(String imageUrl) {
+        if (imageUrl != null && !imageUrl.isBlank() && !imageUrl.startsWith(UPLOAD_URL_PREFIX)) {
+            throw new GroupException(GroupErrorCode.INVALID_INPUT);
+        }
+    }
 }
diff --git a/src/main/java/com/moa/moa_server/domain/vote/service/VoteService.java b/src/main/java/com/moa/moa_server/domain/vote/service/VoteService.java
@@ -79,15 +79,16 @@ public Long createVote(Long userId, VoteCreateRequest request) {
 
         // 요청 값 유효성 검사
         VoteValidator.validateContent(request.content());
-        VoteValidator.validateUrl(request.imageUrl());
+        VoteValidator.validateImageUrl(request.imageUrl());
+        String imageUrl = request.imageUrl().isBlank() ? null : request.imageUrl().trim();
         VoteValidator.validateClosedAt(request.closedAt());
 
         // Vote 생성 및 저장
         Vote vote = Vote.createUserVote(
                 user,
                 group,
                 request.content(),
-                request.imageUrl(),
+                imageUrl,
                 request.closedAt(),
                 adminVote
         );
diff --git a/src/main/java/com/moa/moa_server/domain/vote/util/VoteValidator.java b/src/main/java/com/moa/moa_server/domain/vote/util/VoteValidator.java
@@ -3,23 +3,23 @@
 import com.moa.moa_server.domain.vote.handler.VoteErrorCode;
 import com.moa.moa_server.domain.vote.handler.VoteException;
 
-import java.net.URL;
 import java.time.LocalDateTime;
 
 public class VoteValidator {
 
+    private static final String UPLOAD_URL_PREFIX = "https://upload-domain/vote";
+
+
     public static void validateContent(String content) {
         if (content == null || content.isBlank() || content.length() > 255 || content.length() < 2) {
             throw new VoteException(VoteErrorCode.INVALID_CONTENT);
         }
     }
 
-    public static void validateUrl(String url) {
-        if (url == null || url.isBlank()) return;
-        try {
-            new URL(url).toURI();
-        } catch (Exception e) {
-            throw new VoteException(VoteErrorCode.INVALID_URL);        }
+    public static void validateImageUrl(String imageUrl) {
+        if (imageUrl != null && !imageUrl.isBlank() && !imageUrl.startsWith(UPLOAD_URL_PREFIX)) {
+            throw new VoteException(VoteErrorCode.INVALID_URL);
+        }
     }
 
     public static void validateClosedAt(LocalDateTime closedAt) {

Original file line number	Diff line number	Diff line change
`@@ -65,4 +65,13 @@ public void rejoin() {`
`65`	`65`	`this.joinedAt = LocalDateTime.now();`
`66`	`66`	`this.role = Role.MEMBER;`
`67`	`67`	`}`
	`68`	`+`
	`69`	`+ public static GroupMember createAsOwner(User user, Group group) {`
	`70`	`+ return GroupMember.builder()`
	`71`	`+ .user(user)`
	`72`	`+ .group(group)`
	`73`	`+ .role(Role.OWNER)`
	`74`	`+ .joinedAt(LocalDateTime.now())`
	`75`	`+ .build();`
	`76`	`+ }`
`68`	`77`	`}`
Original file line number	Diff line number	Diff line change
`@@ -7,4 +7,6 @@`
`7`	`7`
`8`	`8`	`public interface GroupRepository extends JpaRepository<Group, Long> {`
`9`	`9`	`Optional<Group> findByInviteCode(String inviteCode);`
	`10`	`+ boolean existsByInviteCode(String inviteCode);`
	`11`	`+ boolean existsByName(String groupName);`
`10`	`12`	`}`