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

[N-yujeong]

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

• 게시글 목록 조회 API (GET /api/posts)
• 게시글 상세 조회 API (GET /api/posts/{postId})
• 게시글 작성 API (POST /api/posts)
• 게시글 수정 API (PATCH /api/posts/{postId})
• 게시글 삭제 API (DELETE /api/posts/{postId})
• 프로젝트 구조 구성 (Controller/Service 레이어 분리)
• [ x] 헬스체크 API 구현 (GET /health)
• 문자열 2개 반환 API 구현 (POST /string/repeat)
• 권장 추가 구현 반영 (선택)

2. 핵심 변경 사항

파일	변경 내용
PostController	게시글 CRUD 5개 엔드포인트 추가
PostService	목록(페이지네이션)/상세/작성/수정/삭제 비즈니스 로직 구현
Post	category, thumbnailImageUrl 필드 추가, create() / update() 팩토리·수정 메서드 추가
Category	카테고리 엔티티 및 CategoryRepository 신규 추가
ApiResponse	공통 응답 래퍼 (success, error, errors 포함)
GlobalExceptionHandler	PostNotFoundException, ForbiddenException, @Valid 검증 오류, 타입 불일치 등 전역 처리
SwaggerConfig	SpringDoc OpenAPI 설정 추가
DataInitializer	앱 시작 시 더미 유저 1명, 카테고리 3개 자동 생성
domain/string 패키지 이동	기존 루트 → domain/string 으로 이동 (도메인 패키지 구조 정리)

3. 실행 및 검증 결과

• 실패 케이스는 대표적으로 몇개만 스크린샷으로 첨부

게시글 목록 조회 성공

게시글 상세 조회 성공

게시글 상세 조회 실패

게시글 작성 성공

게시글 작성 실패

게시글 수정 성공

게시글 수정 실패

게시글 삭제 성공

게시글 삭제 실패

4. 완료 사항

1. 게시글 CRUD API 5종 구현 (목록/상세/작성/수정/삭제)
2. 공통 응답 포맷(ApiResponse) 및 전역 예외 처리(GlobalExceptionHandler) 추가
3. Swagger(SpringDoc OpenAPI) 연동 및 API 문서화
4. 카테고리 엔티티 추가 및 DataInitializer로 초기 데이터 자동 세팅
5. 도메인 패키지 구조 정리 (domain/string으로 이동)

5. 추가 사항

• 관련 이슈: closed [3주차] 남유/[feat] 게시글 도메인 API 구현 #95

제출 체크리스트

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

Reviewer 참고

[gusanans218]

전체적으로 구조가 잘 잡혀 있고 DTO 분리와 예외 처리, Swagger 적용까지 깔끔하게 구현되어 있어서 보기 좋았습니다!!
코드 가독성과 완성도 모두 좋은 것 같습니다 👍