Feat/#32 invitation

src/main/java/com/teamEWSN/gitdeun/common/exception/ErrorCode.java

@@ -43,7 +43,15 @@ public enum ErrorCode {
 
     // 멤버 관련
     MEMBER_NOT_FOUND(HttpStatus.NOT_FOUND, "MEMBER-001", "해당 멤버를 찾을 수 없습니다."),
+    MEMBER_ALREADY_EXISTS(HttpStatus.CONFLICT, "MEMBER-002", "이미 마인드맵에 등록된 멤버입니다."),
 
+    // 초대 관련
+    INVITATION_NOT_FOUND(HttpStatus.NOT_FOUND, "INVITE-001", "초대 정보를 찾을 수 없습니다."),
+    INVITATION_EXPIRED(HttpStatus.BAD_REQUEST, "INVITE-002", "만료된 초대입니다."),
+    INVITATION_ALREADY_EXISTS(HttpStatus.CONFLICT, "INVITE-003", "이미 초대 대기 중인 사용자입니다."),
+    CANNOT_INVITE_SELF(HttpStatus.BAD_REQUEST, "INVITE-004", "자기 자신을 초대할 수 없습니다."),
+    INVITATION_REJECTED_USER(HttpStatus.FORBIDDEN, "INVITE-005", "초대를 거절한 사용자이므로 초대할 수 없습니다."),
+
     // 방문기록 관련
     HISTORY_NOT_FOUND(HttpStatus.NOT_FOUND, "VISITHISTORY-001", "방문 기록을 찾을 수 없습니다."),
 

src/main/java/com/teamEWSN/gitdeun/invitation/controller/InvitationController.java

@@ -1,5 +1,102 @@
 package com.teamEWSN.gitdeun.invitation.controller;
 
+import com.teamEWSN.gitdeun.common.jwt.CustomUserDetails;
+import com.teamEWSN.gitdeun.invitation.dto.InvitationActionResponseDto;
+import com.teamEWSN.gitdeun.invitation.dto.InvitationResponseDto;
+import com.teamEWSN.gitdeun.invitation.dto.InviteRequestDto;
+import com.teamEWSN.gitdeun.invitation.dto.LinkResponseDto;
+import com.teamEWSN.gitdeun.invitation.service.InvitationService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.web.PageableDefault;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.*;
+
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/invitations")
 public class InvitationController {
-
+    private final InvitationService invitationService;
+
+    // 이메일로 멤버 초대
+    @PostMapping("/mindmaps/{mapId}")
+    public ResponseEntity<Void> inviteByEmail(
+        @PathVariable Long mapId,
+        @Valid @RequestBody InviteRequestDto requestDto,
+        @AuthenticationPrincipal CustomUserDetails userDetails
+    ) {
+        invitationService.inviteUserByEmail(mapId, requestDto, userDetails.getId());
+        return ResponseEntity.noContent().build();
+    }
+
+    // 특정 마인드맵의 전체 초대 목록 조회 (페이지네이션 적용)
+    @GetMapping("/mindmaps/{mapId}")
+    public ResponseEntity<Page< InvitationResponseDto>> getInvitations(
+        @PathVariable Long mapId,
+        @AuthenticationPrincipal CustomUserDetails userDetails,
+        @PageableDefault(size = 10, sort = "createdAt,desc") Pageable pageable
+    ) {
+        return ResponseEntity.ok(invitationService.getInvitationsByMindmap(mapId, userDetails.getId(), pageable));
+    }
+
+    // 초대 수락
+    @PostMapping("/{invitationId}/accept")
+    public ResponseEntity<Void> acceptInvitation(
+        @PathVariable Long invitationId,
+        @AuthenticationPrincipal CustomUserDetails userDetails
+    ) {
+        invitationService.acceptInvitation(invitationId, userDetails.getId());
+        return ResponseEntity.noContent().build();
+    }
+
+    // 초대 거절
+    @PostMapping("/{invitationId}/reject")
+    public ResponseEntity<Void> rejectInvitation(
+        @PathVariable Long invitationId,
+        @AuthenticationPrincipal CustomUserDetails userDetails
+    ) {
+        invitationService.rejectInvitation(invitationId, userDetails.getId());
+        return ResponseEntity.noContent().build();
+    }
+
+
+    // 초대 링크 생성
+    @PostMapping("/mindmaps/{mapId}/link")
+    public ResponseEntity<LinkResponseDto> createInvitationLink(
+        @PathVariable Long mapId,
+        @AuthenticationPrincipal CustomUserDetails userDetails
+    ) {
+        return ResponseEntity.ok(invitationService.createInvitationLink(mapId, userDetails.getId()));
+    }
+
+    // 초대 링크를 통해 수락 (로그인한 사용자가 링크 클릭 시)
+    @PostMapping("/link/{token}/accept")
+    public ResponseEntity<Void> acceptInvitationByLink(
+        @PathVariable String token,
+        @AuthenticationPrincipal CustomUserDetails userDetails
+    ) {
+        invitationService.acceptInvitationByLink(token, userDetails.getId());
+        return ResponseEntity.noContent().build();
+    }
+
+    // Owner가 링크 초대 승인
+    @PostMapping("/{invitationId}/approve")
+    public ResponseEntity<InvitationActionResponseDto> approveLinkInvitation(
+        @PathVariable Long invitationId,
+        @AuthenticationPrincipal CustomUserDetails userDetails
+    ) {
+        return ResponseEntity.ok(invitationService.approveLinkInvitation(invitationId, userDetails.getId()));
+    }
+    // Owner가 링크 초대 거부
+    @PostMapping("/{invitationId}/reject-link")
+    public ResponseEntity<InvitationActionResponseDto> rejectLinkApproval(
+        @PathVariable Long invitationId,
+        @AuthenticationPrincipal CustomUserDetails userDetails
+    ) {
+        return ResponseEntity.ok(invitationService.rejectLinkApproval(invitationId, userDetails.getId()));
+    }
 }

src/main/java/com/teamEWSN/gitdeun/invitation/dto/InvitationActionResponseDto.java

@@ -0,0 +1,10 @@
+package com.teamEWSN.gitdeun.invitation.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public class InvitationActionResponseDto {
+    private String message;
+}

src/main/java/com/teamEWSN/gitdeun/invitation/dto/InvitationResponseDto.java

@@ -0,0 +1,21 @@
+package com.teamEWSN.gitdeun.invitation.dto;
+
+import com.teamEWSN.gitdeun.invitation.entity.InvitationStatus;
+import com.teamEWSN.gitdeun.mindmapmember.entity.MindmapRole;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.time.LocalDateTime;
+
+@Getter
+@AllArgsConstructor
+public class InvitationResponseDto {
+
+    private Long invitationId;
+    private String mindmapName;
+    private String inviteeName;
+    private String inviteeEmail;
+    private MindmapRole role;
+    private InvitationStatus status;
+    private LocalDateTime createdAt;
+}

src/main/java/com/teamEWSN/gitdeun/invitation/dto/InviteRequestDto.java

@@ -0,0 +1,20 @@
+package com.teamEWSN.gitdeun.invitation.dto;
+
+import com.teamEWSN.gitdeun.mindmapmember.entity.MindmapRole;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotNull;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+public class InviteRequestDto {
+    @Email(message = "올바른 이메일 형식이 아닙니다.")
+    @NotNull(message = "이메일을 입력해주세요.")
+    private String email;
+
+    @NotNull(message = "권한을 선택해주세요.")
+    private MindmapRole role;
+}

src/main/java/com/teamEWSN/gitdeun/invitation/dto/LinkResponseDto.java

@@ -0,0 +1,10 @@
+package com.teamEWSN.gitdeun.invitation.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+@Getter
+@AllArgsConstructor
+public class LinkResponseDto {
+    private String invitationLink;
+}

src/main/java/com/teamEWSN/gitdeun/invitation/entity/Invitation.java

@@ -1,47 +1,61 @@
 package com.teamEWSN.gitdeun.invitation.entity;
 
+import com.teamEWSN.gitdeun.common.util.CreatedEntity;
 import com.teamEWSN.gitdeun.mindmap.entity.Mindmap;
+import com.teamEWSN.gitdeun.mindmapmember.entity.MindmapRole;
 import com.teamEWSN.gitdeun.user.entity.User;
 import jakarta.persistence.*;
-import lombok.AccessLevel;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
-import org.hibernate.annotations.ColumnDefault;
-import org.hibernate.annotations.CreationTimestamp;
+import lombok.*;
 
 import java.time.LocalDateTime;
 
 @Entity
 @Getter
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor(access = AccessLevel.PRIVATE) // 빌더만 사용하도록 강제
+@Builder(toBuilder = true)
 @Table(name = "invitation")
-public class Invitation {
+public class Invitation extends CreatedEntity {
 
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
     private Long id;
 
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "user_id", nullable = false)
-    private User user;
-
     @ManyToOne(fetch = FetchType.LAZY)
     @JoinColumn(name = "mindmap_id", nullable = false)
     private Mindmap mindmap;
 
+    // 초대한 사람
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "inviter_id", nullable = false)
+    private User inviter;
+
+    // 초대받은 사람 (이메일 초대의 경우)
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "invitee_id")
+    private User invitee;
+
     @Column(length = 36, nullable = false, unique = true)
     private String token;
 
     @Enumerated(EnumType.STRING)
     @Column(nullable = false)
-    @ColumnDefault("'READ_ONLY'")
+    private MindmapRole role; // 초대 시 부여할 권한
+
+    @Enumerated(EnumType.STRING)
+    @Column(nullable = false)
     private InvitationStatus status;
 
-    @CreationTimestamp
-    @Column(name = "invited_at", updatable = false)
-    private LocalDateTime invitedAt;
+    @Column(name = "expires_at")
+    private LocalDateTime expiresAt; // 초대 만료 시간
+
+
+    public Invitation accept() {
+        this.status = InvitationStatus.ACCEPTED;
+        return this;
+    }
 
-    @Column(name = "is_accept", nullable = false)
-    @ColumnDefault("false")
-    private boolean isAccept;
+    public void reject() {
+        this.status = InvitationStatus.REJECTED;
+    }
 }

src/main/java/com/teamEWSN/gitdeun/invitation/entity/InvitationStatus.java

@@ -1,6 +1,7 @@
 package com.teamEWSN.gitdeun.invitation.entity;
 
 public enum InvitationStatus {
-    READ_ONLY,
-    EDIT_ALLOWED
+    PENDING,  // 초대 승인 대기중
+    ACCEPTED, // 수락
+    REJECTED  // 거절
 }

src/main/java/com/teamEWSN/gitdeun/invitation/mapper/InvitationMapper.java

@@ -0,0 +1,17 @@
+package com.teamEWSN.gitdeun.invitation.mapper;
+
+import com.teamEWSN.gitdeun.invitation.dto.InvitationResponseDto;
+import com.teamEWSN.gitdeun.invitation.entity.Invitation;
+import org.mapstruct.Mapper;
+import org.mapstruct.Mapping;
+import org.mapstruct.ReportingPolicy;
+
+@Mapper(componentModel = "spring", unmappedTargetPolicy = ReportingPolicy.IGNORE)
+public interface InvitationMapper {
+
+    @Mapping(source = "id", target = "invitationId")
+    @Mapping(source = "mindmap.field", target = "mindmapName")
+    @Mapping(source = "invitee.name", target = "inviteeName")
+    @Mapping(source = "invitee.email", target = "inviteeEmail", defaultExpression = "java(\"링크 초대\")")
+    InvitationResponseDto toResponseDto(Invitation invitation);
+}

src/main/java/com/teamEWSN/gitdeun/invitation/repository/InvitationRepository.java

@@ -1,5 +1,31 @@
 package com.teamEWSN.gitdeun.invitation.repository;
 
-public class InvitationRepository {
-
+import com.teamEWSN.gitdeun.invitation.entity.Invitation;
+import com.teamEWSN.gitdeun.invitation.entity.InvitationStatus;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.Optional;
+
+@Repository
+public interface InvitationRepository extends JpaRepository<Invitation, Long> {
+
+    // 특정 마인드맵의 모든 초대 목록을 페이징하여 조회
+    Page<Invitation> findByMindmapId(Long mindmapId, Pageable pageable);
+
+    // 특정 마인드맵에 특정 유저가 이미 초대 대기중인지 확인
+    boolean existsByMindmapIdAndInviteeIdAndStatusAndExpiresAtAfter(Long mindmapId, Long inviteeId, InvitationStatus status, LocalDateTime now);
+
+    boolean existsByMindmapIdAndInviteeIdAndStatus(Long mindmapId, Long inviteeId, InvitationStatus status);
+
+    // 사용자가 받은 모든 초대 목록 조회
+    List<Invitation> findByInviteeIdAndStatus(Long inviteeId, InvitationStatus status);
+
+    // 고유 토큰으로 초대 정보 조회
+    Optional<Invitation> findByToken(String token);
+
 }