[feat] 게시판 도메인 구현 (게시글·댓글·멘션·검색)

.github/workflows/ci.yml

@@ -2,7 +2,10 @@ name: CI
 
 on:
   pull_request:
-    branches: [main]
+    branches: [main, develop]
+
+permissions:
+  contents: read
 
 jobs:
   test:

README.md

@@ -156,8 +156,9 @@ open -a Docker && docker start redis   # Docker 데몬이 꺼져 있으면 먼
   <img src=".github/deploy-architecture.png" alt="배포 아키텍처" width="800" />
 </p>
 
-- **CI** (`ci.yml`): PR 생성 시 PostgreSQL·Redis 컨테이너를 띄워 전체 테스트 실행 + Docker 이미지 빌드 검증
-- **CD** (`cd.yml`): `main` 브랜치 push 시 Docker 이미지를 GHCR에 push하고, Lightsail 인스턴스로 SSH 접속해 `scripts/deploy.sh` 실행
+- 작업 브랜치 → `develop` PR/병합 → (여러 작업 누적 후) `develop` → `main` PR/병합 순으로 운영 서버에 배포됩니다.
+- **CI** (`ci.yml`): `main`/`develop`으로의 PR 생성 시 PostgreSQL·Redis 컨테이너를 띄워 전체 테스트 실행 + Docker 이미지 빌드 검증
+- **CD** (`cd.yml`): `main` 브랜치 push(= `develop` → `main` 병합) 시 Docker 이미지를 GHCR에 push하고, Lightsail 인스턴스로 SSH 접속해 `scripts/deploy.sh` 실행
 - Nginx가 `be-blue`(:8080)/`be-green`(:8081) 중 활성 슬롯으로만 트래픽을 전달하고, Redis는 두 슬롯이 공유합니다. Data Pipeline(`data`)도 같은 Docker Compose에 포함되어 별도 인스턴스 없이 함께 배포됩니다.
 - 배포 시 standby 슬롯에 새 이미지를 pull → `/actuator/health` 체크 통과 → Nginx upstream 전환 → 이전 슬롯 정지 순으로 무중단 배포합니다.
 - DB는 별도 Lightsail 인스턴스(Managed PostgreSQL)로 분리되어 두 슬롯이 공통으로 바라보고, 4xx/5xx 에러·공연 데이터 수집 결과·문의 접수는 각각 Discord Webhook으로 알림됩니다.

build.gradle

@@ -40,6 +40,7 @@ dependencies {
 	runtimeOnly 'io.jsonwebtoken:jjwt-jackson:0.12.6'
 	annotationProcessor 'org.projectlombok:lombok'
 	testImplementation 'org.springframework.boot:spring-boot-starter-test'
+	testImplementation 'org.springframework.boot:spring-boot-starter-data-jpa-test'
 	testImplementation 'org.springframework.security:spring-security-test'
 	testCompileOnly 'org.projectlombok:lombok'
 	testRuntimeOnly 'org.junit.platform:junit-platform-launcher'

src/main/java/com/Coming/Backend/common/config/SecurityConfig.java

@@ -118,7 +118,10 @@ public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
                                     "/api/artists/**",
                                     "/api/concerts/**",
                                     "/api/releases/**",
-                                    "/api/calendar"
+                                    "/api/calendar",
+                                    "/api/mentions/search",
+                                    "/api/posts/**",
+                                    "/api/search"
                             ).permitAll()
                             .requestMatchers("/api/admin/**").hasRole("ADMIN")
                             .requestMatchers("/api/auth/register").hasRole("PENDING")

src/main/java/com/Coming/Backend/common/exception/ErrorCode.java

@@ -49,6 +49,18 @@ public enum ErrorCode {
     INVALID_INQUIRY_STATUS(HttpStatus.BAD_REQUEST, "변경 불가능한 문의 상태입니다."),
     TARGET_NOT_FOUND(HttpStatus.NOT_FOUND, "존재하지 않는 대상입니다."),
 
+    // Post
+    POST_NOT_FOUND(HttpStatus.NOT_FOUND, "존재하지 않는 게시글입니다."),
+    ALREADY_RECOMMENDED(HttpStatus.CONFLICT, "이미 추천한 게시글입니다."),
+    NOT_RECOMMENDED(HttpStatus.BAD_REQUEST, "추천하지 않은 게시글입니다."),
+    POST_CONTENT_TOO_LONG(HttpStatus.BAD_REQUEST, "본문은 10000자를 초과할 수 없습니다."),
+
+    // Comment
+    COMMENT_NOT_FOUND(HttpStatus.NOT_FOUND, "존재하지 않는 댓글입니다."),
+    INVALID_REPLY_DEPTH(HttpStatus.BAD_REQUEST, "답글에는 답글을 작성할 수 없습니다."),
+    ALREADY_LIKED(HttpStatus.CONFLICT, "이미 좋아요한 댓글입니다."),
+    NOT_LIKED(HttpStatus.BAD_REQUEST, "좋아요하지 않은 댓글입니다."),
+
     // Pipeline
     PIPELINE_NOT_FOUND(HttpStatus.NOT_FOUND, "Data 파이프라인에서 해당 리소스를 찾을 수 없습니다."),
     PIPELINE_CONFLICT(HttpStatus.CONFLICT, "이미 처리 중인 수집 요청입니다. 잠시 후 다시 확인해주세요."),

src/main/java/com/Coming/Backend/concert/repository/ConcertRepository.java

@@ -35,6 +35,9 @@ public interface ConcertRepository extends JpaRepository<Concert, Long> {
     @Query("UPDATE Concert c SET c.viewCount = c.viewCount + 1 WHERE c.id = :id")
     void incrementViewCount(@Param("id") Long id);
 
+    @Query("SELECT c FROM Concert c WHERE c.status NOT IN :hidden AND LOWER(c.title) LIKE :q ORDER BY c.startDate DESC")
+    List<Concert> searchByTitleForMention(@Param("hidden") Collection<ConcertStatus> hidden, @Param("q") String q, Pageable pageable);
+
     @Query("SELECT c FROM Concert c WHERE c.startDate <= :lastDay AND c.endDate >= :firstDay AND c.status NOT IN :hidden ORDER BY c.startDate ASC")
     List<Concert> findByDateRange(@Param("firstDay") LocalDate firstDay, @Param("lastDay") LocalDate lastDay, @Param("hidden") Collection<ConcertStatus> hidden);
 

src/main/java/com/Coming/Backend/post/controller/CommentController.java

@@ -0,0 +1,55 @@
+package com.Coming.Backend.post.controller;
+
+import com.Coming.Backend.post.dto.CommentLikeCountResponse;
+import com.Coming.Backend.post.service.CommentService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@Tag(name = "Comment")
+@RestController
+@RequestMapping("/api/comments")
+@RequiredArgsConstructor
+public class CommentController {
+
+    private final CommentService commentService;
+
+    @Operation(summary = "댓글 삭제")
+    @ApiResponse(responseCode = "403", description = "FORBIDDEN (작성자 본인 아님)")
+    @ApiResponse(responseCode = "404", description = "COMMENT_NOT_FOUND")
+    @DeleteMapping("/{commentId}")
+    public ResponseEntity<Void> delete(
+            @AuthenticationPrincipal Long userId,
+            @PathVariable Long commentId) {
+        commentService.delete(userId, commentId);
+        return ResponseEntity.ok().build();
+    }
+
+    @Operation(summary = "댓글 좋아요")
+    @ApiResponse(responseCode = "404", description = "COMMENT_NOT_FOUND")
+    @ApiResponse(responseCode = "409", description = "ALREADY_LIKED")
+    @PostMapping("/{commentId}/like")
+    public ResponseEntity<CommentLikeCountResponse> like(
+            @AuthenticationPrincipal Long userId,
+            @PathVariable Long commentId) {
+        return ResponseEntity.ok(commentService.like(userId, commentId));
+    }
+
+    @Operation(summary = "댓글 좋아요 취소")
+    @ApiResponse(responseCode = "400", description = "NOT_LIKED")
+    @ApiResponse(responseCode = "404", description = "COMMENT_NOT_FOUND")
+    @DeleteMapping("/{commentId}/like")
+    public ResponseEntity<CommentLikeCountResponse> unlike(
+            @AuthenticationPrincipal Long userId,
+            @PathVariable Long commentId) {
+        return ResponseEntity.ok(commentService.unlike(userId, commentId));
+    }
+}

src/main/java/com/Coming/Backend/post/controller/EntityPostController.java

@@ -0,0 +1,41 @@
+package com.Coming.Backend.post.controller;
+
+import com.Coming.Backend.common.response.PageResponse;
+import com.Coming.Backend.post.dto.PostSummaryResponse;
+import com.Coming.Backend.post.entity.EntityType;
+import com.Coming.Backend.post.service.PostService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@Tag(name = "Post")
+@Validated
+@RestController
+@RequestMapping("/api/entities")
+@RequiredArgsConstructor
+public class EntityPostController {
+
+    private final PostService postService;
+
+    @Operation(summary = "엔티티별 게시글 백링크 조회")
+    @ApiResponse(responseCode = "400", description = "INVALID_INPUT (허용되지 않은 sort 값)")
+    @GetMapping("/{type}/{id}/posts")
+    public ResponseEntity<PageResponse<PostSummaryResponse>> getBacklinks(
+            @PathVariable EntityType type,
+            @PathVariable Long id,
+            @RequestParam(defaultValue = "latest") String sort,
+            @RequestParam(defaultValue = "0") @Min(0) int page,
+            @RequestParam(defaultValue = "20") @Min(1) @Max(100) int size) {
+        return ResponseEntity.ok(postService.getBacklinks(type, id, sort, page, size));
+    }
+}

src/main/java/com/Coming/Backend/post/controller/MentionController.java

@@ -0,0 +1,40 @@
+package com.Coming.Backend.post.controller;
+
+import com.Coming.Backend.post.dto.EntityCardResponse;
+import com.Coming.Backend.post.entity.EntityType;
+import com.Coming.Backend.post.service.MentionService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+@Tag(name = "Post")
+@Validated
+@RestController
+@RequestMapping("/api/mentions")
+@RequiredArgsConstructor
+public class MentionController {
+
+    private final MentionService mentionService;
+
+    @Operation(summary = "엔티티 검색 (게시글 본문 멘션 자동완성)")
+    @ApiResponse(responseCode = "400", description = "INVALID_INPUT (q 공백 또는 limit 범위 초과)")
+    @GetMapping("/search")
+    public ResponseEntity<List<EntityCardResponse>> search(
+            @RequestParam EntityType type,
+            @RequestParam @NotBlank String q,
+            @RequestParam(defaultValue = "10") @Min(1) @Max(20) int limit) {
+        return ResponseEntity.ok(mentionService.search(type, q, limit));
+    }
+}

src/main/java/com/Coming/Backend/post/controller/PostCommentController.java

@@ -0,0 +1,57 @@
+package com.Coming.Backend.post.controller;
+
+import com.Coming.Backend.common.response.PageResponse;
+import com.Coming.Backend.post.dto.CommentCreateRequest;
+import com.Coming.Backend.post.dto.CommentCreateResponse;
+import com.Coming.Backend.post.dto.CommentResponse;
+import com.Coming.Backend.post.service.CommentService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@Tag(name = "Comment")
+@Validated
+@RestController
+@RequestMapping("/api/posts/{postId}/comments")
+@RequiredArgsConstructor
+public class PostCommentController {
+
+    private final CommentService commentService;
+
+    @Operation(summary = "게시글 댓글·답글 목록 조회")
+    @ApiResponse(responseCode = "404", description = "POST_NOT_FOUND")
+    @GetMapping
+    public ResponseEntity<PageResponse<CommentResponse>> getComments(
+            @PathVariable Long postId,
+            @AuthenticationPrincipal Long userId,
+            @RequestParam(defaultValue = "0") @Min(0) int page,
+            @RequestParam(defaultValue = "20") @Min(1) @Max(100) int size) {
+        return ResponseEntity.ok(commentService.getComments(postId, userId, page, size));
+    }
+
+    @Operation(summary = "댓글 또는 답글 작성")
+    @ApiResponse(responseCode = "400", description = "INVALID_REPLY_DEPTH")
+    @ApiResponse(responseCode = "404", description = "POST_NOT_FOUND | COMMENT_NOT_FOUND")
+    @PostMapping
+    public ResponseEntity<CommentCreateResponse> create(
+            @PathVariable Long postId,
+            @AuthenticationPrincipal Long userId,
+            @Valid @RequestBody CommentCreateRequest request) {
+        return ResponseEntity.status(HttpStatus.CREATED).body(commentService.create(userId, postId, request));
+    }
+}

src/main/java/com/Coming/Backend/post/controller/PostController.java

@@ -0,0 +1,129 @@
+package com.Coming.Backend.post.controller;
+
+import com.Coming.Backend.common.response.PageResponse;
+import com.Coming.Backend.post.dto.PostCreateRequest;
+import com.Coming.Backend.post.dto.PostCreateResponse;
+import com.Coming.Backend.post.dto.PostDetailResponse;
+import com.Coming.Backend.post.dto.PostSummaryResponse;
+import com.Coming.Backend.post.dto.PostUpdateRequest;
+import com.Coming.Backend.post.dto.RecommendCountResponse;
+import com.Coming.Backend.post.dto.TrendingTagResponse;
+import com.Coming.Backend.post.entity.PostCategory;
+import com.Coming.Backend.post.service.PostService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+@Tag(name = "Post")
+@Validated
+@RestController
+@RequestMapping("/api/posts")
+@RequiredArgsConstructor
+public class PostController {
+
+    private final PostService postService;
+
+    @Operation(summary = "게시글 작성")
+    @PostMapping
+    public ResponseEntity<PostCreateResponse> create(
+            @AuthenticationPrincipal Long userId,
+            @Valid @RequestBody PostCreateRequest request) {
+        return ResponseEntity.status(HttpStatus.CREATED).body(postService.create(userId, request));
+    }
+
+    @Operation(summary = "게시글 상세 조회")
+    @ApiResponse(responseCode = "404", description = "POST_NOT_FOUND")
+    @GetMapping("/{id}")
+    public ResponseEntity<PostDetailResponse> getDetail(
+            @PathVariable Long id,
+            @AuthenticationPrincipal Long userId) {
+        return ResponseEntity.ok(postService.getDetail(id, userId));
+    }
+
+    @Operation(summary = "게시글 목록 조회")
+    @GetMapping
+    public ResponseEntity<PageResponse<PostSummaryResponse>> getList(
+            @RequestParam(required = false) PostCategory category,
+            @RequestParam(defaultValue = "0") @Min(0) int page,
+            @RequestParam(defaultValue = "20") @Min(1) @Max(100) int size) {
+        return ResponseEntity.ok(postService.getList(category, page, size));
+    }
+
+    @Operation(summary = "이번 주 인기 게시글 조회")
+    @GetMapping("/popular")
+    public ResponseEntity<List<PostSummaryResponse>> getPopular(
+            @RequestParam(defaultValue = "7") @Min(1) int days,
+            @RequestParam(defaultValue = "5") @Min(1) @Max(100) int limit) {
+        return ResponseEntity.ok(postService.getPopular(days, limit));
+    }
+
+    @Operation(summary = "최근 많이 언급된 태그 조회")
+    @GetMapping("/trending-tags")
+    public ResponseEntity<List<TrendingTagResponse>> getTrendingTags(
+            @RequestParam(defaultValue = "7") @Min(1) int days,
+            @RequestParam(defaultValue = "10") @Min(1) @Max(100) int limit) {
+        return ResponseEntity.ok(postService.getTrendingTags(days, limit));
+    }
+
+    @Operation(summary = "게시글 수정")
+    @ApiResponse(responseCode = "403", description = "FORBIDDEN (작성자 본인 아님)")
+    @ApiResponse(responseCode = "404", description = "POST_NOT_FOUND")
+    @PatchMapping("/{id}")
+    public ResponseEntity<Void> update(
+            @AuthenticationPrincipal Long userId,
+            @PathVariable Long id,
+            @Valid @RequestBody PostUpdateRequest request) {
+        postService.update(userId, id, request);
+        return ResponseEntity.ok().build();
+    }
+
+    @Operation(summary = "게시글 삭제")
+    @ApiResponse(responseCode = "403", description = "FORBIDDEN (작성자 본인 아님)")
+    @ApiResponse(responseCode = "404", description = "POST_NOT_FOUND")
+    @DeleteMapping("/{id}")
+    public ResponseEntity<Void> delete(
+            @AuthenticationPrincipal Long userId,
+            @PathVariable Long id) {
+        postService.delete(userId, id);
+        return ResponseEntity.ok().build();
+    }
+
+    @Operation(summary = "게시글 추천")
+    @ApiResponse(responseCode = "404", description = "POST_NOT_FOUND")
+    @ApiResponse(responseCode = "409", description = "ALREADY_RECOMMENDED")
+    @PostMapping("/{id}/recommend")
+    public ResponseEntity<RecommendCountResponse> recommend(
+            @AuthenticationPrincipal Long userId,
+            @PathVariable Long id) {
+        return ResponseEntity.ok(postService.recommend(userId, id));
+    }
+
+    @Operation(summary = "게시글 추천 취소")
+    @ApiResponse(responseCode = "400", description = "NOT_RECOMMENDED")
+    @ApiResponse(responseCode = "404", description = "POST_NOT_FOUND")
+    @DeleteMapping("/{id}/recommend")
+    public ResponseEntity<RecommendCountResponse> unrecommend(
+            @AuthenticationPrincipal Long userId,
+            @PathVariable Long id) {
+        return ResponseEntity.ok(postService.unrecommend(userId, id));
+    }
+}