[3주차] 이예서/[feat] 게시글 API 구현

[HandoA01]

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

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

2. 핵심 변경 사항

• ApiResponse 공통 응답 포맷 적용 (isSuccess, code, message, result)
• ErrorCode enum으로 에러 코드 일원화 관리
• GlobalExceptionHandler에 게시글 관련 예외 처리 추가
• PostConverter를 통한 Entity ↔ DTO 변환 책임 분리
• BaseEntity의 delete() 메서드를 활용한 soft delete 구현
• Request DTO에 @NotBlank, @NotNull, @Size 등 Bean Validation 적용
• Controller에서 @Valid로 요청 데이터 검증 활성화

3. 실행 및 검증 결과

• 프로젝트 정상 실행 확인

4. 완료 사항

• 게시글 목록 조회 API 구현
• 게시글 상세 조회 API 구현
• 게시글 작성 API 구현
• 게시글 수정 API 구현
• 게시글 삭제 API (soft delete) 구현
• 공통 응답 포맷 ApiResponse 적용
• 전역 예외 처리 GlobalExceptionHandler 적용
• Entity와 DTO 분리 및 PostConverter 적용
• Bean Validation + @Valid 적용
• 404, 403, 400, 500 예외 처리 구현

5. 추가 사항

• 관련 이슈: closes [3주차] 이예서/[feat] 게시글 도메인 API 구현 #94

제출 체크리스트

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

Reviewer 참고

[kdobi]

전반적으로 코드가 깔끔해서 읽기 되게 좋은 것 같습니다!
예외처리도 글로벌에서 세분화해서 처리한 것도 좋아보이네요.

[kallin1]

현재는 Request DTO 안에 userId가 포함되어 있는데, 나중에 Spring Security 등을 도입하게 된다면 컨트롤러에서 인증된 유저 정보를 서비스에 인자로 넘겨주는 방식이 더 안전할 수 있어 이러한 방향도 고민해 보면 좋을 것 같습니다!

[HyeonSeongIM]

Service를 Intetface로 구성하고 ServiceImpl로 구현 클래스를 따로 두는 방식도 좋은 유지보수 코드가 될 것 같아요!

[HyeonSeongIM]

각 에러별로 코드랑 주석처리 하신게 너무 좋습니다!