Merge pull request(피드 기능 배포)

.github/workflows/dev-server-cicd.yml

@@ -8,6 +8,13 @@ on:
 jobs:
   backend-CI:
     runs-on: ubuntu-latest
+
+    # Testcontainers가 CI 환경에서 Docker를 잘 찾도록 환경 변수 추가
+    env:
+      TESTCONTAINERS_RYUK_DISABLED: true
+      TESTCONTAINERS_CHECKS_DISABLE: true
+      DOCKER_HOST: unix:///var/run/docker.sock
+
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -28,6 +35,17 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-gradle-
 
+      # [핵심 2] Docker 소켓 권한 부여 & 상태 확인
+      # 이 스텝이 실패하면 아예 Runner 문제임
+      - name: Check Docker & Grant Permissions
+        run: |
+          echo "Granting permissions to docker socket..."
+          sudo chmod 666 /var/run/docker.sock
+
+          echo "Checking Docker info..."
+          docker info
+        shell: bash
+
       - name: Configure AWS credentials
         if: ${{ github.ref == 'refs/heads/develop'}}
         uses: aws-actions/configure-aws-credentials@v4
@@ -51,10 +69,11 @@ jobs:
         shell: bash
 
       # 3. 모든 설정이 끝난 후 빌드 실행
+      # 권한 부여 및 --no-daemon 옵션 추가 (메모리 절약)
       - name: Build Gradle
         run: |
           chmod +x gradlew
-          ./gradlew build -Dspring.profiles.active=dev-docs
+               ./gradlew clean build -Dspring.profiles.active=dev-docs --no-daemon
         shell: bash
 
       - name: Build and push image to Amazon ECR

build.gradle

@@ -7,7 +7,7 @@ plugins {
 }
 
 group = 'com.project200'
-version = '0.11.0-SNAPSHOT'
+version = '0.12.2-SNAPSHOT'
 
 java {
     toolchain {
@@ -119,6 +119,8 @@ tasks.named('test') {
     useJUnitPlatform()
 //    systemProperty("spring.profiles.active", System.getProperty("spring.profiles.active", "local"))
     jvmArgs("-javaagent:${configurations.mockitoAgent.asPath}")
+
+    maxHeapSize = '4g'
 }
 
 tasks.named('asciidoctor') {
@@ -139,6 +141,14 @@ tasks.named('asciidoctor') {
     attributes([
             'snippets': snippetsDir
     ])
+
+    forkOptions {
+        jvmArgs(
+                '-Xmx2g', // 최대 힙 메모리 2GB 설정
+                '--add-opens', 'java.base/sun.nio.ch=ALL-UNNAMED',
+                '--add-opens', 'java.base/java.io=ALL-UNNAMED'
+        )
+    }
 }
 
 // 생성된 문서를 JAR에 포함시키기

deploy-dev/docker-compose.yml

@@ -10,11 +10,11 @@ services:
     networks:
       - dev-server-network
     environment:
-      # 개발 서버용 초경량 메모리 설정
-      # Xms128m: 시작할 때 128MB로 시작
-      # Xmx256m: 최대 256MB까지만 사용
-      # -XX:+UseSerialGC: 코어가 적은 CPU에서 효율적
       - JAVA_OPTS=-Xms128m -Xmx256m -XX:+UseSerialGC
+    deploy:
+      resources:
+        limits:
+          memory: 400M
 
 networks:
   dev-server-network:

deploy-prod/docker-compose.yml

@@ -13,6 +13,17 @@ services:
       interval: 10s
       timeout: 5s
       retries: 5
+    # 운영 서버는 스왑메모리 영역에 최대한 가지 않도록 설정
+
+    environment:
+      - JAVA_TOOL_OPTIONS=-Xms400m -Xmx500m -XX:MaxMetaspaceSize=128m
+
+    deploy:
+      resources:
+        limits:
+          memory: 600M
+        reservations:
+          memory: 512M
 
 networks:
   server-network:

deploy-prod/scripts/config.sh

@@ -20,8 +20,5 @@ export ACTIVE_APP_CONF=sudo sed -i 's|export ACTIVE_APP_CONF="active_app.conf"|e
  # Nginx가 include할 활성 앱 upstream 설정 파일 이름
 
 # 헬스 체크 설정
-export MAX_HEALTH_RETRIES=20       # 30초 * 20 회
-export HEALTH_CHECK_INTERVAL=30
-
-# 초기 구동 대기 시간
-export INITIAL_WAIT_TIME=90 # 90초 동안 대기
+export MAX_HEALTH_RETRIES=30 # 최대 재시도 횟수
+export HEALTH_CHECK_INTERVAL=10 # 헬스 체크 간격 (초)

deploy-prod/scripts/start_sub_container.sh

@@ -16,8 +16,8 @@ export MAIN_PORT SUB_PORT ECR_REGISTRY ECR_REPOSITORY IMAGE_TAG # docker-compose
 docker-compose -f docker-compose-sub.yml up -d server-prod-sub
 
 # 간단한 시작 확인 (본격적인 헬스체크는 Validate Service에서 수행)
-echo "Waiting for server-prod-sub to initialize ($INITIAL_WAIT_TIME seconds)..."
-sleep "$INITIAL_WAIT_TIME"  # config.sh에서 설정한 60초 대기# 컨테이너가 완전히 시작될 시간을 줍니다. 애플리케이션 시작 시간에 따라 조절.
+echo "Waiting briefly for server-prod-sub to initialize..."
+sleep 15 # 컨테이너가 완전히 시작될 시간을 줍니다. 애플리케이션 시작 시간에 따라 조절.
 
 if ! docker ps | grep -q "server-prod-sub"; then
     echo "ERROR: server-prod-sub container failed to start!"

deploy-prod/scripts/validate_and_switch.sh

@@ -32,8 +32,8 @@ clean_specific_containers "server-prod"
 echo "Starting new version of server-prod on MAIN_PORT ($MAIN_PORT)..."
 docker-compose -f docker-compose.yml up -d server-prod
 
-echo "Waiting for server-prod-sub to initialize ($INITIAL_WAIT_TIME seconds)..."
-sleep "$INITIAL_WAIT_TIME"  # config.sh에서 설정한 60초 대기 # 애플리케이션 시작 시간에 따라 조절
+echo "Waiting briefly for server-prod to initialize..."
+sleep 15 # 애플리케이션 시작 시간에 따라 조절
 
 if ! docker ps | grep -q "server-prod"; then
     echo "ERROR: server-prod container failed to start!"

documents/Undabang SQL/Undabang Database DDL.sql

@@ -25,6 +25,7 @@ DROP TABLE IF EXISTS notification_types;
 DROP TABLE IF EXISTS fcm_tokens;
 
 DROP TABLE IF EXISTS comment_likes;
+DROP TABLE IF EXISTS comment_tags;
 DROP TABLE IF EXISTS comments;
 DROP TABLE IF EXISTS feed_likes;
 DROP TABLE IF EXISTS feed_pictures;
@@ -613,7 +614,7 @@ CREATE TABLE feeds
 (
     feed_id           BIGINT   NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT '피드 식별자',
     member_id         CHAR(36) NOT NULL COMMENT 'UUID_SELF',
-    feed_type_id      BIGINT   NOT NULL,
+    feed_type_id BIGINT NULL,
     feed_content      TEXT     NOT NULL,
     feed_likes_cnt    INTEGER  NOT NULL DEFAULT 0,
     feed_comments_cnt INTEGER  NOT NULL DEFAULT 0,
@@ -660,6 +661,17 @@ CREATE TABLE comments
     CONSTRAINT FK_comments_feed FOREIGN KEY (feed_id) REFERENCES feeds (feed_id)
 );
 
+CREATE TABLE comment_tags
+(
+    comment_tag_id         BIGINT   NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT '댓글 태그 식별자',
+    comment_id             BIGINT   NOT NULL,
+    tagged_member_id       CHAR(36) NOT NULL COMMENT '태그된 회원 UUID',
+    comment_tag_created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT FK_comment_tags_comment FOREIGN KEY (comment_id) REFERENCES comments (comment_id),
+    CONSTRAINT FK_comment_tags_member FOREIGN KEY (tagged_member_id) REFERENCES members (member_id)
+);
+
 CREATE TABLE comment_likes
 (
     comment_like_id         BIGINT   NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT '피드 댓글 좋아요 식별자',

documents/Undabang SQL/Undabang Database DML.sql

@@ -1,6 +1,3 @@
-INSERT INTO post_type (post_type_name, post_type_desc)
-VALUES ('오운완 게시판', '오늘의 운동한 모습이나 결과를 자랑하는 게시판입니다');
-
 INSERT INTO comment_report_subjects (comment_report_subject_name)
 VALUES ('스팸홍보/도배입니다.'),
        ('음란물입니다.'),
@@ -221,11 +218,65 @@ VALUES ('레슬링', 'https://undabang-public-assets.s3.ap-northeast-2.amazonaws
        ('미식축구',
         'https://undabang-public-assets.s3.ap-northeast-2.amazonaws.com/images/exercises/American_football.png');
 
-INSERT INTO policies (policy_key, policy_value, policy_unit, policy_description)
+INSERT INTO policies (policy_id, policy_key, policy_value, policy_unit, policy_description)
 VALUES (21, 'PREFERRED_EXERCISE_MAX_COUNT', '5', 'COUNT', '선호 운동 최대 보유 갯수');
 
 INSERT INTO policies (policy_id, policy_key, policy_value, policy_unit, policy_description)
 VALUES (22, 'EXERCISE_LOCATION_MAX_DISTANCE_METER', '5000', 'METERS', '현재 사용자와 운동장소간의 허용 가능한 최대 거리');
 
 INSERT INTO policy_group_mappings (policy_id, policy_groups_id)
-VALUES (22, 5);
+VALUES (22, 5);
+
+INSERT INTO feed_types (feed_type_name, feed_type_desc, feed_type_is_active)
+VALUES
+('레슬링 다방', '레슬링 기술과 훈련 과정, 실전 경험을 공유하는 피드입니다.', 1),
+('수구 다방', '수구 경기와 수중 훈련 노하우를 나누는 피드입니다.', 1),
+('배구 다방', '배구 경기 후기와 팀 플레이 이야기를 나누는 피드입니다.', 1),
+('테니스 다방', '테니스 플레이와 연습 팁, 레슨 정보를 공유하는 피드입니다.', 1),
+('태권도 다방', '태권도 수련 과정과 품새, 겨루기 경험을 나누는 피드입니다.', 1),
+('탁구 다방', '탁구 경기 결과와 연습 영상을 공유하는 피드입니다.', 1),
+('스쿼시 다방', '스쿼시 플레이와 체력 훈련을 기록하는 피드입니다.', 1),
+('축구 다방', '축구 경기와 전술, 팀 활동을 자유롭게 소통하는 피드입니다.', 1),
+('스키 다방', '스키 시즌 이야기와 슬로프 후기를 공유하는 피드입니다.', 1),
+('런닝 다방', '러닝 기록과 코스, 목표 달성을 공유하는 피드입니다.', 1),
+('럭비 다방', '럭비 경기와 강도 높은 훈련 경험을 나누는 피드입니다.', 1),
+('조정 다방', '조정 운동과 수상 훈련 기록을 공유하는 피드입니다.', 1),
+('파워 리프팅 다방', '파워 리프팅 중량 기록과 훈련 루틴을 공유하는 피드입니다.', 1),
+('필라테스 다방', '필라테스 동작과 자세 교정 경험을 기록하는 피드입니다.', 1),
+('마라톤 다방', '마라톤 도전 과정과 대회 준비 이야기를 나누는 피드입니다.', 1),
+('핸드볼 다방', '핸드볼 경기와 팀 훈련 소식을 공유하는 피드입니다.', 1),
+('골프 다방', '골프 라운딩 후기와 연습 경험을 나누는 피드입니다.', 1),
+('게이트볼 다방', '게이트볼을 즐기는 사람들의 소통 공간입니다.', 1),
+('풋살 다방', '풋살 경기와 팀 활동을 공유하는 피드입니다.', 1),
+('헬스 다방', '헬스와 웨이트 트레이닝 기록을 공유하는 피드입니다.', 1),
+('낚시 다방', '낚시 기록과 조과, 포인트 정보를 나누는 피드입니다.', 1),
+('펜싱 다방', '펜싱 훈련과 경기 경험을 공유하는 피드입니다.', 1),
+('컬링 다방', '컬링 경기와 전략, 팀워크를 나누는 피드입니다.', 1),
+('크로스핏 다방', '고강도 크로스핏 운동 기록을 공유하는 피드입니다.', 1),
+('크리켓 다방', '크리켓 경기를 즐기는 사람들의 피드입니다.', 1),
+('복싱 다방', '복싱 훈련과 스파링 경험을 나누는 피드입니다.', 1),
+('볼링 다방', '볼링 점수와 플레이 경험을 공유하는 피드입니다.', 1),
+('자전거 다방', '라이딩 코스와 자전거 운동 기록을 공유하는 피드입니다.', 1),
+('농구 다방', '농구 경기와 플레이 이야기를 나누는 피드입니다.', 1),
+('야구 다방', '야구 경기와 사회인 야구 활동을 공유하는 피드입니다.', 1),
+('배드민턴 다방', '배드민턴을 즐기는 사람들의 소통 피드입니다.', 1),
+('미식축구 다방', '미식축구 경기와 전술 이야기를 나누는 피드입니다.', 1);
+
+
+-- 피드 좋아요 인덱스 : (피드ID + 회원ID)
+CREATE INDEX idx_feed_likes_feed_member ON feed_likes (feed_id, member_id);
+
+-- 댓글 인덱스 : (피드ID + 회원ID)
+CREATE INDEX idx_comments_feed_member ON comments (feed_id, member_id);
+
+-- 댓글 좋아요 인덱스: (댓글ID + 회원ID)
+CREATE INDEX idx_comment_likes_comment_member ON comment_likes (comment_id, member_id);
+
+INSERT INTO policies (policy_id, policy_key, policy_value, policy_unit, policy_description)
+VALUES (23, 'FEED_PICTURE_MAX_COUNT', '5', 'COUNT', '저장할 수 있는 최대 피드 사진 수');
+
+INSERT INTO policy_groups (policy_groups_id, policy_groups_name)
+VALUES (6, 'feed');
+
+INSERT INTO policy_group_mappings (policy_id, policy_groups_id)
+VALUES (23, 6);

src/docs/asciidoc/comment/댓글-삭제-API.adoc

@@ -0,0 +1,34 @@
+== 댓글 삭제 API
+
+=== 설명
+
+- #DELETE# `/api/v1/comments/{commentId}`
+- 본인이 작성한 댓글을 삭제하는 API 입니다.
+- Soft Delete 방식으로 처리됩니다.
+
+=== 개발 이력
+
+- Sprint 23 (2026-01-29): 기능 개발이 완료되었습니다.
+
+=== 개발 참고 사항
+
+- <<공통-개발-참고-사항,공통 개발 참고 사항>>을 참고하세요.
+
+=== 코드 샘플
+
+operation::delete-comment/delete-comment_success[snippets="curl-request,http-request,http-response"]
+
+=== 매개 변수
+
+operation::delete-comment/delete-comment_success[snippets="request-headers,path-parameters,response-fields"]
+
+==== 응답 상태 코드
+
+|===
+|상태 코드|설명
+|200|댓글이 성공적으로 삭제되었습니다.
+|401|인증되지 않은 요청입니다. Access Token이 없거나 유효하지 않습니다.
+|403|댓글 삭제 권한이 없습니다. 본인이 작성한 댓글만 삭제할 수 있습니다.
+|404|존재하지 않는 댓글입니다.
+|===
+

src/docs/asciidoc/comment/특정-피드에-댓글-작성-API.adoc

@@ -0,0 +1,34 @@
+== 특정 피드에 댓글 작성 API
+
+=== 설명
+
+- #POST# `/api/v1/feeds/{feedId}/comments`
+- 특정 피드에 댓글을 작성하는 API 입니다.
+- 대댓글을 작성할 경우 `parentCommentId`를 함께 전송합니다.
+
+=== 개발 이력
+
+- Sprint 23 (2026-01-29): 기능 개발이 완료되었습니다.
+
+=== 개발 참고 사항
+
+- <<공통-개발-참고-사항,공통 개발 참고 사항>>을 참고하세요.
+
+=== 코드 샘플
+
+operation::create-comment/create-comment_success[snippets="curl-request,http-request,http-response"]
+
+=== 매개 변수
+
+operation::create-comment/create-comment_success[snippets="request-headers,path-parameters,request-fields,response-fields"]
+
+==== 응답 상태 코드
+
+|===
+|상태 코드|설명
+|201|댓글이 성공적으로 생성되었습니다.
+|401|인증되지 않은 요청입니다. Access Token이 없거나 유효하지 않습니다.
+|404|존재하지 않는 피드입니다. +
+존재하지 않는 부모 댓글입니다.
+|===
+

src/docs/asciidoc/comment/특정-피드의-댓글-목록-조회-API.adoc

@@ -0,0 +1,33 @@
+== 특정 피드의 댓글 목록 조회 API
+
+=== 설명
+
+- #GET# `/api/v1/feeds/{feedId}/comments`
+- 특정 피드에 작성된 댓글 목록을 조회하는 API 입니다.
+- 대댓글도 함께 조회됩니다.
+
+=== 개발 이력
+
+- Sprint 23 (2026-01-29): 기능 개발이 완료되었습니다.
+
+=== 개발 참고 사항
+
+- <<공통-개발-참고-사항,공통 개발 참고 사항>>을 참고하세요.
+
+=== 코드 샘플
+
+operation::get-comments/get-comments_success[snippets="curl-request,http-request,http-response"]
+
+=== 매개 변수
+
+operation::get-comments/get-comments_success[snippets="request-headers,path-parameters,response-fields"]
+
+==== 응답 상태 코드
+
+|===
+|상태 코드|설명
+|200|요청이 성공적으로 처리되었습니다.
+|401|인증되지 않은 요청입니다. Access Token이 없거나 유효하지 않습니다.
+|404|존재하지 않는 피드입니다.
+|===
+

src/docs/asciidoc/feed/마이페이지-내가-작성한-피드-목록-조회-API.adoc

@@ -0,0 +1,32 @@
+== 마이페이지에서 내가 작성한 피드 목록 조회 API
+
+=== 설명
+
+- #GET# `/api/v1/mypage/feeds`
+- 회원이 자신이 작성한 피드의 전체 목록을 조회하는 API 입니다.
+
+=== 개발 이력
+
+- Sprint 23 (2026-01-29): 기능 개발이 완료되었습니다.
+
+=== 개발 참고 사항
+
+- <<공통-개발-참고-사항,공통 개발 참고 사항>>을 참고하세요.
+
+=== 코드 샘플
+
+operation::get-my-page-feeds/get-my-page-feeds_-success[snippets="curl-request,http-request,http-response"]
+
+=== 매개 변수
+
+operation::get-my-page-feeds/get-my-page-feeds_-success[snippets="request-headers,response-fields"]
+
+==== 응답 상태 코드
+
+|===
+|상태 코드|설명
+|200|요청이 성공적으로 처리되었습니다.
+|401|인증되지 않은 요청입니다. Access Token이 없거나 유효하지 않습니다
+|404|존재하지 않는 회원입니다.
+|===
+