[3주차] 송유경/[feat] 게시글 도메인 API 구현

[yukyoungs]

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

• 프로젝트 구조 구성 (Controller/Service/Domain/DTO 레이어 분리)
• 게시글 생성, 단건 조회, 전체 조회, 수정, 삭제 API 구현
• BaseTimeEntity를 활용한 생성/수정 시간 자동 기록
• BaseResponse를 활용한 공통 응답 규격 적용 (timestamp, message, data 구조)
• Swagger UI 연동 및 API 문서화 완료
• Global Exception Handler를 통한 예외 처리 기반 마련

2. 핵심 변경 사항

• BaseResponse 도입: 모든 API 응답을 일정한 규격으로 반환하도록 공통 DTO 설계
• JPA Auditing 설정: JpaConfig 분리 및 BaseTimeEntity 상속을 통해 createdAt, updatedAt 자동화
• Controller 레이어 최적화: @PathVariable 명시 및 @RestControllerAdvice를 활용한 예외 처리 구조 잡기
• Swagger UI 설정: 최신 Spring Boot 버전과의 호환성 문제를 해결하기 위해 의존성 및 설정 최적화

3. 실행 및 검증 결과

• 실행 결과: Swagger UI(localhost:8080/swagger-ui/index.html) 정상 접속 및 테스트 완료
• 게시글 생성 (POST): 데이터 생성 시 BaseResponse에 담겨 응답하며 createdAt 값이 정상적으로 출력됨
• 단건 조회 (GET): {id} 경로 변수를 통해 특정 게시글 조회 기능 확인

4. 완료 사항

1. 게시판 도메인(Post) 엔티티 설계 및 JPA 연동 완료
2. 서비스 레이어 로직 구현 (조회 시 예외 발생 처리 포함)
3. BaseResponse 클래스 생성을 통한 API 응답 표준화
4. Swagger UI를 통한 API 문서 자동화 및 테스트 환경 구축

5. 추가 사항

• 관련 이슈: closed [3주차] 송유경/[feat] 게시글 API 구현 #106

제출 체크리스트

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

Reviewer 참고