chore(board): merge from board port branch

Author: silberbullet

README.md

@@ -1,8 +1,8 @@
 # Introduction.
 
-이 샘플 프로젝트는 레이어드 아키텍처를 넘어 확장성과 유연성이 보장되고 MSA 철학에 걸맞은 헥사고날 아키텍처 기반으로 구현되었습니다.
+이 샘플 프로젝트는 레이어드 아키텍처를 넘어 확장성과 유연성을 보장하고 DDD 철학에 걸맞는 헥사고날 아키텍처 기반으로 구현되었습니다.
 
-기본적인 CRUD 동작과 헥사고날 구조를 파악과 개념을 익힐 수 있도록 하였습니다.
+기본적인 CRUD 동작과 헥사고날 아키텍처의 구조를 파악하고 관점을 익힐 수 있도록 하였습니다.
 
 다음 항목을 포함합니다.
 
@@ -31,9 +31,9 @@ me.nettee
 
 Adapter는 Application 계층에 정의된 port를 구현합니다.  
 
-- Driving Adapter는 시스템 외부에서 들어오는 요청을 담당합니다. ( HTTP 요청, 메시지 소비 ) 이후 애플리케이션에 전달합니다.
-- Driven Adpater는 시스템이 외부로 나가는 작업을 담당합니다. ( DB CRUD 작업, 외부 API 호출, 메시지 전달)  
-  - Driven Adapter는 Spring Data JPA를 사용합니다.
+- Driving Adapter는 시스템 외부에서 들어오는 요청을 담당합니다. (HTTP 요청, 메시지 소비) 이후 애플리케이션에 전달합니다.
+- Driven Adpater는 시스템이 외부로 나가는 작업을 담당합니다. (DB CRUD 작업, 외부 API 호출, 메시지 전달)  
+  - 실습에서 Driven Adapter는 RDB Adapter로, Spring Data JPA를 사용합니다.
 
 # Prerequisites
 
@@ -42,37 +42,63 @@ Adapter는 Application 계층에 정의된 port를 구현합니다.
 
 # Branch Rule 
 
-개발자들은 다음과 같은 Branch Rule을 꼭 숙지하고 준수해 주시기 바랍니다.
+개발자들은 다음과 같은 Branch Rule을 꼭 숙지하고 준수해 주시기 바랍니다. (간소화된 브랜치 운영)
 
 - **main 브랜치는 읽기 전용 입니다.**
   - main 브랜치는 관리자(`@merge-simpson`, `@silberbullet`)만 force push가 가능합니다.
-  - 모든 변경 사항은 feature 브랜치를 생성 후, main 브랜치로 병합해야 합니다.
+- **feature 브랜치**: 모든 변경 사항은 <ins>feature 브랜치</ins>를 생성 후, main 브랜치로 병합해야 합니다.
+  - `feature/기능명` 양식으로 명명하며, 영문 소문자, 숫자 및 하이픈(케밥 케이스)를 사용합니다. (추가적인 슬래시를 사용하지 않습니다.)
+    
+    ```mermaid
+      gitGraph
+      commit
+      commit
+      branch feature/board-example
+      branch feature/board-something
+      checkout feature/board-example
+      commit
+      checkout feature/board-something
+      commit
+      commit
+      checkout feature/board-example
+      commit
+      checkout main
+      merge feature/board-example
+      checkout main
+      merge feature/board-something
+      commit
+    ```
   
-- **병합 전 Pull Request는 필수입니다.**
+- **주요 브랜치에 병합 전 Pull Request(PR)는 필수입니다.**
   - Pull Request를 생성할 때, 최소 2명의 reviewer를 지정해야 합니다.
   - 관리자(@merge-simpson, @silberbullet)는 리뷰 없이 병합이 가능합니다.
-  - **코드에 대한 모든 논의(conversations)가 해결되지 않은 상태에서는 Pull Request를 병합할 수 없습니다.**
+  - **코드에 대한 모든 논의(conversations)가 해결(resolved)되지 않은 상태에서는 Pull Request를 병합할 수 없습니다.**
     <details>
     <summary>conversations 예시 보기</summary>
     
     1. @silberbullet 님이 pull request 생성 후, reviewer를 @merge-simpson 에게 신청하였습니다.  
     2. @merge-simpson 님은 코드 수정을 위해 comment를 남겼습니다.  
-    3. @silberbullet 님은 해당 코드를 수정하여 push 후 @merge-simpson님이 남긴 comment에 수정사항을 적어놓았습니다.  
+    3. @silberbullet 님은 해당 코드를 수정하여 push 후 @merge-simpson 님이 남긴 comment에 수정사항을 적어 놓았습니다.  
     4. @merge-simpson "Resolve conversation" 버튼을 클릭하여 피드백이 해결되었음을 표시합니다.  
-    5. 비로서 @silberbullet 님은 코드 병합이 가능합니다.  
+    5. 비로소 @silberbullet 님은 코드 병합이 가능합니다.  
     
     </details>
 
+# Commit Message
+
+커밋 메시지의 제1 규칙은 '알아볼 수 있는 메시지 전달'입니다.  
+커밋 양식의 준수도 좋지만, 양식의 각 바운더리는 차근차근 공감대가 모이는 방향으로 맞추어 봅니다.
 
-# Basic Commit Message Type
+## Basic Commit Message Type
 
-기본적인 커밋 메시지의 첫 단어는 작업의 목적을 명확히 하기 위해 타입으로 시작합니다. 
+커밋 메시지의 첫 단어는 작업의 목적을 명확히 하기 위해 커밋 타입으로 시작합니다. 
 
-다음 아래의 타입을 실습으로 사용해보시면 좋습니다.
+아래의 타입을 실습으로 사용해 보시면 좋습니다.
 
-- feat: 새로운 기능 추가
-- fix: 버그 수정
-- docs: 문서 수정 (README.md 등)
-- refactor: 코드 리팩토링 (기능 변화 없음)
-- test: 테스트 코드 추가 또는 수정
-- chore: 빌드 작업, 패키지 매니저 설정, 기타 작업 등
+- **feat**: 새로운 기능 추가
+- **fix**: 버그 수정
+- **docs**: 문서 생성 및 수정 (README.md 등)
+- **refactor**: 코드 리팩토링 (기능 변화 없음: 성능 개선, 패키지 이동, 파일·식별자 수정 등)
+- **test**: 테스트 코드 추가 또는 수정
+- **chore**: 코드의 구조나 동작에 영향을 주지 않는 기타 작업
+- **build**: 빌드 관련 작업, 패키지 매니저 설정 등

src/main/java/me/nettee/board/application/model/BoardQueryModel.java

@@ -0,0 +1,30 @@
+package me.nettee.board.application.model;
+
+import me.nettee.board.application.domain.type.BoardStatus;
+
+import java.time.Instant;
+
+public final class BoardQueryModel {
+
+    private BoardQueryModel() {
+    }
+
+    public record BoardDetail(
+            Long id,
+            String title,
+            String content,
+            BoardStatus status,
+            Instant createdAt,
+            Instant updatedAt
+    ) {
+    }
+
+    public record BoardSummary(
+            Long id,
+            String title,
+            BoardStatus status,
+            Instant createdAt,
+            Instant updatedAt
+    ) {
+    }
+}

src/main/java/me/nettee/board/application/model/BoardReadDetailModel.java

@@ -2,6 +2,7 @@
 
 import java.util.Optional;
 import me.nettee.board.application.domain.Board;
+import me.nettee.board.application.domain.type.BoardStatus;
 
 public interface BoardCommandPort {
 
@@ -11,5 +12,5 @@ public interface BoardCommandPort {
 
     Board update(Board board);
 
-    void delete(Long id);
+    void updateStatus(Long id, BoardStatus status);
 }

src/main/java/me/nettee/board/application/model/BoardReadSummaryModel.java

@@ -1,19 +1,19 @@
 package me.nettee.board.application.port;
 
-
-import java.util.Optional;
-import java.util.Set;
 import me.nettee.board.application.domain.type.BoardStatus;
-import me.nettee.board.application.model.BoardReadDetailModel;
-import me.nettee.board.application.model.BoardReadSummaryModel;
+import me.nettee.board.application.model.BoardQueryModel.BoardDetail;
+import me.nettee.board.application.model.BoardQueryModel.BoardSummary;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
 
+import java.util.Optional;
+import java.util.Set;
+
 public interface BoardQueryPort {
 
-    Optional<BoardReadDetailModel> findById(Long id);
+    Optional<BoardDetail> findById(Long id);
 
-    Page<BoardReadDetailModel> findAll(Pageable pageable);
+    Page<BoardSummary> findAll(Pageable pageable);
 
-    Page<BoardReadSummaryModel> findByStatusesList(Pageable pageable, Set<BoardStatus> statuses);
+    Page<BoardSummary> findByStatusesList(Pageable pageable, Set<BoardStatus> statuses);
 }

src/main/java/me/nettee/board/application/port/BoardCommandPort.java

@@ -5,5 +5,4 @@
 public interface BoardCreateUseCase {
 
     Board createBoard(Board board);
-
 }

src/main/java/me/nettee/board/application/port/BoardQueryPort.java

@@ -3,5 +3,4 @@
 public interface BoardDeleteUseCase {
 
     void deleteBoard(Long id);
-
 }

src/main/java/me/nettee/board/application/usecase/BoardCreateUseCase.java

@@ -1,14 +1,14 @@
 package me.nettee.board.application.usecase;
 
-import java.util.Set;
 import me.nettee.board.application.domain.type.BoardStatus;
-import me.nettee.board.application.model.BoardReadSummaryModel;
+import me.nettee.board.application.model.BoardQueryModel.BoardSummary;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
 
-public interface BoardReadByStatusesUseCase {
+import java.util.Set;
 
-    Page<BoardReadSummaryModel> findByStatuses(Set<BoardStatus> statuses, Pageable pageable);
+public interface BoardReadByStatusesUseCase {
 
+    Page<BoardSummary> findByStatuses(Set<BoardStatus> statuses, Pageable pageable);
 }
 

src/main/java/me/nettee/board/application/usecase/BoardDeleteUseCase.java

@@ -1,9 +1,8 @@
 package me.nettee.board.application.usecase;
 
-import me.nettee.board.application.model.BoardReadDetailModel;
+import me.nettee.board.application.model.BoardQueryModel.BoardDetail;
 
 public interface BoardReadUseCase {
 
-   BoardReadDetailModel getBoard(Long id);
-
+    BoardDetail getBoard(Long id);
 }