Feat: 게시글 생성 API 구현 (#131)

[joyewon0705]

📌 개요

• 로그인한 사용자가 새로운 게시글을 작성할 수 있는 API를 구현했습니다.
• 컨트롤러, 서비스, DTO, 통합/서비스 테스트, Swagger 문서화를 포함합니다.

🔨 작업 내용

1. Controller

   • PostController 추가
   • POST /api/posts 엔드포인트 구현
   • 로그인 사용자(@AuthenticationPrincipal) 기반으로 게시글 생성

2. Service

   • PostService#createPost 구현
     • User 조회
     • Post 생성
     • 카테고리 매핑
     • 저장 및 PostResponse 반환

3. DTO

   • PostRequest : 게시글 생성/수정 요청 DTO
   • PostResponse : 게시글 응답 DTO
   • AuthorResponse : 작성자 응답 DTO
   • CategoryResponse : 카테고리 응답 DTO

4. Test

   • PostServiceTest
     • 정상 생성 (카테고리 포함)
     • 존재하지 않는 유저 → USER_NOT_FOUND
     • 존재하지 않는 카테고리 → CATEGORY_NOT_FOUND
   • PostControllerTest (MockMvc)
     • 생성 성공 → 201 Created
     • 존재하지 않는 사용자 → 404
     • 존재하지 않는 카테고리 → 404
     • 잘못된 요청 (필드 누락) → 400

5. Swagger 문서 (PostControllerDocs)

   • 게시글 생성 API 문서화
   • 성공/실패 케이스 예시(JSON) 포함
   • 인증 실패/유저 없음/카테고리 없음/잘못된 요청/서버 오류 등 에러 응답 예시 정의

🔗 관련 이슈

Closes #{이슈 번호}

📝 참고 사항

✅ 체크리스트

• [x ] 기능 동작 확인
• [x ] 테스트 코드 작성
• [x ] 문서/주석 추가 및 최신화