[3주차] 김지훈/[feat] 게시글 도메인 API 구현

[jihoonkim501]

1. 과제 요구사항 중 구현한 내용

• 게시글 목록 조회 API (GET /api/posts)
• 게시글 상세 조회 API (GET /api/posts/{postId})
• 게시글 작성 API (POST /api/posts)
• 게시글 수정 API (PATCH /api/posts/{postId})
• 게시글 삭제 API (DELETE /api/posts/{postId})

2. 핵심 변경 사항

게시글 관련 api 5개를 구현하였습니다.
서비스단에서 단일책임원칙을 지키기 위해 PostValidator로 분기하여 책임을 줄였고, 블로그 성격을 띄는 과제라 페이징은 Cursor가 아닌 offset 페이지네이션을 구현하였습니다. 추가적으로 page값을 0으로 설정하는것을 방지하기 위하여 validation 과 매직넘버를 추가하여 추후 프론트와 협업시에 page 값 불일치가 일어나지않도록 구성하였습니다. N+1 문제를 방지하기 위해 EntityGraph를 추가하였습니다.

3. 실행 및 검증 결과

• 게시글 목록 조회 Request

• 게시글 목록 조회 Response

• 게시글 상세 조회 Request

• 게시글 상세 조회 Response

• 게시글 수정 Request

• 게시글 수정 Response

• 게시글 생성 Request

• 게시글 생성 Response

• 게시글 삭제 Request

• 게시글 삭제 Response

• 실행 결과:
• GET /health 응답: O
• POST /string/repeat 요청/응답: O

5. 추가 사항

• 관련 이슈: closed [3주차] 김지훈/[feat] 게시글 도메인 API 구현 #93

제출 체크리스트

• PR 제목이 규칙에 맞다
• base가 {이름}/main 브랜치다
• compare가 {이름}/{숫자}주차 브랜치다
• 프로젝트가 정상 실행된다
• 본인을 Assignee로 지정했다
• 파트 담당 Reviewer를 지정했다
• 리뷰 피드백을 반영한 뒤 머지/PR close를 진행한다

Reviewer 참고

지금은 인증/인가 설정을 해두지않아서 userId 값을 직접 받아오는데 추후에 유저인증정보값으로 수정할 예정입니다. 마지막으로 S3설정을 해두지않아서 추후에 추가할 예정입니다.

[gusanans218]

전체적으로 Command/Query 서비스 분리, Validator 도입 등 역할을 명확하게 나눈 구조가 인상적이었습니다!!
DTO 분리와 응답 구조, 상태 코드 관리까지 일관성 있게 설계되어 있어서 코드 흐름이 잘 읽히네요 👍👍