Feature/144 봉사자 to 기관 쪽지 송신 기능 개발 (#154)

* feat: 봉사자 to 기관 쪽지 송신 기능 레포지토리 구현

- 레포지토리 인터페이스 생성
- Jpa 레포지토리 생성
- 레포지토리 구현체 생성

* feat: 봉사자 to 기관 쪽지 송신 기능 서비스레이어 구현

- 유스케이스 생성
- 송신 클래스및 메서드 생성
- 요청 Dto 구현및 toEntity 변환 메서드 구

* feat: 봉사자 to 기관 쪽지 송신 기능 엔드포인트 구현

- 컨트롤러 구현
- 테스트 코드 작성및 검증 완료

* style(SendNoteToCenterTest): 잠재적 에러 예방을 위한 개행 추가

- 마지막 라인에 개행 추가

* chore: 코드 리뷰 사항 반영

- 엔티티에 존재하던 불필요한 백틱 제거
- 컨트롤러에 존재하던 불필요한 value 속성 지정 제거
- 불필요한 개행 제거

Author: 7zrv

src/main/java/com/somemore/domains/Note.java

@@ -0,0 +1,36 @@
+package com.somemore.note.controller;
+
+import com.somemore.auth.annotation.CurrentUser;
+import com.somemore.global.common.response.ApiResponse;
+import com.somemore.note.dto.SendNoteToCenterRequestDto;
+import com.somemore.note.usecase.SendNoteToCenterUseCase;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.security.access.annotation.Secured;
+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 java.util.UUID;
+
+@Tag(name = "Note Command API", description = "쪽지 송신 삭제 API")
+@RequiredArgsConstructor
+@RequestMapping("/api/note")
+@RestController
+public class NoteCommandApiController {
+
+    private final SendNoteToCenterUseCase sendNoteToCenterUseCase;
+
+    @Secured("ROLE_VOLUNTEER")
+    @Operation(summary = "봉사자 to 기관 쪽지 송신")
+    @PostMapping("/volunteer-to-center")
+    public ApiResponse<Long> sendNoteToCenter(@CurrentUser UUID userId, @Valid @RequestBody SendNoteToCenterRequestDto requestDto) {
+
+        Long noteId = sendNoteToCenterUseCase.sendNoteToCenter(userId, requestDto);
+
+        return ApiResponse.ok(201, noteId, "쪽지 송신 성공");
+    }
+}

src/main/java/com/somemore/note/controller/NoteCommandApiController.java

@@ -0,0 +1,57 @@
+package com.somemore.note.domain;
+
+import com.somemore.global.common.BaseEntity;
+import com.somemore.interestcenter.domain.InterestCenter;
+import jakarta.persistence.*;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.util.UUID;
+
+import static jakarta.persistence.GenerationType.IDENTITY;
+
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Getter
+@Entity
+@Table(name = "note")
+public class Note extends BaseEntity {
+    @Id
+    @GeneratedValue(strategy = IDENTITY)
+    private Long id;
+
+    @Column(name = "sender_id", nullable = false, length = 16)
+    private UUID senderId;
+
+    @Column(name = "receiver_id", nullable = false, length = 16)
+    private UUID receiverId;
+
+    @Column(name = "title", nullable = false)
+    private String title;
+
+    @Lob
+    @Column(name = "content", nullable = false)
+    private String content;
+
+    @Column(name = "is_read", nullable = false)
+    private Boolean isRead = false;
+
+    @Builder
+    private Note(UUID senderId, UUID receiverId, String title, String content) {
+        this.senderId = senderId;
+        this.receiverId = receiverId;
+        this.title = title;
+        this.content = content;
+    }
+
+    public static Note create(UUID senderId, UUID receiverId, String title, String content) {
+        return Note.builder()
+                .senderId(senderId)
+                .receiverId(receiverId)
+                .title(title)
+                .content(content)
+                .build();
+    }
+
+}

src/main/java/com/somemore/note/domain/Note.java

@@ -0,0 +1,29 @@
+package com.somemore.note.dto;
+
+import com.fasterxml.jackson.databind.PropertyNamingStrategies;
+import com.fasterxml.jackson.databind.annotation.JsonNaming;
+import com.somemore.note.domain.Note;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+
+import java.util.UUID;
+
+@JsonNaming(PropertyNamingStrategies.SnakeCaseStrategy.class)
+public record SendNoteToCenterRequestDto(
+
+        @Schema(description = "쪽지 수신 기관 아이디", example = "123e4567-e89b-12d3-a456-426614174000")
+        @NotNull(message = "수신 기관 아이디는 필수 값입니다.")
+        UUID receiverId,
+
+        @Schema(description = "쪽지 제목", example = "이번주 참여할 봉사자인데 문의 드릴게 있습니다.")
+        @NotNull(message = "쪽지 제목은 필수 값입니다.")
+        String title,
+
+        @Schema(description = "쪽지 내용", example = "정확히 어떤 일을 도와드리는건가요?")
+        @NotNull(message = "쪽지 내용은 필수 값입니다.")
+        String content
+) {
+        public Note toEntity(UUID senderId){
+                return Note.create(senderId, receiverId, title, content);
+        }
+}

src/main/java/com/somemore/note/dto/SendNoteToCenterRequestDto.java

@@ -0,0 +1,10 @@
+package com.somemore.note.repository;
+
+import com.somemore.note.domain.Note;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface NoteJpaRepository extends JpaRepository<Note, Long> {
+
+}

src/main/java/com/somemore/note/repository/NoteJpaRepository.java

@@ -0,0 +1,8 @@
+package com.somemore.note.repository;
+
+import com.somemore.note.domain.Note;
+
+public interface NoteRepository {
+
+    Note save(Note note);
+}

src/main/java/com/somemore/note/repository/NoteRepository.java

@@ -0,0 +1,18 @@
+package com.somemore.note.repository;
+
+import com.somemore.note.domain.Note;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Repository;
+
+@RequiredArgsConstructor
+@Repository
+public class NoteRepositoryImpl implements NoteRepository {
+
+    private final NoteJpaRepository noteJpaRepository;
+
+    @Override
+    public Note save(Note note) {
+        return noteJpaRepository.save(note);
+    }
+
+}

src/main/java/com/somemore/note/repository/NoteRepositoryImpl.java

@@ -0,0 +1,32 @@
+package com.somemore.note.service;
+
+import com.somemore.center.usecase.query.CenterQueryUseCase;
+import com.somemore.note.domain.Note;
+import com.somemore.note.dto.SendNoteToCenterRequestDto;
+import com.somemore.note.repository.NoteRepository;
+import com.somemore.note.usecase.SendNoteToCenterUseCase;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.UUID;
+
+@RequiredArgsConstructor
+@Service
+@Transactional
+public class SendNoteToCenterService implements SendNoteToCenterUseCase {
+
+    private final NoteRepository noteRepository;
+    private final CenterQueryUseCase centerQueryUseCase;
+
+    @Override
+    public Long sendNoteToCenter(UUID senderId, SendNoteToCenterRequestDto requestDto) {
+
+        centerQueryUseCase.validateCenterExists(requestDto.receiverId());
+
+        Note note = requestDto.toEntity(senderId);
+        noteRepository.save(note);
+        return note.getId();
+    }
+
+}

src/main/java/com/somemore/note/service/SendNoteToCenterService.java

@@ -0,0 +1,9 @@
+package com.somemore.note.usecase;
+
+import com.somemore.note.dto.SendNoteToCenterRequestDto;
+
+import java.util.UUID;
+
+public interface SendNoteToCenterUseCase {
+    Long sendNoteToCenter(UUID senderId, SendNoteToCenterRequestDto requestDto);
+}

src/main/java/com/somemore/note/usecase/SendNoteToCenterUseCase.java

@@ -0,0 +1,69 @@
+package com.somemore.note.controller;
+
+import com.somemore.ControllerTestSupport;
+import com.somemore.WithMockCustomUser;
+import com.somemore.note.dto.SendNoteToCenterRequestDto;
+import com.somemore.note.usecase.SendNoteToCenterUseCase;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.test.mock.mockito.MockBean;
+import org.springframework.http.MediaType;
+
+import java.util.UUID;
+
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.when;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+class NoteCommandApiControllerTest extends ControllerTestSupport{
+
+    @MockBean
+    private SendNoteToCenterUseCase sendNoteToCenterUseCase;
+
+    @DisplayName("봉사자는 기관에게 쪽지를 보낼수 있다 (controller)")
+    @Test
+    @WithMockCustomUser
+    void sendNoteToCenter_Success() throws Exception {
+        // Given
+        UUID receiverId = UUID.randomUUID();
+        SendNoteToCenterRequestDto requestDto = new SendNoteToCenterRequestDto(
+                receiverId,
+                "쪽지 제목 문의 드릴게 있습니다.",
+                "쪽지 내용"
+        );
+
+        when(sendNoteToCenterUseCase.sendNoteToCenter(any(UUID.class), any(SendNoteToCenterRequestDto.class)))
+                .thenReturn(1L);
+
+        // When & Then
+        mockMvc.perform(post("/api/note/volunteer-to-center")
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content(objectMapper.writeValueAsString(requestDto)))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.code").value(201))
+                .andExpect(jsonPath("$.data").value(1L))
+                .andExpect(jsonPath("$.message").value("쪽지 송신 성공"));
+    }
+
+    @DisplayName("쪽지 송신 시 누락된 정보가 있다면 송신을 할 수 없다")
+    @Test
+    void sendNoteToCenter_ValidationFail() throws Exception {
+        // Given
+        UUID userId = UUID.randomUUID();
+        SendNoteToCenterRequestDto invalidRequestDto = new SendNoteToCenterRequestDto(
+                null,
+                null,
+                null
+        );
+
+        // When & Then
+        mockMvc.perform(post("/api/note/volunteer-to-center")
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content(objectMapper.writeValueAsString(invalidRequestDto))
+                        .requestAttr("userId", userId))
+                .andExpect(status().isBadRequest());
+    }
+
+}