Merge pull request #33 from Team-UMC/feature/#28/invite-api

[FEAT] 초대 코드 관련 API 구현

src/main/java/com/umc/networkingService/config/security/auth/PrincipalDetails.java

@@ -28,7 +28,7 @@ public Member getMember() {
     @Override
     public Collection<? extends GrantedAuthority> getAuthorities() {
         Collection<GrantedAuthority> authorities = new ArrayList<>();
-        authorities.add(new SimpleGrantedAuthority(member.getRole().toString()));
+        authorities.add(new SimpleGrantedAuthority("ROLE_" + member.getRole().toString()));
         return authorities;
     }
 

src/main/java/com/umc/networkingService/domain/invite/controller/InviteController.java

@@ -0,0 +1,61 @@
+package com.umc.networkingService.domain.invite.controller;
+
+import com.umc.networkingService.config.security.auth.CurrentMember;
+import com.umc.networkingService.domain.invite.dto.response.InviteAuthenticateResponse;
+import com.umc.networkingService.domain.invite.dto.response.InviteCreateResponse;
+import com.umc.networkingService.domain.invite.dto.response.InviteInquiryMineResponse;
+import com.umc.networkingService.domain.invite.service.InviteService;
+import com.umc.networkingService.domain.member.entity.Member;
+import com.umc.networkingService.global.common.base.BaseResponse;
+import com.umc.networkingService.global.common.enums.Role;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.enums.ParameterIn;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+@Tag(name = "초대 API", description = "초대 관련 API")
+@RestController
+@RequiredArgsConstructor
+public class InviteController {
+
+    private final InviteService inviteService;
+
+    @Operation(summary = "초대 코드 발급 API", description = "일반 부원용 또는 운영진용 초대 코드 발급 API입니다.")
+    @ApiResponses( value = {
+            @ApiResponse(responseCode = "COMMON200", description = "성공"),
+            @ApiResponse(responseCode = "INVITE002", description = "상위의 역할에 대해서 초대 코드를 발급할 경우 발생")
+    })
+    @Parameter(name = "role", description = "초대 코드에 부여할 역할을 지정합니다.(ex. MEMBER, STAFF, CAMPUS_STAFF ...)")
+    @PostMapping("/staff/invites")
+    public BaseResponse<InviteCreateResponse> createInviteCode(@CurrentMember Member member,
+                                                               @RequestParam Role role) {
+        return BaseResponse.onSuccess(inviteService.createInviteCode(member, role));
+    }
+
+    @Operation(summary = "나의 초대 코드 조회 API", description = "본인이 생성한 초대 코드 목록 조회 API입니다.")
+    @ApiResponses( value = {
+            @ApiResponse(responseCode = "COMMON200", description = "성공")
+    })
+    @GetMapping("/staff/invites")
+    public BaseResponse<List<InviteInquiryMineResponse>> inquiryMyInviteCode(@CurrentMember Member member) {
+        return BaseResponse.onSuccess(inviteService.inquiryMyInviteCode(member));
+    }
+
+    @Operation(summary = "초대 코드 확인 API", description = "발급 받은 초대 코드를 검증하는 API입니다.")
+    @ApiResponses( value = {
+            @ApiResponse(responseCode = "COMMON200", description = "성공"),
+            @ApiResponse(responseCode = "INVITE001", description = "만료된 초대 코드일 경우 발생")
+    })
+    @Parameter(name = "inviteCode", in = ParameterIn.PATH, description = "발급 받은 초대 코드를 입력하는 파라미터입니다.")
+    @PostMapping("/invites/{inviteCode}")
+    public BaseResponse<InviteAuthenticateResponse> authenticationInviteCode(@CurrentMember Member member,
+                                                                             @PathVariable String inviteCode) {
+        return BaseResponse.onSuccess(inviteService.authenticateInviteCode(member, inviteCode));
+    }
+}

src/main/java/com/umc/networkingService/domain/invite/dto/response/InviteAuthenticateResponse.java

@@ -0,0 +1,11 @@
+package com.umc.networkingService.domain.invite.dto.response;
+
+import com.umc.networkingService.global.common.enums.Role;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public class InviteAuthenticateResponse {
+    private Role role;
+}

src/main/java/com/umc/networkingService/domain/invite/dto/response/InviteCreateResponse.java

@@ -0,0 +1,12 @@
+package com.umc.networkingService.domain.invite.dto.response;
+
+import com.umc.networkingService.global.common.enums.Role;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public class InviteCreateResponse {
+    private String inviteCode;
+    private Role role;
+}

src/main/java/com/umc/networkingService/domain/invite/dto/response/InviteInquiryMineResponse.java

@@ -0,0 +1,15 @@
+package com.umc.networkingService.domain.invite.dto.response;
+
+import com.umc.networkingService.global.common.enums.Role;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.time.LocalDateTime;
+
+@Getter
+@AllArgsConstructor
+public class InviteInquiryMineResponse {
+    private String inviteCode;
+    private Role role;
+    private LocalDateTime createdAt;
+}

src/main/java/com/umc/networkingService/domain/inviteCode/entity/InviteCode.java → src/main/java/com/umc/networkingService/domain/invite/entity/Invite.java

@@ -1,22 +1,24 @@
-package com.umc.networkingService.domain.inviteCode.entity;
+package com.umc.networkingService.domain.invite.entity;
 
 import com.umc.networkingService.domain.member.entity.Member;
 import com.umc.networkingService.global.common.base.BaseEntity;
 import com.umc.networkingService.global.common.enums.Role;
 import jakarta.persistence.*;
-import lombok.AccessLevel;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
+import lombok.*;
 import org.hibernate.annotations.SQLRestriction;
 import org.hibernate.annotations.UuidGenerator;
 
+import java.time.LocalDateTime;
+import java.time.temporal.ChronoUnit;
 import java.util.UUID;
 
 @Getter
 @Entity
+@Builder
+@AllArgsConstructor
 @NoArgsConstructor(access= AccessLevel.PROTECTED)
 @SQLRestriction("deleted_at is null")
-public class InviteCode extends BaseEntity {
+public class Invite extends BaseEntity {
     @Id
     @UuidGenerator
     @Column(name = "invite_code_id")
@@ -32,4 +34,9 @@ public class InviteCode extends BaseEntity {
 
     @Column(nullable = false)
     private String code;
+
+    public boolean isExpired() {
+        LocalDateTime expiresAt = this.getCreatedAt().plus(3, ChronoUnit.DAYS);
+        return LocalDateTime.now().isAfter(expiresAt);
+    }
 }

src/main/java/com/umc/networkingService/domain/invite/mapper/InviteMapper.java

@@ -0,0 +1,13 @@
+package com.umc.networkingService.domain.invite.mapper;
+
+import com.umc.networkingService.domain.invite.dto.response.InviteInquiryMineResponse;
+import com.umc.networkingService.domain.invite.entity.Invite;
+import org.springframework.stereotype.Component;
+
+@Component
+public class InviteMapper {
+
+    public InviteInquiryMineResponse toInquiryMineResponse(Invite invite) {
+        return new InviteInquiryMineResponse(invite.getCode(), invite.getRole(), invite.getCreatedAt());
+    }
+}

src/main/java/com/umc/networkingService/domain/invite/repository/InviteRepository.java

@@ -0,0 +1,19 @@
+package com.umc.networkingService.domain.invite.repository;
+
+import com.umc.networkingService.domain.invite.entity.Invite;
+import com.umc.networkingService.domain.member.entity.Member;
+import com.umc.networkingService.global.common.enums.Role;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.List;
+import java.util.Optional;
+import java.util.UUID;
+
+public interface InviteRepository extends JpaRepository<Invite, UUID> {
+
+    Optional<Invite> findByMemberAndRole(Member member, Role role);
+    Optional<Invite> findByCode(String code);
+
+    List<Invite> findAllByMember(Member member);
+    boolean existsByCode(String code);
+}

src/main/java/com/umc/networkingService/domain/invite/service/InviteService.java

@@ -0,0 +1,15 @@
+package com.umc.networkingService.domain.invite.service;
+
+import com.umc.networkingService.domain.invite.dto.response.InviteAuthenticateResponse;
+import com.umc.networkingService.domain.invite.dto.response.InviteCreateResponse;
+import com.umc.networkingService.domain.invite.dto.response.InviteInquiryMineResponse;
+import com.umc.networkingService.domain.member.entity.Member;
+import com.umc.networkingService.global.common.enums.Role;
+
+import java.util.List;
+
+public interface InviteService {
+    InviteCreateResponse createInviteCode(Member member, Role role);
+    InviteAuthenticateResponse authenticateInviteCode(Member member, String inviteCode);
+    List<InviteInquiryMineResponse> inquiryMyInviteCode(Member member);
+}

src/main/java/com/umc/networkingService/domain/invite/service/InviteServiceImpl.java

@@ -0,0 +1,107 @@
+package com.umc.networkingService.domain.invite.service;
+
+import com.umc.networkingService.domain.invite.dto.response.InviteAuthenticateResponse;
+import com.umc.networkingService.domain.invite.dto.response.InviteCreateResponse;
+import com.umc.networkingService.domain.invite.dto.response.InviteInquiryMineResponse;
+import com.umc.networkingService.domain.invite.entity.Invite;
+import com.umc.networkingService.domain.invite.mapper.InviteMapper;
+import com.umc.networkingService.domain.invite.repository.InviteRepository;
+import com.umc.networkingService.domain.member.entity.Member;
+import com.umc.networkingService.domain.member.service.MemberService;
+import com.umc.networkingService.global.common.base.BaseEntity;
+import com.umc.networkingService.global.common.enums.Role;
+import com.umc.networkingService.global.common.exception.ErrorCode;
+import com.umc.networkingService.global.common.exception.RestApiException;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.List;
+import java.util.Optional;
+import java.util.UUID;
+
+@Service
+@RequiredArgsConstructor
+public class InviteServiceImpl implements InviteService {
+
+    private final InviteMapper inviteMapper;
+
+    private final InviteRepository inviteRepository;
+    private final MemberService memberService;
+
+    // 초대 코드 생성 함수
+    @Override
+    public InviteCreateResponse createInviteCode(Member member, Role role) {
+        checkRolePriority(member, role);
+        deleteExistingInvite(member, role);
+        String inviteCode = generateUniqueInviteCode();
+        Invite savedInvite = saveInvite(member, role, inviteCode);
+        return new InviteCreateResponse(savedInvite.getCode(), savedInvite.getRole());
+    }
+
+    // 초대 코드 인증 함수
+    @Override
+    @Transactional
+    public InviteAuthenticateResponse authenticateInviteCode(Member member, String inviteCode) {
+        // 존재하지 않는 초대 코드인 경우 예외 처리
+        Invite savedInvite = inviteRepository.findByCode(inviteCode)
+                .orElseThrow(() -> new RestApiException(ErrorCode.EXPIRED_INVITE_CODE));
+
+        // 만료된 초대 코드인 경우 삭제 후 예외 처리
+        if (savedInvite.isExpired()) {
+            savedInvite.delete();
+            throw new RestApiException(ErrorCode.EXPIRED_INVITE_CODE);
+        }
+
+        // 초대 코드에 부여된 역할 부여
+        member.updateRole(savedInvite.getRole());
+        Member savedMember = memberService.saveEntity(member);
+
+        return new InviteAuthenticateResponse(savedMember.getRole());
+    }
+
+    // 나의 초대 코드 조회 함수
+    @Override
+    public List<InviteInquiryMineResponse> inquiryMyInviteCode(Member member) {
+        // 본인이 생성한 초대 코드 조회
+        List<Invite> savedInvites = inviteRepository.findAllByMember(member);
+
+        return savedInvites.stream()
+                .map(inviteMapper::toInquiryMineResponse)
+                .toList();
+    }
+
+    // 본인의 역할 이상의 역할 부여를 확인하는 함수
+    private void checkRolePriority(Member member, Role role) {
+        if (member.getRole().getPriority() >= role.getPriority()) {
+            throw new RestApiException(ErrorCode.UNAUTHORIZED_CREATE_INVITE);
+        }
+    }
+
+    // 존재하는 초대 코드 삭제 함수
+    private void deleteExistingInvite(Member member, Role role) {
+        Optional<Invite> oldInvite = inviteRepository.findByMemberAndRole(member, role);
+        oldInvite.ifPresent(BaseEntity::delete);
+    }
+
+    // 중복되지 않는 초대 코드 생성 함수
+    private String generateUniqueInviteCode() {
+        String inviteCode;
+        do {
+            inviteCode = UUID.randomUUID().toString().replace("-", "").substring(0, 10);
+        } while (inviteRepository.existsByCode(inviteCode));
+        return inviteCode;
+    }
+
+    // 초대 코드 저장 함수
+    private Invite saveInvite(Member member, Role role, String inviteCode) {
+        return inviteRepository.save(
+                Invite.builder()
+                        .member(member)
+                        .code(inviteCode)
+                        .role(role)
+                        .build()
+        );
+    }
+
+}

src/main/java/com/umc/networkingService/domain/member/controller/MemberController.java

@@ -67,9 +67,9 @@ public BaseResponse<MemberInquiryInfoWithPointResponse> inquiryHomeInfo(@Current
             @ApiResponse(responseCode = "AUTH008", description = "깃허브 서버와 통신 실패할 경우 발생")
     })
     @PostMapping("/github")
-    public BaseResponse<MemberAuthenticationGithubResponse> authenticationGithub(@CurrentMember Member member,
-                                                                                 @RequestParam String code) {
-        return BaseResponse.onSuccess(memberService.authenticationGithub(member, code));
+    public BaseResponse<MemberAuthenticateGithubResponse> authenticationGithub(@CurrentMember Member member,
+                                                                               @RequestParam String code) {
+        return BaseResponse.onSuccess(memberService.authenticateGithub(member, code));
     }
 
     @Operation(summary = "깃허브 데이터 조회 API", description = "깃허브 잔디 이미지를 조회하는 API입니다.")

src/main/java/com/umc/networkingService/domain/member/dto/response/MemberAuthenticationGithubResponse.java → src/main/java/com/umc/networkingService/domain/member/dto/response/MemberAuthenticateGithubResponse.java

@@ -5,6 +5,6 @@
 
 @Getter
 @AllArgsConstructor
-public class MemberAuthenticationGithubResponse {
+public class MemberAuthenticateGithubResponse {
     private String githubNickname;
 }

src/main/java/com/umc/networkingService/domain/member/entity/Member.java

@@ -95,8 +95,7 @@ public void updatePositions(List<MemberPosition> memberPositions) {
     public void updateSemesterParts(List<SemesterPart> semesterParts) {
         this.semesterParts = semesterParts;
     }
-
-    public void authenticationGithub(String gitNickname) {
+    public void authenticateGithub(String gitNickname) {
         this.gitNickname = gitNickname;
     }
 
@@ -105,7 +104,6 @@ public void updateContributionPoint(Long usedPoint) {
         else this.contributionPoint += usedPoint;
     }
 
-    // 테스트 코드용
     public void updateRole(Role role) {
         this.role = role;
     }

src/main/java/com/umc/networkingService/domain/member/service/AuthService.java

@@ -10,6 +10,7 @@
 
 import java.util.UUID;
 
+
 public interface AuthService extends EntityLoader<Member, UUID> {
     MemberLoginResponse socialLogin(final String accessToken, SocialType socialType);
     MemberIdResponse signUp(Member member, MemberSignUpRequest request);

src/main/java/com/umc/networkingService/domain/member/service/AuthServiceImpl.java

@@ -31,6 +31,8 @@
 @RequiredArgsConstructor
 public class AuthServiceImpl implements AuthService {
 
+    private final MemberService memberService;
+
     private final MemberMapper memberMapper;
     private final MemberRepository memberRepository;
 
@@ -85,7 +87,7 @@ public MemberIdResponse signUp(Member loginMember, MemberSignUpRequest request)
         member.setMemberInfo(request.getName(), request.getNickname(),
                 university, branchUniversityService.findBranchByUniversity(university));
 
-        return new MemberIdResponse(memberRepository.save(member).getId());
+        return new MemberIdResponse(memberService.saveEntity(member).getId());
     }
 
     // 새로운 액세스 토큰 발급 함수
@@ -119,6 +121,7 @@ public MemberIdResponse logout(Member loginMember) {
     @Override
     @Transactional
     public MemberIdResponse withdrawal(Member loginMember) {
+        // 멤버 soft delete
         Member member = loadEntity(loginMember.getId());
 
         // refreshToken 삭제
@@ -155,7 +158,8 @@ private MemberLoginResponse loginByKakao(final String accessToken){
             return saveNewMember(clientId, SocialType.KAKAO);
         }
         // 2. 있으면 : 새로운 토큰 반환
-        return getNewToken(getMember.get(), true);
+        boolean isServiceMember = getMember.get().getName() != null;
+        return getNewToken(getMember.get(), isServiceMember);
     }
 
     private MemberLoginResponse loginByNaver(final String accessToken){