Merge pull request #4 from eunhye-ahn/feature/group-core-0516

[BE] 그룹 : 생성/조회/참여 API 개발

Author: eunhye-ahn

polling-app-server/pom.xml

@@ -84,6 +84,11 @@
 			<artifactId>spring-security-test</artifactId>
 			<scope>test</scope>
 		</dependency>
+		<dependency>
+			<groupId>org.projectlombok</groupId>
+			<artifactId>lombok</artifactId>
+			<scope>provided</scope>
+		</dependency>
 	</dependencies>
 
 	<build>

polling-app-server/src/main/java/com/example/polls/controller/AuthController.java

@@ -4,10 +4,10 @@
 import com.example.polls.model.Role;
 import com.example.polls.model.RoleName;
 import com.example.polls.model.User;
-import com.example.polls.payload.ApiResponse;
-import com.example.polls.payload.JwtAuthenticationResponse;
-import com.example.polls.payload.LoginRequest;
-import com.example.polls.payload.SignUpRequest;
+import com.example.polls.payload.Response.ApiResponse;
+import com.example.polls.payload.Response.JwtAuthenticationResponse;
+import com.example.polls.payload.Request.LoginRequest;
+import com.example.polls.payload.Request.SignUpRequest;
 import com.example.polls.repository.RoleRepository;
 import com.example.polls.repository.UserRepository;
 import com.example.polls.security.JwtTokenProvider;

polling-app-server/src/main/java/com/example/polls/controller/GroupController.java

@@ -0,0 +1,68 @@
+package com.example.polls.controller;
+
+import com.example.polls.model.User;
+import com.example.polls.payload.Request.CreateGroupRequest;
+import com.example.polls.payload.Request.JoinGroupRequest;
+import com.example.polls.payload.Response.GroupDetailResponse;
+import com.example.polls.payload.Response.GroupSummaryResponse;
+import com.example.polls.repository.UserRepository;
+import com.example.polls.security.UserPrincipal;
+import com.example.polls.service.GroupService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+@RestController
+@RequestMapping("/api/groups")
+@RequiredArgsConstructor
+public class GroupController {
+    private final UserRepository userRepository;
+
+    private final GroupService groupService;
+
+    //그룹생성
+    @PostMapping
+    public ResponseEntity<GroupSummaryResponse> createGroup(
+            @RequestBody CreateGroupRequest request,
+            @AuthenticationPrincipal UserPrincipal userPrincipal) {
+
+        User creator = userRepository.findById(userPrincipal.getId())
+                .orElseThrow(()-> new RuntimeException("사용자 없음"));
+
+        GroupSummaryResponse response = groupService.createGroup(request, creator);
+        return ResponseEntity.status(HttpStatus.CREATED).body(response);
+    }
+
+    @GetMapping("/my")
+    public ResponseEntity<List<GroupSummaryResponse>> getMyGroups(@AuthenticationPrincipal UserPrincipal userPrincipal) {
+        Long useId = userPrincipal.getId();
+        List<GroupSummaryResponse> groups = groupService.getGroupsForUser(useId);
+        return ResponseEntity.ok(groups);
+    }
+
+    @PostMapping("/join")
+    public ResponseEntity<String> joinGroup(@RequestBody JoinGroupRequest request, @AuthenticationPrincipal UserPrincipal userPrincipal) {
+        groupService.joinCode(userPrincipal.getId(),request.getJoinCode());
+        return ResponseEntity.ok("그룹에 성공적으로 참여했습니다.");
+    }
+
+    //그룹 상세조회
+    @GetMapping("/{groupId}")
+    public ResponseEntity<GroupDetailResponse> getGroupDetail(@PathVariable Long groupId,
+                                                               @AuthenticationPrincipal UserPrincipal userPrincipal) {
+        GroupDetailResponse response = groupService.getGroupDetail(groupId,userPrincipal.getId());
+        return ResponseEntity.ok(response);
+    }
+
+    @GetMapping("{groupId}/members")
+    public ResponseEntity<List<GroupDetailResponse.MemberSummary>> getGroupMembers(@PathVariable Long groupId,
+                                                                                   @AuthenticationPrincipal UserPrincipal userPrincipal) {
+        GroupDetailResponse response = groupService.getGroupDetail(groupId, userPrincipal.getId());
+        return ResponseEntity.ok(response.getMembers());
+    }
+
+}

polling-app-server/src/main/java/com/example/polls/controller/PollController.java

@@ -1,7 +1,11 @@
 package com.example.polls.controller;
 
 import com.example.polls.model.*;
-import com.example.polls.payload.*;
+import com.example.polls.payload.Request.PollRequest;
+import com.example.polls.payload.Request.VoteRequest;
+import com.example.polls.payload.Response.ApiResponse;
+import com.example.polls.payload.Response.PagedResponse;
+import com.example.polls.payload.Response.PollResponse;
 import com.example.polls.repository.PollRepository;
 import com.example.polls.repository.UserRepository;
 import com.example.polls.repository.VoteRepository;

polling-app-server/src/main/java/com/example/polls/controller/UserController.java

@@ -3,6 +3,8 @@
 import com.example.polls.exception.ResourceNotFoundException;
 import com.example.polls.model.User;
 import com.example.polls.payload.*;
+import com.example.polls.payload.Response.PagedResponse;
+import com.example.polls.payload.Response.PollResponse;
 import com.example.polls.repository.PollRepository;
 import com.example.polls.repository.UserRepository;
 import com.example.polls.repository.VoteRepository;

polling-app-server/src/main/java/com/example/polls/exception/AlreadyJoinedException.java

@@ -0,0 +1,7 @@
+package com.example.polls.exception;
+
+public class AlreadyJoinedException extends RuntimeException {
+    public AlreadyJoinedException(String message) {
+        super(message);
+    }
+}

polling-app-server/src/main/java/com/example/polls/exception/GlobalExceptionHandler.java

@@ -0,0 +1,45 @@
+package com.example.polls.exception;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+import java.util.Map;
+
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+    // 400 Bad Request
+    @ExceptionHandler(BadRequestException.class)
+    public ResponseEntity<?> handleBadRequest(BadRequestException ex) {
+        return buildErrorResponse(HttpStatus.BAD_REQUEST, ex.getMessage());
+    }
+
+    // 404 Not Found
+    @ExceptionHandler(ResourceNotFoundException.class)
+    public ResponseEntity<?> handleNotFound(ResourceNotFoundException ex) {
+        return buildErrorResponse(HttpStatus.NOT_FOUND, ex.getMessage());
+    }
+
+    // 409 Conflict
+    @ExceptionHandler(AlreadyJoinedException.class)
+    public ResponseEntity<?> handleConflict(AlreadyJoinedException ex) {
+        return buildErrorResponse(HttpStatus.CONFLICT, ex.getMessage());
+    }
+
+    // 500 Internal Server Error (예외 누락 시 fallback)
+    @ExceptionHandler(Exception.class)
+    public ResponseEntity<?> handleException(Exception ex) {
+        return buildErrorResponse(HttpStatus.INTERNAL_SERVER_ERROR, "서버 오류가 발생했습니다.");
+    }
+
+    // 공통 응답 포맷 생성 메서드
+    private ResponseEntity<?> buildErrorResponse(HttpStatus status, String message) {
+        return ResponseEntity.status(status).body(Map.of(
+                "status", status.value(),
+                "error", status.getReasonPhrase(),
+                "message", message
+        ));
+    }
+}

polling-app-server/src/main/java/com/example/polls/model/Group.java

@@ -0,0 +1,93 @@
+package com.example.polls.model;
+
+import com.example.polls.model.audit.UserDateAudit;
+
+import javax.persistence.*;
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.Size;
+import java.util.ArrayList;
+import java.util.List;
+
+@Entity
+@Table(name = "`groups`")
+public class Group extends UserDateAudit {
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @NotBlank
+    @Size(max = 100)
+    private String name;
+
+    @Size(max=255)
+    private String description;
+
+    @Column(unique = true)
+    private String joinCode;
+
+    @Column
+    private String imageUrl;
+
+    @OneToMany(mappedBy="group",cascade = CascadeType.ALL, orphanRemoval = true)
+    private List<GroupMember> members = new ArrayList<>();
+
+    @OneToMany(mappedBy = "group", cascade=CascadeType.ALL)
+    private List<Poll> polls = new ArrayList<>();
+
+
+    public String getImageUrl() {
+        return imageUrl;
+    }
+
+    public void setImageUrl(String imageUrl) {
+        this.imageUrl = imageUrl;
+    }
+
+    public Long getId() {
+        return id;
+    }
+
+    public void setId(Long id) {
+        this.id = id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    public void setDescription(String description) {
+        this.description = description;
+    }
+
+    public String getJoinCode() {
+        return joinCode;
+    }
+
+    public void setJoinCode(String joinCode) {
+        this.joinCode = joinCode;
+    }
+
+    public List<GroupMember> getMembers() {
+        return members;
+    }
+
+    public void setMembers(List<GroupMember> members) {
+        this.members = members;
+    }
+
+    public List<Poll> getPolls() {
+        return polls;
+    }
+
+    public void setPolls(List<Poll> polls) {
+        this.polls = polls;
+    }
+}

polling-app-server/src/main/java/com/example/polls/model/GroupMember.java

@@ -0,0 +1,83 @@
+package com.example.polls.model;
+
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+
+import javax.persistence.*;
+import java.time.Instant;
+
+@Entity
+@EntityListeners(AuditingEntityListener.class)
+@Table(name = "group_members")
+public class GroupMember {
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "group_id", nullable = false)
+    private Group group;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "user_id", nullable = false)
+    private User user;
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "role", nullable = false)
+    private GroupRole role;
+
+    @CreatedDate
+    @Column(name = "joined_at", nullable = false, updatable = false)
+    private Instant joinedAt;
+
+    public Instant getJoinedAt() {
+        return joinedAt;
+    }
+
+    public void setJoinedAt(Instant joinedAt) {
+        this.joinedAt = joinedAt;
+    }
+
+    public GroupMember(Long id, Group group, User user, GroupRole role) {
+        this.id = id;
+        this.group = group;
+        this.user = user;
+        this.role = role;
+    }
+
+    public GroupMember() {
+
+    }
+
+    public Long getId() {
+        return id;
+    }
+
+    public void setId(Long id) {
+        this.id = id;
+    }
+
+    public Group getGroup() {
+        return group;
+    }
+
+    public void setGroup(Group group) {
+        this.group = group;
+    }
+
+    public User getUser() {
+        return user;
+    }
+
+    public void setUser(User user) {
+        this.user = user;
+    }
+
+    public GroupRole getRole() {
+        return role;
+    }
+
+    public void setRole(GroupRole role) {
+        this.role = role;
+    }
+}

polling-app-server/src/main/java/com/example/polls/model/GroupRole.java

@@ -0,0 +1,5 @@
+package com.example.polls.model;
+
+public enum GroupRole {
+    LEADER, MEMBER
+}