From 945a0fa75e9bdf46aaa21ff87576388a20a4014a Mon Sep 17 00:00:00 2001 From: Dante0922 <101305519+Dante0922@users.noreply.github.com> Date: Sun, 8 Mar 2026 23:54:45 +0900 Subject: [PATCH 01/70] =?UTF-8?q?#1=20[Docs]=20=ED=99=88/=EB=A7=88?= =?UTF-8?q?=EC=9D=B4=ED=8E=98=EC=9D=B4=EC=A7=80=20API=20=EB=AA=85=EC=84=B8?= =?UTF-8?q?=20=EB=B0=8F=20ERD=20=EB=AC=B8=EC=84=9C=20=EC=A0=95=EB=A6=AC=20?= =?UTF-8?q?(#2)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - user, notice-notification ERD 문서 분리 - home, mypage, user API 명세 문서 추가 및 정리 --- docs/api-specs/home-api.md | 128 +++++++++++++++++++++ docs/api-specs/mypage-api.md | 85 ++++++++++++++ docs/api-specs/user-api.md | 183 ++++++++++++++++++++++++++++++ docs/erd/notice-notification.puml | 41 +++++++ docs/erd/user.puml | 81 +++++++++++++ 5 files changed, 518 insertions(+) create mode 100644 docs/api-specs/home-api.md create mode 100644 docs/api-specs/mypage-api.md create mode 100644 docs/api-specs/user-api.md create mode 100644 docs/erd/notice-notification.puml create mode 100644 docs/erd/user.puml diff --git a/docs/api-specs/home-api.md b/docs/api-specs/home-api.md new file mode 100644 index 0000000..3b83e2c --- /dev/null +++ b/docs/api-specs/home-api.md @@ -0,0 +1,128 @@ +# 홈 API 명세서 + +## 1. 설계 메모 + +- `Home`은 원천 도메인이 아니라 여러 도메인을 조합하는 집계 API입니다. +- 메인 화면에서 바로 응답하는 즉답형 기능은 `quiz` 도메인으로 분리합니다. +- 홈 화면은 아래 데이터를 한 번에 조합해서 반환합니다. + - HOT 배틀 + - PICK 배틀 + - 퀴즈 + - 최신 배틀 +- 공지는 홈 상단 노출 대상만 조회합니다. + +--- + +## 2. 홈 API + +### 2.1 `GET /api/v1/home` + +홈 화면 집계 조회 API. + +반환 항목: + +- HOT 배틀 +- PICK 배틀 +- 퀴즈 2지선다 +- 퀴즈 4지선다 +- 최신 배틀 목록 + +```json +{ + "hot_battle": { + "battle_id": "battle_001", + "title": "안락사 도입, 찬성 vs 반대", + "summary": "인간에게 품위 있는 죽음을 허용해야 할까?", + "thumbnail_url": "https://cdn.example.com/battle/hot-001.png" + }, + "pick_battle": { + "battle_id": "battle_002", + "title": "공리주의 vs 의무론", + "summary": "도덕 판단의 기준은 결과일까 원칙일까?", + "thumbnail_url": "https://cdn.example.com/battle/pick-002.png" + }, + "quizzes": [ + { + "quiz_id": "quiz_001", + "type": "BINARY", + "title": "AI가 만든 그림도 예술일까?", + "options": [ + { "code": "A", "label": "그렇다" }, + { "code": "B", "label": "아니다" } + ] + }, + { + "quiz_id": "quiz_002", + "type": "MULTIPLE_CHOICE", + "title": "도덕 판단의 기준은?", + "options": [ + { "code": "A", "label": "결과" }, + { "code": "B", "label": "의도" }, + { "code": "C", "label": "규칙" }, + { "code": "D", "label": "상황" } + ] + } + ], + "latest_battles": [ + { + "battle_id": "battle_101", + "title": "정의란 무엇인가", + "summary": "정의의 기준은 모두에게 같아야 할까?", + "thumbnail_url": "https://cdn.example.com/battle/latest-101.png" + } + ] +} +``` + +### 2.2 `POST /api/v1/quiz/{quizId}/responses` + +홈 화면에서 퀴즈 응답 저장. + +요청: + +```json +{ + "selected_option_code": "A" +} +``` + +응답: + +```json +{ + "quiz_id": "quiz_001", + "selected_option_code": "A", + "submitted_at": "2026-03-08T12:00:00Z" +} +``` + +--- + +## 3. 공지 API + +### 3.1 `GET /api/v1/notices` + +현재 노출 가능한 전체 공지 목록 조회. + +쿼리 파라미터: + +- `placement`: 선택, 예시 `HOME_TOP` +- `limit`: 선택 + +응답: + +```json +{ + "items": [ + { + "notice_id": "notice_001", + "title": "3월 신규 딜레마 업데이트", + "body": "매일 새로운 딜레마가 추가돼요.", + "notice_type": "ANNOUNCEMENT", + "is_pinned": true, + "starts_at": "2026-03-01T00:00:00Z", + "ends_at": "2026-03-31T23:59:59Z" + } + ] +} +``` diff --git a/docs/api-specs/mypage-api.md b/docs/api-specs/mypage-api.md new file mode 100644 index 0000000..e494560 --- /dev/null +++ b/docs/api-specs/mypage-api.md @@ -0,0 +1,85 @@ +# 마이페이지 API 명세서 + +## 1. 설계 메모 + +- 마이페이지는 원천 도메인이 아니라 사용자, 리캡, 활동 이력을 묶는 조회 API 성격이 강합니다. +- 상단 요약과 상세 목록은 분리해서 조회합니다. + +--- + +## 2. 마이페이지 API + +### 2.1 `GET /api/v1/me/mypage` + +마이페이지 상단에 필요한 집계 데이터 조회. + +응답: + +```json +{ + "profile": { + "user_id": "user_001", + "nickname": "생각하는올빼미", + "avatar_emoji": "🦉", + "manner_temperature": 36.5 + }, + "recap_summary": { + "personality_title": "원칙 중심형", + "summary": "감정보다 이성과 규칙을 더 중시하는 편이에요." + }, + "activity_counts": { + "comments": 12, + "posts": 3, + "liked_contents": 8, + "changed_mind_contents": 2 + } +} +``` + +### 2.2 `GET /api/v1/me/recap` + +상세 리캡 정보 조회. + +응답: + +```json +{ + "personality_title": "원칙 중심형", + "summary": "감정보다 이성과 규칙을 더 중시하는 편이에요.", + "scores": { + "score_1": 88, + "score_2": 74, + "score_3": 62, + "score_4": 45, + "score_5": 30, + "score_6": 15 + } +} +``` + +### 2.3 `GET /api/v1/me/activities` + +사용자 행동 이력 조회. + +쿼리 파라미터: + +- `type`: `COMMENT | POST | LIKED_CONTENT | CHANGED_MIND` +- `cursor`: 선택 +- `size`: 선택 + +응답: + +```json +{ + "items": [ + { + "activity_id": "act_001", + "type": "COMMENT", + "title": "안락사 도입, 찬성 vs 반대", + "description": "자기결정권은 가장 기본적인 인권이라고 생각해요.", + "created_at": "2026-03-08T12:00:00Z" + } + ], + "next_cursor": "cursor_002" +} +``` diff --git a/docs/api-specs/user-api.md b/docs/api-specs/user-api.md new file mode 100644 index 0000000..b22e74d --- /dev/null +++ b/docs/api-specs/user-api.md @@ -0,0 +1,183 @@ +# 사용자 API 명세서 + +## 1. 설계 메모 + +- 첫 로그인 시 닉네임 랜덤 생성과 이모지 선택이 필요합니다. +- 프로필, 설정, 성향 점수는 모두 사용자 도메인 책임입니다. +- 성향 점수는 현재값을 갱신하면서 이력도 함께 적재합니다. + +--- + +## 2. 첫 로그인 API + +### 2.1 `GET /api/v1/onboarding/bootstrap` + +첫 로그인 화면 진입 시 필요한 초기 데이터 조회. + +응답: + +```json +{ + "random_nickname": "생각하는올빼미", + "emoji_options": ["🦊", "🦉", "🐱", "🐻", "🐰", "🦁", "🐸", "🐧"] +} +``` + +### 2.2 `POST /api/v1/onboarding/profile` + +첫 로그인 시 프로필 생성. + +요청: + +```json +{ + "nickname": "생각하는올빼미", + "avatar_emoji": "🦉" +} +``` + +응답: + +```json +{ + "user_id": "user_001", + "nickname": "생각하는올빼미", + "avatar_emoji": "🦉", + "manner_temperature": 36.5, + "onboarding_completed": true +} +``` + +--- + +## 3. 프로필 API + +### 3.1 `PATCH /api/v1/me/profile` + +닉네임 및 아바타 수정. + +요청: + +```json +{ + "nickname": "생각하는펭귄", + "avatar_emoji": "🐧" +} +``` + +응답: + +```json +{ + "user_id": "user_001", + "nickname": "생각하는펭귄", + "avatar_emoji": "🐧", + "updated_at": "2026-03-08T12:00:00Z" +} +``` + +--- + +## 4. 설정 API + +### 4.1 `GET /api/v1/me/settings` + +현재 사용자 설정 조회. + +응답: + +```json +{ + "push_enabled": true, + "email_enabled": false, + "debate_request_enabled": true, + "profile_public": true +} +``` + +### 4.2 `PATCH /api/v1/me/settings` + +사용자 설정 수정. + +요청: + +```json +{ + "push_enabled": false, + "debate_request_enabled": false +} +``` + +응답: + +```json +{ + "updated": true +} +``` + +--- + +## 5. 성향 점수 API + +### 5.1 `PUT /api/v1/me/tendency-scores` + +최신 성향 점수 수정 및 이력 저장. + +요청: + +```json +{ + "score_1": 30, + "score_2": -20, + "score_3": 55, + "score_4": 10, + "score_5": -75, + "score_6": 42 +} +``` + +응답: + +```json +{ + "user_id": "user_001", + "score_1": 30, + "score_2": -20, + "score_3": 55, + "score_4": 10, + "score_5": -75, + "score_6": 42, + "updated_at": "2026-03-08T12:00:00Z", + "history_saved": true +} +``` + +### 5.2 `GET /api/v1/me/tendency-scores/history` + +성향 점수 변경 이력 조회. + +쿼리 파라미터: + +- `cursor`: 선택 +- `size`: 선택 + +응답: + +```json +{ + "items": [ + { + "history_id": "ths_001", + "score_1": 30, + "score_2": -20, + "score_3": 55, + "score_4": 10, + "score_5": -75, + "score_6": 42, + "created_at": "2026-03-08T12:00:00Z" + } + ], + "next_cursor": null +} +``` diff --git a/docs/erd/notice-notification.puml b/docs/erd/notice-notification.puml new file mode 100644 index 0000000..4c33ce5 --- /dev/null +++ b/docs/erd/notice-notification.puml @@ -0,0 +1,41 @@ +@startuml +hide circle +hide methods +skinparam linetype ortho + +entity "USERS\n사용자" as users { + * id : uuid <> +} + +entity "NOTICES\n전체 공지" as notices { + * id : uuid <> + -- + title : string + body : text + notice_type : string + is_pinned : boolean + starts_at : datetime + ends_at : datetime + created_at : datetime +} + +entity "NOTIFICATIONS\n알림 발송 이력" as notifications { + * id : uuid <> + -- + user_id : uuid <> + notification_type : string + title : string + body : text + payload_json : text + status : string + scheduled_at : datetime + sent_at : datetime + failed_at : datetime + provider_message_id : string + failure_reason : string + created_at : datetime +} + +users ||--o{ notifications + +@enduml diff --git a/docs/erd/user.puml b/docs/erd/user.puml new file mode 100644 index 0000000..5007a96 --- /dev/null +++ b/docs/erd/user.puml @@ -0,0 +1,81 @@ +@startuml +hide circle +hide methods +skinparam linetype ortho + +entity "USERS\n사용자" as users { + * id : uuid <> + -- + provider : string + provider_user_id : string + status : string + created_at : datetime +} + +entity "USER_PROFILES\n사용자 프로필" as user_profiles { + * user_id : uuid <> + -- + nickname : string + avatar_type : string + avatar_url : string + manner_temperature : float + updated_at : datetime +} + +entity "USER_SETTINGS\n사용자 설정" as user_settings { + * user_id : uuid <> + -- + push_enabled : boolean + email_enabled : boolean + debate_request_enabled : boolean + profile_public : boolean + updated_at : datetime +} + +entity "USER_AGREEMENTS\n사용자 동의 이력" as user_agreements { + * id : uuid <> + -- + user_id : uuid <> + agreement_type : string + version : string + agreed_at : datetime +} + +entity "USER_DEVICES\n사용자 디바이스" as user_devices { + * id : uuid <> + -- + user_id : uuid <> + device_token : string + platform : string + last_seen_at : datetime +} + +entity "USER_BLOCKS\n사용자 차단" as user_blocks { + * id : uuid <> + -- + blocker_user_id : uuid <> + blocked_user_id : uuid <> + created_at : datetime +} + +entity "USER_TENDENCY_SCORES\n사용자 성향 점수 (-100~100) \n(필드는 추후 수정)" as user_tendency_scores { + * user_id : uuid <> + -- + score_1 : int + score_2 : int + score_3 : int + score_4 : int + score_5 : int + score_6 : int + updated_at : datetime +} + +users ||--|| user_profiles +users ||--|| user_settings +users ||--o{ user_agreements +users ||--o{ user_devices +users ||--o{ user_blocks : blocker +users ||--o{ user_blocks : blocked +users ||--|| user_tendency_scores + +@enduml From 95f60dc2b8536002e9e54d79fb2b057e6b0581d1 Mon Sep 17 00:00:00 2001 From: Youwol <153346797+si-zero@users.noreply.github.com> Date: Tue, 10 Mar 2026 14:08:05 +0900 Subject: [PATCH 02/70] =?UTF-8?q?#3=20[Docs]=20Oauth2=20ERD=20=EB=B0=8F=20?= =?UTF-8?q?API=20=EC=A0=95=EC=9D=98=20(#4)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Oauth2 ERD 및 API 정의 --- docs/api-specs/oauth-api.md | 214 ++++++++++++++++++++++++++++++++++++ docs/erd/oauth2.puml | 78 +++++++++++++ 2 files changed, 292 insertions(+) create mode 100644 docs/api-specs/oauth-api.md create mode 100644 docs/erd/oauth2.puml diff --git a/docs/api-specs/oauth-api.md b/docs/api-specs/oauth-api.md new file mode 100644 index 0000000..6117889 --- /dev/null +++ b/docs/api-specs/oauth-api.md @@ -0,0 +1,214 @@ +# 🔐 PIQUE 사용자 인증 및 온보딩 API 통합 명세서 + +## 1. 설계 메모 +* **인증 방식**: OAuth 2.0 인가 코드 방식을 사용하며, 서비스 자체 JWT(Access/Refresh)를 발급합니다. +* **온보딩 흐름**: 로그인 응답의 `isNewUser`가 `true`일 경우, `bootstrap` 데이터를 조회한 뒤 `profile` 생성 API를 호출합니다. +* **상태 전환**: 프로필 생성이 완료되면 유저 상태(`status`)는 `PENDING`에서 `ACTIVE`로 변경됩니다. +* **재화 관리**: 유저 지갑(`userWallet`)은 별도 테이블로 관리하며 프로필 설정 완료 시 함께 조회됩니다. +* **응답 규격**: 모든 응답은 `statusCode`, `data`, `error` 필드를 포함하는 공통 포맷을 준수합니다. + +--- + +## 2. API 상세 내역 + +### 2.1 소셜 로그인 및 회원가입 +* **Endpoint**: `POST /api/v1/auth/login/{provider}` +* **설명**: 소셜 인가 코드를 이용해 로그인 및 계정을 생성합니다. 상태가 `BANNED`인 유저는 403을 반환합니다. +* **요청 바디**: +```json +{ + "authorizationCode": "string", + "redirectUri": "string" +} +``` +* **성공 응답**: +```json +{ + "statusCode": 200, + "data": { + "accessToken": "eyJhbGciOiJIUzI...", + "refreshToken": "def456-ghi789...", + "userId": 105, + "isNewUser": true, + "status": "PENDING" + }, + "error": null +} +``` + +### 2.2 온보딩 초기 데이터 조회 +* **Endpoint**: `GET /api/v1/onboarding/bootstrap` +* **설명**: 첫 로그인 화면 진입 시 필요한 랜덤 닉네임과 캐릭터 옵션을 조회합니다. +* **성공 응답**: +```json +{ + "statusCode": 200, + "data": { + "randomNickname": "생각하는올빼미", + "characterOptions": [ + { "id": 1, "name": "올빼미", "imageUrl": "https://..." }, + { "id": 2, "name": "여우", "imageUrl": "https://..." } + ] + }, + "error": null +} +``` + +### 2.3 초기 프로필 설정 (가입 완료) +* **Endpoint**: `POST /api/v1/onboarding/profile` +* **설명**: 신규 유저의 닉네임과 캐릭터를 설정하여 정식 회원으로 전환합니다. +* **요청 바디**: +```json +{ + "nickname": "생각하는올빼미", + "characterId": 1 +} +``` +* **성공 응답**: +```json +{ + "statusCode": 200, + "data": { + "userId": 105, + "nickname": "생각하는올빼미", + "characterId": 1, + "userWallet": { + "credit": 500, + "updatedAt": "2026-03-08T12:00:00Z" + }, + "status": "ACTIVE", + "onboardingCompleted": true + }, + "error": null +} +``` + +### 2.4 토큰 재발급 +* **Endpoint**: `POST /api/v1/auth/refresh` +* **설명**: 만료된 Access Token을 Refresh Token을 사용하여 재발급합니다. +* **요청 헤더**: `X-Refresh-Token: {refreshToken}` +* **성공 응답**: +```json +{ + "statusCode": 200, + "data": { + "accessToken": "new_eyJhbGciOiJIUzI...", + "refreshToken": "new_def456-ghi789..." + }, + "error": null +} +``` + +### 2.5 로그아웃 +* **Endpoint**: `POST /api/v1/auth/logout` +* **설명**: 현재 로그인된 사용자의 Refresh Token을 삭제하여 로그아웃 처리합니다. +* **요청 헤더**: `Authorization: Bearer {accessToken}` +* **성공 응답**: +```json +{ + "statusCode": 200, + "data": { + "loggedOut": true + }, + "error": null +} +``` + +### 2.6 회원 탈퇴 +* **Endpoint**: `DELETE /api/v1/me` +* **설명**: 현재 로그인된 사용자의 계정을 삭제합니다. `users`, `user_socials`, `refresh_tokens`, `user_wallets`, `credit_histories` 연관 데이터를 함께 처리합니다. +* **요청 헤더**: `Authorization: Bearer {accessToken}` +* **성공 응답**: +```json +{ + "statusCode": 200, + "data": { + "withdrawn": true + }, + "error": null +} +``` + +--- + +## 3. 예외 응답 (공통) + +### 3.1 요청 파라미터 오류 (400) +```json +{ + "statusCode": 400, + "data": null, + "error": { + "code": "COMMON_INVALID_PARAMETER", + "message": "요청 파라미터가 잘못되었습니다.", + "errors": [ + { + "field": "nickname", + "value": "홍길동!", + "reason": "특수문자는 포함할 수 없습니다." + } + ] + } +} +``` + +### 3.2 인증 오류 (401) +```json +{ + "statusCode": 401, + "data": null, + "error": { + "code": "AUTH_INVALID_CODE", + "message": "유효하지 않은 소셜 인가 코드입니다.", + "errors": [] + } +} +``` +```json +{ + "statusCode": 401, + "data": null, + "error": { + "code": "AUTH_TOKEN_EXPIRED", + "message": "만료되었거나 유효하지 않은 Refresh Token입니다.", + "errors": [] + } +} +``` + +### 3.3 중복 오류 (409) +```json +{ + "statusCode": 409, + "data": null, + "error": { + "code": "USER_NICKNAME_DUPLICATE", + "message": "이미 사용 중인 닉네임입니다.", + "errors": [] + } +} +``` +```json +{ + "statusCode": 409, + "data": null, + "error": { + "code": "ONBOARDING_ALREADY_COMPLETED", + "message": "이미 온보딩이 완료된 사용자입니다.", + "errors": [] + } +} +``` + +### 3.4 접근 거부 오류 (403) +```json +{ + "statusCode": 403, + "data": null, + "error": { + "code": "USER_BANNED", + "message": "제재된 사용자입니다.", + "errors": [] + } +} +``` \ No newline at end of file diff --git a/docs/erd/oauth2.puml b/docs/erd/oauth2.puml new file mode 100644 index 0000000..bd04b80 --- /dev/null +++ b/docs/erd/oauth2.puml @@ -0,0 +1,78 @@ +@startuml +!theme plain +skinparam Linetype ortho + +' 1. 사용자 기본 테이블 +entity "users" { + * id : BIGINT <> + -- + email : VARCHAR(255) <> + nickname : VARCHAR(50) <> + character_id : INT <> + role : ENUM('USER', 'ADMIN') + status : ENUM('PENDING', 'ACTIVE', 'DELETED', 'BANNED') + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + +' 2. OAuth 연동 정보 테이블 +' [논의 필요] access_token, refresh_token 암호화 저장 여부 검토 필요 +entity "user_socials" { + * id : BIGINT <> + -- + user_id : BIGINT <> + provider : ENUM('KAKAO', 'GOOGLE', 'APPLE') + provider_user_id : VARCHAR(255) + access_token : TEXT + refresh_token : TEXT +} + +' 3. 선택 가능한 캐릭터 정보 테이블 +entity "characters" { + * id : INT <> + -- + name : VARCHAR(50) + image_url : VARCHAR(255) + description : VARCHAR(255) +} + +' 4. 서비스 자체 인증 토큰 관리 +' [논의 필요] 현재는 재발급 시 기존 토큰 삭제 방식 사용 +' 토큰 탈취 감지가 필요하다면 is_revoked : BOOLEAN DEFAULT false 추가 검토 +entity "refresh_tokens" { + * id : BIGINT <> + -- + user_id : BIGINT <> + token_value : TEXT + expired_at : TIMESTAMP + ' is_revoked : BOOLEAN DEFAULT false +} + +' 5. 지갑 테이블 +entity "user_wallets" { + * id : BIGINT <> + -- + user_id : BIGINT <> + credit : INT DEFAULT 0 + updated_at : TIMESTAMP +} + +' 6. 크레딧 변동 이력 테이블 +entity "credit_histories" { + * id : BIGINT <> + -- + user_id : BIGINT <> + amount : INT -- 변동된 크레딧 양 + type : ENUM('CHARGE', 'USE', 'EVENT', 'REFUND') + description : VARCHAR(255) + created_at : TIMESTAMP +} + +' 관계 설정 +users }|--|| characters : "선택한 캐릭터" +users ||--o{ user_socials : "소셜 연동" +users ||--o{ refresh_tokens : "인증 관리" +users ||--|| user_wallets : "보유 크레딧" +users ||--o{ credit_histories : "이력 기록" + +@enduml \ No newline at end of file From 062f9fc251a0b7ca1ff6aa720319a6861386178c Mon Sep 17 00:00:00 2001 From: JOO <107450745+jucheonsu@users.noreply.github.com> Date: Wed, 11 Mar 2026 13:50:34 +0900 Subject: [PATCH 03/70] =?UTF-8?q?[Docs]=20=EB=B0=B0=ED=8B=80,=20=EC=8B=9C?= =?UTF-8?q?=EB=82=98=EB=A6=AC=EC=98=A4,=20=ED=88=AC=ED=91=9C,=20=ED=83=9C?= =?UTF-8?q?=EA=B7=B8=20ERD=20=EB=B0=8F=20API=20=EC=A0=95=EC=9D=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/api-specs/battle-api.md | 494 ++++++++++++++++++++++++++++ docs/api-specs/scenario-api.md | 569 +++++++++++++++++++++++++++++++++ docs/api-specs/tag-api.md | 188 +++++++++++ docs/api-specs/vote-api.md | 153 +++++++++ docs/erd/battle.puml | 89 ++++++ docs/erd/scenario.puml | 127 ++++++++ docs/erd/tag.puml | 61 ++++ docs/erd/vote.puml | 101 ++++++ 8 files changed, 1782 insertions(+) create mode 100644 docs/api-specs/battle-api.md create mode 100644 docs/api-specs/scenario-api.md create mode 100644 docs/api-specs/tag-api.md create mode 100644 docs/api-specs/vote-api.md create mode 100644 docs/erd/battle.puml create mode 100644 docs/erd/scenario.puml create mode 100644 docs/erd/tag.puml create mode 100644 docs/erd/vote.puml diff --git a/docs/api-specs/battle-api.md b/docs/api-specs/battle-api.md new file mode 100644 index 0000000..4fd9277 --- /dev/null +++ b/docs/api-specs/battle-api.md @@ -0,0 +1,494 @@ +# 배틀 API 명세서 + +--- + +## 설계 메모 + +- **오늘의 배틀 :** + - 스와이프 UI를 위해 약 5개의 배틀 리스트를 반환합니다. '오늘의 배틀(검정 창)'과 '일반 배틀 카드(하얀 창)'의 진입점(API)을 분리하여 각기 필요한 데이터를 제공합니다. +- **태그 :** + - 배틀 응답의 `tags` 필드는 `{ tag_id, name }` 객체 배열로 반환됩니다. 태그 전체 목록 조회 및 태그 기반 배틀 필터링은 Tag API를 참조하세요. +- **도메인 분리 :** + - 사용자 서비스 API와 관리자(Admin) 전용 API 도메인을 분리했습니다. 기본 콘텐츠 발행은 관리자 도메인에서 이루어집니다. +- **AI 자동 생성 :** + - 스케줄러가 매일 자동으로 트렌딩 이슈를 검색·수집하여 AI API를 호출하고 배틀 초안을 `PENDING` 상태로 저장합니다. 관리자는 `/api/v1/admin/ai/battles`를 통해 검수·승인·반려합니다. +- **배틀 `status` 흐름 :** + + | status | 적용 대상 | 설명 | + |--------|--------------|------| + | `DRAFT` | 관리자 | 관리자가 작성 중인 초안 | + | `PENDING` | AI, 유저 [후순위] | 검수 대기 중 | + | `PUBLISHED` | 전체 | 검수 완료, 실제 노출 | + | `REJECTED` | AI, 유저 [후순위] | 검수 반려 | + | `ARCHIVED` | 전체 | 배틀 종료 후 이력 보존 | + +- **[후순위] 크리에이터 정책 :** + - 매너 온도 45도 이상의 사용자가 직접 배틀을 제안하는 기능은 런칭 스펙에서 제외됩니다. + +--- + +## 사용자 API + +### `GET /api/v1/battles/today` + +- 스와이프 UI용으로 오늘 진행 중인 배틀 목록을 반환합니다. +- 피그마 디자인 상 5개로 임의 판단 -> 추후 수정 가능 + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "items": [ + { + "battle_id": "battle_001", + "title": "드라마 <레이디 두아>, 원가 18만원 명품은 사기인가?", + "summary": "18만 원짜리 가방을 1억에 판 주인공, 사기꾼일까 예술가일까?", + "thumbnail_url": "https://cdn.pique.app/battle/hot-001.png", + "tags": [ + { "tag_id": "tag_001", "name": "사회" }, + { "tag_id": "tag_002", "name": "철학" }, + { "tag_id": "tag_003", "name": "롤스" }, + { "tag_id": "tag_004", "name": "니체" } + ], + "participants_count": 2148, + "audio_duration": 420, + "share_url": "https://pique.app/battles/battle_001", + "options": [ + { "option_id": "option_A", "label": "A", "title": "사기다 (롤스)" }, + { "option_id": "option_B", "label": "B", "title": "사기가 아니다 (니체)" } + ], + "user_vote_status": "NONE" + } + ], + "total_count": 5 + }, + "error": null +} +``` + +--- + +### `GET /api/v1/battles/{battle_id}` + +- 배틀 카드(하얀 창) 선택 시 노출되는 상세 정보(철학자, 성향, 인용구 등)를 조회합니다. + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "battle_id": "battle_001", + "title": "드라마 <레이디 두아>, 원가 18만원 명품은 사기인가?", + "tags": [ + { "tag_id": "tag_001", "name": "사회" }, + { "tag_id": "tag_002", "name": "철학" } + ], + "options": [ + { + "option_id": "option_A", + "label": "A", + "stance": "정보의 대칭 (공정성)", + "representative": "존 롤스", + "title": "사기다", + "quote": "베일 뒤에서 누구나 동의할 수 있는 공정한 규칙이 깨진 것입니다.", + "keywords": ["합리적", "원칙주의", "절대적"], + "image_url": "https://cdn.pique.app/images/rawls.png" + }, + { + "option_id": "option_B", + "label": "B", + "stance": "가치 창조 (욕망의 질서)", + "representative": "프리드리히 니체", + "title": "사기가 아니다", + "quote": "주인공은 가려운 욕망을 정확히 읽어내고, 새로운 가치를 창조해낸 예술가입니다.", + "keywords": ["본능적", "실용주의", "주관적"], + "image_url": "https://cdn.pique.app/images/nietzsche.png" + } + ] + }, + "error": null +} +``` + +--- + +## 관리자 API + +### `POST /api/v1/admin/battles` + +- 공식 배틀을 직접 생성합니다. + +#### Request Body + +```json +{ + "title": "드라마 <레이디 두아>, 원가 18만원 명품은 사기인가?", + "summary": "18만 원짜리 가방을 1억에 판 주인공, 사기꾼일까 예술가일까?", + "description": "예술과 사기의 경계에 대한 철학적 딜레마", + "thumbnail_url": "https://cdn.pique.app/battle/hot-001.png", + "target_date": "2026-03-10", + "tag_ids": ["tag_001", "tag_002", "tag_003", "tag_004"], + "options": [ + { + "label": "A", + "title": "사기다", + "stance": "정보의 대칭 (공정성)", + "representative": "존 롤스", + "quote": "베일 뒤에서 누구나 동의할 수 있는 공정한 규칙이 깨진 것입니다.", + "keywords": ["합리적", "원칙주의", "절대적"], + "image_url": "https://cdn.pique.app/images/rawls.png" + }, + { + "label": "B", + "title": "사기가 아니다", + "stance": "가치 창조 (욕망의 질서)", + "representative": "프리드리히 니체", + "quote": "주인공은 가려운 욕망을 정확히 읽어내고, 새로운 가치를 창조해낸 예술가입니다.", + "keywords": ["본능적", "실용주의", "주관적"], + "image_url": "https://cdn.pique.app/images/nietzsche.png" + } + ] +} +``` + +#### 성공 응답 `201 Created` + +```json +{ + "statusCode": 201, + "data": { + "battle_id": "battle_001", + "title": "드라마 <레이디 두아>, 원가 18만원 명품은 사기인가?", + "summary": "18만 원짜리 가방을 1억에 판 주인공, 사기꾼일까 예술가일까?", + "description": "예술과 사기의 경계에 대한 철학적 딜레마", + "thumbnail_url": "https://cdn.pique.app/battle/hot-001.png", + "target_date": "2026-03-10", + "status": "DRAFT", + "creator_type": "ADMIN", + "tags": [ + { "tag_id": "tag_001", "name": "사회" }, + { "tag_id": "tag_002", "name": "철학" }, + { "tag_id": "tag_003", "name": "롤스" }, + { "tag_id": "tag_004", "name": "니체" } + ], + "options": [ + { + "option_id": "option_A", + "label": "A", + "title": "사기다", + "stance": "정보의 대칭 (공정성)", + "representative": "존 롤스", + "quote": "베일 뒤에서 누구나 동의할 수 있는 공정한 규칙이 깨진 것입니다.", + "keywords": ["합리적", "원칙주의", "절대적"], + "image_url": "https://cdn.pique.app/images/rawls.png" + }, + { + "option_id": "option_B", + "label": "B", + "title": "사기가 아니다", + "stance": "가치 창조 (욕망의 질서)", + "representative": "프리드리히 니체", + "quote": "주인공은 가려운 욕망을 정확히 읽어내고, 새로운 가치를 창조해낸 예술가입니다.", + "keywords": ["본능적", "실용주의", "주관적"], + "image_url": "https://cdn.pique.app/images/nietzsche.png" + } + ], + "created_at": "2026-03-10T09:00:00Z" + }, + "error": null +} +``` + +--- + +### `PATCH /api/v1/admin/battles/{battle_id}` + +- 배틀 정보를 수정합니다. 변경할 필드만 포함합니다. + +#### Request Body + +```json +{ + "title": "드라마 <레이디 두아>, 원가 18만원 명품은 사기인가? (수정)", + "status": "PUBLISHED", + "tag_ids": ["tag_001", "tag_002"] +} +``` + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "battle_id": "battle_001", + "title": "드라마 <레이디 두아>, 원가 18만원 명품은 사기인가? (수정)", + "summary": "18만 원짜리 가방을 1억에 판 주인공, 사기꾼일까 예술가일까?", + "description": "예술과 사기의 경계에 대한 철학적 딜레마", + "thumbnail_url": "https://cdn.pique.app/battle/hot-001.png", + "target_date": "2026-03-10", + "status": "PUBLISHED", + "creator_type": "ADMIN", + "tags": [ + { "tag_id": "tag_001", "name": "사회" }, + { "tag_id": "tag_002", "name": "철학" } + ], + "updated_at": "2026-03-10T10:00:00Z" + }, + "error": null +} +``` + +--- + +### `DELETE /api/v1/admin/battles/{battle_id}` + +- 배틀을 삭제합니다. + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "success": true, + "deleted_at": "2026-03-10T11:00:00Z" + }, + "error": null +} +``` + +--- + +## `[후순위]` 관리자 AI 검수 API + +- 스케줄러가 자동 생성한 AI 배틀 초안(`PENDING`)을 관리자가 검수 · 승인 · 반려합니다. + +### `GET /api/v1/admin/ai/battles` + +- AI가 생성한 `PENDING` 상태의 배틀 목록을 조회합니다. + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "items": [ + { + "battle_id": "battle_ai_001", + "title": "AI가 제안한 배틀 제목", + "summary": "AI가 생성한 요약", + "thumbnail_url": "https://cdn.pique.app/battle/ai-001.png", + "target_date": "2026-03-11", + "status": "PENDING", + "creator_type": "AI", + "tags": [ + { "tag_id": "tag_001", "name": "사회" } + ], + "options": [ + { "option_id": "option_A", "label": "A", "title": "찬성", "keywords": ["합리적", "효율중심", "미래지향"] }, + { "option_id": "option_B", "label": "B", "title": "반대", "keywords": ["인본주의", "도덕중심", "전통적"] } + ], + "created_at": "2026-03-11T06:00:00Z" + } + ], + "total_count": 3 + }, + "error": null +} +``` + +--- + +### `PATCH /api/v1/admin/ai/battles/{battle_id}` + +- AI가 생성한 배틀을 승인하거나 반려합니다. 승인 시 내용을 수정한 뒤 승인할 수 있습니다. + +#### Request Body — 승인 + +```json +{ + "action": "APPROVE", + "title": "AI 초안 제목 (수정 가능)", + "summary": "AI 초안 요약 (수정 가능)", + "tag_ids": ["tag_001", "tag_002"] +} +``` + +#### Request Body — 반려 + +```json +{ + "action": "REJECT", + "reject_reason": "주제가 서비스 방향과 맞지 않음" +} +``` + +#### 성공 응답 `200 OK` — 승인 + +```json +{ + "statusCode": 200, + "data": { + "battle_id": "battle_ai_001", + "status": "PUBLISHED", + "creator_type": "AI", + "updated_at": "2026-03-11T09:00:00Z" + }, + "error": null +} +``` + +#### 성공 응답 `200 OK` — 반려 + +```json +{ + "statusCode": 200, + "data": { + "battle_id": "battle_ai_001", + "status": "REJECTED", + "reject_reason": "주제가 서비스 방향과 맞지 않음", + "updated_at": "2026-03-11T09:00:00Z" + }, + "error": null +} +``` + +--- + +## `[후순위]` 크리에이터 API + +### `POST /api/v1/battles` + +- 배틀을 제안합니다. (매너 온도 45도 이상 유저) + +#### Request Body + +```json +{ + "title": "AI가 만든 예술 작품, 저작권은 누구에게?", + "summary": "AI 창작물의 저작권 귀속 주체에 대한 철학적 딜레마", + "description": "창작의 주체성과 소유권에 대한 철학적 논쟁", + "thumbnail_url": "https://cdn.pique.app/battle/ai-art.png", + "target_date": "2026-03-15", + "tag_ids": ["tag_002", "tag_005"], + "options": [ + { + "label": "A", + "title": "AI 개발사에게 귀속된다", + "stance": "도구 이론", + "representative": "존 로크", + "quote": "노동을 투입한 자에게 소유권이 있다.", + "keywords": ["합리적", "효율중심", "미래지향"], + "image_url": "https://cdn.pique.app/images/locke.png" + }, + { + "label": "B", + "title": "퍼블릭 도메인이어야 한다", + "stance": "공유재 이론", + "representative": "장 자크 루소", + "quote": "창작물은 사회의 산물이므로 모두의 것이다.", + "keywords": ["합리적", "효율중심", "미래지향"], + "image_url": "https://cdn.pique.app/images/rousseau.png" + } + ] +} +``` + +#### 성공 응답 `201 Created` + +```json +{ + "statusCode": 201, + "data": { + "battle_id": "battle_002", + "title": "AI가 만든 예술 작품, 저작권은 누구에게?", + "status": "PENDING", + "creator_type": "USER", + "created_at": "2026-03-10T12:00:00Z" + }, + "error": null +} +``` + +--- + +### `PATCH /api/v1/battles/{battle_id}` + +- 제안한 배틀 정보를 수정합니다. 변경할 필드만 포함합니다. + +#### Request Body + +```json +{ + "title": "AI가 만든 예술 작품, 저작권은 누구에게? (수정)", + "summary": "AI 창작물의 저작권 귀속 주체에 대한 철학적 딜레마" +} +``` + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "battle_id": "battle_002", + "title": "AI가 만든 예술 작품, 저작권은 누구에게? (수정)", + "summary": "AI 창작물의 저작권 귀속 주체에 대한 철학적 딜레마", + "status": "PENDING", + "creator_type": "USER", + "updated_at": "2026-03-10T13:00:00Z" + }, + "error": null +} +``` + +--- + +### `DELETE /api/v1/battles/{battle_id}` + +- 제안한 배틀을 삭제합니다. + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "success": true, + "deleted_at": "2026-03-10T14:00:00Z" + }, + "error": null +} +``` + +--- + +## 공통 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `COMMON_INVALID_PARAMETER` | `400` | 요청 파라미터 오류 | +| `COMMON_BAD_REQUEST` | `400` | 잘못된 요청 | +| `AUTH_UNAUTHORIZED` | `401` | 인증 실패 | +| `AUTH_TOKEN_EXPIRED` | `401` | 토큰 만료 | +| `FORBIDDEN_ACCESS` | `403` | 접근 권한 없음 | +| `USER_BANNED` | `403` | 제재된 사용자 | +| `INTERNAL_SERVER_ERROR` | `500` | 서버 오류 | + +--- + +## 배틀 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `BATTLE_NOT_FOUND` | `404` | 존재하지 않는 배틀 | +| `BATTLE_CLOSED` | `409` | 종료된 배틀 | +| `BATTLE_ALREADY_PUBLISHED` | `409` | 이미 발행된 배틀 | +| `BATTLE_OPTION_NOT_FOUND` | `404` | 존재하지 않는 선택지 | + +--- \ No newline at end of file diff --git a/docs/api-specs/scenario-api.md b/docs/api-specs/scenario-api.md new file mode 100644 index 0000000..575c742 --- /dev/null +++ b/docs/api-specs/scenario-api.md @@ -0,0 +1,569 @@ +# 시나리오 API 명세서 + +--- + +## 설계 메모 + +- **시나리오 구조 (인터랙티브 O/X 모두 지원) :** + - 배틀의 성격에 따라 인터랙티브(분기 선택)가 없는 '단일 오디오 재생'과 인터랙티브가 있는 '트리형 오디오 재생'을 모두 지원합니다. `is_interactive` 상태값으로 구분하여 클라이언트가 적절한 UI를 렌더링합니다. +- **트리(Node) 구조 :** + - 시나리오(오디오/대본)는 오프닝/1라운드 → 유저 선택 분기(2라운드) → 최종 결론(3라운드/클로징)으로 이어지는 트리(Node) 구조를 가집니다. +- **TTS 사전 생성 :** + - 관리자가 시나리오를 발행할 때 단 1번만 TTS API를 호출하여 `.mp3` 파일과 타임스탬프(`start_time`)를 생성하고 CDN에 저장합니다. 유저 플레이 시에는 실시간 호출 없이 저장된 파일을 스트리밍합니다. +- **AI 자동 생성 :** + - 스케줄러가 매일 자동으로 트렌딩 이슈를 검색·수집하여 AI API를 호출하고 시나리오 초안을 `PENDING` 상태로 저장합니다. 관리자는 `/api/v1/admin/ai/scenarios`를 통해 검수·승인·반려합니다. +- **프론트엔드 자체 처리 :** + - 글씨 크기(A-/A+) 및 오디오 플레이어 컨트롤(15초 전/후, 배속, 스와이프)은 프론트엔드에서 네이티브/UI 상태로 처리합니다. +- **시나리오 `status` 흐름 :** + + | status | 적용 대상 | 설명 | + |--------|--------------|------| + | `DRAFT` | 관리자 | 관리자가 작성 중인 초안. TTS 미생성 상태 | + | `PENDING` | AI, 유저 [후순위] | 관리자 검수 대기 중 | + | `PUBLISHED` | 전체 | TTS 생성 완료, CDN 업로드 완료, 실제 노출 | + | `REJECTED` | AI, 유저 [후순위] | 검수 반려 | + | `ARCHIVED` | 전체 | 배틀 종료 후 이력 보존, 더 이상 노출 안 함 | + +- **[후순위] 크리에이터 정책 :** + - 매너 온도 45도 이상의 사용자가 직접 시나리오를 제안하는 기능은 런칭 스펙에서 제외됩니다. + +--- + +## 사용자 API + +### `GET /api/v1/battles/{battle_id}/scenario` + +- 사전 투표 완료 후 시나리오 창 진입 시 호출합니다. +- `is_interactive` 값에 따라 클라이언트 렌더링 방식이 분기됩니다. + +--- + +#### CASE 1 - 단일 재생 (`is_interactive: false`) + +- 전체 시나리오가 1개의 노드에 담기며, `interactive_options`는 빈 배열로 반환됩니다. + +```json +{ + "statusCode": 200, + "data": { + "battle_id": "battle_001", + "is_interactive": false, + "my_pre_vote": { + "option_id": "option_A", + "label": "A", + "title": "사기다" + }, + "start_node_id": "node_001_full", + "nodes": [ + { + "node_id": "node_001_full", + "audio_url": "https://cdn.pique.app/audio/battle_001_full.mp3", + "audio_duration": 420, + "scripts": [ + { "start_time": 0, "speaker_name": "나레이션", "speaker_side": "NONE", "message": "여기 한 여자가 있습니다. 동대문에서 18만 원에 떼온 가방을 1억 원에 팔았습니다..." }, + { "start_time": 60000, "speaker_name": "존 롤스", "speaker_side": "A", "message": "재판장님, 시장 경제의 핵심은 '정보의 대칭'입니다. 판매자가 원가를 은폐한 것은 기만입니다." }, + { "start_time": 90000, "speaker_name": "프리드리히 니체", "speaker_side": "B", "message": "명품을 사는 사람이 원가를 몰라서 삽니까? 그들은 남들보다 우월해지기 위해 기꺼이 1억을 지불한 겁니다." }, + { "start_time": 150000, "speaker_name": "존 롤스", "speaker_side": "A", "message": "현명하십니다. 상품의 가치가 전적으로 기만에 의해 결정된다면 사회적 계약의 약탈입니다." }, + { "start_time": 210000, "speaker_name": "프리드리히 니체", "speaker_side": "B", "message": "역시 가치를 아시는군요! 거래는 예술입니다. 주인공은 가방에 독점적 서사를 입혔고 구매자는 만족했습니다." }, + { "start_time": 300000, "speaker_name": "존 롤스", "speaker_side": "A", "message": "한 가지 묻겠습니다. 당신이 만약 그 가방의 구매자였다면, 원가를 알고도 웃으며 1억을 내놓겠습니까?" }, + { "start_time": 330000, "speaker_name": "프리드리히 니체", "speaker_side": "B", "message": "질문이 틀렸소. 명품을 사는 자들은 이미 그 게임의 규칙을 압니다. 불쾌함이 곧 사기는 아닙니다." }, + { "start_time": 390000, "speaker_name": "나레이션", "speaker_side": "NONE", "message": "거래는 끝났고, 가방은 누군가의 손에 들려 있습니다. 이제 당신의 최종 선택을 들려주세요." } + ], + "interactive_options": [] + } + ] + }, + "error": null +} +``` + +--- + +#### CASE 2 - 분기형 인터랙티브 재생 (`is_interactive: true`) + +- `interactive_options` 배열의 `next_node_id`를 따라 노드를 순회합니다. + +```json +{ + "statusCode": 200, + "data": { + "battle_id": "battle_001", + "is_interactive": true, + "my_pre_vote": { + "option_id": "option_A", + "label": "A", + "title": "사기다" + }, + "start_node_id": "node_001_opening", + "nodes": [ + { + "node_id": "node_001_opening", + "audio_url": "https://cdn.pique.app/audio/battle_001_round1.mp3", + "audio_duration": 150, + "scripts": [ + { "start_time": 0, "speaker_name": "나레이션", "speaker_side": "NONE", "message": "여기 한 여자가 있습니다. 동대문에서 18만 원에 떼온 가방을 1억 원에 팔았습니다..." }, + { "start_time": 60000, "speaker_name": "존 롤스", "speaker_side": "A", "message": "재판장님, 시장 경제의 핵심은 '정보의 대칭'입니다..." }, + { "start_time": 90000, "speaker_name": "프리드리히 니체", "speaker_side": "B", "message": "명품을 사는 사람이 원가를 몰라서 삽니까? 그들은 차별화를 위해..." } + ], + "interactive_options": [ + { "label": "사회적 신뢰를 위해 정보의 투명성이 우선이다.", "next_node_id": "node_002_branch_a" }, + { "label": "시장은 개인의 욕망이 만나는 곳이다.", "next_node_id": "node_002_branch_b" } + ] + }, + { + "node_id": "node_002_branch_a", + "audio_url": "https://cdn.pique.app/audio/battle_001_round2_a.mp3", + "audio_duration": 110, + "scripts": [ + { "start_time": 0, "speaker_name": "유저", "speaker_side": "A", "message": "사회의 기본 신뢰를 위해 투명한 정보 공개가 우선되어야 합니다." }, + { "start_time": 10000, "speaker_name": "존 롤스", "speaker_side": "A", "message": "현명하십니다. 상품의 가치가 전적으로 기만에 의해 결정된다면..." } + ], + "interactive_options": [ + { "label": "최종 충돌 및 정리 듣기", "next_node_id": "node_003_closing" } + ] + }, + { + "node_id": "node_002_branch_b", + "audio_url": "https://cdn.pique.app/audio/battle_001_round2_b.mp3", + "audio_duration": 120, + "scripts": [ + { "start_time": 0, "speaker_name": "유저", "speaker_side": "B", "message": "강요 없는 자발적 거래라면, 욕망에 따른 가격 결정은 시장의 자유입니다." }, + { "start_time": 10000, "speaker_name": "프리드리히 니체", "speaker_side": "B", "message": "역시 가치를 아시는군요! 거래는 예술입니다..." } + ], + "interactive_options": [ + { "label": "최종 충돌 및 정리 듣기", "next_node_id": "node_003_closing" } + ] + }, + { + "node_id": "node_003_closing", + "audio_url": "https://cdn.pique.app/audio/battle_001_round3_closing.mp3", + "audio_duration": 90, + "scripts": [ + { "start_time": 0, "speaker_name": "존 롤스", "speaker_side": "A", "message": "한 가지 묻겠습니다. 당신이 만약 그 가방의 구매자였다면..." }, + { "start_time": 30000, "speaker_name": "프리드리히 니체", "speaker_side": "B", "message": "질문이 틀렸소. 명품을 사는 자들은 이미 그 게임의 규칙을 압니다..." }, + { "start_time": 60000, "speaker_name": "나레이션", "speaker_side": "NONE", "message": "이제 당신의 최종 선택을 들려주세요." } + ], + "interactive_options": [] + } + ] + }, + "error": null +} +``` + +--- + +## 관리자 API + +### `POST /api/v1/admin/scenarios` + +- 공식 시나리오를 직접 생성합니다. 생성 시 TTS API가 자동 호출되어 `.mp3` 파일이 CDN에 업로드됩니다. + +#### Request Body + +```json +{ + "battle_id": "battle_001", + "is_interactive": true, + "nodes": [ + { + "node_name": "node_001_opening", + "is_start_node": true, + "scripts": [ + { "speaker_name": "나레이션", "speaker_side": "NONE", "message": "여기 한 여자가 있습니다. 동대문에서 18만 원에 떼온 가방을 1억 원에 팔았습니다..." }, + { "speaker_name": "존 롤스", "speaker_side": "A", "message": "재판장님, 시장 경제의 핵심은 '정보의 대칭'입니다..." }, + { "speaker_name": "프리드리히 니체", "speaker_side": "B", "message": "명품을 사는 사람이 원가를 몰라서 삽니까?..." } + ], + "interactive_options": [ + { "label": "사회적 신뢰를 위해 정보의 투명성이 우선이다.", "next_node_name": "node_002_branch_a" }, + { "label": "시장은 개인의 욕망이 만나는 곳이다.", "next_node_name": "node_002_branch_b" } + ] + }, + { + "node_name": "node_002_branch_a", + "is_start_node": false, + "scripts": [ + { "speaker_name": "유저", "speaker_side": "A", "message": "사회의 기본 신뢰를 위해 투명한 정보 공개가 우선되어야 합니다." }, + { "speaker_name": "존 롤스", "speaker_side": "A", "message": "현명하십니다. 상품의 가치가 전적으로 기만에 의해 결정된다면..." } + ], + "interactive_options": [ + { "label": "최종 충돌 및 정리 듣기", "next_node_name": "node_003_closing" } + ] + }, + { + "node_name": "node_002_branch_b", + "is_start_node": false, + "scripts": [ + { "speaker_name": "유저", "speaker_side": "B", "message": "강요 없는 자발적 거래라면, 욕망에 따른 가격 결정은 시장의 자유입니다." }, + { "speaker_name": "프리드리히 니체", "speaker_side": "B", "message": "역시 가치를 아시는군요! 거래는 예술입니다..." } + ], + "interactive_options": [ + { "label": "최종 충돌 및 정리 듣기", "next_node_name": "node_003_closing" } + ] + }, + { + "node_name": "node_003_closing", + "is_start_node": false, + "scripts": [ + { "speaker_name": "존 롤스", "speaker_side": "A", "message": "한 가지 묻겠습니다. 당신이 만약 그 가방의 구매자였다면..." }, + { "speaker_name": "프리드리히 니체", "speaker_side": "B", "message": "질문이 틀렸소. 명품을 사는 자들은 이미 그 게임의 규칙을 압니다..." }, + { "speaker_name": "나레이션", "speaker_side": "NONE", "message": "이제 당신의 최종 선택을 들려주세요." } + ], + "interactive_options": [] + } + ] +} +``` + +#### 성공 응답 `201 Created` + +```json +{ + "statusCode": 201, + "data": { + "scenario_id": "scenario_001", + "battle_id": "battle_001", + "is_interactive": true, + "status": "DRAFT", + "creator_type": "ADMIN", + "nodes": [ + { + "node_id": "node_001_opening", + "node_name": "node_001_opening", + "is_start_node": true, + "audio_url": "https://cdn.pique.app/audio/battle_001_round1.mp3", + "audio_duration": 150, + "interactive_options": [ + { "label": "사회적 신뢰를 위해 정보의 투명성이 우선이다.", "next_node_id": "node_002_branch_a" }, + { "label": "시장은 개인의 욕망이 만나는 곳이다.", "next_node_id": "node_002_branch_b" } + ] + }, + { + "node_id": "node_002_branch_a", + "node_name": "node_002_branch_a", + "is_start_node": false, + "audio_url": "https://cdn.pique.app/audio/battle_001_round2_a.mp3", + "audio_duration": 110, + "interactive_options": [ + { "label": "최종 충돌 및 정리 듣기", "next_node_id": "node_003_closing" } + ] + }, + { + "node_id": "node_002_branch_b", + "node_name": "node_002_branch_b", + "is_start_node": false, + "audio_url": "https://cdn.pique.app/audio/battle_001_round2_b.mp3", + "audio_duration": 120, + "interactive_options": [ + { "label": "최종 충돌 및 정리 듣기", "next_node_id": "node_003_closing" } + ] + }, + { + "node_id": "node_003_closing", + "node_name": "node_003_closing", + "is_start_node": false, + "audio_url": "https://cdn.pique.app/audio/battle_001_round3_closing.mp3", + "audio_duration": 90, + "interactive_options": [] + } + ], + "created_at": "2026-03-10T09:00:00Z" + }, + "error": null +} +``` + +--- + +### `PATCH /api/v1/admin/scenarios/{scenario_id}` + +- 시나리오 정보를 수정합니다. 변경할 필드만 포함합니다. + +#### Request Body + +```json +{ + "status": "PUBLISHED" +} +``` + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "scenario_id": "scenario_001", + "battle_id": "battle_001", + "is_interactive": true, + "status": "PUBLISHED", + "creator_type": "ADMIN", + "updated_at": "2026-03-10T10:00:00Z" + }, + "error": null +} +``` + +--- + +### `DELETE /api/v1/admin/scenarios/{scenario_id}` + +- 시나리오를 삭제합니다. + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "success": true, + "deleted_at": "2026-03-10T11:00:00Z" + }, + "error": null +} +``` + +--- + +## `[후순위]` 관리자 AI 검수 API + +- 스케줄러가 자동 생성한 AI 시나리오 초안(`PENDING`)을 관리자가 검수 · 승인 · 반려합니다. + +### `GET /api/v1/admin/ai/scenarios` + +- AI가 생성한 `PENDING` 상태의 시나리오 목록을 조회합니다. + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "items": [ + { + "scenario_id": "scenario_ai_001", + "battle_id": "battle_ai_001", + "is_interactive": true, + "status": "PENDING", + "creator_type": "AI", + "nodes": [ + { + "node_id": "node_ai_001_opening", + "node_name": "node_ai_001_opening", + "is_start_node": true, + "audio_url": "https://cdn.pique.app/audio/battle_ai_001_round1.mp3", + "audio_duration": 140, + "interactive_options": [ + { "label": "AI 생성 선택지 A", "next_node_id": "node_ai_002_branch_a" }, + { "label": "AI 생성 선택지 B", "next_node_id": "node_ai_002_branch_b" } + ] + } + ], + "created_at": "2026-03-11T06:00:00Z" + } + ], + "total_count": 2 + }, + "error": null +} +``` + +--- + +### `PATCH /api/v1/admin/ai/scenarios/{scenario_id}` + +- AI가 생성한 시나리오를 승인하거나 반려합니다. 승인 시 내용을 수정한 뒤 승인할 수 있습니다. + +#### Request Body — 승인 + +```json +{ + "action": "APPROVE", + "nodes": [ + { + "node_id": "node_ai_001_opening", + "scripts": [ + { "speaker_name": "나레이션", "speaker_side": "NONE", "message": "수정된 나레이션 내용..." } + ], + "interactive_options": [ + { "label": "수정된 선택지 A", "next_node_id": "node_ai_002_branch_a" }, + { "label": "수정된 선택지 B", "next_node_id": "node_ai_002_branch_b" } + ] + } + ] +} +``` + +#### Request Body — 반려 + +```json +{ + "action": "REJECT", + "reject_reason": "시나리오 흐름이 부자연스러움" +} +``` + +#### 성공 응답 `200 OK` — 승인 + +```json +{ + "statusCode": 200, + "data": { + "scenario_id": "scenario_ai_001", + "battle_id": "battle_ai_001", + "status": "PUBLISHED", + "creator_type": "AI", + "updated_at": "2026-03-11T09:00:00Z" + }, + "error": null +} +``` + +#### 성공 응답 `200 OK` — 반려 + +```json +{ + "statusCode": 200, + "data": { + "scenario_id": "scenario_ai_001", + "status": "REJECTED", + "reject_reason": "시나리오 흐름이 부자연스러움", + "updated_at": "2026-03-11T09:00:00Z" + }, + "error": null +} +``` + +--- + +## `[후순위]` 크리에이터 API + +### `POST /api/v1/scenarios` + +- 시나리오를 제안합니다. (매너 온도 45도 이상 유저) + +#### Request Body + +```json +{ + "battle_id": "battle_002", + "is_interactive": false, + "nodes": [ + { + "node_name": "node_001_full", + "is_start_node": true, + "scripts": [ + { "speaker_name": "나레이션", "speaker_side": "NONE", "message": "AI가 그린 그림 한 장이 경매에서 1억 원에 낙찰됐습니다..." }, + { "speaker_name": "존 로크", "speaker_side": "A", "message": "노동을 투입한 자에게 소유권이 있습니다. AI 개발사가 권리를 가져야 합니다." }, + { "speaker_name": "루소", "speaker_side": "B", "message": "AI는 인류의 지식을 학습했습니다. 그 결과물은 모두의 것이어야 합니다." } + ], + "interactive_options": [] + } + ] +} +``` + +#### 성공 응답 `201 Created` + +```json +{ + "statusCode": 201, + "data": { + "scenario_id": "scenario_002", + "battle_id": "battle_002", + "is_interactive": false, + "status": "PENDING", + "creator_type": "USER", + "created_at": "2026-03-10T12:00:00Z" + }, + "error": null +} +``` + +--- + +### `PATCH /api/v1/scenarios/{scenario_id}` + +제안한 시나리오를 수정합니다. 변경할 필드만 포함합니다. + +#### Request Body + +```json +{ + "nodes": [ + { + "node_name": "node_001_full", + "is_start_node": true, + "scripts": [ + { "speaker_name": "나레이션", "speaker_side": "NONE", "message": "AI가 그린 그림 한 장이 경매에서 1억 원에 낙찰됐습니다. (수정)" }, + { "speaker_name": "존 로크", "speaker_side": "A", "message": "노동을 투입한 자에게 소유권이 있습니다." }, + { "speaker_name": "루소", "speaker_side": "B", "message": "AI는 인류의 지식을 학습했습니다." } + ], + "interactive_options": [] + } + ] +} +``` + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "scenario_id": "scenario_002", + "battle_id": "battle_002", + "is_interactive": false, + "status": "PENDING", + "creator_type": "USER", + "updated_at": "2026-03-10T13:00:00Z" + }, + "error": null +} +``` + +--- + +### `DELETE /api/v1/scenarios/{scenario_id}` + +- 제안한 시나리오를 삭제합니다. + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "success": true, + "deleted_at": "2026-03-10T14:00:00Z" + }, + "error": null +} +``` + +--- + +## 공통 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `COMMON_INVALID_PARAMETER` | `400` | 요청 파라미터 오류 | +| `COMMON_BAD_REQUEST` | `400` | 잘못된 요청 | +| `AUTH_UNAUTHORIZED` | `401` | 인증 실패 | +| `AUTH_TOKEN_EXPIRED` | `401` | 토큰 만료 | +| `FORBIDDEN_ACCESS` | `403` | 접근 권한 없음 | +| `USER_BANNED` | `403` | 제재된 사용자 | +| `INTERNAL_SERVER_ERROR` | `500` | 서버 오류 | + +--- + +## 시나리오 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `SCENARIO_NOT_FOUND` | `404` | 존재하지 않는 시나리오 | +| `SCENARIO_NODE_NOT_FOUND` | `404` | 존재하지 않는 노드 | +| `SCENARIO_ALREADY_PUBLISHED` | `409` | 이미 발행된 시나리오 | +| `SCENARIO_TTS_FAILED` | `500` | TTS 생성 실패 | + +--- \ No newline at end of file diff --git a/docs/api-specs/tag-api.md b/docs/api-specs/tag-api.md new file mode 100644 index 0000000..e852f17 --- /dev/null +++ b/docs/api-specs/tag-api.md @@ -0,0 +1,188 @@ +# 태그 API 명세서 + +--- + +## 설계 메모 + +- **태그 구조 :** + - 태그는 별도 `TAGS` 테이블로 관리하며, `BATTLE_TAGS` 중간 테이블을 통해 배틀과 N:M 관계를 가집니다. +- **태그 목록 조회 :** + - 관리자가 배틀에 태그를 붙일 때 선택 목록 제공 및 클라이언트 필터 UI 구성에 활용됩니다. +- **태그 기반 배틀 필터링 :** + - `tag_id` 쿼리 파라미터로 특정 태그가 붙은 배틀 목록을 조회합니다. + +--- + +## 사용자 API + +### `GET /api/v1/tags` + +- 전체 태그 목록을 조회합니다. 클라이언트 필터 UI 구성 및 관리자 태그 선택에 활용됩니다. + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "items": [ + { "tag_id": "tag_001", "name": "사회" }, + { "tag_id": "tag_002", "name": "철학" }, + { "tag_id": "tag_003", "name": "롤스" }, + { "tag_id": "tag_004", "name": "니체" }, + { "tag_id": "tag_005", "name": "경제" }, + { "tag_id": "tag_006", "name": "윤리" } + ], + "total_count": 6 + }, + "error": null +} +``` + +--- + +### `GET /api/v1/battles?tag_id={tag_id}` + +- 특정 태그가 붙은 배틀 목록을 조회합니다. + +#### Query Parameters + +| 파라미터 | 타입 | 필수 | 설명 | +|----------|------|:----:|------| +| `tag_id` | string | ✅ | 필터링할 태그 ID | + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "tag": { "tag_id": "tag_002", "name": "철학" }, + "items": [ + { + "battle_id": "battle_001", + "title": "드라마 <레이디 두아>, 원가 18만원 명품은 사기인가?", + "summary": "18만 원짜리 가방을 1억에 판 주인공, 사기꾼일까 예술가일까?", + "thumbnail_url": "https://cdn.pique.app/battle/hot-001.png", + "tags": [ + { "tag_id": "tag_001", "name": "사회" }, + { "tag_id": "tag_002", "name": "철학" } + ], + "participants_count": 2148, + "audio_duration": 420, + "options": [ + { "option_id": "option_A", "label": "A", "title": "사기다 (롤스)" }, + { "option_id": "option_B", "label": "B", "title": "사기가 아니다 (니체)" } + ], + "user_vote_status": "NONE" + } + ], + "total_count": 1 + }, + "error": null +} +``` + +--- + +## 관리자 API + +### `POST /api/v1/admin/tags` + +- 새 태그를 생성합니다. + +#### Request Body + +```json +{ + "name": "정치" +} +``` + +#### 성공 응답 `201 Created` + +```json +{ + "statusCode": 201, + "data": { + "tag_id": "tag_007", + "name": "정치", + "created_at": "2026-03-10T09:00:00Z" + }, + "error": null +} +``` + +--- + +### `PATCH /api/v1/admin/tags/{tag_id}` + +- 태그명을 수정합니다. + +#### Request Body + +```json +{ + "name": "사회" +} +``` + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "tag_id": "tag_007", + "name": "사회", + "updated_at": "2026-03-10T10:00:00Z" + }, + "error": null +} +``` + +--- + +### `DELETE /api/v1/admin/tags/{tag_id}` + +- 태그를 삭제합니다. 연결된 `BATTLE_TAGS` 레코드도 함께 삭제됩니다. + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "success": true, + "deleted_at": "2026-03-10T11:00:00Z" + }, + "error": null +} +``` + +--- + +## 공통 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `COMMON_INVALID_PARAMETER` | `400` | 요청 파라미터 오류 | +| `COMMON_BAD_REQUEST` | `400` | 잘못된 요청 | +| `AUTH_UNAUTHORIZED` | `401` | 인증 실패 | +| `AUTH_TOKEN_EXPIRED` | `401` | 토큰 만료 | +| `FORBIDDEN_ACCESS` | `403` | 접근 권한 없음 | +| `USER_BANNED` | `403` | 제재된 사용자 | +| `INTERNAL_SERVER_ERROR` | `500` | 서버 오류 | + +--- + +## 태그 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `TAG_NOT_FOUND` | `404` | 존재하지 않는 태그 | +| `TAG_ALREADY_EXISTS` | `409` | 이미 존재하는 태그명 | +| `TAG_IN_USE` | `409` | 배틀에 사용 중인 태그 (삭제 불가) | +| `TAG_LIMIT_EXCEEDED` | `400` | 배틀당 태그 최대 개수 초과 | + +--- \ No newline at end of file diff --git a/docs/api-specs/vote-api.md b/docs/api-specs/vote-api.md new file mode 100644 index 0000000..cef1e19 --- /dev/null +++ b/docs/api-specs/vote-api.md @@ -0,0 +1,153 @@ +# 투표 API 명세서 + +--- + +## 설계 메모 + +- **사전/사후 투표 단일 레코드 :** + - 사전 투표와 사후 투표는 `VOTES` 테이블의 단일 레코드로 관리됩니다. `status` 필드(`NONE` → `PRE_VOTED` → `POST_VOTED`)로 진행 단계를 추적합니다. +- **투표 수정 :** + - 투표 입장 변경은 `PATCH` 메서드를 사용합니다. `vote_type` 필드로 사전/사후 구분합니다. +- **사후 투표 응답 :** + - 사후 투표 완료 시 `mind_changed` 여부와 전체 통계, 리워드 정보를 함께 반환합니다. + +--- + +## 사용자 API + +### `POST /api/v1/battles/{battle_id}/votes/pre` + +- 시나리오 청취 전 사전 투표를 진행합니다. + +#### Request Body + +```json +{ + "option_id": "option_A" +} +``` + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "vote_id": "vote_001", + "status": "PRE_VOTED", + "next_step_url": "/battles/battle_001/scenario" + }, + "error": null +} +``` + +--- + +### `POST /api/v1/battles/{battle_id}/votes/post` + +- 시나리오 청취 후 최종 사후 투표를 진행합니다. 완료 시 결과 통계와 리워드를 함께 반환합니다. + +#### Request Body + +```json +{ + "option_id": "option_A" +} +``` + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "vote_id": "vote_001", + "mind_changed": false, + "status": "POST_VOTED", + "statistics": { + "option_A_ratio": 65, + "option_B_ratio": 35 + }, + "reward": { + "is_majority": true, + "credits_earned": 10 + }, + "updated_at": "2026-03-10T16:35:00Z" + }, + "error": null +} +``` + +--- + +### `PATCH /api/v1/battles/{battle_id}/votes` + +- 기존 투표 입장을 변경합니다. `vote_type`으로 사전/사후 투표를 구분합니다. + +#### Request Body + +```json +{ + "vote_type": "PRE", + "option_id": "option_B" +} +``` + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "vote_id": "vote_001", + "updated_at": "2026-03-10T16:40:00Z" + }, + "error": null +} +``` + +--- + +### `DELETE /api/v1/battles/{battle_id}/votes` + +- 투표 이력을 취소 및 삭제합니다. + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "success": true, + "deleted_at": "2026-03-10T16:45:00Z" + }, + "error": null +} +``` + +--- + +## 공통 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `COMMON_INVALID_PARAMETER` | `400` | 요청 파라미터 오류 | +| `COMMON_BAD_REQUEST` | `400` | 잘못된 요청 | +| `AUTH_UNAUTHORIZED` | `401` | 인증 실패 | +| `AUTH_TOKEN_EXPIRED` | `401` | 토큰 만료 | +| `FORBIDDEN_ACCESS` | `403` | 접근 권한 없음 | +| `USER_BANNED` | `403` | 제재된 사용자 | +| `INTERNAL_SERVER_ERROR` | `500` | 서버 오류 | + +--- + +## 투표 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `VOTE_NOT_FOUND` | `404` | 존재하지 않는 투표 | +| `VOTE_ALREADY_SUBMITTED` | `409` | 이미 투표 완료 | +| `PRE_VOTE_REQUIRED` | `409` | 사전 투표 필요 | +| `POST_VOTE_REQUIRED` | `409` | 사후 투표 필요 | + +--- \ No newline at end of file diff --git a/docs/erd/battle.puml b/docs/erd/battle.puml new file mode 100644 index 0000000..1da3dc3 --- /dev/null +++ b/docs/erd/battle.puml @@ -0,0 +1,89 @@ +@startuml battle +hide circle +hide methods +skinparam linetype ortho + +' ─────────────────────────────── +' 테이블 정의 +' ─────────────────────────────── + +entity "users\n사용자" as users { + * id : BIGINT <> + -- + email : VARCHAR(255) <> + nickname : VARCHAR(50) <> + character_id : INT <> + role : ENUM('USER', 'ADMIN') + status : ENUM('PENDING', 'ACTIVE', 'DELETED', 'BANNED') + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + +entity "BATTLES\n배틀(주제)" as battles { + * id : UUID <> + -- + title : VARCHAR(255) + summary : VARCHAR(500) + description : TEXT + thumbnail_url : VARCHAR(500) + target_date : DATE + status : ENUM('DRAFT', 'PENDING', 'PUBLISHED', 'REJECTED', 'ARCHIVED') + creator_type : ENUM('ADMIN', 'USER', 'AI') + creator_id : BIGINT <> (nullable) + reject_reason : VARCHAR(500) (nullable) + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + +entity "BATTLE_OPTIONS\n선택지" as battle_options { + * id : UUID <> + -- + battle_id : UUID <> + label : ENUM('A', 'B') + title : VARCHAR(100) + stance : VARCHAR(255) + representative : VARCHAR(100) + quote : TEXT + keywords : JSONB + image_url : VARCHAR(500) +} + +' ─────────────────────────────── +' 배치 가이드 (위→아래) +' ─────────────────────────────── + +users -[hidden]down- battles +battles -[hidden]down- battle_options + +' ─────────────────────────────── +' 관계 +' ─────────────────────────────── + +users ||--o{ battles : "creates" +battles ||--o{ battle_options : "has" + +' ─────────────────────────────── +' 노트 +' ─────────────────────────────── + +note right of battles + status 흐름: + + [관리자 직접 발행] + DRAFT → PUBLISHED → ARCHIVED + + [AI 자동 생성 · 스케줄러 - 후순위] + PENDING → PUBLISHED → ARCHIVED + → REJECTED + + [유저 크리에이터 - 후순위] + PENDING → PUBLISHED → ARCHIVED + → REJECTED + + creator_type + ADMIN : 관리자 직접 발행 → creator_id = null + AI : [후순위] 스케줄러 자동 생성 → creator_id = null + USER : [후순위] 유저 제안 → creator_id = users.id +end note + +@enduml diff --git a/docs/erd/scenario.puml b/docs/erd/scenario.puml new file mode 100644 index 0000000..be674e6 --- /dev/null +++ b/docs/erd/scenario.puml @@ -0,0 +1,127 @@ +@startuml scenario +hide circle +hide methods +skinparam linetype ortho + +' ─────────────────────────────── +' 테이블 정의 +' ─────────────────────────────── + +entity "users\n사용자" as users { + * id : BIGINT <> + -- + email : VARCHAR(255) <> + nickname : VARCHAR(50) <> + character_id : INT <> + role : ENUM('USER', 'ADMIN') + status : ENUM('PENDING', 'ACTIVE', 'DELETED', 'BANNED') + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + +entity "BATTLES\n배틀(주제)" as battles { + * id : UUID <> + -- + title : VARCHAR(255) + summary : VARCHAR(500) + description : TEXT + thumbnail_url : VARCHAR(500) + target_date : DATE + status : ENUM('DRAFT', 'PENDING', 'PUBLISHED', 'REJECTED', 'ARCHIVED') + creator_type : ENUM('ADMIN', 'USER', 'AI') + creator_id : BIGINT <> (nullable) + reject_reason : TEXT (nullable) + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + + +entity "SCENARIOS\n시나리오 마스터" as scenarios { + * id : UUID <> + -- + battle_id : UUID <> + creator_type : ENUM('ADMIN', 'USER', 'AI') + creator_id : BIGINT <> (nullable) + is_interactive : BOOLEAN + status : ENUM('DRAFT', 'PENDING', 'PUBLISHED', 'REJECTED', 'ARCHIVED') + reject_reason : VARCHAR(500) (nullable) + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + +entity "SCENARIO_NODES\n시나리오 노드 (오디오/분기 통합)" as scenario_nodes { + * id : UUID <> + -- + scenario_id : UUID <> + node_name : VARCHAR(100) + audio_url : VARCHAR(500) + audio_duration : INT + is_start_node : BOOLEAN + interactive_options : JSONB +} + +entity "SCENARIO_SCRIPTS\n대본(말풍선)" as scenario_scripts { + * id : UUID <> + -- + node_id : UUID <> + start_time : INT + speaker_name : VARCHAR(100) + speaker_side : ENUM('A', 'B', 'NONE') + message : TEXT +} + +' ─────────────────────────────── +' 배치 가이드 (위→아래) +' ─────────────────────────────── + +users -[hidden]down- battles +battles -[hidden]down- scenarios +scenarios -[hidden]down- scenario_nodes +scenario_nodes -[hidden]down- scenario_scripts + +' ─────────────────────────────── +' 관계 +' ─────────────────────────────── + +users ||--o{ scenarios : "creates" +battles ||--|| scenarios : "has" +scenarios ||--o{ scenario_nodes : "contains" +scenario_nodes ||--o{ scenario_scripts : "contains" + +' ─────────────────────────────── +' 노트 +' ─────────────────────────────── + +note right of scenarios + status 흐름: + + [관리자 직접 발행] + DRAFT → PUBLISHED → ARCHIVED + + [AI 자동 생성 · 스케줄러 - 후순위] + PENDING → PUBLISHED → ARCHIVED + → REJECTED + + [유저 크리에이터 - 후순위] + PENDING → PUBLISHED → ARCHIVED + → REJECTED + + is_interactive = false : + 노드 1개, interactive_options = [] + + is_interactive = true : + 오프닝 → 분기(A/B) → 클로징 + interactive_options = [ + { label, next_node_id } + ] + + PUBLISHED 전환 시 + TTS 생성 + CDN 업로드 자동 연동 + + creator_type + ADMIN : 관리자 직접 발행 → creator_id = null + AI : [후순위] 스케줄러 자동 생성 → creator_id = null + USER : [후순위] 유저 제안 → creator_id = users.id +end note + +@enduml diff --git a/docs/erd/tag.puml b/docs/erd/tag.puml new file mode 100644 index 0000000..bc57d86 --- /dev/null +++ b/docs/erd/tag.puml @@ -0,0 +1,61 @@ +@startuml tag +hide circle +hide methods +skinparam linetype ortho + +' ─────────────────────────────── +' 테이블 정의 +' ─────────────────────────────── + +entity "BATTLES\n배틀(주제)" as battles { + * id : UUID <> + -- + title : VARCHAR(255) + summary : VARCHAR(500) + description : TEXT + thumbnail_url : VARCHAR(500) + target_date : DATE + status : ENUM('DRAFT', 'PENDING', 'PUBLISHED', 'REJECTED', 'ARCHIVED') + creator_type : ENUM('ADMIN', 'USER', 'AI') + creator_id : BIGINT <> (nullable) + reject_reason : VARCHAR(500) (nullable) + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + +entity "TAGS\n태그" as tags { + * id : UUID <> + -- + name : VARCHAR(50) <> + created_at : TIMESTAMP +} + +entity "BATTLE_TAGS\n배틀-태그 매핑" as battle_tags { + * battle_id : UUID <> + * tag_id : UUID <> +} + +' ─────────────────────────────── +' 배치 가이드 (좌→우→아래) +' ─────────────────────────────── + +battles -[hidden]right- tags +tags -[hidden]down- battle_tags + +' ─────────────────────────────── +' 관계 +' ─────────────────────────────── + +battles ||--o{ battle_tags : "tagged with" +tags ||--o{ battle_tags : "used in" + +' ─────────────────────────────── +' 노트 +' ─────────────────────────────── + +note bottom of battle_tags + 복합 PK: (battle_id, tag_id) + 배틀과 태그의 N:M 관계를 처리하는 중간 테이블 +end note + +@enduml diff --git a/docs/erd/vote.puml b/docs/erd/vote.puml new file mode 100644 index 0000000..44defaa --- /dev/null +++ b/docs/erd/vote.puml @@ -0,0 +1,101 @@ +@startuml vote +hide circle +hide methods +skinparam linetype ortho + +' ─────────────────────────────── +' 테이블 정의 +' ─────────────────────────────── + +entity "users\n사용자" as users { + * id : BIGINT <> + -- + email : VARCHAR(255) <> + nickname : VARCHAR(50) <> + character_id : INT <> + role : ENUM('USER', 'ADMIN') + status : ENUM('PENDING', 'ACTIVE', 'DELETED', 'BANNED') + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + +entity "BATTLES\n배틀(주제)" as battles { + * id : UUID <> + -- + title : VARCHAR(255) + summary : VARCHAR(500) + description : TEXT + thumbnail_url : VARCHAR(500) + target_date : DATE + status : ENUM('DRAFT', 'PENDING', 'PUBLISHED', 'REJECTED', 'ARCHIVED') + creator_type : ENUM('ADMIN', 'USER', 'AI') + creator_id : BIGINT <> (nullable) + reject_reason : VARCHAR(500) (nullable) + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + +entity "BATTLE_OPTIONS\n선택지" as battle_options { + * id : UUID <> + -- + battle_id : UUID <> + label : ENUM('A', 'B') + title : VARCHAR(100) + stance : VARCHAR(255) + representative : VARCHAR(100) + quote : TEXT + image_url : VARCHAR(500) +} + +entity "VOTES\n투표 이력" as votes { + * id : UUID <> + -- + user_id : BIGINT <> + battle_id : UUID <> + pre_vote_option_id : UUID <> (nullable) + post_vote_option_id : UUID <> (nullable) + mind_changed : BOOLEAN + reward_credits : INT + status : ENUM('NONE', 'PRE_VOTED', 'POST_VOTED') + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + +' ─────────────────────────────── +' 배치 가이드 +' users battles +' \ | +' votes battle_options +' ─────────────────────────────── + +users -[hidden]right- battles +battles -[hidden]down- battle_options +users -[hidden]down- votes +votes -[hidden]right- battle_options + +' ─────────────────────────────── +' 관계 +' ─────────────────────────────── + +users ||--o{ votes : "votes" +battles ||--o{ battle_options : "has" +battles ||--o{ votes : "receives" +votes }o--|| battle_options : "pre_vote" +votes }o--|| battle_options : "post_vote" + +' ─────────────────────────────── +' 노트 +' ─────────────────────────────── + +note right of votes + status 흐름: + NONE → PRE_VOTED → POST_VOTED + + pre_vote_option_id : 사전 투표 선택지 (nullable) + post_vote_option_id : 사후 투표 선택지 (nullable) + + mind_changed: + pre_vote_option_id ≠ post_vote_option_id 이면 true +end note + +@enduml From 6e83da85b795f5552ec4e5a97a9ec0cc577f4520 Mon Sep 17 00:00:00 2001 From: Dante0922 <101305519+Dante0922@users.noreply.github.com> Date: Thu, 12 Mar 2026 01:53:09 +0900 Subject: [PATCH 04/70] =?UTF-8?q?#8=20[Docs]=20user/oauth=20ERD=20?= =?UTF-8?q?=EB=B0=8F=20API=20=EB=AA=85=EC=84=B8=20=EC=A0=95=EB=A6=AC=20(#9?= =?UTF-8?q?)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - user / oauth2 ERD 경계 및 필드 구조 재정리 - user 운영성 상세 ERD 분리 - user API 명세를 기준으로 oauth API 명세 통일 - 공개 식별자 `user_tag`, 프로필 필드, 토큰 사용 흐름 반영 - 문서 간 상충되던 user / oauth 명세 정합성 수정 --- docs/api-specs/oauth-api.md | 302 +++++++++++++++++------------------- docs/api-specs/user-api.md | 66 ++++++-- docs/erd/oauth2.puml | 77 ++++----- docs/erd/user-ops.puml | 63 ++++++++ docs/erd/user.puml | 92 +++++------ 5 files changed, 328 insertions(+), 272 deletions(-) create mode 100644 docs/erd/user-ops.puml diff --git a/docs/api-specs/oauth-api.md b/docs/api-specs/oauth-api.md index 6117889..d947226 100644 --- a/docs/api-specs/oauth-api.md +++ b/docs/api-specs/oauth-api.md @@ -1,214 +1,202 @@ -# 🔐 PIQUE 사용자 인증 및 온보딩 API 통합 명세서 +# OAuth API 명세서 ## 1. 설계 메모 -* **인증 방식**: OAuth 2.0 인가 코드 방식을 사용하며, 서비스 자체 JWT(Access/Refresh)를 발급합니다. -* **온보딩 흐름**: 로그인 응답의 `isNewUser`가 `true`일 경우, `bootstrap` 데이터를 조회한 뒤 `profile` 생성 API를 호출합니다. -* **상태 전환**: 프로필 생성이 완료되면 유저 상태(`status`)는 `PENDING`에서 `ACTIVE`로 변경됩니다. -* **재화 관리**: 유저 지갑(`userWallet`)은 별도 테이블로 관리하며 프로필 설정 완료 시 함께 조회됩니다. -* **응답 규격**: 모든 응답은 `statusCode`, `data`, `error` 필드를 포함하는 공통 포맷을 준수합니다. + +- OAuth API는 `snake_case` 필드명을 기준으로 합니다. +- 소셜 로그인은 OAuth 2.0 인가 코드 방식을 사용합니다. +- 로그인 성공 시 서비스 자체 `access_token`, `refresh_token`을 발급합니다. +- 사용자 프로필 생성 및 온보딩 상세 명세는 `user-api.md`를 기준으로 합니다. +- 외부 응답에서는 내부 PK인 `user_id`를 노출하지 않고 `user_tag`를 사용합니다. + +### 1.1 공통 요청 헤더 + +- `Content-Type: application/json` + - JSON 요청 바디가 있는 API에 사용합니다. +- `Authorization: Bearer {access_token}` + - 로그인 이후 인증이 필요한 API에 사용합니다. +- `X-Refresh-Token: {refresh_token}` + - Access Token 재발급 API에 사용합니다. + +### 1.2 토큰 사용 방식 + +로그인 성공 후 클라이언트는 `access_token`, `refresh_token`을 발급받습니다. + +- `access_token` + - 이후 인증이 필요한 API 호출 시 `Authorization: Bearer {access_token}` 헤더로 전달합니다. + - 예: `GET /api/v1/me/profile`, `PATCH /api/v1/me/settings`, `DELETE /api/v1/me` +- `refresh_token` + - API가 `401`과 `auth_access_token_expired`를 반환했을 때 `POST /api/v1/auth/refresh` 에서 사용합니다. + - `X-Refresh-Token: {refresh_token}` 헤더로 전달합니다. +- Access Token 만료 안내 + - 인증이 필요한 API는 Access Token이 만료되면 `401 Unauthorized`를 반환합니다. + - 에러 코드가 `auth_access_token_expired` 이면 클라이언트는 Refresh API를 호출해야 합니다. + - Refresh 성공 후 실패했던 요청을 새 `access_token`으로 1회 재시도합니다. +- Refresh Token 만료 안내 + - Refresh API가 `401`과 `auth_refresh_token_expired`를 반환하면 재로그인이 필요합니다. +- 재발급 성공 시 + - 새 `access_token`, 새 `refresh_token`으로 교체합니다. + - 이후 요청에는 기존 토큰 대신 새 토큰을 사용합니다. +- 로그아웃 시 + - `POST /api/v1/auth/logout` 호출 후 클라이언트에 저장된 토큰을 삭제합니다. +- 회원 탈퇴 시 + - `DELETE /api/v1/me` 호출 후 클라이언트에 저장된 토큰을 삭제합니다. + +신규 사용자 흐름: + +1. `POST /api/v1/auth/login/{provider}` 호출 +2. 응답에서 `is_new_user = true` 확인 +3. 발급받은 `access_token`으로 온보딩 API 호출 +4. `POST /api/v1/onboarding/profile` 완료 후 일반 사용자 API 사용 + +기존 사용자 흐름: + +1. `POST /api/v1/auth/login/{provider}` 호출 +2. 응답에서 `is_new_user = false` 확인 +3. 발급받은 `access_token`으로 바로 사용자 API 호출 --- -## 2. API 상세 내역 +## 2. 인증 API -### 2.1 소셜 로그인 및 회원가입 -* **Endpoint**: `POST /api/v1/auth/login/{provider}` -* **설명**: 소셜 인가 코드를 이용해 로그인 및 계정을 생성합니다. 상태가 `BANNED`인 유저는 403을 반환합니다. -* **요청 바디**: -```json -{ - "authorizationCode": "string", - "redirectUri": "string" -} -``` -* **성공 응답**: -```json -{ - "statusCode": 200, - "data": { - "accessToken": "eyJhbGciOiJIUzI...", - "refreshToken": "def456-ghi789...", - "userId": 105, - "isNewUser": true, - "status": "PENDING" - }, - "error": null -} -``` +### 2.1 `POST /api/v1/auth/login/{provider}` -### 2.2 온보딩 초기 데이터 조회 -* **Endpoint**: `GET /api/v1/onboarding/bootstrap` -* **설명**: 첫 로그인 화면 진입 시 필요한 랜덤 닉네임과 캐릭터 옵션을 조회합니다. -* **성공 응답**: -```json -{ - "statusCode": 200, - "data": { - "randomNickname": "생각하는올빼미", - "characterOptions": [ - { "id": 1, "name": "올빼미", "imageUrl": "https://..." }, - { "id": 2, "name": "여우", "imageUrl": "https://..." } - ] - }, - "error": null -} -``` +소셜 인가 코드를 이용해 로그인 및 계정을 생성합니다. + +- `{provider}`: `kakao`, `google` +- 상태가 `BANNED`인 사용자는 `403`을 반환합니다. +- 신규 사용자는 `status = PENDING`, `is_new_user = true` 상태로 응답합니다. + +요청: -### 2.3 초기 프로필 설정 (가입 완료) -* **Endpoint**: `POST /api/v1/onboarding/profile` -* **설명**: 신규 유저의 닉네임과 캐릭터를 설정하여 정식 회원으로 전환합니다. -* **요청 바디**: ```json { - "nickname": "생각하는올빼미", - "characterId": 1 + "authorization_code": "string", + "redirect_uri": "string" } ``` -* **성공 응답**: + +요청 헤더: + +- `Content-Type: application/json` + +응답: + ```json { - "statusCode": 200, - "data": { - "userId": 105, - "nickname": "생각하는올빼미", - "characterId": 1, - "userWallet": { - "credit": 500, - "updatedAt": "2026-03-08T12:00:00Z" - }, - "status": "ACTIVE", - "onboardingCompleted": true - }, - "error": null + "access_token": "eyJhbGciOiJIUzI...", + "refresh_token": "def456-ghi789...", + "user_tag": "sfit4-2", + "is_new_user": true, + "status": "PENDING" } ``` -### 2.4 토큰 재발급 -* **Endpoint**: `POST /api/v1/auth/refresh` -* **설명**: 만료된 Access Token을 Refresh Token을 사용하여 재발급합니다. -* **요청 헤더**: `X-Refresh-Token: {refreshToken}` -* **성공 응답**: +### 2.2 `POST /api/v1/auth/refresh` + +만료된 Access Token을 Refresh Token으로 재발급합니다. + +요청 헤더: + +- `Content-Type: application/json` +- `X-Refresh-Token: {refresh_token}` + +응답: + ```json { - "statusCode": 200, - "data": { - "accessToken": "new_eyJhbGciOiJIUzI...", - "refreshToken": "new_def456-ghi789..." - }, - "error": null + "access_token": "new_eyJhbGciOiJIUzI...", + "refresh_token": "new_def456-ghi789..." } ``` -### 2.5 로그아웃 -* **Endpoint**: `POST /api/v1/auth/logout` -* **설명**: 현재 로그인된 사용자의 Refresh Token을 삭제하여 로그아웃 처리합니다. -* **요청 헤더**: `Authorization: Bearer {accessToken}` -* **성공 응답**: +### 2.3 `POST /api/v1/auth/logout` + +현재 로그인된 사용자의 Refresh Token을 삭제하여 로그아웃 처리합니다. + +요청 헤더: + +- `Content-Type: application/json` +- `Authorization: Bearer {access_token}` + +응답: + ```json { - "statusCode": 200, - "data": { - "loggedOut": true - }, - "error": null + "logged_out": true } ``` -### 2.6 회원 탈퇴 -* **Endpoint**: `DELETE /api/v1/me` -* **설명**: 현재 로그인된 사용자의 계정을 삭제합니다. `users`, `user_socials`, `refresh_tokens`, `user_wallets`, `credit_histories` 연관 데이터를 함께 처리합니다. -* **요청 헤더**: `Authorization: Bearer {accessToken}` -* **성공 응답**: +### 2.4 `DELETE /api/v1/me` + +현재 로그인된 사용자의 계정을 탈퇴 처리합니다. + +- `users`, `user_social_accounts`, `auth_refresh_tokens` 연관 데이터를 함께 처리합니다. +- 사용자 도메인 상세 정리는 `user` 정책에 따라 함께 처리합니다. + +요청 헤더: + +- `Authorization: Bearer {access_token}` + +응답: + ```json { - "statusCode": 200, - "data": { - "withdrawn": true - }, - "error": null + "withdrawn": true } ``` --- -## 3. 예외 응답 (공통) +## 3. 인증 예외 응답 -### 3.1 요청 파라미터 오류 (400) -```json -{ - "statusCode": 400, - "data": null, - "error": { - "code": "COMMON_INVALID_PARAMETER", - "message": "요청 파라미터가 잘못되었습니다.", - "errors": [ - { - "field": "nickname", - "value": "홍길동!", - "reason": "특수문자는 포함할 수 없습니다." - } - ] - } -} -``` +### 3.1 잘못된 요청 (400) -### 3.2 인증 오류 (401) ```json { - "statusCode": 401, - "data": null, - "error": { - "code": "AUTH_INVALID_CODE", - "message": "유효하지 않은 소셜 인가 코드입니다.", - "errors": [] - } + "code": "common_invalid_parameter", + "message": "요청 파라미터가 잘못되었습니다.", + "errors": [ + { + "field": "redirect_uri", + "value": "", + "reason": "redirect_uri 는 필수입니다." + } + ] } ``` + +### 3.2 인증 실패 (401) + ```json { - "statusCode": 401, - "data": null, - "error": { - "code": "AUTH_TOKEN_EXPIRED", - "message": "만료되었거나 유효하지 않은 Refresh Token입니다.", - "errors": [] - } + "code": "auth_invalid_code", + "message": "유효하지 않은 소셜 인가 코드입니다.", + "errors": [] } ``` -### 3.3 중복 오류 (409) ```json { - "statusCode": 409, - "data": null, - "error": { - "code": "USER_NICKNAME_DUPLICATE", - "message": "이미 사용 중인 닉네임입니다.", - "errors": [] - } + "code": "auth_access_token_expired", + "message": "Access Token이 만료되었습니다. Refresh Token으로 재발급이 필요합니다.", + "errors": [] } ``` + ```json { - "statusCode": 409, - "data": null, - "error": { - "code": "ONBOARDING_ALREADY_COMPLETED", - "message": "이미 온보딩이 완료된 사용자입니다.", - "errors": [] - } + "code": "auth_refresh_token_expired", + "message": "Refresh Token이 만료되었거나 유효하지 않습니다. 다시 로그인이 필요합니다.", + "errors": [] } ``` -### 3.4 접근 거부 오류 (403) +### 3.3 접근 거부 (403) + ```json { - "statusCode": 403, - "data": null, - "error": { - "code": "USER_BANNED", - "message": "제재된 사용자입니다.", - "errors": [] - } + "code": "user_banned", + "message": "제재된 사용자입니다.", + "errors": [] } -``` \ No newline at end of file +``` diff --git a/docs/api-specs/user-api.md b/docs/api-specs/user-api.md index b22e74d..be8d36f 100644 --- a/docs/api-specs/user-api.md +++ b/docs/api-specs/user-api.md @@ -2,37 +2,42 @@ ## 1. 설계 메모 -- 첫 로그인 시 닉네임 랜덤 생성과 이모지 선택이 필요합니다. +- 사용자 API는 `snake_case` 필드명을 기준으로 합니다. +- 외부 응답에서는 내부 PK인 `user_id`를 노출하지 않고 `user_tag`를 사용합니다. +- `nickname`은 중복 허용 프로필명입니다. +- `user_tag`는 고유한 공개 식별자이며 저장 시 `@` 없이 관리합니다. +- 프로필 아바타는 자유 입력 이모지가 아니라 `character_type` 선택 방식으로 관리합니다. +- `character_type`은 소문자 `snake_case` 문자열 값으로 관리합니다. - 프로필, 설정, 성향 점수는 모두 사용자 도메인 책임입니다. - 성향 점수는 현재값을 갱신하면서 이력도 함께 적재합니다. --- -## 2. 첫 로그인 API +## 2. 첫 로그인 / 온보딩 API ### 2.1 `GET /api/v1/onboarding/bootstrap` 첫 로그인 화면 진입 시 필요한 초기 데이터 조회. +이모지는 8개 뿐이라 앱에서 관리하는 버전입니다. 응답: ```json { - "random_nickname": "생각하는올빼미", - "emoji_options": ["🦊", "🦉", "🐱", "🐻", "🐰", "🦁", "🐸", "🐧"] + "random_nickname": "생각하는올빼미" } ``` ### 2.2 `POST /api/v1/onboarding/profile` 첫 로그인 시 프로필 생성. - +owl, wolf, lion 등은 추후 디자인에 따라 정의 요청: ```json { "nickname": "생각하는올빼미", - "avatar_emoji": "🦉" + "character_type": "owl" } ``` @@ -40,10 +45,11 @@ ```json { - "user_id": "user_001", + "user_tag": "sfit4-2", "nickname": "생각하는올빼미", - "avatar_emoji": "🦉", + "character_type": "owl", "manner_temperature": 36.5, + "status": "ACTIVE", "onboarding_completed": true } ``` @@ -52,16 +58,47 @@ ## 3. 프로필 API -### 3.1 `PATCH /api/v1/me/profile` +### 3.1 `GET /api/v1/users/{user_tag}` + +공개 사용자 프로필 조회. + +응답: + +```json +{ + "user_tag": "sfit4-2", + "nickname": "생각하는올빼미", + "character_type": "owl", + "manner_temperature": 36.5 +} +``` + +### 3.2 `GET /api/v1/me/profile` + +내 프로필 조회. + +응답: + +```json +{ + "user_tag": "sfit4-2", + "nickname": "생각하는올빼미", + "character_type": "owl", + "manner_temperature": 36.5, + "updated_at": "2026-03-08T12:00:00Z" +} +``` + +### 3.3 `PATCH /api/v1/me/profile` -닉네임 및 아바타 수정. +닉네임 및 캐릭터 수정. 요청: ```json { "nickname": "생각하는펭귄", - "avatar_emoji": "🐧" + "character_type": "penguin" } ``` @@ -69,9 +106,9 @@ ```json { - "user_id": "user_001", + "user_tag": "sfit4-2", "nickname": "생각하는펭귄", - "avatar_emoji": "🐧", + "character_type": "penguin", "updated_at": "2026-03-08T12:00:00Z" } ``` @@ -123,6 +160,7 @@ ### 5.1 `PUT /api/v1/me/tendency-scores` 최신 성향 점수 수정 및 이력 저장. +!!! 기획 확정에 따라 필드명 및 규칙 변경될 예정 요청: @@ -141,7 +179,7 @@ ```json { - "user_id": "user_001", + "user_tag": "sfit4-2", "score_1": 30, "score_2": -20, "score_3": 55, diff --git a/docs/erd/oauth2.puml b/docs/erd/oauth2.puml index bd04b80..1213f84 100644 --- a/docs/erd/oauth2.puml +++ b/docs/erd/oauth2.puml @@ -2,77 +2,54 @@ !theme plain skinparam Linetype ortho -' 1. 사용자 기본 테이블 +' 1. 서비스 사용자 참조 entity "users" { * id : BIGINT <> -- - email : VARCHAR(255) <> - nickname : VARCHAR(50) <> - character_id : INT <> - role : ENUM('USER', 'ADMIN') + user_tag : VARCHAR(30) <> status : ENUM('PENDING', 'ACTIVE', 'DELETED', 'BANNED') created_at : TIMESTAMP updated_at : TIMESTAMP } ' 2. OAuth 연동 정보 테이블 -' [논의 필요] access_token, refresh_token 암호화 저장 여부 검토 필요 -entity "user_socials" { +' 소셜 공급자 식별자는 users 와 분리한다. +entity "user_social_accounts" { * id : BIGINT <> -- user_id : BIGINT <> provider : ENUM('KAKAO', 'GOOGLE', 'APPLE') provider_user_id : VARCHAR(255) - access_token : TEXT - refresh_token : TEXT + provider_email : VARCHAR(255) (nullable) + linked_at : TIMESTAMP + last_login_at : TIMESTAMP } -' 3. 선택 가능한 캐릭터 정보 테이블 -entity "characters" { - * id : INT <> - -- - name : VARCHAR(50) - image_url : VARCHAR(255) - description : VARCHAR(255) -} - -' 4. 서비스 자체 인증 토큰 관리 -' [논의 필요] 현재는 재발급 시 기존 토큰 삭제 방식 사용 -' 토큰 탈취 감지가 필요하다면 is_revoked : BOOLEAN DEFAULT false 추가 검토 -entity "refresh_tokens" { +' 3. 서비스 자체 세션(Refresh Token) 관리 +' raw token 대신 token_hash 저장을 기본 전제로 둔다. +entity "auth_refresh_tokens" { * id : BIGINT <> -- user_id : BIGINT <> - token_value : TEXT - expired_at : TIMESTAMP - ' is_revoked : BOOLEAN DEFAULT false -} - -' 5. 지갑 테이블 -entity "user_wallets" { - * id : BIGINT <> - -- - user_id : BIGINT <> - credit : INT DEFAULT 0 - updated_at : TIMESTAMP -} - -' 6. 크레딧 변동 이력 테이블 -entity "credit_histories" { - * id : BIGINT <> - -- - user_id : BIGINT <> - amount : INT -- 변동된 크레딧 양 - type : ENUM('CHARGE', 'USE', 'EVENT', 'REFUND') - description : VARCHAR(255) + token_hash : VARCHAR(255) + expires_at : TIMESTAMP + revoked_at : TIMESTAMP (nullable) + last_used_at : TIMESTAMP created_at : TIMESTAMP } ' 관계 설정 -users }|--|| characters : "선택한 캐릭터" -users ||--o{ user_socials : "소셜 연동" -users ||--o{ refresh_tokens : "인증 관리" -users ||--|| user_wallets : "보유 크레딧" -users ||--o{ credit_histories : "이력 기록" +users ||--o{ user_social_accounts : "소셜 연동" +users ||--o{ auth_refresh_tokens : "서비스 세션" + +note right of user_social_accounts + UNIQUE(provider, provider_user_id) + 한 유저는 여러 소셜 계정을 연결할 수 있다. +end note + +note right of auth_refresh_tokens + 로그아웃, 재발급, 다중 디바이스 세션 관리를 위해 + 서비스 refresh token 을 별도 테이블에서 관리한다. +end note -@enduml \ No newline at end of file +@enduml diff --git a/docs/erd/user-ops.puml b/docs/erd/user-ops.puml new file mode 100644 index 0000000..dcfc405 --- /dev/null +++ b/docs/erd/user-ops.puml @@ -0,0 +1,63 @@ +@startuml +hide circle +hide methods +skinparam linetype ortho + +entity "USERS\n서비스 사용자" as users { + * id : BIGINT <> + -- + user_tag : VARCHAR(30) <> + status : ENUM('PENDING', 'ACTIVE', 'DELETED') + created_at : timestamp + updated_at : timestamp +} + +entity "USER_SETTINGS\n사용자 설정" as user_settings { + * user_id : BIGINT <> + -- + push_enabled : boolean + email_enabled : boolean + debate_request_enabled : boolean + profile_public : boolean + updated_at : timestamp +} + +entity "USER_AGREEMENTS\n사용자 동의 이력" as user_agreements { + * id : BIGINT <> + -- + user_id : BIGINT <> + agreement_type : string + version : string + agreed_at : timestamp +} + +entity "USER_DEVICES\n사용자 디바이스" as user_devices { + * id : BIGINT <> + -- + user_id : BIGINT <> + device_token : string + platform : string + last_seen_at : timestamp + created_at : timestamp +} + +entity "USER_BLOCKS\n사용자 차단" as user_blocks { + * id : BIGINT <> + -- + blocker_user_id : BIGINT <> + blocked_user_id : BIGINT <> + created_at : timestamp +} + +users -[hidden]down- user_settings +user_settings -[hidden]down- user_agreements +user_agreements -[hidden]down- user_devices +user_devices -[hidden]down- user_blocks + +users ||--|| user_settings +users ||--o{ user_agreements +users ||--o{ user_devices +users ||--o{ user_blocks : blocker +users ||--o{ user_blocks : blocked + +@enduml diff --git a/docs/erd/user.puml b/docs/erd/user.puml index 5007a96..e34d53a 100644 --- a/docs/erd/user.puml +++ b/docs/erd/user.puml @@ -3,79 +3,69 @@ hide circle hide methods skinparam linetype ortho -entity "USERS\n사용자" as users { - * id : uuid <> +entity "USERS\n서비스 사용자" as users { + * id : BIGINT <> -- - provider : string - provider_user_id : string - status : string - created_at : datetime + user_tag : VARCHAR(30) <> + role : ENUM('USER', 'ADMIN') + status : ENUM('PENDING', 'ACTIVE', 'DELETED') + onboarding_completed : boolean + created_at : timestamp + updated_at : timestamp + deleted_at : timestamp (nullable) } entity "USER_PROFILES\n사용자 프로필" as user_profiles { - * user_id : uuid <> + * user_id : BIGINT <> -- nickname : string - avatar_type : string - avatar_url : string + character_type : ENUM('owl', 'fox', '...') manner_temperature : float - updated_at : datetime + updated_at : timestamp } -entity "USER_SETTINGS\n사용자 설정" as user_settings { - * user_id : uuid <> +entity "USER_TENDENCY_SCORES\n사용자 성향 점수 현재값" as user_tendency_scores { + * user_id : BIGINT <> -- - push_enabled : boolean - email_enabled : boolean - debate_request_enabled : boolean - profile_public : boolean - updated_at : datetime -} - -entity "USER_AGREEMENTS\n사용자 동의 이력" as user_agreements { - * id : uuid <> - -- - user_id : uuid <> - agreement_type : string - version : string - agreed_at : datetime -} - -entity "USER_DEVICES\n사용자 디바이스" as user_devices { - * id : uuid <> - -- - user_id : uuid <> - device_token : string - platform : string - last_seen_at : datetime -} - -entity "USER_BLOCKS\n사용자 차단" as user_blocks { - * id : uuid <> - -- - blocker_user_id : uuid <> - blocked_user_id : uuid <> - created_at : datetime + score_1 : int + score_2 : int + score_3 : int + score_4 : int + score_5 : int + score_6 : int + updated_at : timestamp } -entity "USER_TENDENCY_SCORES\n사용자 성향 점수 (-100~100) \n(필드는 추후 수정)" as user_tendency_scores { - * user_id : uuid <> +entity "USER_TENDENCY_SCORE_HISTORIES\n사용자 성향 점수 변경 이력" as user_tendency_score_histories { + * id : BIGINT <> -- + user_id : BIGINT <> score_1 : int score_2 : int score_3 : int score_4 : int score_5 : int score_6 : int - updated_at : datetime + created_at : timestamp } +users -[hidden]down- user_profiles +user_profiles -[hidden]down- user_tendency_scores +user_tendency_scores -[hidden]down- user_tendency_score_histories + users ||--|| user_profiles -users ||--|| user_settings -users ||--o{ user_agreements -users ||--o{ user_devices -users ||--o{ user_blocks : blocker -users ||--o{ user_blocks : blocked users ||--|| user_tendency_scores +users ||--o{ user_tendency_score_histories + +note right of users + users 는 서비스 내부 사용자 식별자와 상태만 관리한다. + provider, provider_user_id 같은 OAuth 식별자는 이 테이블에 두지 않는다. + user_tag 는 공개 식별자이며 저장 시 @ 없이 보관한다. +end note + +note right of user_profiles + nickname은 중복 허용 + user_tag를 대외 식별자로 활용 +end note @enduml From deb598fa3e19d06ec46d9c41f2bc1b1189b8b247 Mon Sep 17 00:00:00 2001 From: JOO <107450745+jucheonsu@users.noreply.github.com> Date: Thu, 12 Mar 2026 23:05:20 +0900 Subject: [PATCH 05/70] =?UTF-8?q?#7=20[Chore]=20API=20=EA=B3=B5=ED=86=B5?= =?UTF-8?q?=20=EC=9D=91=EB=8B=B5=20=EA=B5=AC=EC=A1=B0=20=EB=B0=8F=20?= =?UTF-8?q?=EA=B8=B0=EB=B3=B8=20Config=20=EC=84=B8=ED=8C=85=20(#11)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitignore | 3 +- docker-compose.yml | 17 +++++++ .../java/com/swyp/app/AppApplication.java | 12 +++-- .../test/controller/TestController.java | 19 ++++++++ .../swyp/app/global/common/BaseEntity.java | 24 ++++++++++ .../common/exception/CustomException.java | 10 +++++ .../global/common/exception/ErrorCode.java | 21 +++++++++ .../exception/GlobalExceptionHandler.java | 29 ++++++++++++ .../global/common/response/ApiResponse.java | 44 +++++++++++++++++++ .../app/global/config/SecurityConfig.java | 24 ++++++++++ .../swyp/app/global/config/SwaggerConfig.java | 19 ++++++++ src/main/resources/application.yml | 19 +++++++- 12 files changed, 231 insertions(+), 10 deletions(-) create mode 100644 docker-compose.yml create mode 100644 src/main/java/com/swyp/app/domain/test/controller/TestController.java create mode 100644 src/main/java/com/swyp/app/global/common/BaseEntity.java create mode 100644 src/main/java/com/swyp/app/global/common/exception/CustomException.java create mode 100644 src/main/java/com/swyp/app/global/common/exception/ErrorCode.java create mode 100644 src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java create mode 100644 src/main/java/com/swyp/app/global/common/response/ApiResponse.java create mode 100644 src/main/java/com/swyp/app/global/config/SecurityConfig.java create mode 100644 src/main/java/com/swyp/app/global/config/SwaggerConfig.java diff --git a/.gitignore b/.gitignore index 4244546..edc1c6e 100644 --- a/.gitignore +++ b/.gitignore @@ -37,4 +37,5 @@ out/ .vscode/ ### Setting ### -.env \ No newline at end of file +.env +postgres_data/ \ No newline at end of file diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..0cfd926 --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,17 @@ +services: + db: + image: postgres:15 + container_name: pique-postgres-db + restart: always + environment: + POSTGRES_DB: ${DB_NAME} + POSTGRES_USER: ${DB_USER} + POSTGRES_PASSWORD: ${DB_PASSWORD} + ports: + - "127.0.0.1:${DB_PORT:-5433}:5432" + volumes: + - ./postgres_data:/var/lib/postgresql/data + +networks: + default: + name: pique-network \ No newline at end of file diff --git a/src/main/java/com/swyp/app/AppApplication.java b/src/main/java/com/swyp/app/AppApplication.java index 11ec00c..01062c0 100644 --- a/src/main/java/com/swyp/app/AppApplication.java +++ b/src/main/java/com/swyp/app/AppApplication.java @@ -4,12 +4,10 @@ import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.data.jpa.repository.config.EnableJpaAuditing; -@SpringBootApplication @EnableJpaAuditing +@SpringBootApplication public class AppApplication { - - public static void main(String[] args) { - SpringApplication.run(AppApplication.class, args); - } - -} + public static void main(String[] args) { + SpringApplication.run(AppApplication.class, args); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/test/controller/TestController.java b/src/main/java/com/swyp/app/domain/test/controller/TestController.java new file mode 100644 index 0000000..f8ea09f --- /dev/null +++ b/src/main/java/com/swyp/app/domain/test/controller/TestController.java @@ -0,0 +1,19 @@ +package com.swyp.app.domain.test.controller; + +import com.swyp.app.global.common.response.ApiResponse; // 패키지 경로 확인! +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import java.util.List; + +@RestController +@RequestMapping("/api/test") +public class TestController { + + @GetMapping("/response") + public ApiResponse> testResponse() { + List teamMembers = List.of("주천수", "팀원2", "팀원3", "팀원4"); + return ApiResponse.onSuccess("API 공통 응답 테스트 성공!", teamMembers); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/global/common/BaseEntity.java b/src/main/java/com/swyp/app/global/common/BaseEntity.java new file mode 100644 index 0000000..8da69f0 --- /dev/null +++ b/src/main/java/com/swyp/app/global/common/BaseEntity.java @@ -0,0 +1,24 @@ +package com.swyp.app.global.common; + +import jakarta.persistence.Column; +import jakarta.persistence.EntityListeners; +import jakarta.persistence.MappedSuperclass; +import lombok.Getter; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.annotation.LastModifiedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +@Getter +@MappedSuperclass +@EntityListeners(AuditingEntityListener.class) +public abstract class BaseEntity { + + @CreatedDate + @Column(updatable = false) + private LocalDateTime createdAt; + + @LastModifiedDate + private LocalDateTime updatedAt; +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/global/common/exception/CustomException.java b/src/main/java/com/swyp/app/global/common/exception/CustomException.java new file mode 100644 index 0000000..5c83472 --- /dev/null +++ b/src/main/java/com/swyp/app/global/common/exception/CustomException.java @@ -0,0 +1,10 @@ +package com.swyp.app.global.common.exception; + +import lombok.Getter; +import lombok.RequiredArgsConstructor; + +@Getter +@RequiredArgsConstructor +public class CustomException extends RuntimeException { + private final ErrorCode errorCode; +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java new file mode 100644 index 0000000..122fcaa --- /dev/null +++ b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java @@ -0,0 +1,21 @@ +package com.swyp.app.global.common.exception; + +import lombok.AllArgsConstructor; +import lombok.Getter; +import org.springframework.http.HttpStatus; + +@Getter +@AllArgsConstructor +public enum ErrorCode { + // Common + INTERNAL_SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "COMMON_500", "서버 에러, 관리자에게 문의하세요."), + BAD_REQUEST(HttpStatus.BAD_REQUEST, "COMMON_400", "잘못된 요청입니다."), + + // Battle & Tag + BATTLE_NOT_FOUND(HttpStatus.NOT_FOUND, "BATTLE_404", "존재하지 않는 배틀입니다."), + TAG_NOT_FOUND(HttpStatus.NOT_FOUND, "TAG_404", "존재하지 않는 태그입니다."); + + private final HttpStatus httpStatus; + private final String code; + private final String message; +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java b/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java new file mode 100644 index 0000000..1d1336c --- /dev/null +++ b/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java @@ -0,0 +1,29 @@ +package com.swyp.app.global.common.exception; + +import com.swyp.app.global.common.response.ApiResponse; +import lombok.extern.slf4j.Slf4j; +import org.springframework.http.ResponseEntity; +import org.springframework.web.bind.annotation.ExceptionHandler; +import org.springframework.web.bind.annotation.RestControllerAdvice; + +@Slf4j +@RestControllerAdvice +public class GlobalExceptionHandler { + + @ExceptionHandler(CustomException.class) + public ResponseEntity> handleCustomException(CustomException e) { + ErrorCode code = e.getErrorCode(); + return ResponseEntity + .status(code.getHttpStatus()) + .body(ApiResponse.onFailure(code.getHttpStatus().value(), code.getCode(), code.getMessage())); + } + + @ExceptionHandler(Exception.class) + public ResponseEntity> handleAllException(Exception e) { + log.error("Internal Server Error: ", e); + ErrorCode code = ErrorCode.INTERNAL_SERVER_ERROR; + return ResponseEntity + .status(code.getHttpStatus()) + .body(ApiResponse.onFailure(500, code.getCode(), e.getMessage())); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/global/common/response/ApiResponse.java b/src/main/java/com/swyp/app/global/common/response/ApiResponse.java new file mode 100644 index 0000000..904d76d --- /dev/null +++ b/src/main/java/com/swyp/app/global/common/response/ApiResponse.java @@ -0,0 +1,44 @@ +package com.swyp.app.global.common.response; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import lombok.AccessLevel; +import lombok.AllArgsConstructor; +import lombok.Getter; + +@Getter +@AllArgsConstructor(access = AccessLevel.PRIVATE) +@JsonPropertyOrder({"statusCode", "message", "data", "error"}) +public class ApiResponse { + + private final int statusCode; + private final String message; + + @JsonInclude(JsonInclude.Include.NON_NULL) + private final T data; + + @JsonInclude(JsonInclude.Include.NON_NULL) + private final ErrorResponse error; + + // 성공 응답 (기본) + public static ApiResponse onSuccess(T data) { + return new ApiResponse<>(200, "요청에 성공하였습니다.", data, null); + } + + // 성공 응답 (메시지 커스텀) + public static ApiResponse onSuccess(String message, T data) { + return new ApiResponse<>(200, message, data, null); + } + + // 에러 응답 + public static ApiResponse onFailure(int statusCode, String errorCode, String message) { + return new ApiResponse<>(statusCode, message, null, new ErrorResponse(errorCode, message)); + } + + @Getter + @AllArgsConstructor + public static class ErrorResponse { + private final String code; + private final String message; + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/global/config/SecurityConfig.java b/src/main/java/com/swyp/app/global/config/SecurityConfig.java new file mode 100644 index 0000000..11163d2 --- /dev/null +++ b/src/main/java/com/swyp/app/global/config/SecurityConfig.java @@ -0,0 +1,24 @@ +package com.swyp.app.global.config; + +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.security.config.annotation.web.builders.HttpSecurity; +import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity; +import org.springframework.security.config.annotation.web.configurers.AbstractHttpConfigurer; +import org.springframework.security.web.SecurityFilterChain; + +@Configuration +@EnableWebSecurity +public class SecurityConfig { + + @Bean + public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { + http + .csrf(AbstractHttpConfigurer::disable) + .authorizeHttpRequests(auth -> auth + .requestMatchers("/swagger-ui/**", "/v3/api-docs/**").permitAll() + .anyRequest().permitAll() // 개발 초기 전체 허용 + ); + return http.build(); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/global/config/SwaggerConfig.java b/src/main/java/com/swyp/app/global/config/SwaggerConfig.java new file mode 100644 index 0000000..7b63e1a --- /dev/null +++ b/src/main/java/com/swyp/app/global/config/SwaggerConfig.java @@ -0,0 +1,19 @@ +package com.swyp.app.global.config; + +import io.swagger.v3.oas.models.OpenAPI; +import io.swagger.v3.oas.models.info.Info; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration +public class SwaggerConfig { + + @Bean + public OpenAPI openAPI() { + return new OpenAPI() + .info(new Info() + .title("PIQUE API 명세서") + .description("PIQUE 서비스 API 명세서입니다.") + .version("v1.0.0")); + } +} \ No newline at end of file diff --git a/src/main/resources/application.yml b/src/main/resources/application.yml index 71885b8..1607f89 100644 --- a/src/main/resources/application.yml +++ b/src/main/resources/application.yml @@ -2,7 +2,7 @@ spring: datasource: url: ${DB_URL} username: ${DB_USER} - password: ${DB_PW} + password: ${DB_PASSWORD} driver-class-name: org.postgresql.Driver jpa: @@ -11,4 +11,19 @@ spring: show-sql: true properties: hibernate: - format_sql: true \ No newline at end of file + format_sql: true + dialect: org.hibernate.dialect.PostgreSQLDialect + + jackson: + property-naming-strategy: SNAKE_CASE + +springdoc: + default-consumes-media-type: application/json + default-produces-media-type: application/json + swagger-ui: + path: /swagger-ui.html + tags-sorter: alpha + operations-sorter: alpha + display-request-duration: true + api-docs: + path: /v3/api-docs \ No newline at end of file From 301f313a156a4bacf30ab07c5f0f049a7ec527ee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EC=A4=80=ED=98=81?= <127603139+HYH0804@users.noreply.github.com> Date: Thu, 12 Mar 2026 23:38:04 +0900 Subject: [PATCH 06/70] =?UTF-8?q?#10=20[Docs]=20Perspective=20,=20Like=20,?= =?UTF-8?q?=20Comment=20ERD=20=EB=B0=8F=20API=20=EC=A0=95=EC=9D=98=20(#12)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## #️⃣ 연관된 이슈 - #10 ## 📝 작업 내용 ### 📚 Docs | 내용 | 파일 | |------|------| | 좋아요 도메인 API 명세서 신규 작성 | `likes-api.md` | | 댓글 도메인 API 명세서 신규 작성 | `comments-api.md` | | 관점 도메인 ERD 다이어그램 추가 | `perspectives.puml` | | 관점 도메인 API 명세서 신규 작성 | `perspectives-api.md` | | 추천 도메인 API 명세서 신규 작성 | `recommendations-api.md` | | 투표 도메인 API 명세서 수정 | `vote-api.md` | | 댓글 도메인 ERD 다이어그램 추가 | `comment.puml` | ## ✅ 체크리스트 - [x] Reviewer에 팀원들을 선택했나요? - [x] Assignees에 본인을 선택했나요? - [x] 컨벤션에 맞는 Type을 선택했나요? - [x] Development에 이슈를 연동했나요? - [x] Merge 하려는 브랜치가 올바르게 설정되어 있나요? - [x] 컨벤션을 지키고 있나요? - [x] 로컬에서 실행했을 때 에러가 발생하지 않나요? - [x] 팀원들에게 PR 링크 공유를 했나요? ## 📸 스크린샷 PERSPECTIVES (관점) + COMMENTS (댓글) + LIKES (좋아요) image COMMENTS (댓글) image ## 💬 리뷰 요구사항 > 1. 천수님 테이블 구조 위에다가 제가 필요한 테이블들 끼운거라 큰 문제는 없어보입니다. --- docs/api-specs/comments-api.md | 265 ++++++++++++++++++++++++++ docs/api-specs/likes-api.md | 175 +++++++++++++++++ docs/api-specs/perspectives-api.md | 258 +++++++++++++++++++++++++ docs/api-specs/recommendations-api.md | 163 ++++++++++++++++ docs/api-specs/vote-api.md | 103 ++++++++++ docs/erd/comment.puml | 36 ++++ docs/erd/perspectives.puml | 84 ++++++++ 7 files changed, 1084 insertions(+) create mode 100644 docs/api-specs/comments-api.md create mode 100644 docs/api-specs/likes-api.md create mode 100644 docs/api-specs/perspectives-api.md create mode 100644 docs/api-specs/recommendations-api.md create mode 100644 docs/erd/comment.puml create mode 100644 docs/erd/perspectives.puml diff --git a/docs/api-specs/comments-api.md b/docs/api-specs/comments-api.md new file mode 100644 index 0000000..0980f5f --- /dev/null +++ b/docs/api-specs/comments-api.md @@ -0,0 +1,265 @@ +# 댓글 API 명세서 + +--- + +## 설계 메모 + +- 관점에서의 댓글 관련한 API 입니다. +- 대댓글은 존재하지 않고 같은 최상위 뎁스의 댓글만 존재합니다. + +--- + +## 댓글 목록 조회 API + +### `GET /api/v1/perspectives/{perspective_id}/comments` + +- 댓글 목록 조회 (UI 상에서 아직 없어 임의로 기입함) + +#### 쿼리 파라미터 + +- 파라미터 | 타입 | 필수 | 설명 +- cursor | string | X | 커서 페이지네이션 +- size | number | X | 기본값 20 (임의 설정했음) + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "items": [ + { + "comment_id": "comment_001", + "user": { + "user_tag": "user@12312asb", + "nickname": "철학하는고양이", + "character_url": "https://cdn.pique.app/characters/cat.png" + }, + "content": "저도 같은 생각이에요.", + "is_mine": true, + "created_at": "2026-03-11T12:00:00Z" + } + ], + "next_cursor": "cursor_002", + "has_next": true + }, + "error": null +} +``` + +#### 예외 응답 `404 - 관점 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "PERSPECTIVE_NOT_FOUND", + "message": "존재하지 않는 관점입니다.", + "errors": [] + } +} +``` + +--- +## 특정 댓글 삭제 API +### `DELETE /api/v1/perspectives/{perspective_id}/comments/{comment_id}` + +- 특정 댓글을 삭제 + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "success": true + }, + "error": null +} +``` + +#### 예외 응답 `404 - 댓글 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "COMMENT_NOT_FOUND", + "message": "존재하지 않는 댓글입니다.", + "errors": [] + } +} +``` + +#### 예외 응답 `403 - 본인 댓글 아님` + +```json +{ + "statusCode": 403, + "data": null, + "error": { + "code": "FORBIDDEN_ACCESS", + "message": "본인 댓글만 삭제할 수 있습니다.", + "errors": [] + } +} +``` + +--- + +## 특정 댓글 수정 API +### `PATCH /api/v1/perspectives/{perspective_id}/comments/{comment_id}` + +- 특정 댓글을 삭제 + +#### Request Body + +```json +{ + "content": "수정된 댓글 내용이에요." +} +``` + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "comment_id": "comment_001", + "content": "수정된 댓글 내용이에요.", + "updated_at": "2026-03-11T13:00:00Z" + }, + "error": null +} +``` + +#### 예외 응답 `404 - 댓글 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "COMMENT_NOT_FOUND", + "message": "존재하지 않는 댓글입니다.", + "errors": [] + } +} +``` + +#### 예외 응답 `403 - 본인 댓글 아님` + +```json +{ + "statusCode": 403, + "data": null, + "error": { + "code": "COMMENT_FORBIDDEN", + "message": "본인 댓글만 삭제할 수 있습니다.", + "errors": [] + } +} +``` + +#### 예외 응답 `400 - 내용 없음` + +```json +{ + "statusCode": 400, + "data": null, + "error": { + "code": "COMMON_INVALID_PARAMETER", + "message": "댓글 내용을 입력해주세요.", + "errors": [] + } +} +``` + +--- + + +## 특정 댓글 생성 API +### `DELETE /api/v1/perspectives/{perspective_id}/comments` + +- 특정 댓글을 삭제 + +#### Request Body + +```json +{ + "content": "저도 같은 생각이에요." +} +``` + +#### 성공 응답 `201 Created` + +```json +{ + "statusCode": 201, + "data": { + "comment_id": "comment_001", + "user": { + "user_tag": "user@12312asb", + "nickname": "철학하는고양이", + "character_url": "https://cdn.pique.app/characters/cat.png" + }, + "content": "저도 같은 생각이에요.", + "created_at": "2026-03-11T12:00:00Z" + }, + "error": null +} +``` + +#### 예외 응답 `404 - 관점 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "PERSPECTIVE_NOT_FOUND", + "message": "존재하지 않는 관점입니다.", + "errors": [] + } +} +``` + +#### 예외 응답 `400 - 내용 없음` + +```json +{ + "statusCode": 400, + "data": null, + "error": { + "code": "COMMON_INVALID_PARAMETER", + "message": "댓글 내용을 입력해주세요.", + "errors": [] + } +} +``` + + +## 공통 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `COMMON_INVALID_PARAMETER` | `400` | 요청 파라미터 오류 | +| `COMMON_BAD_REQUEST` | `400` | 잘못된 요청 | +| `AUTH_UNAUTHORIZED` | `401` | 인증 실패 | +| `AUTH_TOKEN_EXPIRED` | `401` | 토큰 만료 | +| `FORBIDDEN_ACCESS` | `403` | 접근 권한 없음 | +| `USER_BANNED` | `403` | 제재된 사용자 | +| `INTERNAL_SERVER_ERROR` | `500` | 서버 오류 | + +--- + +## 댓글 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|-----------| +| `COMMENT_NOT_FOUND` | `404` | 존재하지 않는 댓글 | +| `COMMENT_FORBIDDEN` | `403` | 본인 댓글 아님 | +--- \ No newline at end of file diff --git a/docs/api-specs/likes-api.md b/docs/api-specs/likes-api.md new file mode 100644 index 0000000..601ca30 --- /dev/null +++ b/docs/api-specs/likes-api.md @@ -0,0 +1,175 @@ +# 좋아요 API 명세서 + +--- + +## 설계 메모 + +- 관점에 들어갈 좋아요 API 입니다. + +--- + +## 관점 좋아요 조회 API + +### `GET /api/v1/perspectives/{perspective_id}/likes` + +- 관점 좋아요 + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "perspective_id": "perspective_001", + "like_count": 13 + }, + "error": null +} +``` + +#### 예외 응답 `404 - 관점 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "PERSPECTIVE_NOT_FOUND", + "message": "존재하지 않는 관점입니다.", + "errors": [] + } +} +``` + +```json +{ + "statusCode": 409, + "data": null, + "error": { + "code": "LIKE_ALREADY_EXISTS", + "message": "이미 좋아요를 누른 관점입니다.", + "errors": [] + } +} +``` + +--- +## 관점 좋아요 등록 API +### `POST /api/v1/perspectives/{perspective_id}/likes` + +- 좋아요 등록 + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "perspective_id": "perspective_001", + "like_count": 13, + "is_liked": true + }, + "error": null +} +``` + +#### 실패 응답 `404 - 관점 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "PERSPECTIVE_NOT_FOUND", + "message": "존재하지 않는 관점입니다.", + "errors": [] + } +} +``` + +#### 실패 응답 `409 - 이미 좋아요 누름` + +```json +{ + "statusCode": 409, + "data": null, + "error": { + "code": "LIKE_ALREADY_EXISTS", + "message": "이미 좋아요를 누른 관점입니다.", + "errors": [] + } +} +``` + + +--- +## 관점에 등록됐던 좋아요 삭제 API +### `DELETE /api/v1/perspectives/{perspective_id}/likes` + +- 관점에 등록됐던 좋아요 취소 API + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "perspective_id": "perspective_001", + "like_count": 12, + "is_liked": false + }, + "error": null +} +``` + +#### 실패 응답 `404 - 관점 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "PERSPECTIVE_NOT_FOUND", + "message": "존재하지 않는 관점입니다.", + "errors": [] + } +} +``` + +#### 실패 응답 `409 - 좋아요 누른 적 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "LIKE_NOT_FOUND", + "message": "좋아요를 누른 적 없는 관점입니다.", + "errors": [] + } +} +``` +--- + +## 공통 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `COMMON_INVALID_PARAMETER` | `400` | 요청 파라미터 오류 | +| `COMMON_BAD_REQUEST` | `400` | 잘못된 요청 | +| `AUTH_UNAUTHORIZED` | `401` | 인증 실패 | +| `AUTH_TOKEN_EXPIRED` | `401` | 토큰 만료 | +| `FORBIDDEN_ACCESS` | `403` | 접근 권한 없음 | +| `USER_BANNED` | `403` | 제재된 사용자 | +| `INTERNAL_SERVER_ERROR` | `500` | 서버 오류 | + +--- + +## 좋아요 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `LIKE_ALREADY_EXISTS` | `409` | 이미 좋아요 누른 관점 | +| `LIKE_NOT_FOUND` | `404` | 좋아요 누른 적 없는 관점 | + +--- \ No newline at end of file diff --git a/docs/api-specs/perspectives-api.md b/docs/api-specs/perspectives-api.md new file mode 100644 index 0000000..365aa73 --- /dev/null +++ b/docs/api-specs/perspectives-api.md @@ -0,0 +1,258 @@ +# 관점 API 명세서 + +--- + +## 설계 메모 + +- 관점 API 입니다. +- 현재 Creator 뱃지 부분이 ERD 상에선 보이지 않는데 확인 필요 +--- + +## 관점 생성 API + +### `POST /api/v1/battles/{battle_id}/perspectives` + +- 특정 배틀에 대한 관점 생성 (비동기) + +#### Request Body + +```json +{ + "content": "자기결정권은 가장 기본적인 인권이라고 생각해요." +} +``` + +#### 성공 응답 `201 Created` + +```json +{ + "statusCode": 201, + "data": { + "perspective_id": "perspective_001", + "status": "PENDING", + "created_at": "2026-03-11T12:00:00Z" + }, + "error": null +} +``` + +#### 예외 응답 `404 - 존재하지 않는 배틀` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "BATTLE_NOT_FOUND", + "message": "존재하지 않는 배틀입니다.", + "errors": [] + } +} +``` + +#### 예외 응답 `409 - 이미 관점 작성함` + +```json +{ + "statusCode": 409, + "data": null, + "error": { + "code": "PERSPECTIVE_ALREADY_EXISTS", + "message": "이미 관점을 작성한 배틀입니다.", + "errors": [] + } +} +``` + + + +--- +## 관점 리스트 조회 API +### `GET /api/v1/battles/{battle_id}/perspectives` + +- 특정 배틀에 대한 관점 리스트 조회 + +#### 쿼리 파라미터 + +- 파라미터 | 타입 | 필수 | 설명 +- cursor | string | X | 커서 페이지네이션 +- size | number | X | 기본값 20 (임의 설정했음) +- option_label | string | X | A or B 투표 옵션 필터 + + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "items": [ + { + "perspective_id": "perspective_001", + "user": { + "user_tag": "user@12312asb", + "nickname": "철학하는고양이", + "character_url": "https://cdn.pique.app/characters/cat.png" + }, + "option": { + "option_id": "option_A", + "label": "A", + "title": "찬성" + }, + "content": "자기결정권은 가장 기본적인 인권이라고 생각해요.", + "like_count": 12, + "comment_count": 3, + "is_liked": false, + "created_at": "2026-03-11T12:00:00Z" + } + ], + "next_cursor": "cursor_002", + "has_next": true + }, + "error": null +} +``` + +#### 예외 응답 `404 - 존재하지 않는 배틀` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "BATTLE_NOT_FOUND", + "message": "존재하지 않는 배틀입니다.", + "errors": [] + } +} +``` + +--- +## 관점 삭제 API +### `DELETE /api/v1/perspectives/{perspective_id}` + +- 특정 배틀에 대한 내가 쓴 관점 삭제 + + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "success": true + }, + "error": null +} +``` + +#### 예외 응답 `404 - 관점 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "PERSPECTIVE_NOT_FOUND", + "message": "존재하지 않는 관점입니다.", + "errors": [] + } +} +``` + +#### 예외 응답 `403 - 본인 관점 아님` + +```json +{ + "statusCode": 403, + "data": null, + "error": { + "code": "FORBIDDEN_ACCESS", + "message": "본인 관점만 삭제할 수 있습니다.", + "errors": [] + } +} +``` + + +--- +## 관점 수정 API +### `PATCH /api/v1/perspectives/{perspective_id}` + +- 특정 배틀에 대한 내가 쓴 관점 수정 + +#### Request Body + +```json +{ + "content": "수정된 관점 내용입니다." +} +``` + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "perspective_id": "perspective_001", + "content": "수정된 관점 내용입니다.", + "updated_at": "2026-03-11T13:00:00Z" + }, + "error": null +} +``` + +#### 예외 응답 `404 - 존재하지 않는 관점` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "PERSPECTIVE_NOT_FOUND", + "message": "존재하지 않는 관점입니다.", + "errors": [] + } +} +``` + +#### 예외 응답 `403 - 본인 관점 아님` +```json +{ + "statusCode": 403, + "data": null, + "error": { + "code": "FORBIDDEN_ACCESS", + "message": "본인 관점만 수정할 수 있습니다.", + "errors": [] + } +} +``` + +--- + +## 공통 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `COMMON_INVALID_PARAMETER` | `400` | 요청 파라미터 오류 | +| `COMMON_BAD_REQUEST` | `400` | 잘못된 요청 | +| `AUTH_UNAUTHORIZED` | `401` | 인증 실패 | +| `AUTH_TOKEN_EXPIRED` | `401` | 토큰 만료 | +| `FORBIDDEN_ACCESS` | `403` | 접근 권한 없음 | +| `USER_BANNED` | `403` | 제재된 사용자 | +| `INTERNAL_SERVER_ERROR` | `500` | 서버 오류 | + +--- + +## 관점 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|-------------| +| `PERSPECTIVE_NOT_FOUND` | `404` | 존재하지 않는 관점 | +| `PERSPECTIVE_ALREADY_EXISTS` | `409` | 해당 배틀에 이미 관점 작성함 | +| `PERSPECTIVE_FORBIDDEN` | `403` | 본인 관점 아님 | +| `PERSPECTIVE_POST_VOTE_REQUIRED` | `409` | 사후 투표 미완료 | + +--- \ No newline at end of file diff --git a/docs/api-specs/recommendations-api.md b/docs/api-specs/recommendations-api.md new file mode 100644 index 0000000..7d444aa --- /dev/null +++ b/docs/api-specs/recommendations-api.md @@ -0,0 +1,163 @@ +# 성향기반 배틀 추천 API 명세서 + +--- + +## 설계 메모 + +- 연관 , 비슷한 , 반대 성향에 대한 추천 / 내부 정책 로직 API 입니다. + +--- + +## 성향 기반 연관 배틀 조회 API + +### `GET /api/v1/battles/{battle_id}/related` + +- 연관 배틀 조회 + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "items": [ + { + "battle_id": "battle_002", + "title": "유전자 편집 아기, 허용해야 할까?", + "tags": [ + { "tag_id": "tag_001", "name": "과학" }, + { "tag_id": "tag_002", "name": "윤리" } + ], + "options": [ + { "option_id": "option_A", "label": "A", "title": "허용" }, + { "option_id": "option_B", "label": "B", "title": "금지" } + ], + "participants_count": 890 + } + ] + }, + "error": null +} +``` + +#### 예외 응답 `404 - 배틀 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "BATTLE_NOT_FOUND", + "message": "존재하지 않는 배틀입니다.", + "errors": [] + } +} +``` + +--- +## 성향 기반 비슷한 유저가 들은 배틀 조회 API +### `GET /api/v1/battles/{battle_id}/recommendations/similar` + +- 비슷한 유저가 들은 배틀 + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "items": [ + { + "battle_id": "battle_002", + "title": "사형제도, 유지 vs 폐지", + "thumbnail_url": "https://cdn.pique.app/battle/002.png", + "tags": [ + { "tag_id": "tag_001", "name": "사회" } + ], + "participants_count": 1500, + "options": [ + { "option_id": "option_A", "label": "A", "title": "유지" }, + { "option_id": "option_B", "label": "B", "title": "폐지" } + ], + "match_ratio": 87 + } + ] + }, + "error": null +} +``` + +### 예외 응답 `404 - 배틀 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "BATTLE_NOT_FOUND", + "message": "존재하지 않는 배틀입니다.", + "errors": [] + } +} +``` + +--- +## 성향 기반 반대 성향 유저에게 인기 배틀 조회 API +### `GET /api/v1/battles/{battle_id}/recommendations/opposite` + +- 반대 성향 유저에게 인기 중인 배틀 + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "items": [ + { + "battle_id": "battle_003", + "title": "AI 판사, 도입해야 할까?", + "thumbnail_url": "https://cdn.pique.app/battle/003.png", + "tags": [ + { "tag_id": "tag_002", "name": "기술" } + ], + "participants_count": 780, + "options": [ + { "option_id": "option_A", "label": "A", "title": "도입" }, + { "option_id": "option_B", "label": "B", "title": "반대" } + ] + } + ] + }, + "error": null +} +``` + +#### 예외 응답 `404 - 배틀 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "BATTLE_NOT_FOUND", + "message": "존재하지 않는 배틀입니다.", + "errors": [] + } +} +``` +--- + +## 공통 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `COMMON_INVALID_PARAMETER` | `400` | 요청 파라미터 오류 | +| `COMMON_BAD_REQUEST` | `400` | 잘못된 요청 | +| `AUTH_UNAUTHORIZED` | `401` | 인증 실패 | +| `AUTH_TOKEN_EXPIRED` | `401` | 토큰 만료 | +| `FORBIDDEN_ACCESS` | `403` | 접근 권한 없음 | +| `USER_BANNED` | `403` | 제재된 사용자 | +| `INTERNAL_SERVER_ERROR` | `500` | 서버 오류 | + +--- \ No newline at end of file diff --git a/docs/api-specs/vote-api.md b/docs/api-specs/vote-api.md index cef1e19..0ebae6d 100644 --- a/docs/api-specs/vote-api.md +++ b/docs/api-specs/vote-api.md @@ -127,6 +127,109 @@ --- +### `GET /api/v1/battles/{battle_id}/vote-stats` + +- 투표 %를 조회 + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "options": [ + { + "option_id": "option_A", + "label": "A", + "title": "찬성", + "vote_count": 1259, + "ratio": 59.5 + }, + { + "option_id": "option_B", + "label": "B", + "title": "반대", + "vote_count": 856, + "ratio": 40.5 + } + ], + "total_count": 2115, + "updated_at": "2026-03-11T12:00:00Z" + }, + "error": null +} +``` + +#### 예외 응답 `404 - 배틀없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "BATTLE_NOT_FOUND", + "message": "존재하지 않는 배틀입니다.", + "errors": [] + } +} +``` +--- +### `GET /api/v1/battles/{battle_id}/votes/me` + +- 투표 %를 조회 + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "pre_vote": { + "option_id": "option_A", + "label": "A", + "title": "찬성" + }, + "post_vote": { + "option_id": "option_A", + "label": "A", + "title": "찬성" + }, + "mind_changed": false, + "status": "POST_VOTED" + }, + "error": null +} +``` + +#### 예외 응답 `404 - 배틀없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "BATTLE_NOT_FOUND", + "message": "존재하지 않는 배틀입니다.", + "errors": [] + } +} +``` + +#### 예외 응답 `404 - 투표 내역 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "VOTE_NOT_FOUND", + "message": "투표 내역이 없습니다.", + "errors": [] + } +} +``` + +--- ## 공통 에러 코드 | Error Code | HTTP Status | 설명 | diff --git a/docs/erd/comment.puml b/docs/erd/comment.puml new file mode 100644 index 0000000..258ca3f --- /dev/null +++ b/docs/erd/comment.puml @@ -0,0 +1,36 @@ +@startuml perspective_comments +hide circle +hide methods +skinparam linetype ortho + +entity "users\n사용자" as users { + * id : BIGINT <> +} + +entity "PERSPECTIVES\n관점" as perspectives { + * id : UUID <> +} + +entity "PERSPECTIVE_COMMENTS\n관점 댓글" as perspective_comments { + * id : UUID <> + -- + perspective_id : UUID <> + user_id : BIGINT <> + content : TEXT + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + +perspectives -[hidden]down- perspective_comments +users -[hidden]right- perspective_comments + +perspectives ||--o{ perspective_comments : "has" +users ||--o{ perspective_comments : "writes" + +note right of perspective_comments + 삭제: 본인만 가능 + 수정: 본인만 가능 + 대댓글 없음 (1단 구조) +end note + +@enduml \ No newline at end of file diff --git a/docs/erd/perspectives.puml b/docs/erd/perspectives.puml new file mode 100644 index 0000000..960f0a7 --- /dev/null +++ b/docs/erd/perspectives.puml @@ -0,0 +1,84 @@ +@startuml perspective +hide circle +hide methods +skinparam linetype ortho + +entity "users\n사용자" as users { + * id : BIGINT <> +} + +entity "BATTLES\n배틀(주제)" as battles { + * id : UUID <> +} + +entity "BATTLE_OPTIONS\n선택지" as battle_options { + * id : UUID <> +} + +entity "PERSPECTIVES\n관점" as perspectives { + * id : UUID <> + -- + battle_id : UUID <> + user_id : BIGINT <> + option_id : UUID <> + content : TEXT + like_count : INT default 0 + comment_count : INT default 0 + status : ENUM('PENDING', 'PUBLISHED', 'REJECTED') + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + +entity "COMMENTS\n관점 댓글" as perspective_comments { + * id : UUID <> + -- + perspective_id : UUID <> + user_id : BIGINT <> + content : TEXT + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + +entity "LIKES\n관점 좋아요" as perspective_likes { + * perspective_id : UUID <> + * user_id : BIGINT <> + -- + created_at : TIMESTAMP +} + +users -[hidden]down- perspectives +battles -[hidden]down- perspectives +perspectives -[hidden]down- perspective_comments +perspective_likes -[hidden]right- perspective_comments + +battles ||--o{ perspectives : "has" +users ||--o{ perspectives : "writes" +battle_options ||--o{ perspectives : "belongs to" +perspectives ||--o{ perspective_comments : "has" +users ||--o{ perspective_comments : "writes" +perspectives ||--o{ perspective_likes : "has" +users ||--o{ perspective_likes : "likes" + +note right of perspectives + status 흐름: + PENDING → PUBLISHED → REJECTED + + option_id: 서버가 votes 테이블에서 + pre_vote_option_id를 읽어서 저장 + + like_count, comment_count: + 캐싱용 카운터 (정합성은 배치로 보정) + + UNIQUE (battle_id, user_id): + 1인 1관점 제약 +end note + +note bottom of perspective_likes + 복합 PK: (perspective_id, user_id) + 동일 유저 중복 좋아요 방지 +end note + +@enduml +``` + +--- \ No newline at end of file From b5efc6e0a4261bfde6913bf7d4584e50a9ca97d5 Mon Sep 17 00:00:00 2001 From: Youwol <153346797+si-zero@users.noreply.github.com> Date: Fri, 13 Mar 2026 15:22:40 +0900 Subject: [PATCH 07/70] =?UTF-8?q?#13=20[Docs]=20user/oauth=20API=20?= =?UTF-8?q?=EC=9D=91=EB=8B=B5=20=EC=88=98=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/api-specs/oauth-api.md | 148 +++++++++++++++----------------- docs/api-specs/user-api.md | 162 +++++++++++++++++++++++++----------- 2 files changed, 181 insertions(+), 129 deletions(-) diff --git a/docs/api-specs/oauth-api.md b/docs/api-specs/oauth-api.md index d947226..4f31b61 100644 --- a/docs/api-specs/oauth-api.md +++ b/docs/api-specs/oauth-api.md @@ -11,44 +11,46 @@ ### 1.1 공통 요청 헤더 - `Content-Type: application/json` - - JSON 요청 바디가 있는 API에 사용합니다. + - JSON 요청 바디가 있는 API에 사용합니다. - `Authorization: Bearer {access_token}` - - 로그인 이후 인증이 필요한 API에 사용합니다. + - 로그인 이후 인증이 필요한 API에 사용합니다. - `X-Refresh-Token: {refresh_token}` - - Access Token 재발급 API에 사용합니다. + - Access Token 재발급 API에 사용합니다. ### 1.2 토큰 사용 방식 로그인 성공 후 클라이언트는 `access_token`, `refresh_token`을 발급받습니다. - `access_token` - - 이후 인증이 필요한 API 호출 시 `Authorization: Bearer {access_token}` 헤더로 전달합니다. - - 예: `GET /api/v1/me/profile`, `PATCH /api/v1/me/settings`, `DELETE /api/v1/me` + - 이후 인증이 필요한 API 호출 시 `Authorization: Bearer {access_token}` 헤더로 전달합니다. + - 예: `GET /api/v1/me/profile`, `PATCH /api/v1/me/settings`, `DELETE /api/v1/me` - `refresh_token` - - API가 `401`과 `auth_access_token_expired`를 반환했을 때 `POST /api/v1/auth/refresh` 에서 사용합니다. - - `X-Refresh-Token: {refresh_token}` 헤더로 전달합니다. + - API가 `401`과 `AUTH_ACCESS_TOKEN_EXPIRED`를 반환했을 때 `POST /api/v1/auth/refresh` 에서 사용합니다. + - `X-Refresh-Token: {refresh_token}` 헤더로 전달합니다. - Access Token 만료 안내 - - 인증이 필요한 API는 Access Token이 만료되면 `401 Unauthorized`를 반환합니다. - - 에러 코드가 `auth_access_token_expired` 이면 클라이언트는 Refresh API를 호출해야 합니다. - - Refresh 성공 후 실패했던 요청을 새 `access_token`으로 1회 재시도합니다. + - 인증이 필요한 API는 Access Token이 만료되면 `401 Unauthorized`를 반환합니다. + - 에러 코드가 `AUTH_ACCESS_TOKEN_EXPIRED` 이면 클라이언트는 Refresh API를 호출해야 합니다. + - Refresh 성공 후 실패했던 요청을 새 `access_token`으로 1회 재시도합니다. - Refresh Token 만료 안내 - - Refresh API가 `401`과 `auth_refresh_token_expired`를 반환하면 재로그인이 필요합니다. + - Refresh API가 `401`과 `AUTH_REFRESH_TOKEN_EXPIRED`를 반환하면 재로그인이 필요합니다. - 재발급 성공 시 - - 새 `access_token`, 새 `refresh_token`으로 교체합니다. - - 이후 요청에는 기존 토큰 대신 새 토큰을 사용합니다. + - 새 `access_token`, 새 `refresh_token`으로 교체합니다. + - 이후 요청에는 기존 토큰 대신 새 토큰을 사용합니다. - 로그아웃 시 - - `POST /api/v1/auth/logout` 호출 후 클라이언트에 저장된 토큰을 삭제합니다. + - `POST /api/v1/auth/logout` 호출 후 클라이언트에 저장된 토큰을 삭제합니다. - 회원 탈퇴 시 - - `DELETE /api/v1/me` 호출 후 클라이언트에 저장된 토큰을 삭제합니다. + - `DELETE /api/v1/me` 호출 후 클라이언트에 저장된 토큰을 삭제합니다. -신규 사용자 흐름: +### 1.3 로그인 흐름 + +**신규 사용자** 1. `POST /api/v1/auth/login/{provider}` 호출 2. 응답에서 `is_new_user = true` 확인 3. 발급받은 `access_token`으로 온보딩 API 호출 4. `POST /api/v1/onboarding/profile` 완료 후 일반 사용자 API 사용 -기존 사용자 흐름: +**기존 사용자** 1. `POST /api/v1/auth/login/{provider}` 호출 2. 응답에서 `is_new_user = false` 확인 @@ -63,9 +65,13 @@ 소셜 인가 코드를 이용해 로그인 및 계정을 생성합니다. - `{provider}`: `kakao`, `google` -- 상태가 `BANNED`인 사용자는 `403`을 반환합니다. +- 상태가 `BANNED` 또는 `SUSPENDED`인 사용자는 `403`을 반환합니다. - 신규 사용자는 `status = PENDING`, `is_new_user = true` 상태로 응답합니다. +요청 헤더: + +- `Content-Type: application/json` + 요청: ```json @@ -75,22 +81,24 @@ } ``` -요청 헤더: - -- `Content-Type: application/json` - 응답: ```json { - "access_token": "eyJhbGciOiJIUzI...", - "refresh_token": "def456-ghi789...", - "user_tag": "sfit4-2", - "is_new_user": true, - "status": "PENDING" + "statusCode": 200, + "data": { + "access_token": "eyJhbGciOiJIUzI...", + "refresh_token": "def456-ghi789...", + "user_tag": "sfit4-2", + "is_new_user": true, + "status": "PENDING" + }, + "error": null } ``` +--- + ### 2.2 `POST /api/v1/auth/refresh` 만료된 Access Token을 Refresh Token으로 재발급합니다. @@ -104,11 +112,17 @@ ```json { - "access_token": "new_eyJhbGciOiJIUzI...", - "refresh_token": "new_def456-ghi789..." + "statusCode": 200, + "data": { + "access_token": "new_eyJhbGciOiJIUzI...", + "refresh_token": "new_def456-ghi789..." + }, + "error": null } ``` +--- + ### 2.3 `POST /api/v1/auth/logout` 현재 로그인된 사용자의 Refresh Token을 삭제하여 로그아웃 처리합니다. @@ -122,10 +136,16 @@ ```json { - "logged_out": true + "statusCode": 200, + "data": { + "logged_out": true + }, + "error": null } ``` +--- + ### 2.4 `DELETE /api/v1/me` 현재 로그인된 사용자의 계정을 탈퇴 처리합니다. @@ -141,62 +161,26 @@ ```json { - "withdrawn": true + "statusCode": 200, + "data": { + "withdrawn": true + }, + "error": null } ``` --- -## 3. 인증 예외 응답 - -### 3.1 잘못된 요청 (400) - -```json -{ - "code": "common_invalid_parameter", - "message": "요청 파라미터가 잘못되었습니다.", - "errors": [ - { - "field": "redirect_uri", - "value": "", - "reason": "redirect_uri 는 필수입니다." - } - ] -} -``` +## 3. 에러 코드 -### 3.2 인증 실패 (401) +### 3.1 공통 에러 코드 -```json -{ - "code": "auth_invalid_code", - "message": "유효하지 않은 소셜 인가 코드입니다.", - "errors": [] -} -``` - -```json -{ - "code": "auth_access_token_expired", - "message": "Access Token이 만료되었습니다. Refresh Token으로 재발급이 필요합니다.", - "errors": [] -} -``` - -```json -{ - "code": "auth_refresh_token_expired", - "message": "Refresh Token이 만료되었거나 유효하지 않습니다. 다시 로그인이 필요합니다.", - "errors": [] -} -``` - -### 3.3 접근 거부 (403) - -```json -{ - "code": "user_banned", - "message": "제재된 사용자입니다.", - "errors": [] -} -``` +| HTTP | 에러 코드 | 설명 | +|------|-----------|------| +| `400` | `COMMON_INVALID_PARAMETER` | 요청 파라미터가 잘못되었습니다. | +| `401` | `AUTH_INVALID_CODE` | 유효하지 않은 소셜 인가 코드 | +| `401` | `AUTH_ACCESS_TOKEN_EXPIRED` | Access Token 만료 — Refresh 필요 | +| `401` | `AUTH_REFRESH_TOKEN_EXPIRED` | Refresh Token 만료 — 재로그인 필요 | +| `403` | `USER_BANNED` | 영구 제재된 사용자 | +| `403` | `USER_SUSPENDED` | 일정 기간 이용 정지된 사용자 | +| `500` | `INTERNAL_SERVER_ERROR` | 서버 오류 | \ No newline at end of file diff --git a/docs/api-specs/user-api.md b/docs/api-specs/user-api.md index be8d36f..65c9214 100644 --- a/docs/api-specs/user-api.md +++ b/docs/api-specs/user-api.md @@ -24,7 +24,11 @@ ```json { - "random_nickname": "생각하는올빼미" + "statusCode": 200, + "data": { + "random_nickname": "생각하는올빼미" + }, + "error": null } ``` @@ -32,6 +36,7 @@ 첫 로그인 시 프로필 생성. owl, wolf, lion 등은 추후 디자인에 따라 정의 + 요청: ```json @@ -45,12 +50,16 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 ```json { - "user_tag": "sfit4-2", - "nickname": "생각하는올빼미", - "character_type": "owl", - "manner_temperature": 36.5, - "status": "ACTIVE", - "onboarding_completed": true + "statusCode": 200, + "data": { + "user_tag": "sfit4-2", + "nickname": "생각하는올빼미", + "character_type": "owl", + "manner_temperature": 36.5, + "status": "ACTIVE", + "onboarding_completed": true + }, + "error": null } ``` @@ -66,13 +75,19 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 ```json { - "user_tag": "sfit4-2", - "nickname": "생각하는올빼미", - "character_type": "owl", - "manner_temperature": 36.5 + "statusCode": 200, + "data": { + "user_tag": "sfit4-2", + "nickname": "생각하는올빼미", + "character_type": "owl", + "manner_temperature": 36.5 + }, + "error": null } ``` +--- + ### 3.2 `GET /api/v1/me/profile` 내 프로필 조회. @@ -81,14 +96,20 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 ```json { - "user_tag": "sfit4-2", - "nickname": "생각하는올빼미", - "character_type": "owl", - "manner_temperature": 36.5, - "updated_at": "2026-03-08T12:00:00Z" + "statusCode": 200, + "data": { + "user_tag": "sfit4-2", + "nickname": "생각하는올빼미", + "character_type": "owl", + "manner_temperature": 36.5, + "updated_at": "2026-03-08T12:00:00Z" + }, + "error": null } ``` +--- + ### 3.3 `PATCH /api/v1/me/profile` 닉네임 및 캐릭터 수정. @@ -106,10 +127,14 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 ```json { - "user_tag": "sfit4-2", - "nickname": "생각하는펭귄", - "character_type": "penguin", - "updated_at": "2026-03-08T12:00:00Z" + "statusCode": 200, + "data": { + "user_tag": "sfit4-2", + "nickname": "생각하는펭귄", + "character_type": "penguin", + "updated_at": "2026-03-08T12:00:00Z" + }, + "error": null } ``` @@ -125,13 +150,19 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 ```json { - "push_enabled": true, - "email_enabled": false, - "debate_request_enabled": true, - "profile_public": true + "statusCode": 200, + "data": { + "push_enabled": true, + "email_enabled": false, + "debate_request_enabled": true, + "profile_public": true + }, + "error": null } ``` +--- + ### 4.2 `PATCH /api/v1/me/settings` 사용자 설정 수정. @@ -149,7 +180,11 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 ```json { - "updated": true + "statusCode": 200, + "data": { + "updated": true + }, + "error": null } ``` @@ -179,18 +214,24 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 ```json { - "user_tag": "sfit4-2", - "score_1": 30, - "score_2": -20, - "score_3": 55, - "score_4": 10, - "score_5": -75, - "score_6": 42, - "updated_at": "2026-03-08T12:00:00Z", - "history_saved": true + "statusCode": 200, + "data": { + "user_tag": "sfit4-2", + "score_1": 30, + "score_2": -20, + "score_3": 55, + "score_4": 10, + "score_5": -75, + "score_6": 42, + "updated_at": "2026-03-08T12:00:00Z", + "history_saved": true + }, + "error": null } ``` +--- + ### 5.2 `GET /api/v1/me/tendency-scores/history` 성향 점수 변경 이력 조회. @@ -204,18 +245,45 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 ```json { - "items": [ - { - "history_id": "ths_001", - "score_1": 30, - "score_2": -20, - "score_3": 55, - "score_4": 10, - "score_5": -75, - "score_6": 42, - "created_at": "2026-03-08T12:00:00Z" - } - ], - "next_cursor": null + "statusCode": 200, + "data": { + "items": [ + { + "history_id": "ths_001", + "score_1": 30, + "score_2": -20, + "score_3": 55, + "score_4": 10, + "score_5": -75, + "score_6": 42, + "created_at": "2026-03-08T12:00:00Z" + } + ], + "next_cursor": null + }, + "error": null } ``` + +--- + +## 6. 에러 코드 + +### 6.1 공통 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `COMMON_INVALID_PARAMETER` | `400` | 요청 파라미터 오류 | +| `AUTH_UNAUTHORIZED` | `401` | 인증 실패 | +| `AUTH_ACCESS_TOKEN_EXPIRED` | `401` | Access Token 만료 | +| `AUTH_REFRESH_TOKEN_EXPIRED` | `401` | Refresh Token 만료 — 재로그인 필요 | +| `USER_BANNED` | `403` | 영구 제재된 사용자 | +| `USER_SUSPENDED` | `403` | 일정 기간 이용 정지된 사용자 | +| `INTERNAL_SERVER_ERROR` | `500` | 서버 오류 | + +### 6.2 사용자 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|------| +| `USER_NOT_FOUND` | `404` | 존재하지 않는 사용자 | +| `ONBOARDING_ALREADY_COMPLETED` | `409` | 이미 온보딩이 완료된 사용자 | \ No newline at end of file From ff0cdb7f85b7f931b3960a70edaa4460e795bcce Mon Sep 17 00:00:00 2001 From: Youwol <153346797+si-zero@users.noreply.github.com> Date: Fri, 13 Mar 2026 15:34:24 +0900 Subject: [PATCH 08/70] =?UTF-8?q?#19=20[Fix]=20=EA=B3=B5=ED=86=B5=20?= =?UTF-8?q?=EC=9D=91=EB=8B=B5=20API=20=EC=88=98=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../app/domain/test/controller/TestController.java | 2 +- .../common/exception/GlobalExceptionHandler.java | 2 +- .../app/global/common/response/ApiResponse.java | 14 ++++---------- 3 files changed, 6 insertions(+), 12 deletions(-) diff --git a/src/main/java/com/swyp/app/domain/test/controller/TestController.java b/src/main/java/com/swyp/app/domain/test/controller/TestController.java index f8ea09f..40a9d9c 100644 --- a/src/main/java/com/swyp/app/domain/test/controller/TestController.java +++ b/src/main/java/com/swyp/app/domain/test/controller/TestController.java @@ -14,6 +14,6 @@ public class TestController { @GetMapping("/response") public ApiResponse> testResponse() { List teamMembers = List.of("주천수", "팀원2", "팀원3", "팀원4"); - return ApiResponse.onSuccess("API 공통 응답 테스트 성공!", teamMembers); + return ApiResponse.onSuccess(teamMembers); } } \ No newline at end of file diff --git a/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java b/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java index 1d1336c..aade740 100644 --- a/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java +++ b/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java @@ -24,6 +24,6 @@ public ResponseEntity> handleAllException(Exception e) { ErrorCode code = ErrorCode.INTERNAL_SERVER_ERROR; return ResponseEntity .status(code.getHttpStatus()) - .body(ApiResponse.onFailure(500, code.getCode(), e.getMessage())); + .body(ApiResponse.onFailure(500, code.getCode(), code.getMessage())); } } \ No newline at end of file diff --git a/src/main/java/com/swyp/app/global/common/response/ApiResponse.java b/src/main/java/com/swyp/app/global/common/response/ApiResponse.java index 904d76d..b3b4e50 100644 --- a/src/main/java/com/swyp/app/global/common/response/ApiResponse.java +++ b/src/main/java/com/swyp/app/global/common/response/ApiResponse.java @@ -8,11 +8,10 @@ @Getter @AllArgsConstructor(access = AccessLevel.PRIVATE) -@JsonPropertyOrder({"statusCode", "message", "data", "error"}) +@JsonPropertyOrder({"statusCode", "data", "error"}) public class ApiResponse { private final int statusCode; - private final String message; @JsonInclude(JsonInclude.Include.NON_NULL) private final T data; @@ -20,19 +19,14 @@ public class ApiResponse { @JsonInclude(JsonInclude.Include.NON_NULL) private final ErrorResponse error; - // 성공 응답 (기본) + // 성공 응답 public static ApiResponse onSuccess(T data) { - return new ApiResponse<>(200, "요청에 성공하였습니다.", data, null); - } - - // 성공 응답 (메시지 커스텀) - public static ApiResponse onSuccess(String message, T data) { - return new ApiResponse<>(200, message, data, null); + return new ApiResponse<>(200, data, null); } // 에러 응답 public static ApiResponse onFailure(int statusCode, String errorCode, String message) { - return new ApiResponse<>(statusCode, message, null, new ErrorResponse(errorCode, message)); + return new ApiResponse<>(statusCode, null, new ErrorResponse(errorCode, message)); } @Getter From f4da17948a3b02ec3beeac4ab335d245e831c326 Mon Sep 17 00:00:00 2001 From: Dante0922 <101305519+Dante0922@users.noreply.github.com> Date: Sat, 14 Mar 2026 22:55:18 +0900 Subject: [PATCH 09/70] =?UTF-8?q?#21=20[Feat]=20=EC=82=AC=EC=9A=A9?= =?UTF-8?q?=EC=9E=90=20=EB=8F=84=EB=A9=94=EC=9D=B8=20=EB=B0=8F=20API=20?= =?UTF-8?q?=EA=B5=AC=ED=98=84=20(#24)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## #️⃣ 연관된 이슈 - #21 ## 📝 작업 내용 ### ✨ Feat | 내용 | 파일 | |------|------| | 사용자 도메인 엔티티 및 리포지토리 구현 | `src/main/java/com/swyp/app/domain/user/entity/*`, `src/main/java/com/swyp/app/domain/user/repository/*` | | 온보딩/프로필/설정/성향 점수 API 구현 | `src/main/java/com/swyp/app/domain/user/controller/UserController.java`, `src/main/java/com/swyp/app/domain/user/service/UserService.java` | | 필수 약관 동의 이력 저장 로직 추가 | `src/main/java/com/swyp/app/domain/user/entity/UserAgreement.java`, `src/main/java/com/swyp/app/domain/user/service/UserService.java` | | request validation 및 입력 예외 처리 보강 | `src/main/java/com/swyp/app/domain/user/dto/request/*`, `src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java` | ### ♻️ Refactor | 내용 | 파일 | |------|------| | `/me` 계열 호출을 auth 전 임시 현재 사용자 방식으로 단순화 | `src/main/java/com/swyp/app/domain/user/controller/UserController.java`, `src/main/java/com/swyp/app/domain/user/service/UserService.java` | | 프로필 PATCH를 부분 수정 방식으로 보강 | `src/main/java/com/swyp/app/domain/user/entity/UserProfile.java`, `src/main/java/com/swyp/app/domain/user/dto/request/UpdateUserProfileRequest.java` | ### 🐛 Fix | 내용 | 파일 | |------|------| | 온보딩 재호출 시 중복 완료 방지 로직 추가 | `src/main/java/com/swyp/app/domain/user/service/UserService.java` | | 설정 기본값 및 응답 예시 정합성 수정 | `src/main/java/com/swyp/app/domain/user/service/UserService.java`, `docs/api-specs/user-api.md` | ## 📌 공유 사항 > 1. auth 미구현 상태라 `/me` 계열은 현재 가장 최근 사용자를 임시 current user로 간주합니다. OAuth 연동 시 교체 예정입니다. > 2. `user_tag`는 prefix 없는 8자리 랜덤 문자열로 생성되도록 변경했습니다. ## ✅ 체크리스트 - [x] Reviewer에 팀원들을 선택했나요? - [x] Assignees에 본인을 선택했나요? - [x] 컨벤션에 맞는 Type을 선택했나요? - [x] Development에 이슈를 연동했나요? - [x] Merge 하려는 브랜치가 올바르게 설정되어 있나요? - [x] 컨벤션을 지키고 있나요? - [x] 로컬에서 실행했을 때 에러가 발생하지 않나요? - [x] 팀원들에게 PR 링크 공유를 했나요? ## 📸 스크린샷 - 없음 (서버/API 구현) ## 💬 리뷰 요구사항 - 없음 --- build.gradle | 2 + docs/api-specs/oauth-api.md | 4 +- docs/api-specs/user-api.md | 22 +- docs/erd/user-ops.puml | 10 +- docs/erd/user.puml | 10 +- .../user/controller/UserController.java | 91 ++++++ .../CreateOnboardingProfileRequest.java | 15 + .../request/UpdateTendencyScoreRequest.java | 20 ++ .../dto/request/UpdateUserProfileRequest.java | 21 ++ .../request/UpdateUserSettingsRequest.java | 18 ++ .../user/dto/response/BootstrapResponse.java | 6 + .../user/dto/response/MyProfileResponse.java | 15 + .../response/OnboardingProfileResponse.java | 16 + .../TendencyScoreHistoryItemResponse.java | 15 + .../TendencyScoreHistoryResponse.java | 9 + .../dto/response/TendencyScoreResponse.java | 16 + .../dto/response/UpdateResultResponse.java | 6 + .../dto/response/UserProfileResponse.java | 13 + .../dto/response/UserSettingsResponse.java | 9 + .../app/domain/user/entity/AgreementType.java | 6 + .../app/domain/user/entity/CharacterType.java | 36 +++ .../user/entity/CharacterTypeConverter.java | 18 ++ .../com/swyp/app/domain/user/entity/User.java | 58 ++++ .../app/domain/user/entity/UserAgreement.java | 53 +++ .../app/domain/user/entity/UserProfile.java | 54 ++++ .../swyp/app/domain/user/entity/UserRole.java | 6 + .../app/domain/user/entity/UserSettings.java | 61 ++++ .../app/domain/user/entity/UserStatus.java | 8 + .../domain/user/entity/UserTendencyScore.java | 56 ++++ .../user/entity/UserTendencyScoreHistory.java | 48 +++ .../repository/UserAgreementRepository.java | 7 + .../repository/UserProfileRepository.java | 7 + .../user/repository/UserRepository.java | 12 + .../repository/UserSettingsRepository.java | 7 + .../UserTendencyScoreHistoryRepository.java | 13 + .../UserTendencyScoreRepository.java | 7 + .../app/domain/user/service/UserService.java | 304 ++++++++++++++++++ .../global/common/exception/ErrorCode.java | 9 +- .../exception/GlobalExceptionHandler.java | 21 +- src/test/resources/application.yml | 13 + 40 files changed, 1103 insertions(+), 19 deletions(-) create mode 100644 src/main/java/com/swyp/app/domain/user/controller/UserController.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/request/CreateOnboardingProfileRequest.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/request/UpdateTendencyScoreRequest.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/request/UpdateUserProfileRequest.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/request/UpdateUserSettingsRequest.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/BootstrapResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/MyProfileResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/OnboardingProfileResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryItemResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/UpdateResultResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/UserProfileResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/UserSettingsResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/AgreementType.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/CharacterType.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/CharacterTypeConverter.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/User.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/UserAgreement.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/UserProfile.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/UserRole.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/UserSettings.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/UserStatus.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/UserTendencyScore.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/UserTendencyScoreHistory.java create mode 100644 src/main/java/com/swyp/app/domain/user/repository/UserAgreementRepository.java create mode 100644 src/main/java/com/swyp/app/domain/user/repository/UserProfileRepository.java create mode 100644 src/main/java/com/swyp/app/domain/user/repository/UserRepository.java create mode 100644 src/main/java/com/swyp/app/domain/user/repository/UserSettingsRepository.java create mode 100644 src/main/java/com/swyp/app/domain/user/repository/UserTendencyScoreHistoryRepository.java create mode 100644 src/main/java/com/swyp/app/domain/user/repository/UserTendencyScoreRepository.java create mode 100644 src/main/java/com/swyp/app/domain/user/service/UserService.java create mode 100644 src/test/resources/application.yml diff --git a/build.gradle b/build.gradle index 7343ef1..582eb26 100644 --- a/build.gradle +++ b/build.gradle @@ -27,6 +27,7 @@ repositories { dependencies { // Web implementation 'org.springframework.boot:spring-boot-starter-webmvc' + implementation 'org.springframework.boot:spring-boot-starter-validation' // JPA implementation 'org.springframework.boot:spring-boot-starter-data-jpa' // Security @@ -41,6 +42,7 @@ dependencies { // PostgreSQL runtimeOnly 'org.postgresql:postgresql' // Test + testRuntimeOnly 'com.h2database:h2' testImplementation 'org.springframework.boot:spring-boot-starter-data-jpa-test' testImplementation 'org.springframework.boot:spring-boot-starter-security-test' testImplementation 'org.springframework.boot:spring-boot-starter-webmvc-test' diff --git a/docs/api-specs/oauth-api.md b/docs/api-specs/oauth-api.md index 4f31b61..7a7db7f 100644 --- a/docs/api-specs/oauth-api.md +++ b/docs/api-specs/oauth-api.md @@ -89,7 +89,7 @@ "data": { "access_token": "eyJhbGciOiJIUzI...", "refresh_token": "def456-ghi789...", - "user_tag": "sfit4-2", + "user_tag": "a7k2m9q1", "is_new_user": true, "status": "PENDING" }, @@ -183,4 +183,4 @@ | `401` | `AUTH_REFRESH_TOKEN_EXPIRED` | Refresh Token 만료 — 재로그인 필요 | | `403` | `USER_BANNED` | 영구 제재된 사용자 | | `403` | `USER_SUSPENDED` | 일정 기간 이용 정지된 사용자 | -| `500` | `INTERNAL_SERVER_ERROR` | 서버 오류 | \ No newline at end of file +| `500` | `INTERNAL_SERVER_ERROR` | 서버 오류 | diff --git a/docs/api-specs/user-api.md b/docs/api-specs/user-api.md index 65c9214..ee5898d 100644 --- a/docs/api-specs/user-api.md +++ b/docs/api-specs/user-api.md @@ -6,9 +6,11 @@ - 외부 응답에서는 내부 PK인 `user_id`를 노출하지 않고 `user_tag`를 사용합니다. - `nickname`은 중복 허용 프로필명입니다. - `user_tag`는 고유한 공개 식별자이며 저장 시 `@` 없이 관리합니다. +- `user_tag`는 prefix 없이 생성되는 8자리 이하의 랜덤 문자열입니다. - 프로필 아바타는 자유 입력 이모지가 아니라 `character_type` 선택 방식으로 관리합니다. - `character_type`은 소문자 `snake_case` 문자열 값으로 관리합니다. - 프로필, 설정, 성향 점수는 모두 사용자 도메인 책임입니다. +- 온보딩 완료 시 필수 약관 동의 이력은 서버에서 함께 저장합니다. - 성향 점수는 현재값을 갱신하면서 이력도 함께 적재합니다. --- @@ -52,7 +54,7 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 { "statusCode": 200, "data": { - "user_tag": "sfit4-2", + "user_tag": "a7k2m9q1", "nickname": "생각하는올빼미", "character_type": "owl", "manner_temperature": 36.5, @@ -77,7 +79,7 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 { "statusCode": 200, "data": { - "user_tag": "sfit4-2", + "user_tag": "a7k2m9q1", "nickname": "생각하는올빼미", "character_type": "owl", "manner_temperature": 36.5 @@ -98,7 +100,7 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 { "statusCode": 200, "data": { - "user_tag": "sfit4-2", + "user_tag": "a7k2m9q1", "nickname": "생각하는올빼미", "character_type": "owl", "manner_temperature": 36.5, @@ -129,7 +131,7 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 { "statusCode": 200, "data": { - "user_tag": "sfit4-2", + "user_tag": "a7k2m9q1", "nickname": "생각하는펭귄", "character_type": "penguin", "updated_at": "2026-03-08T12:00:00Z" @@ -152,10 +154,10 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 { "statusCode": 200, "data": { - "push_enabled": true, + "push_enabled": false, "email_enabled": false, - "debate_request_enabled": true, - "profile_public": true + "debate_request_enabled": false, + "profile_public": false }, "error": null } @@ -216,7 +218,7 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 { "statusCode": 200, "data": { - "user_tag": "sfit4-2", + "user_tag": "a7k2m9q1", "score_1": 30, "score_2": -20, "score_3": 55, @@ -249,7 +251,7 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 "data": { "items": [ { - "history_id": "ths_001", + "history_id": 1, "score_1": 30, "score_2": -20, "score_3": 55, @@ -286,4 +288,4 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 | Error Code | HTTP Status | 설명 | |------------|:-----------:|------| | `USER_NOT_FOUND` | `404` | 존재하지 않는 사용자 | -| `ONBOARDING_ALREADY_COMPLETED` | `409` | 이미 온보딩이 완료된 사용자 | \ No newline at end of file +| `ONBOARDING_ALREADY_COMPLETED` | `409` | 이미 온보딩이 완료된 사용자 | diff --git a/docs/erd/user-ops.puml b/docs/erd/user-ops.puml index dcfc405..8cf8d1f 100644 --- a/docs/erd/user-ops.puml +++ b/docs/erd/user-ops.puml @@ -7,7 +7,7 @@ entity "USERS\n서비스 사용자" as users { * id : BIGINT <> -- user_tag : VARCHAR(30) <> - status : ENUM('PENDING', 'ACTIVE', 'DELETED') + status : ENUM('PENDING', 'ACTIVE', 'DELETED', 'BANNED') created_at : timestamp updated_at : timestamp } @@ -26,7 +26,7 @@ entity "USER_AGREEMENTS\n사용자 동의 이력" as user_agreements { * id : BIGINT <> -- user_id : BIGINT <> - agreement_type : string + agreement_type : ENUM('TERMS_OF_SERVICE', 'PRIVACY_POLICY') version : string agreed_at : timestamp } @@ -60,4 +60,10 @@ users ||--o{ user_devices users ||--o{ user_blocks : blocker users ||--o{ user_blocks : blocked +note bottom of user_blocks + 공통 컬럼 정책 + - BaseEntity: created_at, updated_at + - agreed_at, last_seen_at 은 도메인별 개별 컬럼 +end note + @enduml diff --git a/docs/erd/user.puml b/docs/erd/user.puml index e34d53a..c057281 100644 --- a/docs/erd/user.puml +++ b/docs/erd/user.puml @@ -8,7 +8,7 @@ entity "USERS\n서비스 사용자" as users { -- user_tag : VARCHAR(30) <> role : ENUM('USER', 'ADMIN') - status : ENUM('PENDING', 'ACTIVE', 'DELETED') + status : ENUM('PENDING', 'ACTIVE', 'DELETED', 'BANNED') onboarding_completed : boolean created_at : timestamp updated_at : timestamp @@ -19,7 +19,7 @@ entity "USER_PROFILES\n사용자 프로필" as user_profiles { * user_id : BIGINT <> -- nickname : string - character_type : ENUM('owl', 'fox', '...') + character_type : ENUM('owl', 'fox', 'wolf', 'lion', 'penguin', 'bear', 'rabbit', 'cat') manner_temperature : float updated_at : timestamp } @@ -68,4 +68,10 @@ note right of user_profiles user_tag를 대외 식별자로 활용 end note +note bottom of user_tendency_score_histories + 공통 컬럼 정책 + - BaseEntity: created_at, updated_at + - deleted_at 은 users 에만 개별 보유 +end note + @enduml diff --git a/src/main/java/com/swyp/app/domain/user/controller/UserController.java b/src/main/java/com/swyp/app/domain/user/controller/UserController.java new file mode 100644 index 0000000..15c1e4e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/controller/UserController.java @@ -0,0 +1,91 @@ +package com.swyp.app.domain.user.controller; + +import com.swyp.app.domain.user.dto.request.CreateOnboardingProfileRequest; +import com.swyp.app.domain.user.dto.request.UpdateTendencyScoreRequest; +import com.swyp.app.domain.user.dto.request.UpdateUserProfileRequest; +import com.swyp.app.domain.user.dto.request.UpdateUserSettingsRequest; +import com.swyp.app.domain.user.dto.response.BootstrapResponse; +import com.swyp.app.domain.user.dto.response.MyProfileResponse; +import com.swyp.app.domain.user.dto.response.OnboardingProfileResponse; +import com.swyp.app.domain.user.dto.response.TendencyScoreHistoryResponse; +import com.swyp.app.domain.user.dto.response.TendencyScoreResponse; +import com.swyp.app.domain.user.dto.response.UpdateResultResponse; +import com.swyp.app.domain.user.dto.response.UserProfileResponse; +import com.swyp.app.domain.user.dto.response.UserSettingsResponse; +import com.swyp.app.domain.user.service.UserService; +import com.swyp.app.global.common.response.ApiResponse; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +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.PutMapping; +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; + +@RestController +@RequiredArgsConstructor +@RequestMapping("/api/v1") +public class UserController { + + private final UserService userService; + + @GetMapping("/onboarding/bootstrap") + public ApiResponse getBootstrap() { + return ApiResponse.onSuccess(userService.getBootstrap()); + } + + @PostMapping("/onboarding/profile") + public ApiResponse createOnboardingProfile( + @Valid @RequestBody CreateOnboardingProfileRequest request + ) { + return ApiResponse.onSuccess(userService.createOnboardingProfile(request)); + } + + @GetMapping("/users/{userTag}") + public ApiResponse getUserProfile(@PathVariable String userTag) { + return ApiResponse.onSuccess(userService.getUserProfile(userTag)); + } + + @GetMapping("/me/profile") + public ApiResponse getMyProfile() { + return ApiResponse.onSuccess(userService.getMyProfile()); + } + + @PatchMapping("/me/profile") + public ApiResponse updateMyProfile( + @Valid @RequestBody UpdateUserProfileRequest request + ) { + return ApiResponse.onSuccess(userService.updateMyProfile(request)); + } + + @GetMapping("/me/settings") + public ApiResponse getMySettings() { + return ApiResponse.onSuccess(userService.getMySettings()); + } + + @PatchMapping("/me/settings") + public ApiResponse updateMySettings( + @Valid @RequestBody UpdateUserSettingsRequest request + ) { + return ApiResponse.onSuccess(userService.updateMySettings(request)); + } + + @PutMapping("/me/tendency-scores") + public ApiResponse updateMyTendencyScores( + @Valid @RequestBody UpdateTendencyScoreRequest request + ) { + return ApiResponse.onSuccess(userService.updateMyTendencyScores(request)); + } + + @GetMapping("/me/tendency-scores/history") + public ApiResponse getMyTendencyScoreHistory( + @RequestParam(required = false) Long cursor, + @RequestParam(required = false) Integer size + ) { + return ApiResponse.onSuccess(userService.getMyTendencyScoreHistory(cursor, size)); + } +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/request/CreateOnboardingProfileRequest.java b/src/main/java/com/swyp/app/domain/user/dto/request/CreateOnboardingProfileRequest.java new file mode 100644 index 0000000..f00047d --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/request/CreateOnboardingProfileRequest.java @@ -0,0 +1,15 @@ +package com.swyp.app.domain.user.dto.request; + +import com.swyp.app.domain.user.entity.CharacterType; +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.NotNull; +import jakarta.validation.constraints.Size; + +public record CreateOnboardingProfileRequest( + @NotBlank + @Size(min = 2, max = 20) + String nickname, + @NotNull + CharacterType characterType +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/request/UpdateTendencyScoreRequest.java b/src/main/java/com/swyp/app/domain/user/dto/request/UpdateTendencyScoreRequest.java new file mode 100644 index 0000000..2cde0bc --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/request/UpdateTendencyScoreRequest.java @@ -0,0 +1,20 @@ +package com.swyp.app.domain.user.dto.request; + +import jakarta.validation.constraints.Max; +import jakarta.validation.constraints.Min; + +public record UpdateTendencyScoreRequest( + @Min(-100) @Max(100) + int score1, + @Min(-100) @Max(100) + int score2, + @Min(-100) @Max(100) + int score3, + @Min(-100) @Max(100) + int score4, + @Min(-100) @Max(100) + int score5, + @Min(-100) @Max(100) + int score6 +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/request/UpdateUserProfileRequest.java b/src/main/java/com/swyp/app/domain/user/dto/request/UpdateUserProfileRequest.java new file mode 100644 index 0000000..d287da7 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/request/UpdateUserProfileRequest.java @@ -0,0 +1,21 @@ +package com.swyp.app.domain.user.dto.request; + +import com.swyp.app.domain.user.entity.CharacterType; +import jakarta.validation.constraints.AssertTrue; +import jakarta.validation.constraints.Size; + +public record UpdateUserProfileRequest( + @Size(min = 2, max = 20) + String nickname, + CharacterType characterType +) { + @AssertTrue(message = "적어도 하나 이상의 프로필 값이 필요합니다.") + public boolean hasAnyFieldToUpdate() { + return nickname != null || characterType != null; + } + + @AssertTrue(message = "nickname은 공백만 입력할 수 없습니다.") + public boolean hasValidNickname() { + return nickname == null || !nickname.isBlank(); + } +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/request/UpdateUserSettingsRequest.java b/src/main/java/com/swyp/app/domain/user/dto/request/UpdateUserSettingsRequest.java new file mode 100644 index 0000000..a0a067b --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/request/UpdateUserSettingsRequest.java @@ -0,0 +1,18 @@ +package com.swyp.app.domain.user.dto.request; + +import jakarta.validation.constraints.AssertTrue; + +public record UpdateUserSettingsRequest( + Boolean pushEnabled, + Boolean emailEnabled, + Boolean debateRequestEnabled, + Boolean profilePublic +) { + @AssertTrue(message = "적어도 하나 이상의 설정값이 필요합니다.") + public boolean hasAnySettingToUpdate() { + return pushEnabled != null + || emailEnabled != null + || debateRequestEnabled != null + || profilePublic != null; + } +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/BootstrapResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/BootstrapResponse.java new file mode 100644 index 0000000..60cfd4a --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/BootstrapResponse.java @@ -0,0 +1,6 @@ +package com.swyp.app.domain.user.dto.response; + +public record BootstrapResponse( + String randomNickname +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/MyProfileResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/MyProfileResponse.java new file mode 100644 index 0000000..1f7a357 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/MyProfileResponse.java @@ -0,0 +1,15 @@ +package com.swyp.app.domain.user.dto.response; + +import com.swyp.app.domain.user.entity.CharacterType; + +import java.math.BigDecimal; +import java.time.LocalDateTime; + +public record MyProfileResponse( + String userTag, + String nickname, + CharacterType characterType, + BigDecimal mannerTemperature, + LocalDateTime updatedAt +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/OnboardingProfileResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/OnboardingProfileResponse.java new file mode 100644 index 0000000..6c67ab4 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/OnboardingProfileResponse.java @@ -0,0 +1,16 @@ +package com.swyp.app.domain.user.dto.response; + +import com.swyp.app.domain.user.entity.CharacterType; +import com.swyp.app.domain.user.entity.UserStatus; + +import java.math.BigDecimal; + +public record OnboardingProfileResponse( + String userTag, + String nickname, + CharacterType characterType, + BigDecimal mannerTemperature, + UserStatus status, + boolean onboardingCompleted +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryItemResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryItemResponse.java new file mode 100644 index 0000000..96aa08e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryItemResponse.java @@ -0,0 +1,15 @@ +package com.swyp.app.domain.user.dto.response; + +import java.time.LocalDateTime; + +public record TendencyScoreHistoryItemResponse( + Long historyId, + int score1, + int score2, + int score3, + int score4, + int score5, + int score6, + LocalDateTime createdAt +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryResponse.java new file mode 100644 index 0000000..d125ef1 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryResponse.java @@ -0,0 +1,9 @@ +package com.swyp.app.domain.user.dto.response; + +import java.util.List; + +public record TendencyScoreHistoryResponse( + List items, + Long nextCursor +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreResponse.java new file mode 100644 index 0000000..14b697b --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreResponse.java @@ -0,0 +1,16 @@ +package com.swyp.app.domain.user.dto.response; + +import java.time.LocalDateTime; + +public record TendencyScoreResponse( + String userTag, + int score1, + int score2, + int score3, + int score4, + int score5, + int score6, + LocalDateTime updatedAt, + boolean historySaved +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/UpdateResultResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/UpdateResultResponse.java new file mode 100644 index 0000000..c5ee9cb --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/UpdateResultResponse.java @@ -0,0 +1,6 @@ +package com.swyp.app.domain.user.dto.response; + +public record UpdateResultResponse( + boolean updated +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/UserProfileResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/UserProfileResponse.java new file mode 100644 index 0000000..f1bdce7 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/UserProfileResponse.java @@ -0,0 +1,13 @@ +package com.swyp.app.domain.user.dto.response; + +import com.swyp.app.domain.user.entity.CharacterType; + +import java.math.BigDecimal; + +public record UserProfileResponse( + String userTag, + String nickname, + CharacterType characterType, + BigDecimal mannerTemperature +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/UserSettingsResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/UserSettingsResponse.java new file mode 100644 index 0000000..a1c8965 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/UserSettingsResponse.java @@ -0,0 +1,9 @@ +package com.swyp.app.domain.user.dto.response; + +public record UserSettingsResponse( + boolean pushEnabled, + boolean emailEnabled, + boolean debateRequestEnabled, + boolean profilePublic +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/AgreementType.java b/src/main/java/com/swyp/app/domain/user/entity/AgreementType.java new file mode 100644 index 0000000..18be442 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/AgreementType.java @@ -0,0 +1,6 @@ +package com.swyp.app.domain.user.entity; + +public enum AgreementType { + TERMS_OF_SERVICE, + PRIVACY_POLICY +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/CharacterType.java b/src/main/java/com/swyp/app/domain/user/entity/CharacterType.java new file mode 100644 index 0000000..e26e5b6 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/CharacterType.java @@ -0,0 +1,36 @@ +package com.swyp.app.domain.user.entity; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonValue; + +import java.util.Arrays; + +public enum CharacterType { + OWL("owl"), + FOX("fox"), + WOLF("wolf"), + LION("lion"), + PENGUIN("penguin"), + BEAR("bear"), + RABBIT("rabbit"), + CAT("cat"); + + private final String value; + + CharacterType(String value) { + this.value = value; + } + + @JsonValue + public String getValue() { + return value; + } + + @JsonCreator + public static CharacterType from(String value) { + return Arrays.stream(values()) + .filter(type -> type.value.equalsIgnoreCase(value)) + .findFirst() + .orElseThrow(() -> new IllegalArgumentException("Unknown character type: " + value)); + } +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/CharacterTypeConverter.java b/src/main/java/com/swyp/app/domain/user/entity/CharacterTypeConverter.java new file mode 100644 index 0000000..287a520 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/CharacterTypeConverter.java @@ -0,0 +1,18 @@ +package com.swyp.app.domain.user.entity; + +import jakarta.persistence.AttributeConverter; +import jakarta.persistence.Converter; + +@Converter(autoApply = true) +public class CharacterTypeConverter implements AttributeConverter { + + @Override + public String convertToDatabaseColumn(CharacterType attribute) { + return attribute == null ? null : attribute.getValue(); + } + + @Override + public CharacterType convertToEntityAttribute(String dbData) { + return dbData == null ? null : CharacterType.from(dbData); + } +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/User.java b/src/main/java/com/swyp/app/domain/user/entity/User.java new file mode 100644 index 0000000..fcaaf6f --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/User.java @@ -0,0 +1,58 @@ +package com.swyp.app.domain.user.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EnumType; +import jakarta.persistence.Enumerated; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.time.LocalDateTime; + +@Getter +@Entity +@Table(name = "users") +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class User extends BaseEntity { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @Column(name = "user_tag", nullable = false, unique = true, length = 30) + private String userTag; + + @Enumerated(EnumType.STRING) + @Column(nullable = false, length = 20) + private UserRole role; + + @Enumerated(EnumType.STRING) + @Column(nullable = false, length = 20) + private UserStatus status; + + @Column(name = "onboarding_completed", nullable = false) + private boolean onboardingCompleted; + + @Column(name = "deleted_at") + private LocalDateTime deletedAt; + + @Builder + private User(String userTag, UserRole role, UserStatus status, boolean onboardingCompleted) { + this.userTag = userTag; + this.role = role; + this.status = status; + this.onboardingCompleted = onboardingCompleted; + } + + public void completeOnboarding() { + this.status = UserStatus.ACTIVE; + this.onboardingCompleted = true; + } +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/UserAgreement.java b/src/main/java/com/swyp/app/domain/user/entity/UserAgreement.java new file mode 100644 index 0000000..c719acc --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/UserAgreement.java @@ -0,0 +1,53 @@ +package com.swyp.app.domain.user.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EnumType; +import jakarta.persistence.Enumerated; +import jakarta.persistence.FetchType; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; +import jakarta.persistence.Table; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.time.LocalDateTime; + +@Getter +@Entity +@Table(name = "user_agreements") +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class UserAgreement extends BaseEntity { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id", nullable = false) + private User user; + + @Enumerated(EnumType.STRING) + @Column(name = "agreement_type", nullable = false, length = 50) + private AgreementType agreementType; + + @Column(nullable = false, length = 20) + private String version; + + @Column(name = "agreed_at", nullable = false) + private LocalDateTime agreedAt; + + @Builder + private UserAgreement(User user, AgreementType agreementType, String version, LocalDateTime agreedAt) { + this.user = user; + this.agreementType = agreementType; + this.version = version; + this.agreedAt = agreedAt; + } +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/UserProfile.java b/src/main/java/com/swyp/app/domain/user/entity/UserProfile.java new file mode 100644 index 0000000..51a7e83 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/UserProfile.java @@ -0,0 +1,54 @@ +package com.swyp.app.domain.user.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Entity; +import jakarta.persistence.FetchType; +import jakarta.persistence.Id; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.MapsId; +import jakarta.persistence.OneToOne; +import jakarta.persistence.Table; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.math.BigDecimal; + +@Getter +@Entity +@Table(name = "user_profiles") +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class UserProfile extends BaseEntity { + + @Id + private Long userId; + + @MapsId + @OneToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id") + private User user; + + private String nickname; + + private CharacterType characterType; + + private BigDecimal mannerTemperature; + + @Builder + private UserProfile(User user, String nickname, CharacterType characterType, BigDecimal mannerTemperature) { + this.user = user; + this.nickname = nickname; + this.characterType = characterType; + this.mannerTemperature = mannerTemperature; + } + + public void update(String nickname, CharacterType characterType) { + if (nickname != null && !nickname.isBlank()) { + this.nickname = nickname; + } + if (characterType != null) { + this.characterType = characterType; + } + } +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/UserRole.java b/src/main/java/com/swyp/app/domain/user/entity/UserRole.java new file mode 100644 index 0000000..60fe041 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/UserRole.java @@ -0,0 +1,6 @@ +package com.swyp.app.domain.user.entity; + +public enum UserRole { + USER, + ADMIN +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/UserSettings.java b/src/main/java/com/swyp/app/domain/user/entity/UserSettings.java new file mode 100644 index 0000000..e141593 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/UserSettings.java @@ -0,0 +1,61 @@ +package com.swyp.app.domain.user.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Entity; +import jakarta.persistence.FetchType; +import jakarta.persistence.Id; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.MapsId; +import jakarta.persistence.OneToOne; +import jakarta.persistence.Table; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +@Getter +@Entity +@Table(name = "user_settings") +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class UserSettings extends BaseEntity { + + @Id + private Long userId; + + @MapsId + @OneToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id") + private User user; + + private boolean pushEnabled; + + private boolean emailEnabled; + + private boolean debateRequestEnabled; + + private boolean profilePublic; + + @Builder + private UserSettings(User user, boolean pushEnabled, boolean emailEnabled, boolean debateRequestEnabled, boolean profilePublic) { + this.user = user; + this.pushEnabled = pushEnabled; + this.emailEnabled = emailEnabled; + this.debateRequestEnabled = debateRequestEnabled; + this.profilePublic = profilePublic; + } + + public void update(Boolean pushEnabled, Boolean emailEnabled, Boolean debateRequestEnabled, Boolean profilePublic) { + if (pushEnabled != null) { + this.pushEnabled = pushEnabled; + } + if (emailEnabled != null) { + this.emailEnabled = emailEnabled; + } + if (debateRequestEnabled != null) { + this.debateRequestEnabled = debateRequestEnabled; + } + if (profilePublic != null) { + this.profilePublic = profilePublic; + } + } +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/UserStatus.java b/src/main/java/com/swyp/app/domain/user/entity/UserStatus.java new file mode 100644 index 0000000..8b6aa8d --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/UserStatus.java @@ -0,0 +1,8 @@ +package com.swyp.app.domain.user.entity; + +public enum UserStatus { + PENDING, + ACTIVE, + DELETED, + BANNED +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScore.java b/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScore.java new file mode 100644 index 0000000..093e11e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScore.java @@ -0,0 +1,56 @@ +package com.swyp.app.domain.user.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Entity; +import jakarta.persistence.FetchType; +import jakarta.persistence.Id; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.MapsId; +import jakarta.persistence.OneToOne; +import jakarta.persistence.Table; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +@Getter +@Entity +@Table(name = "user_tendency_scores") +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class UserTendencyScore extends BaseEntity { + + @Id + private Long userId; + + @MapsId + @OneToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id") + private User user; + + private int score1; + private int score2; + private int score3; + private int score4; + private int score5; + private int score6; + + @Builder + private UserTendencyScore(User user, int score1, int score2, int score3, int score4, int score5, int score6) { + this.user = user; + this.score1 = score1; + this.score2 = score2; + this.score3 = score3; + this.score4 = score4; + this.score5 = score5; + this.score6 = score6; + } + + public void update(int score1, int score2, int score3, int score4, int score5, int score6) { + this.score1 = score1; + this.score2 = score2; + this.score3 = score3; + this.score4 = score4; + this.score5 = score5; + this.score6 = score6; + } +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScoreHistory.java b/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScoreHistory.java new file mode 100644 index 0000000..9cbf6de --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScoreHistory.java @@ -0,0 +1,48 @@ +package com.swyp.app.domain.user.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Entity; +import jakarta.persistence.FetchType; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; +import jakarta.persistence.Table; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +@Getter +@Entity +@Table(name = "user_tendency_score_histories") +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class UserTendencyScoreHistory extends BaseEntity { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id", nullable = false) + private User user; + + private int score1; + private int score2; + private int score3; + private int score4; + private int score5; + private int score6; + + @Builder + private UserTendencyScoreHistory(User user, int score1, int score2, int score3, int score4, int score5, int score6) { + this.user = user; + this.score1 = score1; + this.score2 = score2; + this.score3 = score3; + this.score4 = score4; + this.score5 = score5; + this.score6 = score6; + } +} diff --git a/src/main/java/com/swyp/app/domain/user/repository/UserAgreementRepository.java b/src/main/java/com/swyp/app/domain/user/repository/UserAgreementRepository.java new file mode 100644 index 0000000..a5da426 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/repository/UserAgreementRepository.java @@ -0,0 +1,7 @@ +package com.swyp.app.domain.user.repository; + +import com.swyp.app.domain.user.entity.UserAgreement; +import org.springframework.data.jpa.repository.JpaRepository; + +public interface UserAgreementRepository extends JpaRepository { +} diff --git a/src/main/java/com/swyp/app/domain/user/repository/UserProfileRepository.java b/src/main/java/com/swyp/app/domain/user/repository/UserProfileRepository.java new file mode 100644 index 0000000..510ef9b --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/repository/UserProfileRepository.java @@ -0,0 +1,7 @@ +package com.swyp.app.domain.user.repository; + +import com.swyp.app.domain.user.entity.UserProfile; +import org.springframework.data.jpa.repository.JpaRepository; + +public interface UserProfileRepository extends JpaRepository { +} diff --git a/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java b/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java new file mode 100644 index 0000000..7691467 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java @@ -0,0 +1,12 @@ +package com.swyp.app.domain.user.repository; + +import com.swyp.app.domain.user.entity.User; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.Optional; + +public interface UserRepository extends JpaRepository { + Optional findByUserTag(String userTag); + Optional findTopByOrderByIdDesc(); + boolean existsByUserTag(String userTag); +} diff --git a/src/main/java/com/swyp/app/domain/user/repository/UserSettingsRepository.java b/src/main/java/com/swyp/app/domain/user/repository/UserSettingsRepository.java new file mode 100644 index 0000000..6559e6f --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/repository/UserSettingsRepository.java @@ -0,0 +1,7 @@ +package com.swyp.app.domain.user.repository; + +import com.swyp.app.domain.user.entity.UserSettings; +import org.springframework.data.jpa.repository.JpaRepository; + +public interface UserSettingsRepository extends JpaRepository { +} diff --git a/src/main/java/com/swyp/app/domain/user/repository/UserTendencyScoreHistoryRepository.java b/src/main/java/com/swyp/app/domain/user/repository/UserTendencyScoreHistoryRepository.java new file mode 100644 index 0000000..e7c4d45 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/repository/UserTendencyScoreHistoryRepository.java @@ -0,0 +1,13 @@ +package com.swyp.app.domain.user.repository; + +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.entity.UserTendencyScoreHistory; +import org.springframework.data.domain.Pageable; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.List; + +public interface UserTendencyScoreHistoryRepository extends JpaRepository { + List findByUserOrderByIdDesc(User user, Pageable pageable); + List findByUserAndIdLessThanOrderByIdDesc(User user, Long id, Pageable pageable); +} diff --git a/src/main/java/com/swyp/app/domain/user/repository/UserTendencyScoreRepository.java b/src/main/java/com/swyp/app/domain/user/repository/UserTendencyScoreRepository.java new file mode 100644 index 0000000..db4324d --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/repository/UserTendencyScoreRepository.java @@ -0,0 +1,7 @@ +package com.swyp.app.domain.user.repository; + +import com.swyp.app.domain.user.entity.UserTendencyScore; +import org.springframework.data.jpa.repository.JpaRepository; + +public interface UserTendencyScoreRepository extends JpaRepository { +} diff --git a/src/main/java/com/swyp/app/domain/user/service/UserService.java b/src/main/java/com/swyp/app/domain/user/service/UserService.java new file mode 100644 index 0000000..6332c48 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/service/UserService.java @@ -0,0 +1,304 @@ +package com.swyp.app.domain.user.service; + +import com.swyp.app.domain.user.dto.request.CreateOnboardingProfileRequest; +import com.swyp.app.domain.user.dto.request.UpdateTendencyScoreRequest; +import com.swyp.app.domain.user.dto.request.UpdateUserProfileRequest; +import com.swyp.app.domain.user.dto.request.UpdateUserSettingsRequest; +import com.swyp.app.domain.user.dto.response.BootstrapResponse; +import com.swyp.app.domain.user.dto.response.MyProfileResponse; +import com.swyp.app.domain.user.dto.response.OnboardingProfileResponse; +import com.swyp.app.domain.user.dto.response.TendencyScoreHistoryItemResponse; +import com.swyp.app.domain.user.dto.response.TendencyScoreHistoryResponse; +import com.swyp.app.domain.user.dto.response.TendencyScoreResponse; +import com.swyp.app.domain.user.dto.response.UpdateResultResponse; +import com.swyp.app.domain.user.dto.response.UserProfileResponse; +import com.swyp.app.domain.user.dto.response.UserSettingsResponse; +import com.swyp.app.domain.user.entity.AgreementType; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.entity.UserAgreement; +import com.swyp.app.domain.user.entity.UserProfile; +import com.swyp.app.domain.user.entity.UserRole; +import com.swyp.app.domain.user.entity.UserSettings; +import com.swyp.app.domain.user.entity.UserStatus; +import com.swyp.app.domain.user.entity.UserTendencyScore; +import com.swyp.app.domain.user.entity.UserTendencyScoreHistory; +import com.swyp.app.domain.user.repository.UserProfileRepository; +import com.swyp.app.domain.user.repository.UserAgreementRepository; +import com.swyp.app.domain.user.repository.UserRepository; +import com.swyp.app.domain.user.repository.UserSettingsRepository; +import com.swyp.app.domain.user.repository.UserTendencyScoreHistoryRepository; +import com.swyp.app.domain.user.repository.UserTendencyScoreRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.PageRequest; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.math.BigDecimal; +import java.time.LocalDateTime; +import java.util.List; +import java.util.concurrent.ThreadLocalRandom; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class UserService { + + private static final String[] PREFIXES = {"생각하는", "집중하는", "차분한", "기민한", "용감한", "명확한"}; + private static final String[] SUFFIXES = {"올빼미", "여우", "늑대", "사자", "펭귄", "토끼", "고양이", "곰"}; + private static final BigDecimal DEFAULT_MANNER_TEMPERATURE = BigDecimal.valueOf(36.5); + private static final int DEFAULT_HISTORY_SIZE = 20; + private static final String DEFAULT_AGREEMENT_VERSION = "1.0"; + private static final String USER_TAG_CHARACTERS = "abcdefghijklmnopqrstuvwxyz0123456789"; + private static final int USER_TAG_LENGTH = 8; + + private final UserRepository userRepository; + private final UserAgreementRepository userAgreementRepository; + private final UserProfileRepository userProfileRepository; + private final UserSettingsRepository userSettingsRepository; + private final UserTendencyScoreRepository userTendencyScoreRepository; + private final UserTendencyScoreHistoryRepository userTendencyScoreHistoryRepository; + + public BootstrapResponse getBootstrap() { + return new BootstrapResponse(generateRandomNickname()); + } + + @Transactional + public OnboardingProfileResponse createOnboardingProfile(CreateOnboardingProfileRequest request) { + User user = userRepository.findTopByOrderByIdDesc() + .orElseGet(this::createPendingUser); + + if (user.isOnboardingCompleted()) { + throw new CustomException(ErrorCode.ONBOARDING_ALREADY_COMPLETED); + } + + UserProfile profile = UserProfile.builder() + .user(user) + .nickname(request.nickname()) + .characterType(request.characterType()) + .mannerTemperature(DEFAULT_MANNER_TEMPERATURE) + .build(); + + UserSettings settings = UserSettings.builder() + .user(user) + .pushEnabled(false) + .emailEnabled(false) + .debateRequestEnabled(false) + .profilePublic(false) + .build(); + + UserTendencyScore tendencyScore = UserTendencyScore.builder() + .user(user) + .score1(0) + .score2(0) + .score3(0) + .score4(0) + .score5(0) + .score6(0) + .build(); + + userProfileRepository.save(profile); + userSettingsRepository.save(settings); + userTendencyScoreRepository.save(tendencyScore); + saveRequiredAgreements(user); + + user.completeOnboarding(); + + return new OnboardingProfileResponse( + user.getUserTag(), + profile.getNickname(), + profile.getCharacterType(), + profile.getMannerTemperature(), + user.getStatus(), + user.isOnboardingCompleted() + ); + } + + public UserProfileResponse getUserProfile(String userTag) { + User user = findUserByTag(userTag); + UserProfile profile = findUserProfile(user.getId()); + return new UserProfileResponse(user.getUserTag(), profile.getNickname(), profile.getCharacterType(), profile.getMannerTemperature()); + } + + public MyProfileResponse getMyProfile() { + User user = findCurrentUser(); + UserProfile profile = findUserProfile(user.getId()); + return new MyProfileResponse( + user.getUserTag(), + profile.getNickname(), + profile.getCharacterType(), + profile.getMannerTemperature(), + profile.getUpdatedAt() + ); + } + + @Transactional + public MyProfileResponse updateMyProfile(UpdateUserProfileRequest request) { + User user = findCurrentUser(); + UserProfile profile = findUserProfile(user.getId()); + profile.update(request.nickname(), request.characterType()); + return new MyProfileResponse( + user.getUserTag(), + profile.getNickname(), + profile.getCharacterType(), + profile.getMannerTemperature(), + profile.getUpdatedAt() + ); + } + + public UserSettingsResponse getMySettings() { + UserSettings settings = findUserSettings(findCurrentUser().getId()); + return new UserSettingsResponse( + settings.isPushEnabled(), + settings.isEmailEnabled(), + settings.isDebateRequestEnabled(), + settings.isProfilePublic() + ); + } + + @Transactional + public UpdateResultResponse updateMySettings(UpdateUserSettingsRequest request) { + UserSettings settings = findUserSettings(findCurrentUser().getId()); + settings.update( + request.pushEnabled(), + request.emailEnabled(), + request.debateRequestEnabled(), + request.profilePublic() + ); + return new UpdateResultResponse(true); + } + + @Transactional + public TendencyScoreResponse updateMyTendencyScores(UpdateTendencyScoreRequest request) { + User user = findCurrentUser(); + UserTendencyScore score = findUserTendencyScore(user.getId()); + score.update( + request.score1(), + request.score2(), + request.score3(), + request.score4(), + request.score5(), + request.score6() + ); + + userTendencyScoreHistoryRepository.save(UserTendencyScoreHistory.builder() + .user(user) + .score1(request.score1()) + .score2(request.score2()) + .score3(request.score3()) + .score4(request.score4()) + .score5(request.score5()) + .score6(request.score6()) + .build()); + + return new TendencyScoreResponse( + user.getUserTag(), + score.getScore1(), + score.getScore2(), + score.getScore3(), + score.getScore4(), + score.getScore5(), + score.getScore6(), + score.getUpdatedAt(), + true + ); + } + + public TendencyScoreHistoryResponse getMyTendencyScoreHistory(Long cursor, Integer size) { + User user = findCurrentUser(); + int pageSize = size == null || size <= 0 ? DEFAULT_HISTORY_SIZE : size; + PageRequest pageable = PageRequest.of(0, pageSize); + + List histories = cursor == null + ? userTendencyScoreHistoryRepository.findByUserOrderByIdDesc(user, pageable) + : userTendencyScoreHistoryRepository.findByUserAndIdLessThanOrderByIdDesc(user, cursor, pageable); + + List items = histories.stream() + .map(history -> new TendencyScoreHistoryItemResponse( + history.getId(), + history.getScore1(), + history.getScore2(), + history.getScore3(), + history.getScore4(), + history.getScore5(), + history.getScore6(), + history.getCreatedAt() + )) + .toList(); + + Long nextCursor = histories.size() == pageSize ? histories.get(histories.size() - 1).getId() : null; + return new TendencyScoreHistoryResponse(items, nextCursor); + } + + private User findUserByTag(String userTag) { + return userRepository.findByUserTag(userTag) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + } + + private User findCurrentUser() { + return userRepository.findTopByOrderByIdDesc() + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + } + + private User createPendingUser() { + User user = User.builder() + .userTag(generateUserTag()) + .role(UserRole.USER) + .status(UserStatus.PENDING) + .onboardingCompleted(false) + .build(); + return userRepository.save(user); + } + + private void saveRequiredAgreements(User user) { + LocalDateTime agreedAt = LocalDateTime.now(); + userAgreementRepository.saveAll(List.of( + UserAgreement.builder() + .user(user) + .agreementType(AgreementType.TERMS_OF_SERVICE) + .version(DEFAULT_AGREEMENT_VERSION) + .agreedAt(agreedAt) + .build(), + UserAgreement.builder() + .user(user) + .agreementType(AgreementType.PRIVACY_POLICY) + .version(DEFAULT_AGREEMENT_VERSION) + .agreedAt(agreedAt) + .build() + )); + } + + private UserProfile findUserProfile(Long userId) { + return userProfileRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + } + + private UserSettings findUserSettings(Long userId) { + return userSettingsRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + } + + private UserTendencyScore findUserTendencyScore(Long userId) { + return userTendencyScoreRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + } + + private String generateRandomNickname() { + return PREFIXES[ThreadLocalRandom.current().nextInt(PREFIXES.length)] + + SUFFIXES[ThreadLocalRandom.current().nextInt(SUFFIXES.length)]; + } + + private String generateUserTag() { + String candidate; + do { + StringBuilder builder = new StringBuilder(USER_TAG_LENGTH); + for (int i = 0; i < USER_TAG_LENGTH; i++) { + int index = ThreadLocalRandom.current().nextInt(USER_TAG_CHARACTERS.length()); + builder.append(USER_TAG_CHARACTERS.charAt(index)); + } + candidate = builder.toString(); + } while (userRepository.existsByUserTag(candidate)); + return candidate; + } +} diff --git a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java index 122fcaa..5cef13a 100644 --- a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java +++ b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java @@ -10,12 +10,17 @@ public enum ErrorCode { // Common INTERNAL_SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "COMMON_500", "서버 에러, 관리자에게 문의하세요."), BAD_REQUEST(HttpStatus.BAD_REQUEST, "COMMON_400", "잘못된 요청입니다."), + AUTH_UNAUTHORIZED(HttpStatus.UNAUTHORIZED, "AUTH_401", "인증 정보가 필요합니다."), // Battle & Tag BATTLE_NOT_FOUND(HttpStatus.NOT_FOUND, "BATTLE_404", "존재하지 않는 배틀입니다."), - TAG_NOT_FOUND(HttpStatus.NOT_FOUND, "TAG_404", "존재하지 않는 태그입니다."); + TAG_NOT_FOUND(HttpStatus.NOT_FOUND, "TAG_404", "존재하지 않는 태그입니다."), + + // User + USER_NOT_FOUND(HttpStatus.NOT_FOUND, "USER_404", "존재하지 않는 사용자입니다."), + ONBOARDING_ALREADY_COMPLETED(HttpStatus.CONFLICT, "USER_409", "이미 온보딩이 완료된 사용자입니다."); private final HttpStatus httpStatus; private final String code; private final String message; -} \ No newline at end of file +} diff --git a/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java b/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java index aade740..135cae0 100644 --- a/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java +++ b/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java @@ -1,10 +1,14 @@ package com.swyp.app.global.common.exception; import com.swyp.app.global.common.response.ApiResponse; +import jakarta.validation.ConstraintViolationException; import lombok.extern.slf4j.Slf4j; import org.springframework.http.ResponseEntity; +import org.springframework.http.converter.HttpMessageNotReadableException; +import org.springframework.web.bind.MethodArgumentNotValidException; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.RestControllerAdvice; +import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException; @Slf4j @RestControllerAdvice @@ -18,6 +22,21 @@ public ResponseEntity> handleCustomException(CustomException e .body(ApiResponse.onFailure(code.getHttpStatus().value(), code.getCode(), code.getMessage())); } + @ExceptionHandler({ + HttpMessageNotReadableException.class, + MethodArgumentTypeMismatchException.class, + MethodArgumentNotValidException.class, + ConstraintViolationException.class, + IllegalArgumentException.class + }) + public ResponseEntity> handleBadRequest(Exception e) { + log.warn("Bad Request: {}", e.getMessage()); + ErrorCode code = ErrorCode.BAD_REQUEST; + return ResponseEntity + .status(code.getHttpStatus()) + .body(ApiResponse.onFailure(code.getHttpStatus().value(), code.getCode(), code.getMessage())); + } + @ExceptionHandler(Exception.class) public ResponseEntity> handleAllException(Exception e) { log.error("Internal Server Error: ", e); @@ -26,4 +45,4 @@ public ResponseEntity> handleAllException(Exception e) { .status(code.getHttpStatus()) .body(ApiResponse.onFailure(500, code.getCode(), code.getMessage())); } -} \ No newline at end of file +} diff --git a/src/test/resources/application.yml b/src/test/resources/application.yml new file mode 100644 index 0000000..3262fa0 --- /dev/null +++ b/src/test/resources/application.yml @@ -0,0 +1,13 @@ +spring: + datasource: + url: jdbc:h2:mem:testdb;MODE=PostgreSQL;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE + driver-class-name: org.h2.Driver + username: sa + password: + + jpa: + hibernate: + ddl-auto: create-drop + properties: + hibernate: + dialect: org.hibernate.dialect.H2Dialect From 8d57f66787673a4c578d1fb734b4733f3f591dee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EC=A4=80=ED=98=81?= <127603139+HYH0804@users.noreply.github.com> Date: Sun, 15 Mar 2026 16:05:16 +0900 Subject: [PATCH 10/70] =?UTF-8?q?#17=20[Feat]=20Perspective=20=EB=8F=84?= =?UTF-8?q?=EB=A9=94=EC=9D=B8=20=EA=B8=B0=EB=8A=A5=20=EA=B0=9C=EB=B0=9C=20?= =?UTF-8?q?(#26)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## #️⃣ 연관된 이슈 - #17 ## 📝 작업 내용 ### ✨ Feat | 내용 | 파일 | |------|------| | Perspective 엔티티 및 상태(PerspectiveStatus) 구현 | `Perspective.java`, `PerspectiveStatus.java` | | PerspectiveComment 엔티티 구현 | `PerspectiveComment.java` | | PerspectiveLike 엔티티 구현 (UUID PK + UniqueConstraint) | `PerspectiveLike.java` | | 관점 생성 / 조회 / 수정 / 삭제 API 구현 | `PerspectiveController.java`, `PerspectiveService.java` | | 내 PENDING 관점 조회 API 구현 | `PerspectiveController.java`, `PerspectiveService.java` | | 관점 댓글 생성 / 조회 / 수정 / 삭제 API 구현 | `PerspectiveCommentController.java`, `PerspectiveCommentService.java` | | 관점 좋아요 조회 / 등록 / 취소 API 구현 | `PerspectiveLikeController.java`, `PerspectiveLikeService.java` | | 흥미 기반 배틀 추천 조회 API 구현 (커서 페이지네이션, 정책 미확정) | `RecommendationController.java`, `RecommendationService.java` | | 투표 통계 조회 / 내 투표 내역 조회 API 구현 | `VoteController.java`, `VoteServiceImpl.java` | | 타 도메인 의존 서비스 인터페이스 + 구현체 구현 (Battle, Vote, User, Tag) | `BattleServiceImpl.java`,`UserQueryServiceImpl.java`, `TagServiceImpl.java` | | User 엔티티 및 Repository 구현 | `User.java`, `UserRepository.java` | | 에러코드 추가 (Perspective / Comment / Like / Vote / User) | `ErrorCode.java` | | 로컬 개발환경 DB 설정 (application-local.yml, .gitignore 추가) | `application-local.yml`, `.gitignore` | | perspectives-api.md 명세 업데이트 (내 PENDING 관점 조회 추가) | `perspectives-api.md` | ### ♻️ Refactor | 내용 | 파일 | |------|------| | 관점 목록 조회 시 PUBLISHED 상태만 반환하도록 수정 | `PerspectiveRepository.java`, `PerspectiveService.java` | | 좋아요 수 조회를 캐시 카운터 대신 실제 DB count로 변경 | `PerspectiveLikeService.java`, `PerspectiveLikeRepository.java` | | 추천 응답에 커서 페이지네이션(nextCursor, hasNext) 추가 | `RecommendationListResponse.java` | ### 🐛 Fix | 내용 | 파일 | |------|------| | 본인 관점에 좋아요 방지 로직 추가 | `PerspectiveLikeService.java` | ## 📌 공유 사항 > 1. Security 미적용으로 인해 userId가 각 Controller에 `1L`로 하드코딩되어 있습니다. Security 적용 후 `@AuthenticationPrincipal`로 교체 필요합니다. > 2. Battle / Vote / User / Tag 서비스는 각 도메인 병합 전 임시 구현으로, 추후 해당 도메인 담당자와 로직 통합이 필요합니다. > 3. 흥미 기반 배틀 추천 정책이 미확정 상태로, 현재는 빈 리스트를 반환합니다. ## ✅ 체크리스트 - [x] Reviewer에 팀원들을 선택했나요? - [x] Assignees에 본인을 선택했나요? - [x] 컨벤션에 맞는 Type을 선택했나요? - [x] Development에 이슈를 연동했나요? - [x] Merge 하려는 브랜치가 올바르게 설정되어 있나요? - [x] 컨벤션을 지키고 있나요? - [x] 로컬에서 실행했을 때 에러가 발생하지 않나요? - [x] 팀원들에게 PR 링크 공유를 했나요? ## 📸 스크린샷 Perspective 도메인 관련 스웨거 명세입니다. image ## 💬 리뷰 요구사항 > 1. 타 도메인(Battle, User, Vote, Tag) 서비스 구현체를 임시로 포함했습니다. 리뷰하실때 엔티티랑 도메인 ServiceImpl 만 확인해주시면 Merge Confilict는 제가 해결해서 Merge 시켜놓겠습니다. --- .gitignore | 3 +- build.gradle | 2 + docs/api-specs/perspectives-api.md | 36 +++++ docs/api-specs/recommendations-api.md | 120 +++----------- .../swyp/app/domain/battle/entity/Battle.java | 74 +++++++++ .../battle/entity/BattleCreatorType.java | 5 + .../domain/battle/entity/BattleOption.java | 69 +++++++++ .../battle/entity/BattleOptionLabel.java | 5 + .../domain/battle/entity/BattleStatus.java | 5 + .../app/domain/battle/entity/BattleTag.java | 46 ++++++ .../repository/BattleOptionRepository.java | 17 ++ .../battle/repository/BattleRepository.java | 9 ++ .../repository/BattleTagRepository.java | 13 ++ .../domain/battle/service/BattleService.java | 16 ++ .../battle/service/BattleServiceImpl.java | 40 +++++ .../PerspectiveCommentController.java | 80 ++++++++++ .../controller/PerspectiveController.java | 87 +++++++++++ .../controller/PerspectiveLikeController.java | 48 ++++++ .../dto/request/CreateCommentRequest.java | 8 + .../dto/request/CreatePerspectiveRequest.java | 8 + .../dto/request/UpdateCommentRequest.java | 8 + .../dto/request/UpdatePerspectiveRequest.java | 8 + .../dto/response/CommentListResponse.java | 21 +++ .../dto/response/CreateCommentResponse.java | 13 ++ .../response/CreatePerspectiveResponse.java | 12 ++ .../dto/response/LikeCountResponse.java | 5 + .../dto/response/LikeResponse.java | 5 + .../dto/response/MyPerspectiveResponse.java | 13 ++ .../dto/response/PerspectiveListResponse.java | 34 ++++ .../dto/response/UpdateCommentResponse.java | 10 ++ .../response/UpdatePerspectiveResponse.java | 10 ++ .../perspective/entity/Perspective.java | 96 ++++++++++++ .../entity/PerspectiveComment.java | 51 ++++++ .../perspective/entity/PerspectiveLike.java | 47 ++++++ .../perspective/entity/PerspectiveStatus.java | 5 + .../PerspectiveCommentRepository.java | 17 ++ .../repository/PerspectiveLikeRepository.java | 17 ++ .../repository/PerspectiveRepository.java | 26 ++++ .../service/PerspectiveCommentService.java | 123 +++++++++++++++ .../service/PerspectiveLikeService.java | 69 +++++++++ .../service/PerspectiveService.java | 146 ++++++++++++++++++ .../controller/RecommendationController.java | 33 ++++ .../response/RecommendationListResponse.java | 25 +++ .../service/RecommendationService.java | 28 ++++ .../com/swyp/app/domain/tag/entity/Tag.java | 34 ++++ .../domain/tag/repository/TagRepository.java | 9 ++ .../app/domain/tag/service/TagService.java | 11 ++ .../domain/tag/service/TagServiceImpl.java | 27 ++++ .../user/repository/UserRepository.java | 1 + .../domain/user/service/UserQueryService.java | 8 + .../user/service/UserQueryServiceImpl.java | 22 +++ .../vote/controller/VoteController.java | 38 +++++ .../vote/dto/response/MyVoteResponse.java | 14 ++ .../vote/dto/response/VoteStatsResponse.java | 19 +++ .../com/swyp/app/domain/vote/entity/Vote.java | 71 +++++++++ .../app/domain/vote/entity/VoteStatus.java | 5 + .../vote/repository/VoteRepository.java | 20 +++ .../app/domain/vote/service/VoteService.java | 15 ++ .../domain/vote/service/VoteServiceImpl.java | 81 ++++++++++ .../global/common/exception/ErrorCode.java | 20 +++ 60 files changed, 1806 insertions(+), 102 deletions(-) create mode 100644 src/main/java/com/swyp/app/domain/battle/entity/Battle.java create mode 100644 src/main/java/com/swyp/app/domain/battle/entity/BattleCreatorType.java create mode 100644 src/main/java/com/swyp/app/domain/battle/entity/BattleOption.java create mode 100644 src/main/java/com/swyp/app/domain/battle/entity/BattleOptionLabel.java create mode 100644 src/main/java/com/swyp/app/domain/battle/entity/BattleStatus.java create mode 100644 src/main/java/com/swyp/app/domain/battle/entity/BattleTag.java create mode 100644 src/main/java/com/swyp/app/domain/battle/repository/BattleOptionRepository.java create mode 100644 src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java create mode 100644 src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java create mode 100644 src/main/java/com/swyp/app/domain/battle/service/BattleService.java create mode 100644 src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveCommentController.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveLikeController.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/request/CreateCommentRequest.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/request/CreatePerspectiveRequest.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/request/UpdateCommentRequest.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/request/UpdatePerspectiveRequest.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/response/CommentListResponse.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/response/CreateCommentResponse.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/response/CreatePerspectiveResponse.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/response/LikeCountResponse.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/response/LikeResponse.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/response/MyPerspectiveResponse.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveListResponse.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/response/UpdateCommentResponse.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/response/UpdatePerspectiveResponse.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveComment.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveLike.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveStatus.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveCommentRepository.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveLikeRepository.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveRepository.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/service/PerspectiveLikeService.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java create mode 100644 src/main/java/com/swyp/app/domain/recommendation/controller/RecommendationController.java create mode 100644 src/main/java/com/swyp/app/domain/recommendation/dto/response/RecommendationListResponse.java create mode 100644 src/main/java/com/swyp/app/domain/recommendation/service/RecommendationService.java create mode 100644 src/main/java/com/swyp/app/domain/tag/entity/Tag.java create mode 100644 src/main/java/com/swyp/app/domain/tag/repository/TagRepository.java create mode 100644 src/main/java/com/swyp/app/domain/tag/service/TagService.java create mode 100644 src/main/java/com/swyp/app/domain/tag/service/TagServiceImpl.java create mode 100644 src/main/java/com/swyp/app/domain/user/service/UserQueryService.java create mode 100644 src/main/java/com/swyp/app/domain/user/service/UserQueryServiceImpl.java create mode 100644 src/main/java/com/swyp/app/domain/vote/controller/VoteController.java create mode 100644 src/main/java/com/swyp/app/domain/vote/dto/response/MyVoteResponse.java create mode 100644 src/main/java/com/swyp/app/domain/vote/dto/response/VoteStatsResponse.java create mode 100644 src/main/java/com/swyp/app/domain/vote/entity/Vote.java create mode 100644 src/main/java/com/swyp/app/domain/vote/entity/VoteStatus.java create mode 100644 src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java create mode 100644 src/main/java/com/swyp/app/domain/vote/service/VoteService.java create mode 100644 src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java diff --git a/.gitignore b/.gitignore index edc1c6e..2020e07 100644 --- a/.gitignore +++ b/.gitignore @@ -38,4 +38,5 @@ out/ ### Setting ### .env -postgres_data/ \ No newline at end of file +postgres_data/ +src/main/resources/application-local.yml \ No newline at end of file diff --git a/build.gradle b/build.gradle index 582eb26..4856d4f 100644 --- a/build.gradle +++ b/build.gradle @@ -41,6 +41,8 @@ dependencies { developmentOnly 'org.springframework.boot:spring-boot-devtools' // PostgreSQL runtimeOnly 'org.postgresql:postgresql' + // H2 (local 프로필용) + runtimeOnly 'com.h2database:h2' // Test testRuntimeOnly 'com.h2database:h2' testImplementation 'org.springframework.boot:spring-boot-starter-data-jpa-test' diff --git a/docs/api-specs/perspectives-api.md b/docs/api-specs/perspectives-api.md index 365aa73..dd60b8f 100644 --- a/docs/api-specs/perspectives-api.md +++ b/docs/api-specs/perspectives-api.md @@ -127,6 +127,42 @@ } ``` +--- +## 내 PENDING 관점 조회 API +### `GET /api/v1/battles/{battle_id}/perspectives/me/pending` + +- 특정 배틀에서 내가 작성한 관점이 PENDING 상태인 경우 반환합니다. +- UI 상단에 검수 대기 중인 내 관점을 표시하기 위한 API입니다. + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": { + "perspective_id": "perspective_001", + "content": "자기결정권은 가장 기본적인 인권이라고 생각해요.", + "status": "PENDING", + "created_at": "2026-03-11T12:00:00Z" + }, + "error": null +} +``` + +#### 예외 응답 `404 - PENDING 관점 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "PERSPECTIVE_NOT_FOUND", + "message": "존재하지 않는 관점입니다.", + "errors": [] + } +} +``` + --- ## 관점 삭제 API ### `DELETE /api/v1/perspectives/{perspective_id}` diff --git a/docs/api-specs/recommendations-api.md b/docs/api-specs/recommendations-api.md index 7d444aa..1974890 100644 --- a/docs/api-specs/recommendations-api.md +++ b/docs/api-specs/recommendations-api.md @@ -8,57 +8,10 @@ --- -## 성향 기반 연관 배틀 조회 API - -### `GET /api/v1/battles/{battle_id}/related` - -- 연관 배틀 조회 - -#### 성공 응답 `200 OK` - -```json -{ - "statusCode": 200, - "data": { - "items": [ - { - "battle_id": "battle_002", - "title": "유전자 편집 아기, 허용해야 할까?", - "tags": [ - { "tag_id": "tag_001", "name": "과학" }, - { "tag_id": "tag_002", "name": "윤리" } - ], - "options": [ - { "option_id": "option_A", "label": "A", "title": "허용" }, - { "option_id": "option_B", "label": "B", "title": "금지" } - ], - "participants_count": 890 - } - ] - }, - "error": null -} -``` - -#### 예외 응답 `404 - 배틀 없음` - -```json -{ - "statusCode": 404, - "data": null, - "error": { - "code": "BATTLE_NOT_FOUND", - "message": "존재하지 않는 배틀입니다.", - "errors": [] - } -} -``` - ---- ## 성향 기반 비슷한 유저가 들은 배틀 조회 API ### `GET /api/v1/battles/{battle_id}/recommendations/similar` -- 비슷한 유저가 들은 배틀 +- 비슷한 유저가 들은 배틀 , PM의 전략 미확정 (26.03.15) #### 성공 응답 `200 OK` @@ -69,17 +22,27 @@ "items": [ { "battle_id": "battle_002", - "title": "사형제도, 유지 vs 폐지", - "thumbnail_url": "https://cdn.pique.app/battle/002.png", + "title": "사후세계는 존재하는가, 인간이 만든 위안인가?", "tags": [ - { "tag_id": "tag_001", "name": "사회" } + { "tag_id": "tag_001", "name": "철학" } ], - "participants_count": 1500, + "participants_count": 1340, "options": [ - { "option_id": "option_A", "label": "A", "title": "유지" }, - { "option_id": "option_B", "label": "B", "title": "폐지" } - ], - "match_ratio": 87 + { + "option_id": "option_A", + "label": "A", + "title": "존재한다", + "representative": "플라톤", + "image_url": "https://cdn.pique.app/characters/platon.png" + }, + { + "option_id": "option_B", + "label": "B", + "title": "인간이 만든 위안이다", + "representative": "에피쿠로스", + "image_url": "https://cdn.pique.app/characters/epicurus.png" + } + ] } ] }, @@ -101,51 +64,6 @@ } ``` ---- -## 성향 기반 반대 성향 유저에게 인기 배틀 조회 API -### `GET /api/v1/battles/{battle_id}/recommendations/opposite` - -- 반대 성향 유저에게 인기 중인 배틀 - -#### 성공 응답 `200 OK` - -```json -{ - "statusCode": 200, - "data": { - "items": [ - { - "battle_id": "battle_003", - "title": "AI 판사, 도입해야 할까?", - "thumbnail_url": "https://cdn.pique.app/battle/003.png", - "tags": [ - { "tag_id": "tag_002", "name": "기술" } - ], - "participants_count": 780, - "options": [ - { "option_id": "option_A", "label": "A", "title": "도입" }, - { "option_id": "option_B", "label": "B", "title": "반대" } - ] - } - ] - }, - "error": null -} -``` - -#### 예외 응답 `404 - 배틀 없음` - -```json -{ - "statusCode": 404, - "data": null, - "error": { - "code": "BATTLE_NOT_FOUND", - "message": "존재하지 않는 배틀입니다.", - "errors": [] - } -} -``` --- ## 공통 에러 코드 diff --git a/src/main/java/com/swyp/app/domain/battle/entity/Battle.java b/src/main/java/com/swyp/app/domain/battle/entity/Battle.java new file mode 100644 index 0000000..2b79cc6 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/entity/Battle.java @@ -0,0 +1,74 @@ +package com.swyp.app.domain.battle.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EnumType; +import jakarta.persistence.Enumerated; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.time.LocalDate; +import java.util.UUID; + +@Getter +@Entity +@Table(name = "battles") +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class Battle extends BaseEntity { + + @Id + @GeneratedValue(strategy = GenerationType.UUID) + private UUID id; + + @Column(nullable = false, length = 255) + private String title; + + @Column(length = 500) + private String summary; + + @Column(columnDefinition = "TEXT") + private String description; + + @Column(name = "thumbnail_url", length = 500) + private String thumbnailUrl; + + @Column(name = "target_date") + private LocalDate targetDate; + + @Enumerated(EnumType.STRING) + @Column(nullable = false, length = 20) + private BattleStatus status; + + @Enumerated(EnumType.STRING) + @Column(name = "creator_type", nullable = false, length = 10) + private BattleCreatorType creatorType; + + // TODO: User 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "creator_id") 로 교체 + @Column(name = "creator_id") + private Long creatorId; + + @Column(name = "reject_reason", length = 500) + private String rejectReason; + + @Builder + private Battle(String title, String summary, String description, String thumbnailUrl, + LocalDate targetDate, BattleStatus status, BattleCreatorType creatorType, + Long creatorId, String rejectReason) { + this.title = title; + this.summary = summary; + this.description = description; + this.thumbnailUrl = thumbnailUrl; + this.targetDate = targetDate; + this.status = status; + this.creatorType = creatorType; + this.creatorId = creatorId; + this.rejectReason = rejectReason; + } +} diff --git a/src/main/java/com/swyp/app/domain/battle/entity/BattleCreatorType.java b/src/main/java/com/swyp/app/domain/battle/entity/BattleCreatorType.java new file mode 100644 index 0000000..6367ac5 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/entity/BattleCreatorType.java @@ -0,0 +1,5 @@ +package com.swyp.app.domain.battle.entity; + +public enum BattleCreatorType { + ADMIN, USER, AI +} diff --git a/src/main/java/com/swyp/app/domain/battle/entity/BattleOption.java b/src/main/java/com/swyp/app/domain/battle/entity/BattleOption.java new file mode 100644 index 0000000..54683de --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/entity/BattleOption.java @@ -0,0 +1,69 @@ +package com.swyp.app.domain.battle.entity; + +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EnumType; +import jakarta.persistence.Enumerated; +import jakarta.persistence.FetchType; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; +import jakarta.persistence.Table; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.util.UUID; + +@Getter +@Entity +@Table(name = "battle_options") +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class BattleOption { + + @Id + @GeneratedValue(strategy = GenerationType.UUID) + private UUID id; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "battle_id", nullable = false) + private Battle battle; + + @Enumerated(EnumType.STRING) + @Column(nullable = false, length = 5) + private BattleOptionLabel label; + + @Column(nullable = false, length = 100) + private String title; + + @Column(length = 255) + private String stance; + + @Column(length = 100) + private String representative; + + @Column(columnDefinition = "TEXT") + private String quote; + + @Column(columnDefinition = "jsonb") + private String keywords; + + @Column(name = "image_url", length = 500) + private String imageUrl; + + @Builder + private BattleOption(Battle battle, BattleOptionLabel label, String title, String stance, + String representative, String quote, String keywords, String imageUrl) { + this.battle = battle; + this.label = label; + this.title = title; + this.stance = stance; + this.representative = representative; + this.quote = quote; + this.keywords = keywords; + this.imageUrl = imageUrl; + } +} diff --git a/src/main/java/com/swyp/app/domain/battle/entity/BattleOptionLabel.java b/src/main/java/com/swyp/app/domain/battle/entity/BattleOptionLabel.java new file mode 100644 index 0000000..7cc4784 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/entity/BattleOptionLabel.java @@ -0,0 +1,5 @@ +package com.swyp.app.domain.battle.entity; + +public enum BattleOptionLabel { + A, B +} diff --git a/src/main/java/com/swyp/app/domain/battle/entity/BattleStatus.java b/src/main/java/com/swyp/app/domain/battle/entity/BattleStatus.java new file mode 100644 index 0000000..5c7cf55 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/entity/BattleStatus.java @@ -0,0 +1,5 @@ +package com.swyp.app.domain.battle.entity; + +public enum BattleStatus { + DRAFT, PENDING, PUBLISHED, REJECTED, ARCHIVED +} diff --git a/src/main/java/com/swyp/app/domain/battle/entity/BattleTag.java b/src/main/java/com/swyp/app/domain/battle/entity/BattleTag.java new file mode 100644 index 0000000..50ca423 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/entity/BattleTag.java @@ -0,0 +1,46 @@ +package com.swyp.app.domain.battle.entity; + +import com.swyp.app.domain.tag.entity.Tag; +import jakarta.persistence.Entity; +import jakarta.persistence.FetchType; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; +import jakarta.persistence.Table; +import jakarta.persistence.UniqueConstraint; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.util.UUID; + +@Getter +@Entity +@Table( + name = "battle_tags", + uniqueConstraints = @UniqueConstraint(columnNames = {"battle_id", "tag_id"}) +) +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class BattleTag { + + @Id + @GeneratedValue(strategy = GenerationType.UUID) + private UUID id; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "battle_id", nullable = false) + private Battle battle; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "tag_id", nullable = false) + private Tag tag; + + @Builder + private BattleTag(Battle battle, Tag tag) { + this.battle = battle; + this.tag = tag; + } +} diff --git a/src/main/java/com/swyp/app/domain/battle/repository/BattleOptionRepository.java b/src/main/java/com/swyp/app/domain/battle/repository/BattleOptionRepository.java new file mode 100644 index 0000000..6ecea26 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/repository/BattleOptionRepository.java @@ -0,0 +1,17 @@ +package com.swyp.app.domain.battle.repository; + +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.battle.entity.BattleOptionLabel; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.List; +import java.util.Optional; +import java.util.UUID; + +public interface BattleOptionRepository extends JpaRepository { + + List findByBattle(Battle battle); + + Optional findByBattleAndLabel(Battle battle, BattleOptionLabel label); +} diff --git a/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java b/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java new file mode 100644 index 0000000..b09b20e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java @@ -0,0 +1,9 @@ +package com.swyp.app.domain.battle.repository; + +import com.swyp.app.domain.battle.entity.Battle; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.UUID; + +public interface BattleRepository extends JpaRepository { +} diff --git a/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java b/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java new file mode 100644 index 0000000..ea686e3 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java @@ -0,0 +1,13 @@ +package com.swyp.app.domain.battle.repository; + +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleTag; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.List; +import java.util.UUID; + +public interface BattleTagRepository extends JpaRepository { + + List findByBattle(Battle battle); +} diff --git a/src/main/java/com/swyp/app/domain/battle/service/BattleService.java b/src/main/java/com/swyp/app/domain/battle/service/BattleService.java new file mode 100644 index 0000000..762c514 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/service/BattleService.java @@ -0,0 +1,16 @@ +package com.swyp.app.domain.battle.service; + +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.battle.entity.BattleOptionLabel; + +import java.util.UUID; + +public interface BattleService { + + Battle findById(UUID battleId); + + BattleOption findOptionById(UUID optionId); + + BattleOption findOptionByBattleIdAndLabel(UUID battleId, BattleOptionLabel label); +} diff --git a/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java b/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java new file mode 100644 index 0000000..c23d9c6 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java @@ -0,0 +1,40 @@ +package com.swyp.app.domain.battle.service; + +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.battle.entity.BattleOptionLabel; +import com.swyp.app.domain.battle.repository.BattleOptionRepository; +import com.swyp.app.domain.battle.repository.BattleRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; + +import java.util.UUID; + +@Service +@RequiredArgsConstructor +public class BattleServiceImpl implements BattleService { + + private final BattleRepository battleRepository; + private final BattleOptionRepository battleOptionRepository; + + @Override + public Battle findById(UUID battleId) { + return battleRepository.findById(battleId) + .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_NOT_FOUND)); + } + + @Override + public BattleOption findOptionById(UUID optionId) { + return battleOptionRepository.findById(optionId) + .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_NOT_FOUND)); + } + + @Override + public BattleOption findOptionByBattleIdAndLabel(UUID battleId, BattleOptionLabel label) { + Battle battle = findById(battleId); + return battleOptionRepository.findByBattleAndLabel(battle, label) + .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_NOT_FOUND)); + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveCommentController.java b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveCommentController.java new file mode 100644 index 0000000..83cfcf9 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveCommentController.java @@ -0,0 +1,80 @@ +package com.swyp.app.domain.perspective.controller; + +import com.swyp.app.domain.perspective.dto.request.CreateCommentRequest; +import com.swyp.app.domain.perspective.dto.request.UpdateCommentRequest; +import com.swyp.app.domain.perspective.dto.response.CommentListResponse; +import com.swyp.app.domain.perspective.dto.response.CreateCommentResponse; +import com.swyp.app.domain.perspective.dto.response.UpdateCommentResponse; +import com.swyp.app.domain.perspective.service.PerspectiveCommentService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +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.UUID; + +@Tag(name = "관점 댓글 (Comment)", description = "관점 댓글 생성, 조회, 수정, 삭제 API") +@RestController +@RequestMapping("/api/v1") +@RequiredArgsConstructor +public class PerspectiveCommentController { + + private final PerspectiveCommentService commentService; + + @Operation(summary = "댓글 생성", description = "특정 관점에 댓글을 작성합니다.") + @PostMapping("/perspectives/{perspectiveId}/comments") + public ApiResponse createComment( + @PathVariable UUID perspectiveId, + @RequestBody @Valid CreateCommentRequest request + ) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + return ApiResponse.onSuccess(commentService.createComment(perspectiveId, userId, request)); + } + + @Operation(summary = "댓글 목록 조회", description = "특정 관점의 댓글 목록을 커서 기반 페이지네이션으로 조회합니다.") + @GetMapping("/perspectives/{perspectiveId}/comments") + public ApiResponse getComments( + @PathVariable UUID perspectiveId, + @RequestParam(required = false) String cursor, + @RequestParam(required = false) Integer size + ) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + return ApiResponse.onSuccess(commentService.getComments(perspectiveId, userId, cursor, size)); + } + + @Operation(summary = "댓글 삭제", description = "본인이 작성한 댓글을 삭제합니다.") + @DeleteMapping("/perspectives/{perspectiveId}/comments/{commentId}") + public ApiResponse deleteComment( + @PathVariable UUID perspectiveId, + @PathVariable UUID commentId + ) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + commentService.deleteComment(perspectiveId, commentId, userId); + return ApiResponse.onSuccess(null); + } + + @Operation(summary = "댓글 수정", description = "본인이 작성한 댓글의 내용을 수정합니다.") + @PatchMapping("/perspectives/{perspectiveId}/comments/{commentId}") + public ApiResponse updateComment( + @PathVariable UUID perspectiveId, + @PathVariable UUID commentId, + @RequestBody @Valid UpdateCommentRequest request + ) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + return ApiResponse.onSuccess(commentService.updateComment(perspectiveId, commentId, userId, request)); + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java new file mode 100644 index 0000000..e0b98bd --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java @@ -0,0 +1,87 @@ +package com.swyp.app.domain.perspective.controller; + +import com.swyp.app.domain.perspective.dto.request.CreatePerspectiveRequest; +import com.swyp.app.domain.perspective.dto.request.UpdatePerspectiveRequest; +import com.swyp.app.domain.perspective.dto.response.CreatePerspectiveResponse; +import com.swyp.app.domain.perspective.dto.response.MyPerspectiveResponse; +import com.swyp.app.domain.perspective.dto.response.PerspectiveListResponse; +import com.swyp.app.domain.perspective.dto.response.UpdatePerspectiveResponse; +import com.swyp.app.domain.perspective.service.PerspectiveService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +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.UUID; + +@Tag(name = "관점 (Perspective)", description = "관점 생성, 조회, 수정, 삭제 API") +@RestController +@RequestMapping("/api/v1") +@RequiredArgsConstructor +public class PerspectiveController { + + private final PerspectiveService perspectiveService; + + // TODO: Prevote 의 여부를 Vote 도메인 개발 이후 교체 + @Operation(summary = "관점 생성", description = "특정 배틀에 대한 관점을 생성합니다. 사전 투표가 완료된 경우에만 가능합니다.") + @PostMapping("/battles/{battleId}/perspectives") + public ApiResponse createPerspective( + @PathVariable UUID battleId, + @RequestBody @Valid CreatePerspectiveRequest request + ) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + return ApiResponse.onSuccess(perspectiveService.createPerspective(battleId, userId, request)); + } + + @Operation(summary = "관점 리스트 조회", description = "특정 배틀의 관점 목록을 커서 기반 페이지네이션으로 조회합니다. optionLabel(A/B)로 필터링 가능합니다.") + @GetMapping("/battles/{battleId}/perspectives") + public ApiResponse getPerspectives( + @PathVariable UUID battleId, + @RequestParam(required = false) String cursor, + @RequestParam(required = false) Integer size, + @RequestParam(required = false) String optionLabel + ) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + return ApiResponse.onSuccess(perspectiveService.getPerspectives(battleId, userId, cursor, size, optionLabel)); + } + + @Operation(summary = "내 PENDING 관점 조회", description = "특정 배틀에서 내가 작성한 관점이 PENDING 상태인 경우 반환합니다. PENDING 관점이 없으면 404를 반환합니다.") + @GetMapping("/battles/{battleId}/perspectives/me/pending") + public ApiResponse getMyPendingPerspective(@PathVariable UUID battleId) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + return ApiResponse.onSuccess(perspectiveService.getMyPendingPerspective(battleId, userId)); + } + + @Operation(summary = "관점 삭제", description = "본인이 작성한 관점을 삭제합니다.") + @DeleteMapping("/perspectives/{perspectiveId}") + public ApiResponse deletePerspective(@PathVariable UUID perspectiveId) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + perspectiveService.deletePerspective(perspectiveId, userId); + return ApiResponse.onSuccess(null); + } + + @Operation(summary = "관점 수정", description = "본인이 작성한 관점의 내용을 수정합니다.") + @PatchMapping("/perspectives/{perspectiveId}") + public ApiResponse updatePerspective( + @PathVariable UUID perspectiveId, + @RequestBody @Valid UpdatePerspectiveRequest request + ) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + return ApiResponse.onSuccess(perspectiveService.updatePerspective(perspectiveId, userId, request)); + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveLikeController.java b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveLikeController.java new file mode 100644 index 0000000..9ce7e23 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveLikeController.java @@ -0,0 +1,48 @@ +package com.swyp.app.domain.perspective.controller; + +import com.swyp.app.domain.perspective.dto.response.LikeCountResponse; +import com.swyp.app.domain.perspective.dto.response.LikeResponse; +import com.swyp.app.domain.perspective.service.PerspectiveLikeService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import lombok.RequiredArgsConstructor; +import org.springframework.web.bind.annotation.DeleteMapping; +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.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +import java.util.UUID; + +@Tag(name = "관점 좋아요 (Like)", description = "관점 좋아요 조회, 등록, 취소 API") +@RestController +@RequestMapping("/api/v1") +@RequiredArgsConstructor +public class PerspectiveLikeController { + + private final PerspectiveLikeService likeService; + + @Operation(summary = "좋아요 수 조회", description = "특정 관점의 좋아요 수를 조회합니다.") + @GetMapping("/perspectives/{perspectiveId}/likes") + public ApiResponse getLikeCount(@PathVariable UUID perspectiveId) { + return ApiResponse.onSuccess(likeService.getLikeCount(perspectiveId)); + } + + @Operation(summary = "좋아요 등록", description = "특정 관점에 좋아요를 등록합니다.") + @PostMapping("/perspectives/{perspectiveId}/likes") + public ApiResponse addLike(@PathVariable UUID perspectiveId) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + return ApiResponse.onSuccess(likeService.addLike(perspectiveId, userId)); + } + + @Operation(summary = "좋아요 취소", description = "특정 관점에 등록한 좋아요를 취소합니다.") + @DeleteMapping("/perspectives/{perspectiveId}/likes") + public ApiResponse removeLike(@PathVariable UUID perspectiveId) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + return ApiResponse.onSuccess(likeService.removeLike(perspectiveId, userId)); + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/request/CreateCommentRequest.java b/src/main/java/com/swyp/app/domain/perspective/dto/request/CreateCommentRequest.java new file mode 100644 index 0000000..9715a68 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/request/CreateCommentRequest.java @@ -0,0 +1,8 @@ +package com.swyp.app.domain.perspective.dto.request; + +import jakarta.validation.constraints.NotBlank; + +public record CreateCommentRequest( + @NotBlank + String content +) {} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/request/CreatePerspectiveRequest.java b/src/main/java/com/swyp/app/domain/perspective/dto/request/CreatePerspectiveRequest.java new file mode 100644 index 0000000..04994b3 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/request/CreatePerspectiveRequest.java @@ -0,0 +1,8 @@ +package com.swyp.app.domain.perspective.dto.request; + +import jakarta.validation.constraints.NotBlank; + +public record CreatePerspectiveRequest( + @NotBlank + String content +) {} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/request/UpdateCommentRequest.java b/src/main/java/com/swyp/app/domain/perspective/dto/request/UpdateCommentRequest.java new file mode 100644 index 0000000..fd767a4 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/request/UpdateCommentRequest.java @@ -0,0 +1,8 @@ +package com.swyp.app.domain.perspective.dto.request; + +import jakarta.validation.constraints.NotBlank; + +public record UpdateCommentRequest( + @NotBlank + String content +) {} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/request/UpdatePerspectiveRequest.java b/src/main/java/com/swyp/app/domain/perspective/dto/request/UpdatePerspectiveRequest.java new file mode 100644 index 0000000..0cc75f3 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/request/UpdatePerspectiveRequest.java @@ -0,0 +1,8 @@ +package com.swyp.app.domain.perspective.dto.request; + +import jakarta.validation.constraints.NotBlank; + +public record UpdatePerspectiveRequest( + @NotBlank + String content +) {} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/CommentListResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/CommentListResponse.java new file mode 100644 index 0000000..fb7e85b --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/CommentListResponse.java @@ -0,0 +1,21 @@ +package com.swyp.app.domain.perspective.dto.response; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.UUID; + +public record CommentListResponse( + List items, + String nextCursor, + boolean hasNext +) { + public record Item( + UUID commentId, + UserSummary user, + String content, + boolean isMine, + LocalDateTime createdAt + ) {} + + public record UserSummary(String userTag, String nickname, String characterUrl) {} +} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/CreateCommentResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/CreateCommentResponse.java new file mode 100644 index 0000000..3709f6b --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/CreateCommentResponse.java @@ -0,0 +1,13 @@ +package com.swyp.app.domain.perspective.dto.response; + +import java.time.LocalDateTime; +import java.util.UUID; + +public record CreateCommentResponse( + UUID commentId, + UserSummary user, + String content, + LocalDateTime createdAt +) { + public record UserSummary(String userTag, String nickname, String characterUrl) {} +} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/CreatePerspectiveResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/CreatePerspectiveResponse.java new file mode 100644 index 0000000..7de585b --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/CreatePerspectiveResponse.java @@ -0,0 +1,12 @@ +package com.swyp.app.domain.perspective.dto.response; + +import com.swyp.app.domain.perspective.entity.PerspectiveStatus; + +import java.time.LocalDateTime; +import java.util.UUID; + +public record CreatePerspectiveResponse( + UUID perspectiveId, + PerspectiveStatus status, + LocalDateTime createdAt +) {} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/LikeCountResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/LikeCountResponse.java new file mode 100644 index 0000000..b0446a9 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/LikeCountResponse.java @@ -0,0 +1,5 @@ +package com.swyp.app.domain.perspective.dto.response; + +import java.util.UUID; + +public record LikeCountResponse(UUID perspectiveId, long likeCount) {} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/LikeResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/LikeResponse.java new file mode 100644 index 0000000..5f0a077 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/LikeResponse.java @@ -0,0 +1,5 @@ +package com.swyp.app.domain.perspective.dto.response; + +import java.util.UUID; + +public record LikeResponse(UUID perspectiveId, int likeCount, boolean isLiked) {} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/MyPerspectiveResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/MyPerspectiveResponse.java new file mode 100644 index 0000000..c59fe49 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/MyPerspectiveResponse.java @@ -0,0 +1,13 @@ +package com.swyp.app.domain.perspective.dto.response; + +import com.swyp.app.domain.perspective.entity.PerspectiveStatus; + +import java.time.LocalDateTime; +import java.util.UUID; + +public record MyPerspectiveResponse( + UUID perspectiveId, + String content, + PerspectiveStatus status, + LocalDateTime createdAt +) {} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveListResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveListResponse.java new file mode 100644 index 0000000..a5e535a --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveListResponse.java @@ -0,0 +1,34 @@ +package com.swyp.app.domain.perspective.dto.response; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.UUID; + +public record PerspectiveListResponse( + List items, + String nextCursor, + boolean hasNext +) { + public record Item( + UUID perspectiveId, + UserSummary user, + OptionSummary option, + String content, + int likeCount, + int commentCount, + boolean isLiked, + LocalDateTime createdAt + ) {} + + public record UserSummary( + String userTag, + String nickname, + String characterUrl + ) {} + + public record OptionSummary( + UUID optionId, + String label, + String title + ) {} +} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/UpdateCommentResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/UpdateCommentResponse.java new file mode 100644 index 0000000..302a589 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/UpdateCommentResponse.java @@ -0,0 +1,10 @@ +package com.swyp.app.domain.perspective.dto.response; + +import java.time.LocalDateTime; +import java.util.UUID; + +public record UpdateCommentResponse( + UUID commentId, + String content, + LocalDateTime updatedAt +) {} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/UpdatePerspectiveResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/UpdatePerspectiveResponse.java new file mode 100644 index 0000000..b6e9959 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/UpdatePerspectiveResponse.java @@ -0,0 +1,10 @@ +package com.swyp.app.domain.perspective.dto.response; + +import java.time.LocalDateTime; +import java.util.UUID; + +public record UpdatePerspectiveResponse( + UUID perspectiveId, + String content, + LocalDateTime updatedAt +) {} diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java b/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java new file mode 100644 index 0000000..b9cee98 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java @@ -0,0 +1,96 @@ +package com.swyp.app.domain.perspective.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EnumType; +import jakarta.persistence.Enumerated; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import jakarta.persistence.UniqueConstraint; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.util.UUID; + +@Getter +@Entity +@Table( + name = "perspectives", + uniqueConstraints = @UniqueConstraint(columnNames = {"battle_id", "user_id"}) +) +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class Perspective extends BaseEntity { + + @Id + @GeneratedValue(strategy = GenerationType.UUID) + private UUID id; + + // TODO: Battle 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "battle_id") 로 교체 + @Column(name = "battle_id", nullable = false) + private UUID battleId; + + // TODO: User 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "user_id") 로 교체 + @Column(name = "user_id", nullable = false) + private Long userId; + + // TODO: BattleOption 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "option_id") 로 교체 + @Column(name = "option_id", nullable = false) + private UUID optionId; + + @Column(nullable = false, columnDefinition = "TEXT") + private String content; + + @Column(name = "like_count", nullable = false) + private int likeCount = 0; + + @Column(name = "comment_count", nullable = false) + private int commentCount = 0; + + @Enumerated(EnumType.STRING) + @Column(nullable = false, length = 20) + private PerspectiveStatus status; + + @Builder + private Perspective(UUID battleId, Long userId, UUID optionId, String content) { + this.battleId = battleId; + this.userId = userId; + this.optionId = optionId; + this.content = content; + this.likeCount = 0; + this.commentCount = 0; + this.status = PerspectiveStatus.PENDING; + } + + public void updateContent(String content) { + this.content = content; + } + + public void publish() { + this.status = PerspectiveStatus.PUBLISHED; + } + + public void reject() { + this.status = PerspectiveStatus.REJECTED; + } + + public void incrementLikeCount() { + this.likeCount++; + } + + public void decrementLikeCount() { + if (this.likeCount > 0) this.likeCount--; + } + + public void incrementCommentCount() { + this.commentCount++; + } + + public void decrementCommentCount() { + if (this.commentCount > 0) this.commentCount--; + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveComment.java b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveComment.java new file mode 100644 index 0000000..1e5cee2 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveComment.java @@ -0,0 +1,51 @@ +package com.swyp.app.domain.perspective.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.FetchType; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; +import jakarta.persistence.Table; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.util.UUID; + +@Getter +@Entity +@Table(name = "perspective_comments") +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class PerspectiveComment extends BaseEntity { + + @Id + @GeneratedValue(strategy = GenerationType.UUID) + private UUID id; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "perspective_id", nullable = false) + private Perspective perspective; + + // TODO: User 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "user_id") 로 교체 + @Column(name = "user_id", nullable = false) + private Long userId; + + @Column(nullable = false, columnDefinition = "TEXT") + private String content; + + @Builder + private PerspectiveComment(Perspective perspective, Long userId, String content) { + this.perspective = perspective; + this.userId = userId; + this.content = content; + } + + public void updateContent(String content) { + this.content = content; + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveLike.java b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveLike.java new file mode 100644 index 0000000..8286834 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveLike.java @@ -0,0 +1,47 @@ +package com.swyp.app.domain.perspective.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.FetchType; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; +import jakarta.persistence.Table; +import jakarta.persistence.UniqueConstraint; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.util.UUID; + +@Getter +@Entity +@Table( + name = "perspective_likes", + uniqueConstraints = @UniqueConstraint(columnNames = {"perspective_id", "user_id"}) +) +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class PerspectiveLike extends BaseEntity { + + @Id + @GeneratedValue(strategy = GenerationType.UUID) + private UUID id; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "perspective_id", nullable = false) + private Perspective perspective; + + // TODO: User 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "user_id") 로 교체 + @Column(name = "user_id", nullable = false) + private Long userId; + + @Builder + private PerspectiveLike(Perspective perspective, Long userId) { + this.perspective = perspective; + this.userId = userId; + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveStatus.java b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveStatus.java new file mode 100644 index 0000000..21f7ae5 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveStatus.java @@ -0,0 +1,5 @@ +package com.swyp.app.domain.perspective.entity; + +public enum PerspectiveStatus { + PENDING, PUBLISHED, REJECTED +} diff --git a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveCommentRepository.java b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveCommentRepository.java new file mode 100644 index 0000000..1b02326 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveCommentRepository.java @@ -0,0 +1,17 @@ +package com.swyp.app.domain.perspective.repository; + +import com.swyp.app.domain.perspective.entity.Perspective; +import com.swyp.app.domain.perspective.entity.PerspectiveComment; +import org.springframework.data.domain.Pageable; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.UUID; + +public interface PerspectiveCommentRepository extends JpaRepository { + + List findByPerspectiveOrderByCreatedAtDesc(Perspective perspective, Pageable pageable); + + List findByPerspectiveAndCreatedAtBeforeOrderByCreatedAtDesc(Perspective perspective, LocalDateTime cursor, Pageable pageable); +} diff --git a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveLikeRepository.java b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveLikeRepository.java new file mode 100644 index 0000000..dff34fe --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveLikeRepository.java @@ -0,0 +1,17 @@ +package com.swyp.app.domain.perspective.repository; + +import com.swyp.app.domain.perspective.entity.Perspective; +import com.swyp.app.domain.perspective.entity.PerspectiveLike; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.Optional; +import java.util.UUID; + +public interface PerspectiveLikeRepository extends JpaRepository { + + boolean existsByPerspectiveAndUserId(Perspective perspective, Long userId); + + Optional findByPerspectiveAndUserId(Perspective perspective, Long userId); + + long countByPerspective(Perspective perspective); +} diff --git a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveRepository.java b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveRepository.java new file mode 100644 index 0000000..fde10af --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveRepository.java @@ -0,0 +1,26 @@ +package com.swyp.app.domain.perspective.repository; + +import com.swyp.app.domain.perspective.entity.Perspective; +import com.swyp.app.domain.perspective.entity.PerspectiveStatus; +import org.springframework.data.domain.Pageable; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.Optional; +import java.util.UUID; + +public interface PerspectiveRepository extends JpaRepository { + + boolean existsByBattleIdAndUserId(UUID battleId, Long userId); + + Optional findByBattleIdAndUserId(UUID battleId, Long userId); + + List findByBattleIdAndStatusOrderByCreatedAtDesc(UUID battleId, PerspectiveStatus status, Pageable pageable); + + List findByBattleIdAndStatusAndCreatedAtBeforeOrderByCreatedAtDesc(UUID battleId, PerspectiveStatus status, LocalDateTime cursor, Pageable pageable); + + List findByBattleIdAndOptionIdAndStatusOrderByCreatedAtDesc(UUID battleId, UUID optionId, PerspectiveStatus status, Pageable pageable); + + List findByBattleIdAndOptionIdAndStatusAndCreatedAtBeforeOrderByCreatedAtDesc(UUID battleId, UUID optionId, PerspectiveStatus status, LocalDateTime cursor, Pageable pageable); +} diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java new file mode 100644 index 0000000..aafddd3 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java @@ -0,0 +1,123 @@ +package com.swyp.app.domain.perspective.service; + +import com.swyp.app.domain.perspective.dto.request.CreateCommentRequest; +import com.swyp.app.domain.perspective.dto.request.UpdateCommentRequest; +import com.swyp.app.domain.perspective.dto.response.CommentListResponse; +import com.swyp.app.domain.perspective.dto.response.CreateCommentResponse; +import com.swyp.app.domain.perspective.dto.response.UpdateCommentResponse; +import com.swyp.app.domain.perspective.entity.Perspective; +import com.swyp.app.domain.perspective.entity.PerspectiveComment; +import com.swyp.app.domain.perspective.repository.PerspectiveCommentRepository; +import com.swyp.app.domain.perspective.repository.PerspectiveRepository; +import com.swyp.app.domain.user.service.UserQueryService; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.PageRequest; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.UUID; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class PerspectiveCommentService { + + private static final int DEFAULT_PAGE_SIZE = 20; + + private final PerspectiveRepository perspectiveRepository; + private final PerspectiveCommentRepository commentRepository; + private final UserQueryService userQueryService; + + @Transactional + public CreateCommentResponse createComment(UUID perspectiveId, Long userId, CreateCommentRequest request) { + Perspective perspective = findPerspectiveById(perspectiveId); + + PerspectiveComment comment = PerspectiveComment.builder() + .perspective(perspective) + .userId(userId) + .content(request.content()) + .build(); + + commentRepository.save(comment); + perspective.incrementCommentCount(); + + UserQueryService.UserSummary user = userQueryService.findSummaryById(userId); + return new CreateCommentResponse( + comment.getId(), + new CreateCommentResponse.UserSummary(user.userTag(), user.nickname(), user.characterUrl()), + comment.getContent(), + comment.getCreatedAt() + ); + } + + public CommentListResponse getComments(UUID perspectiveId, Long userId, String cursor, Integer size) { + Perspective perspective = findPerspectiveById(perspectiveId); + + int pageSize = (size == null || size <= 0) ? DEFAULT_PAGE_SIZE : size; + PageRequest pageable = PageRequest.of(0, pageSize); + + List comments = cursor == null + ? commentRepository.findByPerspectiveOrderByCreatedAtDesc(perspective, pageable) + : commentRepository.findByPerspectiveAndCreatedAtBeforeOrderByCreatedAtDesc( + perspective, LocalDateTime.parse(cursor), pageable); + + List items = comments.stream() + .map(c -> { + UserQueryService.UserSummary user = userQueryService.findSummaryById(c.getUserId()); + return new CommentListResponse.Item( + c.getId(), + new CommentListResponse.UserSummary(user.userTag(), user.nickname(), user.characterUrl()), + c.getContent(), + c.getUserId().equals(userId), + c.getCreatedAt() + ); + }) + .toList(); + + String nextCursor = comments.size() == pageSize + ? comments.get(comments.size() - 1).getCreatedAt().toString() + : null; + + return new CommentListResponse(items, nextCursor, nextCursor != null); + } + + @Transactional + public void deleteComment(UUID perspectiveId, UUID commentId, Long userId) { + Perspective perspective = findPerspectiveById(perspectiveId); + PerspectiveComment comment = findCommentById(commentId); + validateOwnership(comment, userId); + + commentRepository.delete(comment); + perspective.decrementCommentCount(); + } + + @Transactional + public UpdateCommentResponse updateComment(UUID perspectiveId, UUID commentId, Long userId, UpdateCommentRequest request) { + findPerspectiveById(perspectiveId); + PerspectiveComment comment = findCommentById(commentId); + validateOwnership(comment, userId); + + comment.updateContent(request.content()); + return new UpdateCommentResponse(comment.getId(), comment.getContent(), comment.getUpdatedAt()); + } + + private Perspective findPerspectiveById(UUID perspectiveId) { + return perspectiveRepository.findById(perspectiveId) + .orElseThrow(() -> new CustomException(ErrorCode.PERSPECTIVE_NOT_FOUND)); + } + + private PerspectiveComment findCommentById(UUID commentId) { + return commentRepository.findById(commentId) + .orElseThrow(() -> new CustomException(ErrorCode.COMMENT_NOT_FOUND)); + } + + private void validateOwnership(PerspectiveComment comment, Long userId) { + if (!comment.getUserId().equals(userId)) { + throw new CustomException(ErrorCode.COMMENT_FORBIDDEN); + } + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveLikeService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveLikeService.java new file mode 100644 index 0000000..7d419e4 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveLikeService.java @@ -0,0 +1,69 @@ +package com.swyp.app.domain.perspective.service; + +import com.swyp.app.domain.perspective.dto.response.LikeCountResponse; +import com.swyp.app.domain.perspective.dto.response.LikeResponse; +import com.swyp.app.domain.perspective.entity.Perspective; +import com.swyp.app.domain.perspective.entity.PerspectiveLike; +import com.swyp.app.domain.perspective.repository.PerspectiveLikeRepository; +import com.swyp.app.domain.perspective.repository.PerspectiveRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.UUID; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class PerspectiveLikeService { + + private final PerspectiveRepository perspectiveRepository; + private final PerspectiveLikeRepository likeRepository; + + public LikeCountResponse getLikeCount(UUID perspectiveId) { + Perspective perspective = findPerspectiveById(perspectiveId); + long likeCount = likeRepository.countByPerspective(perspective); + return new LikeCountResponse(perspective.getId(), likeCount); + } + + @Transactional + public LikeResponse addLike(UUID perspectiveId, Long userId) { + Perspective perspective = findPerspectiveById(perspectiveId); + + if (perspective.getUserId().equals(userId)) { + throw new CustomException(ErrorCode.LIKE_SELF_FORBIDDEN); + } + + if (likeRepository.existsByPerspectiveAndUserId(perspective, userId)) { + throw new CustomException(ErrorCode.LIKE_ALREADY_EXISTS); + } + + likeRepository.save(PerspectiveLike.builder() + .perspective(perspective) + .userId(userId) + .build()); + perspective.incrementLikeCount(); + + return new LikeResponse(perspective.getId(), perspective.getLikeCount(), true); + } + + @Transactional + public LikeResponse removeLike(UUID perspectiveId, Long userId) { + Perspective perspective = findPerspectiveById(perspectiveId); + + PerspectiveLike like = likeRepository.findByPerspectiveAndUserId(perspective, userId) + .orElseThrow(() -> new CustomException(ErrorCode.LIKE_NOT_FOUND)); + + likeRepository.delete(like); + perspective.decrementLikeCount(); + + return new LikeResponse(perspective.getId(), perspective.getLikeCount(), false); + } + + private Perspective findPerspectiveById(UUID perspectiveId) { + return perspectiveRepository.findById(perspectiveId) + .orElseThrow(() -> new CustomException(ErrorCode.PERSPECTIVE_NOT_FOUND)); + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java new file mode 100644 index 0000000..85bca44 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java @@ -0,0 +1,146 @@ +package com.swyp.app.domain.perspective.service; + +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.battle.entity.BattleOptionLabel; +import com.swyp.app.domain.battle.service.BattleService; +import com.swyp.app.domain.perspective.entity.PerspectiveStatus; +import com.swyp.app.domain.perspective.dto.request.CreatePerspectiveRequest; +import com.swyp.app.domain.perspective.dto.request.UpdatePerspectiveRequest; +import com.swyp.app.domain.perspective.dto.response.CreatePerspectiveResponse; +import com.swyp.app.domain.perspective.dto.response.MyPerspectiveResponse; +import com.swyp.app.domain.perspective.dto.response.PerspectiveListResponse; +import com.swyp.app.domain.perspective.dto.response.UpdatePerspectiveResponse; +import com.swyp.app.domain.perspective.entity.Perspective; +import com.swyp.app.domain.perspective.repository.PerspectiveLikeRepository; +import com.swyp.app.domain.perspective.repository.PerspectiveRepository; +import com.swyp.app.domain.user.service.UserQueryService; +import com.swyp.app.domain.vote.service.VoteService; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.PageRequest; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.UUID; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class PerspectiveService { + + private static final int DEFAULT_PAGE_SIZE = 20; + + private final PerspectiveRepository perspectiveRepository; + private final PerspectiveLikeRepository perspectiveLikeRepository; + private final BattleService battleService; + private final VoteService voteService; + private final UserQueryService userQueryService; + + @Transactional + public CreatePerspectiveResponse createPerspective(UUID battleId, Long userId, CreatePerspectiveRequest request) { + battleService.findById(battleId); + + if (perspectiveRepository.existsByBattleIdAndUserId(battleId, userId)) { + throw new CustomException(ErrorCode.PERSPECTIVE_ALREADY_EXISTS); + } + + UUID optionId = voteService.findPreVoteOptionId(battleId, userId); + + Perspective perspective = Perspective.builder() + .battleId(battleId) + .userId(userId) + .optionId(optionId) + .content(request.content()) + .build(); + + Perspective saved = perspectiveRepository.save(perspective); + return new CreatePerspectiveResponse(saved.getId(), saved.getStatus(), saved.getCreatedAt()); + } + + public PerspectiveListResponse getPerspectives(UUID battleId, Long userId, String cursor, Integer size, String optionLabel) { + battleService.findById(battleId); + + int pageSize = (size == null || size <= 0) ? DEFAULT_PAGE_SIZE : size; + PageRequest pageable = PageRequest.of(0, pageSize); + + List perspectives; + + if (optionLabel != null) { + BattleOptionLabel label = BattleOptionLabel.valueOf(optionLabel.toUpperCase()); + BattleOption option = battleService.findOptionByBattleIdAndLabel(battleId, label); + perspectives = cursor == null + ? perspectiveRepository.findByBattleIdAndOptionIdAndStatusOrderByCreatedAtDesc(battleId, option.getId(), PerspectiveStatus.PUBLISHED, pageable) + : perspectiveRepository.findByBattleIdAndOptionIdAndStatusAndCreatedAtBeforeOrderByCreatedAtDesc(battleId, option.getId(), PerspectiveStatus.PUBLISHED, LocalDateTime.parse(cursor), pageable); + } else { + perspectives = cursor == null + ? perspectiveRepository.findByBattleIdAndStatusOrderByCreatedAtDesc(battleId, PerspectiveStatus.PUBLISHED, pageable) + : perspectiveRepository.findByBattleIdAndStatusAndCreatedAtBeforeOrderByCreatedAtDesc(battleId, PerspectiveStatus.PUBLISHED, LocalDateTime.parse(cursor), pageable); + } + + List items = perspectives.stream() + .map(p -> { + UserQueryService.UserSummary user = userQueryService.findSummaryById(p.getUserId()); + BattleOption option = battleService.findOptionById(p.getOptionId()); + boolean isLiked = perspectiveLikeRepository.existsByPerspectiveAndUserId(p, userId); + return new PerspectiveListResponse.Item( + p.getId(), + new PerspectiveListResponse.UserSummary(user.userTag(), user.nickname(), user.characterUrl()), + new PerspectiveListResponse.OptionSummary(option.getId(), option.getLabel().name(), option.getTitle()), + p.getContent(), + p.getLikeCount(), + p.getCommentCount(), + isLiked, + p.getCreatedAt() + ); + }) + .toList(); + + String nextCursor = perspectives.size() == pageSize + ? perspectives.get(perspectives.size() - 1).getCreatedAt().toString() + : null; + + return new PerspectiveListResponse(items, nextCursor, nextCursor != null); + } + + @Transactional + public void deletePerspective(UUID perspectiveId, Long userId) { + Perspective perspective = findPerspectiveById(perspectiveId); + validateOwnership(perspective, userId); + perspectiveRepository.delete(perspective); + } + + @Transactional + public UpdatePerspectiveResponse updatePerspective(UUID perspectiveId, Long userId, UpdatePerspectiveRequest request) { + Perspective perspective = findPerspectiveById(perspectiveId); + validateOwnership(perspective, userId); + perspective.updateContent(request.content()); + return new UpdatePerspectiveResponse(perspective.getId(), perspective.getContent(), perspective.getUpdatedAt()); + } + + public MyPerspectiveResponse getMyPendingPerspective(UUID battleId, Long userId) { + battleService.findById(battleId); + Perspective perspective = perspectiveRepository.findByBattleIdAndUserId(battleId, userId) + .filter(p -> p.getStatus() == PerspectiveStatus.PENDING) + .orElseThrow(() -> new CustomException(ErrorCode.PERSPECTIVE_NOT_FOUND)); + return new MyPerspectiveResponse( + perspective.getId(), + perspective.getContent(), + perspective.getStatus(), + perspective.getCreatedAt() + ); + } + + private Perspective findPerspectiveById(UUID perspectiveId) { + return perspectiveRepository.findById(perspectiveId) + .orElseThrow(() -> new CustomException(ErrorCode.PERSPECTIVE_NOT_FOUND)); + } + + private void validateOwnership(Perspective perspective, Long userId) { + if (!perspective.getUserId().equals(userId)) { + throw new CustomException(ErrorCode.PERSPECTIVE_FORBIDDEN); + } + } +} diff --git a/src/main/java/com/swyp/app/domain/recommendation/controller/RecommendationController.java b/src/main/java/com/swyp/app/domain/recommendation/controller/RecommendationController.java new file mode 100644 index 0000000..37b3a26 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/recommendation/controller/RecommendationController.java @@ -0,0 +1,33 @@ +package com.swyp.app.domain.recommendation.controller; + +import com.swyp.app.domain.recommendation.dto.response.RecommendationListResponse; +import com.swyp.app.domain.recommendation.service.RecommendationService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import lombok.RequiredArgsConstructor; +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; + +import java.util.UUID; + +@Tag(name = "추천 (Recommendation)", description = "배틀 추천 API") +@RestController +@RequestMapping("/api/v1") +@RequiredArgsConstructor +public class RecommendationController { + + private final RecommendationService recommendationService; + + @Operation(summary = "흥미 기반 배틀 추천 조회", description = "특정 배틀 기반으로 흥미로운 배틀 목록을 추천합니다. (추천 정책 미확정)") + @GetMapping("/battles/{battleId}/recommendations/interesting") + public ApiResponse getInterestingBattles( + @PathVariable UUID battleId, + @RequestParam(required = false) String cursor, + @RequestParam(required = false) Integer size) { + return ApiResponse.onSuccess(recommendationService.getInterestingBattles(battleId, cursor, size)); + } +} diff --git a/src/main/java/com/swyp/app/domain/recommendation/dto/response/RecommendationListResponse.java b/src/main/java/com/swyp/app/domain/recommendation/dto/response/RecommendationListResponse.java new file mode 100644 index 0000000..2aeae67 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/recommendation/dto/response/RecommendationListResponse.java @@ -0,0 +1,25 @@ +package com.swyp.app.domain.recommendation.dto.response; + +import java.util.List; +import java.util.UUID; + +public record RecommendationListResponse(List items, String nextCursor, boolean hasNext) { + + public record Item( + UUID battleId, + String title, + List tags, + int participantsCount, + List options + ) {} + + public record TagSummary(UUID tagId, String name) {} + + public record OptionSummary( + UUID optionId, + String label, + String title, + String representative, + String imageUrl + ) {} +} diff --git a/src/main/java/com/swyp/app/domain/recommendation/service/RecommendationService.java b/src/main/java/com/swyp/app/domain/recommendation/service/RecommendationService.java new file mode 100644 index 0000000..bcec8f0 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/recommendation/service/RecommendationService.java @@ -0,0 +1,28 @@ +package com.swyp.app.domain.recommendation.service; + +import com.swyp.app.domain.battle.service.BattleService; +import com.swyp.app.domain.recommendation.dto.response.RecommendationListResponse; +import com.swyp.app.domain.tag.service.TagService; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.List; +import java.util.UUID; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class RecommendationService { + + private final BattleService battleService; + private final TagService tagService; + + public RecommendationListResponse getInterestingBattles(UUID battleId, String cursor, Integer size) { + battleService.findById(battleId); + + // TODO: 흥미 기반 배틀 추천 정책 미확정 (추후 구현) + + return new RecommendationListResponse(List.of(), null, false); + } +} diff --git a/src/main/java/com/swyp/app/domain/tag/entity/Tag.java b/src/main/java/com/swyp/app/domain/tag/entity/Tag.java new file mode 100644 index 0000000..b4ed127 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/tag/entity/Tag.java @@ -0,0 +1,34 @@ +package com.swyp.app.domain.tag.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.Table; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.util.UUID; + +@Getter +@Entity +@Table(name = "tags") +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class Tag extends BaseEntity { + + @Id + @GeneratedValue(strategy = GenerationType.UUID) + private UUID id; + + @Column(nullable = false, unique = true, length = 50) + private String name; + + @Builder + private Tag(String name) { + this.name = name; + } +} diff --git a/src/main/java/com/swyp/app/domain/tag/repository/TagRepository.java b/src/main/java/com/swyp/app/domain/tag/repository/TagRepository.java new file mode 100644 index 0000000..4abc69c --- /dev/null +++ b/src/main/java/com/swyp/app/domain/tag/repository/TagRepository.java @@ -0,0 +1,9 @@ +package com.swyp.app.domain.tag.repository; + +import com.swyp.app.domain.tag.entity.Tag; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.UUID; + +public interface TagRepository extends JpaRepository { +} diff --git a/src/main/java/com/swyp/app/domain/tag/service/TagService.java b/src/main/java/com/swyp/app/domain/tag/service/TagService.java new file mode 100644 index 0000000..7be5db8 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/tag/service/TagService.java @@ -0,0 +1,11 @@ +package com.swyp.app.domain.tag.service; + +import com.swyp.app.domain.tag.entity.Tag; + +import java.util.List; +import java.util.UUID; + +public interface TagService { + + List findByBattleId(UUID battleId); +} diff --git a/src/main/java/com/swyp/app/domain/tag/service/TagServiceImpl.java b/src/main/java/com/swyp/app/domain/tag/service/TagServiceImpl.java new file mode 100644 index 0000000..60fd259 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/tag/service/TagServiceImpl.java @@ -0,0 +1,27 @@ +package com.swyp.app.domain.tag.service; + +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.repository.BattleTagRepository; +import com.swyp.app.domain.battle.service.BattleService; +import com.swyp.app.domain.tag.entity.Tag; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; + +import java.util.List; +import java.util.UUID; + +@Service +@RequiredArgsConstructor +public class TagServiceImpl implements TagService { + + private final BattleService battleService; + private final BattleTagRepository battleTagRepository; + + @Override + public List findByBattleId(UUID battleId) { + Battle battle = battleService.findById(battleId); + return battleTagRepository.findByBattle(battle).stream() + .map(bt -> bt.getTag()) + .toList(); + } +} diff --git a/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java b/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java index 7691467..3e430c8 100644 --- a/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java +++ b/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java @@ -3,6 +3,7 @@ import com.swyp.app.domain.user.entity.User; import org.springframework.data.jpa.repository.JpaRepository; +public interface UserRepository extends JpaRepository { import java.util.Optional; public interface UserRepository extends JpaRepository { diff --git a/src/main/java/com/swyp/app/domain/user/service/UserQueryService.java b/src/main/java/com/swyp/app/domain/user/service/UserQueryService.java new file mode 100644 index 0000000..7cfa195 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/service/UserQueryService.java @@ -0,0 +1,8 @@ +package com.swyp.app.domain.user.service; + +public interface UserQueryService { + + UserSummary findSummaryById(Long userId); + + record UserSummary(String userTag, String nickname, String characterUrl) {} +} diff --git a/src/main/java/com/swyp/app/domain/user/service/UserQueryServiceImpl.java b/src/main/java/com/swyp/app/domain/user/service/UserQueryServiceImpl.java new file mode 100644 index 0000000..cf2aefe --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/service/UserQueryServiceImpl.java @@ -0,0 +1,22 @@ +package com.swyp.app.domain.user.service; + +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.repository.UserRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; + +@Service +@RequiredArgsConstructor +public class UserQueryServiceImpl implements UserQueryService { + + private final UserRepository userRepository; + + @Override + public UserSummary findSummaryById(Long userId) { + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + return new UserSummary(user.getUserTag(), user.getNickname(), user.getCharacterUrl()); + } +} diff --git a/src/main/java/com/swyp/app/domain/vote/controller/VoteController.java b/src/main/java/com/swyp/app/domain/vote/controller/VoteController.java new file mode 100644 index 0000000..3575186 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/vote/controller/VoteController.java @@ -0,0 +1,38 @@ +package com.swyp.app.domain.vote.controller; + +import com.swyp.app.domain.vote.dto.response.MyVoteResponse; +import com.swyp.app.domain.vote.dto.response.VoteStatsResponse; +import com.swyp.app.domain.vote.service.VoteService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import lombok.RequiredArgsConstructor; +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.RestController; + +import java.util.UUID; + +@Tag(name = "투표 (Vote)", description = "투표 통계 및 내 투표 내역 조회 API") +@RestController +@RequestMapping("/api/v1") +@RequiredArgsConstructor +public class VoteController { + + private final VoteService voteService; + + @Operation(summary = "투표 통계 조회", description = "특정 배틀의 옵션별 투표 수와 비율을 조회합니다.") + @GetMapping("/battles/{battleId}/vote-stats") + public ApiResponse getVoteStats(@PathVariable UUID battleId) { + return ApiResponse.onSuccess(voteService.getVoteStats(battleId)); + } + + @Operation(summary = "내 투표 내역 조회", description = "특정 배틀에 대한 내 사전/사후 투표 내역과 생각 변화 여부를 조회합니다.") + @GetMapping("/battles/{battleId}/votes/me") + public ApiResponse getMyVote(@PathVariable UUID battleId) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + return ApiResponse.onSuccess(voteService.getMyVote(battleId, userId)); + } +} diff --git a/src/main/java/com/swyp/app/domain/vote/dto/response/MyVoteResponse.java b/src/main/java/com/swyp/app/domain/vote/dto/response/MyVoteResponse.java new file mode 100644 index 0000000..4a99b1d --- /dev/null +++ b/src/main/java/com/swyp/app/domain/vote/dto/response/MyVoteResponse.java @@ -0,0 +1,14 @@ +package com.swyp.app.domain.vote.dto.response; + +import com.swyp.app.domain.vote.entity.VoteStatus; + +import java.util.UUID; + +public record MyVoteResponse( + OptionInfo preVote, + OptionInfo postVote, + boolean mindChanged, + VoteStatus status +) { + public record OptionInfo(UUID optionId, String label, String title) {} +} diff --git a/src/main/java/com/swyp/app/domain/vote/dto/response/VoteStatsResponse.java b/src/main/java/com/swyp/app/domain/vote/dto/response/VoteStatsResponse.java new file mode 100644 index 0000000..6a7122e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/vote/dto/response/VoteStatsResponse.java @@ -0,0 +1,19 @@ +package com.swyp.app.domain.vote.dto.response; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.UUID; + +public record VoteStatsResponse( + List options, + long totalCount, + LocalDateTime updatedAt +) { + public record OptionStat( + UUID optionId, + String label, + String title, + long voteCount, + double ratio + ) {} +} diff --git a/src/main/java/com/swyp/app/domain/vote/entity/Vote.java b/src/main/java/com/swyp/app/domain/vote/entity/Vote.java new file mode 100644 index 0000000..2851acb --- /dev/null +++ b/src/main/java/com/swyp/app/domain/vote/entity/Vote.java @@ -0,0 +1,71 @@ +package com.swyp.app.domain.vote.entity; + +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EnumType; +import jakarta.persistence.Enumerated; +import jakarta.persistence.FetchType; +import jakarta.persistence.GeneratedValue; +import jakarta.persistence.GenerationType; +import jakarta.persistence.Id; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; +import jakarta.persistence.Table; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.util.UUID; + +@Getter +@Entity +@Table(name = "votes") +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class Vote extends BaseEntity { + + @Id + @GeneratedValue(strategy = GenerationType.UUID) + private UUID id; + + // TODO: User 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "user_id") 로 교체 + @Column(name = "user_id", nullable = false) + private Long userId; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "battle_id", nullable = false) + private Battle battle; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "pre_vote_option_id") + private BattleOption preVoteOption; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "post_vote_option_id") + private BattleOption postVoteOption; + + @Column(name = "mind_changed", nullable = false) + private boolean mindChanged; + + @Column(name = "reward_credits", nullable = false) + private int rewardCredits; + + @Enumerated(EnumType.STRING) + @Column(nullable = false, length = 20) + private VoteStatus status; + + @Builder + private Vote(Long userId, Battle battle, BattleOption preVoteOption, + BattleOption postVoteOption, boolean mindChanged, int rewardCredits, VoteStatus status) { + this.userId = userId; + this.battle = battle; + this.preVoteOption = preVoteOption; + this.postVoteOption = postVoteOption; + this.mindChanged = mindChanged; + this.rewardCredits = rewardCredits; + this.status = status; + } +} diff --git a/src/main/java/com/swyp/app/domain/vote/entity/VoteStatus.java b/src/main/java/com/swyp/app/domain/vote/entity/VoteStatus.java new file mode 100644 index 0000000..478c63d --- /dev/null +++ b/src/main/java/com/swyp/app/domain/vote/entity/VoteStatus.java @@ -0,0 +1,5 @@ +package com.swyp.app.domain.vote.entity; + +public enum VoteStatus { + NONE, PRE_VOTED, POST_VOTED +} diff --git a/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java b/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java new file mode 100644 index 0000000..9410f06 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java @@ -0,0 +1,20 @@ +package com.swyp.app.domain.vote.repository; + +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.vote.entity.Vote; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.Optional; +import java.util.UUID; + +public interface VoteRepository extends JpaRepository { + + Optional findByBattleAndUserId(Battle battle, Long userId); + + long countByBattle(Battle battle); + + long countByBattleAndPreVoteOption(Battle battle, BattleOption preVoteOption); + + Optional findTopByBattleOrderByUpdatedAtDesc(Battle battle); +} diff --git a/src/main/java/com/swyp/app/domain/vote/service/VoteService.java b/src/main/java/com/swyp/app/domain/vote/service/VoteService.java new file mode 100644 index 0000000..0c8b8d1 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/vote/service/VoteService.java @@ -0,0 +1,15 @@ +package com.swyp.app.domain.vote.service; + +import com.swyp.app.domain.vote.dto.response.MyVoteResponse; +import com.swyp.app.domain.vote.dto.response.VoteStatsResponse; + +import java.util.UUID; + +public interface VoteService { + + UUID findPreVoteOptionId(UUID battleId, Long userId); + + VoteStatsResponse getVoteStats(UUID battleId); + + MyVoteResponse getMyVote(UUID battleId, Long userId); +} diff --git a/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java b/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java new file mode 100644 index 0000000..8e7bb9f --- /dev/null +++ b/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java @@ -0,0 +1,81 @@ +package com.swyp.app.domain.vote.service; + +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.battle.repository.BattleOptionRepository; +import com.swyp.app.domain.battle.service.BattleService; +import com.swyp.app.domain.vote.dto.response.MyVoteResponse; +import com.swyp.app.domain.vote.dto.response.VoteStatsResponse; +import com.swyp.app.domain.vote.entity.Vote; +import com.swyp.app.domain.vote.repository.VoteRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.time.LocalDateTime; +import java.util.List; +import java.util.UUID; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class VoteServiceImpl implements VoteService { + + private final VoteRepository voteRepository; + private final BattleService battleService; + private final BattleOptionRepository battleOptionRepository; + + @Override + public UUID findPreVoteOptionId(UUID battleId, Long userId) { + Battle battle = battleService.findById(battleId); + Vote vote = voteRepository.findByBattleAndUserId(battle, userId) + .orElseThrow(() -> new CustomException(ErrorCode.VOTE_NOT_FOUND)); + if (vote.getPreVoteOption() == null) { + throw new CustomException(ErrorCode.PERSPECTIVE_POST_VOTE_REQUIRED); + } + return vote.getPreVoteOption().getId(); + } + + @Override + public VoteStatsResponse getVoteStats(UUID battleId) { + Battle battle = battleService.findById(battleId); + List options = battleOptionRepository.findByBattle(battle); + long totalCount = voteRepository.countByBattle(battle); + + List stats = options.stream() + .map(option -> { + long count = voteRepository.countByBattleAndPreVoteOption(battle, option); + double ratio = totalCount > 0 + ? Math.round((double) count / totalCount * 1000.0) / 10.0 + : 0.0; + return new VoteStatsResponse.OptionStat( + option.getId(), option.getLabel().name(), option.getTitle(), count, ratio); + }) + .toList(); + + LocalDateTime updatedAt = voteRepository.findTopByBattleOrderByUpdatedAtDesc(battle) + .map(Vote::getUpdatedAt) + .orElse(null); + + return new VoteStatsResponse(stats, totalCount, updatedAt); + } + + @Override + public MyVoteResponse getMyVote(UUID battleId, Long userId) { + Battle battle = battleService.findById(battleId); + Vote vote = voteRepository.findByBattleAndUserId(battle, userId) + .orElseThrow(() -> new CustomException(ErrorCode.VOTE_NOT_FOUND)); + + MyVoteResponse.OptionInfo preVote = toOptionInfo(vote.getPreVoteOption()); + MyVoteResponse.OptionInfo postVote = toOptionInfo(vote.getPostVoteOption()); + + return new MyVoteResponse(preVote, postVote, vote.isMindChanged(), vote.getStatus()); + } + + private MyVoteResponse.OptionInfo toOptionInfo(BattleOption option) { + if (option == null) return null; + return new MyVoteResponse.OptionInfo(option.getId(), option.getLabel().name(), option.getTitle()); + } +} diff --git a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java index 5cef13a..313c074 100644 --- a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java +++ b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java @@ -12,10 +12,30 @@ public enum ErrorCode { BAD_REQUEST(HttpStatus.BAD_REQUEST, "COMMON_400", "잘못된 요청입니다."), AUTH_UNAUTHORIZED(HttpStatus.UNAUTHORIZED, "AUTH_401", "인증 정보가 필요합니다."), + // User + USER_NOT_FOUND(HttpStatus.NOT_FOUND, "USER_404", "존재하지 않는 유저입니다."), + // Battle & Tag BATTLE_NOT_FOUND(HttpStatus.NOT_FOUND, "BATTLE_404", "존재하지 않는 배틀입니다."), TAG_NOT_FOUND(HttpStatus.NOT_FOUND, "TAG_404", "존재하지 않는 태그입니다."), + // Perspective + PERSPECTIVE_NOT_FOUND(HttpStatus.NOT_FOUND, "PERSPECTIVE_404", "존재하지 않는 관점입니다."), + PERSPECTIVE_ALREADY_EXISTS(HttpStatus.CONFLICT, "PERSPECTIVE_409", "이미 관점을 작성한 배틀입니다."), + PERSPECTIVE_FORBIDDEN(HttpStatus.FORBIDDEN, "PERSPECTIVE_403", "본인 관점만 수정/삭제할 수 있습니다."), + PERSPECTIVE_POST_VOTE_REQUIRED(HttpStatus.CONFLICT, "PERSPECTIVE_VOTE_409", "사후 투표가 완료되지 않았습니다."), + + // Comment + COMMENT_NOT_FOUND(HttpStatus.NOT_FOUND, "COMMENT_404", "존재하지 않는 댓글입니다."), + COMMENT_FORBIDDEN(HttpStatus.FORBIDDEN, "COMMENT_403", "본인 댓글만 수정/삭제할 수 있습니다."), + + // Like + LIKE_ALREADY_EXISTS(HttpStatus.CONFLICT, "LIKE_409", "이미 좋아요를 누른 관점입니다."), + LIKE_NOT_FOUND(HttpStatus.NOT_FOUND, "LIKE_404", "좋아요를 누른 적 없는 관점입니다."), + LIKE_SELF_FORBIDDEN(HttpStatus.FORBIDDEN, "LIKE_403", "본인 관점에는 좋아요를 누를 수 없습니다."), + + // Vote + VOTE_NOT_FOUND(HttpStatus.NOT_FOUND, "VOTE_404", "투표 내역이 없습니다."); // User USER_NOT_FOUND(HttpStatus.NOT_FOUND, "USER_404", "존재하지 않는 사용자입니다."), ONBOARDING_ALREADY_COMPLETED(HttpStatus.CONFLICT, "USER_409", "이미 온보딩이 완료된 사용자입니다."); From e212667bf2d5111d3cae3d0821f986a192bf4f23 Mon Sep 17 00:00:00 2001 From: JOO <107450745+jucheonsu@users.noreply.github.com> Date: Mon, 16 Mar 2026 17:39:06 +0900 Subject: [PATCH 11/70] =?UTF-8?q?#15=20[Feat]=20=EB=B0=B0=ED=8B=80,=20?= =?UTF-8?q?=ED=83=9C=EA=B7=B8,=20=ED=88=AC=ED=91=9C=20=EB=8F=84=EB=A9=94?= =?UTF-8?q?=EC=9D=B8=20=EA=B8=B0=EB=8A=A5=20=EA=B0=9C=EB=B0=9C=20(#28)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../controller/AdminBattleController.java | 55 +++++ .../battle/controller/BattleController.java | 35 +++ .../battle/converter/BattleConverter.java | 119 ++++++++++ .../dto/request/AdminBattleCreateRequest.java | 19 ++ .../dto/request/AdminBattleOptionRequest.java | 17 ++ .../dto/request/AdminBattleUpdateRequest.java | 18 ++ .../response/AdminBattleDeleteResponse.java | 13 ++ .../response/AdminBattleDetailResponse.java | 32 +++ .../dto/response/BattleOptionResponse.java | 15 ++ .../dto/response/BattleSummaryResponse.java | 24 ++ .../dto/response/BattleTagResponse.java | 15 ++ .../response/BattleUserDetailResponse.java | 18 ++ .../dto/response/BattleVoteResponse.java | 16 ++ .../dto/response/OptionStatResponse.java | 18 ++ .../dto/response/TodayBattleListResponse.java | 13 ++ .../dto/response/TodayBattleResponse.java | 23 ++ .../dto/response/TodayOptionResponse.java | 19 ++ .../swyp/app/domain/battle/entity/Battle.java | 91 ++++++-- .../domain/battle/entity/BattleOption.java | 32 ++- .../battle/entity/BattleOptionLabel.java | 5 - .../{entity => enums}/BattleCreatorType.java | 2 +- .../battle/enums/BattleOptionLabel.java | 5 + .../{entity => enums}/BattleStatus.java | 2 +- .../app/domain/battle/enums/BattleType.java | 5 + .../repository/BattleOptionRepository.java | 4 +- .../battle/repository/BattleRepository.java | 46 +++- .../repository/BattleTagRepository.java | 6 +- .../domain/battle/service/BattleService.java | 54 ++++- .../battle/service/BattleServiceImpl.java | 212 +++++++++++++++++- .../service/PerspectiveService.java | 2 +- .../domain/tag/controller/TagController.java | 64 ++++++ .../domain/tag/converter/TagConverter.java | 35 +++ .../domain/tag/dto/request/TagRequest.java | 13 ++ .../tag/dto/response/TagDeleteResponse.java | 8 + .../tag/dto/response/TagListResponse.java | 8 + .../domain/tag/dto/response/TagResponse.java | 13 ++ .../com/swyp/app/domain/tag/entity/Tag.java | 39 +++- .../swyp/app/domain/tag/enums/TagType.java | 10 + .../domain/tag/repository/TagRepository.java | 8 +- .../app/domain/tag/service/TagService.java | 13 +- .../domain/tag/service/TagServiceImpl.java | 74 +++++- .../com/swyp/app/domain/user/entity/User.java | 12 +- .../user/repository/UserRepository.java | 1 - .../vote/controller/VoteController.java | 33 ++- .../domain/vote/converter/VoteConverter.java | 38 ++++ .../domain/vote/dto/request/VoteRequest.java | 7 + .../vote/dto/response/MyVoteResponse.java | 3 +- .../vote/dto/response/VoteResultResponse.java | 9 + .../com/swyp/app/domain/vote/entity/Vote.java | 29 ++- .../vote/{entity => enums}/VoteStatus.java | 2 +- .../vote/repository/VoteRepository.java | 2 +- .../app/domain/vote/service/VoteService.java | 8 +- .../domain/vote/service/VoteServiceImpl.java | 52 ++++- .../swyp/app/global/common/BaseEntity.java | 3 +- .../global/common/exception/ErrorCode.java | 50 +++-- src/main/resources/application.yml | 3 - 56 files changed, 1337 insertions(+), 135 deletions(-) create mode 100644 src/main/java/com/swyp/app/domain/battle/controller/AdminBattleController.java create mode 100644 src/main/java/com/swyp/app/domain/battle/controller/BattleController.java create mode 100644 src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleCreateRequest.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleOptionRequest.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleUpdateRequest.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/response/AdminBattleDeleteResponse.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/response/AdminBattleDetailResponse.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/response/BattleOptionResponse.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/response/BattleSummaryResponse.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/response/BattleTagResponse.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/response/BattleUserDetailResponse.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/response/BattleVoteResponse.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/response/OptionStatResponse.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/response/TodayBattleListResponse.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/response/TodayBattleResponse.java create mode 100644 src/main/java/com/swyp/app/domain/battle/dto/response/TodayOptionResponse.java delete mode 100644 src/main/java/com/swyp/app/domain/battle/entity/BattleOptionLabel.java rename src/main/java/com/swyp/app/domain/battle/{entity => enums}/BattleCreatorType.java (56%) create mode 100644 src/main/java/com/swyp/app/domain/battle/enums/BattleOptionLabel.java rename src/main/java/com/swyp/app/domain/battle/{entity => enums}/BattleStatus.java (65%) create mode 100644 src/main/java/com/swyp/app/domain/battle/enums/BattleType.java create mode 100644 src/main/java/com/swyp/app/domain/tag/controller/TagController.java create mode 100644 src/main/java/com/swyp/app/domain/tag/converter/TagConverter.java create mode 100644 src/main/java/com/swyp/app/domain/tag/dto/request/TagRequest.java create mode 100644 src/main/java/com/swyp/app/domain/tag/dto/response/TagDeleteResponse.java create mode 100644 src/main/java/com/swyp/app/domain/tag/dto/response/TagListResponse.java create mode 100644 src/main/java/com/swyp/app/domain/tag/dto/response/TagResponse.java create mode 100644 src/main/java/com/swyp/app/domain/tag/enums/TagType.java create mode 100644 src/main/java/com/swyp/app/domain/vote/converter/VoteConverter.java create mode 100644 src/main/java/com/swyp/app/domain/vote/dto/request/VoteRequest.java create mode 100644 src/main/java/com/swyp/app/domain/vote/dto/response/VoteResultResponse.java rename src/main/java/com/swyp/app/domain/vote/{entity => enums}/VoteStatus.java (59%) diff --git a/src/main/java/com/swyp/app/domain/battle/controller/AdminBattleController.java b/src/main/java/com/swyp/app/domain/battle/controller/AdminBattleController.java new file mode 100644 index 0000000..0c50ee6 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/controller/AdminBattleController.java @@ -0,0 +1,55 @@ +package com.swyp.app.domain.battle.controller; + +import com.swyp.app.domain.battle.dto.request.AdminBattleCreateRequest; +import com.swyp.app.domain.battle.dto.request.AdminBattleUpdateRequest; +import com.swyp.app.domain.battle.dto.response.AdminBattleDeleteResponse; +import com.swyp.app.domain.battle.dto.response.AdminBattleDetailResponse; +import com.swyp.app.domain.battle.service.BattleService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +import org.springframework.security.core.annotation.AuthenticationPrincipal; +import org.springframework.web.bind.annotation.*; + +import java.util.UUID; + +@Tag(name = "배틀 API (관리자)", description = "배틀 생성/수정/삭제 (관리자 전용)") +@RestController +@RequestMapping("/api/v1/admin/battles") +@RequiredArgsConstructor +public class AdminBattleController { + + private final BattleService battleService; + + @Operation(summary = "배틀 생성") + @PostMapping + public ApiResponse createBattle( + @RequestBody @Valid AdminBattleCreateRequest request, + @AuthenticationPrincipal Long adminUserId + ) { + // TODO: 로그인 기능 구현 후 @AuthenticationPrincipal adminUserId로 변경 예정 + // 현재 인증 정보가 없어 null이 들어오므로 테스트용 가짜 ID(1L)를 사용함 + Long testAdminId = (adminUserId != null) ? adminUserId : 1L; + + return ApiResponse.onSuccess(battleService.createBattle(request, testAdminId)); + } + + @Operation(summary = "배틀 수정 (변경 필드만 포함)") + @PatchMapping("/{battleId}") + public ApiResponse updateBattle( + @PathVariable UUID battleId, + @RequestBody @Valid AdminBattleUpdateRequest request + ) { + return ApiResponse.onSuccess(battleService.updateBattle(battleId, request)); + } + + @Operation(summary = "배틀 삭제") + @DeleteMapping("/{battleId}") + public ApiResponse deleteBattle( + @PathVariable UUID battleId + ) { + return ApiResponse.onSuccess(battleService.deleteBattle(battleId)); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/controller/BattleController.java b/src/main/java/com/swyp/app/domain/battle/controller/BattleController.java new file mode 100644 index 0000000..fc3b5c7 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/controller/BattleController.java @@ -0,0 +1,35 @@ +package com.swyp.app.domain.battle.controller; + +import com.swyp.app.domain.battle.dto.response.BattleUserDetailResponse; +import com.swyp.app.domain.battle.dto.response.TodayBattleListResponse; +import com.swyp.app.domain.battle.service.BattleService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import lombok.RequiredArgsConstructor; +import org.springframework.web.bind.annotation.*; + +import java.util.UUID; + +@Tag(name = "배틀 API (사용자)", description = "배틀 조회") +@RestController +@RequestMapping("/api/v1/battles") +@RequiredArgsConstructor +public class BattleController { + + private final BattleService battleService; + + @Operation(summary = "오늘의 배틀 목록 조회 (스와이프 UI용, 최대 5개)") + @GetMapping("/today") + public ApiResponse getTodayBattles() { + return ApiResponse.onSuccess(battleService.getTodayBattles()); + } + + @Operation(summary = "배틀 상세 조회") + @GetMapping("/{battleId}") + public ApiResponse getBattleDetail( + @PathVariable UUID battleId + ) { + return ApiResponse.onSuccess(battleService.getBattleDetail(battleId)); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java b/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java new file mode 100644 index 0000000..a8262d8 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java @@ -0,0 +1,119 @@ +package com.swyp.app.domain.battle.converter; + +import com.swyp.app.domain.battle.dto.request.AdminBattleCreateRequest; +import com.swyp.app.domain.battle.dto.response.*; +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.battle.enums.BattleCreatorType; +import com.swyp.app.domain.battle.enums.BattleStatus; +import com.swyp.app.domain.tag.entity.Tag; +import com.swyp.app.domain.tag.enums.TagType; +import com.swyp.app.domain.user.entity.User; +import org.springframework.stereotype.Component; + +import java.util.List; + +@Component +public class BattleConverter { + + private static final String BASE_SHARE_URL = "https://pique.app/battles/"; + + // 1. 배틀 엔티티 변환 (Admin 생성용) + public static Battle toEntity(AdminBattleCreateRequest request, User admin) { + return Battle.builder() + .title(request.title()) + .summary(request.summary()) + .description(request.description()) + .thumbnailUrl(request.thumbnailUrl()) + .type(request.type()) + .targetDate(request.targetDate()) + .status(BattleStatus.DRAFT) + .creatorType(BattleCreatorType.ADMIN) + .creator(admin) + .build(); + } + + // 2. 오늘의 배틀 변환 + public static TodayBattleResponse toTodayResponse(Battle b, List tags, List opts) { + return new TodayBattleResponse( + b.getId(), + b.getTitle(), + b.getSummary(), + b.getThumbnailUrl(), + b.getType(), + b.getAudioDuration() == null ? 0 : b.getAudioDuration(), + BASE_SHARE_URL + b.getId(), + toTagResponses(tags, null), + opts.stream().map(o -> new TodayOptionResponse( + o.getId(), o.getLabel(), o.getTitle(), o.getRepresentative(), o.getStance(), o.getImageUrl() + )).toList() + ); + } + + // 관리자용 상세 정보 변환 + public static AdminBattleDetailResponse toAdminDetailResponse(Battle b, List tags, List opts) { + return new AdminBattleDetailResponse( + b.getId(), + b.getTitle(), + b.getSummary(), + b.getDescription(), + b.getThumbnailUrl(), + b.getType(), + b.getTargetDate(), + b.getStatus(), + b.getCreatorType(), + toTagResponses(tags, null), + toOptionResponses(opts), + b.getCreatedAt(), + b.getUpdatedAt() + ); + } + + // 3. 유저용 배틀 상세 변환 (사전/사후 투표) + public static BattleUserDetailResponse toUserDetailResponse(Battle b, List tags, List opts, Long partCount, String voteStatus) { + + BattleSummaryResponse summary = new BattleSummaryResponse( + b.getId(), + b.getTitle(), + b.getSummary(), + b.getThumbnailUrl(), + b.getType(), + b.getViewCount() == null ? 0 : b.getViewCount(), + partCount == null ? 0L : partCount, + b.getAudioDuration() == null ? 0 : b.getAudioDuration(), + toTagResponses(tags, null), + toOptionResponses(opts) + ); + + return new BattleUserDetailResponse( + summary, + b.getDescription(), + BASE_SHARE_URL + b.getId(), + voteStatus, + toTagResponses(tags, TagType.CATEGORY), + toTagResponses(tags, TagType.PHILOSOPHER), + toTagResponses(tags, TagType.VALUE) + ); + } + + // 옵션 변환 (A, B, C, D 모두 대응) + private static List toOptionResponses(List options) { + return options.stream() + .map(o -> new BattleOptionResponse( + o.getId(), + o.getLabel(), + o.getTitle(), + o.getRepresentative(), + o.getImageUrl(), + o.getStance(), + o.getQuote() + )).toList(); + } + + private static List toTagResponses(List tags, TagType targetType) { + return tags.stream() + .filter(t -> targetType == null || t.getType() == targetType) + .map(t -> new BattleTagResponse(t.getId(), t.getName(), t.getType())) + .toList(); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleCreateRequest.java b/src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleCreateRequest.java new file mode 100644 index 0000000..10f13ff --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleCreateRequest.java @@ -0,0 +1,19 @@ +package com.swyp.app.domain.battle.dto.request; + +import com.swyp.app.domain.battle.enums.BattleType; + +import java.time.LocalDate; +import java.util.List; +import java.util.UUID; + +public record AdminBattleCreateRequest( + String title, + String summary, + String description, + String thumbnailUrl, + BattleType type, + UUID categoryId, + LocalDate targetDate, + List tagIds, + List options +) {} diff --git a/src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleOptionRequest.java b/src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleOptionRequest.java new file mode 100644 index 0000000..51eaa91 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleOptionRequest.java @@ -0,0 +1,17 @@ +package com.swyp.app.domain.battle.dto.request; + +import com.swyp.app.domain.battle.enums.BattleOptionLabel; + +import java.util.List; +import java.util.UUID; + +public record AdminBattleOptionRequest( + BattleOptionLabel label, + String title, + String stance, + String representative, + String quote, + String imageUrl, + List philosopherTagIds, + List valueTagIds +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleUpdateRequest.java b/src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleUpdateRequest.java new file mode 100644 index 0000000..c972dc0 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleUpdateRequest.java @@ -0,0 +1,18 @@ +package com.swyp.app.domain.battle.dto.request; + +import com.swyp.app.domain.battle.enums.BattleStatus; + +import java.time.LocalDate; +import java.util.List; +import java.util.UUID; + +public record AdminBattleUpdateRequest( + String title, + String summary, + String description, + String thumbnailUrl, + LocalDate targetDate, + Integer audioDuration, + BattleStatus status, + List tagIds +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/dto/response/AdminBattleDeleteResponse.java b/src/main/java/com/swyp/app/domain/battle/dto/response/AdminBattleDeleteResponse.java new file mode 100644 index 0000000..4aa786d --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/response/AdminBattleDeleteResponse.java @@ -0,0 +1,13 @@ +package com.swyp.app.domain.battle.dto.response; + +import java.time.LocalDateTime; + +/** + * 관리자 - 배틀 삭제 응답 + * 역할: 배틀이 성공적으로 소프트 딜리트 되었는지 확인하고 삭제 시점을 반환합니다. + */ + +public record AdminBattleDeleteResponse( + Boolean success, // 삭제 성공 여부 + LocalDateTime deletedAt // 삭제 처리된 일시 (Soft Delete) +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/dto/response/AdminBattleDetailResponse.java b/src/main/java/com/swyp/app/domain/battle/dto/response/AdminBattleDetailResponse.java new file mode 100644 index 0000000..28766df --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/response/AdminBattleDetailResponse.java @@ -0,0 +1,32 @@ +package com.swyp.app.domain.battle.dto.response; + +import com.swyp.app.domain.battle.enums.BattleCreatorType; +import com.swyp.app.domain.battle.enums.BattleStatus; +import com.swyp.app.domain.battle.enums.BattleType; + +import java.time.LocalDate; +import java.time.LocalDateTime; +import java.util.List; +import java.util.UUID; + +/** + * 관리자 - 배틀 상세 상세 조회 응답 + * 역할: 관리자가 배틀의 모든 설정 값(상태, 생성자 타입, 수정일 등)을 확인하고 수정할 때 사용합니다. + */ + +public record AdminBattleDetailResponse( + UUID battleId, // 배틀 고유 ID + String title, // 배틀 제목 + String summary, // 배틀 요약 문구 + String description, // 배틀 상세 설명 + String thumbnailUrl, // 상단 배경 이미지 URL + BattleType type, // 배틀 타입 (BATTLE, QUIZ, VOTE) + LocalDate targetDate, // 게시 예정일 (홈 화면 노출 날짜) + BattleStatus status, // 배틀 상태 (DRAFT, PUBLISHED, ARCHIVED 등) + BattleCreatorType creatorType, // 생성 주체 (ADMIN, USER) + List tags, // 연결된 모든 태그 리스트 + List options, // 대결 선택지 상세 정보 리스트 + LocalDateTime createdAt, // 데이터 생성 일시 + LocalDateTime updatedAt // 데이터 최종 수정 일시 +) {} +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/dto/response/BattleOptionResponse.java b/src/main/java/com/swyp/app/domain/battle/dto/response/BattleOptionResponse.java new file mode 100644 index 0000000..0dfb1ca --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/response/BattleOptionResponse.java @@ -0,0 +1,15 @@ +package com.swyp.app.domain.battle.dto.response; + +import com.swyp.app.domain.battle.enums.BattleOptionLabel; + +import java.util.UUID; + +public record BattleOptionResponse( + UUID optionId, + BattleOptionLabel label, + String title, + String stance, + String representative, + String quote, + String imageUrl +) {} diff --git a/src/main/java/com/swyp/app/domain/battle/dto/response/BattleSummaryResponse.java b/src/main/java/com/swyp/app/domain/battle/dto/response/BattleSummaryResponse.java new file mode 100644 index 0000000..a093fc9 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/response/BattleSummaryResponse.java @@ -0,0 +1,24 @@ +package com.swyp.app.domain.battle.dto.response; + +import com.swyp.app.domain.battle.enums.BattleType; + +import java.util.List; +import java.util.UUID; + +/** + * 유저 - 배틀 요약 정보 응답 + * 역할: 홈 화면의 각 섹션 카드나 리스트에서 '미리보기' 형태로 보여줄 데이터입니다. + */ + +public record BattleSummaryResponse( + UUID battleId, // 배틀 고유 ID + String title, // 배틀 제목 + String summary, // 배틀 요약 (누군가는 이것을...) + String thumbnailUrl, // 카드 배경 이미지 URL + BattleType type, // 배틀 타입 태그 (#BATTLE, #VOTE 등) + Integer viewCount, // 조회수 + Long participantsCount, // 누적 참여자 수 + Integer audioDuration, // 오디오 소요 시간 + List tags, // 카테고리/인물 태그 리스트 + List options // 선택지 요약 (A vs B) +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/dto/response/BattleTagResponse.java b/src/main/java/com/swyp/app/domain/battle/dto/response/BattleTagResponse.java new file mode 100644 index 0000000..358dffc --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/response/BattleTagResponse.java @@ -0,0 +1,15 @@ +package com.swyp.app.domain.battle.dto.response; +import com.swyp.app.domain.tag.enums.TagType; + +import java.util.UUID; + +/** + * 유저 - 배틀 태그 응답 + * 역할: 화면 곳곳에 쓰이는 #예술 #철학 등의 태그 정보를 담습니다. + */ + +public record BattleTagResponse( + UUID tagId, // 태그 고유 ID + String name, // 태그 명칭 + TagType type // 태그 카테고리 (CATEGORY, PHILOSOPHER, VALUE) +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/dto/response/BattleUserDetailResponse.java b/src/main/java/com/swyp/app/domain/battle/dto/response/BattleUserDetailResponse.java new file mode 100644 index 0000000..d7ea2a2 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/response/BattleUserDetailResponse.java @@ -0,0 +1,18 @@ +package com.swyp.app.domain.battle.dto.response; + +import java.util.List; + +/** + * 유저 - 배틀 상세 페이지 응답 (시안 4, 5번) + * 역할: 배틀 클릭 시 진입하는 상세 화면의 모든 정보를 담습니다. 투표 여부에 따라 UI가 변합니다. + */ + +public record BattleUserDetailResponse( + BattleSummaryResponse battleInfo, // 기본적인 배틀 정보 (요약 DTO 재사용) + String description, // 상세 본문 설명 + String shareUrl, // 공유하기 버튼용 링크 + String userVoteStatus, // 현재 유저의 투표 상태 (NONE, A, B...) + List categoryTags, // UI 상단용 카테고리 태그만 분리 + List philosopherTags, // UI 하단용 철학자 태그만 분리 + List valueTags // 성향 분석용 가치관 태그만 분리 +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/dto/response/BattleVoteResponse.java b/src/main/java/com/swyp/app/domain/battle/dto/response/BattleVoteResponse.java new file mode 100644 index 0000000..fecc989 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/response/BattleVoteResponse.java @@ -0,0 +1,16 @@ +package com.swyp.app.domain.battle.dto.response; + +import java.util.List; +import java.util.UUID; + +/** + * 유저 - 투표 결과 전체 응답 + * 역할: 투표 완료 후 실시간으로 변한 전체 참여자 수와 옵션별 비율을 반환합니다. + */ + +public record BattleVoteResponse( + UUID battleId, // 투표한 배틀 ID + UUID selectedOptionId, // 유저가 방금 선택한 옵션 ID + Long totalParticipants, // 실시간 전체 참여자 수 + List results // 옵션별 득표 현황 리스트 +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/dto/response/OptionStatResponse.java b/src/main/java/com/swyp/app/domain/battle/dto/response/OptionStatResponse.java new file mode 100644 index 0000000..00579f7 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/response/OptionStatResponse.java @@ -0,0 +1,18 @@ +package com.swyp.app.domain.battle.dto.response; + +import com.swyp.app.domain.battle.enums.BattleOptionLabel; + +import java.util.UUID; + +/** + * 유저 - 옵션별 실시간 통계 + * 역할: 각 선택지별로 몇 명이 선택했는지, 퍼센트(%)는 얼마인지 담습니다. + */ + +public record OptionStatResponse( + UUID optionId, // 옵션 고유 ID + BattleOptionLabel label,// 라벨 (A, B) + String title, // 옵션 명칭 + Long voteCount, // 해당 옵션의 득표 수 + Double ratio // 해당 옵션의 득표 비율 (0~100.0) +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/dto/response/TodayBattleListResponse.java b/src/main/java/com/swyp/app/domain/battle/dto/response/TodayBattleListResponse.java new file mode 100644 index 0000000..0e7f72a --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/response/TodayBattleListResponse.java @@ -0,0 +1,13 @@ +package com.swyp.app.domain.battle.dto.response; + +import java.util.List; + +/** + * 유저 - 오늘의 배틀 목록 응답 + * 역할: 오늘의 배틀 섹션에 노출될 배틀들과 총 개수를 감싸는 리스트형 DTO입니다. + */ + +public record TodayBattleListResponse( + List items, // 오늘의 배틀 리스트 + Integer totalCount // 목록 총 개수 +) {} diff --git a/src/main/java/com/swyp/app/domain/battle/dto/response/TodayBattleResponse.java b/src/main/java/com/swyp/app/domain/battle/dto/response/TodayBattleResponse.java new file mode 100644 index 0000000..35d8817 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/response/TodayBattleResponse.java @@ -0,0 +1,23 @@ +package com.swyp.app.domain.battle.dto.response; + +import com.swyp.app.domain.battle.enums.BattleType; + +import java.util.List; +import java.util.UUID; + +/** + * 유저 - 오늘의 배틀 상세 응답 (시안 6번) + * 역할: 어두운 배경의 풀스크린 UI에 필요한 배경 이미지, 시간, 공유 주소 등을 담습니다. + */ + +public record TodayBattleResponse( + UUID battleId, // 배틀 고유 ID + String title, // 배틀 제목 + String summary, // 중간 요약 문구 + String thumbnailUrl, // 풀스크린 배경 이미지 URL + BattleType type, // 타입 태그 + Integer audioDuration, // 소요 시간 (분:초 변환용 데이터) + String shareUrl, // 공유하기 링크 + List tags, // 상단 태그 리스트 + List options // 중앙 세로형 대결 카드 데이터 +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/dto/response/TodayOptionResponse.java b/src/main/java/com/swyp/app/domain/battle/dto/response/TodayOptionResponse.java new file mode 100644 index 0000000..d34af13 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/dto/response/TodayOptionResponse.java @@ -0,0 +1,19 @@ +package com.swyp.app.domain.battle.dto.response; + +import com.swyp.app.domain.battle.enums.BattleOptionLabel; + +import java.util.UUID; + +/** + * 유저 - 오늘의 배틀 전용 옵션 응답 + * 역할: 오늘의 배틀 시안의 세로형 카드에 들어가는 인물, 입장, 아바타 정보를 담습니다. + */ + +public record TodayOptionResponse( + UUID optionId, // 옵션 ID + BattleOptionLabel label,// 라벨 (A, B) + String title, // 제목 (예: 찬성한다) + String representative, // 인물 (예: 피터 싱어) + String stance, // 한 줄 입장 (예: 고통을 끝낼 권리는..) + String imageUrl // 아바타 이미지 URL +) {} diff --git a/src/main/java/com/swyp/app/domain/battle/entity/Battle.java b/src/main/java/com/swyp/app/domain/battle/entity/Battle.java index 2b79cc6..a175880 100644 --- a/src/main/java/com/swyp/app/domain/battle/entity/Battle.java +++ b/src/main/java/com/swyp/app/domain/battle/entity/Battle.java @@ -1,20 +1,18 @@ package com.swyp.app.domain.battle.entity; +import com.swyp.app.domain.battle.enums.BattleCreatorType; +import com.swyp.app.domain.battle.enums.BattleStatus; +import com.swyp.app.domain.battle.enums.BattleType; +import com.swyp.app.domain.user.entity.User; import com.swyp.app.global.common.BaseEntity; -import jakarta.persistence.Column; -import jakarta.persistence.Entity; -import jakarta.persistence.EnumType; -import jakarta.persistence.Enumerated; -import jakarta.persistence.GeneratedValue; -import jakarta.persistence.GenerationType; -import jakarta.persistence.Id; -import jakarta.persistence.Table; +import jakarta.persistence.*; import lombok.AccessLevel; import lombok.Builder; import lombok.Getter; import lombok.NoArgsConstructor; import java.time.LocalDate; +import java.time.LocalDateTime; import java.util.UUID; @Getter @@ -27,10 +25,9 @@ public class Battle extends BaseEntity { @GeneratedValue(strategy = GenerationType.UUID) private UUID id; - @Column(nullable = false, length = 255) + @Column(nullable = false) private String title; - @Column(length = 500) private String summary; @Column(columnDefinition = "TEXT") @@ -39,9 +36,22 @@ public class Battle extends BaseEntity { @Column(name = "thumbnail_url", length = 500) private String thumbnailUrl; + @Enumerated(EnumType.STRING) + @Column(nullable = false, length = 20) + private BattleType type; + + @Column(name = "view_count") + private Integer viewCount = 0; + + @Column(name = "total_participants") + private Long totalParticipantsCount = 0L; + @Column(name = "target_date") private LocalDate targetDate; + @Column(name = "audio_duration") + private Integer audioDuration; + @Enumerated(EnumType.STRING) @Column(nullable = false, length = 20) private BattleStatus status; @@ -50,25 +60,64 @@ public class Battle extends BaseEntity { @Column(name = "creator_type", nullable = false, length = 10) private BattleCreatorType creatorType; - // TODO: User 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "creator_id") 로 교체 - @Column(name = "creator_id") - private Long creatorId; + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "creator_id") + private User creator; + + // 홈 화면 5단 기획을 위한 필드들 + + @Column(name = "is_editor_pick") + private Boolean isEditorPick = false; // 기본값 false + + @Column(name = "comment_count") + private Long commentCount = 0L; // 베스트 배틀 정렬용 기본값 0 - @Column(name = "reject_reason", length = 500) - private String rejectReason; + @Column(name = "deleted_at") + private LocalDateTime deletedAt; @Builder - private Battle(String title, String summary, String description, String thumbnailUrl, - LocalDate targetDate, BattleStatus status, BattleCreatorType creatorType, - Long creatorId, String rejectReason) { + public Battle(String title, String summary, String description, String thumbnailUrl, + BattleType type, LocalDate targetDate, Integer audioDuration, + BattleStatus status, BattleCreatorType creatorType, User creator) { this.title = title; this.summary = summary; this.description = description; this.thumbnailUrl = thumbnailUrl; + this.type = type; this.targetDate = targetDate; + this.audioDuration = audioDuration; this.status = status; this.creatorType = creatorType; - this.creatorId = creatorId; - this.rejectReason = rejectReason; + this.creator = creator; + this.viewCount = 0; + this.totalParticipantsCount = 0L; + this.isEditorPick = false; + this.commentCount = 0L; + this.deletedAt = null; + } + + public void update(String title, String summary, String description, + String thumbnailUrl, LocalDate targetDate, + Integer audioDuration, BattleStatus status) { + if (title != null) this.title = title; + if (summary != null) this.summary = summary; + if (description != null) this.description = description; + if (thumbnailUrl != null) this.thumbnailUrl = thumbnailUrl; + if (targetDate != null) this.targetDate = targetDate; + if (audioDuration != null) this.audioDuration = audioDuration; + if (status != null) this.status = status; + } + + public void delete() { + this.status = BattleStatus.ARCHIVED; + this.deletedAt = LocalDateTime.now(); + } + + public void increaseViewCount() { + this.viewCount = (this.viewCount == null ? 0 : this.viewCount) + 1; + } + + public void addParticipant() { + this.totalParticipantsCount = (this.totalParticipantsCount == null ? 0L : this.totalParticipantsCount) + 1; } -} +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/entity/BattleOption.java b/src/main/java/com/swyp/app/domain/battle/entity/BattleOption.java index 54683de..42d8f0f 100644 --- a/src/main/java/com/swyp/app/domain/battle/entity/BattleOption.java +++ b/src/main/java/com/swyp/app/domain/battle/entity/BattleOption.java @@ -1,21 +1,13 @@ package com.swyp.app.domain.battle.entity; -import jakarta.persistence.Column; -import jakarta.persistence.Entity; -import jakarta.persistence.EnumType; -import jakarta.persistence.Enumerated; -import jakarta.persistence.FetchType; -import jakarta.persistence.GeneratedValue; -import jakarta.persistence.GenerationType; -import jakarta.persistence.Id; -import jakarta.persistence.JoinColumn; -import jakarta.persistence.ManyToOne; -import jakarta.persistence.Table; +import com.swyp.app.domain.battle.enums.BattleOptionLabel; +import jakarta.persistence.*; import lombok.AccessLevel; import lombok.Builder; import lombok.Getter; import lombok.NoArgsConstructor; +import java.util.List; import java.util.UUID; @Getter @@ -33,7 +25,7 @@ public class BattleOption { private Battle battle; @Enumerated(EnumType.STRING) - @Column(nullable = false, length = 5) + @Column(nullable = false, length = 10) private BattleOptionLabel label; @Column(nullable = false, length = 100) @@ -48,22 +40,26 @@ public class BattleOption { @Column(columnDefinition = "TEXT") private String quote; - @Column(columnDefinition = "jsonb") - private String keywords; + @Column(name = "vote_count") + private Long voteCount = 0L; @Column(name = "image_url", length = 500) private String imageUrl; @Builder - private BattleOption(Battle battle, BattleOptionLabel label, String title, String stance, - String representative, String quote, String keywords, String imageUrl) { + public BattleOption(Battle battle, BattleOptionLabel label, String title, String stance, + String representative, String quote, List keywords, String imageUrl) { this.battle = battle; this.label = label; this.title = title; this.stance = stance; this.representative = representative; this.quote = quote; - this.keywords = keywords; this.imageUrl = imageUrl; + this.voteCount = 0L; } -} + + public void increaseVoteCount() { + this.voteCount = (this.voteCount == null ? 0L : this.voteCount) + 1; + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/entity/BattleOptionLabel.java b/src/main/java/com/swyp/app/domain/battle/entity/BattleOptionLabel.java deleted file mode 100644 index 7cc4784..0000000 --- a/src/main/java/com/swyp/app/domain/battle/entity/BattleOptionLabel.java +++ /dev/null @@ -1,5 +0,0 @@ -package com.swyp.app.domain.battle.entity; - -public enum BattleOptionLabel { - A, B -} diff --git a/src/main/java/com/swyp/app/domain/battle/entity/BattleCreatorType.java b/src/main/java/com/swyp/app/domain/battle/enums/BattleCreatorType.java similarity index 56% rename from src/main/java/com/swyp/app/domain/battle/entity/BattleCreatorType.java rename to src/main/java/com/swyp/app/domain/battle/enums/BattleCreatorType.java index 6367ac5..0ec4f25 100644 --- a/src/main/java/com/swyp/app/domain/battle/entity/BattleCreatorType.java +++ b/src/main/java/com/swyp/app/domain/battle/enums/BattleCreatorType.java @@ -1,4 +1,4 @@ -package com.swyp.app.domain.battle.entity; +package com.swyp.app.domain.battle.enums; public enum BattleCreatorType { ADMIN, USER, AI diff --git a/src/main/java/com/swyp/app/domain/battle/enums/BattleOptionLabel.java b/src/main/java/com/swyp/app/domain/battle/enums/BattleOptionLabel.java new file mode 100644 index 0000000..e395fb1 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/enums/BattleOptionLabel.java @@ -0,0 +1,5 @@ +package com.swyp.app.domain.battle.enums; + +public enum BattleOptionLabel { + A, B, C, D +} diff --git a/src/main/java/com/swyp/app/domain/battle/entity/BattleStatus.java b/src/main/java/com/swyp/app/domain/battle/enums/BattleStatus.java similarity index 65% rename from src/main/java/com/swyp/app/domain/battle/entity/BattleStatus.java rename to src/main/java/com/swyp/app/domain/battle/enums/BattleStatus.java index 5c7cf55..c395e5f 100644 --- a/src/main/java/com/swyp/app/domain/battle/entity/BattleStatus.java +++ b/src/main/java/com/swyp/app/domain/battle/enums/BattleStatus.java @@ -1,4 +1,4 @@ -package com.swyp.app.domain.battle.entity; +package com.swyp.app.domain.battle.enums; public enum BattleStatus { DRAFT, PENDING, PUBLISHED, REJECTED, ARCHIVED diff --git a/src/main/java/com/swyp/app/domain/battle/enums/BattleType.java b/src/main/java/com/swyp/app/domain/battle/enums/BattleType.java new file mode 100644 index 0000000..0f8b71e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/enums/BattleType.java @@ -0,0 +1,5 @@ +package com.swyp.app.domain.battle.enums; + +public enum BattleType { + BATTLE, QUIZ, VOTE +} diff --git a/src/main/java/com/swyp/app/domain/battle/repository/BattleOptionRepository.java b/src/main/java/com/swyp/app/domain/battle/repository/BattleOptionRepository.java index 6ecea26..d00339f 100644 --- a/src/main/java/com/swyp/app/domain/battle/repository/BattleOptionRepository.java +++ b/src/main/java/com/swyp/app/domain/battle/repository/BattleOptionRepository.java @@ -2,7 +2,7 @@ import com.swyp.app.domain.battle.entity.Battle; import com.swyp.app.domain.battle.entity.BattleOption; -import com.swyp.app.domain.battle.entity.BattleOptionLabel; +import com.swyp.app.domain.battle.enums.BattleOptionLabel; import org.springframework.data.jpa.repository.JpaRepository; import java.util.List; @@ -12,6 +12,6 @@ public interface BattleOptionRepository extends JpaRepository { List findByBattle(Battle battle); - Optional findByBattleAndLabel(Battle battle, BattleOptionLabel label); + } diff --git a/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java b/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java index b09b20e..4e9c28a 100644 --- a/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java +++ b/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java @@ -1,9 +1,53 @@ package com.swyp.app.domain.battle.repository; import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.enums.BattleStatus; +import com.swyp.app.domain.battle.enums.BattleType; +import org.springframework.data.domain.Pageable; import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; +import java.time.LocalDate; +import java.time.LocalDateTime; +import java.util.List; import java.util.UUID; public interface BattleRepository extends JpaRepository { -} + + // 1. EDITOR PICK + @Query("SELECT battle FROM Battle battle " + + "WHERE battle.isEditorPick = true AND battle.status = :status " + + "AND battle.deletedAt IS NULL " + + "ORDER BY battle.createdAt DESC") + List findEditorPicks(@Param("status") BattleStatus status, Pageable pageable); + + // 2. 지금 뜨는 배틀 + @Query("SELECT battle FROM Battle battle JOIN Vote vote ON vote.battle = battle " + + "WHERE vote.createdAt >= :yesterday AND battle.status = 'PUBLISHED' " + + "AND battle.deletedAt IS NULL " + + "GROUP BY battle ORDER BY COUNT(vote) DESC") + List findTrendingBattles(@Param("yesterday") LocalDateTime yesterday, Pageable pageable); + + // 3. Best 배틀 + @Query("SELECT battle FROM Battle battle " + + "WHERE battle.status = 'PUBLISHED' AND battle.deletedAt IS NULL " + + "ORDER BY (battle.totalParticipantsCount + (battle.commentCount * 5)) DESC") + List findBestBattles(Pageable pageable); + + // 4. 오늘의 Pické (단일 타입) + @Query("SELECT battle FROM Battle battle " + + "WHERE battle.type = :type AND battle.targetDate = :today " + + "AND battle.status = 'PUBLISHED' AND battle.deletedAt IS NULL") + List findTodayPicks(@Param("type") BattleType type, @Param("today") LocalDate today); + + // 5. 새로운 배틀 + @Query("SELECT battle FROM Battle battle " + + "WHERE battle.id NOT IN :excludeIds AND battle.status = 'PUBLISHED' " + + "AND battle.deletedAt IS NULL " + + "ORDER BY battle.createdAt DESC") + List findNewBattlesExcluding(@Param("excludeIds") List excludeIds, Pageable pageable); + + // 기본 조회용 + List findByTargetDateAndStatusAndDeletedAtIsNull(LocalDate date, BattleStatus status); +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java b/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java index ea686e3..38a5c8a 100644 --- a/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java +++ b/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java @@ -2,12 +2,14 @@ import com.swyp.app.domain.battle.entity.Battle; import com.swyp.app.domain.battle.entity.BattleTag; +import com.swyp.app.domain.tag.entity.Tag; import org.springframework.data.jpa.repository.JpaRepository; import java.util.List; import java.util.UUID; public interface BattleTagRepository extends JpaRepository { - List findByBattle(Battle battle); -} + void deleteByBattle(Battle battle); + boolean existsByTag(Tag tag); +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/service/BattleService.java b/src/main/java/com/swyp/app/domain/battle/service/BattleService.java index 762c514..fe6fc12 100644 --- a/src/main/java/com/swyp/app/domain/battle/service/BattleService.java +++ b/src/main/java/com/swyp/app/domain/battle/service/BattleService.java @@ -1,16 +1,62 @@ package com.swyp.app.domain.battle.service; +import com.swyp.app.domain.battle.dto.request.AdminBattleCreateRequest; +import com.swyp.app.domain.battle.dto.request.AdminBattleUpdateRequest; +import com.swyp.app.domain.battle.dto.response.*; import com.swyp.app.domain.battle.entity.Battle; import com.swyp.app.domain.battle.entity.BattleOption; -import com.swyp.app.domain.battle.entity.BattleOptionLabel; +import com.swyp.app.domain.battle.enums.BattleOptionLabel; +import com.swyp.app.domain.battle.enums.BattleType; +import java.util.List; import java.util.UUID; public interface BattleService { + // === [내부 공통/조회 메서드] === Battle findById(UUID battleId); - BattleOption findOptionById(UUID optionId); - BattleOption findOptionByBattleIdAndLabel(UUID battleId, BattleOptionLabel label); -} + + + // === [사용자용 - 홈 화면 5단 로직 지원 API] === + + // 1. 에디터 픽 조회 (isEditorPick = true) + List getEditorPicks(); + + // 2. 지금 뜨는 배틀 조회 (최근 24시간 투표 급증순) + List getTrendingBattles(); + + // 3. Best 배틀 조회 (누적 지표 랭킹) + List getBestBattles(); + + // 4. 오늘의 Pické 조회 (단일 타입 매칭) + List getTodayPicks(BattleType type); + + // 5. 새로운 배틀 조회 (중복 제외 리스트) + List getNewBattles(List excludeIds); + + + // === [사용자용 - 기본 API] === + + // 오늘의 배틀 (기존 로직 유지용) + TodayBattleListResponse getTodayBattles(); + + // 배틀 상세 정보 + BattleUserDetailResponse getBattleDetail(UUID battleId); + + // 투표 실행 및 실시간 통계 결과 반환 + BattleVoteResponse vote(UUID battleId, UUID optionId); + + + // === [관리자용 API] === + + // 배틀 생성 + AdminBattleDetailResponse createBattle(AdminBattleCreateRequest request, Long adminUserId); + + // 배틀 수정 + AdminBattleDetailResponse updateBattle(UUID battleId, AdminBattleUpdateRequest request); + + // 배틀 삭제 (DB에서 지우지 않고 소프트 딜리트/상태변경을 수행합니다) + AdminBattleDeleteResponse deleteBattle(UUID battleId); +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java b/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java index c23d9c6..03da9ea 100644 --- a/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java +++ b/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java @@ -1,40 +1,238 @@ package com.swyp.app.domain.battle.service; +import com.swyp.app.domain.battle.converter.BattleConverter; +import com.swyp.app.domain.battle.dto.request.AdminBattleCreateRequest; +import com.swyp.app.domain.battle.dto.request.AdminBattleUpdateRequest; +import com.swyp.app.domain.battle.dto.response.*; import com.swyp.app.domain.battle.entity.Battle; import com.swyp.app.domain.battle.entity.BattleOption; -import com.swyp.app.domain.battle.entity.BattleOptionLabel; +import com.swyp.app.domain.battle.entity.BattleTag; +import com.swyp.app.domain.battle.enums.BattleOptionLabel; +import com.swyp.app.domain.battle.enums.BattleStatus; +import com.swyp.app.domain.battle.enums.BattleType; import com.swyp.app.domain.battle.repository.BattleOptionRepository; import com.swyp.app.domain.battle.repository.BattleRepository; +import com.swyp.app.domain.battle.repository.BattleTagRepository; +import com.swyp.app.domain.tag.entity.Tag; +import com.swyp.app.domain.tag.repository.TagRepository; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.repository.UserRepository; +import com.swyp.app.domain.vote.repository.VoteRepository; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.PageRequest; import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; +import java.time.LocalDate; +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.List; import java.util.UUID; @Service @RequiredArgsConstructor +@Transactional(readOnly = true) public class BattleServiceImpl implements BattleService { private final BattleRepository battleRepository; private final BattleOptionRepository battleOptionRepository; + private final BattleTagRepository battleTagRepository; + private final TagRepository tagRepository; + private final UserRepository userRepository; + private final VoteRepository voteRepository; @Override public Battle findById(UUID battleId) { - return battleRepository.findById(battleId) + Battle battle = battleRepository.findById(battleId) .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_NOT_FOUND)); + + if (battle.getDeletedAt() != null) { + throw new CustomException(ErrorCode.BATTLE_NOT_FOUND); + } + return battle; + } + + // [사용자용 - 홈 화면 5단 로직] + + @Override + public List getEditorPicks() { + List battles = battleRepository.findEditorPicks(BattleStatus.PUBLISHED, PageRequest.of(0, 10)); + return convertToTodayResponses(battles); + } + + @Override + public List getTrendingBattles() { + LocalDateTime yesterday = LocalDateTime.now().minusDays(1); + List battles = battleRepository.findTrendingBattles(yesterday, PageRequest.of(0, 5)); + return convertToTodayResponses(battles); + } + + @Override + public List getBestBattles() { + List battles = battleRepository.findBestBattles(PageRequest.of(0, 5)); + return convertToTodayResponses(battles); + } + + @Override + public List getTodayPicks(BattleType type) { + List battles = battleRepository.findTodayPicks(type, LocalDate.now()); + return convertToTodayResponses(battles); + } + + @Override + public List getNewBattles(List excludeIds) { + List finalExcludeIds = (excludeIds == null || excludeIds.isEmpty()) + ? List.of(UUID.randomUUID()) : excludeIds; + List battles = battleRepository.findNewBattlesExcluding(finalExcludeIds, PageRequest.of(0, 10)); + return convertToTodayResponses(battles); + } + + // [사용자용 - 기본 API] + + @Override + public TodayBattleListResponse getTodayBattles() { + List battles = battleRepository.findByTargetDateAndStatusAndDeletedAtIsNull( + LocalDate.now(), BattleStatus.PUBLISHED); + List items = convertToTodayResponses(battles); + return new TodayBattleListResponse(items, items.size()); + } + + @Override + public BattleUserDetailResponse getBattleDetail(UUID battleId) { + Battle battle = findById(battleId); + battle.increaseViewCount(); + + List allTags = getTagsByBattle(battle); + List options = battleOptionRepository.findByBattle(battle); + + // 임시 유저 1L의 투표 상태 확인 (추후 수정 필요) + String voteStatus = voteRepository.findByBattleAndUserId(battle, 1L) + .map(v -> v.getPostVoteOption().getLabel().name()) + .orElse("NONE"); + + return BattleConverter.toUserDetailResponse(battle, allTags, options, battle.getTotalParticipantsCount(), voteStatus); + } + + @Override + @Transactional + public BattleVoteResponse vote(UUID battleId, UUID optionId) { + Battle battle = findById(battleId); + BattleOption option = battleOptionRepository.findById(optionId) + .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_OPTION_NOT_FOUND)); + + battle.addParticipant(); + option.increaseVoteCount(); + + List results = battleOptionRepository.findByBattle(battle).stream().map(opt -> { + Long v = opt.getVoteCount() == null ? 0L : opt.getVoteCount(); + Long t = battle.getTotalParticipantsCount() == null ? 0L : battle.getTotalParticipantsCount(); + Double r = (t == 0L) ? 0.0 : Math.round((double) v / t * 1000) / 10.0; + return new OptionStatResponse(opt.getId(), opt.getLabel(), opt.getTitle(), v, r); + }).toList(); + + return new BattleVoteResponse(battle.getId(), option.getId(), battle.getTotalParticipantsCount(), results); + } + + // [관리자용 API] + + @Override + @Transactional + public AdminBattleDetailResponse createBattle(AdminBattleCreateRequest request, Long adminUserId) { + // 1. 유저 확인 + User admin = userRepository.findById(adminUserId == null ? 1L : adminUserId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + + // 2. 선택지 개수 검증 (VOTE는 4개, QUIZ, BATTLE은 2개) + int requiredOptionCount = (request.type() == BattleType.VOTE) ? 4 : 2; + if (request.options().size() != requiredOptionCount) { + throw new CustomException(ErrorCode.BATTLE_INVALID_OPTION_COUNT); + } + + // 3. 배틀 저장 + Battle battle = battleRepository.save(BattleConverter.toEntity(request, admin)); + + // 4. 태그 저장 + if (request.tagIds() != null) { + saveBattleTags(battle, request.tagIds()); + } + + // 5. 옵션 저장 + List savedOptions = new ArrayList<>(); + for (var optReq : request.options()) { + BattleOption option = battleOptionRepository.save(BattleOption.builder() + .battle(battle) + .label(optReq.label()) + .title(optReq.title()) + .stance(optReq.stance()) + .representative(optReq.representative()) + .quote(optReq.quote()) + .imageUrl(optReq.imageUrl()) + .build()); + savedOptions.add(option); + } + + // 6. 관리자용 상세 응답 반환 + return BattleConverter.toAdminDetailResponse(battle, getTagsByBattle(battle), savedOptions); + } + + @Override + @Transactional + public AdminBattleDetailResponse updateBattle(UUID battleId, AdminBattleUpdateRequest request) { + Battle battle = findById(battleId); + battle.update(request.title(), request.summary(), request.description(), + request.thumbnailUrl(), request.targetDate(), request.audioDuration(), request.status()); + + if (request.tagIds() != null) { + battleTagRepository.deleteByBattle(battle); + saveBattleTags(battle, request.tagIds()); + } + + return BattleConverter.toAdminDetailResponse(battle, getTagsByBattle(battle), battleOptionRepository.findByBattle(battle)); + } + + @Override + @Transactional + public AdminBattleDeleteResponse deleteBattle(UUID battleId) { + Battle battle = findById(battleId); + battle.delete(); + return new AdminBattleDeleteResponse(true, LocalDateTime.now()); + } + + // [공통 헬퍼 메서드] + + private List convertToTodayResponses(List battles) { + return battles.stream().map(battle -> { + List tags = getTagsByBattle(battle); + List options = battleOptionRepository.findByBattle(battle); + return BattleConverter.toTodayResponse(battle, tags, options); + }).toList(); + } + + private List getTagsByBattle(Battle b) { + return battleTagRepository.findByBattle(b).stream() + .map(BattleTag::getTag) + .filter(t -> t.getDeletedAt() == null) + .toList(); + } + + private void saveBattleTags(Battle b, List ids) { + tagRepository.findAllById(ids).stream() + .filter(t -> t.getDeletedAt() == null) + .forEach(t -> battleTagRepository.save(BattleTag.builder().battle(b).tag(t).build())); } @Override public BattleOption findOptionById(UUID optionId) { return battleOptionRepository.findById(optionId) - .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_NOT_FOUND)); + .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_OPTION_NOT_FOUND)); } @Override public BattleOption findOptionByBattleIdAndLabel(UUID battleId, BattleOptionLabel label) { - Battle battle = findById(battleId); - return battleOptionRepository.findByBattleAndLabel(battle, label) - .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_NOT_FOUND)); + Battle b = findById(battleId); + return battleOptionRepository.findByBattleAndLabel(b, label) + .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_OPTION_NOT_FOUND)); } -} +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java index 85bca44..867bd2e 100644 --- a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java @@ -1,7 +1,7 @@ package com.swyp.app.domain.perspective.service; import com.swyp.app.domain.battle.entity.BattleOption; -import com.swyp.app.domain.battle.entity.BattleOptionLabel; +import com.swyp.app.domain.battle.enums.BattleOptionLabel; import com.swyp.app.domain.battle.service.BattleService; import com.swyp.app.domain.perspective.entity.PerspectiveStatus; import com.swyp.app.domain.perspective.dto.request.CreatePerspectiveRequest; diff --git a/src/main/java/com/swyp/app/domain/tag/controller/TagController.java b/src/main/java/com/swyp/app/domain/tag/controller/TagController.java new file mode 100644 index 0000000..96f30f1 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/tag/controller/TagController.java @@ -0,0 +1,64 @@ +package com.swyp.app.domain.tag.controller; + +import com.swyp.app.domain.tag.dto.request.TagRequest; +import com.swyp.app.domain.tag.dto.response.*; +import com.swyp.app.domain.tag.enums.TagType; +import com.swyp.app.domain.tag.service.TagService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.Parameter; +import io.swagger.v3.oas.annotations.tags.Tag; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +import org.springframework.web.bind.annotation.*; + +import java.util.UUID; + +@Tag(name = "태그 (Tag)", description = "태그 조회 및 관리 API") +@RestController +@RequiredArgsConstructor +@RequestMapping("/api/v1") +public class TagController { + + private final TagService tagService; + + @Operation(summary = "태그 목록 조회", description = "전체 태그 목록을 조회합니다. 특정 타입(type)을 지정하여 필터링할 수 있습니다.") + @GetMapping("/tags") + public ApiResponse getTags( + @Parameter(description = "필터링할 태그 타입 (예: BATTLE 등)", required = false) + @RequestParam(name = "type", required = false) TagType type) { + + TagListResponse response = tagService.getTags(type); + return ApiResponse.onSuccess(response); + } + + @Operation(summary = "태그 생성 (관리자)", description = "관리자가 새로운 태그를 생성합니다.") + @PostMapping("/admin/tags") + public ApiResponse createTag( + @Valid @RequestBody TagRequest request) { + + TagResponse response = tagService.createTag(request); + return ApiResponse.onSuccess(response); + } + + @Operation(summary = "태그 수정 (관리자)", description = "관리자가 기존 태그의 이름이나 정보를 수정합니다.") + @PatchMapping("/admin/tags/{tag_id}") + public ApiResponse updateTag( + @Parameter(description = "수정할 태그의 UUID", example = "123e4567-e89b-12d3-a456-426614174000") + @PathVariable("tag_id") UUID tagId, + @Valid @RequestBody TagRequest request) { + + TagResponse response = tagService.updateTag(tagId, request); + return ApiResponse.onSuccess(response); + } + + @Operation(summary = "태그 삭제 (관리자)", description = "관리자가 특정 태그를 삭제합니다. 단, 배틀에 사용 중인 태그는 삭제할 수 없습니다.") + @DeleteMapping("/admin/tags/{tag_id}") + public ApiResponse deleteTag( + @Parameter(description = "삭제할 태그의 UUID", example = "123e4567-e89b-12d3-a456-426614174000") + @PathVariable("tag_id") UUID tagId) { + + TagDeleteResponse response = tagService.deleteTag(tagId); + return ApiResponse.onSuccess(response); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/tag/converter/TagConverter.java b/src/main/java/com/swyp/app/domain/tag/converter/TagConverter.java new file mode 100644 index 0000000..d92fee8 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/tag/converter/TagConverter.java @@ -0,0 +1,35 @@ +package com.swyp.app.domain.tag.converter; + +import com.swyp.app.domain.tag.dto.request.TagRequest; +import com.swyp.app.domain.tag.dto.response.*; +import com.swyp.app.domain.tag.entity.Tag; +import org.springframework.stereotype.Component; + +import java.time.LocalDateTime; +import java.util.List; + +@Component +public class TagConverter { + + public static Tag toEntity(TagRequest request) { + return Tag.builder() + .name(request.name()) + .type(request.type()) + .build(); + } + + public static TagResponse toDetailResponse(Tag tag) { + return new TagResponse(tag.getId(), tag.getName(), tag.getType(), tag.getCreatedAt(), tag.getUpdatedAt()); + } + + public static TagListResponse toListResponse(List tags) { + List items = tags.stream() + .map(TagConverter::toDetailResponse) + .toList(); + return new TagListResponse(items, items.size()); + } + + public static TagDeleteResponse toDeleteResponse() { + return new TagDeleteResponse(true, LocalDateTime.now()); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/tag/dto/request/TagRequest.java b/src/main/java/com/swyp/app/domain/tag/dto/request/TagRequest.java new file mode 100644 index 0000000..3b124a5 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/tag/dto/request/TagRequest.java @@ -0,0 +1,13 @@ +package com.swyp.app.domain.tag.dto.request; + +import com.swyp.app.domain.tag.enums.TagType; +import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.NotNull; + +public record TagRequest( + @NotBlank(message = "태그 이름을 입력해주세요.") + String name, + + @NotNull(message = "태그 타입을 선택해주세요.") + TagType type +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/tag/dto/response/TagDeleteResponse.java b/src/main/java/com/swyp/app/domain/tag/dto/response/TagDeleteResponse.java new file mode 100644 index 0000000..0df7b20 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/tag/dto/response/TagDeleteResponse.java @@ -0,0 +1,8 @@ +package com.swyp.app.domain.tag.dto.response; + +import java.time.LocalDateTime; + +public record TagDeleteResponse( + boolean success, + LocalDateTime deletedAt +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/tag/dto/response/TagListResponse.java b/src/main/java/com/swyp/app/domain/tag/dto/response/TagListResponse.java new file mode 100644 index 0000000..8bd726d --- /dev/null +++ b/src/main/java/com/swyp/app/domain/tag/dto/response/TagListResponse.java @@ -0,0 +1,8 @@ +package com.swyp.app.domain.tag.dto.response; + +import java.util.List; + +public record TagListResponse( + List items, + int totalCount +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/tag/dto/response/TagResponse.java b/src/main/java/com/swyp/app/domain/tag/dto/response/TagResponse.java new file mode 100644 index 0000000..27be10a --- /dev/null +++ b/src/main/java/com/swyp/app/domain/tag/dto/response/TagResponse.java @@ -0,0 +1,13 @@ +package com.swyp.app.domain.tag.dto.response; + +import com.swyp.app.domain.tag.enums.TagType; +import java.time.LocalDateTime; +import java.util.UUID; + +public record TagResponse( + UUID tagId, + String name, + TagType type, + LocalDateTime createdAt, + LocalDateTime updatedAt +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/tag/entity/Tag.java b/src/main/java/com/swyp/app/domain/tag/entity/Tag.java index b4ed127..0df5f86 100644 --- a/src/main/java/com/swyp/app/domain/tag/entity/Tag.java +++ b/src/main/java/com/swyp/app/domain/tag/entity/Tag.java @@ -1,17 +1,14 @@ package com.swyp.app.domain.tag.entity; +import com.swyp.app.domain.tag.enums.TagType; import com.swyp.app.global.common.BaseEntity; -import jakarta.persistence.Column; -import jakarta.persistence.Entity; -import jakarta.persistence.GeneratedValue; -import jakarta.persistence.GenerationType; -import jakarta.persistence.Id; -import jakarta.persistence.Table; +import jakarta.persistence.*; import lombok.AccessLevel; import lombok.Builder; import lombok.Getter; import lombok.NoArgsConstructor; +import java.time.LocalDateTime; import java.util.UUID; @Getter @@ -22,13 +19,37 @@ public class Tag extends BaseEntity { @Id @GeneratedValue(strategy = GenerationType.UUID) + @Column(name = "tag_id", updatable = false, nullable = false) private UUID id; - @Column(nullable = false, unique = true, length = 50) + @Column(nullable = false, length = 50) private String name; + @Enumerated(EnumType.STRING) + @Column(nullable = false, length = 20) + private TagType type; + + @Column(name = "deleted_at") + private LocalDateTime deletedAt; + @Builder - private Tag(String name) { + public Tag(String name, TagType type) { this.name = name; + this.type = type; + this.deletedAt = null; + } + + public void updateTag(String name, TagType type) { + if (name != null && !name.isBlank()) { + this.name = name; + } + if (type != null) { + this.type = type; + } + } + + // 소프트 삭제 메서드 + public void delete() { + this.deletedAt = LocalDateTime.now(); } -} +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/tag/enums/TagType.java b/src/main/java/com/swyp/app/domain/tag/enums/TagType.java new file mode 100644 index 0000000..3b7de82 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/tag/enums/TagType.java @@ -0,0 +1,10 @@ +package com.swyp.app.domain.tag.enums; + +import lombok.Getter; +import lombok.RequiredArgsConstructor; + +@Getter +@RequiredArgsConstructor +public enum TagType { + PHILOSOPHER, CATEGORY, VALUE +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/tag/repository/TagRepository.java b/src/main/java/com/swyp/app/domain/tag/repository/TagRepository.java index 4abc69c..d72e128 100644 --- a/src/main/java/com/swyp/app/domain/tag/repository/TagRepository.java +++ b/src/main/java/com/swyp/app/domain/tag/repository/TagRepository.java @@ -1,9 +1,15 @@ package com.swyp.app.domain.tag.repository; import com.swyp.app.domain.tag.entity.Tag; +import com.swyp.app.domain.tag.enums.TagType; import org.springframework.data.jpa.repository.JpaRepository; +import java.util.List; import java.util.UUID; public interface TagRepository extends JpaRepository { -} + + List findAllByType(TagType type); + + Boolean existsByNameAndType(String name, TagType type); +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/tag/service/TagService.java b/src/main/java/com/swyp/app/domain/tag/service/TagService.java index 7be5db8..17d1acc 100644 --- a/src/main/java/com/swyp/app/domain/tag/service/TagService.java +++ b/src/main/java/com/swyp/app/domain/tag/service/TagService.java @@ -1,11 +1,20 @@ package com.swyp.app.domain.tag.service; +import com.swyp.app.domain.tag.dto.request.TagRequest; +import com.swyp.app.domain.tag.dto.response.TagDeleteResponse; +import com.swyp.app.domain.tag.dto.response.TagListResponse; +import com.swyp.app.domain.tag.dto.response.TagResponse; import com.swyp.app.domain.tag.entity.Tag; +import com.swyp.app.domain.tag.enums.TagType; import java.util.List; import java.util.UUID; public interface TagService { - List findByBattleId(UUID battleId); -} + + TagListResponse getTags(TagType type); + TagResponse createTag(TagRequest request); + TagResponse updateTag(UUID tagId, TagRequest request); + TagDeleteResponse deleteTag(UUID tagId); +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/tag/service/TagServiceImpl.java b/src/main/java/com/swyp/app/domain/tag/service/TagServiceImpl.java index 60fd259..16f8817 100644 --- a/src/main/java/com/swyp/app/domain/tag/service/TagServiceImpl.java +++ b/src/main/java/com/swyp/app/domain/tag/service/TagServiceImpl.java @@ -1,27 +1,93 @@ package com.swyp.app.domain.tag.service; import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.repository.BattleRepository; import com.swyp.app.domain.battle.repository.BattleTagRepository; -import com.swyp.app.domain.battle.service.BattleService; +import com.swyp.app.domain.tag.converter.TagConverter; +import com.swyp.app.domain.tag.dto.request.TagRequest; +import com.swyp.app.domain.tag.dto.response.*; import com.swyp.app.domain.tag.entity.Tag; +import com.swyp.app.domain.tag.enums.TagType; +import com.swyp.app.domain.tag.repository.TagRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; import java.util.List; import java.util.UUID; @Service @RequiredArgsConstructor +@Transactional(readOnly = true) public class TagServiceImpl implements TagService { - private final BattleService battleService; + private final TagRepository tagRepository; private final BattleTagRepository battleTagRepository; + private final BattleRepository battleRepository; @Override public List findByBattleId(UUID battleId) { - Battle battle = battleService.findById(battleId); + Battle battle = battleRepository.findById(battleId) + .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_NOT_FOUND)); + return battleTagRepository.findByBattle(battle).stream() .map(bt -> bt.getTag()) .toList(); } -} + + @Override + public TagListResponse getTags(TagType type) { + List tags = (type != null) ? tagRepository.findAllByType(type) : tagRepository.findAll(); + return TagConverter.toListResponse(tags); + } + + @Override + @Transactional + public TagResponse createTag(TagRequest request) { + validateDuplicateTag(request.name(), request.type()); + + Tag newTag = TagConverter.toEntity(request); + Tag savedTag = tagRepository.save(newTag); + + return TagConverter.toDetailResponse(savedTag); + } + + @Override + @Transactional + public TagResponse updateTag(UUID tagId, TagRequest request) { + Tag tag = findTagById(tagId); + + if (!tag.getName().equals(request.name()) || tag.getType() != request.type()) { + validateDuplicateTag(request.name(), request.type()); + } + + tag.updateTag(request.name(), request.type()); + return TagConverter.toDetailResponse(tag); + } + + @Override + @Transactional + public TagDeleteResponse deleteTag(UUID tagId) { + Tag tag = findTagById(tagId); + + if (battleTagRepository.existsByTag(tag)) { + throw new CustomException(ErrorCode.TAG_IN_USE); + } + + tag.delete(); + return TagConverter.toDeleteResponse(); + } + + private Tag findTagById(UUID tagId) { + return tagRepository.findById(tagId) + .orElseThrow(() -> new CustomException(ErrorCode.TAG_NOT_FOUND)); + } + + private void validateDuplicateTag(String name, TagType type) { + if (tagRepository.existsByNameAndType(name, type)) { + throw new CustomException(ErrorCode.TAG_DUPLICATED); + } + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/user/entity/User.java b/src/main/java/com/swyp/app/domain/user/entity/User.java index fcaaf6f..37c7ee8 100644 --- a/src/main/java/com/swyp/app/domain/user/entity/User.java +++ b/src/main/java/com/swyp/app/domain/user/entity/User.java @@ -29,6 +29,12 @@ public class User extends BaseEntity { @Column(name = "user_tag", nullable = false, unique = true, length = 30) private String userTag; + @Column(length = 50) + private String nickname; + + @Column(name = "character_url", columnDefinition = "TEXT") + private String characterUrl; + @Enumerated(EnumType.STRING) @Column(nullable = false, length = 20) private UserRole role; @@ -44,8 +50,10 @@ public class User extends BaseEntity { private LocalDateTime deletedAt; @Builder - private User(String userTag, UserRole role, UserStatus status, boolean onboardingCompleted) { + private User(String userTag, String nickname, String characterUrl, UserRole role, UserStatus status, boolean onboardingCompleted) { this.userTag = userTag; + this.nickname = nickname; + this.characterUrl = characterUrl; this.role = role; this.status = status; this.onboardingCompleted = onboardingCompleted; @@ -55,4 +63,4 @@ public void completeOnboarding() { this.status = UserStatus.ACTIVE; this.onboardingCompleted = true; } -} +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java b/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java index 3e430c8..7691467 100644 --- a/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java +++ b/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java @@ -3,7 +3,6 @@ import com.swyp.app.domain.user.entity.User; import org.springframework.data.jpa.repository.JpaRepository; -public interface UserRepository extends JpaRepository { import java.util.Optional; public interface UserRepository extends JpaRepository { diff --git a/src/main/java/com/swyp/app/domain/vote/controller/VoteController.java b/src/main/java/com/swyp/app/domain/vote/controller/VoteController.java index 3575186..8c96f9b 100644 --- a/src/main/java/com/swyp/app/domain/vote/controller/VoteController.java +++ b/src/main/java/com/swyp/app/domain/vote/controller/VoteController.java @@ -1,20 +1,19 @@ package com.swyp.app.domain.vote.controller; +import com.swyp.app.domain.vote.dto.request.VoteRequest; import com.swyp.app.domain.vote.dto.response.MyVoteResponse; +import com.swyp.app.domain.vote.dto.response.VoteResultResponse; import com.swyp.app.domain.vote.dto.response.VoteStatsResponse; import com.swyp.app.domain.vote.service.VoteService; import com.swyp.app.global.common.response.ApiResponse; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; -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.RestController; +import org.springframework.web.bind.annotation.*; import java.util.UUID; -@Tag(name = "투표 (Vote)", description = "투표 통계 및 내 투표 내역 조회 API") +@Tag(name = "투표 (Vote)", description = "사전/사후 투표 실행 및 통계, 내 투표 내역 조회 API") @RestController @RequestMapping("/api/v1") @RequiredArgsConstructor @@ -22,17 +21,37 @@ public class VoteController { private final VoteService voteService; + @Operation(summary = "사전 투표 실행", description = "배틀 진입 시 첫 투표(사전 투표)를 진행합니다.") + @PostMapping("/battles/{battleId}/votes/pre") + public ApiResponse preVote( + @PathVariable UUID battleId, + @RequestBody VoteRequest request) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + return ApiResponse.onSuccess(voteService.preVote(battleId, userId, request)); + } + + @Operation(summary = "사후 투표 실행", description = "콘텐츠 소비 후 최종 투표(사후 투표)를 진행합니다.") + @PostMapping("/battles/{battleId}/votes/post") + public ApiResponse postVote( + @PathVariable UUID battleId, + @RequestBody VoteRequest request) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + return ApiResponse.onSuccess(voteService.postVote(battleId, userId, request)); + } + @Operation(summary = "투표 통계 조회", description = "특정 배틀의 옵션별 투표 수와 비율을 조회합니다.") @GetMapping("/battles/{battleId}/vote-stats") public ApiResponse getVoteStats(@PathVariable UUID battleId) { return ApiResponse.onSuccess(voteService.getVoteStats(battleId)); } - @Operation(summary = "내 투표 내역 조회", description = "특정 배틀에 대한 내 사전/사후 투표 내역과 생각 변화 여부를 조회합니다.") + @Operation(summary = "내 투표 내역 조회", description = "특정 배틀에 대한 내 사전/사후 투표 내역과 현재 상태를 조회합니다.") @GetMapping("/battles/{battleId}/votes/me") public ApiResponse getMyVote(@PathVariable UUID battleId) { // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 Long userId = 1L; return ApiResponse.onSuccess(voteService.getMyVote(battleId, userId)); } -} +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/vote/converter/VoteConverter.java b/src/main/java/com/swyp/app/domain/vote/converter/VoteConverter.java new file mode 100644 index 0000000..1332244 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/vote/converter/VoteConverter.java @@ -0,0 +1,38 @@ +package com.swyp.app.domain.vote.converter; + +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.vote.dto.response.MyVoteResponse; +import com.swyp.app.domain.vote.dto.response.VoteResultResponse; +import com.swyp.app.domain.vote.dto.response.VoteStatsResponse; +import com.swyp.app.domain.vote.entity.Vote; + +import java.time.LocalDateTime; +import java.util.List; + +public class VoteConverter { + + // 투표 실행 결과 변환 + public static VoteResultResponse toVoteResultResponse(Vote vote) { + return new VoteResultResponse(vote.getId(), vote.getStatus()); + } + + // 내 투표 내역 변환 + public static MyVoteResponse toMyVoteResponse(Vote vote) { + return new MyVoteResponse( + toOptionInfo(vote.getPreVoteOption()), + toOptionInfo(vote.getPostVoteOption()), + vote.getStatus() + ); + } + + // 투표 통계 변환 + public static VoteStatsResponse toVoteStatsResponse(List stats, long totalCount, LocalDateTime updatedAt) { + return new VoteStatsResponse(stats, totalCount, updatedAt); + } + + // 옵션 정보를 응답용으로 변환 (null 안전 처리) + private static MyVoteResponse.OptionInfo toOptionInfo(BattleOption option) { + if (option == null) return null; + return new MyVoteResponse.OptionInfo(option.getId(), option.getLabel().name(), option.getTitle()); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/vote/dto/request/VoteRequest.java b/src/main/java/com/swyp/app/domain/vote/dto/request/VoteRequest.java new file mode 100644 index 0000000..194ccbf --- /dev/null +++ b/src/main/java/com/swyp/app/domain/vote/dto/request/VoteRequest.java @@ -0,0 +1,7 @@ +package com.swyp.app.domain.vote.dto.request; + +import java.util.UUID; + +public record VoteRequest( + UUID optionId +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/vote/dto/response/MyVoteResponse.java b/src/main/java/com/swyp/app/domain/vote/dto/response/MyVoteResponse.java index 4a99b1d..354ecb4 100644 --- a/src/main/java/com/swyp/app/domain/vote/dto/response/MyVoteResponse.java +++ b/src/main/java/com/swyp/app/domain/vote/dto/response/MyVoteResponse.java @@ -1,13 +1,12 @@ package com.swyp.app.domain.vote.dto.response; -import com.swyp.app.domain.vote.entity.VoteStatus; +import com.swyp.app.domain.vote.enums.VoteStatus; import java.util.UUID; public record MyVoteResponse( OptionInfo preVote, OptionInfo postVote, - boolean mindChanged, VoteStatus status ) { public record OptionInfo(UUID optionId, String label, String title) {} diff --git a/src/main/java/com/swyp/app/domain/vote/dto/response/VoteResultResponse.java b/src/main/java/com/swyp/app/domain/vote/dto/response/VoteResultResponse.java new file mode 100644 index 0000000..6ffa2a0 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/vote/dto/response/VoteResultResponse.java @@ -0,0 +1,9 @@ +package com.swyp.app.domain.vote.dto.response; + +import com.swyp.app.domain.vote.enums.VoteStatus; +import java.util.UUID; + +public record VoteResultResponse( + UUID voteId, + VoteStatus status +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/vote/entity/Vote.java b/src/main/java/com/swyp/app/domain/vote/entity/Vote.java index 2851acb..33a92f1 100644 --- a/src/main/java/com/swyp/app/domain/vote/entity/Vote.java +++ b/src/main/java/com/swyp/app/domain/vote/entity/Vote.java @@ -2,6 +2,7 @@ import com.swyp.app.domain.battle.entity.Battle; import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.vote.enums.VoteStatus; import com.swyp.app.global.common.BaseEntity; import jakarta.persistence.Column; import jakarta.persistence.Entity; @@ -47,25 +48,33 @@ public class Vote extends BaseEntity { @JoinColumn(name = "post_vote_option_id") private BattleOption postVoteOption; - @Column(name = "mind_changed", nullable = false) - private boolean mindChanged; - - @Column(name = "reward_credits", nullable = false) - private int rewardCredits; - @Enumerated(EnumType.STRING) @Column(nullable = false, length = 20) private VoteStatus status; @Builder private Vote(Long userId, Battle battle, BattleOption preVoteOption, - BattleOption postVoteOption, boolean mindChanged, int rewardCredits, VoteStatus status) { + BattleOption postVoteOption, VoteStatus status) { this.userId = userId; this.battle = battle; this.preVoteOption = preVoteOption; this.postVoteOption = postVoteOption; - this.mindChanged = mindChanged; - this.rewardCredits = rewardCredits; this.status = status; } -} + + // 사전 투표 생성 팩토리 메서드 + public static Vote createPreVote(Long userId, Battle battle, BattleOption option) { + return Vote.builder() + .userId(userId) + .battle(battle) + .preVoteOption(option) + .status(VoteStatus.PRE_VOTED) + .build(); + } + + // 사후 투표 실행 상태 변경 메서드 + public void doPostVote(BattleOption postOption) { + this.postVoteOption = postOption; + this.status = VoteStatus.POST_VOTED; + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/vote/entity/VoteStatus.java b/src/main/java/com/swyp/app/domain/vote/enums/VoteStatus.java similarity index 59% rename from src/main/java/com/swyp/app/domain/vote/entity/VoteStatus.java rename to src/main/java/com/swyp/app/domain/vote/enums/VoteStatus.java index 478c63d..166ce81 100644 --- a/src/main/java/com/swyp/app/domain/vote/entity/VoteStatus.java +++ b/src/main/java/com/swyp/app/domain/vote/enums/VoteStatus.java @@ -1,4 +1,4 @@ -package com.swyp.app.domain.vote.entity; +package com.swyp.app.domain.vote.enums; public enum VoteStatus { NONE, PRE_VOTED, POST_VOTED diff --git a/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java b/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java index 9410f06..ca13e2c 100644 --- a/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java +++ b/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java @@ -17,4 +17,4 @@ public interface VoteRepository extends JpaRepository { long countByBattleAndPreVoteOption(Battle battle, BattleOption preVoteOption); Optional findTopByBattleOrderByUpdatedAtDesc(Battle battle); -} +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/vote/service/VoteService.java b/src/main/java/com/swyp/app/domain/vote/service/VoteService.java index 0c8b8d1..6efc522 100644 --- a/src/main/java/com/swyp/app/domain/vote/service/VoteService.java +++ b/src/main/java/com/swyp/app/domain/vote/service/VoteService.java @@ -1,6 +1,8 @@ package com.swyp.app.domain.vote.service; +import com.swyp.app.domain.vote.dto.request.VoteRequest; import com.swyp.app.domain.vote.dto.response.MyVoteResponse; +import com.swyp.app.domain.vote.dto.response.VoteResultResponse; import com.swyp.app.domain.vote.dto.response.VoteStatsResponse; import java.util.UUID; @@ -12,4 +14,8 @@ public interface VoteService { VoteStatsResponse getVoteStats(UUID battleId); MyVoteResponse getMyVote(UUID battleId, Long userId); -} + + VoteResultResponse preVote(UUID battleId, Long userId, VoteRequest request); + + VoteResultResponse postVote(UUID battleId, Long userId, VoteRequest request); +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java b/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java index 8e7bb9f..1df48b1 100644 --- a/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java +++ b/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java @@ -4,9 +4,13 @@ import com.swyp.app.domain.battle.entity.BattleOption; import com.swyp.app.domain.battle.repository.BattleOptionRepository; import com.swyp.app.domain.battle.service.BattleService; +import com.swyp.app.domain.vote.converter.VoteConverter; +import com.swyp.app.domain.vote.dto.request.VoteRequest; import com.swyp.app.domain.vote.dto.response.MyVoteResponse; +import com.swyp.app.domain.vote.dto.response.VoteResultResponse; import com.swyp.app.domain.vote.dto.response.VoteStatsResponse; import com.swyp.app.domain.vote.entity.Vote; +import com.swyp.app.domain.vote.enums.VoteStatus; import com.swyp.app.domain.vote.repository.VoteRepository; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; @@ -33,7 +37,7 @@ public UUID findPreVoteOptionId(UUID battleId, Long userId) { Vote vote = voteRepository.findByBattleAndUserId(battle, userId) .orElseThrow(() -> new CustomException(ErrorCode.VOTE_NOT_FOUND)); if (vote.getPreVoteOption() == null) { - throw new CustomException(ErrorCode.PERSPECTIVE_POST_VOTE_REQUIRED); + throw new CustomException(ErrorCode.PRE_VOTE_REQUIRED); } return vote.getPreVoteOption().getId(); } @@ -59,7 +63,7 @@ public VoteStatsResponse getVoteStats(UUID battleId) { .map(Vote::getUpdatedAt) .orElse(null); - return new VoteStatsResponse(stats, totalCount, updatedAt); + return VoteConverter.toVoteStatsResponse(stats, totalCount, updatedAt); } @Override @@ -68,14 +72,44 @@ public MyVoteResponse getMyVote(UUID battleId, Long userId) { Vote vote = voteRepository.findByBattleAndUserId(battle, userId) .orElseThrow(() -> new CustomException(ErrorCode.VOTE_NOT_FOUND)); - MyVoteResponse.OptionInfo preVote = toOptionInfo(vote.getPreVoteOption()); - MyVoteResponse.OptionInfo postVote = toOptionInfo(vote.getPostVoteOption()); + return VoteConverter.toMyVoteResponse(vote); + } + + @Override + @Transactional + public VoteResultResponse preVote(UUID battleId, Long userId, VoteRequest request) { + Battle battle = battleService.findById(battleId); + BattleOption option = battleOptionRepository.findById(request.optionId()) + .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_OPTION_NOT_FOUND)); - return new MyVoteResponse(preVote, postVote, vote.isMindChanged(), vote.getStatus()); + // 이미 투표 내역이 존재하는지 검증 + if (voteRepository.findByBattleAndUserId(battle, userId).isPresent()) { + throw new CustomException(ErrorCode.VOTE_ALREADY_SUBMITTED); + } + + Vote vote = Vote.createPreVote(userId, battle, option); + voteRepository.save(vote); + + return VoteConverter.toVoteResultResponse(vote); } - private MyVoteResponse.OptionInfo toOptionInfo(BattleOption option) { - if (option == null) return null; - return new MyVoteResponse.OptionInfo(option.getId(), option.getLabel().name(), option.getTitle()); + @Override + @Transactional + public VoteResultResponse postVote(UUID battleId, Long userId, VoteRequest request) { + Battle battle = battleService.findById(battleId); + BattleOption option = battleOptionRepository.findById(request.optionId()) + .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_OPTION_NOT_FOUND)); + + Vote vote = voteRepository.findByBattleAndUserId(battle, userId) + .orElseThrow(() -> new CustomException(ErrorCode.VOTE_NOT_FOUND)); + + // 사전 투표 상태일 때만 사후 투표 가능 + if (vote.getStatus() != VoteStatus.PRE_VOTED) { + throw new CustomException(ErrorCode.INVALID_VOTE_STATUS); + } + + vote.doPostVote(option); + + return VoteConverter.toVoteResultResponse(vote); } -} +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/global/common/BaseEntity.java b/src/main/java/com/swyp/app/global/common/BaseEntity.java index 8da69f0..ccf7f32 100644 --- a/src/main/java/com/swyp/app/global/common/BaseEntity.java +++ b/src/main/java/com/swyp/app/global/common/BaseEntity.java @@ -16,9 +16,10 @@ public abstract class BaseEntity { @CreatedDate - @Column(updatable = false) + @Column(name = "created_at", updatable = false) private LocalDateTime createdAt; @LastModifiedDate + @Column(name = "updated_at") private LocalDateTime updatedAt; } \ No newline at end of file diff --git a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java index 313c074..95e2aea 100644 --- a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java +++ b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java @@ -7,40 +7,54 @@ @Getter @AllArgsConstructor public enum ErrorCode { + // Common INTERNAL_SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "COMMON_500", "서버 에러, 관리자에게 문의하세요."), - BAD_REQUEST(HttpStatus.BAD_REQUEST, "COMMON_400", "잘못된 요청입니다."), - AUTH_UNAUTHORIZED(HttpStatus.UNAUTHORIZED, "AUTH_401", "인증 정보가 필요합니다."), + BAD_REQUEST (HttpStatus.BAD_REQUEST, "COMMON_400", "잘못된 요청입니다."), + AUTH_UNAUTHORIZED (HttpStatus.UNAUTHORIZED, "AUTH_401", "인증 정보가 필요합니다."), // User - USER_NOT_FOUND(HttpStatus.NOT_FOUND, "USER_404", "존재하지 않는 유저입니다."), - - // Battle & Tag - BATTLE_NOT_FOUND(HttpStatus.NOT_FOUND, "BATTLE_404", "존재하지 않는 배틀입니다."), - TAG_NOT_FOUND(HttpStatus.NOT_FOUND, "TAG_404", "존재하지 않는 태그입니다."), + USER_NOT_FOUND (HttpStatus.NOT_FOUND, "USER_404", "존재하지 않는 사용자입니다."), + ONBOARDING_ALREADY_COMPLETED(HttpStatus.CONFLICT, "USER_409", "이미 온보딩이 완료된 사용자입니다."), + + // Battle + BATTLE_NOT_FOUND (HttpStatus.NOT_FOUND, "BATTLE_404", "존재하지 않는 배틀입니다."), + BATTLE_CLOSED (HttpStatus.CONFLICT, "BATTLE_409_CLS", "종료된 배틀입니다."), + BATTLE_ALREADY_PUBLISHED(HttpStatus.CONFLICT, "BATTLE_409_PUB", "이미 발행된 배틀입니다."), + BATTLE_OPTION_NOT_FOUND (HttpStatus.NOT_FOUND, "BATTLE_OPT_404", "존재하지 않는 선택지입니다."), + BATTLE_INVALID_OPTION_COUNT(HttpStatus.BAD_REQUEST, "BATTLE_400_OPT", "배틀 타입에 맞지 않는 선택지 개수입니다."), + + // Tag + TAG_NOT_FOUND (HttpStatus.NOT_FOUND, "TAG_404", "존재하지 않는 태그입니다."), + TAG_DUPLICATED (HttpStatus.CONFLICT, "TAG_409_DUP", "이미 존재하는 태그명입니다."), + TAG_IN_USE (HttpStatus.CONFLICT, "TAG_409_USE", "배틀에 사용 중인 태그라 삭제할 수 없습니다."), + TAG_INVALID_ID (HttpStatus.BAD_REQUEST, "TAG_400_ID", "잘못된 태그 ID 형식입니다."), + TAG_INVALID_TYPE (HttpStatus.BAD_REQUEST, "TAG_400_TYPE", "알 수 없는 태그 타입입니다."), + TAG_LIMIT_EXCEEDED(HttpStatus.BAD_REQUEST, "TAG_400_LIMIT", "배틀당 태그 최대 개수를 초과했습니다."), // Perspective - PERSPECTIVE_NOT_FOUND(HttpStatus.NOT_FOUND, "PERSPECTIVE_404", "존재하지 않는 관점입니다."), - PERSPECTIVE_ALREADY_EXISTS(HttpStatus.CONFLICT, "PERSPECTIVE_409", "이미 관점을 작성한 배틀입니다."), - PERSPECTIVE_FORBIDDEN(HttpStatus.FORBIDDEN, "PERSPECTIVE_403", "본인 관점만 수정/삭제할 수 있습니다."), - PERSPECTIVE_POST_VOTE_REQUIRED(HttpStatus.CONFLICT, "PERSPECTIVE_VOTE_409", "사후 투표가 완료되지 않았습니다."), + PERSPECTIVE_NOT_FOUND (HttpStatus.NOT_FOUND, "PERSPECTIVE_404", "존재하지 않는 관점입니다."), + PERSPECTIVE_ALREADY_EXISTS (HttpStatus.CONFLICT, "PERSPECTIVE_409", "이미 관점을 작성한 배틀입니다."), + PERSPECTIVE_FORBIDDEN (HttpStatus.FORBIDDEN, "PERSPECTIVE_403", "본인 관점만 수정/삭제할 수 있습니다."), + PERSPECTIVE_POST_VOTE_REQUIRED(HttpStatus.CONFLICT, "PERSPECTIVE_VOTE_409", "사후 투표가 완료되지 않았습니다."), // Comment COMMENT_NOT_FOUND(HttpStatus.NOT_FOUND, "COMMENT_404", "존재하지 않는 댓글입니다."), COMMENT_FORBIDDEN(HttpStatus.FORBIDDEN, "COMMENT_403", "본인 댓글만 수정/삭제할 수 있습니다."), // Like - LIKE_ALREADY_EXISTS(HttpStatus.CONFLICT, "LIKE_409", "이미 좋아요를 누른 관점입니다."), - LIKE_NOT_FOUND(HttpStatus.NOT_FOUND, "LIKE_404", "좋아요를 누른 적 없는 관점입니다."), + LIKE_ALREADY_EXISTS(HttpStatus.CONFLICT, "LIKE_409", "이미 좋아요를 누른 관점입니다."), + LIKE_NOT_FOUND (HttpStatus.NOT_FOUND, "LIKE_404", "좋아요를 누른 적 없는 관점입니다."), LIKE_SELF_FORBIDDEN(HttpStatus.FORBIDDEN, "LIKE_403", "본인 관점에는 좋아요를 누를 수 없습니다."), // Vote - VOTE_NOT_FOUND(HttpStatus.NOT_FOUND, "VOTE_404", "투표 내역이 없습니다."); - // User - USER_NOT_FOUND(HttpStatus.NOT_FOUND, "USER_404", "존재하지 않는 사용자입니다."), - ONBOARDING_ALREADY_COMPLETED(HttpStatus.CONFLICT, "USER_409", "이미 온보딩이 완료된 사용자입니다."); + VOTE_NOT_FOUND (HttpStatus.NOT_FOUND, "VOTE_404", "투표 내역이 없습니다."), + VOTE_ALREADY_SUBMITTED(HttpStatus.CONFLICT, "VOTE_409_SUB", "이미 투표가 완료되었습니다."), + INVALID_VOTE_STATUS (HttpStatus.BAD_REQUEST, "VOTE_400_INV", "사전 투표를 진행해야 하거나, 이미 사후 투표가 완료되었습니다."), // 💡 새로 추가됨! + PRE_VOTE_REQUIRED (HttpStatus.CONFLICT, "VOTE_409_PRE", "사전 투표가 필요합니다."), + POST_VOTE_REQUIRED (HttpStatus.CONFLICT, "VOTE_409_PST", "사후 투표가 필요합니다."); private final HttpStatus httpStatus; private final String code; private final String message; -} +} \ No newline at end of file diff --git a/src/main/resources/application.yml b/src/main/resources/application.yml index 1607f89..77987d2 100644 --- a/src/main/resources/application.yml +++ b/src/main/resources/application.yml @@ -14,9 +14,6 @@ spring: format_sql: true dialect: org.hibernate.dialect.PostgreSQLDialect - jackson: - property-naming-strategy: SNAKE_CASE - springdoc: default-consumes-media-type: application/json default-produces-media-type: application/json From 6d63f2f87c47812c877e353f626c1df17b5046fa Mon Sep 17 00:00:00 2001 From: Youwol <153346797+si-zero@users.noreply.github.com> Date: Mon, 16 Mar 2026 19:41:59 +0900 Subject: [PATCH 12/70] =?UTF-8?q?#18=20[Feat]=20OAuth2.0=20=EC=97=B0?= =?UTF-8?q?=EB=8F=99=20=EB=B0=8F=20=EA=B5=AC=ED=98=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- build.gradle | 6 + .../oauth/client/GoogleOAuthClient.java | 58 ++++++ .../domain/oauth/client/KakaoOAuthClient.java | 63 ++++++ .../oauth/controller/AuthController.java | 55 +++++ .../app/domain/oauth/dto/LoginRequest.java | 10 + .../app/domain/oauth/dto/LoginResponse.java | 18 ++ .../app/domain/oauth/dto/OAuthUserInfo.java | 13 ++ .../oauth/dto/google/GoogleTokenResponse.java | 20 ++ .../oauth/dto/google/GoogleUserResponse.java | 15 ++ .../oauth/dto/kakao/KakaoTokenResponse.java | 20 ++ .../oauth/dto/kakao/KakaoUserResponse.java | 18 ++ .../domain/oauth/entity/AuthRefreshToken.java | 47 +++++ .../oauth/entity/UserSocialAccount.java | 48 +++++ .../swyp/app/domain/oauth/jwt/JwtFilter.java | 77 +++++++ .../app/domain/oauth/jwt/JwtProvider.java | 75 +++++++ .../AuthRefreshTokenRepository.java | 14 ++ .../UserSocialAccountRepository.java | 12 ++ .../app/domain/oauth/service/AuthService.java | 188 ++++++++++++++++++ .../dto/response/CommentListResponse.java | 2 +- .../dto/response/CreateCommentResponse.java | 2 +- .../dto/response/PerspectiveListResponse.java | 2 +- .../service/PerspectiveCommentService.java | 4 +- .../service/PerspectiveService.java | 2 +- .../com/swyp/app/domain/user/entity/User.java | 7 +- .../app/domain/user/entity/UserStatus.java | 5 +- .../repository/UserProfileRepository.java | 3 + .../user/repository/UserRepository.java | 3 +- .../domain/user/service/UserQueryService.java | 2 +- .../user/service/UserQueryServiceImpl.java | 9 +- .../global/common/exception/ErrorCode.java | 23 ++- .../exception/GlobalExceptionHandler.java | 2 +- .../app/global/config/SecurityConfig.java | 29 ++- .../swyp/app/global/config/SwaggerConfig.java | 22 +- 33 files changed, 845 insertions(+), 29 deletions(-) create mode 100644 src/main/java/com/swyp/app/domain/oauth/client/GoogleOAuthClient.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/client/KakaoOAuthClient.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/controller/AuthController.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/dto/LoginRequest.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/dto/LoginResponse.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/dto/OAuthUserInfo.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/dto/google/GoogleTokenResponse.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/dto/google/GoogleUserResponse.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/dto/kakao/KakaoTokenResponse.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/dto/kakao/KakaoUserResponse.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/entity/AuthRefreshToken.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/entity/UserSocialAccount.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/jwt/JwtFilter.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/jwt/JwtProvider.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/repository/AuthRefreshTokenRepository.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/repository/UserSocialAccountRepository.java create mode 100644 src/main/java/com/swyp/app/domain/oauth/service/AuthService.java diff --git a/build.gradle b/build.gradle index 4856d4f..6767d41 100644 --- a/build.gradle +++ b/build.gradle @@ -32,6 +32,12 @@ dependencies { implementation 'org.springframework.boot:spring-boot-starter-data-jpa' // Security implementation 'org.springframework.boot:spring-boot-starter-security' + // JWT + implementation 'io.jsonwebtoken:jjwt-api:0.12.6' + runtimeOnly 'io.jsonwebtoken:jjwt-impl:0.12.6' + runtimeOnly 'io.jsonwebtoken:jjwt-jackson:0.12.6' + // HTTP Client (소셜 API 호출용) + implementation 'org.springframework.boot:spring-boot-starter-webflux' // Swagger implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:3.0.1' // Lombok diff --git a/src/main/java/com/swyp/app/domain/oauth/client/GoogleOAuthClient.java b/src/main/java/com/swyp/app/domain/oauth/client/GoogleOAuthClient.java new file mode 100644 index 0000000..76f64df --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/client/GoogleOAuthClient.java @@ -0,0 +1,58 @@ +package com.swyp.app.domain.oauth.client; + +import com.swyp.app.domain.oauth.dto.OAuthUserInfo; +import com.swyp.app.domain.oauth.dto.google.GoogleTokenResponse; +import com.swyp.app.domain.oauth.dto.google.GoogleUserResponse; +import lombok.RequiredArgsConstructor; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.http.HttpHeaders; +import org.springframework.http.MediaType; +import org.springframework.stereotype.Component; +import org.springframework.util.LinkedMultiValueMap; +import org.springframework.util.MultiValueMap; +import org.springframework.web.reactive.function.client.WebClient; + +@Component +@RequiredArgsConstructor +public class GoogleOAuthClient { + + @Value("${oauth.google.client-id}") + private String clientId; + + @Value("${oauth.google.client-secret}") + private String clientSecret; + + // 인가 코드 → 구글 access_token + public String getAccessToken(String code, String redirectUri) { + MultiValueMap body = new LinkedMultiValueMap<>(); + body.add("grant_type", "authorization_code"); + body.add("client_id", clientId); + body.add("client_secret", clientSecret); + body.add("redirect_uri", redirectUri); + body.add("code", code); + + GoogleTokenResponse response = WebClient.create() + .post() + .uri("https://oauth2.googleapis.com/token") + .contentType(MediaType.APPLICATION_FORM_URLENCODED) + .bodyValue(body) + .retrieve() + .bodyToMono(GoogleTokenResponse.class) + .block(); + + return response.getAccessToken(); + } + + // 구글 access_token → 사용자 정보 + public OAuthUserInfo getUserInfo(String accessToken) { + GoogleUserResponse response = WebClient.create() + .get() + .uri("https://www.googleapis.com/oauth2/v2/userinfo") + .header(HttpHeaders.AUTHORIZATION, "Bearer " + accessToken) + .retrieve() + .bodyToMono(GoogleUserResponse.class) + .block(); + + return new OAuthUserInfo("GOOGLE", response.getId(), response.getEmail()); + } +} diff --git a/src/main/java/com/swyp/app/domain/oauth/client/KakaoOAuthClient.java b/src/main/java/com/swyp/app/domain/oauth/client/KakaoOAuthClient.java new file mode 100644 index 0000000..ba242a6 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/client/KakaoOAuthClient.java @@ -0,0 +1,63 @@ +package com.swyp.app.domain.oauth.client; + +import com.swyp.app.domain.oauth.dto.OAuthUserInfo; +import com.swyp.app.domain.oauth.dto.kakao.KakaoTokenResponse; +import com.swyp.app.domain.oauth.dto.kakao.KakaoUserResponse; +import lombok.RequiredArgsConstructor; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.http.HttpHeaders; +import org.springframework.http.MediaType; +import org.springframework.stereotype.Component; +import org.springframework.util.LinkedMultiValueMap; +import org.springframework.util.MultiValueMap; +import org.springframework.web.reactive.function.client.WebClient; + +@Component +@RequiredArgsConstructor +public class KakaoOAuthClient { + + @Value("${oauth.kakao.client-id}") + private String clientId; + + @Value("${oauth.kakao.client-secret:}") + private String clientSecret; + + // 인가 코드 → 카카오 access_token + public String getAccessToken(String code, String redirectUri) { + MultiValueMap body = new LinkedMultiValueMap<>(); + body.add("grant_type", "authorization_code"); + body.add("client_id", clientId); + body.add("redirect_uri", redirectUri); + body.add("code", code); + + if (clientSecret != null && !clientSecret.isEmpty()) { + body.add("client_secret", clientSecret); + } + + KakaoTokenResponse response = WebClient.create() + .post() + .uri("https://kauth.kakao.com/oauth/token") + .contentType(MediaType.APPLICATION_FORM_URLENCODED) + .bodyValue(body) + .retrieve() + .bodyToMono(KakaoTokenResponse.class) + .block(); + + return response.getAccessToken(); + } + + // 카카오 access_token → 사용자 정보 + public OAuthUserInfo getUserInfo(String accessToken) { + KakaoUserResponse response = WebClient.create() + .get() + .uri("https://kapi.kakao.com/v2/user/me") + .header(HttpHeaders.AUTHORIZATION, "Bearer " + accessToken) + .retrieve() + .bodyToMono(KakaoUserResponse.class) + .block(); + + String providerId = String.valueOf(response.getId()); + + return new OAuthUserInfo("KAKAO", providerId, null); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/oauth/controller/AuthController.java b/src/main/java/com/swyp/app/domain/oauth/controller/AuthController.java new file mode 100644 index 0000000..ea9f7cb --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/controller/AuthController.java @@ -0,0 +1,55 @@ +package com.swyp.app.domain.oauth.controller; + +import com.swyp.app.domain.oauth.dto.LoginRequest; +import com.swyp.app.domain.oauth.dto.LoginResponse; +import com.swyp.app.domain.oauth.service.AuthService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import lombok.RequiredArgsConstructor; +import org.springframework.security.core.annotation.AuthenticationPrincipal; +import org.springframework.web.bind.annotation.*; + +@RestController +@RequestMapping("/api/v1") +@RequiredArgsConstructor +@Tag(name = "Auth", description = "인증 API") +public class AuthController { + + private final AuthService authService; + + @Operation(summary = "소셜 로그인") + @PostMapping("/auth/login/{provider}") + public ApiResponse login( + @PathVariable String provider, + @RequestBody LoginRequest request + ) { + return ApiResponse.onSuccess(authService.login(provider, request)); + } + + @Operation(summary = "Access Token 재발급") + @PostMapping("/auth/refresh") + public ApiResponse refresh( + @RequestHeader("X-Refresh-Token") String refreshToken + ) { + return ApiResponse.onSuccess(authService.refresh(refreshToken)); + } + + @Operation(summary = "로그아웃") + @PostMapping("/auth/logout") + public ApiResponse logout( + @AuthenticationPrincipal Long userId + ) { + authService.logout(userId); + return ApiResponse.onSuccess(null); + } + + @Operation(summary = "회원 탈퇴") + @DeleteMapping("/me") + public ApiResponse withdraw( + @AuthenticationPrincipal Long userId + ) { + authService.withdraw(userId); + return ApiResponse.onSuccess(null); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/oauth/dto/LoginRequest.java b/src/main/java/com/swyp/app/domain/oauth/dto/LoginRequest.java new file mode 100644 index 0000000..c397553 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/dto/LoginRequest.java @@ -0,0 +1,10 @@ +package com.swyp.app.domain.oauth.dto; + +import lombok.Getter; + +// 클라이언트가 서버로 요청을 보낼 때, 데이터를 담는 DTO +@Getter +public class LoginRequest { + private String authorizationCode; + private String redirectUri; +} diff --git a/src/main/java/com/swyp/app/domain/oauth/dto/LoginResponse.java b/src/main/java/com/swyp/app/domain/oauth/dto/LoginResponse.java new file mode 100644 index 0000000..74503c8 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/dto/LoginResponse.java @@ -0,0 +1,18 @@ +package com.swyp.app.domain.oauth.dto; + +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.AllArgsConstructor; +import lombok.Getter; + +// 서버가 클라이언트에게 데이터를 돌려줄 때, 데이터를 담는 DTO +@Getter +@AllArgsConstructor +public class LoginResponse { + private String accessToken; + private String refreshToken; + private String userTag; // 회의에서 userTag 반환하는 것으로 통일했기 때문에 userId 대신 userTag 반환 + + @JsonProperty("is_new_user") + private boolean isNewUser; + private String status; +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/oauth/dto/OAuthUserInfo.java b/src/main/java/com/swyp/app/domain/oauth/dto/OAuthUserInfo.java new file mode 100644 index 0000000..254ca2e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/dto/OAuthUserInfo.java @@ -0,0 +1,13 @@ +package com.swyp.app.domain.oauth.dto; + +import lombok.AllArgsConstructor; +import lombok.Getter; + +// 소셜 API를 호출해서 받아온 사용자 정보를 담는 DTO +@Getter +@AllArgsConstructor +public class OAuthUserInfo { + private String provider; // "KAKAO" or "GOOGLE" + private String providerUserId; // 소셜 고유 ID + private String email; // nullable - 소셜 로그인 시도 시 선택 동의 안함 체크로 인해 +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/oauth/dto/google/GoogleTokenResponse.java b/src/main/java/com/swyp/app/domain/oauth/dto/google/GoogleTokenResponse.java new file mode 100644 index 0000000..0c08ff7 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/dto/google/GoogleTokenResponse.java @@ -0,0 +1,20 @@ +package com.swyp.app.domain.oauth.dto.google; + +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; + +@Getter +public class GoogleTokenResponse { + + @JsonProperty("access_token") + private String accessToken; + + @JsonProperty("token_type") + private String tokenType; + + @JsonProperty("expires_in") + private int expiresIn; + + @JsonProperty("id_token") + private String idToken; +} diff --git a/src/main/java/com/swyp/app/domain/oauth/dto/google/GoogleUserResponse.java b/src/main/java/com/swyp/app/domain/oauth/dto/google/GoogleUserResponse.java new file mode 100644 index 0000000..b108d7e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/dto/google/GoogleUserResponse.java @@ -0,0 +1,15 @@ +package com.swyp.app.domain.oauth.dto.google; + +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; + +@Getter +public class GoogleUserResponse { + + private String id; + private String email; + private String name; + + @JsonProperty("verified_email") + private boolean verifiedEmail; +} diff --git a/src/main/java/com/swyp/app/domain/oauth/dto/kakao/KakaoTokenResponse.java b/src/main/java/com/swyp/app/domain/oauth/dto/kakao/KakaoTokenResponse.java new file mode 100644 index 0000000..e62b62d --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/dto/kakao/KakaoTokenResponse.java @@ -0,0 +1,20 @@ +package com.swyp.app.domain.oauth.dto.kakao; + +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; + +@Getter +public class KakaoTokenResponse { + + @JsonProperty("access_token") + private String accessToken; + + @JsonProperty("token_type") + private String tokenType; + + @JsonProperty("refresh_token") + private String refreshToken; + + @JsonProperty("expires_in") + private int expiresIn; +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/oauth/dto/kakao/KakaoUserResponse.java b/src/main/java/com/swyp/app/domain/oauth/dto/kakao/KakaoUserResponse.java new file mode 100644 index 0000000..ac20447 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/dto/kakao/KakaoUserResponse.java @@ -0,0 +1,18 @@ +package com.swyp.app.domain.oauth.dto.kakao; + +import com.fasterxml.jackson.annotation.JsonProperty; +import lombok.Getter; + +@Getter +public class KakaoUserResponse { + + private Long id; + + @JsonProperty("kakao_account") + private KakaoAccount kakaoAccount; + + @Getter + public static class KakaoAccount { + private String email; + } +} diff --git a/src/main/java/com/swyp/app/domain/oauth/entity/AuthRefreshToken.java b/src/main/java/com/swyp/app/domain/oauth/entity/AuthRefreshToken.java new file mode 100644 index 0000000..970bf50 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/entity/AuthRefreshToken.java @@ -0,0 +1,47 @@ +package com.swyp.app.domain.oauth.entity; + +import com.swyp.app.domain.user.entity.User; +import jakarta.persistence.*; +import lombok.*; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +@Entity +@Table(name = "auth_refresh_tokens") +@Getter +@NoArgsConstructor(access = AccessLevel.PROTECTED) +@EntityListeners(AuditingEntityListener.class) +public class AuthRefreshToken { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id", nullable = false) + private User user; + + @Column(name = "token_hash", nullable = false) + private String tokenHash; + + @Column(name = "expires_at", nullable = false) + private LocalDateTime expiresAt; + + @CreatedDate + @Column(name = "created_at", updatable = false) + private LocalDateTime createdAt; + + @Builder + public AuthRefreshToken(User user, String tokenHash, LocalDateTime expiresAt) { + this.user = user; + this.tokenHash = tokenHash; + this.expiresAt = expiresAt; + } + + // 만료 여부 확인 + public boolean isExpired() { + return LocalDateTime.now().isAfter(expiresAt); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/oauth/entity/UserSocialAccount.java b/src/main/java/com/swyp/app/domain/oauth/entity/UserSocialAccount.java new file mode 100644 index 0000000..6eb522e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/entity/UserSocialAccount.java @@ -0,0 +1,48 @@ +package com.swyp.app.domain.oauth.entity; + +import com.swyp.app.domain.user.entity.User; +import jakarta.persistence.*; +import lombok.*; +import org.springframework.data.annotation.CreatedDate; +import org.springframework.data.jpa.domain.support.AuditingEntityListener; + +import java.time.LocalDateTime; + +@Entity +@Table(name = "user_social_accounts") +@Getter +@NoArgsConstructor(access = AccessLevel.PROTECTED) +@EntityListeners(AuditingEntityListener.class) +public class UserSocialAccount { + + @Id + @GeneratedValue(strategy = GenerationType.IDENTITY) + private Long id; + + // 여러 소셜 계정을 연동할 수 있으므로 1 대 다 + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id", nullable = false) + private User user; + + @Column(nullable = false, length = 20) + private String provider; + + @Column(name = "provider_user_id", nullable = false) + private String providerUserId; + + @Column(name = "provider_email") + private String providerEmail; + + @CreatedDate + @Column(name = "created_at", updatable = false) + private LocalDateTime createdAt; + + @Builder + public UserSocialAccount(User user, String provider, + String providerUserId, String providerEmail) { + this.user = user; + this.provider = provider; + this.providerUserId = providerUserId; + this.providerEmail = providerEmail; + } +} diff --git a/src/main/java/com/swyp/app/domain/oauth/jwt/JwtFilter.java b/src/main/java/com/swyp/app/domain/oauth/jwt/JwtFilter.java new file mode 100644 index 0000000..39db18f --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/jwt/JwtFilter.java @@ -0,0 +1,77 @@ +package com.swyp.app.domain.oauth.jwt; + +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import jakarta.servlet.FilterChain; +import jakarta.servlet.ServletException; +import jakarta.servlet.http.HttpServletRequest; +import jakarta.servlet.http.HttpServletResponse; +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; +import org.springframework.security.core.context.SecurityContextHolder; +import org.springframework.util.StringUtils; +import org.springframework.web.filter.OncePerRequestFilter; + +import java.io.IOException; +import java.util.List; + +@Slf4j +@RequiredArgsConstructor +public class JwtFilter extends OncePerRequestFilter { + + private final JwtProvider jwtProvider; + + // 인증 제외 경로 + private static final List WHITELIST = List.of( + "/api/v1/auth/login", + "/api/v1/auth/refresh", + "/swagger-ui", + "/v3/api-docs" + ); + + @Override + protected void doFilterInternal(HttpServletRequest request, + HttpServletResponse response, + FilterChain filterChain) throws ServletException, IOException { + + String requestUri = request.getRequestURI(); + + // 화이트리스트 경로는 토큰 검증 스킵 + if (isWhitelisted(requestUri)) { + filterChain.doFilter(request, response); + return; + } + + // Authorization 헤더에서 토큰 추출 + String token = resolveToken(request); + + if (token == null) { + throw new CustomException(ErrorCode.AUTH_UNAUTHORIZED); + } + + if (!jwtProvider.validateToken(token)) { + throw new CustomException(ErrorCode.AUTH_ACCESS_TOKEN_EXPIRED); + } + + // 토큰에서 userId 추출 후 SecurityContext 에 저장 + Long userId = jwtProvider.getUserId(token); + UsernamePasswordAuthenticationToken authentication = + new UsernamePasswordAuthenticationToken(userId, null, List.of()); + SecurityContextHolder.getContext().setAuthentication(authentication); + + filterChain.doFilter(request, response); + } + + private String resolveToken(HttpServletRequest request) { + String bearerToken = request.getHeader("Authorization"); + if (StringUtils.hasText(bearerToken) && bearerToken.startsWith("Bearer ")) { + return bearerToken.substring(7); + } + return null; + } + + private boolean isWhitelisted(String uri) { + return WHITELIST.stream().anyMatch(uri::startsWith); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/oauth/jwt/JwtProvider.java b/src/main/java/com/swyp/app/domain/oauth/jwt/JwtProvider.java new file mode 100644 index 0000000..401ba96 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/jwt/JwtProvider.java @@ -0,0 +1,75 @@ +package com.swyp.app.domain.oauth.jwt; + +import io.jsonwebtoken.Claims; +import io.jsonwebtoken.Jwts; +import io.jsonwebtoken.security.Keys; +import jakarta.annotation.PostConstruct; +import lombok.RequiredArgsConstructor; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.stereotype.Component; + +import javax.crypto.SecretKey; +import java.util.Base64; +import java.util.Date; +import java.util.UUID; + +@Component +@RequiredArgsConstructor +public class JwtProvider { + + @Value("${jwt.secret}") + private String secret; + + @Value("${jwt.access-token-expiration}") + private long accessTokenExpiration; + + @Value("${jwt.refresh-token-expiration}") + private long refreshTokenExpiration; + + private SecretKey key; + + @PostConstruct + public void init() { + byte[] keyBytes = Base64.getDecoder().decode(secret); + this.key = Keys.hmacShaKeyFor(keyBytes); + } + + // access token 생성 + public String createAccessToken(Long userId) { + return Jwts.builder() + .subject(String.valueOf(userId)) + .issuedAt(new Date()) + .expiration(new Date(System.currentTimeMillis() + accessTokenExpiration)) + .signWith(key) + .compact(); + } + + // refresh token 생성 + public String createRefreshToken() { + return UUID.randomUUID().toString(); + } + + // token 에서 userId 추출 + public Long getUserId(String token) { + Claims claims = Jwts.parser() + .verifyWith(key) + .build() + .parseSignedClaims(token) + .getPayload(); + + return Long.parseLong(claims.getSubject()); + } + + // token 유효성 검증 + public boolean validateToken(String token) { + try { + Jwts.parser() + .verifyWith(key) + .build() + .parseSignedClaims(token); + return true; + } catch (Exception e) { + return false; + } + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/oauth/repository/AuthRefreshTokenRepository.java b/src/main/java/com/swyp/app/domain/oauth/repository/AuthRefreshTokenRepository.java new file mode 100644 index 0000000..c62d0fc --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/repository/AuthRefreshTokenRepository.java @@ -0,0 +1,14 @@ +package com.swyp.app.domain.oauth.repository; + +import com.swyp.app.domain.oauth.entity.AuthRefreshToken; +import com.swyp.app.domain.user.entity.User; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.Optional; + +public interface AuthRefreshTokenRepository extends JpaRepository { + + Optional findByTokenHash(String tokenHash); + + void deleteByUser(User user); +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/oauth/repository/UserSocialAccountRepository.java b/src/main/java/com/swyp/app/domain/oauth/repository/UserSocialAccountRepository.java new file mode 100644 index 0000000..2fc7081 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/repository/UserSocialAccountRepository.java @@ -0,0 +1,12 @@ +package com.swyp.app.domain.oauth.repository; + +import com.swyp.app.domain.oauth.entity.UserSocialAccount; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.Optional; + +public interface UserSocialAccountRepository extends JpaRepository { + + Optional findByProviderAndProviderUserId( + String provider, String providerUserId); +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/oauth/service/AuthService.java b/src/main/java/com/swyp/app/domain/oauth/service/AuthService.java new file mode 100644 index 0000000..4ed465b --- /dev/null +++ b/src/main/java/com/swyp/app/domain/oauth/service/AuthService.java @@ -0,0 +1,188 @@ +package com.swyp.app.domain.oauth.service; + +import com.swyp.app.domain.oauth.client.GoogleOAuthClient; +import com.swyp.app.domain.oauth.client.KakaoOAuthClient; +import com.swyp.app.domain.oauth.dto.LoginRequest; +import com.swyp.app.domain.oauth.dto.LoginResponse; +import com.swyp.app.domain.oauth.dto.OAuthUserInfo; +import com.swyp.app.domain.oauth.entity.AuthRefreshToken; +import com.swyp.app.domain.oauth.entity.UserSocialAccount; +import com.swyp.app.domain.oauth.jwt.JwtProvider; +import com.swyp.app.domain.oauth.repository.AuthRefreshTokenRepository; +import com.swyp.app.domain.oauth.repository.UserSocialAccountRepository; +import com.swyp.app.domain.user.entity.UserRole; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.entity.UserStatus; +import com.swyp.app.domain.user.repository.UserRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.nio.charset.StandardCharsets; +import java.security.MessageDigest; +import java.security.NoSuchAlgorithmException; +import java.time.LocalDateTime; +import java.util.Base64; +import java.util.UUID; + +@Service +@RequiredArgsConstructor +@Transactional +public class AuthService { + + private final KakaoOAuthClient kakaoOAuthClient; + private final GoogleOAuthClient googleOAuthClient; + private final UserRepository userRepository; + private final UserSocialAccountRepository socialAccountRepository; + private final AuthRefreshTokenRepository refreshTokenRepository; + private final JwtProvider jwtProvider; + + public LoginResponse login(String provider, LoginRequest request) { + + // 1. provider에 따라 소셜 사용자 정보 조회 + OAuthUserInfo oAuthUserInfo = getOAuthUserInfo(provider, + request.getAuthorizationCode(), request.getRedirectUri()); + + // 2. 기존 소셜 계정 조회 → 없으면 신규 유저 생성 + boolean isNewUser = false; + UserSocialAccount socialAccount = socialAccountRepository + .findByProviderAndProviderUserId(provider, oAuthUserInfo.getProviderUserId()) + .orElse(null); + + User user; + if (socialAccount == null) { + // 신규 유저 생성 + user = User.builder() + .userTag(generateUserTag()) + .role(UserRole.USER) + .status(UserStatus.PENDING) + .onboardingCompleted(false) + .build(); + userRepository.save(user); + + // 소셜 계정 연결 + socialAccount = UserSocialAccount.builder() + .user(user) + .provider(provider.toUpperCase()) + .providerUserId(oAuthUserInfo.getProviderUserId()) + .providerEmail(oAuthUserInfo.getEmail()) + .build(); + socialAccountRepository.save(socialAccount); + isNewUser = true; + } else { + user = socialAccount.getUser(); + } + + // 3. 제재 유저 체크 + if (user.getStatus() == UserStatus.BANNED) { + throw new CustomException(ErrorCode.USER_BANNED); + } + if (user.getStatus() == UserStatus.SUSPENDED) { + throw new CustomException(ErrorCode.USER_SUSPENDED); + } + + // 4. 기존 refresh token 삭제 후 새로 발급 + refreshTokenRepository.deleteByUser(user); + + String accessToken = jwtProvider.createAccessToken(user.getId()); + String refreshToken = jwtProvider.createRefreshToken(); + + // 5. refresh token 해시해서 저장 + refreshTokenRepository.save(AuthRefreshToken.builder() + .user(user) + .tokenHash(hashToken(refreshToken)) + .expiresAt(LocalDateTime.now().plusDays(30)) + .build()); + + return new LoginResponse( + accessToken, + refreshToken, + user.getUserTag(), + isNewUser, + user.getStatus().name() + ); + } + + public LoginResponse refresh(String refreshToken) { + + // 1. refresh token 해시해서 DB 조회 + String tokenHash = hashToken(refreshToken); + AuthRefreshToken authRefreshToken = refreshTokenRepository + .findByTokenHash(tokenHash) + .orElseThrow(() -> new CustomException(ErrorCode.AUTH_REFRESH_TOKEN_EXPIRED)); + + // 2. 만료 여부 확인 + if (authRefreshToken.isExpired()) { + refreshTokenRepository.delete(authRefreshToken); + throw new CustomException(ErrorCode.AUTH_REFRESH_TOKEN_EXPIRED); + } + + // 3. 기존 토큰 삭제 후 새 토큰 발급 + User user = authRefreshToken.getUser(); + refreshTokenRepository.delete(authRefreshToken); + + String newAccessToken = jwtProvider.createAccessToken(user.getId()); + String newRefreshToken = jwtProvider.createRefreshToken(); + + // 4. 새 refresh token 저장 + refreshTokenRepository.save(AuthRefreshToken.builder() + .user(user) + .tokenHash(hashToken(newRefreshToken)) + .expiresAt(LocalDateTime.now().plusDays(30)) + .build()); + + return new LoginResponse( + newAccessToken, + newRefreshToken, + user.getUserTag(), + false, + user.getStatus().name() + ); + } + + public void logout(Long userId) { + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + refreshTokenRepository.deleteByUser(user); + } + + public void withdraw(Long userId) { + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + refreshTokenRepository.deleteByUser(user); + user.delete(); + } + + // provider에 따라 소셜 사용자 정보 조회 + private OAuthUserInfo getOAuthUserInfo(String provider, String code, String redirectUri) { + return switch (provider.toUpperCase()) { + case "KAKAO" -> { + String token = kakaoOAuthClient.getAccessToken(code, redirectUri); + yield kakaoOAuthClient.getUserInfo(token); + } + case "GOOGLE" -> { + String token = googleOAuthClient.getAccessToken(code, redirectUri); + yield googleOAuthClient.getUserInfo(token); + } + default -> throw new CustomException(ErrorCode.INVALID_PROVIDER); + }; + } + + // user_tag 랜덤 생성 + private String generateUserTag() { + return "pique-" + UUID.randomUUID().toString().substring(0, 8); + } + + // refresh token 해시 + private String hashToken(String token) { + try { + MessageDigest digest = MessageDigest.getInstance("SHA-256"); + byte[] hash = digest.digest(token.getBytes(StandardCharsets.UTF_8)); + return Base64.getEncoder().encodeToString(hash); + } catch (NoSuchAlgorithmException e) { + throw new RuntimeException("토큰 해시 실패", e); + } + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/CommentListResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/CommentListResponse.java index fb7e85b..db8529a 100644 --- a/src/main/java/com/swyp/app/domain/perspective/dto/response/CommentListResponse.java +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/CommentListResponse.java @@ -17,5 +17,5 @@ public record Item( LocalDateTime createdAt ) {} - public record UserSummary(String userTag, String nickname, String characterUrl) {} + public record UserSummary(String userTag, String nickname, String characterType) {} } diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/CreateCommentResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/CreateCommentResponse.java index 3709f6b..278fcc6 100644 --- a/src/main/java/com/swyp/app/domain/perspective/dto/response/CreateCommentResponse.java +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/CreateCommentResponse.java @@ -9,5 +9,5 @@ public record CreateCommentResponse( String content, LocalDateTime createdAt ) { - public record UserSummary(String userTag, String nickname, String characterUrl) {} + public record UserSummary(String userTag, String nickname, String characterType) {} } diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveListResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveListResponse.java index a5e535a..7394f04 100644 --- a/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveListResponse.java +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveListResponse.java @@ -23,7 +23,7 @@ public record Item( public record UserSummary( String userTag, String nickname, - String characterUrl + String characterType ) {} public record OptionSummary( diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java index aafddd3..53b408f 100644 --- a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java @@ -48,7 +48,7 @@ public CreateCommentResponse createComment(UUID perspectiveId, Long userId, Crea UserQueryService.UserSummary user = userQueryService.findSummaryById(userId); return new CreateCommentResponse( comment.getId(), - new CreateCommentResponse.UserSummary(user.userTag(), user.nickname(), user.characterUrl()), + new CreateCommentResponse.UserSummary(user.userTag(), user.nickname(), user.characterType()), comment.getContent(), comment.getCreatedAt() ); @@ -70,7 +70,7 @@ public CommentListResponse getComments(UUID perspectiveId, Long userId, String c UserQueryService.UserSummary user = userQueryService.findSummaryById(c.getUserId()); return new CommentListResponse.Item( c.getId(), - new CommentListResponse.UserSummary(user.userTag(), user.nickname(), user.characterUrl()), + new CommentListResponse.UserSummary(user.userTag(), user.nickname(), user.characterType()), c.getContent(), c.getUserId().equals(userId), c.getCreatedAt() diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java index 867bd2e..1499085 100644 --- a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java @@ -87,7 +87,7 @@ public PerspectiveListResponse getPerspectives(UUID battleId, Long userId, Strin boolean isLiked = perspectiveLikeRepository.existsByPerspectiveAndUserId(p, userId); return new PerspectiveListResponse.Item( p.getId(), - new PerspectiveListResponse.UserSummary(user.userTag(), user.nickname(), user.characterUrl()), + new PerspectiveListResponse.UserSummary(user.userTag(), user.nickname(), user.characterType()), new PerspectiveListResponse.OptionSummary(option.getId(), option.getLabel().name(), option.getTitle()), p.getContent(), p.getLikeCount(), diff --git a/src/main/java/com/swyp/app/domain/user/entity/User.java b/src/main/java/com/swyp/app/domain/user/entity/User.java index 37c7ee8..ed1afe2 100644 --- a/src/main/java/com/swyp/app/domain/user/entity/User.java +++ b/src/main/java/com/swyp/app/domain/user/entity/User.java @@ -63,4 +63,9 @@ public void completeOnboarding() { this.status = UserStatus.ACTIVE; this.onboardingCompleted = true; } -} \ No newline at end of file + + public void delete() { + this.status = UserStatus.DELETED; + this.deletedAt = LocalDateTime.now(); + } +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/UserStatus.java b/src/main/java/com/swyp/app/domain/user/entity/UserStatus.java index 8b6aa8d..22715ed 100644 --- a/src/main/java/com/swyp/app/domain/user/entity/UserStatus.java +++ b/src/main/java/com/swyp/app/domain/user/entity/UserStatus.java @@ -1,8 +1,5 @@ package com.swyp.app.domain.user.entity; public enum UserStatus { - PENDING, - ACTIVE, - DELETED, - BANNED + PENDING, ACTIVE, SUSPENDED, BANNED, DELETED } diff --git a/src/main/java/com/swyp/app/domain/user/repository/UserProfileRepository.java b/src/main/java/com/swyp/app/domain/user/repository/UserProfileRepository.java index 510ef9b..e7c501d 100644 --- a/src/main/java/com/swyp/app/domain/user/repository/UserProfileRepository.java +++ b/src/main/java/com/swyp/app/domain/user/repository/UserProfileRepository.java @@ -1,7 +1,10 @@ package com.swyp.app.domain.user.repository; import com.swyp.app.domain.user.entity.UserProfile; +import java.util.Optional; import org.springframework.data.jpa.repository.JpaRepository; public interface UserProfileRepository extends JpaRepository { + + Optional findByUserId(Long userId); } diff --git a/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java b/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java index 7691467..81e09cb 100644 --- a/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java +++ b/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java @@ -1,9 +1,8 @@ package com.swyp.app.domain.user.repository; import com.swyp.app.domain.user.entity.User; -import org.springframework.data.jpa.repository.JpaRepository; - import java.util.Optional; +import org.springframework.data.jpa.repository.JpaRepository; public interface UserRepository extends JpaRepository { Optional findByUserTag(String userTag); diff --git a/src/main/java/com/swyp/app/domain/user/service/UserQueryService.java b/src/main/java/com/swyp/app/domain/user/service/UserQueryService.java index 7cfa195..8d0867b 100644 --- a/src/main/java/com/swyp/app/domain/user/service/UserQueryService.java +++ b/src/main/java/com/swyp/app/domain/user/service/UserQueryService.java @@ -4,5 +4,5 @@ public interface UserQueryService { UserSummary findSummaryById(Long userId); - record UserSummary(String userTag, String nickname, String characterUrl) {} + record UserSummary(String userTag, String nickname, String characterType) {} } diff --git a/src/main/java/com/swyp/app/domain/user/service/UserQueryServiceImpl.java b/src/main/java/com/swyp/app/domain/user/service/UserQueryServiceImpl.java index cf2aefe..e9f2a6b 100644 --- a/src/main/java/com/swyp/app/domain/user/service/UserQueryServiceImpl.java +++ b/src/main/java/com/swyp/app/domain/user/service/UserQueryServiceImpl.java @@ -1,6 +1,8 @@ package com.swyp.app.domain.user.service; import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.entity.UserProfile; +import com.swyp.app.domain.user.repository.UserProfileRepository; import com.swyp.app.domain.user.repository.UserRepository; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; @@ -12,11 +14,16 @@ public class UserQueryServiceImpl implements UserQueryService { private final UserRepository userRepository; + private final UserProfileRepository userProfileRepository; @Override public UserSummary findSummaryById(Long userId) { User user = userRepository.findById(userId) .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); - return new UserSummary(user.getUserTag(), user.getNickname(), user.getCharacterUrl()); + + UserProfile profile = userProfileRepository.findByUserId(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + + return new UserSummary(user.getUserTag(), profile.getNickname(), profile.getCharacterType().name()); } } diff --git a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java index 95e2aea..84c8a59 100644 --- a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java +++ b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java @@ -10,12 +10,23 @@ public enum ErrorCode { // Common INTERNAL_SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "COMMON_500", "서버 에러, 관리자에게 문의하세요."), - BAD_REQUEST (HttpStatus.BAD_REQUEST, "COMMON_400", "잘못된 요청입니다."), - AUTH_UNAUTHORIZED (HttpStatus.UNAUTHORIZED, "AUTH_401", "인증 정보가 필요합니다."), + BAD_REQUEST(HttpStatus.BAD_REQUEST, "COMMON_400", "잘못된 요청입니다."), + COMMON_INVALID_PARAMETER(HttpStatus.BAD_REQUEST, "COMMON_400", "요청 파라미터가 잘못되었습니다."), + + // Auth (Token) + AUTH_UNAUTHORIZED(HttpStatus.UNAUTHORIZED, "AUTH_401", "인증이 필요합니다."), + AUTH_INVALID_CODE(HttpStatus.UNAUTHORIZED, "AUTH_401_CODE", "유효하지 않은 소셜 인가 코드입니다."), + AUTH_ACCESS_TOKEN_EXPIRED(HttpStatus.UNAUTHORIZED, "AUTH_401_ACCESS", "Access Token이 만료되었습니다."), + AUTH_REFRESH_TOKEN_EXPIRED(HttpStatus.UNAUTHORIZED, "AUTH_401_REFRESH", "Refresh Token이 만료되었습니다. 다시 로그인이 필요합니다."), // User - USER_NOT_FOUND (HttpStatus.NOT_FOUND, "USER_404", "존재하지 않는 사용자입니다."), - ONBOARDING_ALREADY_COMPLETED(HttpStatus.CONFLICT, "USER_409", "이미 온보딩이 완료된 사용자입니다."), + USER_BANNED(HttpStatus.FORBIDDEN, "USER_403_BAN", "영구 제재된 사용자입니다."), + USER_SUSPENDED(HttpStatus.FORBIDDEN, "USER_403_SUS", "일정 기간 이용 정지된 사용자입니다."), + USER_NOT_FOUND(HttpStatus.NOT_FOUND, "USER_404", "존재하지 않는 사용자입니다."), + ONBOARDING_ALREADY_COMPLETED(HttpStatus.CONFLICT, "USER_409", "이미 온보딩이 완료된 사용자입니다."), + + // OAuth (Social Login) + INVALID_PROVIDER(HttpStatus.BAD_REQUEST, "AUTH_400_PROVIDER", "지원하지 않는 소셜 로그인 provider입니다."), // Battle BATTLE_NOT_FOUND (HttpStatus.NOT_FOUND, "BATTLE_404", "존재하지 않는 배틀입니다."), @@ -39,8 +50,8 @@ public enum ErrorCode { PERSPECTIVE_POST_VOTE_REQUIRED(HttpStatus.CONFLICT, "PERSPECTIVE_VOTE_409", "사후 투표가 완료되지 않았습니다."), // Comment - COMMENT_NOT_FOUND(HttpStatus.NOT_FOUND, "COMMENT_404", "존재하지 않는 댓글입니다."), - COMMENT_FORBIDDEN(HttpStatus.FORBIDDEN, "COMMENT_403", "본인 댓글만 수정/삭제할 수 있습니다."), + COMMENT_NOT_FOUND(HttpStatus.NOT_FOUND, "COMMENT_NOT_FOUND", "존재하지 않는 댓글입니다."), + COMMENT_FORBIDDEN(HttpStatus.FORBIDDEN, "COMMENT_FORBIDDEN", "본인 댓글만 수정/삭제할 수 있습니다."), // Like LIKE_ALREADY_EXISTS(HttpStatus.CONFLICT, "LIKE_409", "이미 좋아요를 누른 관점입니다."), diff --git a/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java b/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java index 135cae0..78c06dd 100644 --- a/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java +++ b/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java @@ -31,7 +31,7 @@ public ResponseEntity> handleCustomException(CustomException e }) public ResponseEntity> handleBadRequest(Exception e) { log.warn("Bad Request: {}", e.getMessage()); - ErrorCode code = ErrorCode.BAD_REQUEST; + ErrorCode code = ErrorCode.COMMON_INVALID_PARAMETER; return ResponseEntity .status(code.getHttpStatus()) .body(ApiResponse.onFailure(code.getHttpStatus().value(), code.getCode(), code.getMessage())); diff --git a/src/main/java/com/swyp/app/global/config/SecurityConfig.java b/src/main/java/com/swyp/app/global/config/SecurityConfig.java index 11163d2..51827dc 100644 --- a/src/main/java/com/swyp/app/global/config/SecurityConfig.java +++ b/src/main/java/com/swyp/app/global/config/SecurityConfig.java @@ -1,24 +1,45 @@ package com.swyp.app.global.config; +import com.swyp.app.domain.oauth.jwt.JwtFilter; +import com.swyp.app.domain.oauth.jwt.JwtProvider; +import io.swagger.v3.oas.models.Components; +import io.swagger.v3.oas.models.OpenAPI; +import io.swagger.v3.oas.models.security.SecurityRequirement; +import io.swagger.v3.oas.models.security.SecurityScheme; +import lombok.RequiredArgsConstructor; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.security.config.annotation.web.builders.HttpSecurity; import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity; import org.springframework.security.config.annotation.web.configurers.AbstractHttpConfigurer; +import org.springframework.security.config.http.SessionCreationPolicy; import org.springframework.security.web.SecurityFilterChain; +import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter; @Configuration @EnableWebSecurity +@RequiredArgsConstructor public class SecurityConfig { + private final JwtProvider jwtProvider; + @Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { http .csrf(AbstractHttpConfigurer::disable) + .sessionManagement(session -> + session.sessionCreationPolicy(SessionCreationPolicy.STATELESS)) .authorizeHttpRequests(auth -> auth - .requestMatchers("/swagger-ui/**", "/v3/api-docs/**").permitAll() - .anyRequest().permitAll() // 개발 초기 전체 허용 - ); + .requestMatchers( + "/api/v1/auth/**", + "/swagger-ui/**", + "/v3/api-docs/**" + ).permitAll() + .anyRequest().authenticated() + ) + .addFilterBefore(new JwtFilter(jwtProvider), + UsernamePasswordAuthenticationFilter.class); + return http.build(); } -} \ No newline at end of file +} diff --git a/src/main/java/com/swyp/app/global/config/SwaggerConfig.java b/src/main/java/com/swyp/app/global/config/SwaggerConfig.java index 7b63e1a..8c9aef7 100644 --- a/src/main/java/com/swyp/app/global/config/SwaggerConfig.java +++ b/src/main/java/com/swyp/app/global/config/SwaggerConfig.java @@ -1,7 +1,10 @@ package com.swyp.app.global.config; +import io.swagger.v3.oas.models.Components; import io.swagger.v3.oas.models.OpenAPI; import io.swagger.v3.oas.models.info.Info; +import io.swagger.v3.oas.models.security.SecurityRequirement; +import io.swagger.v3.oas.models.security.SecurityScheme; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @@ -10,10 +13,23 @@ public class SwaggerConfig { @Bean public OpenAPI openAPI() { + SecurityScheme securityScheme = new SecurityScheme() + .type(SecurityScheme.Type.HTTP) + .scheme("bearer") + .bearerFormat("JWT") + .in(SecurityScheme.In.HEADER) + .name("Authorization"); + + SecurityRequirement securityRequirement = + new SecurityRequirement().addList("bearerAuth"); + return new OpenAPI() .info(new Info() - .title("PIQUE API 명세서") - .description("PIQUE 서비스 API 명세서입니다.") - .version("v1.0.0")); + .title("PIQUE API 명세서") + .description("PIQUE 서비스 API 명세서입니다.") + .version("v1.0.0")) + .components(new Components() + .addSecuritySchemes("bearerAuth", securityScheme)) + .addSecurityItem(securityRequirement); } } \ No newline at end of file From 9d5cfe8a7afcbbe3062af2435e58afff1a4a3b02 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EC=A4=80=ED=98=81?= <127603139+HYH0804@users.noreply.github.com> Date: Wed, 18 Mar 2026 20:57:54 +0900 Subject: [PATCH 13/70] =?UTF-8?q?#25=20[Feat]=20=EA=B4=80=EC=A0=90=20?= =?UTF-8?q?=EC=83=9D=EC=84=B1,=20=EC=88=98=EC=A0=95=20=EC=8B=9C=20GPT=20?= =?UTF-8?q?=EA=B2=80=EC=88=98=20(#31)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ● ## #️⃣ 연관된 이슈 - #25 ## 📝 작업 내용 ### ✨ Feat | 내용 | 파일 | |------|------| | GPT 비동기 검수 서비스 구현 (PENDING → PUBLISHED / REJECTED / MODERATION_FAILED) | `GptModerationService.java` | | 관점 생성/수정 시 GPT 검수 비동기 호출 연동 | `PerspectiveService.java` | | 검수 재시도 API 구현 (`POST /perspectives/{id}/moderation/retry`) | `PerspectiveController.java`, `PerspectiveService.java` | | `MODERATION_FAILED` 상태 추가 | `PerspectiveStatus.java` | | `PERSPECTIVE_MODERATION_NOT_FAILED` 에러 코드 추가 | `ErrorCode.java` | | `@EnableAsync` 설정 추가 | `AsyncConfig.java` | | OpenAI API 설정 추가 (`api-key`, `url`, `model`) | `application.yml` | | 관점 상태 직접 변경 메서드 추가 | `Perspective.java` | ### ♻️ Refactor | 내용 | 파일 | |------|------| | | | ### 🐛 Fix | 내용 | 파일 | |------|------| | | | ## 📌 공유 사항 > 1. OpenAI API Key는 `.env` 에 `OPENAI_API_KEY`로 설정이 필요합니다. 노션 환경 설정 파일 확인 부탁드립니다! > 2. `@Async` + `@Transactional` 동시 사용 시 트랜잭션이 호출 쓰레드에서 커밋되어 비동기 쓰레드에서 DB 반영이 안 되는 문제로, `GptModerationService`에서 `@Transactional` 제거 후 `save()` 명시 호출 방식으로 처리했습니다. ## ✅ 체크리스트 - [x] Reviewer에 팀원들을 선택했나요? - [x] Assignees에 본인을 선택했나요? - [x] 컨벤션에 맞는 Type을 선택했나요? - [x] Development에 이슈를 연동했나요? - [x] Merge 하려는 브랜치가 올바르게 설정되어 있나요? - [x] 컨벤션을 지키고 있나요? - [x] 로컬에서 실행했을 때 에러가 발생하지 않나요? - [x] 팀원들에게 PR 링크 공유를 했나요? ## 📸 스크린샷 수정 시 아래와 같습니다. 올바른 관점 수정 image image image 욕설 관점 image image image 생성 시 아래와 같습니다. 올바른 관점 생성 image image image 욕설 관점 생성 image image image ## 💬 리뷰 요구사항 > 1. GPT API 호출 실패 시 최대 2회 재시도 후 `MODERATION_FAILED`로 전환되는 구조인데, 재시도 횟수나 대기 시간(현재 2초) 조정이 필요한지 의견 부탁드립니다. > 2. Prompt 의 경우 임시로 ` "당신은 콘텐츠 검수 AI입니다. 입력된 텍스트에 욕설, 혐오 발언, 폭력적 표현, 성적 표현, 특정인을 향한 공격적 내용이 포함되어 있는지 판단하세요. " + "문제가 있으면 'REJECT', 없으면 'APPROVE' 딱 한 단어만 응답하세요.";` 로 진행 중입니다. --------- Co-authored-by: Claude Sonnet 4.6 --- docs/api-specs/perspectives-api.md | 81 +++++++++++++ .../java/com/swyp/app/AppApplication.java | 2 + .../controller/PerspectiveController.java | 9 ++ .../perspective/entity/Perspective.java | 4 + .../perspective/entity/PerspectiveStatus.java | 2 +- .../service/GptModerationService.java | 108 ++++++++++++++++++ .../service/PerspectiveCommentService.java | 9 +- .../service/PerspectiveService.java | 22 +++- .../domain/user/dto/response/UserSummary.java | 3 + .../user/repository/UserRepository.java | 2 +- .../domain/user/service/UserQueryService.java | 8 -- .../user/service/UserQueryServiceImpl.java | 29 ----- .../app/domain/user/service/UserService.java | 8 ++ .../global/common/exception/ErrorCode.java | 11 +- .../swyp/app/global/config/AsyncConfig.java | 9 ++ src/main/resources/application.yml | 6 + 16 files changed, 262 insertions(+), 51 deletions(-) create mode 100644 src/main/java/com/swyp/app/domain/perspective/service/GptModerationService.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/UserSummary.java delete mode 100644 src/main/java/com/swyp/app/domain/user/service/UserQueryService.java delete mode 100644 src/main/java/com/swyp/app/domain/user/service/UserQueryServiceImpl.java create mode 100644 src/main/java/com/swyp/app/global/config/AsyncConfig.java diff --git a/docs/api-specs/perspectives-api.md b/docs/api-specs/perspectives-api.md index dd60b8f..5b445aa 100644 --- a/docs/api-specs/perspectives-api.md +++ b/docs/api-specs/perspectives-api.md @@ -6,6 +6,25 @@ - 관점 API 입니다. - 현재 Creator 뱃지 부분이 ERD 상에선 보이지 않는데 확인 필요 + +### 관점 상태(status) 흐름 + +| status | 설명 | +|--------|------| +| `PENDING` | 생성/수정 직후, GPT 검수 대기 중 | +| `PUBLISHED` | GPT 검수 통과, 목록에 노출됨 | +| `REJECTED` | GPT 검수 거절 (욕설/공격적 표현 포함) | +| `MODERATION_FAILED` | GPT API 호출 실패 (네트워크 오류 등), 재시도 가능 | + +``` +생성/수정 → PENDING → GPT 호출 성공 → APPROVED → PUBLISHED + → REJECT → REJECTED + → GPT 호출 실패 → 1회 재시도 + → 재시도 실패 → MODERATION_FAILED + ↓ (재시도 버튼) + PENDING → GPT 재호출 +``` + --- ## 관점 생성 API @@ -268,6 +287,67 @@ --- +## 관점 검수 재시도 API +### `POST /api/v1/perspectives/{perspective_id}/moderation/retry` + +- `MODERATION_FAILED` 상태의 관점에 대해 GPT 검수를 다시 요청합니다. +- 재시도 후 상태는 `PENDING`으로 변경되며, GPT 응답에 따라 `PUBLISHED` / `REJECTED` / `MODERATION_FAILED`로 전환됩니다. +- 재시도도 실패하면 다시 `MODERATION_FAILED`로 남습니다. + +#### 성공 응답 `200 OK` + +```json +{ + "statusCode": 200, + "data": null, + "error": null +} +``` + +#### 예외 응답 `404 - 관점 없음` + +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "PERSPECTIVE_NOT_FOUND", + "message": "존재하지 않는 관점입니다.", + "errors": [] + } +} +``` + +#### 예외 응답 `400 - 검수 실패 상태 아님` + +```json +{ + "statusCode": 400, + "data": null, + "error": { + "code": "PERSPECTIVE_400", + "message": "검수 실패 상태의 관점이 아닙니다.", + "errors": [] + } +} +``` + +#### 예외 응답 `403 - 본인 관점 아님` + +```json +{ + "statusCode": 403, + "data": null, + "error": { + "code": "PERSPECTIVE_403", + "message": "본인 관점만 수정/삭제할 수 있습니다.", + "errors": [] + } +} +``` + +--- + ## 공통 에러 코드 | Error Code | HTTP Status | 설명 | @@ -290,5 +370,6 @@ | `PERSPECTIVE_ALREADY_EXISTS` | `409` | 해당 배틀에 이미 관점 작성함 | | `PERSPECTIVE_FORBIDDEN` | `403` | 본인 관점 아님 | | `PERSPECTIVE_POST_VOTE_REQUIRED` | `409` | 사후 투표 미완료 | +| `PERSPECTIVE_400` | `400` | 검수 실패 상태의 관점이 아님 (재시도 불가) | --- \ No newline at end of file diff --git a/src/main/java/com/swyp/app/AppApplication.java b/src/main/java/com/swyp/app/AppApplication.java index 01062c0..ce684d0 100644 --- a/src/main/java/com/swyp/app/AppApplication.java +++ b/src/main/java/com/swyp/app/AppApplication.java @@ -3,9 +3,11 @@ import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.data.jpa.repository.config.EnableJpaAuditing; +import org.springframework.scheduling.annotation.EnableAsync; @EnableJpaAuditing @SpringBootApplication +@EnableAsync public class AppApplication { public static void main(String[] args) { SpringApplication.run(AppApplication.class, args); diff --git a/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java index e0b98bd..b8b64b3 100644 --- a/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java +++ b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java @@ -74,6 +74,15 @@ public ApiResponse deletePerspective(@PathVariable UUID perspectiveId) { return ApiResponse.onSuccess(null); } + @Operation(summary = "관점 검수 재시도", description = "검수 실패(MODERATION_FAILED) 상태의 관점에 대해 GPT 검수를 다시 요청합니다.") + @PostMapping("/perspectives/{perspectiveId}/moderation/retry") + public ApiResponse retryModeration(@PathVariable UUID perspectiveId) { + // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 + Long userId = 1L; + perspectiveService.retryModeration(perspectiveId, userId); + return ApiResponse.onSuccess(null); + } + @Operation(summary = "관점 수정", description = "본인이 작성한 관점의 내용을 수정합니다.") @PatchMapping("/perspectives/{perspectiveId}") public ApiResponse updatePerspective( diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java b/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java index b9cee98..61c5171 100644 --- a/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java +++ b/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java @@ -70,6 +70,10 @@ public void updateContent(String content) { this.content = content; } + public void updateStatus(PerspectiveStatus status) { + this.status = status; + } + public void publish() { this.status = PerspectiveStatus.PUBLISHED; } diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveStatus.java b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveStatus.java index 21f7ae5..3613c54 100644 --- a/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveStatus.java +++ b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveStatus.java @@ -1,5 +1,5 @@ package com.swyp.app.domain.perspective.entity; public enum PerspectiveStatus { - PENDING, PUBLISHED, REJECTED + PENDING, PUBLISHED, REJECTED, MODERATION_FAILED } diff --git a/src/main/java/com/swyp/app/domain/perspective/service/GptModerationService.java b/src/main/java/com/swyp/app/domain/perspective/service/GptModerationService.java new file mode 100644 index 0000000..f00ec51 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/service/GptModerationService.java @@ -0,0 +1,108 @@ +package com.swyp.app.domain.perspective.service; + +import com.swyp.app.domain.perspective.entity.PerspectiveStatus; +import com.swyp.app.domain.perspective.repository.PerspectiveRepository; +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.http.client.SimpleClientHttpRequestFactory; +import org.springframework.scheduling.annotation.Async; +import org.springframework.stereotype.Service; +import org.springframework.web.client.RestClient; + +import java.util.List; +import java.util.Map; +import java.util.UUID; + +@Slf4j +@Service +@RequiredArgsConstructor +public class GptModerationService { + + // 프롬프트는 추후 결정 + private static final String SYSTEM_PROMPT = + "당신은 콘텐츠 검수 AI입니다. 입력된 텍스트에 욕설, 혐오 발언, 폭력적 표현, 성적 표현, 특정인을 향한 공격적 내용이 포함되어 있는지 판단하세요. " + + "문제가 있으면 'REJECT', 없으면 'APPROVE' 딱 한 단어만 응답하세요."; + + private static final int MAX_ATTEMPTS = 2; + private static final int CONNECT_TIMEOUT_MS = 5000; + private static final int READ_TIMEOUT_MS = 10000; + private static final int WAIT_TIMEOUT_MS = 2000; + + private final PerspectiveRepository perspectiveRepository; + + @Value("${openai.api-key}") + private String apiKey; + + @Value("${openai.url}") + private String openaiUrl; + + @Value("${openai.model}") + private String model; + + @Async + public void moderate(UUID perspectiveId, String content) { + Exception lastException = null; + for (int attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) { + try { + String result = callGpt(content); + PerspectiveStatus newStatus = result.contains("APPROVE") + ? PerspectiveStatus.PUBLISHED + : PerspectiveStatus.REJECTED; + + perspectiveRepository.findById(perspectiveId).ifPresent(p -> { + if (p.getStatus() == PerspectiveStatus.PENDING) { + if (newStatus == PerspectiveStatus.PUBLISHED) p.publish(); + else p.reject(); + perspectiveRepository.save(p); + } + }); + return; + } catch (Exception e) { + lastException = e; + if (attempt < MAX_ATTEMPTS) { + try { Thread.sleep(WAIT_TIMEOUT_MS); } catch (InterruptedException ie) { + Thread.currentThread().interrupt(); + break; + } + } + } + } + log.error("GPT 검수 최종 실패 (재시도 소진). perspectiveId={}", perspectiveId, lastException); + perspectiveRepository.findById(perspectiveId).ifPresent(p -> { + if (p.getStatus() == PerspectiveStatus.PENDING) { + p.updateStatus(PerspectiveStatus.MODERATION_FAILED); + perspectiveRepository.save(p); + } + }); + } + + private String callGpt(String content) { + SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory(); + factory.setConnectTimeout(CONNECT_TIMEOUT_MS); + factory.setReadTimeout(READ_TIMEOUT_MS); + RestClient restClient = RestClient.builder().requestFactory(factory).build(); + + Map requestBody = Map.of( + "model", model, + "messages", List.of( + Map.of("role", "system", "content", SYSTEM_PROMPT), + Map.of("role", "user", "content", content) + ), + "max_tokens", 10 + ); + + Map response = restClient.post() + .uri(openaiUrl) + .header("Authorization", "Bearer " + apiKey) + .header("Content-Type", "application/json") + .body(requestBody) + .retrieve() + .body(Map.class); + + List choices = (List) response.get("choices"); + Map choice = (Map) choices.get(0); + Map message = (Map) choice.get("message"); + return ((String) message.get("content")).trim().toUpperCase(); + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java index 53b408f..ef8bf1c 100644 --- a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java @@ -9,7 +9,8 @@ import com.swyp.app.domain.perspective.entity.PerspectiveComment; import com.swyp.app.domain.perspective.repository.PerspectiveCommentRepository; import com.swyp.app.domain.perspective.repository.PerspectiveRepository; -import com.swyp.app.domain.user.service.UserQueryService; +import com.swyp.app.domain.user.dto.response.UserSummary; +import com.swyp.app.domain.user.service.UserService; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; import lombok.RequiredArgsConstructor; @@ -30,7 +31,7 @@ public class PerspectiveCommentService { private final PerspectiveRepository perspectiveRepository; private final PerspectiveCommentRepository commentRepository; - private final UserQueryService userQueryService; + private final UserService userQueryService; @Transactional public CreateCommentResponse createComment(UUID perspectiveId, Long userId, CreateCommentRequest request) { @@ -45,7 +46,7 @@ public CreateCommentResponse createComment(UUID perspectiveId, Long userId, Crea commentRepository.save(comment); perspective.incrementCommentCount(); - UserQueryService.UserSummary user = userQueryService.findSummaryById(userId); + UserSummary user = userQueryService.findSummaryById(userId); return new CreateCommentResponse( comment.getId(), new CreateCommentResponse.UserSummary(user.userTag(), user.nickname(), user.characterType()), @@ -67,7 +68,7 @@ public CommentListResponse getComments(UUID perspectiveId, Long userId, String c List items = comments.stream() .map(c -> { - UserQueryService.UserSummary user = userQueryService.findSummaryById(c.getUserId()); + UserSummary user = userQueryService.findSummaryById(c.getUserId()); return new CommentListResponse.Item( c.getId(), new CommentListResponse.UserSummary(user.userTag(), user.nickname(), user.characterType()), diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java index 1499085..ff9e106 100644 --- a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java @@ -13,7 +13,8 @@ import com.swyp.app.domain.perspective.entity.Perspective; import com.swyp.app.domain.perspective.repository.PerspectiveLikeRepository; import com.swyp.app.domain.perspective.repository.PerspectiveRepository; -import com.swyp.app.domain.user.service.UserQueryService; +import com.swyp.app.domain.user.dto.response.UserSummary; +import com.swyp.app.domain.user.service.UserService; import com.swyp.app.domain.vote.service.VoteService; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; @@ -37,7 +38,8 @@ public class PerspectiveService { private final PerspectiveLikeRepository perspectiveLikeRepository; private final BattleService battleService; private final VoteService voteService; - private final UserQueryService userQueryService; + private final UserService userQueryService; + private final GptModerationService gptModerationService; @Transactional public CreatePerspectiveResponse createPerspective(UUID battleId, Long userId, CreatePerspectiveRequest request) { @@ -57,6 +59,7 @@ public CreatePerspectiveResponse createPerspective(UUID battleId, Long userId, C .build(); Perspective saved = perspectiveRepository.save(perspective); + gptModerationService.moderate(saved.getId(), saved.getContent()); return new CreatePerspectiveResponse(saved.getId(), saved.getStatus(), saved.getCreatedAt()); } @@ -82,7 +85,7 @@ public PerspectiveListResponse getPerspectives(UUID battleId, Long userId, Strin List items = perspectives.stream() .map(p -> { - UserQueryService.UserSummary user = userQueryService.findSummaryById(p.getUserId()); + UserSummary user = userQueryService.findSummaryById(p.getUserId()); BattleOption option = battleService.findOptionById(p.getOptionId()); boolean isLiked = perspectiveLikeRepository.existsByPerspectiveAndUserId(p, userId); return new PerspectiveListResponse.Item( @@ -117,6 +120,8 @@ public UpdatePerspectiveResponse updatePerspective(UUID perspectiveId, Long user Perspective perspective = findPerspectiveById(perspectiveId); validateOwnership(perspective, userId); perspective.updateContent(request.content()); + perspective.updateStatus(PerspectiveStatus.PENDING); + gptModerationService.moderate(perspective.getId(), perspective.getContent()); return new UpdatePerspectiveResponse(perspective.getId(), perspective.getContent(), perspective.getUpdatedAt()); } @@ -133,6 +138,17 @@ public MyPerspectiveResponse getMyPendingPerspective(UUID battleId, Long userId) ); } + @Transactional + public void retryModeration(UUID perspectiveId, Long userId) { + Perspective perspective = findPerspectiveById(perspectiveId); + validateOwnership(perspective, userId); + if (perspective.getStatus() != PerspectiveStatus.MODERATION_FAILED) { + throw new CustomException(ErrorCode.PERSPECTIVE_MODERATION_NOT_FAILED); + } + perspective.updateStatus(PerspectiveStatus.PENDING); + gptModerationService.moderate(perspectiveId, perspective.getContent()); + } + private Perspective findPerspectiveById(UUID perspectiveId) { return perspectiveRepository.findById(perspectiveId) .orElseThrow(() -> new CustomException(ErrorCode.PERSPECTIVE_NOT_FOUND)); diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/UserSummary.java b/src/main/java/com/swyp/app/domain/user/dto/response/UserSummary.java new file mode 100644 index 0000000..c4f8b5a --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/UserSummary.java @@ -0,0 +1,3 @@ +package com.swyp.app.domain.user.dto.response; + +public record UserSummary(String userTag, String nickname, String characterType) {} diff --git a/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java b/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java index 81e09cb..be32520 100644 --- a/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java +++ b/src/main/java/com/swyp/app/domain/user/repository/UserRepository.java @@ -1,8 +1,8 @@ package com.swyp.app.domain.user.repository; import com.swyp.app.domain.user.entity.User; -import java.util.Optional; import org.springframework.data.jpa.repository.JpaRepository; +import java.util.Optional; public interface UserRepository extends JpaRepository { Optional findByUserTag(String userTag); diff --git a/src/main/java/com/swyp/app/domain/user/service/UserQueryService.java b/src/main/java/com/swyp/app/domain/user/service/UserQueryService.java deleted file mode 100644 index 8d0867b..0000000 --- a/src/main/java/com/swyp/app/domain/user/service/UserQueryService.java +++ /dev/null @@ -1,8 +0,0 @@ -package com.swyp.app.domain.user.service; - -public interface UserQueryService { - - UserSummary findSummaryById(Long userId); - - record UserSummary(String userTag, String nickname, String characterType) {} -} diff --git a/src/main/java/com/swyp/app/domain/user/service/UserQueryServiceImpl.java b/src/main/java/com/swyp/app/domain/user/service/UserQueryServiceImpl.java deleted file mode 100644 index e9f2a6b..0000000 --- a/src/main/java/com/swyp/app/domain/user/service/UserQueryServiceImpl.java +++ /dev/null @@ -1,29 +0,0 @@ -package com.swyp.app.domain.user.service; - -import com.swyp.app.domain.user.entity.User; -import com.swyp.app.domain.user.entity.UserProfile; -import com.swyp.app.domain.user.repository.UserProfileRepository; -import com.swyp.app.domain.user.repository.UserRepository; -import com.swyp.app.global.common.exception.CustomException; -import com.swyp.app.global.common.exception.ErrorCode; -import lombok.RequiredArgsConstructor; -import org.springframework.stereotype.Service; - -@Service -@RequiredArgsConstructor -public class UserQueryServiceImpl implements UserQueryService { - - private final UserRepository userRepository; - private final UserProfileRepository userProfileRepository; - - @Override - public UserSummary findSummaryById(Long userId) { - User user = userRepository.findById(userId) - .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); - - UserProfile profile = userProfileRepository.findByUserId(userId) - .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); - - return new UserSummary(user.getUserTag(), profile.getNickname(), profile.getCharacterType().name()); - } -} diff --git a/src/main/java/com/swyp/app/domain/user/service/UserService.java b/src/main/java/com/swyp/app/domain/user/service/UserService.java index 6332c48..b941155 100644 --- a/src/main/java/com/swyp/app/domain/user/service/UserService.java +++ b/src/main/java/com/swyp/app/domain/user/service/UserService.java @@ -13,6 +13,7 @@ import com.swyp.app.domain.user.dto.response.UpdateResultResponse; import com.swyp.app.domain.user.dto.response.UserProfileResponse; import com.swyp.app.domain.user.dto.response.UserSettingsResponse; +import com.swyp.app.domain.user.dto.response.UserSummary; import com.swyp.app.domain.user.entity.AgreementType; import com.swyp.app.domain.user.entity.User; import com.swyp.app.domain.user.entity.UserAgreement; @@ -231,6 +232,13 @@ public TendencyScoreHistoryResponse getMyTendencyScoreHistory(Long cursor, Integ return new TendencyScoreHistoryResponse(items, nextCursor); } + public UserSummary findSummaryById(Long userId) { + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + UserProfile profile = findUserProfile(user.getId()); + return new UserSummary(user.getUserTag(), profile.getNickname(), profile.getCharacterType().name()); + } + private User findUserByTag(String userTag) { return userRepository.findByUserTag(userTag) .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); diff --git a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java index 84c8a59..3872eef 100644 --- a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java +++ b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java @@ -44,10 +44,11 @@ public enum ErrorCode { TAG_LIMIT_EXCEEDED(HttpStatus.BAD_REQUEST, "TAG_400_LIMIT", "배틀당 태그 최대 개수를 초과했습니다."), // Perspective - PERSPECTIVE_NOT_FOUND (HttpStatus.NOT_FOUND, "PERSPECTIVE_404", "존재하지 않는 관점입니다."), - PERSPECTIVE_ALREADY_EXISTS (HttpStatus.CONFLICT, "PERSPECTIVE_409", "이미 관점을 작성한 배틀입니다."), - PERSPECTIVE_FORBIDDEN (HttpStatus.FORBIDDEN, "PERSPECTIVE_403", "본인 관점만 수정/삭제할 수 있습니다."), - PERSPECTIVE_POST_VOTE_REQUIRED(HttpStatus.CONFLICT, "PERSPECTIVE_VOTE_409", "사후 투표가 완료되지 않았습니다."), + PERSPECTIVE_NOT_FOUND (HttpStatus.NOT_FOUND, "PERSPECTIVE_404", "존재하지 않는 관점입니다."), + PERSPECTIVE_ALREADY_EXISTS (HttpStatus.CONFLICT, "PERSPECTIVE_409", "이미 관점을 작성한 배틀입니다."), + PERSPECTIVE_FORBIDDEN (HttpStatus.FORBIDDEN, "PERSPECTIVE_403", "본인 관점만 수정/삭제할 수 있습니다."), + PERSPECTIVE_POST_VOTE_REQUIRED (HttpStatus.CONFLICT, "PERSPECTIVE_VOTE_409", "사후 투표가 완료되지 않았습니다."), + PERSPECTIVE_MODERATION_NOT_FAILED (HttpStatus.BAD_REQUEST,"PERSPECTIVE_400", "검수 실패 상태의 관점이 아닙니다."), // Comment COMMENT_NOT_FOUND(HttpStatus.NOT_FOUND, "COMMENT_NOT_FOUND", "존재하지 않는 댓글입니다."), @@ -61,7 +62,7 @@ public enum ErrorCode { // Vote VOTE_NOT_FOUND (HttpStatus.NOT_FOUND, "VOTE_404", "투표 내역이 없습니다."), VOTE_ALREADY_SUBMITTED(HttpStatus.CONFLICT, "VOTE_409_SUB", "이미 투표가 완료되었습니다."), - INVALID_VOTE_STATUS (HttpStatus.BAD_REQUEST, "VOTE_400_INV", "사전 투표를 진행해야 하거나, 이미 사후 투표가 완료되었습니다."), // 💡 새로 추가됨! + INVALID_VOTE_STATUS (HttpStatus.BAD_REQUEST, "VOTE_400_INV", "사전 투표를 진행해야 하거나, 이미 사후 투표가 완료되었습니다."), PRE_VOTE_REQUIRED (HttpStatus.CONFLICT, "VOTE_409_PRE", "사전 투표가 필요합니다."), POST_VOTE_REQUIRED (HttpStatus.CONFLICT, "VOTE_409_PST", "사후 투표가 필요합니다."); diff --git a/src/main/java/com/swyp/app/global/config/AsyncConfig.java b/src/main/java/com/swyp/app/global/config/AsyncConfig.java new file mode 100644 index 0000000..439a397 --- /dev/null +++ b/src/main/java/com/swyp/app/global/config/AsyncConfig.java @@ -0,0 +1,9 @@ +package com.swyp.app.global.config; + +import org.springframework.context.annotation.Configuration; +import org.springframework.scheduling.annotation.EnableAsync; + +@Configuration +@EnableAsync +public class AsyncConfig { +} diff --git a/src/main/resources/application.yml b/src/main/resources/application.yml index 77987d2..9090cc8 100644 --- a/src/main/resources/application.yml +++ b/src/main/resources/application.yml @@ -14,6 +14,12 @@ spring: format_sql: true dialect: org.hibernate.dialect.PostgreSQLDialect +openai: + api-key: ${OPENAI_API_KEY} + url: https://api.openai.com/v1/chat/completions + model: gpt-4o-mini + + springdoc: default-consumes-media-type: application/json default-produces-media-type: application/json From 352509032db3edab90eb03e0692fa50626b2b99b Mon Sep 17 00:00:00 2001 From: JOO <107450745+jucheonsu@users.noreply.github.com> Date: Wed, 18 Mar 2026 21:25:58 +0900 Subject: [PATCH 14/70] =?UTF-8?q?#29=20[Feat]=20=EC=8B=9C=EB=82=98?= =?UTF-8?q?=EB=A6=AC=EC=98=A4=20=EB=8F=84=EB=A9=94=EC=9D=B8=20=EA=B8=B0?= =?UTF-8?q?=EB=8A=A5=20=EA=B5=AC=ED=98=84=20(#32)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- build.gradle | 67 +++--- docker-compose.yml | 10 +- .../java/com/swyp/app/AppApplication.java | 1 + .../controller/AdminBattleController.java | 7 +- .../battle/converter/BattleConverter.java | 6 +- .../response/AdminBattleDetailResponse.java | 1 - .../response/BattleUserDetailResponse.java | 2 +- .../battle/service/BattleServiceImpl.java | 9 +- .../controller/ScenarioController.java | 79 +++++++ .../scenario/converter/ScenarioConverter.java | 82 +++++++ .../scenario/dto/request/NodeRequest.java | 11 + .../scenario/dto/request/OptionRequest.java | 6 + .../dto/request/ScenarioCreateRequest.java | 10 + .../request/ScenarioStatusUpdateRequest.java | 7 + .../scenario/dto/request/ScriptRequest.java | 9 + .../dto/response/AdminDeleteResponse.java | 8 + .../dto/response/AdminScenarioResponse.java | 11 + .../scenario/dto/response/NodeResponse.java | 15 ++ .../scenario/dto/response/OptionResponse.java | 10 + .../scenario/dto/response/ScriptResponse.java | 14 ++ .../dto/response/UserScenarioResponse.java | 17 ++ .../scenario/entity/InteractiveOption.java | 41 ++++ .../app/domain/scenario/entity/Scenario.java | 76 +++++++ .../domain/scenario/entity/ScenarioNode.java | 76 +++++++ .../app/domain/scenario/entity/Script.java | 56 +++++ .../domain/scenario/enums/AudioPathType.java | 5 + .../domain/scenario/enums/CreatorType.java | 5 + .../domain/scenario/enums/ScenarioStatus.java | 5 + .../domain/scenario/enums/SpeakerType.java | 5 + .../repository/ScenarioRepository.java | 22 ++ .../scenario/service/AudioProcessor.java | 13 ++ .../scenario/service/FFmpegService.java | 94 ++++++++ .../service/GoogleCloudTtsServiceImpl.java | 72 ++++++ .../service/MockS3UploadServiceImpl.java | 22 ++ .../scenario/service/S3UploadService.java | 10 + .../service/ScenarioAudioPipelineService.java | 147 ++++++++++++ .../scenario/service/ScenarioService.java | 20 ++ .../scenario/service/ScenarioServiceImpl.java | 209 ++++++++++++++++++ .../domain/scenario/service/TtsService.java | 11 + .../app/domain/scenario/util/PathFinder.java | 44 ++++ .../vote/repository/VoteRepository.java | 4 + .../domain/vote/service/VoteServiceImpl.java | 3 + .../global/common/exception/ErrorCode.java | 5 + src/main/resources/application.yml | 42 ++++ 44 files changed, 1327 insertions(+), 42 deletions(-) create mode 100644 src/main/java/com/swyp/app/domain/scenario/controller/ScenarioController.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/converter/ScenarioConverter.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/dto/request/NodeRequest.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/dto/request/OptionRequest.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/dto/request/ScenarioCreateRequest.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/dto/request/ScenarioStatusUpdateRequest.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/dto/request/ScriptRequest.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/dto/response/AdminDeleteResponse.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/dto/response/AdminScenarioResponse.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/dto/response/NodeResponse.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/dto/response/OptionResponse.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/dto/response/ScriptResponse.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/dto/response/UserScenarioResponse.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/entity/InteractiveOption.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/entity/Scenario.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/entity/ScenarioNode.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/entity/Script.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/enums/AudioPathType.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/enums/CreatorType.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/enums/ScenarioStatus.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/enums/SpeakerType.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/repository/ScenarioRepository.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/service/AudioProcessor.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/service/FFmpegService.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/service/GoogleCloudTtsServiceImpl.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/service/MockS3UploadServiceImpl.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/service/S3UploadService.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/service/ScenarioAudioPipelineService.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/service/ScenarioService.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/service/ScenarioServiceImpl.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/service/TtsService.java create mode 100644 src/main/java/com/swyp/app/domain/scenario/util/PathFinder.java diff --git a/build.gradle b/build.gradle index 6767d41..cabd1d2 100644 --- a/build.gradle +++ b/build.gradle @@ -1,7 +1,7 @@ plugins { - id 'java' - id 'org.springframework.boot' version '4.0.3' - id 'io.spring.dependency-management' version '1.1.7' + id 'java' + id 'org.springframework.boot' version '3.5.11' + id 'io.spring.dependency-management' version '1.1.7' } group = 'com.swyp' @@ -9,54 +9,67 @@ version = '0.0.1-SNAPSHOT' description = 'SWYP APP 4th' java { - toolchain { - languageVersion = JavaLanguageVersion.of(21) - } + toolchain { + languageVersion = JavaLanguageVersion.of(21) + } } configurations { - compileOnly { - extendsFrom annotationProcessor - } + compileOnly { + extendsFrom annotationProcessor + } } repositories { - mavenCentral() + mavenCentral() } dependencies { // Web - implementation 'org.springframework.boot:spring-boot-starter-webmvc' + implementation 'org.springframework.boot:spring-boot-starter-web' implementation 'org.springframework.boot:spring-boot-starter-validation' + // JPA - implementation 'org.springframework.boot:spring-boot-starter-data-jpa' + implementation 'org.springframework.boot:spring-boot-starter-data-jpa' + // Security implementation 'org.springframework.boot:spring-boot-starter-security' + // JWT implementation 'io.jsonwebtoken:jjwt-api:0.12.6' runtimeOnly 'io.jsonwebtoken:jjwt-impl:0.12.6' runtimeOnly 'io.jsonwebtoken:jjwt-jackson:0.12.6' + // HTTP Client (소셜 API 호출용) implementation 'org.springframework.boot:spring-boot-starter-webflux' - // Swagger - implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:3.0.1' - // Lombok + + // Swagger + implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.16' + + // Google Cloud TTS + implementation 'com.google.cloud:google-cloud-texttospeech:2.58.0' + + // AWS S3 + implementation 'io.awspring.cloud:spring-cloud-aws-starter-s3:3.3.0' + + // Lombok compileOnly 'org.projectlombok:lombok' annotationProcessor 'org.projectlombok:lombok' + // devTools - developmentOnly 'org.springframework.boot:spring-boot-devtools' - // PostgreSQL + developmentOnly 'org.springframework.boot:spring-boot-devtools' + + // DB runtimeOnly 'org.postgresql:postgresql' - // H2 (local 프로필용) - runtimeOnly 'com.h2database:h2' - // Test - testRuntimeOnly 'com.h2database:h2' - testImplementation 'org.springframework.boot:spring-boot-starter-data-jpa-test' - testImplementation 'org.springframework.boot:spring-boot-starter-security-test' - testImplementation 'org.springframework.boot:spring-boot-starter-webmvc-test' - testRuntimeOnly 'org.junit.platform:junit-platform-launcher' + runtimeOnly 'com.h2database:h2' + + // Test + testRuntimeOnly 'com.h2database:h2' + testImplementation 'org.springframework.boot:spring-boot-starter-test' // JPA, Web 테스트 기능 모두 포함 + testImplementation 'org.springframework.security:spring-security-test' // 시큐리티 전용 테스트 + testRuntimeOnly 'org.junit.platform:junit-platform-launcher' } tasks.named('test') { - useJUnitPlatform() -} + useJUnitPlatform() +} \ No newline at end of file diff --git a/docker-compose.yml b/docker-compose.yml index 0cfd926..f3a2073 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -1,3 +1,5 @@ +version: '3.8' + services: db: image: postgres:15 @@ -8,10 +10,12 @@ services: POSTGRES_USER: ${DB_USER} POSTGRES_PASSWORD: ${DB_PASSWORD} ports: - - "127.0.0.1:${DB_PORT:-5433}:5432" + - "${DB_PORT}:5433" volumes: - ./postgres_data:/var/lib/postgresql/data + networks: + - pique-network networks: - default: - name: pique-network \ No newline at end of file + pique-network: + driver: bridge \ No newline at end of file diff --git a/src/main/java/com/swyp/app/AppApplication.java b/src/main/java/com/swyp/app/AppApplication.java index ce684d0..b2d6e2a 100644 --- a/src/main/java/com/swyp/app/AppApplication.java +++ b/src/main/java/com/swyp/app/AppApplication.java @@ -5,6 +5,7 @@ import org.springframework.data.jpa.repository.config.EnableJpaAuditing; import org.springframework.scheduling.annotation.EnableAsync; +@EnableAsync @EnableJpaAuditing @SpringBootApplication @EnableAsync diff --git a/src/main/java/com/swyp/app/domain/battle/controller/AdminBattleController.java b/src/main/java/com/swyp/app/domain/battle/controller/AdminBattleController.java index 0c50ee6..3458532 100644 --- a/src/main/java/com/swyp/app/domain/battle/controller/AdminBattleController.java +++ b/src/main/java/com/swyp/app/domain/battle/controller/AdminBattleController.java @@ -29,11 +29,8 @@ public ApiResponse createBattle( @RequestBody @Valid AdminBattleCreateRequest request, @AuthenticationPrincipal Long adminUserId ) { - // TODO: 로그인 기능 구현 후 @AuthenticationPrincipal adminUserId로 변경 예정 - // 현재 인증 정보가 없어 null이 들어오므로 테스트용 가짜 ID(1L)를 사용함 - Long testAdminId = (adminUserId != null) ? adminUserId : 1L; - - return ApiResponse.onSuccess(battleService.createBattle(request, testAdminId)); + // 인증된 관리자 ID를 사용하여 배틀을 생성합니다. + return ApiResponse.onSuccess(battleService.createBattle(request, adminUserId)); } @Operation(summary = "배틀 수정 (변경 필드만 포함)") diff --git a/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java b/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java index a8262d8..b3158e6 100644 --- a/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java +++ b/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java @@ -103,10 +103,10 @@ private static List toOptionResponses(List o o.getId(), o.getLabel(), o.getTitle(), - o.getRepresentative(), - o.getImageUrl(), o.getStance(), - o.getQuote() + o.getRepresentative(), + o.getQuote(), + o.getImageUrl() )).toList(); } diff --git a/src/main/java/com/swyp/app/domain/battle/dto/response/AdminBattleDetailResponse.java b/src/main/java/com/swyp/app/domain/battle/dto/response/AdminBattleDetailResponse.java index 28766df..d1848b6 100644 --- a/src/main/java/com/swyp/app/domain/battle/dto/response/AdminBattleDetailResponse.java +++ b/src/main/java/com/swyp/app/domain/battle/dto/response/AdminBattleDetailResponse.java @@ -28,5 +28,4 @@ public record AdminBattleDetailResponse( List options, // 대결 선택지 상세 정보 리스트 LocalDateTime createdAt, // 데이터 생성 일시 LocalDateTime updatedAt // 데이터 최종 수정 일시 -) {} ) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/dto/response/BattleUserDetailResponse.java b/src/main/java/com/swyp/app/domain/battle/dto/response/BattleUserDetailResponse.java index d7ea2a2..35b6c5b 100644 --- a/src/main/java/com/swyp/app/domain/battle/dto/response/BattleUserDetailResponse.java +++ b/src/main/java/com/swyp/app/domain/battle/dto/response/BattleUserDetailResponse.java @@ -11,7 +11,7 @@ public record BattleUserDetailResponse( BattleSummaryResponse battleInfo, // 기본적인 배틀 정보 (요약 DTO 재사용) String description, // 상세 본문 설명 String shareUrl, // 공유하기 버튼용 링크 - String userVoteStatus, // 현재 유저의 투표 상태 (NONE, A, B...) + String userVoteStatus, // 현재 유저의 투표 상태 List categoryTags, // UI 상단용 카테고리 태그만 분리 List philosopherTags, // UI 하단용 철학자 태그만 분리 List valueTags // 성향 분석용 가치관 태그만 분리 diff --git a/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java b/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java index 03da9ea..0844ae0 100644 --- a/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java +++ b/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java @@ -107,9 +107,14 @@ public BattleUserDetailResponse getBattleDetail(UUID battleId) { List allTags = getTagsByBattle(battle); List options = battleOptionRepository.findByBattle(battle); - // 임시 유저 1L의 투표 상태 확인 (추후 수정 필요) + // 🔥 수정됨: findByBattleIdAndUserId -> findByBattleAndUserId 로 변경하여 에러 해결 String voteStatus = voteRepository.findByBattleAndUserId(battle, 1L) - .map(v -> v.getPostVoteOption().getLabel().name()) + .map(v -> { + if (v.getPostVoteOption() != null) { + return v.getPostVoteOption().getLabel().name(); + } + return "NONE"; // 사후 투표를 아직 안 했을 경우를 대비한 안전 처리 + }) .orElse("NONE"); return BattleConverter.toUserDetailResponse(battle, allTags, options, battle.getTotalParticipantsCount(), voteStatus); diff --git a/src/main/java/com/swyp/app/domain/scenario/controller/ScenarioController.java b/src/main/java/com/swyp/app/domain/scenario/controller/ScenarioController.java new file mode 100644 index 0000000..9013598 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/controller/ScenarioController.java @@ -0,0 +1,79 @@ +package com.swyp.app.domain.scenario.controller; + +import com.swyp.app.domain.scenario.dto.request.ScenarioCreateRequest; +import com.swyp.app.domain.scenario.dto.request.ScenarioStatusUpdateRequest; +import com.swyp.app.domain.scenario.dto.response.AdminDeleteResponse; +import com.swyp.app.domain.scenario.dto.response.AdminScenarioResponse; +import com.swyp.app.domain.scenario.dto.response.UserScenarioResponse; +import com.swyp.app.domain.scenario.service.ScenarioService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import lombok.RequiredArgsConstructor; +import org.springframework.http.HttpStatus; +import org.springframework.security.access.prepost.PreAuthorize; +import org.springframework.web.bind.annotation.*; + +import java.util.Map; +import java.util.UUID; + +@Tag(name = "시나리오 (Scenario)", description = "시나리오 API") +@RestController +@RequestMapping("/api/v1") +@RequiredArgsConstructor +public class ScenarioController { + + private final ScenarioService scenarioService; + + @Operation(summary = "배틀 - 시나리오 조회") + @GetMapping("/battles/{battleId}/scenario") + public ApiResponse getBattleScenario( + @PathVariable UUID battleId, + @RequestAttribute(value = "userId", required = false) Long userId + ) { + return ApiResponse.onSuccess(scenarioService.getScenarioForUser(battleId, userId)); + } + + @Operation(summary = "시나리오 생성") + @PreAuthorize("hasRole('ADMIN')") + @PostMapping("/admin/scenarios") + @ResponseStatus(HttpStatus.CREATED) + public ApiResponse> createScenario( + @RequestBody ScenarioCreateRequest request) { + + UUID scenarioId = scenarioService.createScenario(request); + return ApiResponse.onSuccess(Map.of("scenarioId", scenarioId, "status", "DRAFT")); + } + + @Operation(summary = "시나리오 내용 수정") + @PreAuthorize("hasRole('ADMIN')") + @PutMapping("/admin/scenarios/{scenarioId}") + public ApiResponse updateScenarioContent( + @PathVariable UUID scenarioId, + @RequestBody ScenarioCreateRequest request) { + + scenarioService.updateScenarioContent(scenarioId, request); + return ApiResponse.onSuccess(null); + } + + @Operation(summary = "시나리오 상태 수정 (PUBLISHED 변경 시 자동 오디오 처리)") + @PreAuthorize("hasRole('ADMIN')") + @PatchMapping("/admin/scenarios/{scenarioId}") + public ApiResponse updateScenarioStatus( + @PathVariable UUID scenarioId, + @RequestBody ScenarioStatusUpdateRequest request) { + + scenarioService.updateScenarioStatus(scenarioId, request.status()); + return ApiResponse.onSuccess(scenarioService.updateScenarioStatus(scenarioId, request.status())); + } + + @Operation(summary = "시나리오 삭제 (Soft Delete)") + @PreAuthorize("hasRole('ADMIN')") + @DeleteMapping("/admin/scenarios/{scenarioId}") + public ApiResponse deleteScenario( + @PathVariable UUID scenarioId) { + + scenarioService.deleteScenario(scenarioId); + return ApiResponse.onSuccess(scenarioService.deleteScenario(scenarioId)); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/converter/ScenarioConverter.java b/src/main/java/com/swyp/app/domain/scenario/converter/ScenarioConverter.java new file mode 100644 index 0000000..094a9c1 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/converter/ScenarioConverter.java @@ -0,0 +1,82 @@ +package com.swyp.app.domain.scenario.converter; + +import com.swyp.app.domain.scenario.dto.response.NodeResponse; +import com.swyp.app.domain.scenario.dto.response.OptionResponse; +import com.swyp.app.domain.scenario.dto.response.ScriptResponse; +import com.swyp.app.domain.scenario.dto.response.UserScenarioResponse; +import com.swyp.app.domain.scenario.entity.InteractiveOption; +import com.swyp.app.domain.scenario.entity.Scenario; +import com.swyp.app.domain.scenario.entity.ScenarioNode; +import com.swyp.app.domain.scenario.entity.Script; +import com.swyp.app.domain.scenario.enums.AudioPathType; +import org.springframework.stereotype.Component; + +import java.util.List; +import java.util.UUID; +import java.util.stream.Collectors; + +@Component +public class ScenarioConverter { + + /** + * Scenario 엔티티를 프론트엔드 전달용 DTO로 변환합니다. + * @param scenario DB에서 조회된 시나리오 엔티티 + * @param recommendedPathKey 사전 투표 결과에 따른 추천 오디오 키 (COMMON, PATH_A, PATH_B) + */ + public UserScenarioResponse toUserResponse(Scenario scenario, AudioPathType recommendedPathKey) { + + // 1. 시작 노드 ID 찾기 + UUID startNodeId = scenario.getNodes().stream() + .filter(node -> Boolean.TRUE.equals(node.getIsStartNode())) + .map(ScenarioNode::getId) + .findFirst() + .orElse(null); + + // 2. 하위 노드 리스트 변환 + List nodeResponses = scenario.getNodes().stream() + .map(this::toNodeResponse) + .collect(Collectors.toList()); + + // 3. 최종 응답 빌드 + return UserScenarioResponse.builder() + .battleId(scenario.getBattle().getId()) + .isInteractive(scenario.getIsInteractive()) + .startNodeId(startNodeId) + .recommendedPathKey(recommendedPathKey) + .audios(scenario.getAudios()) + .nodes(nodeResponses) + .build(); + } + + private NodeResponse toNodeResponse(ScenarioNode node) { + return NodeResponse.builder() + .nodeId(node.getId()) + .nodeName(node.getNodeName()) + .audioDuration(node.getAudioDuration()) // 노드별 재생 시간 전달 + .autoNextNodeId(node.getAutoNextNodeId()) + .scripts(node.getScripts().stream() + .map(this::toScriptResponse) + .collect(Collectors.toList())) + .interactiveOptions(node.getOptions().stream() + .map(this::toOptionResponse) + .collect(Collectors.toList())) + .build(); + } + + private ScriptResponse toScriptResponse(Script script) { + return ScriptResponse.builder() + .scriptId(script.getId()) + .startTimeMs(script.getStartTimeMs()) // 자막 띄우는 핵심 싱크 타이밍 + .speakerType(script.getSpeakerType()) + .speakerName(script.getSpeakerName()) + .text(script.getText()) + .build(); + } + + private OptionResponse toOptionResponse(InteractiveOption option) { + return OptionResponse.builder() + .label(option.getLabel()) + .nextNodeId(option.getNextNodeId()) + .build(); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/dto/request/NodeRequest.java b/src/main/java/com/swyp/app/domain/scenario/dto/request/NodeRequest.java new file mode 100644 index 0000000..50c3b19 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/dto/request/NodeRequest.java @@ -0,0 +1,11 @@ +package com.swyp.app.domain.scenario.dto.request; + +import java.util.List; + +public record NodeRequest( + String nodeName, + Boolean isStartNode, + String autoNextNode, // 자동 넘김 노드 이름 추가 + List scripts, + List interactiveOptions +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/dto/request/OptionRequest.java b/src/main/java/com/swyp/app/domain/scenario/dto/request/OptionRequest.java new file mode 100644 index 0000000..2654d47 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/dto/request/OptionRequest.java @@ -0,0 +1,6 @@ +package com.swyp.app.domain.scenario.dto.request; + +public record OptionRequest( + String label, + String nextNodeName +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/dto/request/ScenarioCreateRequest.java b/src/main/java/com/swyp/app/domain/scenario/dto/request/ScenarioCreateRequest.java new file mode 100644 index 0000000..f0b116d --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/dto/request/ScenarioCreateRequest.java @@ -0,0 +1,10 @@ +package com.swyp.app.domain.scenario.dto.request; + +import java.util.List; +import java.util.UUID; + +public record ScenarioCreateRequest( + UUID battleId, + Boolean isInteractive, + List nodes +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/dto/request/ScenarioStatusUpdateRequest.java b/src/main/java/com/swyp/app/domain/scenario/dto/request/ScenarioStatusUpdateRequest.java new file mode 100644 index 0000000..6cc1e46 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/dto/request/ScenarioStatusUpdateRequest.java @@ -0,0 +1,7 @@ +package com.swyp.app.domain.scenario.dto.request; + +import com.swyp.app.domain.scenario.enums.ScenarioStatus; + +public record ScenarioStatusUpdateRequest( + ScenarioStatus status +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/dto/request/ScriptRequest.java b/src/main/java/com/swyp/app/domain/scenario/dto/request/ScriptRequest.java new file mode 100644 index 0000000..7fc1d63 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/dto/request/ScriptRequest.java @@ -0,0 +1,9 @@ +package com.swyp.app.domain.scenario.dto.request; + +import com.swyp.app.domain.scenario.enums.SpeakerType; + +public record ScriptRequest( + String speakerName, + SpeakerType speakerType, + String text +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/dto/response/AdminDeleteResponse.java b/src/main/java/com/swyp/app/domain/scenario/dto/response/AdminDeleteResponse.java new file mode 100644 index 0000000..71802d0 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/dto/response/AdminDeleteResponse.java @@ -0,0 +1,8 @@ +package com.swyp.app.domain.scenario.dto.response; + +import java.time.LocalDateTime; + +public record AdminDeleteResponse( + boolean success, + LocalDateTime deletedAt +) {} diff --git a/src/main/java/com/swyp/app/domain/scenario/dto/response/AdminScenarioResponse.java b/src/main/java/com/swyp/app/domain/scenario/dto/response/AdminScenarioResponse.java new file mode 100644 index 0000000..8b9e4dc --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/dto/response/AdminScenarioResponse.java @@ -0,0 +1,11 @@ +package com.swyp.app.domain.scenario.dto.response; + +import com.swyp.app.domain.scenario.enums.ScenarioStatus; + +import java.util.UUID; + +public record AdminScenarioResponse( + UUID scenarioId, + ScenarioStatus status, + String message +) {} diff --git a/src/main/java/com/swyp/app/domain/scenario/dto/response/NodeResponse.java b/src/main/java/com/swyp/app/domain/scenario/dto/response/NodeResponse.java new file mode 100644 index 0000000..4854aea --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/dto/response/NodeResponse.java @@ -0,0 +1,15 @@ +package com.swyp.app.domain.scenario.dto.response; + +import lombok.Builder; +import java.util.List; +import java.util.UUID; + +@Builder +public record NodeResponse( + UUID nodeId, + String nodeName, + Integer audioDuration, // 프론트엔드 재생 시간 표시에 활용 + UUID autoNextNodeId, + List scripts, + List interactiveOptions +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/dto/response/OptionResponse.java b/src/main/java/com/swyp/app/domain/scenario/dto/response/OptionResponse.java new file mode 100644 index 0000000..3380dd7 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/dto/response/OptionResponse.java @@ -0,0 +1,10 @@ +package com.swyp.app.domain.scenario.dto.response; + +import lombok.Builder; +import java.util.UUID; + +@Builder +public record OptionResponse( + String label, + UUID nextNodeId +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/dto/response/ScriptResponse.java b/src/main/java/com/swyp/app/domain/scenario/dto/response/ScriptResponse.java new file mode 100644 index 0000000..34794a3 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/dto/response/ScriptResponse.java @@ -0,0 +1,14 @@ +package com.swyp.app.domain.scenario.dto.response; + +import com.swyp.app.domain.scenario.enums.SpeakerType; +import lombok.Builder; +import java.util.UUID; + +@Builder +public record ScriptResponse( + UUID scriptId, + Integer startTimeMs, + SpeakerType speakerType, + String speakerName, + String text +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/dto/response/UserScenarioResponse.java b/src/main/java/com/swyp/app/domain/scenario/dto/response/UserScenarioResponse.java new file mode 100644 index 0000000..04fa6c6 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/dto/response/UserScenarioResponse.java @@ -0,0 +1,17 @@ +package com.swyp.app.domain.scenario.dto.response; + +import com.swyp.app.domain.scenario.enums.AudioPathType; +import lombok.Builder; +import java.util.List; +import java.util.Map; +import java.util.UUID; + +@Builder +public record UserScenarioResponse( + UUID battleId, + Boolean isInteractive, + UUID startNodeId, // 프론트가 텍스트 시작점을 잡을 수 있게 전달 + AudioPathType recommendedPathKey, // 사전 투표 기반 추천 오디오 키 (예: PATH_A) + Map audios, // 통합 오디오 파일 맵 + List nodes +) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/entity/InteractiveOption.java b/src/main/java/com/swyp/app/domain/scenario/entity/InteractiveOption.java new file mode 100644 index 0000000..7544f10 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/entity/InteractiveOption.java @@ -0,0 +1,41 @@ +package com.swyp.app.domain.scenario.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.*; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.util.UUID; + +@Entity +@Table(name = "scenario_options") +@Getter +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class InteractiveOption extends BaseEntity { + + @Id + @GeneratedValue(strategy = GenerationType.UUID) + @Column(name = "option_id", updatable = false, nullable = false) + private UUID id; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "node_id") + private ScenarioNode node; + + private String label; + + @Column(name = "next_node_id") + private UUID nextNodeId; + + @Builder + public InteractiveOption(String label, UUID nextNodeId) { + this.label = label; + this.nextNodeId = nextNodeId; + } + + public void assignNode(ScenarioNode node) { + this.node = node; + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/entity/Scenario.java b/src/main/java/com/swyp/app/domain/scenario/entity/Scenario.java new file mode 100644 index 0000000..b333c6e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/entity/Scenario.java @@ -0,0 +1,76 @@ +package com.swyp.app.domain.scenario.entity; + +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.scenario.enums.AudioPathType; +import com.swyp.app.domain.scenario.enums.CreatorType; +import com.swyp.app.domain.scenario.enums.ScenarioStatus; +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.*; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.util.*; + +@Entity +@Table(name = "scenarios") +@Getter +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class Scenario extends BaseEntity { + + @Id + @GeneratedValue(strategy = GenerationType.UUID) + @Column(name = "scenario_id", updatable = false, nullable = false) + private UUID id; + + @OneToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "battle_id", nullable = false) + private Battle battle; + + @Column(name = "is_interactive", nullable = false) + private Boolean isInteractive; + + @Enumerated(EnumType.STRING) + @Column(nullable = false) + private ScenarioStatus status; + + @Enumerated(EnumType.STRING) + @Column(nullable = false) + private CreatorType creatorType; + + @ElementCollection + @CollectionTable(name = "scenario_audios", joinColumns = @JoinColumn(name = "scenario_id")) + @MapKeyEnumerated(EnumType.STRING) + @MapKeyColumn(name = "path_key") + @Column(name = "audio_url") + private Map audios = new EnumMap<>(AudioPathType.class); + + @OneToMany(mappedBy = "scenario", cascade = CascadeType.ALL, orphanRemoval = true) + private List nodes = new ArrayList<>(); + + @Builder + public Scenario(Battle battle, Boolean isInteractive, ScenarioStatus status, CreatorType creatorType) { + this.battle = battle; + this.isInteractive = isInteractive; + this.status = status; + this.creatorType = creatorType; + } + + public void updateStatus(ScenarioStatus status) { + this.status = status; + } + + public void addAudioUrl(AudioPathType type, String url) { + this.audios.put(type, url); + } + + public void addNode(ScenarioNode node) { + this.nodes.add(node); + node.assignScenario(this); + } + + public void clearNodes() { + this.nodes.clear(); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/entity/ScenarioNode.java b/src/main/java/com/swyp/app/domain/scenario/entity/ScenarioNode.java new file mode 100644 index 0000000..dde90de --- /dev/null +++ b/src/main/java/com/swyp/app/domain/scenario/entity/ScenarioNode.java @@ -0,0 +1,76 @@ +package com.swyp.app.domain.scenario.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.*; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.util.ArrayList; +import java.util.List; +import java.util.UUID; + +@Entity +@Table(name = "scenario_nodes") +@Getter +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class ScenarioNode extends BaseEntity { + + @Id + @GeneratedValue(strategy = GenerationType.UUID) + @Column(name = "node_id", updatable = false, nullable = false) + private UUID id; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "scenario_id") + private Scenario scenario; + + @Column(name = "node_name") + private String nodeName; + + @Column(name = "is_start_node") + private Boolean isStartNode; + + @Column(name = "audio_duration") + private Integer audioDuration; + + @Column(name = "auto_next_node_id") + private UUID autoNextNodeId; + + @OneToMany(mappedBy = "node", cascade = CascadeType.ALL, orphanRemoval = true) + private List + + + + + + + +
+
+

당신의 생각을

+

Pické

+
+ +
+ + + + + + 카카오로 로그인 + + + + + + + + + + Google로 로그인 + +
+
+ + + + \ No newline at end of file diff --git a/src/main/resources/templates/admin/components/form-battle.html b/src/main/resources/templates/admin/components/form-battle.html new file mode 100644 index 0000000..ac67691 --- /dev/null +++ b/src/main/resources/templates/admin/components/form-battle.html @@ -0,0 +1,174 @@ +
+ +
+
+

1 기본 정보

+ BASIC INFO +
+ +
+
+ + +
+ +
+ +
+ +
+
+ +
+ + +
+ +
+ + +
+ +
+ + +
+
+
+ +
+
+

2 대결 설정

+ CHARACTERS +
+ +
+ + +
+

등장인물 A

+ + + + + + + +
+ +
+
+ +
+

등장인물 B

+ + + + + + + +
+ +
+
+
+
+ +
+
+

3 대본 설정

+ SCRIPT BUILDER +
+ +
+
+
+

🎬 오프닝

+ + +
+ +
+
+ +
+ + +
+ + + +
+
+
+

🎬 클로징

+ + +
+ +
+
+
+
\ No newline at end of file diff --git a/src/main/resources/templates/admin/components/form-quiz.html b/src/main/resources/templates/admin/components/form-quiz.html new file mode 100644 index 0000000..4123494 --- /dev/null +++ b/src/main/resources/templates/admin/components/form-quiz.html @@ -0,0 +1,87 @@ +
+
+
+

1 퀴즈 등록

+ QUIZ +
+ +
+
+ + +
+ +
+ + +
+ +
+ + +
+ +
+ + +
+ +
+ + +
+ +
+ + +
+ +
+ +
+ +
+
+ + O 정답 + +
+
+ + +
+
+ + +
+
+
+ +
+ + X 오답 + +
+
+ + +
+
+ + +
+
+
+
+
+
+
+
\ No newline at end of file diff --git a/src/main/resources/templates/admin/components/form-vote.html b/src/main/resources/templates/admin/components/form-vote.html new file mode 100644 index 0000000..0a074c7 --- /dev/null +++ b/src/main/resources/templates/admin/components/form-vote.html @@ -0,0 +1,54 @@ +
+
+
+

1 투표 등록

+ VOTE +
+ +
+
+ + +
+ +
+ + +
+ +
+ +
+ +
+ + +
+ + +
+
+ 1 + +
+
+ 2 + +
+
+ 3 + +
+
+ 4 + +
+
+
+
+
+
\ No newline at end of file diff --git a/src/main/resources/templates/admin/fragments/basic-info.html b/src/main/resources/templates/admin/fragments/basic-info.html new file mode 100644 index 0000000..88e2691 --- /dev/null +++ b/src/main/resources/templates/admin/fragments/basic-info.html @@ -0,0 +1,12 @@ +
+
+

1 기본정보

+ BASIC INFO +
+
+
+ + +
+
+
\ No newline at end of file diff --git a/src/main/resources/templates/admin/fragments/header.html b/src/main/resources/templates/admin/fragments/header.html new file mode 100644 index 0000000..ec99dbe --- /dev/null +++ b/src/main/resources/templates/admin/fragments/header.html @@ -0,0 +1,8 @@ +
+
+ Pické + Admin +
+ +
ADMIN
+
\ No newline at end of file diff --git a/src/main/resources/templates/admin/fragments/preview.html b/src/main/resources/templates/admin/fragments/preview.html new file mode 100644 index 0000000..00fa2d6 --- /dev/null +++ b/src/main/resources/templates/admin/fragments/preview.html @@ -0,0 +1,200 @@ +
+ +
+ 실시간 미리보기 + BRANCH MODE +
+ +
+
+ +
+ 9:41 +
+ + + +
+
+ +
+ +
+
+
+ +
+
+ + +
+ +
+
+

제목을 입력해주세요

+

콘텐츠에 대한 배경 설명 또는 힌트가 이곳에 표시됩니다.

+ +
+
+
+

A 입장 요약

+

A 이름

+
+
VS
+
+
+

B 입장 요약

+

B 이름

+
+
+ + +
+
+
+ + +
+ + + + + +
+
+
\ No newline at end of file diff --git a/src/main/resources/templates/admin/picke-create.html b/src/main/resources/templates/admin/picke-create.html new file mode 100644 index 0000000..d51be09 --- /dev/null +++ b/src/main/resources/templates/admin/picke-create.html @@ -0,0 +1,132 @@ + + + + + + Pické Admin - 콘텐츠 등록 + + + + + + + +
+ +
+ +
+
+ +
+ + + +
+ +
+
+
+ + + + + +
+
+ +
+
+
+ +
+ +
+ + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/src/main/resources/templates/admin/picke-list.html b/src/main/resources/templates/admin/picke-list.html new file mode 100644 index 0000000..f0cf176 --- /dev/null +++ b/src/main/resources/templates/admin/picke-list.html @@ -0,0 +1,252 @@ + + + + + + Pické Admin - 콘텐츠 관리 + + + + + + + +
+ +
+
+
+

콘텐츠 관리

+

배틀, 퀴즈, 투표 콘텐츠를 조회하고 관리합니다.

+
+ +
+ +
+ + + + +
+ +
+ + + + + + + + + + + + + + +
ID유형콘텐츠 제목상태등록일관리
+
+
+ 데이터를 불러오는 중... +
+
+
+
+
+ + + + \ No newline at end of file diff --git a/tsconfig.json b/tsconfig.json new file mode 100644 index 0000000..ef11cb9 --- /dev/null +++ b/tsconfig.json @@ -0,0 +1,14 @@ +{ + "compilerOptions": { + "target": "ES6", + "module": "ESNext", + "outDir": "./src/main/resources/static/js/admin", + "rootDir": "./src/main/resources/frontend/ts/admin", + "strict": true, + "esModuleInterop": true, + "forceConsistentCasingInFileNames": true + }, + "include": [ + "src/main/resources/frontend/ts/admin/**/*" + ] +} \ No newline at end of file From c9d8c717791dce80b2b9178fade4430bb7b74ab5 Mon Sep 17 00:00:00 2001 From: Dante0922 <101305519+Dante0922@users.noreply.github.com> Date: Sat, 28 Mar 2026 14:14:11 +0900 Subject: [PATCH 27/70] =?UTF-8?q?#36=20[Feat]=20user=20=EB=8F=84=EB=A9=94?= =?UTF-8?q?=EC=9D=B8=20=EB=A6=AC=ED=8C=A9=ED=86=A0=EB=A7=81=20=EB=B0=8F=20?= =?UTF-8?q?=EB=A7=88=EC=9D=B4=ED=8E=98=EC=9D=B4=EC=A7=80=20API=20=EA=B5=AC?= =?UTF-8?q?=ED=98=84=20(#39)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## #️⃣ 연관된 이슈 - #36 - #40 ## 📝 작업 내용 ### ✨ Feat | 내용 | 파일 | |------|------| | 마이페이지 API 추가 (`/me/mypage`, `/me/recap`, `/me/battle-records`, `/me/content-activities`, `/me/notification-settings`, `/me/notices`) | `MypageController.java`, `MypageService.java`, 관련 request/response DTO | | 리캡/배틀기록/활동 조회용 Query Service 추가 및 집계 로직 구현 | `VoteQueryService.java`, `PerspectiveQueryService.java`, `BattleQueryService.java` | | 크레딧 적립/누적 포인트 기반 티어 계산 기능 추가 | `CreditService.java`, `CreditHistory.java`, `CreditHistoryRepository.java`, `TierCode.java`, `CreditType.java` | | | | ### ♻️ Refactor | 내용 | 파일 | |------|------| | onboarding/bootstrap/public-profile 계열 불필요 엔드포인트 및 관련 코드 제거 | `UserController.java`, `AuthService.java`, 관련 DTO | | `UserSettings`, `UserTendencyScore`, `UserTendencyScoreHistory` 필드명을 현재 도메인 용어 기준으로 정리 | `UserSettings.java`, `UserTendencyScore.java`, `UserTendencyScoreHistory.java`, 관련 DTO | | user 내부 공지 구현을 notice 도메인으로 통합하고 중복 로직 제거 | `MypageService.java`, `NoticeService.java` 연동부 | | USER ERD, API 문서, DB 마이그레이션 스크립트 최신화 | `user.puml`, `user-ops.puml`, `user-api.md`, `mypage-api.md`, `20260326_alter_credit_histories_reference_id_not_null.sql` | | | | ### 🧪 Test | 내용 | 파일 | |------|------| | user/mypage/credit 단위 테스트 추가 및 핵심 시나리오 검증 | `UserServiceTest.java`, `MypageServiceTest.java`, `CreditServiceTest.java` | | home/notice 테스트 보강 및 테스트 메서드명 정리 | `HomeServiceTest.java`, `NoticeServiceTest.java` | | `./gradlew test --tests '*UserServiceTest' --tests '*MypageServiceTest' --tests '*CreditServiceTest' --tests '*HomeServiceTest' --tests '*NoticeServiceTest'` 통과 | 테스트 실행 결과 | | | | ## 📌 공유 사항 - 철학자 산출 로직은 아직 확정 전이라 `SOCRATES`, `PLATO`, `MARX`를 임시값으로 사용하고 있습니다. - 크레딧/티어 계산은 붙었지만 실제 적립 이벤트 연결은 아직 남아 있습니다. - 전체 `./gradlew test`는 `AppApplicationTests.contextLoads()`에서 로컬 환경 변수 placeholder 미설정으로 실패했습니다. - 운영 반영 전 스키마 변경 대상(`user_settings`, tendency score 컬럼명, `onboarding_completed`, `credit_histories.reference_id NOT NULL`)은 별도 마이그레이션 검증이 필요합니다. ## ✅ 체크리스트 - [x] Reviewer에 팀원들을 선택했나요? - [x] Assignees에 본인을 선택했나요? - [x] 컨벤션에 맞는 Type을 선택했나요? - [x] Development에 이슈를 연동했나요? - [x] Merge 하려는 브랜치가 올바르게 설정되어 있나요? - [x] 컨벤션을 지키고 있나요? - [ ] 로컬에서 실행했을 때 에러가 발생하지 않나요? - [x] 팀원들에게 PR 링크 공유를 했나요? ## 📸 스크린샷 > 없음 ## 💬 리뷰 요구사항 > 1. `MypageService`에서 타 도메인 조회를 `QueryService`로 분리한 현재 경계가 적절한지 확인 부탁드립니다. > --------- Co-authored-by: Claude Opus 4.6 --- docs/api-specs/mypage-api.md | 85 ---- docs/api-specs/user-api.md | 328 ++++++++----- ...credit_histories_reference_id_not_null.sql | 13 + docs/erd/user-ops.puml | 12 +- docs/erd/user.puml | 29 +- .../repository/BattleTagRepository.java | 6 + .../battle/service/BattleQueryService.java | 61 +++ .../domain/battle/service/BattleService.java | 2 +- .../battle/service/BattleServiceImpl.java | 2 +- .../domain/notice/entity/NoticePlacement.java | 6 + .../app/domain/notice/entity/NoticeType.java | 6 + .../app/domain/oauth/service/AuthService.java | 3 +- .../PerspectiveCommentRepository.java | 8 + .../repository/PerspectiveLikeRepository.java | 10 + .../service/PerspectiveQueryService.java | 39 ++ .../user/controller/MypageController.java | 96 ++++ .../user/controller/UserController.java | 91 ---- .../CreateOnboardingProfileRequest.java | 15 - .../UpdateNotificationSettingsRequest.java | 11 + .../request/UpdateTendencyScoreRequest.java | 20 - .../request/UpdateUserSettingsRequest.java | 18 - .../response/BattleRecordListResponse.java | 23 + .../user/dto/response/BootstrapResponse.java | 6 - .../response/ContentActivityListResponse.java | 35 ++ .../user/dto/response/MyProfileResponse.java | 2 - .../user/dto/response/MypageResponse.java | 34 ++ .../dto/response/NoticeDetailResponse.java | 15 + .../user/dto/response/NoticeListResponse.java | 21 + .../NotificationSettingsResponse.java | 11 + .../response/OnboardingProfileResponse.java | 16 - .../user/dto/response/RecapResponse.java | 44 ++ .../TendencyScoreHistoryItemResponse.java | 15 - .../TendencyScoreHistoryResponse.java | 9 - .../dto/response/TendencyScoreResponse.java | 16 - .../dto/response/UpdateResultResponse.java | 6 - .../dto/response/UserProfileResponse.java | 13 - .../dto/response/UserSettingsResponse.java | 9 - .../app/domain/user/entity/ActivityType.java | 6 + .../app/domain/user/entity/CreditHistory.java | 45 ++ .../domain/user/entity/PhilosopherType.java | 14 + .../swyp/app/domain/user/entity/TierCode.java | 30 ++ .../com/swyp/app/domain/user/entity/User.java | 11 +- .../app/domain/user/entity/UserSettings.java | 59 ++- .../domain/user/entity/UserTendencyScore.java | 47 +- .../user/entity/UserTendencyScoreHistory.java | 32 +- .../swyp/app/domain/user/entity/VoteSide.java | 6 + .../app/domain/user/enums/CreditType.java | 21 + .../repository/CreditHistoryRepository.java | 15 + .../domain/user/service/CreditService.java | 83 ++++ .../domain/user/service/MypageService.java | 303 ++++++++++++ .../app/domain/user/service/UserService.java | 251 +--------- .../vote/repository/VoteRepository.java | 36 +- .../domain/vote/service/VoteQueryService.java | 71 +++ .../global/common/exception/ErrorCode.java | 4 + .../app/global/config/SecurityConfig.java | 3 +- .../domain/home/service/HomeServiceTest.java | 46 +- .../notice/service/NoticeServiceTest.java | 7 +- .../user/service/CreditServiceTest.java | 105 ++++ .../user/service/MypageServiceTest.java | 450 ++++++++++++++++++ .../domain/user/service/UserServiceTest.java | 191 ++++++++ 60 files changed, 2185 insertions(+), 787 deletions(-) delete mode 100644 docs/api-specs/mypage-api.md create mode 100644 docs/db/20260326_alter_credit_histories_reference_id_not_null.sql create mode 100644 src/main/java/com/swyp/app/domain/battle/service/BattleQueryService.java create mode 100644 src/main/java/com/swyp/app/domain/notice/entity/NoticePlacement.java create mode 100644 src/main/java/com/swyp/app/domain/notice/entity/NoticeType.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/service/PerspectiveQueryService.java create mode 100644 src/main/java/com/swyp/app/domain/user/controller/MypageController.java delete mode 100644 src/main/java/com/swyp/app/domain/user/controller/UserController.java delete mode 100644 src/main/java/com/swyp/app/domain/user/dto/request/CreateOnboardingProfileRequest.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/request/UpdateNotificationSettingsRequest.java delete mode 100644 src/main/java/com/swyp/app/domain/user/dto/request/UpdateTendencyScoreRequest.java delete mode 100644 src/main/java/com/swyp/app/domain/user/dto/request/UpdateUserSettingsRequest.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/BattleRecordListResponse.java delete mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/BootstrapResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/ContentActivityListResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/MypageResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/NoticeDetailResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/NoticeListResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/NotificationSettingsResponse.java delete mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/OnboardingProfileResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/RecapResponse.java delete mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryItemResponse.java delete mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryResponse.java delete mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreResponse.java delete mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/UpdateResultResponse.java delete mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/UserProfileResponse.java delete mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/UserSettingsResponse.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/ActivityType.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/CreditHistory.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/PhilosopherType.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/TierCode.java create mode 100644 src/main/java/com/swyp/app/domain/user/entity/VoteSide.java create mode 100644 src/main/java/com/swyp/app/domain/user/enums/CreditType.java create mode 100644 src/main/java/com/swyp/app/domain/user/repository/CreditHistoryRepository.java create mode 100644 src/main/java/com/swyp/app/domain/user/service/CreditService.java create mode 100644 src/main/java/com/swyp/app/domain/user/service/MypageService.java create mode 100644 src/main/java/com/swyp/app/domain/vote/service/VoteQueryService.java create mode 100644 src/test/java/com/swyp/app/domain/user/service/CreditServiceTest.java create mode 100644 src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java create mode 100644 src/test/java/com/swyp/app/domain/user/service/UserServiceTest.java diff --git a/docs/api-specs/mypage-api.md b/docs/api-specs/mypage-api.md deleted file mode 100644 index e494560..0000000 --- a/docs/api-specs/mypage-api.md +++ /dev/null @@ -1,85 +0,0 @@ -# 마이페이지 API 명세서 - -## 1. 설계 메모 - -- 마이페이지는 원천 도메인이 아니라 사용자, 리캡, 활동 이력을 묶는 조회 API 성격이 강합니다. -- 상단 요약과 상세 목록은 분리해서 조회합니다. - ---- - -## 2. 마이페이지 API - -### 2.1 `GET /api/v1/me/mypage` - -마이페이지 상단에 필요한 집계 데이터 조회. - -응답: - -```json -{ - "profile": { - "user_id": "user_001", - "nickname": "생각하는올빼미", - "avatar_emoji": "🦉", - "manner_temperature": 36.5 - }, - "recap_summary": { - "personality_title": "원칙 중심형", - "summary": "감정보다 이성과 규칙을 더 중시하는 편이에요." - }, - "activity_counts": { - "comments": 12, - "posts": 3, - "liked_contents": 8, - "changed_mind_contents": 2 - } -} -``` - -### 2.2 `GET /api/v1/me/recap` - -상세 리캡 정보 조회. - -응답: - -```json -{ - "personality_title": "원칙 중심형", - "summary": "감정보다 이성과 규칙을 더 중시하는 편이에요.", - "scores": { - "score_1": 88, - "score_2": 74, - "score_3": 62, - "score_4": 45, - "score_5": 30, - "score_6": 15 - } -} -``` - -### 2.3 `GET /api/v1/me/activities` - -사용자 행동 이력 조회. - -쿼리 파라미터: - -- `type`: `COMMENT | POST | LIKED_CONTENT | CHANGED_MIND` -- `cursor`: 선택 -- `size`: 선택 - -응답: - -```json -{ - "items": [ - { - "activity_id": "act_001", - "type": "COMMENT", - "title": "안락사 도입, 찬성 vs 반대", - "description": "자기결정권은 가장 기본적인 인권이라고 생각해요.", - "created_at": "2026-03-08T12:00:00Z" - } - ], - "next_cursor": "cursor_002" -} -``` diff --git a/docs/api-specs/user-api.md b/docs/api-specs/user-api.md index ee5898d..bf50c05 100644 --- a/docs/api-specs/user-api.md +++ b/docs/api-specs/user-api.md @@ -1,50 +1,53 @@ -# 사용자 API 명세서 +# 내 정보 / 사용자 API 명세서 ## 1. 설계 메모 -- 사용자 API는 `snake_case` 필드명을 기준으로 합니다. +- 이 문서는 사용자 프로필 수정과 `/api/v1/me/**` 계열 API를 함께 다룹니다. +- 문서 전반은 `snake_case` 필드명을 기준으로 합니다. - 외부 응답에서는 내부 PK인 `user_id`를 노출하지 않고 `user_tag`를 사용합니다. - `nickname`은 중복 허용 프로필명입니다. - `user_tag`는 고유한 공개 식별자이며 저장 시 `@` 없이 관리합니다. - `user_tag`는 prefix 없이 생성되는 8자리 이하의 랜덤 문자열입니다. - 프로필 아바타는 자유 입력 이모지가 아니라 `character_type` 선택 방식으로 관리합니다. -- `character_type`은 소문자 `snake_case` 문자열 값으로 관리합니다. -- 프로필, 설정, 성향 점수는 모두 사용자 도메인 책임입니다. -- 온보딩 완료 시 필수 약관 동의 이력은 서버에서 함께 저장합니다. -- 성향 점수는 현재값을 갱신하면서 이력도 함께 적재합니다. +- `GET /api/v1/me/mypage`는 상단 요약 조회, `GET /api/v1/me/recap`은 상세 리캡 조회에 사용합니다. +- 프론트는 `philosopher_type` 값에 따라 사전 정의된 철학자 카드를 통째로 교체 렌더링합니다. +- 그래서 백엔드는 철학자 카드용 `title`, `description`, 해시태그 문구를 내려주지 않습니다. +- 포인트(`point`)는 새 개념으로 도입하되, 이번 버전에서는 현재 DB에서 계산 가능한 항목만 부분 반영합니다. +- 현재 반영 규칙은 `완료된 사후 투표 x 10P`, `입장 변경 x 20P 보너스`입니다. +- 철학자 산출 로직은 추후 확정 예정이며, 현재는 프론트 연동을 위해 임시로 `SOCRATES`를 반환합니다. + +### 1.1 공통 프로필 응답 필드 + +| 필드 | 타입 | 설명 | +|------|------|------| +| `user_tag` | string | 외부 공개용 사용자 식별자 | +| `nickname` | string | 중복 허용 프로필명 | +| `character_type` | string | 캐릭터 enum 값 | +| `manner_temperature` | number | 사용자 매너 온도 | + +### 1.2 공통 enum 값 + +| 필드 | 가능한 값 | +|------|-----------| +| `philosopher_type` | `SOCRATES \| PLATO \| ARISTOTLE \| KANT \| NIETZSCHE \| MARX \| SARTRE \| CONFUCIUS \| LAOZI \| BUDDHA` | +| `character_type` | `OWL \| FOX \| WOLF \| LION \| PENGUIN \| BEAR \| RABBIT \| CAT` | +| `activity_type` | `COMMENT \| LIKE` | +| `vote_side` | `PRO \| CON` | --- -## 2. 첫 로그인 / 온보딩 API +## 2. 프로필 API -### 2.1 `GET /api/v1/onboarding/bootstrap` +### 2.1 `PATCH /api/v1/me/profile` -첫 로그인 화면 진입 시 필요한 초기 데이터 조회. -이모지는 8개 뿐이라 앱에서 관리하는 버전입니다. - -응답: - -```json -{ - "statusCode": 200, - "data": { - "random_nickname": "생각하는올빼미" - }, - "error": null -} -``` - -### 2.2 `POST /api/v1/onboarding/profile` - -첫 로그인 시 프로필 생성. -owl, wolf, lion 등은 추후 디자인에 따라 정의 +닉네임 및 캐릭터 수정. 요청: ```json { - "nickname": "생각하는올빼미", - "character_type": "owl" + "nickname": "생각하는펭귄", + "character_type": "PENGUIN" } ``` @@ -55,11 +58,9 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 "statusCode": 200, "data": { "user_tag": "a7k2m9q1", - "nickname": "생각하는올빼미", - "character_type": "owl", - "manner_temperature": 36.5, - "status": "ACTIVE", - "onboarding_completed": true + "nickname": "생각하는펭귄", + "character_type": "PENGUIN", + "updated_at": "2026-03-08T12:00:00Z" }, "error": null } @@ -67,11 +68,11 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 --- -## 3. 프로필 API +## 3. 마이페이지 조회 API -### 3.1 `GET /api/v1/users/{user_tag}` +### 3.1 `GET /api/v1/me/mypage` -공개 사용자 프로필 조회. +마이페이지 상단에 필요한 집계 데이터 조회. 응답: @@ -79,20 +80,28 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 { "statusCode": 200, "data": { - "user_tag": "a7k2m9q1", - "nickname": "생각하는올빼미", - "character_type": "owl", - "manner_temperature": 36.5 + "profile": { + "user_tag": "a7k2m9q1", + "nickname": "생각하는올빼미", + "character_type": "OWL", + "manner_temperature": 36.5 + }, + "philosopher": { + "philosopher_type": "SOCRATES" + }, + "tier": { + "tier_code": "WANDERER", + "tier_label": "방랑자", + "current_point": 40 + } }, "error": null } ``` ---- - -### 3.2 `GET /api/v1/me/profile` +### 3.2 `GET /api/v1/me/recap` -내 프로필 조회. +상세 리캡 정보 조회. 응답: @@ -100,30 +109,66 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 { "statusCode": 200, "data": { - "user_tag": "a7k2m9q1", - "nickname": "생각하는올빼미", - "character_type": "owl", - "manner_temperature": 36.5, - "updated_at": "2026-03-08T12:00:00Z" + "my_card": { + "philosopher_type": "SOCRATES" + }, + "best_match_card": { + "philosopher_type": "PLATO" + }, + "worst_match_card": { + "philosopher_type": "MARX" + }, + "scores": { + "principle": 88, + "reason": 74, + "individual": 62, + "change": 45, + "inner": 30, + "ideal": 15 + }, + "preference_report": { + "total_participation": 47, + "opinion_changes": 12, + "battle_win_rate": 68, + "favorite_topics": [ + { + "rank": 1, + "tag_name": "철학", + "participation_count": 20 + }, + { + "rank": 2, + "tag_name": "문학", + "participation_count": 13 + }, + { + "rank": 3, + "tag_name": "예술", + "participation_count": 8 + }, + { + "rank": 4, + "tag_name": "사회", + "participation_count": 5 + } + ] + } }, "error": null } ``` ---- +### 3.3 `GET /api/v1/me/battle-records` -### 3.3 `PATCH /api/v1/me/profile` - -닉네임 및 캐릭터 수정. +내 배틀 기록 조회. +찬성/반대 탭을 따로 나누지 않고 하나의 목록으로 반환합니다. +각 item의 `vote_side`가 실제 구분자입니다. -요청: +쿼리 파라미터: -```json -{ - "nickname": "생각하는펭귄", - "character_type": "penguin" -} -``` +- `offset`: 선택, 0-based 시작 위치 +- `size`: 선택 +- `vote_side`: 각 item의 구분자이며 가능한 값은 `PRO | CON` 응답: @@ -131,22 +176,34 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 { "statusCode": 200, "data": { - "user_tag": "a7k2m9q1", - "nickname": "생각하는펭귄", - "character_type": "penguin", - "updated_at": "2026-03-08T12:00:00Z" + "items": [ + { + "battle_id": "battle_001", + "record_id": "vote_001", + "vote_side": "PRO", + "title": "안락사 도입, 찬성 vs 반대", + "summary": "인간에게 품위 있는 죽음을 허용해야 할까?", + "created_at": "2026-03-07T18:30:00" + } + ], + "next_offset": 20, + "has_next": true }, "error": null } ``` ---- +### 3.4 `GET /api/v1/me/content-activities` -## 4. 설정 API +내 댓글/좋아요 기반 콘텐츠 활동 조회. +댓글/좋아요 탭을 따로 나누지 않고 하나의 목록으로 반환합니다. +각 item의 `activity_type`이 실제 구분자입니다. -### 4.1 `GET /api/v1/me/settings` +쿼리 파라미터: -현재 사용자 설정 조회. +- `offset`: 선택, 0-based 시작 위치 +- `size`: 선택 +- `activity_type`: 각 item의 구분자이며 가능한 값은 `COMMENT | LIKE` 응답: @@ -154,29 +211,34 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 { "statusCode": 200, "data": { - "push_enabled": false, - "email_enabled": false, - "debate_request_enabled": false, - "profile_public": false + "items": [ + { + "activity_id": "comment_001", + "activity_type": "COMMENT", + "perspective_id": "perspective_001", + "battle_id": "battle_001", + "battle_title": "안락사 도입, 찬성 vs 반대", + "author": { + "user_tag": "a7k2m9q1", + "nickname": "사색하는고양이", + "character_type": "CAT" + }, + "stance": "반대", + "content": "제도가 무서운 건, 사회적 압력이 선택을 의무로 바꿀 수 있다는 거예요.", + "like_count": 1340, + "created_at": "2026-03-08T12:00:00" + } + ], + "next_offset": 20, + "has_next": true }, "error": null } ``` ---- - -### 4.2 `PATCH /api/v1/me/settings` +### 3.5 `GET /api/v1/me/notification-settings` -사용자 설정 수정. - -요청: - -```json -{ - "push_enabled": false, - "debate_request_enabled": false -} -``` +마이페이지 알림 설정 조회. 응답: @@ -184,31 +246,27 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 { "statusCode": 200, "data": { - "updated": true + "new_battle_enabled": false, + "battle_result_enabled": true, + "comment_reply_enabled": true, + "new_comment_enabled": false, + "content_like_enabled": false, + "marketing_event_enabled": true }, "error": null } ``` ---- - -## 5. 성향 점수 API +### 3.6 `PATCH /api/v1/me/notification-settings` -### 5.1 `PUT /api/v1/me/tendency-scores` - -최신 성향 점수 수정 및 이력 저장. -!!! 기획 확정에 따라 필드명 및 규칙 변경될 예정 +마이페이지 알림 설정 부분 수정. 요청: ```json { - "score_1": 30, - "score_2": -20, - "score_3": 55, - "score_4": 10, - "score_5": -75, - "score_6": 42 + "battle_result_enabled": true, + "marketing_event_enabled": false } ``` @@ -218,30 +276,24 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 { "statusCode": 200, "data": { - "user_tag": "a7k2m9q1", - "score_1": 30, - "score_2": -20, - "score_3": 55, - "score_4": 10, - "score_5": -75, - "score_6": 42, - "updated_at": "2026-03-08T12:00:00Z", - "history_saved": true + "new_battle_enabled": false, + "battle_result_enabled": true, + "comment_reply_enabled": true, + "new_comment_enabled": false, + "content_like_enabled": false, + "marketing_event_enabled": false }, "error": null } ``` ---- +### 3.7 `GET /api/v1/me/notices` -### 5.2 `GET /api/v1/me/tendency-scores/history` - -성향 점수 변경 이력 조회. +공지/이벤트 목록 조회. 쿼리 파라미터: -- `cursor`: 선택 -- `size`: 선택 +- `type`: `NOTICE | EVENT` 응답: @@ -251,17 +303,35 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 "data": { "items": [ { - "history_id": 1, - "score_1": 30, - "score_2": -20, - "score_3": 55, - "score_4": 10, - "score_5": -75, - "score_6": 42, - "created_at": "2026-03-08T12:00:00Z" + "notice_id": "notice_001", + "type": "NOTICE", + "title": "3월 신규 딜레마 업데이트", + "body_preview": "매일 새로운 딜레마가 추가돼요.", + "is_pinned": true, + "published_at": "2026-03-01T00:00:00" } - ], - "next_cursor": null + ] + }, + "error": null +} +``` + +### 3.8 `GET /api/v1/me/notices/{noticeId}` + +공지/이벤트 상세 조회. + +응답: + +```json +{ + "statusCode": 200, + "data": { + "notice_id": "notice_001", + "type": "NOTICE", + "title": "3월 신규 딜레마 업데이트", + "body": "매일 새로운 딜레마가 추가돼요.", + "is_pinned": true, + "published_at": "2026-03-01T00:00:00" }, "error": null } @@ -269,21 +339,21 @@ owl, wolf, lion 등은 추후 디자인에 따라 정의 --- -## 6. 에러 코드 +## 4. 에러 코드 -### 6.1 공통 에러 코드 +### 4.1 공통 에러 코드 | Error Code | HTTP Status | 설명 | |------------|:-----------:|------| | `COMMON_INVALID_PARAMETER` | `400` | 요청 파라미터 오류 | | `AUTH_UNAUTHORIZED` | `401` | 인증 실패 | | `AUTH_ACCESS_TOKEN_EXPIRED` | `401` | Access Token 만료 | -| `AUTH_REFRESH_TOKEN_EXPIRED` | `401` | Refresh Token 만료 — 재로그인 필요 | +| `AUTH_REFRESH_TOKEN_EXPIRED` | `401` | Refresh Token 만료 - 재로그인 필요 | | `USER_BANNED` | `403` | 영구 제재된 사용자 | | `USER_SUSPENDED` | `403` | 일정 기간 이용 정지된 사용자 | | `INTERNAL_SERVER_ERROR` | `500` | 서버 오류 | -### 6.2 사용자 에러 코드 +### 4.2 사용자 에러 코드 | Error Code | HTTP Status | 설명 | |------------|:-----------:|------| diff --git a/docs/db/20260326_alter_credit_histories_reference_id_not_null.sql b/docs/db/20260326_alter_credit_histories_reference_id_not_null.sql new file mode 100644 index 0000000..2c90327 --- /dev/null +++ b/docs/db/20260326_alter_credit_histories_reference_id_not_null.sql @@ -0,0 +1,13 @@ +DO $$ +BEGIN + IF EXISTS ( + SELECT 1 + FROM credit_histories + WHERE reference_id IS NULL + ) THEN + RAISE EXCEPTION 'credit_histories.reference_id contains NULL values. Backfill the rows before applying NOT NULL.'; + END IF; +END $$; + +ALTER TABLE credit_histories + ALTER COLUMN reference_id SET NOT NULL; diff --git a/docs/erd/user-ops.puml b/docs/erd/user-ops.puml index 8cf8d1f..db748bc 100644 --- a/docs/erd/user-ops.puml +++ b/docs/erd/user-ops.puml @@ -7,7 +7,7 @@ entity "USERS\n서비스 사용자" as users { * id : BIGINT <> -- user_tag : VARCHAR(30) <> - status : ENUM('PENDING', 'ACTIVE', 'DELETED', 'BANNED') + status : ENUM('PENDING', 'ACTIVE', 'SUSPENDED', 'BANNED', 'DELETED') created_at : timestamp updated_at : timestamp } @@ -15,10 +15,12 @@ entity "USERS\n서비스 사용자" as users { entity "USER_SETTINGS\n사용자 설정" as user_settings { * user_id : BIGINT <> -- - push_enabled : boolean - email_enabled : boolean - debate_request_enabled : boolean - profile_public : boolean + new_battle_enabled : boolean + battle_result_enabled : boolean + comment_reply_enabled : boolean + new_comment_enabled : boolean + content_like_enabled : boolean + marketing_event_enabled : boolean updated_at : timestamp } diff --git a/docs/erd/user.puml b/docs/erd/user.puml index c057281..be8614f 100644 --- a/docs/erd/user.puml +++ b/docs/erd/user.puml @@ -7,9 +7,10 @@ entity "USERS\n서비스 사용자" as users { * id : BIGINT <> -- user_tag : VARCHAR(30) <> + nickname : VARCHAR(50) + character_url : TEXT role : ENUM('USER', 'ADMIN') - status : ENUM('PENDING', 'ACTIVE', 'DELETED', 'BANNED') - onboarding_completed : boolean + status : ENUM('PENDING', 'ACTIVE', 'SUSPENDED', 'BANNED', 'DELETED') created_at : timestamp updated_at : timestamp deleted_at : timestamp (nullable) @@ -27,12 +28,12 @@ entity "USER_PROFILES\n사용자 프로필" as user_profiles { entity "USER_TENDENCY_SCORES\n사용자 성향 점수 현재값" as user_tendency_scores { * user_id : BIGINT <> -- - score_1 : int - score_2 : int - score_3 : int - score_4 : int - score_5 : int - score_6 : int + principle : int + reason : int + individual : int + change : int + inner : int + ideal : int updated_at : timestamp } @@ -40,12 +41,12 @@ entity "USER_TENDENCY_SCORE_HISTORIES\n사용자 성향 점수 변경 이력" as * id : BIGINT <> -- user_id : BIGINT <> - score_1 : int - score_2 : int - score_3 : int - score_4 : int - score_5 : int - score_6 : int + principle : int + reason : int + individual : int + change : int + inner : int + ideal : int created_at : timestamp } diff --git a/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java b/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java index 6bc6e81..6a157fb 100644 --- a/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java +++ b/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java @@ -4,6 +4,8 @@ import com.swyp.app.domain.battle.entity.BattleTag; import com.swyp.app.domain.tag.entity.Tag; import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; import java.util.List; @@ -11,4 +13,8 @@ public interface BattleTagRepository extends JpaRepository { List findByBattle(Battle battle); void deleteByBattle(Battle battle); boolean existsByTag(Tag tag); + + // MypageService (recap): 여러 배틀의 태그를 한번에 조회 + @Query("SELECT bt FROM BattleTag bt JOIN FETCH bt.tag WHERE bt.battle.id IN :battleIds") + List findByBattleIdIn(@Param("battleIds") List battleIds); } \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/service/BattleQueryService.java b/src/main/java/com/swyp/app/domain/battle/service/BattleQueryService.java new file mode 100644 index 0000000..e324144 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/battle/service/BattleQueryService.java @@ -0,0 +1,61 @@ +package com.swyp.app.domain.battle.service; + +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.battle.entity.BattleTag; +import com.swyp.app.domain.battle.repository.BattleOptionRepository; +import com.swyp.app.domain.battle.repository.BattleRepository; +import com.swyp.app.domain.battle.repository.BattleTagRepository; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.List; +import java.util.Map; +import java.util.function.Function; +import java.util.stream.Collectors; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class BattleQueryService { + + private final BattleRepository battleRepository; + private final BattleOptionRepository battleOptionRepository; + private final BattleTagRepository battleTagRepository; + + public Map findBattlesByIds(List battleIds) { + return battleRepository.findAllById(battleIds).stream() + .collect(Collectors.toMap(Battle::getId, Function.identity())); + } + + public Map findOptionsByIds(List optionIds) { + return battleOptionRepository.findAllById(optionIds).stream() + .collect(Collectors.toMap(BattleOption::getId, Function.identity())); + } + + /** + * 주어진 배틀 ID 목록에 대해 태그별 빈도를 집계하여 상위 limit개를 반환한다. + * @return Map<태그명, 빈도수> (상위 limit개) + */ + public Map getTopTagsByBattleIds(List battleIds, int limit) { + if (battleIds.isEmpty()) return Map.of(); + + List battleTags = battleTagRepository.findByBattleIdIn(battleIds); + + return battleTags.stream() + .collect(Collectors.groupingBy( + bt -> bt.getTag().getName(), + Collectors.counting() + )) + .entrySet().stream() + .sorted(Map.Entry.comparingByValue().reversed()) + .limit(limit) + .collect(Collectors.toMap( + Map.Entry::getKey, + Map.Entry::getValue, + (a, b) -> a, + java.util.LinkedHashMap::new + )); + } +} diff --git a/src/main/java/com/swyp/app/domain/battle/service/BattleService.java b/src/main/java/com/swyp/app/domain/battle/service/BattleService.java index cd8430c..1348813 100644 --- a/src/main/java/com/swyp/app/domain/battle/service/BattleService.java +++ b/src/main/java/com/swyp/app/domain/battle/service/BattleService.java @@ -60,4 +60,4 @@ public interface BattleService { // 배틀 삭제 (DB에서 지우지 않고 소프트 딜리트/상태변경을 수행합니다) AdminBattleDeleteResponse deleteBattle(Long battleId); -} \ No newline at end of file +} diff --git a/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java b/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java index 1844de8..1bba412 100644 --- a/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java +++ b/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java @@ -307,4 +307,4 @@ public BattleOption findOptionByBattleIdAndLabel(Long battleId, BattleOptionLabe return battleOptionRepository.findByBattleAndLabel(b, label) .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_OPTION_NOT_FOUND)); } -} \ No newline at end of file +} diff --git a/src/main/java/com/swyp/app/domain/notice/entity/NoticePlacement.java b/src/main/java/com/swyp/app/domain/notice/entity/NoticePlacement.java new file mode 100644 index 0000000..180382e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/notice/entity/NoticePlacement.java @@ -0,0 +1,6 @@ +package com.swyp.app.domain.notice.entity; + +public enum NoticePlacement { + HOME_TOP, + NOTICE_BOARD +} diff --git a/src/main/java/com/swyp/app/domain/notice/entity/NoticeType.java b/src/main/java/com/swyp/app/domain/notice/entity/NoticeType.java new file mode 100644 index 0000000..be76097 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/notice/entity/NoticeType.java @@ -0,0 +1,6 @@ +package com.swyp.app.domain.notice.entity; + +public enum NoticeType { + ANNOUNCEMENT, + EVENT +} diff --git a/src/main/java/com/swyp/app/domain/oauth/service/AuthService.java b/src/main/java/com/swyp/app/domain/oauth/service/AuthService.java index e5a5f90..a5b5a33 100644 --- a/src/main/java/com/swyp/app/domain/oauth/service/AuthService.java +++ b/src/main/java/com/swyp/app/domain/oauth/service/AuthService.java @@ -60,8 +60,7 @@ public LoginResponse login(String provider, LoginRequest request) { user = User.builder() .userTag(generateUserTag()) .role(UserRole.USER) - .status(UserStatus.PENDING) - .onboardingCompleted(false) + .status(UserStatus.ACTIVE) .build(); userRepository.save(user); diff --git a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveCommentRepository.java b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveCommentRepository.java index 5822133..e28e877 100644 --- a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveCommentRepository.java +++ b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveCommentRepository.java @@ -4,6 +4,8 @@ import com.swyp.app.domain.perspective.entity.PerspectiveComment; import org.springframework.data.domain.Pageable; import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; import java.time.LocalDateTime; import java.util.List; @@ -13,4 +15,10 @@ public interface PerspectiveCommentRepository extends JpaRepository findByPerspectiveOrderByCreatedAtDesc(Perspective perspective, Pageable pageable); List findByPerspectiveAndCreatedAtBeforeOrderByCreatedAtDesc(Perspective perspective, LocalDateTime cursor, Pageable pageable); + + // MypageService: 사용자 댓글 활동 조회 (offset 페이지네이션) + @Query("SELECT c FROM PerspectiveComment c JOIN FETCH c.perspective WHERE c.userId = :userId ORDER BY c.createdAt DESC") + List findByUserIdOrderByCreatedAtDesc(@Param("userId") Long userId, Pageable pageable); + + long countByUserId(Long userId); } diff --git a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveLikeRepository.java b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveLikeRepository.java index 5153f83..267a6ba 100644 --- a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveLikeRepository.java +++ b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveLikeRepository.java @@ -2,8 +2,12 @@ import com.swyp.app.domain.perspective.entity.Perspective; import com.swyp.app.domain.perspective.entity.PerspectiveLike; +import org.springframework.data.domain.Pageable; import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; +import java.util.List; import java.util.Optional; public interface PerspectiveLikeRepository extends JpaRepository { @@ -13,4 +17,10 @@ public interface PerspectiveLikeRepository extends JpaRepository findByPerspectiveAndUserId(Perspective perspective, Long userId); long countByPerspective(Perspective perspective); + + // MypageService: 사용자 좋아요 활동 조회 (offset 페이지네이션) + @Query("SELECT l FROM PerspectiveLike l JOIN FETCH l.perspective WHERE l.userId = :userId ORDER BY l.createdAt DESC") + List findByUserIdOrderByCreatedAtDesc(@Param("userId") Long userId, Pageable pageable); + + long countByUserId(Long userId); } diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveQueryService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveQueryService.java new file mode 100644 index 0000000..bc6a9f2 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveQueryService.java @@ -0,0 +1,39 @@ +package com.swyp.app.domain.perspective.service; + +import com.swyp.app.domain.perspective.entity.PerspectiveComment; +import com.swyp.app.domain.perspective.entity.PerspectiveLike; +import com.swyp.app.domain.perspective.repository.PerspectiveCommentRepository; +import com.swyp.app.domain.perspective.repository.PerspectiveLikeRepository; +import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.PageRequest; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.List; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class PerspectiveQueryService { + + private final PerspectiveCommentRepository perspectiveCommentRepository; + private final PerspectiveLikeRepository perspectiveLikeRepository; + + public List findUserComments(Long userId, int offset, int size) { + PageRequest pageable = PageRequest.of(offset / size, size); + return perspectiveCommentRepository.findByUserIdOrderByCreatedAtDesc(userId, pageable); + } + + public long countUserComments(Long userId) { + return perspectiveCommentRepository.countByUserId(userId); + } + + public List findUserLikes(Long userId, int offset, int size) { + PageRequest pageable = PageRequest.of(offset / size, size); + return perspectiveLikeRepository.findByUserIdOrderByCreatedAtDesc(userId, pageable); + } + + public long countUserLikes(Long userId) { + return perspectiveLikeRepository.countByUserId(userId); + } +} diff --git a/src/main/java/com/swyp/app/domain/user/controller/MypageController.java b/src/main/java/com/swyp/app/domain/user/controller/MypageController.java new file mode 100644 index 0000000..84e03e4 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/controller/MypageController.java @@ -0,0 +1,96 @@ +package com.swyp.app.domain.user.controller; + +import com.swyp.app.domain.user.dto.request.UpdateNotificationSettingsRequest; +import com.swyp.app.domain.user.dto.request.UpdateUserProfileRequest; +import com.swyp.app.domain.user.dto.response.BattleRecordListResponse; +import com.swyp.app.domain.user.dto.response.ContentActivityListResponse; +import com.swyp.app.domain.user.dto.response.MypageResponse; +import com.swyp.app.domain.user.dto.response.MyProfileResponse; +import com.swyp.app.domain.user.dto.response.NoticeDetailResponse; +import com.swyp.app.domain.user.dto.response.NoticeListResponse; +import com.swyp.app.domain.user.dto.response.NotificationSettingsResponse; +import com.swyp.app.domain.user.dto.response.RecapResponse; +import com.swyp.app.domain.notice.enums.NoticeType; +import com.swyp.app.domain.user.entity.ActivityType; +import com.swyp.app.domain.user.entity.VoteSide; + +import com.swyp.app.domain.user.service.MypageService; +import com.swyp.app.domain.user.service.UserService; +import com.swyp.app.global.common.response.ApiResponse; +import jakarta.validation.Valid; +import lombok.RequiredArgsConstructor; +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.RequestBody; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +@RestController +@RequiredArgsConstructor +@RequestMapping("/api/v1/me") +public class MypageController { + + private final UserService userService; + private final MypageService mypageService; + + @PatchMapping("/profile") + public ApiResponse updateMyProfile( + @Valid @RequestBody UpdateUserProfileRequest request + ) { + return ApiResponse.onSuccess(userService.updateMyProfile(request)); + } + + @GetMapping("/mypage") + public ApiResponse getMypage() { + return ApiResponse.onSuccess(mypageService.getMypage()); + } + + @GetMapping("/recap") + public ApiResponse getRecap() { + return ApiResponse.onSuccess(mypageService.getRecap()); + } + + @GetMapping("/battle-records") + public ApiResponse getBattleRecords( + @RequestParam(required = false) Integer offset, + @RequestParam(required = false) Integer size, + @RequestParam(name = "vote_side", required = false) VoteSide voteSide + ) { + return ApiResponse.onSuccess(mypageService.getBattleRecords(offset, size, voteSide)); + } + + @GetMapping("/content-activities") + public ApiResponse getContentActivities( + @RequestParam(required = false) Integer offset, + @RequestParam(required = false) Integer size, + @RequestParam(name = "activity_type", required = false) ActivityType activityType + ) { + return ApiResponse.onSuccess(mypageService.getContentActivities(offset, size, activityType)); + } + + @GetMapping("/notification-settings") + public ApiResponse getNotificationSettings() { + return ApiResponse.onSuccess(mypageService.getNotificationSettings()); + } + + @PatchMapping("/notification-settings") + public ApiResponse updateNotificationSettings( + @RequestBody UpdateNotificationSettingsRequest request + ) { + return ApiResponse.onSuccess(mypageService.updateNotificationSettings(request)); + } + + @GetMapping("/notices") + public ApiResponse getNotices( + @RequestParam(required = false) NoticeType type + ) { + return ApiResponse.onSuccess(mypageService.getNotices(type)); + } + + @GetMapping("/notices/{noticeId}") + public ApiResponse getNoticeDetail(@PathVariable Long noticeId) { + return ApiResponse.onSuccess(mypageService.getNoticeDetail(noticeId)); + } +} diff --git a/src/main/java/com/swyp/app/domain/user/controller/UserController.java b/src/main/java/com/swyp/app/domain/user/controller/UserController.java deleted file mode 100644 index 15c1e4e..0000000 --- a/src/main/java/com/swyp/app/domain/user/controller/UserController.java +++ /dev/null @@ -1,91 +0,0 @@ -package com.swyp.app.domain.user.controller; - -import com.swyp.app.domain.user.dto.request.CreateOnboardingProfileRequest; -import com.swyp.app.domain.user.dto.request.UpdateTendencyScoreRequest; -import com.swyp.app.domain.user.dto.request.UpdateUserProfileRequest; -import com.swyp.app.domain.user.dto.request.UpdateUserSettingsRequest; -import com.swyp.app.domain.user.dto.response.BootstrapResponse; -import com.swyp.app.domain.user.dto.response.MyProfileResponse; -import com.swyp.app.domain.user.dto.response.OnboardingProfileResponse; -import com.swyp.app.domain.user.dto.response.TendencyScoreHistoryResponse; -import com.swyp.app.domain.user.dto.response.TendencyScoreResponse; -import com.swyp.app.domain.user.dto.response.UpdateResultResponse; -import com.swyp.app.domain.user.dto.response.UserProfileResponse; -import com.swyp.app.domain.user.dto.response.UserSettingsResponse; -import com.swyp.app.domain.user.service.UserService; -import com.swyp.app.global.common.response.ApiResponse; -import jakarta.validation.Valid; -import lombok.RequiredArgsConstructor; -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.PutMapping; -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; - -@RestController -@RequiredArgsConstructor -@RequestMapping("/api/v1") -public class UserController { - - private final UserService userService; - - @GetMapping("/onboarding/bootstrap") - public ApiResponse getBootstrap() { - return ApiResponse.onSuccess(userService.getBootstrap()); - } - - @PostMapping("/onboarding/profile") - public ApiResponse createOnboardingProfile( - @Valid @RequestBody CreateOnboardingProfileRequest request - ) { - return ApiResponse.onSuccess(userService.createOnboardingProfile(request)); - } - - @GetMapping("/users/{userTag}") - public ApiResponse getUserProfile(@PathVariable String userTag) { - return ApiResponse.onSuccess(userService.getUserProfile(userTag)); - } - - @GetMapping("/me/profile") - public ApiResponse getMyProfile() { - return ApiResponse.onSuccess(userService.getMyProfile()); - } - - @PatchMapping("/me/profile") - public ApiResponse updateMyProfile( - @Valid @RequestBody UpdateUserProfileRequest request - ) { - return ApiResponse.onSuccess(userService.updateMyProfile(request)); - } - - @GetMapping("/me/settings") - public ApiResponse getMySettings() { - return ApiResponse.onSuccess(userService.getMySettings()); - } - - @PatchMapping("/me/settings") - public ApiResponse updateMySettings( - @Valid @RequestBody UpdateUserSettingsRequest request - ) { - return ApiResponse.onSuccess(userService.updateMySettings(request)); - } - - @PutMapping("/me/tendency-scores") - public ApiResponse updateMyTendencyScores( - @Valid @RequestBody UpdateTendencyScoreRequest request - ) { - return ApiResponse.onSuccess(userService.updateMyTendencyScores(request)); - } - - @GetMapping("/me/tendency-scores/history") - public ApiResponse getMyTendencyScoreHistory( - @RequestParam(required = false) Long cursor, - @RequestParam(required = false) Integer size - ) { - return ApiResponse.onSuccess(userService.getMyTendencyScoreHistory(cursor, size)); - } -} diff --git a/src/main/java/com/swyp/app/domain/user/dto/request/CreateOnboardingProfileRequest.java b/src/main/java/com/swyp/app/domain/user/dto/request/CreateOnboardingProfileRequest.java deleted file mode 100644 index f00047d..0000000 --- a/src/main/java/com/swyp/app/domain/user/dto/request/CreateOnboardingProfileRequest.java +++ /dev/null @@ -1,15 +0,0 @@ -package com.swyp.app.domain.user.dto.request; - -import com.swyp.app.domain.user.entity.CharacterType; -import jakarta.validation.constraints.NotBlank; -import jakarta.validation.constraints.NotNull; -import jakarta.validation.constraints.Size; - -public record CreateOnboardingProfileRequest( - @NotBlank - @Size(min = 2, max = 20) - String nickname, - @NotNull - CharacterType characterType -) { -} diff --git a/src/main/java/com/swyp/app/domain/user/dto/request/UpdateNotificationSettingsRequest.java b/src/main/java/com/swyp/app/domain/user/dto/request/UpdateNotificationSettingsRequest.java new file mode 100644 index 0000000..c2ac052 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/request/UpdateNotificationSettingsRequest.java @@ -0,0 +1,11 @@ +package com.swyp.app.domain.user.dto.request; + +public record UpdateNotificationSettingsRequest( + Boolean newBattleEnabled, + Boolean battleResultEnabled, + Boolean commentReplyEnabled, + Boolean newCommentEnabled, + Boolean contentLikeEnabled, + Boolean marketingEventEnabled +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/request/UpdateTendencyScoreRequest.java b/src/main/java/com/swyp/app/domain/user/dto/request/UpdateTendencyScoreRequest.java deleted file mode 100644 index 2cde0bc..0000000 --- a/src/main/java/com/swyp/app/domain/user/dto/request/UpdateTendencyScoreRequest.java +++ /dev/null @@ -1,20 +0,0 @@ -package com.swyp.app.domain.user.dto.request; - -import jakarta.validation.constraints.Max; -import jakarta.validation.constraints.Min; - -public record UpdateTendencyScoreRequest( - @Min(-100) @Max(100) - int score1, - @Min(-100) @Max(100) - int score2, - @Min(-100) @Max(100) - int score3, - @Min(-100) @Max(100) - int score4, - @Min(-100) @Max(100) - int score5, - @Min(-100) @Max(100) - int score6 -) { -} diff --git a/src/main/java/com/swyp/app/domain/user/dto/request/UpdateUserSettingsRequest.java b/src/main/java/com/swyp/app/domain/user/dto/request/UpdateUserSettingsRequest.java deleted file mode 100644 index a0a067b..0000000 --- a/src/main/java/com/swyp/app/domain/user/dto/request/UpdateUserSettingsRequest.java +++ /dev/null @@ -1,18 +0,0 @@ -package com.swyp.app.domain.user.dto.request; - -import jakarta.validation.constraints.AssertTrue; - -public record UpdateUserSettingsRequest( - Boolean pushEnabled, - Boolean emailEnabled, - Boolean debateRequestEnabled, - Boolean profilePublic -) { - @AssertTrue(message = "적어도 하나 이상의 설정값이 필요합니다.") - public boolean hasAnySettingToUpdate() { - return pushEnabled != null - || emailEnabled != null - || debateRequestEnabled != null - || profilePublic != null; - } -} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/BattleRecordListResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/BattleRecordListResponse.java new file mode 100644 index 0000000..0436db5 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/BattleRecordListResponse.java @@ -0,0 +1,23 @@ +package com.swyp.app.domain.user.dto.response; + +import com.swyp.app.domain.user.entity.VoteSide; + +import java.time.LocalDateTime; +import java.util.List; + +public record BattleRecordListResponse( + List items, + Integer nextOffset, + boolean hasNext +) { + + public record BattleRecordItem( + String battleId, + String recordId, + VoteSide voteSide, + String title, + String summary, + LocalDateTime createdAt + ) { + } +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/BootstrapResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/BootstrapResponse.java deleted file mode 100644 index 60cfd4a..0000000 --- a/src/main/java/com/swyp/app/domain/user/dto/response/BootstrapResponse.java +++ /dev/null @@ -1,6 +0,0 @@ -package com.swyp.app.domain.user.dto.response; - -public record BootstrapResponse( - String randomNickname -) { -} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/ContentActivityListResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/ContentActivityListResponse.java new file mode 100644 index 0000000..586c6a0 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/ContentActivityListResponse.java @@ -0,0 +1,35 @@ +package com.swyp.app.domain.user.dto.response; + +import com.swyp.app.domain.user.entity.ActivityType; +import com.swyp.app.domain.user.entity.CharacterType; + +import java.time.LocalDateTime; +import java.util.List; + +public record ContentActivityListResponse( + List items, + Integer nextOffset, + boolean hasNext +) { + + public record ContentActivityItem( + String activityId, + ActivityType activityType, + String perspectiveId, + String battleId, + String battleTitle, + AuthorInfo author, + String stance, + String content, + int likeCount, + LocalDateTime createdAt + ) { + } + + public record AuthorInfo( + String userTag, + String nickname, + CharacterType characterType + ) { + } +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/MyProfileResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/MyProfileResponse.java index 1f7a357..9e55fff 100644 --- a/src/main/java/com/swyp/app/domain/user/dto/response/MyProfileResponse.java +++ b/src/main/java/com/swyp/app/domain/user/dto/response/MyProfileResponse.java @@ -2,14 +2,12 @@ import com.swyp.app.domain.user.entity.CharacterType; -import java.math.BigDecimal; import java.time.LocalDateTime; public record MyProfileResponse( String userTag, String nickname, CharacterType characterType, - BigDecimal mannerTemperature, LocalDateTime updatedAt ) { } diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/MypageResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/MypageResponse.java new file mode 100644 index 0000000..9804cf3 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/MypageResponse.java @@ -0,0 +1,34 @@ +package com.swyp.app.domain.user.dto.response; + +import com.swyp.app.domain.user.entity.CharacterType; +import com.swyp.app.domain.user.entity.PhilosopherType; +import com.swyp.app.domain.user.entity.TierCode; + +import java.math.BigDecimal; + +public record MypageResponse( + ProfileInfo profile, + PhilosopherInfo philosopher, + TierInfo tier +) { + + public record ProfileInfo( + String userTag, + String nickname, + CharacterType characterType, + BigDecimal mannerTemperature + ) { + } + + public record PhilosopherInfo( + PhilosopherType philosopherType + ) { + } + + public record TierInfo( + TierCode tierCode, + String tierLabel, + int currentPoint + ) { + } +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/NoticeDetailResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/NoticeDetailResponse.java new file mode 100644 index 0000000..845c368 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/NoticeDetailResponse.java @@ -0,0 +1,15 @@ +package com.swyp.app.domain.user.dto.response; + +import com.swyp.app.domain.notice.enums.NoticeType; + +import java.time.LocalDateTime; + +public record NoticeDetailResponse( + Long noticeId, + NoticeType type, + String title, + String body, + boolean isPinned, + LocalDateTime publishedAt +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/NoticeListResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/NoticeListResponse.java new file mode 100644 index 0000000..4b0b1da --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/NoticeListResponse.java @@ -0,0 +1,21 @@ +package com.swyp.app.domain.user.dto.response; + +import com.swyp.app.domain.notice.enums.NoticeType; + +import java.time.LocalDateTime; +import java.util.List; + +public record NoticeListResponse( + List items +) { + + public record NoticeItem( + Long noticeId, + NoticeType type, + String title, + String bodyPreview, + boolean isPinned, + LocalDateTime publishedAt + ) { + } +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/NotificationSettingsResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/NotificationSettingsResponse.java new file mode 100644 index 0000000..cc2a5fb --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/NotificationSettingsResponse.java @@ -0,0 +1,11 @@ +package com.swyp.app.domain.user.dto.response; + +public record NotificationSettingsResponse( + boolean newBattleEnabled, + boolean battleResultEnabled, + boolean commentReplyEnabled, + boolean newCommentEnabled, + boolean contentLikeEnabled, + boolean marketingEventEnabled +) { +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/OnboardingProfileResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/OnboardingProfileResponse.java deleted file mode 100644 index 6c67ab4..0000000 --- a/src/main/java/com/swyp/app/domain/user/dto/response/OnboardingProfileResponse.java +++ /dev/null @@ -1,16 +0,0 @@ -package com.swyp.app.domain.user.dto.response; - -import com.swyp.app.domain.user.entity.CharacterType; -import com.swyp.app.domain.user.entity.UserStatus; - -import java.math.BigDecimal; - -public record OnboardingProfileResponse( - String userTag, - String nickname, - CharacterType characterType, - BigDecimal mannerTemperature, - UserStatus status, - boolean onboardingCompleted -) { -} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/RecapResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/RecapResponse.java new file mode 100644 index 0000000..7d7f245 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/dto/response/RecapResponse.java @@ -0,0 +1,44 @@ +package com.swyp.app.domain.user.dto.response; + +import com.swyp.app.domain.user.entity.PhilosopherType; + +import java.util.List; + +public record RecapResponse( + PhilosopherCard myCard, + PhilosopherCard bestMatchCard, + PhilosopherCard worstMatchCard, + Scores scores, + PreferenceReport preferenceReport +) { + + public record PhilosopherCard( + PhilosopherType philosopherType + ) { + } + + public record Scores( + int principle, + int reason, + int individual, + int change, + int inner, + int ideal + ) { + } + + public record PreferenceReport( + int totalParticipation, + int opinionChanges, + int battleWinRate, + List favoriteTopics + ) { + } + + public record FavoriteTopic( + int rank, + String tagName, + int participationCount + ) { + } +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryItemResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryItemResponse.java deleted file mode 100644 index 96aa08e..0000000 --- a/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryItemResponse.java +++ /dev/null @@ -1,15 +0,0 @@ -package com.swyp.app.domain.user.dto.response; - -import java.time.LocalDateTime; - -public record TendencyScoreHistoryItemResponse( - Long historyId, - int score1, - int score2, - int score3, - int score4, - int score5, - int score6, - LocalDateTime createdAt -) { -} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryResponse.java deleted file mode 100644 index d125ef1..0000000 --- a/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreHistoryResponse.java +++ /dev/null @@ -1,9 +0,0 @@ -package com.swyp.app.domain.user.dto.response; - -import java.util.List; - -public record TendencyScoreHistoryResponse( - List items, - Long nextCursor -) { -} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreResponse.java deleted file mode 100644 index 14b697b..0000000 --- a/src/main/java/com/swyp/app/domain/user/dto/response/TendencyScoreResponse.java +++ /dev/null @@ -1,16 +0,0 @@ -package com.swyp.app.domain.user.dto.response; - -import java.time.LocalDateTime; - -public record TendencyScoreResponse( - String userTag, - int score1, - int score2, - int score3, - int score4, - int score5, - int score6, - LocalDateTime updatedAt, - boolean historySaved -) { -} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/UpdateResultResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/UpdateResultResponse.java deleted file mode 100644 index c5ee9cb..0000000 --- a/src/main/java/com/swyp/app/domain/user/dto/response/UpdateResultResponse.java +++ /dev/null @@ -1,6 +0,0 @@ -package com.swyp.app.domain.user.dto.response; - -public record UpdateResultResponse( - boolean updated -) { -} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/UserProfileResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/UserProfileResponse.java deleted file mode 100644 index f1bdce7..0000000 --- a/src/main/java/com/swyp/app/domain/user/dto/response/UserProfileResponse.java +++ /dev/null @@ -1,13 +0,0 @@ -package com.swyp.app.domain.user.dto.response; - -import com.swyp.app.domain.user.entity.CharacterType; - -import java.math.BigDecimal; - -public record UserProfileResponse( - String userTag, - String nickname, - CharacterType characterType, - BigDecimal mannerTemperature -) { -} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/UserSettingsResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/UserSettingsResponse.java deleted file mode 100644 index a1c8965..0000000 --- a/src/main/java/com/swyp/app/domain/user/dto/response/UserSettingsResponse.java +++ /dev/null @@ -1,9 +0,0 @@ -package com.swyp.app.domain.user.dto.response; - -public record UserSettingsResponse( - boolean pushEnabled, - boolean emailEnabled, - boolean debateRequestEnabled, - boolean profilePublic -) { -} diff --git a/src/main/java/com/swyp/app/domain/user/entity/ActivityType.java b/src/main/java/com/swyp/app/domain/user/entity/ActivityType.java new file mode 100644 index 0000000..c6f47e8 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/ActivityType.java @@ -0,0 +1,6 @@ +package com.swyp.app.domain.user.entity; + +public enum ActivityType { + COMMENT, + LIKE +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/CreditHistory.java b/src/main/java/com/swyp/app/domain/user/entity/CreditHistory.java new file mode 100644 index 0000000..ceeea05 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/CreditHistory.java @@ -0,0 +1,45 @@ +package com.swyp.app.domain.user.entity; + +import com.swyp.app.domain.user.enums.CreditType; +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EnumType; +import jakarta.persistence.Enumerated; +import jakarta.persistence.Index; +import jakarta.persistence.Table; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +@Getter +@Entity +@Table(name = "credit_histories", indexes = { + @Index(name = "idx_credit_history_user_id", columnList = "user_id"), + @Index(name = "idx_credit_history_user_type_ref", columnList = "user_id, credit_type, reference_id", unique = true) +}) +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class CreditHistory extends BaseEntity { + + @Column(name = "user_id", nullable = false) + private Long userId; + + @Enumerated(EnumType.STRING) + @Column(name = "credit_type", nullable = false, length = 30) + private CreditType creditType; + + @Column(nullable = false) + private int amount; + + @Column(name = "reference_id", nullable = false) + private Long referenceId; + + @Builder + private CreditHistory(Long userId, CreditType creditType, int amount, Long referenceId) { + this.userId = userId; + this.creditType = creditType; + this.amount = amount; + this.referenceId = referenceId; + } +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/PhilosopherType.java b/src/main/java/com/swyp/app/domain/user/entity/PhilosopherType.java new file mode 100644 index 0000000..c78ad98 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/PhilosopherType.java @@ -0,0 +1,14 @@ +package com.swyp.app.domain.user.entity; + +public enum PhilosopherType { + SOCRATES, + PLATO, + ARISTOTLE, + KANT, + NIETZSCHE, + MARX, + SARTRE, + CONFUCIUS, + LAOZI, + BUDDHA +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/TierCode.java b/src/main/java/com/swyp/app/domain/user/entity/TierCode.java new file mode 100644 index 0000000..84579f8 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/TierCode.java @@ -0,0 +1,30 @@ +package com.swyp.app.domain.user.entity; + +import lombok.Getter; + +@Getter +public enum TierCode { + WANDERER("방랑자", 0), + STUDENT("학도", 500), + SAGE("현자", 2000), + PHILOSOPHER("철학자", 5000), + MASTER("마스터", 10000); + + private final String label; + private final int minPoints; + + TierCode(String label, int minPoints) { + this.label = label; + this.minPoints = minPoints; + } + + public static TierCode fromPoints(int points) { + TierCode result = WANDERER; + for (TierCode tier : values()) { + if (points >= tier.minPoints) { + result = tier; + } + } + return result; + } +} diff --git a/src/main/java/com/swyp/app/domain/user/entity/User.java b/src/main/java/com/swyp/app/domain/user/entity/User.java index 1cc57d3..f9b3c73 100644 --- a/src/main/java/com/swyp/app/domain/user/entity/User.java +++ b/src/main/java/com/swyp/app/domain/user/entity/User.java @@ -39,25 +39,16 @@ public class User extends BaseEntity { @Column(nullable = false, length = 20) private UserStatus status; - @Column(name = "onboarding_completed", nullable = false) - private boolean onboardingCompleted; - @Column(name = "deleted_at") private LocalDateTime deletedAt; @Builder - private User(String userTag, String nickname, String characterUrl, UserRole role, UserStatus status, boolean onboardingCompleted) { + private User(String userTag, String nickname, String characterUrl, UserRole role, UserStatus status) { this.userTag = userTag; this.nickname = nickname; this.characterUrl = characterUrl; this.role = role; this.status = status; - this.onboardingCompleted = onboardingCompleted; - } - - public void completeOnboarding() { - this.status = UserStatus.ACTIVE; - this.onboardingCompleted = true; } public void delete() { diff --git a/src/main/java/com/swyp/app/domain/user/entity/UserSettings.java b/src/main/java/com/swyp/app/domain/user/entity/UserSettings.java index 89f6bac..019236b 100644 --- a/src/main/java/com/swyp/app/domain/user/entity/UserSettings.java +++ b/src/main/java/com/swyp/app/domain/user/entity/UserSettings.java @@ -1,6 +1,7 @@ package com.swyp.app.domain.user.entity; import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Column; import jakarta.persistence.Entity; import jakarta.persistence.FetchType; import jakarta.persistence.Id; @@ -23,35 +24,57 @@ public class UserSettings extends BaseEntity { @JoinColumn(name = "user_id") private User user; - private boolean pushEnabled; + @Column(name = "new_battle_enabled") + private boolean newBattleEnabled; - private boolean emailEnabled; + @Column(name = "battle_result_enabled") + private boolean battleResultEnabled; - private boolean debateRequestEnabled; + @Column(name = "comment_reply_enabled") + private boolean commentReplyEnabled; - private boolean profilePublic; + @Column(name = "new_comment_enabled") + private boolean newCommentEnabled; + + @Column(name = "content_like_enabled") + private boolean contentLikeEnabled; + + @Column(name = "marketing_event_enabled") + private boolean marketingEventEnabled; @Builder - private UserSettings(User user, boolean pushEnabled, boolean emailEnabled, boolean debateRequestEnabled, boolean profilePublic) { + private UserSettings(User user, boolean newBattleEnabled, boolean battleResultEnabled, + boolean commentReplyEnabled, boolean newCommentEnabled, + boolean contentLikeEnabled, boolean marketingEventEnabled) { this.user = user; - this.pushEnabled = pushEnabled; - this.emailEnabled = emailEnabled; - this.debateRequestEnabled = debateRequestEnabled; - this.profilePublic = profilePublic; + this.newBattleEnabled = newBattleEnabled; + this.battleResultEnabled = battleResultEnabled; + this.commentReplyEnabled = commentReplyEnabled; + this.newCommentEnabled = newCommentEnabled; + this.contentLikeEnabled = contentLikeEnabled; + this.marketingEventEnabled = marketingEventEnabled; } - public void update(Boolean pushEnabled, Boolean emailEnabled, Boolean debateRequestEnabled, Boolean profilePublic) { - if (pushEnabled != null) { - this.pushEnabled = pushEnabled; + public void update(Boolean newBattleEnabled, Boolean battleResultEnabled, + Boolean commentReplyEnabled, Boolean newCommentEnabled, + Boolean contentLikeEnabled, Boolean marketingEventEnabled) { + if (newBattleEnabled != null) { + this.newBattleEnabled = newBattleEnabled; + } + if (battleResultEnabled != null) { + this.battleResultEnabled = battleResultEnabled; + } + if (commentReplyEnabled != null) { + this.commentReplyEnabled = commentReplyEnabled; } - if (emailEnabled != null) { - this.emailEnabled = emailEnabled; + if (newCommentEnabled != null) { + this.newCommentEnabled = newCommentEnabled; } - if (debateRequestEnabled != null) { - this.debateRequestEnabled = debateRequestEnabled; + if (contentLikeEnabled != null) { + this.contentLikeEnabled = contentLikeEnabled; } - if (profilePublic != null) { - this.profilePublic = profilePublic; + if (marketingEventEnabled != null) { + this.marketingEventEnabled = marketingEventEnabled; } } } diff --git a/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScore.java b/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScore.java index fd8c7a6..b090ff7 100644 --- a/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScore.java +++ b/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScore.java @@ -23,30 +23,37 @@ public class UserTendencyScore extends BaseEntity { @JoinColumn(name = "user_id") private User user; - private int score1; - private int score2; - private int score3; - private int score4; - private int score5; - private int score6; + private int principle; + + private int reason; + + private int individual; + + private int change; + + private int inner; + + private int ideal; @Builder - private UserTendencyScore(User user, int score1, int score2, int score3, int score4, int score5, int score6) { + private UserTendencyScore(User user, int principle, int reason, int individual, + int change, int inner, int ideal) { this.user = user; - this.score1 = score1; - this.score2 = score2; - this.score3 = score3; - this.score4 = score4; - this.score5 = score5; - this.score6 = score6; + this.principle = principle; + this.reason = reason; + this.individual = individual; + this.change = change; + this.inner = inner; + this.ideal = ideal; } - public void update(int score1, int score2, int score3, int score4, int score5, int score6) { - this.score1 = score1; - this.score2 = score2; - this.score3 = score3; - this.score4 = score4; - this.score5 = score5; - this.score6 = score6; + public void update(int principle, int reason, int individual, + int change, int inner, int ideal) { + this.principle = principle; + this.reason = reason; + this.individual = individual; + this.change = change; + this.inner = inner; + this.ideal = ideal; } } diff --git a/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScoreHistory.java b/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScoreHistory.java index 7759cc8..526cb20 100644 --- a/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScoreHistory.java +++ b/src/main/java/com/swyp/app/domain/user/entity/UserTendencyScoreHistory.java @@ -24,21 +24,27 @@ public class UserTendencyScoreHistory extends BaseEntity { @JoinColumn(name = "user_id", nullable = false) private User user; - private int score1; - private int score2; - private int score3; - private int score4; - private int score5; - private int score6; + private int principle; + + private int reason; + + private int individual; + + private int change; + + private int inner; + + private int ideal; @Builder - private UserTendencyScoreHistory(User user, int score1, int score2, int score3, int score4, int score5, int score6) { + private UserTendencyScoreHistory(User user, int principle, int reason, int individual, + int change, int inner, int ideal) { this.user = user; - this.score1 = score1; - this.score2 = score2; - this.score3 = score3; - this.score4 = score4; - this.score5 = score5; - this.score6 = score6; + this.principle = principle; + this.reason = reason; + this.individual = individual; + this.change = change; + this.inner = inner; + this.ideal = ideal; } } diff --git a/src/main/java/com/swyp/app/domain/user/entity/VoteSide.java b/src/main/java/com/swyp/app/domain/user/entity/VoteSide.java new file mode 100644 index 0000000..07d3f8a --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/entity/VoteSide.java @@ -0,0 +1,6 @@ +package com.swyp.app.domain.user.entity; + +public enum VoteSide { + PRO, + CON +} diff --git a/src/main/java/com/swyp/app/domain/user/enums/CreditType.java b/src/main/java/com/swyp/app/domain/user/enums/CreditType.java new file mode 100644 index 0000000..d98917a --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/enums/CreditType.java @@ -0,0 +1,21 @@ +package com.swyp.app.domain.user.enums; + +import lombok.Getter; + +@Getter +public enum CreditType { + BATTLE_VOTE(10), + QUIZ_VOTE(5), + MAJORITY_WIN(20), + BEST_COMMENT(100), + TOPIC_SUGGEST(30), + TOPIC_ADOPTED(1000), + AD_REWARD(50), + FREE_CHARGE(0); + + private final int defaultAmount; + + CreditType(int defaultAmount) { + this.defaultAmount = defaultAmount; + } +} diff --git a/src/main/java/com/swyp/app/domain/user/repository/CreditHistoryRepository.java b/src/main/java/com/swyp/app/domain/user/repository/CreditHistoryRepository.java new file mode 100644 index 0000000..a860eef --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/repository/CreditHistoryRepository.java @@ -0,0 +1,15 @@ +package com.swyp.app.domain.user.repository; + +import com.swyp.app.domain.user.entity.CreditHistory; +import com.swyp.app.domain.user.enums.CreditType; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; + +public interface CreditHistoryRepository extends JpaRepository { + + @Query("SELECT COALESCE(SUM(c.amount), 0) FROM CreditHistory c WHERE c.userId = :userId") + int sumAmountByUserId(@Param("userId") Long userId); + + boolean existsByUserIdAndCreditTypeAndReferenceId(Long userId, CreditType creditType, Long referenceId); +} diff --git a/src/main/java/com/swyp/app/domain/user/service/CreditService.java b/src/main/java/com/swyp/app/domain/user/service/CreditService.java new file mode 100644 index 0000000..a9c9ce3 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/service/CreditService.java @@ -0,0 +1,83 @@ +package com.swyp.app.domain.user.service; + +import com.swyp.app.domain.user.entity.CreditHistory; +import com.swyp.app.domain.user.entity.TierCode; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.enums.CreditType; +import com.swyp.app.domain.user.repository.CreditHistoryRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.dao.DataIntegrityViolationException; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class CreditService { + + private final CreditHistoryRepository creditHistoryRepository; + private final UserService userService; + + /** + * 현재 로그인한 유저에게 크레딧 적립 (기본 포인트). + * 일반적인 유저 액션(투표, 관점 작성, 좋아요 등)에서 사용. + * 예: creditService.addCredit(CreditType.BATTLE_VOTE, voteId); + */ + @Transactional + public void addCredit(CreditType creditType, Long referenceId) { + User user = userService.findCurrentUser(); + addCredit(user.getId(), creditType, creditType.getDefaultAmount(), referenceId); + } + + /** + * 특정 유저에게 크레딧 적립 (기본 포인트). + * SecurityContext 없이 호출하는 경우(배치, 스케줄러, 관리자 지급 등)에서 사용. + * 예: creditService.addCredit(authorId, CreditType.BEST_COMMENT, perspectiveId); + */ + @Transactional + public void addCredit(Long userId, CreditType creditType, Long referenceId) { + addCredit(userId, creditType, creditType.getDefaultAmount(), referenceId); + } + + /** + * 특정 유저에게 커스텀 포인트로 크레딧 적립. + * CreditType의 기본 포인트가 아닌 가변 포인트가 필요한 경우(FREE_CHARGE 랜덤 박스 등)에서 사용. + * 예: creditService.addCredit(userId, CreditType.FREE_CHARGE, 15, boxId); + */ + @Transactional + public void addCredit(Long userId, CreditType creditType, int amount, Long referenceId) { + validateReferenceId(referenceId); + + CreditHistory history = CreditHistory.builder() + .userId(userId) + .creditType(creditType) + .amount(amount) + .referenceId(referenceId) + .build(); + + try { + creditHistoryRepository.saveAndFlush(history); + } catch (DataIntegrityViolationException e) { + if (creditHistoryRepository.existsByUserIdAndCreditTypeAndReferenceId(userId, creditType, referenceId)) { + return; + } + throw new CustomException(ErrorCode.CREDIT_SAVE_FAILED); + } + } + + public int getTotalPoints(Long userId) { + return creditHistoryRepository.sumAmountByUserId(userId); + } + + public TierCode getTier(Long userId) { + return TierCode.fromPoints(getTotalPoints(userId)); + } + + private void validateReferenceId(Long referenceId) { + if (referenceId == null) { + throw new CustomException(ErrorCode.CREDIT_REFERENCE_REQUIRED); + } + } +} diff --git a/src/main/java/com/swyp/app/domain/user/service/MypageService.java b/src/main/java/com/swyp/app/domain/user/service/MypageService.java new file mode 100644 index 0000000..9db9a2e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/user/service/MypageService.java @@ -0,0 +1,303 @@ +package com.swyp.app.domain.user.service; + +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.battle.enums.BattleOptionLabel; +import com.swyp.app.domain.battle.service.BattleQueryService; +import com.swyp.app.domain.perspective.entity.Perspective; +import com.swyp.app.domain.perspective.entity.PerspectiveComment; +import com.swyp.app.domain.perspective.entity.PerspectiveLike; +import com.swyp.app.domain.perspective.service.PerspectiveQueryService; +import com.swyp.app.domain.user.dto.request.UpdateNotificationSettingsRequest; +import com.swyp.app.domain.user.dto.response.BattleRecordListResponse; +import com.swyp.app.domain.user.dto.response.ContentActivityListResponse; +import com.swyp.app.domain.user.dto.response.MypageResponse; +import com.swyp.app.domain.notice.dto.response.NoticeSummaryResponse; +import com.swyp.app.domain.notice.enums.NoticePlacement; +import com.swyp.app.domain.notice.enums.NoticeType; +import com.swyp.app.domain.notice.service.NoticeService; +import com.swyp.app.domain.user.dto.response.NoticeDetailResponse; +import com.swyp.app.domain.user.dto.response.NoticeListResponse; +import com.swyp.app.domain.user.dto.response.NotificationSettingsResponse; +import com.swyp.app.domain.user.dto.response.RecapResponse; +import com.swyp.app.domain.user.dto.response.UserSummary; +import com.swyp.app.domain.user.entity.ActivityType; +import com.swyp.app.domain.user.entity.CharacterType; +import com.swyp.app.domain.user.entity.PhilosopherType; +import com.swyp.app.domain.user.entity.TierCode; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.entity.UserProfile; +import com.swyp.app.domain.user.entity.UserSettings; +import com.swyp.app.domain.user.entity.UserTendencyScore; +import com.swyp.app.domain.user.entity.VoteSide; +import com.swyp.app.domain.vote.entity.Vote; +import com.swyp.app.domain.vote.service.VoteQueryService; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.time.LocalDateTime; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class MypageService { + + private static final int DEFAULT_PAGE_SIZE = 20; + + private final UserService userService; + private final NoticeService noticeService; + private final CreditService creditService; + private final VoteQueryService voteQueryService; + private final BattleQueryService battleQueryService; + private final PerspectiveQueryService perspectiveQueryService; + + public MypageResponse getMypage() { + User user = userService.findCurrentUser(); + UserProfile profile = userService.findUserProfile(user.getId()); + + MypageResponse.ProfileInfo profileInfo = new MypageResponse.ProfileInfo( + user.getUserTag(), + profile.getNickname(), + profile.getCharacterType(), + profile.getMannerTemperature() + ); + + // TODO: 철학자 산출 로직 확정 후 구현, 현재는 임시로 SOCRATES 반환 + MypageResponse.PhilosopherInfo philosopherInfo = new MypageResponse.PhilosopherInfo( + PhilosopherType.SOCRATES + ); + + int currentPoint = creditService.getTotalPoints(user.getId()); + TierCode tierCode = TierCode.fromPoints(currentPoint); + MypageResponse.TierInfo tierInfo = new MypageResponse.TierInfo( + tierCode, + tierCode.getLabel(), + currentPoint + ); + + return new MypageResponse(profileInfo, philosopherInfo, tierInfo); + } + + public RecapResponse getRecap() { + User user = userService.findCurrentUser(); + UserTendencyScore score = userService.findUserTendencyScore(user.getId()); + + // TODO: 철학자 산출 로직 확정 후 구현, 현재는 임시 값 반환 + RecapResponse.PhilosopherCard myCard = new RecapResponse.PhilosopherCard(PhilosopherType.SOCRATES); + RecapResponse.PhilosopherCard bestMatchCard = new RecapResponse.PhilosopherCard(PhilosopherType.PLATO); + RecapResponse.PhilosopherCard worstMatchCard = new RecapResponse.PhilosopherCard(PhilosopherType.MARX); + + RecapResponse.Scores scores = new RecapResponse.Scores( + score.getPrinciple(), + score.getReason(), + score.getIndividual(), + score.getChange(), + score.getInner(), + score.getIdeal() + ); + + RecapResponse.PreferenceReport preferenceReport = buildPreferenceReport(user.getId()); + + return new RecapResponse(myCard, bestMatchCard, worstMatchCard, scores, preferenceReport); + } + + private RecapResponse.PreferenceReport buildPreferenceReport(Long userId) { + long totalParticipation = voteQueryService.countTotalParticipation(userId); + long opinionChanges = voteQueryService.countOpinionChanges(userId); + int battleWinRate = voteQueryService.calculateBattleWinRate(userId); + + List battleIds = voteQueryService.findParticipatedBattleIds(userId); + Map topTags = battleQueryService.getTopTagsByBattleIds(battleIds, 4); + + List favoriteTopics = new ArrayList<>(); + int rank = 1; + for (Map.Entry entry : topTags.entrySet()) { + favoriteTopics.add(new RecapResponse.FavoriteTopic(rank++, entry.getKey(), entry.getValue().intValue())); + } + + return new RecapResponse.PreferenceReport( + (int) totalParticipation, + (int) opinionChanges, + battleWinRate, + favoriteTopics + ); + } + + public BattleRecordListResponse getBattleRecords(Integer offset, Integer size, VoteSide voteSide) { + User user = userService.findCurrentUser(); + int pageOffset = offset == null || offset < 0 ? 0 : offset; + int pageSize = size == null || size <= 0 ? DEFAULT_PAGE_SIZE : size; + + BattleOptionLabel label = voteSide != null ? toOptionLabel(voteSide) : null; + + List votes = voteQueryService.findUserVotes(user.getId(), pageOffset, pageSize, label); + long totalCount = voteQueryService.countUserVotes(user.getId(), label); + + List items = votes.stream() + .map(vote -> new BattleRecordListResponse.BattleRecordItem( + vote.getBattle().getId().toString(), + vote.getId().toString(), + toVoteSide(vote.getPreVoteOption().getLabel()), + vote.getBattle().getTitle(), + vote.getBattle().getSummary(), + vote.getCreatedAt() + )) + .toList(); + + int nextOffset = pageOffset + pageSize; + boolean hasNext = nextOffset < totalCount; + return new BattleRecordListResponse(items, hasNext ? nextOffset : null, hasNext); + } + + public ContentActivityListResponse getContentActivities(Integer offset, Integer size, ActivityType activityType) { + User user = userService.findCurrentUser(); + int pageOffset = offset == null || offset < 0 ? 0 : offset; + int pageSize = size == null || size <= 0 ? DEFAULT_PAGE_SIZE : size; + + if (activityType == ActivityType.LIKE) { + return buildLikeActivities(user, pageOffset, pageSize); + } + return buildCommentActivities(user, pageOffset, pageSize); + } + + private ContentActivityListResponse buildCommentActivities(User user, int pageOffset, int pageSize) { + List comments = perspectiveQueryService.findUserComments(user.getId(), pageOffset, pageSize); + long totalCount = perspectiveQueryService.countUserComments(user.getId()); + + List perspectives = comments.stream().map(PerspectiveComment::getPerspective).toList(); + Map battleMap = loadBattles(perspectives); + Map optionMap = loadOptions(perspectives); + + List items = comments.stream() + .map(comment -> { + Perspective p = comment.getPerspective(); + return toActivityItem(comment.getId().toString(), ActivityType.COMMENT, p, + battleMap.get(p.getBattleId()), optionMap.get(p.getOptionId()), + comment.getContent(), comment.getCreatedAt()); + }) + .toList(); + + int nextOffset = pageOffset + pageSize; + boolean hasNext = nextOffset < totalCount; + return new ContentActivityListResponse(items, hasNext ? nextOffset : null, hasNext); + } + + private ContentActivityListResponse buildLikeActivities(User user, int pageOffset, int pageSize) { + List likes = perspectiveQueryService.findUserLikes(user.getId(), pageOffset, pageSize); + long totalCount = perspectiveQueryService.countUserLikes(user.getId()); + + List perspectives = likes.stream().map(PerspectiveLike::getPerspective).toList(); + Map battleMap = loadBattles(perspectives); + Map optionMap = loadOptions(perspectives); + + List items = likes.stream() + .map(like -> { + Perspective p = like.getPerspective(); + return toActivityItem(like.getId().toString(), ActivityType.LIKE, p, + battleMap.get(p.getBattleId()), optionMap.get(p.getOptionId()), + p.getContent(), like.getCreatedAt()); + }) + .toList(); + + int nextOffset = pageOffset + pageSize; + boolean hasNext = nextOffset < totalCount; + return new ContentActivityListResponse(items, hasNext ? nextOffset : null, hasNext); + } + + private ContentActivityListResponse.ContentActivityItem toActivityItem( + String activityId, ActivityType activityType, Perspective perspective, + Battle battle, BattleOption option, String content, LocalDateTime createdAt) { + + UserSummary author = userService.findSummaryById(perspective.getUserId()); + ContentActivityListResponse.AuthorInfo authorInfo = new ContentActivityListResponse.AuthorInfo( + author.userTag(), author.nickname(), CharacterType.from(author.characterType()) + ); + + return new ContentActivityListResponse.ContentActivityItem( + activityId, activityType, + perspective.getId().toString(), + perspective.getBattleId().toString(), + battle != null ? battle.getTitle() : null, + authorInfo, + option != null ? option.getStance() : null, + content, + perspective.getLikeCount(), + createdAt + ); + } + + private Map loadBattles(List perspectives) { + List battleIds = perspectives.stream().map(Perspective::getBattleId).distinct().toList(); + return battleQueryService.findBattlesByIds(battleIds); + } + + private Map loadOptions(List perspectives) { + List optionIds = perspectives.stream().map(Perspective::getOptionId).distinct().toList(); + return battleQueryService.findOptionsByIds(optionIds); + } + + public NotificationSettingsResponse getNotificationSettings() { + User user = userService.findCurrentUser(); + UserSettings settings = userService.findUserSettings(user.getId()); + return toNotificationSettingsResponse(settings); + } + + @Transactional + public NotificationSettingsResponse updateNotificationSettings(UpdateNotificationSettingsRequest request) { + User user = userService.findCurrentUser(); + UserSettings settings = userService.findUserSettings(user.getId()); + settings.update( + request.newBattleEnabled(), + request.battleResultEnabled(), + request.commentReplyEnabled(), + request.newCommentEnabled(), + request.contentLikeEnabled(), + request.marketingEventEnabled() + ); + return toNotificationSettingsResponse(settings); + } + + public NoticeListResponse getNotices(NoticeType type) { + List notices = noticeService.getActiveNotices( + NoticePlacement.NOTICE_BOARD, type, null + ); + + List items = notices.stream() + .map(notice -> new NoticeListResponse.NoticeItem( + notice.noticeId(), notice.type(), notice.title(), + notice.body(), notice.pinned(), notice.startsAt() + )) + .toList(); + + return new NoticeListResponse(items); + } + + public NoticeDetailResponse getNoticeDetail(Long noticeId) { + com.swyp.app.domain.notice.dto.response.NoticeDetailResponse notice = + noticeService.getNoticeDetail(noticeId); + return new NoticeDetailResponse( + notice.noticeId(), notice.type(), notice.title(), + notice.body(), notice.pinned(), notice.startsAt() + ); + } + + private VoteSide toVoteSide(BattleOptionLabel label) { + return label == BattleOptionLabel.A ? VoteSide.PRO : VoteSide.CON; + } + + private BattleOptionLabel toOptionLabel(VoteSide voteSide) { + return voteSide == VoteSide.PRO ? BattleOptionLabel.A : BattleOptionLabel.B; + } + + private NotificationSettingsResponse toNotificationSettingsResponse(UserSettings settings) { + return new NotificationSettingsResponse( + settings.isNewBattleEnabled(), settings.isBattleResultEnabled(), + settings.isCommentReplyEnabled(), settings.isNewCommentEnabled(), + settings.isContentLikeEnabled(), settings.isMarketingEventEnabled() + ); + } +} diff --git a/src/main/java/com/swyp/app/domain/user/service/UserService.java b/src/main/java/com/swyp/app/domain/user/service/UserService.java index b941155..6275bad 100644 --- a/src/main/java/com/swyp/app/domain/user/service/UserService.java +++ b/src/main/java/com/swyp/app/domain/user/service/UserService.java @@ -1,138 +1,31 @@ package com.swyp.app.domain.user.service; -import com.swyp.app.domain.user.dto.request.CreateOnboardingProfileRequest; -import com.swyp.app.domain.user.dto.request.UpdateTendencyScoreRequest; import com.swyp.app.domain.user.dto.request.UpdateUserProfileRequest; -import com.swyp.app.domain.user.dto.request.UpdateUserSettingsRequest; -import com.swyp.app.domain.user.dto.response.BootstrapResponse; import com.swyp.app.domain.user.dto.response.MyProfileResponse; -import com.swyp.app.domain.user.dto.response.OnboardingProfileResponse; -import com.swyp.app.domain.user.dto.response.TendencyScoreHistoryItemResponse; -import com.swyp.app.domain.user.dto.response.TendencyScoreHistoryResponse; -import com.swyp.app.domain.user.dto.response.TendencyScoreResponse; -import com.swyp.app.domain.user.dto.response.UpdateResultResponse; -import com.swyp.app.domain.user.dto.response.UserProfileResponse; -import com.swyp.app.domain.user.dto.response.UserSettingsResponse; import com.swyp.app.domain.user.dto.response.UserSummary; -import com.swyp.app.domain.user.entity.AgreementType; import com.swyp.app.domain.user.entity.User; -import com.swyp.app.domain.user.entity.UserAgreement; import com.swyp.app.domain.user.entity.UserProfile; -import com.swyp.app.domain.user.entity.UserRole; import com.swyp.app.domain.user.entity.UserSettings; -import com.swyp.app.domain.user.entity.UserStatus; import com.swyp.app.domain.user.entity.UserTendencyScore; -import com.swyp.app.domain.user.entity.UserTendencyScoreHistory; import com.swyp.app.domain.user.repository.UserProfileRepository; -import com.swyp.app.domain.user.repository.UserAgreementRepository; import com.swyp.app.domain.user.repository.UserRepository; import com.swyp.app.domain.user.repository.UserSettingsRepository; -import com.swyp.app.domain.user.repository.UserTendencyScoreHistoryRepository; import com.swyp.app.domain.user.repository.UserTendencyScoreRepository; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; import lombok.RequiredArgsConstructor; -import org.springframework.data.domain.PageRequest; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; -import java.math.BigDecimal; -import java.time.LocalDateTime; -import java.util.List; -import java.util.concurrent.ThreadLocalRandom; - @Service @RequiredArgsConstructor @Transactional(readOnly = true) public class UserService { - private static final String[] PREFIXES = {"생각하는", "집중하는", "차분한", "기민한", "용감한", "명확한"}; - private static final String[] SUFFIXES = {"올빼미", "여우", "늑대", "사자", "펭귄", "토끼", "고양이", "곰"}; - private static final BigDecimal DEFAULT_MANNER_TEMPERATURE = BigDecimal.valueOf(36.5); - private static final int DEFAULT_HISTORY_SIZE = 20; - private static final String DEFAULT_AGREEMENT_VERSION = "1.0"; - private static final String USER_TAG_CHARACTERS = "abcdefghijklmnopqrstuvwxyz0123456789"; - private static final int USER_TAG_LENGTH = 8; - private final UserRepository userRepository; - private final UserAgreementRepository userAgreementRepository; private final UserProfileRepository userProfileRepository; private final UserSettingsRepository userSettingsRepository; private final UserTendencyScoreRepository userTendencyScoreRepository; - private final UserTendencyScoreHistoryRepository userTendencyScoreHistoryRepository; - - public BootstrapResponse getBootstrap() { - return new BootstrapResponse(generateRandomNickname()); - } - - @Transactional - public OnboardingProfileResponse createOnboardingProfile(CreateOnboardingProfileRequest request) { - User user = userRepository.findTopByOrderByIdDesc() - .orElseGet(this::createPendingUser); - - if (user.isOnboardingCompleted()) { - throw new CustomException(ErrorCode.ONBOARDING_ALREADY_COMPLETED); - } - - UserProfile profile = UserProfile.builder() - .user(user) - .nickname(request.nickname()) - .characterType(request.characterType()) - .mannerTemperature(DEFAULT_MANNER_TEMPERATURE) - .build(); - - UserSettings settings = UserSettings.builder() - .user(user) - .pushEnabled(false) - .emailEnabled(false) - .debateRequestEnabled(false) - .profilePublic(false) - .build(); - - UserTendencyScore tendencyScore = UserTendencyScore.builder() - .user(user) - .score1(0) - .score2(0) - .score3(0) - .score4(0) - .score5(0) - .score6(0) - .build(); - - userProfileRepository.save(profile); - userSettingsRepository.save(settings); - userTendencyScoreRepository.save(tendencyScore); - saveRequiredAgreements(user); - - user.completeOnboarding(); - - return new OnboardingProfileResponse( - user.getUserTag(), - profile.getNickname(), - profile.getCharacterType(), - profile.getMannerTemperature(), - user.getStatus(), - user.isOnboardingCompleted() - ); - } - - public UserProfileResponse getUserProfile(String userTag) { - User user = findUserByTag(userTag); - UserProfile profile = findUserProfile(user.getId()); - return new UserProfileResponse(user.getUserTag(), profile.getNickname(), profile.getCharacterType(), profile.getMannerTemperature()); - } - - public MyProfileResponse getMyProfile() { - User user = findCurrentUser(); - UserProfile profile = findUserProfile(user.getId()); - return new MyProfileResponse( - user.getUserTag(), - profile.getNickname(), - profile.getCharacterType(), - profile.getMannerTemperature(), - profile.getUpdatedAt() - ); - } @Transactional public MyProfileResponse updateMyProfile(UpdateUserProfileRequest request) { @@ -143,95 +36,10 @@ public MyProfileResponse updateMyProfile(UpdateUserProfileRequest request) { user.getUserTag(), profile.getNickname(), profile.getCharacterType(), - profile.getMannerTemperature(), profile.getUpdatedAt() ); } - public UserSettingsResponse getMySettings() { - UserSettings settings = findUserSettings(findCurrentUser().getId()); - return new UserSettingsResponse( - settings.isPushEnabled(), - settings.isEmailEnabled(), - settings.isDebateRequestEnabled(), - settings.isProfilePublic() - ); - } - - @Transactional - public UpdateResultResponse updateMySettings(UpdateUserSettingsRequest request) { - UserSettings settings = findUserSettings(findCurrentUser().getId()); - settings.update( - request.pushEnabled(), - request.emailEnabled(), - request.debateRequestEnabled(), - request.profilePublic() - ); - return new UpdateResultResponse(true); - } - - @Transactional - public TendencyScoreResponse updateMyTendencyScores(UpdateTendencyScoreRequest request) { - User user = findCurrentUser(); - UserTendencyScore score = findUserTendencyScore(user.getId()); - score.update( - request.score1(), - request.score2(), - request.score3(), - request.score4(), - request.score5(), - request.score6() - ); - - userTendencyScoreHistoryRepository.save(UserTendencyScoreHistory.builder() - .user(user) - .score1(request.score1()) - .score2(request.score2()) - .score3(request.score3()) - .score4(request.score4()) - .score5(request.score5()) - .score6(request.score6()) - .build()); - - return new TendencyScoreResponse( - user.getUserTag(), - score.getScore1(), - score.getScore2(), - score.getScore3(), - score.getScore4(), - score.getScore5(), - score.getScore6(), - score.getUpdatedAt(), - true - ); - } - - public TendencyScoreHistoryResponse getMyTendencyScoreHistory(Long cursor, Integer size) { - User user = findCurrentUser(); - int pageSize = size == null || size <= 0 ? DEFAULT_HISTORY_SIZE : size; - PageRequest pageable = PageRequest.of(0, pageSize); - - List histories = cursor == null - ? userTendencyScoreHistoryRepository.findByUserOrderByIdDesc(user, pageable) - : userTendencyScoreHistoryRepository.findByUserAndIdLessThanOrderByIdDesc(user, cursor, pageable); - - List items = histories.stream() - .map(history -> new TendencyScoreHistoryItemResponse( - history.getId(), - history.getScore1(), - history.getScore2(), - history.getScore3(), - history.getScore4(), - history.getScore5(), - history.getScore6(), - history.getCreatedAt() - )) - .toList(); - - Long nextCursor = histories.size() == pageSize ? histories.get(histories.size() - 1).getId() : null; - return new TendencyScoreHistoryResponse(items, nextCursor); - } - public UserSummary findSummaryById(Long userId) { User user = userRepository.findById(userId) .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); @@ -239,74 +47,23 @@ public UserSummary findSummaryById(Long userId) { return new UserSummary(user.getUserTag(), profile.getNickname(), profile.getCharacterType().name()); } - private User findUserByTag(String userTag) { - return userRepository.findByUserTag(userTag) - .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); - } - - private User findCurrentUser() { + public User findCurrentUser() { return userRepository.findTopByOrderByIdDesc() .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); } - private User createPendingUser() { - User user = User.builder() - .userTag(generateUserTag()) - .role(UserRole.USER) - .status(UserStatus.PENDING) - .onboardingCompleted(false) - .build(); - return userRepository.save(user); - } - - private void saveRequiredAgreements(User user) { - LocalDateTime agreedAt = LocalDateTime.now(); - userAgreementRepository.saveAll(List.of( - UserAgreement.builder() - .user(user) - .agreementType(AgreementType.TERMS_OF_SERVICE) - .version(DEFAULT_AGREEMENT_VERSION) - .agreedAt(agreedAt) - .build(), - UserAgreement.builder() - .user(user) - .agreementType(AgreementType.PRIVACY_POLICY) - .version(DEFAULT_AGREEMENT_VERSION) - .agreedAt(agreedAt) - .build() - )); - } - - private UserProfile findUserProfile(Long userId) { + public UserProfile findUserProfile(Long userId) { return userProfileRepository.findById(userId) .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); } - private UserSettings findUserSettings(Long userId) { + public UserSettings findUserSettings(Long userId) { return userSettingsRepository.findById(userId) .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); } - private UserTendencyScore findUserTendencyScore(Long userId) { + public UserTendencyScore findUserTendencyScore(Long userId) { return userTendencyScoreRepository.findById(userId) .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); } - - private String generateRandomNickname() { - return PREFIXES[ThreadLocalRandom.current().nextInt(PREFIXES.length)] - + SUFFIXES[ThreadLocalRandom.current().nextInt(SUFFIXES.length)]; - } - - private String generateUserTag() { - String candidate; - do { - StringBuilder builder = new StringBuilder(USER_TAG_LENGTH); - for (int i = 0; i < USER_TAG_LENGTH; i++) { - int index = ThreadLocalRandom.current().nextInt(USER_TAG_CHARACTERS.length()); - builder.append(USER_TAG_CHARACTERS.charAt(index)); - } - candidate = builder.toString(); - } while (userRepository.existsByUserTag(candidate)); - return candidate; - } } diff --git a/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java b/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java index 99c9a18..086be02 100644 --- a/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java +++ b/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java @@ -2,10 +2,15 @@ import com.swyp.app.domain.battle.entity.Battle; import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.battle.enums.BattleOptionLabel; import com.swyp.app.domain.user.entity.User; import com.swyp.app.domain.vote.entity.Vote; +import org.springframework.data.domain.Pageable; import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; +import java.util.List; import java.util.Optional; public interface VoteRepository extends JpaRepository { @@ -21,4 +26,33 @@ public interface VoteRepository extends JpaRepository { long countByBattleAndPreVoteOption(Battle battle, BattleOption preVoteOption); Optional findTopByBattleOrderByUpdatedAtDesc(Battle battle); -} \ No newline at end of file + + // MypageService: 사용자 투표 기록 조회 (offset 페이지네이션) + @Query("SELECT v FROM Vote v JOIN FETCH v.battle JOIN FETCH v.preVoteOption " + + "WHERE v.userId = :userId ORDER BY v.createdAt DESC") + List findByUserIdOrderByCreatedAtDesc(@Param("userId") Long userId, Pageable pageable); + + // MypageService: 사용자 투표 기록 - voteSide(PRO/CON) 필터 + @Query("SELECT v FROM Vote v JOIN FETCH v.battle JOIN FETCH v.preVoteOption " + + "WHERE v.userId = :userId AND v.preVoteOption.label = :label ORDER BY v.createdAt DESC") + List findByUserIdAndPreVoteOptionLabelOrderByCreatedAtDesc( + @Param("userId") Long userId, @Param("label") BattleOptionLabel label, Pageable pageable); + + // MypageService: 사용자 투표 전체 수 + long countByUserId(Long userId); + + // MypageService: 사용자 투표 수 - voteSide 필터 + @Query("SELECT COUNT(v) FROM Vote v WHERE v.userId = :userId AND v.preVoteOption.label = :label") + long countByUserIdAndPreVoteOptionLabel(@Param("userId") Long userId, @Param("label") BattleOptionLabel label); + + // MypageService (recap): 사후 투표 완료 수 + long countByUserIdAndStatus(Long userId, com.swyp.app.domain.vote.enums.VoteStatus status); + + // MypageService (recap): 입장 변경 수 (사전/사후 투표 옵션이 다른 경우) + @Query("SELECT COUNT(v) FROM Vote v WHERE v.userId = :userId AND v.status = 'POST_VOTED' " + + "AND v.preVoteOption <> v.postVoteOption") + long countOpinionChangesByUserId(@Param("userId") Long userId); + + // MypageService (recap): 사용자가 참여한 모든 투표 (배틀 목록 추출용) + List findByUserId(Long userId); +} diff --git a/src/main/java/com/swyp/app/domain/vote/service/VoteQueryService.java b/src/main/java/com/swyp/app/domain/vote/service/VoteQueryService.java new file mode 100644 index 0000000..7250919 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/vote/service/VoteQueryService.java @@ -0,0 +1,71 @@ +package com.swyp.app.domain.vote.service; + +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.battle.enums.BattleOptionLabel; +import com.swyp.app.domain.vote.entity.Vote; +import com.swyp.app.domain.vote.enums.VoteStatus; +import com.swyp.app.domain.vote.repository.VoteRepository; +import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.PageRequest; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.List; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class VoteQueryService { + + private final VoteRepository voteRepository; + + public List findUserVotes(Long userId, int offset, int size, BattleOptionLabel label) { + PageRequest pageable = PageRequest.of(offset / size, size); + return label != null + ? voteRepository.findByUserIdAndPreVoteOptionLabelOrderByCreatedAtDesc(userId, label, pageable) + : voteRepository.findByUserIdOrderByCreatedAtDesc(userId, pageable); + } + + public long countUserVotes(Long userId, BattleOptionLabel label) { + return label != null + ? voteRepository.countByUserIdAndPreVoteOptionLabel(userId, label) + : voteRepository.countByUserId(userId); + } + + public long countTotalParticipation(Long userId) { + return voteRepository.countByUserId(userId); + } + + public long countOpinionChanges(Long userId) { + return voteRepository.countOpinionChangesByUserId(userId); + } + + public int calculateBattleWinRate(Long userId) { + List postVotes = voteRepository.findByUserId(userId).stream() + .filter(v -> v.getStatus() == VoteStatus.POST_VOTED && v.getPostVoteOption() != null) + .toList(); + + if (postVotes.isEmpty()) return 0; + + long wins = postVotes.stream() + .filter(v -> { + BattleOption myOption = v.getPostVoteOption(); + BattleOption otherOption = v.getPreVoteOption(); + if (myOption.getId().equals(otherOption.getId())) { + long totalVotes = v.getBattle().getTotalParticipantsCount(); + return myOption.getVoteCount() > totalVotes - myOption.getVoteCount(); + } + return myOption.getVoteCount() > otherOption.getVoteCount(); + }) + .count(); + + return (int) (wins * 100 / postVotes.size()); + } + + public List findParticipatedBattleIds(Long userId) { + return voteRepository.findByUserId(userId).stream() + .map(v -> v.getBattle().getId()) + .distinct() + .toList(); + } +} diff --git a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java index 8f32a9a..5b895f1 100644 --- a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java +++ b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java @@ -33,6 +33,10 @@ public enum ErrorCode { USER_NOT_FOUND(HttpStatus.NOT_FOUND, "USER_404", "존재하지 않는 사용자입니다."), ONBOARDING_ALREADY_COMPLETED(HttpStatus.CONFLICT, "USER_409", "이미 온보딩이 완료된 사용자입니다."), + // Credit + CREDIT_REFERENCE_REQUIRED(HttpStatus.BAD_REQUEST, "CREDIT_400_REF", "크레딧 적립 referenceId는 필수입니다."), + CREDIT_SAVE_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "CREDIT_500_SAVE", "크레딧 적립 처리 중 오류가 발생했습니다."), + // OAuth (Social Login) INVALID_PROVIDER(HttpStatus.BAD_REQUEST, "AUTH_400_PROVIDER", "지원하지 않는 소셜 로그인 provider입니다."), diff --git a/src/main/java/com/swyp/app/global/config/SecurityConfig.java b/src/main/java/com/swyp/app/global/config/SecurityConfig.java index be902b6..ae11cd1 100644 --- a/src/main/java/com/swyp/app/global/config/SecurityConfig.java +++ b/src/main/java/com/swyp/app/global/config/SecurityConfig.java @@ -31,6 +31,7 @@ public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { .authorizeHttpRequests(auth -> auth .requestMatchers( "/", "/api/v1/auth/**", "/api/v1/home", + "/api/v1/notices/**", "/swagger-ui/**", "/v3/api-docs/**", "/js/**", "/css/**", "/images/**", "/favicon.ico", "/api/v1/admin/login", "/api/v1/admin" @@ -51,4 +52,4 @@ public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { return http.build(); } -} \ No newline at end of file +} diff --git a/src/test/java/com/swyp/app/domain/home/service/HomeServiceTest.java b/src/test/java/com/swyp/app/domain/home/service/HomeServiceTest.java index 276d4e7..e7e3403 100644 --- a/src/test/java/com/swyp/app/domain/home/service/HomeServiceTest.java +++ b/src/test/java/com/swyp/app/domain/home/service/HomeServiceTest.java @@ -9,6 +9,7 @@ import com.swyp.app.domain.notice.dto.response.NoticeSummaryResponse; import com.swyp.app.domain.notice.enums.NoticePlacement; import com.swyp.app.domain.notice.service.NoticeService; +import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.extension.ExtendWith; import org.mockito.InjectMocks; @@ -45,7 +46,8 @@ private Long generateId() { } @Test - void getHome_명세기준으로_섹션별_데이터를_조합한다() { + @DisplayName("명세기준으로 섹션별 데이터를 조합한다") + void getHome_aggregates_sections_by_spec() { TodayBattleResponse editorPick = battle("editor-id", BATTLE); TodayBattleResponse trendingBattle = battle("trending-id", BATTLE); TodayBattleResponse bestBattle = battle("best-id", BATTLE); @@ -99,7 +101,8 @@ private Long generateId() { } @Test - void getHome_데이터가_없으면_false와_빈리스트를_반환한다() { + @DisplayName("데이터가 없으면 false와 빈리스트를 반환한다") + void getHome_returns_false_and_empty_lists_when_no_data() { when(noticeService.getActiveNotices(NoticePlacement.HOME_TOP, null, 1)).thenReturn(List.of()); when(battleService.getEditorPicks()).thenReturn(List.of()); when(battleService.getTrendingBattles()).thenReturn(List.of()); @@ -118,6 +121,45 @@ private Long generateId() { assertThat(response.newBattles()).isEmpty(); } + @Test + @DisplayName("에디터픽만 있을때 제외목록이 정확하다") + void getHome_excludes_only_editor_pick_ids() { + TodayBattleResponse editorPick = battle("editor-only", BATTLE); + + when(noticeService.getActiveNotices(NoticePlacement.HOME_TOP, null, 1)).thenReturn(List.of()); + when(battleService.getEditorPicks()).thenReturn(List.of(editorPick)); + when(battleService.getTrendingBattles()).thenReturn(List.of()); + when(battleService.getBestBattles()).thenReturn(List.of()); + when(battleService.getTodayPicks(VOTE)).thenReturn(List.of()); + when(battleService.getTodayPicks(QUIZ)).thenReturn(List.of()); + when(battleService.getNewBattles(List.of(editorPick.battleId()))).thenReturn(List.of()); + + homeService.getHome(); + + verify(battleService).getNewBattles(List.of(editorPick.battleId())); + } + + @Test + @DisplayName("공지가 여러개여도 newNotice는 true이다") + void getHome_newNotice_true_with_multiple_notices() { + NoticeSummaryResponse notice1 = new NoticeSummaryResponse( + generateId(), "notice1", "body1", null, + NoticePlacement.HOME_TOP, true, LocalDateTime.now().minusDays(1), null + ); + + when(noticeService.getActiveNotices(NoticePlacement.HOME_TOP, null, 1)).thenReturn(List.of(notice1)); + when(battleService.getEditorPicks()).thenReturn(List.of()); + when(battleService.getTrendingBattles()).thenReturn(List.of()); + when(battleService.getBestBattles()).thenReturn(List.of()); + when(battleService.getTodayPicks(VOTE)).thenReturn(List.of()); + when(battleService.getTodayPicks(QUIZ)).thenReturn(List.of()); + when(battleService.getNewBattles(List.of())).thenReturn(List.of()); + + var response = homeService.getHome(); + + assertThat(response.newNotice()).isTrue(); + } + private TodayBattleResponse battle(String title, BattleType type) { return new TodayBattleResponse( generateId(), diff --git a/src/test/java/com/swyp/app/domain/notice/service/NoticeServiceTest.java b/src/test/java/com/swyp/app/domain/notice/service/NoticeServiceTest.java index b503994..6f5d196 100644 --- a/src/test/java/com/swyp/app/domain/notice/service/NoticeServiceTest.java +++ b/src/test/java/com/swyp/app/domain/notice/service/NoticeServiceTest.java @@ -5,6 +5,7 @@ import com.swyp.app.domain.notice.enums.NoticeType; import com.swyp.app.domain.notice.repository.NoticeRepository; import com.swyp.app.global.common.exception.CustomException; +import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.extension.ExtendWith; import org.mockito.InjectMocks; @@ -32,7 +33,8 @@ class NoticeServiceTest { private NoticeService noticeService; @Test - void getNoticeList_활성공지_목록을_개수와_함께_반환한다() { + @DisplayName("활성공지 목록을 개수와 함께 반환한다") + void getNoticeList_returns_active_notices_with_count() { Notice notice = Notice.builder() .title("공지") .body("내용") @@ -54,7 +56,8 @@ class NoticeServiceTest { } @Test - void getNoticeDetail_활성공지가_없으면_예외를_던진다() { + @DisplayName("활성공지가 없으면 예외를 던진다") + void getNoticeDetail_throws_when_no_active_notice() { Long noticeId = 1L; when(noticeRepository.findActiveById(eq(noticeId), any(LocalDateTime.class))).thenReturn(Optional.empty()); diff --git a/src/test/java/com/swyp/app/domain/user/service/CreditServiceTest.java b/src/test/java/com/swyp/app/domain/user/service/CreditServiceTest.java new file mode 100644 index 0000000..a82f810 --- /dev/null +++ b/src/test/java/com/swyp/app/domain/user/service/CreditServiceTest.java @@ -0,0 +1,105 @@ +package com.swyp.app.domain.user.service; + +import com.swyp.app.domain.user.entity.CreditHistory; +import com.swyp.app.domain.user.entity.TierCode; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.enums.CreditType; +import com.swyp.app.domain.user.repository.CreditHistoryRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.ArgumentCaptor; +import org.mockito.InjectMocks; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; +import org.springframework.dao.DataIntegrityViolationException; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +class CreditServiceTest { + + @Mock + private CreditHistoryRepository creditHistoryRepository; + + @Mock + private UserService userService; + + @InjectMocks + private CreditService creditService; + + @Test + @DisplayName("현재 로그인 유저에게 기본 크레딧을 적립한다") + void addCredit_forCurrentUser_savesDefaultAmount() { + User user = org.mockito.Mockito.mock(User.class); + when(user.getId()).thenReturn(1L); + when(userService.findCurrentUser()).thenReturn(user); + + creditService.addCredit(CreditType.BATTLE_VOTE, 10L); + + ArgumentCaptor captor = ArgumentCaptor.forClass(CreditHistory.class); + verify(creditHistoryRepository).saveAndFlush(captor.capture()); + + CreditHistory saved = captor.getValue(); + assertThat(saved.getUserId()).isEqualTo(1L); + assertThat(saved.getCreditType()).isEqualTo(CreditType.BATTLE_VOTE); + assertThat(saved.getAmount()).isEqualTo(CreditType.BATTLE_VOTE.getDefaultAmount()); + assertThat(saved.getReferenceId()).isEqualTo(10L); + } + + @Test + @DisplayName("referenceId가 없으면 적립을 거부한다") + void addCredit_withoutReferenceId_throwsException() { + assertThatThrownBy(() -> creditService.addCredit(1L, CreditType.BATTLE_VOTE, 10, null)) + .isInstanceOf(CustomException.class) + .extracting("errorCode") + .isEqualTo(ErrorCode.CREDIT_REFERENCE_REQUIRED); + + verify(creditHistoryRepository, never()).saveAndFlush(any()); + } + + @Test + @DisplayName("중복 적립 충돌이면 조용히 무시한다") + void addCredit_duplicateInsert_ignoresConflict() { + when(creditHistoryRepository.saveAndFlush(any(CreditHistory.class))) + .thenThrow(new DataIntegrityViolationException("duplicate")); + when(creditHistoryRepository.existsByUserIdAndCreditTypeAndReferenceId(1L, CreditType.BATTLE_VOTE, 10L)) + .thenReturn(true); + + creditService.addCredit(1L, CreditType.BATTLE_VOTE, 10, 10L); + + verify(creditHistoryRepository).existsByUserIdAndCreditTypeAndReferenceId(1L, CreditType.BATTLE_VOTE, 10L); + } + + @Test + @DisplayName("중복이 아닌 데이터 무결성 오류는 그대로 던진다") + void addCredit_nonDuplicateIntegrityFailure_rethrows() { + when(creditHistoryRepository.saveAndFlush(any(CreditHistory.class))) + .thenThrow(new DataIntegrityViolationException("broken")); + when(creditHistoryRepository.existsByUserIdAndCreditTypeAndReferenceId(1L, CreditType.BATTLE_VOTE, 10L)) + .thenReturn(false); + + assertThatThrownBy(() -> creditService.addCredit(1L, CreditType.BATTLE_VOTE, 10, 10L)) + .isInstanceOf(CustomException.class) + .extracting("errorCode") + .isEqualTo(ErrorCode.CREDIT_SAVE_FAILED); + } + + @Test + @DisplayName("누적 포인트로 티어를 계산한다") + void getTier_returnsTierFromTotalPoints() { + when(creditHistoryRepository.sumAmountByUserId(eq(1L))).thenReturn(2_500); + + TierCode tier = creditService.getTier(1L); + + assertThat(tier).isEqualTo(TierCode.SAGE); + } +} diff --git a/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java b/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java new file mode 100644 index 0000000..617a27b --- /dev/null +++ b/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java @@ -0,0 +1,450 @@ +package com.swyp.app.domain.user.service; + +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.battle.enums.BattleOptionLabel; +import com.swyp.app.domain.battle.enums.BattleStatus; +import com.swyp.app.domain.battle.enums.BattleType; +import com.swyp.app.domain.battle.service.BattleQueryService; +import com.swyp.app.domain.notice.dto.response.NoticeSummaryResponse; +import com.swyp.app.domain.notice.enums.NoticePlacement; +import com.swyp.app.domain.notice.enums.NoticeType; +import com.swyp.app.domain.notice.service.NoticeService; +import com.swyp.app.domain.perspective.entity.Perspective; +import com.swyp.app.domain.perspective.entity.PerspectiveComment; +import com.swyp.app.domain.perspective.entity.PerspectiveLike; +import com.swyp.app.domain.perspective.service.PerspectiveQueryService; +import com.swyp.app.domain.user.dto.request.UpdateNotificationSettingsRequest; +import com.swyp.app.domain.user.dto.response.BattleRecordListResponse; +import com.swyp.app.domain.user.dto.response.ContentActivityListResponse; +import com.swyp.app.domain.user.dto.response.MypageResponse; +import com.swyp.app.domain.user.dto.response.NoticeDetailResponse; +import com.swyp.app.domain.user.dto.response.NoticeListResponse; +import com.swyp.app.domain.user.dto.response.NotificationSettingsResponse; +import com.swyp.app.domain.user.dto.response.RecapResponse; +import com.swyp.app.domain.user.dto.response.UserSummary; +import com.swyp.app.domain.user.entity.ActivityType; +import com.swyp.app.domain.user.entity.CharacterType; +import com.swyp.app.domain.user.entity.PhilosopherType; +import com.swyp.app.domain.user.entity.TierCode; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.entity.UserProfile; +import com.swyp.app.domain.user.entity.UserRole; +import com.swyp.app.domain.user.entity.UserSettings; +import com.swyp.app.domain.user.entity.UserStatus; +import com.swyp.app.domain.user.entity.UserTendencyScore; +import com.swyp.app.domain.user.entity.VoteSide; +import com.swyp.app.domain.vote.entity.Vote; +import com.swyp.app.domain.vote.service.VoteQueryService; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.InjectMocks; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; +import org.springframework.test.util.ReflectionTestUtils; + +import java.math.BigDecimal; +import java.time.LocalDateTime; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.concurrent.atomic.AtomicLong; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +class MypageServiceTest { + + @Mock + private UserService userService; + @Mock + private NoticeService noticeService; + @Mock + private CreditService creditService; + @Mock + private VoteQueryService voteQueryService; + @Mock + private BattleQueryService battleQueryService; + @Mock + private PerspectiveQueryService perspectiveQueryService; + + @InjectMocks + private MypageService mypageService; + + private final AtomicLong idGenerator = new AtomicLong(100L); + + private Long generateId() { + return idGenerator.getAndIncrement(); + } + + @Test + @DisplayName("프로필, 철학자, 티어 정보를 반환한다") + void getMypage_returns_profile_philosopher_tier() { + User user = createUser(1L, "myTag"); + UserProfile profile = createProfile(user, "nick", CharacterType.OWL); + + when(userService.findCurrentUser()).thenReturn(user); + when(userService.findUserProfile(1L)).thenReturn(profile); + when(creditService.getTotalPoints(1L)).thenReturn(0); + + MypageResponse response = mypageService.getMypage(); + + assertThat(response.profile().userTag()).isEqualTo("myTag"); + assertThat(response.profile().nickname()).isEqualTo("nick"); + assertThat(response.profile().characterType()).isEqualTo(CharacterType.OWL); + assertThat(response.profile().mannerTemperature()).isEqualByComparingTo(BigDecimal.valueOf(36.5)); + assertThat(response.philosopher().philosopherType()).isEqualTo(PhilosopherType.SOCRATES); + assertThat(response.tier().tierCode()).isEqualTo(TierCode.WANDERER); + assertThat(response.tier().currentPoint()).isZero(); + } + + @Test + @DisplayName("철학자카드와 성향점수와 선호보고서를 반환한다") + void getRecap_returns_cards_scores_report() { + User user = createUser(1L, "tag"); + UserTendencyScore score = UserTendencyScore.builder() + .user(user) + .principle(10).reason(20).individual(30) + .change(40).inner(50).ideal(60) + .build(); + + when(userService.findCurrentUser()).thenReturn(user); + when(userService.findUserTendencyScore(1L)).thenReturn(score); + when(voteQueryService.countTotalParticipation(1L)).thenReturn(15L); + when(voteQueryService.countOpinionChanges(1L)).thenReturn(3L); + when(voteQueryService.calculateBattleWinRate(1L)).thenReturn(70); + + List battleIds = List.of(generateId()); + when(voteQueryService.findParticipatedBattleIds(1L)).thenReturn(battleIds); + + LinkedHashMap topTags = new LinkedHashMap<>(); + topTags.put("정치", 5L); + topTags.put("경제", 3L); + when(battleQueryService.getTopTagsByBattleIds(battleIds, 4)).thenReturn(topTags); + + RecapResponse response = mypageService.getRecap(); + + assertThat(response.myCard().philosopherType()).isEqualTo(PhilosopherType.SOCRATES); + assertThat(response.bestMatchCard().philosopherType()).isEqualTo(PhilosopherType.PLATO); + assertThat(response.worstMatchCard().philosopherType()).isEqualTo(PhilosopherType.MARX); + assertThat(response.scores().principle()).isEqualTo(10); + assertThat(response.scores().ideal()).isEqualTo(60); + assertThat(response.preferenceReport().totalParticipation()).isEqualTo(15); + assertThat(response.preferenceReport().opinionChanges()).isEqualTo(3); + assertThat(response.preferenceReport().battleWinRate()).isEqualTo(70); + assertThat(response.preferenceReport().favoriteTopics()).hasSize(2); + assertThat(response.preferenceReport().favoriteTopics().get(0).tagName()).isEqualTo("정치"); + } + + @Test + @DisplayName("투표이력이 없으면 선호보고서가 0값이다") + void getRecap_returns_zero_report_when_no_votes() { + User user = createUser(1L, "tag"); + UserTendencyScore score = UserTendencyScore.builder() + .user(user) + .principle(0).reason(0).individual(0) + .change(0).inner(0).ideal(0) + .build(); + + when(userService.findCurrentUser()).thenReturn(user); + when(userService.findUserTendencyScore(1L)).thenReturn(score); + when(voteQueryService.countTotalParticipation(1L)).thenReturn(0L); + when(voteQueryService.countOpinionChanges(1L)).thenReturn(0L); + when(voteQueryService.calculateBattleWinRate(1L)).thenReturn(0); + when(voteQueryService.findParticipatedBattleIds(1L)).thenReturn(List.of()); + when(battleQueryService.getTopTagsByBattleIds(List.of(), 4)).thenReturn(new LinkedHashMap<>()); + + RecapResponse response = mypageService.getRecap(); + + assertThat(response.preferenceReport().totalParticipation()).isZero(); + assertThat(response.preferenceReport().opinionChanges()).isZero(); + assertThat(response.preferenceReport().battleWinRate()).isZero(); + assertThat(response.preferenceReport().favoriteTopics()).isEmpty(); + } + + @Test + @DisplayName("투표기록을 페이지네이션하여 반환한다") + void getBattleRecords_returns_paginated_records() { + User user = createUser(1L, "tag"); + Battle battle = createBattle("배틀 제목"); + BattleOption optionA = createOption(battle, BattleOptionLabel.A); + Vote vote = Vote.builder() + .userId(1L) + .battle(battle) + .preVoteOption(optionA) + .build(); + ReflectionTestUtils.setField(vote, "id", generateId()); + ReflectionTestUtils.setField(vote, "createdAt", LocalDateTime.now()); + + when(userService.findCurrentUser()).thenReturn(user); + when(voteQueryService.findUserVotes(1L, 0, 2, null)).thenReturn(List.of(vote)); + when(voteQueryService.countUserVotes(1L, null)).thenReturn(5L); + + BattleRecordListResponse response = mypageService.getBattleRecords(0, 2, null); + + assertThat(response.items()).hasSize(1); + assertThat(response.items().get(0).voteSide()).isEqualTo(VoteSide.PRO); + assertThat(response.hasNext()).isTrue(); + assertThat(response.nextOffset()).isEqualTo(2); + } + + @Test + @DisplayName("다음페이지가 없으면 hasNext가 false이다") + void getBattleRecords_returns_no_next_when_last_page() { + User user = createUser(1L, "tag"); + Battle battle = createBattle("제목"); + BattleOption optionA = createOption(battle, BattleOptionLabel.A); + Vote vote = Vote.builder() + .userId(1L) + .battle(battle) + .preVoteOption(optionA) + .build(); + ReflectionTestUtils.setField(vote, "id", generateId()); + ReflectionTestUtils.setField(vote, "createdAt", LocalDateTime.now()); + + when(userService.findCurrentUser()).thenReturn(user); + when(voteQueryService.findUserVotes(1L, 0, 20, null)).thenReturn(List.of(vote)); + when(voteQueryService.countUserVotes(1L, null)).thenReturn(1L); + + BattleRecordListResponse response = mypageService.getBattleRecords(null, null, null); + + assertThat(response.hasNext()).isFalse(); + assertThat(response.nextOffset()).isNull(); + } + + @Test + @DisplayName("voteSide 필터가 적용된다") + void getBattleRecords_applies_vote_side_filter() { + User user = createUser(1L, "tag"); + + when(userService.findCurrentUser()).thenReturn(user); + when(voteQueryService.findUserVotes(1L, 0, 20, BattleOptionLabel.A)).thenReturn(List.of()); + when(voteQueryService.countUserVotes(1L, BattleOptionLabel.A)).thenReturn(0L); + + mypageService.getBattleRecords(null, null, VoteSide.PRO); + + verify(voteQueryService).findUserVotes(eq(1L), eq(0), eq(20), eq(BattleOptionLabel.A)); + } + + @Test + @DisplayName("COMMENT 타입으로 댓글활동을 반환한다") + void getContentActivities_returns_comments() { + User user = createUser(1L, "tag"); + Long battleId = generateId(); + Long optionId = generateId(); + Perspective perspective = Perspective.builder() + .battleId(battleId) + .userId(1L) + .optionId(optionId) + .content("관점 내용") + .build(); + ReflectionTestUtils.setField(perspective, "id", generateId()); + + PerspectiveComment comment = PerspectiveComment.builder() + .perspective(perspective) + .userId(1L) + .content("댓글") + .build(); + ReflectionTestUtils.setField(comment, "id", generateId()); + ReflectionTestUtils.setField(comment, "createdAt", LocalDateTime.now()); + + Battle battle = createBattle("배틀"); + ReflectionTestUtils.setField(battle, "id", battleId); + BattleOption option = createOption(battle, BattleOptionLabel.A); + ReflectionTestUtils.setField(option, "id", optionId); + + when(userService.findCurrentUser()).thenReturn(user); + when(perspectiveQueryService.findUserComments(1L, 0, 20)).thenReturn(List.of(comment)); + when(perspectiveQueryService.countUserComments(1L)).thenReturn(1L); + when(battleQueryService.findBattlesByIds(List.of(battleId))).thenReturn(Map.of(battleId, battle)); + when(battleQueryService.findOptionsByIds(List.of(optionId))).thenReturn(Map.of(optionId, option)); + when(userService.findSummaryById(1L)).thenReturn(new UserSummary("tag", "nick", "OWL")); + + ContentActivityListResponse response = mypageService.getContentActivities(null, null, ActivityType.COMMENT); + + assertThat(response.items()).hasSize(1); + assertThat(response.items().get(0).activityType()).isEqualTo(ActivityType.COMMENT); + assertThat(response.items().get(0).content()).isEqualTo("댓글"); + } + + @Test + @DisplayName("LIKE 타입으로 좋아요활동을 반환한다") + void getContentActivities_returns_likes() { + User user = createUser(1L, "tag"); + Long battleId = generateId(); + Long optionId = generateId(); + Perspective perspective = Perspective.builder() + .battleId(battleId) + .userId(1L) + .optionId(optionId) + .content("관점 내용") + .build(); + ReflectionTestUtils.setField(perspective, "id", generateId()); + + PerspectiveLike like = PerspectiveLike.builder() + .perspective(perspective) + .userId(1L) + .build(); + ReflectionTestUtils.setField(like, "id", generateId()); + ReflectionTestUtils.setField(like, "createdAt", LocalDateTime.now()); + + Battle battle = createBattle("배틀"); + ReflectionTestUtils.setField(battle, "id", battleId); + BattleOption option = createOption(battle, BattleOptionLabel.B); + ReflectionTestUtils.setField(option, "id", optionId); + + when(userService.findCurrentUser()).thenReturn(user); + when(perspectiveQueryService.findUserLikes(1L, 0, 20)).thenReturn(List.of(like)); + when(perspectiveQueryService.countUserLikes(1L)).thenReturn(1L); + when(battleQueryService.findBattlesByIds(List.of(battleId))).thenReturn(Map.of(battleId, battle)); + when(battleQueryService.findOptionsByIds(List.of(optionId))).thenReturn(Map.of(optionId, option)); + when(userService.findSummaryById(1L)).thenReturn(new UserSummary("tag", "nick", "OWL")); + + ContentActivityListResponse response = mypageService.getContentActivities(null, null, ActivityType.LIKE); + + assertThat(response.items()).hasSize(1); + assertThat(response.items().get(0).activityType()).isEqualTo(ActivityType.LIKE); + } + + @Test + @DisplayName("알림설정을 반환한다") + void getNotificationSettings_returns_settings() { + User user = createUser(1L, "tag"); + UserSettings settings = UserSettings.builder() + .user(user) + .newBattleEnabled(true) + .battleResultEnabled(false) + .commentReplyEnabled(true) + .newCommentEnabled(true) + .contentLikeEnabled(false) + .marketingEventEnabled(false) + .build(); + + when(userService.findCurrentUser()).thenReturn(user); + when(userService.findUserSettings(1L)).thenReturn(settings); + + NotificationSettingsResponse response = mypageService.getNotificationSettings(); + + assertThat(response.newBattleEnabled()).isTrue(); + assertThat(response.battleResultEnabled()).isFalse(); + assertThat(response.commentReplyEnabled()).isTrue(); + assertThat(response.newCommentEnabled()).isTrue(); + assertThat(response.contentLikeEnabled()).isFalse(); + assertThat(response.marketingEventEnabled()).isFalse(); + } + + @Test + @DisplayName("설정을 업데이트하고 반환한다") + void updateNotificationSettings_updates_and_returns() { + User user = createUser(1L, "tag"); + UserSettings settings = UserSettings.builder() + .user(user) + .newBattleEnabled(false) + .battleResultEnabled(false) + .commentReplyEnabled(false) + .newCommentEnabled(false) + .contentLikeEnabled(false) + .marketingEventEnabled(false) + .build(); + + when(userService.findCurrentUser()).thenReturn(user); + when(userService.findUserSettings(1L)).thenReturn(settings); + + UpdateNotificationSettingsRequest request = new UpdateNotificationSettingsRequest( + true, null, true, null, null, true + ); + + NotificationSettingsResponse response = mypageService.updateNotificationSettings(request); + + assertThat(response.newBattleEnabled()).isTrue(); + assertThat(response.battleResultEnabled()).isFalse(); + assertThat(response.commentReplyEnabled()).isTrue(); + assertThat(response.marketingEventEnabled()).isTrue(); + } + + @Test + @DisplayName("공지사항 목록을 반환한다") + void getNotices_returns_notice_list() { + NoticeSummaryResponse notice = new NoticeSummaryResponse( + 1L, "공지 제목", "본문", + NoticeType.ANNOUNCEMENT, NoticePlacement.NOTICE_BOARD, + true, LocalDateTime.now().minusDays(1), null + ); + + when(noticeService.getActiveNotices(NoticePlacement.NOTICE_BOARD, NoticeType.ANNOUNCEMENT, null)) + .thenReturn(List.of(notice)); + + NoticeListResponse response = mypageService.getNotices(NoticeType.ANNOUNCEMENT); + + assertThat(response.items()).hasSize(1); + assertThat(response.items().get(0).title()).isEqualTo("공지 제목"); + assertThat(response.items().get(0).isPinned()).isTrue(); + } + + @Test + @DisplayName("공지사항 상세를 반환한다") + void getNoticeDetail_returns_notice_detail() { + Long noticeId = 1L; + com.swyp.app.domain.notice.dto.response.NoticeDetailResponse noticeDetail = + new com.swyp.app.domain.notice.dto.response.NoticeDetailResponse( + noticeId, "상세 제목", "상세 본문", + NoticeType.EVENT, NoticePlacement.NOTICE_BOARD, + false, LocalDateTime.now(), null, LocalDateTime.now() + ); + + when(noticeService.getNoticeDetail(noticeId)).thenReturn(noticeDetail); + + NoticeDetailResponse response = mypageService.getNoticeDetail(noticeId); + + assertThat(response.noticeId()).isEqualTo(noticeId); + assertThat(response.title()).isEqualTo("상세 제목"); + assertThat(response.type()).isEqualTo(NoticeType.EVENT); + assertThat(response.isPinned()).isFalse(); + } + + private User createUser(Long id, String userTag) { + User user = User.builder() + .userTag(userTag) + .nickname("nickname") + .role(UserRole.USER) + .status(UserStatus.ACTIVE) + .build(); + ReflectionTestUtils.setField(user, "id", id); + return user; + } + + private UserProfile createProfile(User user, String nickname, CharacterType characterType) { + return UserProfile.builder() + .user(user) + .nickname(nickname) + .characterType(characterType) + .mannerTemperature(BigDecimal.valueOf(36.5)) + .build(); + } + + private Battle createBattle(String title) { + Battle battle = Battle.builder() + .title(title) + .summary("summary") + .type(BattleType.BATTLE) + .status(BattleStatus.PUBLISHED) + .build(); + ReflectionTestUtils.setField(battle, "id", generateId()); + return battle; + } + + private BattleOption createOption(Battle battle, BattleOptionLabel label) { + BattleOption option = BattleOption.builder() + .battle(battle) + .label(label) + .title(label.name()) + .stance("stance-" + label.name()) + .build(); + ReflectionTestUtils.setField(option, "id", generateId()); + return option; + } +} diff --git a/src/test/java/com/swyp/app/domain/user/service/UserServiceTest.java b/src/test/java/com/swyp/app/domain/user/service/UserServiceTest.java new file mode 100644 index 0000000..56d530f --- /dev/null +++ b/src/test/java/com/swyp/app/domain/user/service/UserServiceTest.java @@ -0,0 +1,191 @@ +package com.swyp.app.domain.user.service; + +import com.swyp.app.domain.user.dto.request.UpdateUserProfileRequest; +import com.swyp.app.domain.user.dto.response.MyProfileResponse; +import com.swyp.app.domain.user.dto.response.UserSummary; +import com.swyp.app.domain.user.entity.CharacterType; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.entity.UserProfile; +import com.swyp.app.domain.user.entity.UserRole; +import com.swyp.app.domain.user.entity.UserSettings; +import com.swyp.app.domain.user.entity.UserStatus; +import com.swyp.app.domain.user.entity.UserTendencyScore; +import com.swyp.app.domain.user.repository.UserProfileRepository; +import com.swyp.app.domain.user.repository.UserRepository; +import com.swyp.app.domain.user.repository.UserSettingsRepository; +import com.swyp.app.domain.user.repository.UserTendencyScoreRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.InjectMocks; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; +import org.springframework.test.util.ReflectionTestUtils; + +import java.math.BigDecimal; +import java.util.Optional; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +class UserServiceTest { + + @Mock + private UserRepository userRepository; + @Mock + private UserProfileRepository userProfileRepository; + @Mock + private UserSettingsRepository userSettingsRepository; + @Mock + private UserTendencyScoreRepository userTendencyScoreRepository; + + @InjectMocks + private UserService userService; + + @Test + @DisplayName("가장 최근 사용자를 반환한다") + void findCurrentUser_returns_latest_user() { + User user = createUser(1L, "testTag"); + when(userRepository.findTopByOrderByIdDesc()).thenReturn(Optional.of(user)); + + User result = userService.findCurrentUser(); + + assertThat(result.getUserTag()).isEqualTo("testTag"); + } + + @Test + @DisplayName("사용자가 없으면 예외를 던진다") + void findCurrentUser_throws_when_no_user() { + when(userRepository.findTopByOrderByIdDesc()).thenReturn(Optional.empty()); + + assertThatThrownBy(() -> userService.findCurrentUser()) + .isInstanceOf(CustomException.class) + .satisfies(ex -> assertThat(((CustomException) ex).getErrorCode()).isEqualTo(ErrorCode.USER_NOT_FOUND)); + } + + @Test + @DisplayName("사용자 요약정보를 반환한다") + void findSummaryById_returns_user_summary() { + User user = createUser(1L, "summaryTag"); + UserProfile profile = createProfile(user, "nick", CharacterType.OWL); + + when(userRepository.findById(1L)).thenReturn(Optional.of(user)); + when(userProfileRepository.findById(1L)).thenReturn(Optional.of(profile)); + + UserSummary summary = userService.findSummaryById(1L); + + assertThat(summary.userTag()).isEqualTo("summaryTag"); + assertThat(summary.nickname()).isEqualTo("nick"); + assertThat(summary.characterType()).isEqualTo("OWL"); + } + + @Test + @DisplayName("존재하지 않는 사용자의 요약정보 조회 시 예외를 던진다") + void findSummaryById_throws_when_not_found() { + when(userRepository.findById(999L)).thenReturn(Optional.empty()); + + assertThatThrownBy(() -> userService.findSummaryById(999L)) + .isInstanceOf(CustomException.class) + .satisfies(ex -> assertThat(((CustomException) ex).getErrorCode()).isEqualTo(ErrorCode.USER_NOT_FOUND)); + } + + @Test + @DisplayName("닉네임과 캐릭터를 수정한다") + void updateMyProfile_updates_nickname_and_character() { + User user = createUser(1L, "myTag"); + UserProfile profile = createProfile(user, "oldNick", CharacterType.OWL); + + when(userRepository.findTopByOrderByIdDesc()).thenReturn(Optional.of(user)); + when(userProfileRepository.findById(1L)).thenReturn(Optional.of(profile)); + + UpdateUserProfileRequest request = new UpdateUserProfileRequest("newNick", CharacterType.FOX); + MyProfileResponse response = userService.updateMyProfile(request); + + assertThat(response.userTag()).isEqualTo("myTag"); + assertThat(response.nickname()).isEqualTo("newNick"); + assertThat(response.characterType()).isEqualTo(CharacterType.FOX); + } + + @Test + @DisplayName("프로필을 반환한다") + void findUserProfile_returns_profile() { + User user = createUser(1L, "tag"); + UserProfile profile = createProfile(user, "nick", CharacterType.BEAR); + + when(userProfileRepository.findById(1L)).thenReturn(Optional.of(profile)); + + UserProfile result = userService.findUserProfile(1L); + + assertThat(result.getNickname()).isEqualTo("nick"); + assertThat(result.getCharacterType()).isEqualTo(CharacterType.BEAR); + } + + @Test + @DisplayName("설정을 반환한다") + void findUserSettings_returns_settings() { + User user = createUser(1L, "tag"); + UserSettings settings = UserSettings.builder() + .user(user) + .newBattleEnabled(true) + .battleResultEnabled(false) + .commentReplyEnabled(true) + .newCommentEnabled(false) + .contentLikeEnabled(true) + .marketingEventEnabled(false) + .build(); + + when(userSettingsRepository.findById(1L)).thenReturn(Optional.of(settings)); + + UserSettings result = userService.findUserSettings(1L); + + assertThat(result.isNewBattleEnabled()).isTrue(); + assertThat(result.isBattleResultEnabled()).isFalse(); + } + + @Test + @DisplayName("성향점수를 반환한다") + void findUserTendencyScore_returns_score() { + User user = createUser(1L, "tag"); + UserTendencyScore score = UserTendencyScore.builder() + .user(user) + .principle(10) + .reason(20) + .individual(30) + .change(40) + .inner(50) + .ideal(60) + .build(); + + when(userTendencyScoreRepository.findById(1L)).thenReturn(Optional.of(score)); + + UserTendencyScore result = userService.findUserTendencyScore(1L); + + assertThat(result.getPrinciple()).isEqualTo(10); + assertThat(result.getReason()).isEqualTo(20); + assertThat(result.getIdeal()).isEqualTo(60); + } + + private User createUser(Long id, String userTag) { + User user = User.builder() + .userTag(userTag) + .nickname("nickname") + .role(UserRole.USER) + .status(UserStatus.ACTIVE) + .build(); + ReflectionTestUtils.setField(user, "id", id); + return user; + } + + private UserProfile createProfile(User user, String nickname, CharacterType characterType) { + return UserProfile.builder() + .user(user) + .nickname(nickname) + .characterType(characterType) + .mannerTemperature(BigDecimal.valueOf(36.5)) + .build(); + } +} From fccaeba0c80cca4f0e1d45c86bea317b45d00311 Mon Sep 17 00:00:00 2001 From: Youwol <153346797+si-zero@users.noreply.github.com> Date: Sat, 28 Mar 2026 16:27:22 +0900 Subject: [PATCH 28/70] =?UTF-8?q?#60=20[Feat]=20AdMob=20=EA=B8=B0=EB=8A=A5?= =?UTF-8?q?=20=EB=B0=8F=20SSV=20=EA=B2=80=EC=A6=9D=20=EB=A1=9C=EC=A7=81=20?= =?UTF-8?q?=EC=B6=94=EA=B0=80=20(#61)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## #️⃣ 연관된 이슈 - #60 ## 📝 작업 내용 ### ✨ Feat | 내용 | 파일 | |------|------| | AdMob 보상 광고 서명 검증(SSV) 컨트롤러 구현 | `AdMobRewardController.java` | | 보상 지급 로직 및 멱등성(중복 방지) 처리 서비스 구현 | `AdMobRewardServiceImpl.java` | | 보상 상태 값(OK, Already Processed) 관리를 위한 Enum 추가 | `AdRewardStatus.java` | | 보상 요청 및 응답 전용 DTO 설계 | `AdMobRewardRequest.java`, `AdMobRewardResponse.java` | | 보상 지급 이력 관리를 위한 엔티티 및 레포지토리 구축 | `AdRewardHistory.java`, `AdRewardHistoryRepository.java` | | Google Tink 기반 서명 검증 빈(Bean) 설정 | `AdMobConfig.java` | ### ♻️ Refactor | 내용 | 파일 | |------|------| | `build.gradle` 내 AdMob SSV 관련 의존성 및 저장소 설정 최적화 | `build.gradle` | | 단위 테스트 내 불필요한 Stubbing 제거 및 검증 로직 정규화 | `AdMobRewardServiceTest.java` | ### 🐛 Fix | 내용 | 파일 | |------|------| | 테스트 환경의 'Cannot resolve symbol android' 참조 오류 수정 | `build.gradle` | | Mockito Strict Stubbing 정책 위반으로 인한 테스트 실패 해결 | `AdMobRewardServiceTest.java` | ## 📌 공유 사항 > 1. @yaeunjess 예은님, 프론트엔드 작업하시면서 실제 시그니처 값 받아서 테스트가 더 필요해보입니다! 작업할 때, 알려주세요! 2. 그리고, 지금 보상 타입 부분인 `reward_item` 부분 `ITEM`, `POINT` 아니면 오류뜨게 해놨는데 오류 말고 기본값을 부여할지도 궁금합니다. ## ✅ 체크리스트 - [x] Reviewer에 팀원들을 선택했나요? - [x] Assignees에 본인을 선택했나요? - [x] 컨벤션에 맞는 Type을 선택했나요? - [x] Development에 이슈를 연동했나요? - [x] Merge 하려는 브랜치가 올바르게 설정되어 있나요? - [x] 컨벤션을 지키고 있나요? - [x] 로컬에서 실행했을 때 에러가 발생하지 않나요? - [x] 팀원들에게 PR 링크 공유를 했나요? ## 📸 스크린샷 > 성공 스크린샷 2026-03-27 오후 8 08 31 > 응답만 성공 (같은 사용자가 같은 광고를 봤을 때) 스크린샷 2026-03-27 오후 8 08 45 > 에러: 유저 스크린샷 2026-03-27 오후 8 08 57 > 에러: 보상 타입 스크린샷 2026-03-27 오후 8 09 12 > 에러: 시그니처(서명) 검증 오류 스크린샷 2026-03-27 오후 9 24 04 ## 💬 리뷰 요구사항 > 없음 --- build.gradle | 5 + docs/api-specs/reward-api.md | 136 ++++++++++++++++++ docs/erd/admob.puml | 29 ++++ .../controller/AdMobRewardController.java | 42 ++++++ .../dto/request/AdMobRewardRequest.java | 34 +++++ .../dto/response/AdMobRewardResponse.java | 23 +++ .../domain/reward/entity/AdRewardHistory.java | 36 +++++ .../app/domain/reward/enums/RewardItem.java | 18 +++ .../repository/AdRewardHistoryRepository.java | 19 +++ .../reward/service/AdMobRewardService.java | 11 ++ .../service/AdMobRewardServiceImpl.java | 87 +++++++++++ .../global/common/exception/ErrorCode.java | 7 +- .../swyp/app/global/config/AdMobConfig.java | 20 +++ .../service/AdMobRewardServiceTest.java | 89 ++++++++++++ 14 files changed, 555 insertions(+), 1 deletion(-) create mode 100644 docs/api-specs/reward-api.md create mode 100644 docs/erd/admob.puml create mode 100644 src/main/java/com/swyp/app/domain/reward/controller/AdMobRewardController.java create mode 100644 src/main/java/com/swyp/app/domain/reward/dto/request/AdMobRewardRequest.java create mode 100644 src/main/java/com/swyp/app/domain/reward/dto/response/AdMobRewardResponse.java create mode 100644 src/main/java/com/swyp/app/domain/reward/entity/AdRewardHistory.java create mode 100644 src/main/java/com/swyp/app/domain/reward/enums/RewardItem.java create mode 100644 src/main/java/com/swyp/app/domain/reward/repository/AdRewardHistoryRepository.java create mode 100644 src/main/java/com/swyp/app/domain/reward/service/AdMobRewardService.java create mode 100644 src/main/java/com/swyp/app/domain/reward/service/AdMobRewardServiceImpl.java create mode 100644 src/main/java/com/swyp/app/global/config/AdMobConfig.java create mode 100644 src/test/java/com/swyp/app/domain/reward/service/AdMobRewardServiceTest.java diff --git a/build.gradle b/build.gradle index 0b17ca9..f9cbebd 100644 --- a/build.gradle +++ b/build.gradle @@ -22,6 +22,7 @@ configurations { repositories { mavenCentral() + google() } dependencies { @@ -43,6 +44,10 @@ dependencies { // HTTP Client (소셜 API 호출용) implementation 'org.springframework.boot:spring-boot-starter-webflux' + // AdMob SSV 검증을 위한 Tink 라이브러리 + implementation 'com.google.crypto.tink:apps-rewardedads:1.9.1' + testImplementation 'com.google.crypto.tink:apps-rewardedads:1.9.1' + // Swagger implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.16' diff --git a/docs/api-specs/reward-api.md b/docs/api-specs/reward-api.md new file mode 100644 index 0000000..24b8a3f --- /dev/null +++ b/docs/api-specs/reward-api.md @@ -0,0 +1,136 @@ +# 보상(Reward) API 명세서 + +## 1. 설계 메모 + +- AdMob의 **SSV(Server-Side Verification)** 콜백 수신을 위한 API입니다. +- 모든 필드명은 AdMob 가이드라인에 따라 `snake_case`를 사용합니다. +- **중복 지급 방지**: `transaction_id`를 고유 식별자로 사용하여 동일 요청 재유입 시 차단(Idempotency)합니다. +- **유저 식별**: `custom_data` 필드에 담긴 값을 내부 `user_id`로 매핑하여 처리합니다. +- **타입 검증**: `reward_item` 값은 내부 `RewardType` Enum과 매핑하며, 정의되지 않은 값(예: "123")은 에러 처리합니다. +- **데이터 보존**: 보상 요청의 성공 이력을 `ad_reward_history` 테이블에 적재합니다. + +--- + +## 2. AdMob 보상 콜백 API + +### 2.1 `GET /api/v1/admob/reward` + +광고 시청 완료 후 구글 서버에서 보내는 보상 지급 콜백 수신. + +**쿼리 파라미터:** + +| Parameter | Type | Required | 설명 | +|-----------|:----:|:---:|------| +| `ad_unit_id` | `String` | Y | 광고 단위 ID | +| `custom_data` | `String` | Y | 유저 식별자 (내부 User ID) | +| `reward_amount` | `int` | Y | 보상 수량 | +| `reward_item` | `String` | Y | 보상 아이템 이름 (e.g., "POINT") | +| `timestamp` | `long` | Y | 요청 생성 시간 | +| `transaction_id` | `String` | Y | **중복 방지용 고유 ID** | +| `signature` | `String` | N | 검증용 서명 | +| `key_id` | `String` | N | 검증용 공개키 ID | + +**응답 (성공):** + +```json +{ + "statusCode": 200, + "data": { + "reward_status": "OK" + } +} +``` + +**응답 (중복 요청 시):** + +```JSON + +{ + "statusCode": 200, + "data": { + "reward_status": "Already Processed" + } +} +``` + +--- + +## 3. 내 보상 이력 API + +### 3.1 GET /api/v1/me/rewards/history + +로그인한 사용자의 보상 획득 이력 조회.쿼리 파라미터 + +```JSON +{ + "statusCode": 200, + "data": { + "items": [ + { + "history_id": 105, + "reward_type": "POINT", + "reward_amount": 100, + "transaction_id": "unique_trans_id_20260327_001", + "created_at": "2026-03-27T18:00:00Z" + } + ], + "next_cursor": 104 + }, + "error": null + } +``` + +## 4. 에러 코드 + +### 4.1 보상 관련 에러 코드 + +### 🚨 보상 API 에러 응답 JSON 샘플 + +**1. 유저를 찾을 수 없을 때 (REWARD_INVALID_USER)** +- 상황: `custom_data`로 넘어온 ID가 DB에 없는 유저일 경우 +```json +{ + "statusCode": 404, + "data": null, + "error": { + "code": "REWARD_INVALID_USER", + "message": "해당 유저를 찾을 수 없습니다. (custom_data: 1)" + } +} +``` + +**2. 잘못된 보상 타입일 때 (REWARD_INVALID_TYPE)** +- 상황: `reward_item`에 Enum에 정의되지 않은 값(예: "123")이 들어온 경우 +```json +{ + "statusCode": 400, + "data": null, + "error": { + "code": "REWARD_INVALID_TYPE", + "message": "지원하지 않는 reward_item 타입입니다. (입력값: 123)" + } +} +``` + +**3. 서명 검증 실패 시 (REWARD_VERIFICATION_FAILED)** +- 상황: AdMob이 보낸 `signature`가 올바르지 않아 위변조가 의심될 경우 +```json +{ + "statusCode": 401, + "data": null, + "error": { + "code": "REWARD_INVALID_SIGNATURE", + "message": "AdMob 서명 검증에 실패하였습니다. 요청의 유효성을 확인하세요." + } +} +``` +--- + +## 공통 에러 코드 + +| Error Code | HTTP Status | 설명 | +|------------|:-----------:|-------------------------------------| +| `REWARD_INVALID_USER` | `404` | custom_data에 해당하는 유저가 존재하지 않음 | +| `REWARD_INVALID_TYPE` | `400` | 지원하지 않는 reward_item 타입 (Enum 미매칭) | +| `REWARD_INVALID_SIGNATURE` | `401` | AdMob 서명(Signature) 검증 실패 또는 위변조 의심 | +--- \ No newline at end of file diff --git a/docs/erd/admob.puml b/docs/erd/admob.puml new file mode 100644 index 0000000..a14df6b --- /dev/null +++ b/docs/erd/admob.puml @@ -0,0 +1,29 @@ +@startuml +!theme plain +skinparam Linetype ortho + +' 1. 서비스 사용자 참조 +entity "users" { + * id : LONG <> + -- + user_tag : VARCHAR(30) <> + status : ENUM('PENDING', 'ACTIVE', 'DELETED', 'BANNED') + created_at : TIMESTAMP + updated_at : TIMESTAMP +} + +' 2. 사용자 광고 이력 테이블 +entity "ad_reward_history" { + * id : LONG <> + -- + user_id : LONG <> + transaction_id : VARCHAR(255) UNIQUE + reward_amount : INT NOT NULL + reward_type : enum('POINT', 'ITEM') + created_at : TIMESTAMP +} + +' 관계 설정 +users ||--o{ ad_reward_history : "사용자 보상 이력" + +@enduml diff --git a/src/main/java/com/swyp/app/domain/reward/controller/AdMobRewardController.java b/src/main/java/com/swyp/app/domain/reward/controller/AdMobRewardController.java new file mode 100644 index 0000000..7082acc --- /dev/null +++ b/src/main/java/com/swyp/app/domain/reward/controller/AdMobRewardController.java @@ -0,0 +1,42 @@ +package com.swyp.app.domain.reward.controller; + +import com.swyp.app.domain.reward.dto.request.AdMobRewardRequest; +import com.swyp.app.domain.reward.dto.response.AdMobRewardResponse; +import com.swyp.app.domain.reward.service.AdMobRewardService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springdoc.core.annotations.ParameterObject; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.ModelAttribute; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RestController; + +@Slf4j +@Tag(name = "보상 (Reward)", description = "AdMob 광고 보상 관련 API") +@RestController +@RequestMapping("/api/v1/admob") +@RequiredArgsConstructor +public class AdMobRewardController { + + private final AdMobRewardService rewardService; + + /** + * // 1. AdMob SSV 콜백 수신 엔드포인트 + * 호출 경로: GET /api/v1/admob/reward + */ + @Operation(summary = "AdMob 보상 콜백 수신") + @GetMapping("/reward") + public ApiResponse handleAdMobReward( + @ParameterObject @ModelAttribute AdMobRewardRequest request) { + log.info("AdMob SSV 콜백 수신: transaction_id={}", request.transaction_id()); + + // 서비스에서 "OK" 또는 "Already Processed" 수신 + String status = rewardService.processReward(request); + + // DTO로 감싸서 반환 (명세서의 data { "reward_status": "..." } 구조 완성) + return ApiResponse.onSuccess(AdMobRewardResponse.from(status)); + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/reward/dto/request/AdMobRewardRequest.java b/src/main/java/com/swyp/app/domain/reward/dto/request/AdMobRewardRequest.java new file mode 100644 index 0000000..02b36a5 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/reward/dto/request/AdMobRewardRequest.java @@ -0,0 +1,34 @@ +package com.swyp.app.domain.reward.dto.request; + +import com.swyp.app.domain.reward.enums.RewardItem; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; + +public record AdMobRewardRequest( + String ad_unit_id, + String custom_data, + int reward_amount, + String reward_item, + long timestamp, + String transaction_id, + String signature, + String key_id +) { + // 구글이 보낸 유저 데이터를 우리 데이터베이스에서 찾기 위해 메소드 추가 + public Long getUserId() { + try { + return Long.parseLong(this.custom_data); + } catch (NumberFormatException e) { + throw new CustomException(ErrorCode.REWARD_INVALID_USER); + } + } + + // 실제 우리가 제공하는 보상 유형이랑 동일한지 확인 enum에서! + public RewardItem getRewardType() { + try { + return RewardItem.valueOf(this.reward_item.toUpperCase()); + } catch (IllegalArgumentException | NullPointerException e) { + throw new CustomException(ErrorCode.REWARD_INVALID_TYPE); + } + } +} diff --git a/src/main/java/com/swyp/app/domain/reward/dto/response/AdMobRewardResponse.java b/src/main/java/com/swyp/app/domain/reward/dto/response/AdMobRewardResponse.java new file mode 100644 index 0000000..3eafa79 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/reward/dto/response/AdMobRewardResponse.java @@ -0,0 +1,23 @@ +package com.swyp.app.domain.reward.dto.response; + +import io.swagger.v3.oas.annotations.media.Schema; +import lombok.AccessLevel; +import lombok.AllArgsConstructor; +import lombok.Builder; +import lombok.Getter; + +@Getter +@Builder +@AllArgsConstructor(access = AccessLevel.PRIVATE) +@Schema(description = "AdMob 보상 처리 결과 응답") +public class AdMobRewardResponse { + + @Schema(description = "처리 결과 코드 (OK, Already Processed)", example = "OK") + private final String reward_status; + + public static AdMobRewardResponse from(String status) { + return AdMobRewardResponse.builder() + .reward_status(status) + .build(); + } +} diff --git a/src/main/java/com/swyp/app/domain/reward/entity/AdRewardHistory.java b/src/main/java/com/swyp/app/domain/reward/entity/AdRewardHistory.java new file mode 100644 index 0000000..b77c943 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/reward/entity/AdRewardHistory.java @@ -0,0 +1,36 @@ +package com.swyp.app.domain.reward.entity; + +import com.swyp.app.domain.reward.enums.RewardItem; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.*; +import lombok.*; + +@Entity +@Getter +@Table(name = "ad_reward_history") +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class AdRewardHistory extends BaseEntity { + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id", nullable = false) + private User user; + + @Column(name = "transaction_id", unique = true, nullable = false) + private String transactionId; + + @Column(name = "reward_amount", nullable = false) + private int rewardAmount; + + @Enumerated(EnumType.STRING) + @Column(name = "reward_item", nullable = false) + private RewardItem rewardItem; + + @Builder + public AdRewardHistory(User user, String transactionId, int rewardAmount, RewardItem rewardItem) { + this.user = user; + this.transactionId = transactionId; + this.rewardAmount = rewardAmount; + this.rewardItem = rewardItem; + } +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/reward/enums/RewardItem.java b/src/main/java/com/swyp/app/domain/reward/enums/RewardItem.java new file mode 100644 index 0000000..f04a2dd --- /dev/null +++ b/src/main/java/com/swyp/app/domain/reward/enums/RewardItem.java @@ -0,0 +1,18 @@ +package com.swyp.app.domain.reward.enums; + +import lombok.Getter; +import lombok.RequiredArgsConstructor; + +@Getter +@RequiredArgsConstructor +public enum RewardItem { + POINT, ITEM; + + public static RewardItem from(String value) { + for (RewardItem type : RewardItem.values()) { + if (type.name().equalsIgnoreCase(value)) return type; + } + + throw new IllegalArgumentException("REWARD_INVALID_TYPE"); + } +} diff --git a/src/main/java/com/swyp/app/domain/reward/repository/AdRewardHistoryRepository.java b/src/main/java/com/swyp/app/domain/reward/repository/AdRewardHistoryRepository.java new file mode 100644 index 0000000..7f95fef --- /dev/null +++ b/src/main/java/com/swyp/app/domain/reward/repository/AdRewardHistoryRepository.java @@ -0,0 +1,19 @@ +package com.swyp.app.domain.reward.repository; + +import com.swyp.app.domain.reward.entity.AdRewardHistory; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.stereotype.Repository; + +@Repository +public interface AdRewardHistoryRepository extends JpaRepository { + + /** + * 1. 중복 보상 지급 방지를 위한 검증 메서드 + * @param transactionId 구글에서 보낸 고유 트랜잭션 ID + * @return 존재하면 true, 없으면 false + */ + + // transactionId는 한 광고의 시청 영수증 번호라고 생각해주세요! + boolean existsByTransactionId(String transactionId); + +} diff --git a/src/main/java/com/swyp/app/domain/reward/service/AdMobRewardService.java b/src/main/java/com/swyp/app/domain/reward/service/AdMobRewardService.java new file mode 100644 index 0000000..e54f62b --- /dev/null +++ b/src/main/java/com/swyp/app/domain/reward/service/AdMobRewardService.java @@ -0,0 +1,11 @@ +package com.swyp.app.domain.reward.service; + +import com.swyp.app.domain.reward.dto.request.AdMobRewardRequest; + +// 서비스를 인터페이스로 분리하면 서비스를 변경할 때, Impl 파일만 수정하면 됨! +// 테스트 코드 짜기 용이! +public interface AdMobRewardService { + + String processReward(AdMobRewardRequest request); + +} diff --git a/src/main/java/com/swyp/app/domain/reward/service/AdMobRewardServiceImpl.java b/src/main/java/com/swyp/app/domain/reward/service/AdMobRewardServiceImpl.java new file mode 100644 index 0000000..70114fa --- /dev/null +++ b/src/main/java/com/swyp/app/domain/reward/service/AdMobRewardServiceImpl.java @@ -0,0 +1,87 @@ +package com.swyp.app.domain.reward.service; + +import com.google.crypto.tink.apps.rewardedads.RewardedAdsVerifier; +import com.swyp.app.domain.reward.dto.request.AdMobRewardRequest; +import com.swyp.app.domain.reward.entity.AdRewardHistory; +import com.swyp.app.domain.reward.repository.AdRewardHistoryRepository; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.repository.UserRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import jakarta.transaction.Transactional; +import java.security.GeneralSecurityException; +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.stereotype.Service; + +@Slf4j +@Service +@RequiredArgsConstructor +public class AdMobRewardServiceImpl implements AdMobRewardService { + + private final RewardedAdsVerifier rewardedAdsVerifier; + private final AdRewardHistoryRepository adRewardHistoryRepository; + private final UserRepository userRepository; + + @Override + @Transactional + public String processReward(AdMobRewardRequest request) { + // 2. 서명 검증 (구글이 보낸 진짜 신호인지 확인) + if (!verifyAdMobSignature(request)) { + log.warn("AdMob 서명 검증 실패: transaction_id={}", request.transaction_id()); + throw new CustomException(ErrorCode.REWARD_INVALID_SIGNATURE); + } + + // 3. 중복 처리 방지 (멱등성 유지) + if (adRewardHistoryRepository.existsByTransactionId(request.transaction_id())) { + log.info("이미 처리된 광고 요청입니다: transaction_id={}", request.transaction_id()); + return "Already Processed"; + } + + // 4. 유저 존재 여부 확인 (DTO의 getUserId 활용) + User user = userRepository.findById(request.getUserId()) + .orElseThrow(() -> new CustomException(ErrorCode.REWARD_INVALID_USER)); + + // 5. 보상 이력 저장 (영수증 남기기) + AdRewardHistory history = AdRewardHistory.builder() + .transactionId(request.transaction_id()) + .user(user) + .rewardAmount(request.reward_amount()) + .rewardItem(request.getRewardType()) + .build(); + + adRewardHistoryRepository.save(history); + + // 6. TODO: 작업 중인 포인트 합산 로직 호출 지점 + // user.addPoint(request.reward_amount()); + + log.info("보상 지급 완료: user={}, amount={}", user.getId(), request.reward_amount()); + return "OK"; + } + + /** + * Google Tink를 이용한 SSV 서명 검증 로직 + */ + private boolean verifyAdMobSignature(AdMobRewardRequest request) { + try { + // signature와 key_id까지 모두 포함된 전체 쿼리 스트링을 만듭니다. + // (구글이 우리 서버에 쏜 URL의 뒷부분 전체라고 보시면 됩니다.) + String fullQueryString = String.format( + "ad_unit_id=%s&custom_data=%s&reward_amount=%d&reward_item=%s×tamp=%d&transaction_id=%s&signature=%s&key_id=%s", + request.ad_unit_id(), request.custom_data(), request.reward_amount(), + request.reward_item(), request.timestamp(), request.transaction_id(), + request.signature(), request.key_id() + ); + + rewardedAdsVerifier.verify(fullQueryString); + return true; + + } catch (GeneralSecurityException e) { + log.error("AdMob 서명 검증 실패: {}", e.getMessage()); + return false; + } catch (Exception e) { + log.error("검증 중 알 수 없는 오류: {}", e.getMessage()); + return false; + } + } +} diff --git a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java index 5b895f1..553116a 100644 --- a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java +++ b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java @@ -84,7 +84,12 @@ public enum ErrorCode { VOTE_ALREADY_SUBMITTED(HttpStatus.CONFLICT, "VOTE_409_SUB", "이미 투표가 완료되었습니다."), INVALID_VOTE_STATUS (HttpStatus.BAD_REQUEST, "VOTE_400_INV", "사전 투표를 진행해야 하거나, 이미 사후 투표가 완료되었습니다."), PRE_VOTE_REQUIRED (HttpStatus.CONFLICT, "VOTE_409_PRE", "사전 투표가 필요합니다."), - POST_VOTE_REQUIRED (HttpStatus.CONFLICT, "VOTE_409_PST", "사후 투표가 필요합니다."); + POST_VOTE_REQUIRED (HttpStatus.CONFLICT, "VOTE_409_PST", "사후 투표가 필요합니다."), + + // Reward + REWARD_INVALID_USER(HttpStatus.NOT_FOUND, "REWARD_404", "해당 유저를 찾을 수 없습니다."), + REWARD_INVALID_TYPE(HttpStatus.BAD_REQUEST, "REWARD_400", "지원하지 않는 보상 아이템 타입입니다."), + REWARD_INVALID_SIGNATURE(HttpStatus.UNAUTHORIZED, "REWARD_401", "AdMob 서명 검증에 실패하였습니다."); private final HttpStatus httpStatus; private final String code; diff --git a/src/main/java/com/swyp/app/global/config/AdMobConfig.java b/src/main/java/com/swyp/app/global/config/AdMobConfig.java new file mode 100644 index 0000000..8653a7f --- /dev/null +++ b/src/main/java/com/swyp/app/global/config/AdMobConfig.java @@ -0,0 +1,20 @@ +package com.swyp.app.global.config; + +import com.google.crypto.tink.apps.rewardedads.RewardedAdsVerifier; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration +public class AdMobConfig { + + @Bean + public RewardedAdsVerifier rewardedAdsVerifier() { + try { + return new RewardedAdsVerifier.Builder() + .setVerifyingPublicKeys("https://www.gstatic.com/admob/reward/verifier-keys.json") + .build(); + } catch (Exception e) { + throw new RuntimeException("AdMob Verifier 초기화 실패!", e); + } + } +} \ No newline at end of file diff --git a/src/test/java/com/swyp/app/domain/reward/service/AdMobRewardServiceTest.java b/src/test/java/com/swyp/app/domain/reward/service/AdMobRewardServiceTest.java new file mode 100644 index 0000000..cfdf56b --- /dev/null +++ b/src/test/java/com/swyp/app/domain/reward/service/AdMobRewardServiceTest.java @@ -0,0 +1,89 @@ +package com.swyp.app.domain.reward.service; + +import com.google.crypto.tink.apps.rewardedads.RewardedAdsVerifier; +import com.swyp.app.domain.reward.dto.request.AdMobRewardRequest; +import com.swyp.app.domain.reward.entity.AdRewardHistory; +import com.swyp.app.domain.reward.repository.AdRewardHistoryRepository; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.repository.UserRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.InjectMocks; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; + +import java.security.GeneralSecurityException; +import java.util.Optional; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.BDDMockito.given; +import static org.mockito.Mockito.*; + +@ExtendWith(MockitoExtension.class) +class AdMobRewardServiceTest { + + @InjectMocks + private AdMobRewardServiceImpl rewardService; + + @Mock + private AdRewardHistoryRepository adRewardHistoryRepository; + + @Mock + private UserRepository userRepository; + + @Mock + private RewardedAdsVerifier rewardedAdsVerifier; + + @Test + @DisplayName("1. 정상적인 광고 시청 시 보상 이력이 저장되고 OK를 반환한다.") + void processReward_Success() throws Exception { + // given + AdMobRewardRequest request = createSampleRequest("unique-id"); + User mockUser = mock(User.class); + + given(adRewardHistoryRepository.existsByTransactionId(request.transaction_id())).willReturn(false); + doNothing().when(rewardedAdsVerifier).verify(anyString()); + given(userRepository.findById(1L)).willReturn(Optional.of(mockUser)); + + // when + String result = rewardService.processReward(request); + + // then + assertThat(result).isEqualTo("OK"); + verify(adRewardHistoryRepository, times(1)).save(any(AdRewardHistory.class)); + } + + @Test + @DisplayName("2. 서명 검증에 실패하면 REWARD_INVALID_SIGNATURE 예외가 발생한다.") + void processReward_InvalidSignature() throws Exception { + // given + AdMobRewardRequest request = createSampleRequest("trans-id"); + + // // 1. 불필요한 existsByTransactionId 스터빙 제거 (만약 서비스에서 검증을 먼저 한다면 호출 안 될 수 있음) + // // 만약 호출이 반드시 일어난다면 아래 주석을 풀고 사용하세요. + lenient().when(adRewardHistoryRepository.existsByTransactionId(anyString())).thenReturn(false); + + // // 2. 서명 검증 실패 시뮬레이션 + doThrow(new GeneralSecurityException("Invalid signature")) + .when(rewardedAdsVerifier).verify(anyString()); + + // when & then + assertThatThrownBy(() -> rewardService.processReward(request)) + .isInstanceOf(CustomException.class) + .hasFieldOrPropertyWithValue("errorCode", ErrorCode.REWARD_INVALID_SIGNATURE); + + verify(adRewardHistoryRepository, never()).save(any()); + } + + private AdMobRewardRequest createSampleRequest(String transId) { + return new AdMobRewardRequest( + "ad-unit-123", "1", 100, "POINT", 123456789L, + transId, "sig-123", "key-123" + ); + } +} \ No newline at end of file From b7f9fe7b3288508d9a46645e64987b084cf8b3ca Mon Sep 17 00:00:00 2001 From: Dante0922 <101305519+Dante0922@users.noreply.github.com> Date: Sat, 28 Mar 2026 23:13:04 +0900 Subject: [PATCH 29/70] =?UTF-8?q?#64=20[Feat]=20Home/MyPage/Search=20?= =?UTF-8?q?=ED=83=AD=20=EA=B0=9C=EC=84=A0=20(#65)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Summary - S3 Presigned URL 인프라 구축 및 홈 API 응답 구조를 섹션별 전용 DTO로 리팩토링 - 철학자·캐릭터 enum에 이미지 매핑(imageKey, label) 추가 및 정규화 - 마이페이지 철학자 유형 산출 로직 구현 (최초 5회 투표 → PHILOSOPHER 태그 기반 자동 산출·저장) - PhilosopherType 확장: typeName, description, bestMatch/worstMatch, 6축 고정 성향 점수 - 탐색 탭 배틀 검색 API 신설 (`GET /api/v1/search/battles`) — 카테고리 필터, 인기순/최신순 정렬, offset 페이지네이션 ## Changes - **홈 API**: `HomeResponse`를 6개 섹션별 DTO로 분리 (EditorPick, Trending, BestBattle, TodayQuiz, TodayVote, NewBattle) - **S3**: `S3PresignedUrlService`, `S3Config` 신설, `FileUploadController` presigned URL 응답 추가 - **Enum**: `PhilosopherType` 10종 (label, typeName, description, bestMatch, worstMatch, 6축 점수, imageKey), `CharacterType` 8종 정규화 - **마이페이지**: `UserProfile.philosopherType` 필드 추가, `MypageService.resolvePhilosopherType()` 산출 로직 - **서치**: `search` 도메인 신설 (Controller, Service, DTO, Enum), `BattleRepository` 검색 쿼리 추가 ## Test plan - [x] `./gradlew build` 컴파일 확인 (contextLoads 제외 전 테스트 통과) - [ ] Swagger에서 홈 API 호출 → 섹션별 응답 확인 - [ ] Swagger에서 마이페이지 API → 철학자 유형 산출 확인 (5회 투표 후) - [ ] Swagger에서 탐색 API → 카테고리 필터/정렬 확인 Closes #64 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 4.6 --- .../battle/converter/BattleConverter.java | 8 +- .../dto/response/TodayBattleResponse.java | 9 +- .../battle/repository/BattleRepository.java | 18 +++ .../battle/service/BattleQueryService.java | 19 +++ .../dto/response/HomeBestBattleResponse.java | 15 ++ .../dto/response/HomeEditorPickResponse.java | 16 ++ ...sponse.java => HomeNewBattleResponse.java} | 19 ++- .../home/dto/response/HomeResponse.java | 14 +- .../dto/response/HomeTodayQuizResponse.java | 12 ++ ....java => HomeTodayVoteOptionResponse.java} | 7 +- .../dto/response/HomeTodayVoteResponse.java | 12 ++ .../dto/response/HomeTrendingResponse.java | 14 ++ .../app/domain/home/service/HomeService.java | 139 +++++++++++++----- .../search/controller/SearchController.java | 29 ++++ .../response/SearchBattleListResponse.java | 25 ++++ .../domain/search/enums/SearchSortType.java | 6 + .../domain/search/service/SearchService.java | 90 ++++++++++++ .../user/dto/response/MypageResponse.java | 8 +- .../user/dto/response/RecapResponse.java | 6 +- .../app/domain/user/entity/CharacterType.java | 40 +++-- .../user/entity/CharacterTypeConverter.java | 2 +- .../domain/user/entity/PhilosopherType.java | 102 +++++++++++-- .../app/domain/user/entity/UserProfile.java | 9 ++ .../domain/user/service/MypageService.java | 83 ++++++++--- .../vote/repository/VoteRepository.java | 4 + .../domain/vote/service/VoteQueryService.java | 7 + .../com/swyp/app/global/config/S3Config.java | 27 ++++ .../s3/controller/FileUploadController.java | 14 +- .../infra/s3/dto/FileUploadResponse.java | 4 + .../global/infra/s3/enums/FileCategory.java | 1 + .../s3/service/S3PresignedUrlService.java | 65 ++++++++ .../infra/s3/service/S3UploadServiceImpl.java | 8 +- src/main/resources/application.yml | 5 +- .../domain/home/service/HomeServiceTest.java | 82 ++++++----- .../user/service/MypageServiceTest.java | 53 +++---- 35 files changed, 778 insertions(+), 194 deletions(-) create mode 100644 src/main/java/com/swyp/app/domain/home/dto/response/HomeBestBattleResponse.java create mode 100644 src/main/java/com/swyp/app/domain/home/dto/response/HomeEditorPickResponse.java rename src/main/java/com/swyp/app/domain/home/dto/response/{HomeBattleResponse.java => HomeNewBattleResponse.java} (57%) create mode 100644 src/main/java/com/swyp/app/domain/home/dto/response/HomeTodayQuizResponse.java rename src/main/java/com/swyp/app/domain/home/dto/response/{HomeBattleOptionResponse.java => HomeTodayVoteOptionResponse.java} (67%) create mode 100644 src/main/java/com/swyp/app/domain/home/dto/response/HomeTodayVoteResponse.java create mode 100644 src/main/java/com/swyp/app/domain/home/dto/response/HomeTrendingResponse.java create mode 100644 src/main/java/com/swyp/app/domain/search/controller/SearchController.java create mode 100644 src/main/java/com/swyp/app/domain/search/dto/response/SearchBattleListResponse.java create mode 100644 src/main/java/com/swyp/app/domain/search/enums/SearchSortType.java create mode 100644 src/main/java/com/swyp/app/domain/search/service/SearchService.java create mode 100644 src/main/java/com/swyp/app/global/config/S3Config.java create mode 100644 src/main/java/com/swyp/app/global/infra/s3/dto/FileUploadResponse.java create mode 100644 src/main/java/com/swyp/app/global/infra/s3/service/S3PresignedUrlService.java diff --git a/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java b/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java index 3c7d63a..2cf1dd9 100644 --- a/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java +++ b/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java @@ -54,7 +54,13 @@ public TodayBattleResponse toTodayResponse(Battle b, List tags, List tags, // 상단 태그 리스트 - List options // 중앙 세로형 대결 카드 데이터 + List options, // 중앙 세로형 대결 카드 데이터 + // 퀴즈·투표 전용 필드 + String titlePrefix, // 투표 접두사 (예: "도덕의 기준은") + String titleSuffix, // 투표 접미사 (예: "이다") + String itemA, // 퀴즈 O 선택지 + String itemADesc, // 퀴즈 O 설명 + String itemB, // 퀴즈 X 선택지 + String itemBDesc // 퀴즈 X 설명 ) {} diff --git a/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java b/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java index eef4f44..4c888e0 100644 --- a/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java +++ b/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java @@ -54,4 +54,22 @@ public interface BattleRepository extends JpaRepository { // 기본 조회용 List findByTargetDateAndStatusAndDeletedAtIsNull(LocalDate date, BattleStatus status); + + // 탐색 탭: 전체 배틀 검색 (정렬은 Pageable Sort로 처리) + @Query("SELECT b FROM Battle b WHERE b.status = 'PUBLISHED' AND b.deletedAt IS NULL") + List searchAll(Pageable pageable); + + @Query("SELECT COUNT(b) FROM Battle b WHERE b.status = 'PUBLISHED' AND b.deletedAt IS NULL") + long countSearchAll(); + + // 탐색 탭: 카테고리 태그 필터 배틀 검색 + @Query("SELECT DISTINCT b FROM Battle b JOIN BattleTag bt ON bt.battle = b JOIN bt.tag t " + + "WHERE t.type = 'CATEGORY' AND t.name = :categoryName " + + "AND b.status = 'PUBLISHED' AND b.deletedAt IS NULL") + List searchByCategory(@Param("categoryName") String categoryName, Pageable pageable); + + @Query("SELECT COUNT(DISTINCT b) FROM Battle b JOIN BattleTag bt ON bt.battle = b JOIN bt.tag t " + + "WHERE t.type = 'CATEGORY' AND t.name = :categoryName " + + "AND b.status = 'PUBLISHED' AND b.deletedAt IS NULL") + long countSearchByCategory(@Param("categoryName") String categoryName); } \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/service/BattleQueryService.java b/src/main/java/com/swyp/app/domain/battle/service/BattleQueryService.java index e324144..1dc6d7b 100644 --- a/src/main/java/com/swyp/app/domain/battle/service/BattleQueryService.java +++ b/src/main/java/com/swyp/app/domain/battle/service/BattleQueryService.java @@ -10,8 +10,11 @@ import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; +import com.swyp.app.domain.tag.enums.TagType; + import java.util.List; import java.util.Map; +import java.util.Optional; import java.util.function.Function; import java.util.stream.Collectors; @@ -58,4 +61,20 @@ public Map getTopTagsByBattleIds(List battleIds, int limit) java.util.LinkedHashMap::new )); } + + public Optional getTopPhilosopherTagName(List battleIds) { + if (battleIds.isEmpty()) return Optional.empty(); + + List battleTags = battleTagRepository.findByBattleIdIn(battleIds); + + return battleTags.stream() + .filter(bt -> bt.getTag().getType() == TagType.PHILOSOPHER) + .collect(Collectors.groupingBy( + bt -> bt.getTag().getName(), + Collectors.counting() + )) + .entrySet().stream() + .max(Map.Entry.comparingByValue()) + .map(Map.Entry::getKey); + } } diff --git a/src/main/java/com/swyp/app/domain/home/dto/response/HomeBestBattleResponse.java b/src/main/java/com/swyp/app/domain/home/dto/response/HomeBestBattleResponse.java new file mode 100644 index 0000000..8568898 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/home/dto/response/HomeBestBattleResponse.java @@ -0,0 +1,15 @@ +package com.swyp.app.domain.home.dto.response; + +import com.swyp.app.domain.battle.dto.response.BattleTagResponse; + +import java.util.List; + +public record HomeBestBattleResponse( + Long battleId, + String philosopherA, + String philosopherB, + String title, + List tags, + Integer audioDuration, + Integer viewCount +) {} diff --git a/src/main/java/com/swyp/app/domain/home/dto/response/HomeEditorPickResponse.java b/src/main/java/com/swyp/app/domain/home/dto/response/HomeEditorPickResponse.java new file mode 100644 index 0000000..24862c7 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/home/dto/response/HomeEditorPickResponse.java @@ -0,0 +1,16 @@ +package com.swyp.app.domain.home.dto.response; + +import com.swyp.app.domain.battle.dto.response.BattleTagResponse; + +import java.util.List; + +public record HomeEditorPickResponse( + Long battleId, + String thumbnailUrl, + String optionATitle, + String optionBTitle, + String title, + String summary, + List tags, + Integer viewCount +) {} diff --git a/src/main/java/com/swyp/app/domain/home/dto/response/HomeBattleResponse.java b/src/main/java/com/swyp/app/domain/home/dto/response/HomeNewBattleResponse.java similarity index 57% rename from src/main/java/com/swyp/app/domain/home/dto/response/HomeBattleResponse.java rename to src/main/java/com/swyp/app/domain/home/dto/response/HomeNewBattleResponse.java index c00da9d..52e883b 100644 --- a/src/main/java/com/swyp/app/domain/home/dto/response/HomeBattleResponse.java +++ b/src/main/java/com/swyp/app/domain/home/dto/response/HomeNewBattleResponse.java @@ -1,20 +1,19 @@ package com.swyp.app.domain.home.dto.response; import com.swyp.app.domain.battle.dto.response.BattleTagResponse; -import com.swyp.app.domain.battle.enums.BattleType; import java.util.List; -public record HomeBattleResponse( +public record HomeNewBattleResponse( Long battleId, + String thumbnailUrl, String title, String summary, - String thumbnailUrl, - BattleType type, - Integer viewCount, - Long participantsCount, - Integer audioDuration, + String philosopherA, + String philosopherAImageUrl, + String philosopherB, + String philosopherBImageUrl, List tags, - List options -) { -} + Integer audioDuration, + Integer viewCount +) {} diff --git a/src/main/java/com/swyp/app/domain/home/dto/response/HomeResponse.java b/src/main/java/com/swyp/app/domain/home/dto/response/HomeResponse.java index 525680a..8aa1b67 100644 --- a/src/main/java/com/swyp/app/domain/home/dto/response/HomeResponse.java +++ b/src/main/java/com/swyp/app/domain/home/dto/response/HomeResponse.java @@ -4,10 +4,10 @@ public record HomeResponse( boolean newNotice, - List editorPicks, - List trendingBattles, - List bestBattles, - List todayPicks, - List newBattles -) { -} + List editorPicks, + List trendingBattles, + List bestBattles, + List todayQuizzes, + List todayVotes, + List newBattles +) {} diff --git a/src/main/java/com/swyp/app/domain/home/dto/response/HomeTodayQuizResponse.java b/src/main/java/com/swyp/app/domain/home/dto/response/HomeTodayQuizResponse.java new file mode 100644 index 0000000..00eb2b1 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/home/dto/response/HomeTodayQuizResponse.java @@ -0,0 +1,12 @@ +package com.swyp.app.domain.home.dto.response; + +public record HomeTodayQuizResponse( + Long battleId, + String title, + String summary, + Long participantsCount, + String itemA, + String itemADesc, + String itemB, + String itemBDesc +) {} diff --git a/src/main/java/com/swyp/app/domain/home/dto/response/HomeBattleOptionResponse.java b/src/main/java/com/swyp/app/domain/home/dto/response/HomeTodayVoteOptionResponse.java similarity index 67% rename from src/main/java/com/swyp/app/domain/home/dto/response/HomeBattleOptionResponse.java rename to src/main/java/com/swyp/app/domain/home/dto/response/HomeTodayVoteOptionResponse.java index b2ce088..0c3f73d 100644 --- a/src/main/java/com/swyp/app/domain/home/dto/response/HomeBattleOptionResponse.java +++ b/src/main/java/com/swyp/app/domain/home/dto/response/HomeTodayVoteOptionResponse.java @@ -2,8 +2,7 @@ import com.swyp.app.domain.battle.enums.BattleOptionLabel; -public record HomeBattleOptionResponse( +public record HomeTodayVoteOptionResponse( BattleOptionLabel label, - String text -) { -} + String title +) {} diff --git a/src/main/java/com/swyp/app/domain/home/dto/response/HomeTodayVoteResponse.java b/src/main/java/com/swyp/app/domain/home/dto/response/HomeTodayVoteResponse.java new file mode 100644 index 0000000..33fd5b1 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/home/dto/response/HomeTodayVoteResponse.java @@ -0,0 +1,12 @@ +package com.swyp.app.domain.home.dto.response; + +import java.util.List; + +public record HomeTodayVoteResponse( + Long battleId, + String titlePrefix, + String titleSuffix, + String summary, + Long participantsCount, + List options +) {} diff --git a/src/main/java/com/swyp/app/domain/home/dto/response/HomeTrendingResponse.java b/src/main/java/com/swyp/app/domain/home/dto/response/HomeTrendingResponse.java new file mode 100644 index 0000000..30d1a2a --- /dev/null +++ b/src/main/java/com/swyp/app/domain/home/dto/response/HomeTrendingResponse.java @@ -0,0 +1,14 @@ +package com.swyp.app.domain.home.dto.response; + +import com.swyp.app.domain.battle.dto.response.BattleTagResponse; + +import java.util.List; + +public record HomeTrendingResponse( + Long battleId, + String thumbnailUrl, + String title, + List tags, + Integer audioDuration, + Integer viewCount +) {} diff --git a/src/main/java/com/swyp/app/domain/home/service/HomeService.java b/src/main/java/com/swyp/app/domain/home/service/HomeService.java index 4919897..ee31bb8 100644 --- a/src/main/java/com/swyp/app/domain/home/service/HomeService.java +++ b/src/main/java/com/swyp/app/domain/home/service/HomeService.java @@ -1,20 +1,21 @@ package com.swyp.app.domain.home.service; +import com.swyp.app.domain.battle.dto.response.BattleTagResponse; import com.swyp.app.domain.battle.dto.response.TodayBattleResponse; import com.swyp.app.domain.battle.dto.response.TodayOptionResponse; +import com.swyp.app.domain.battle.enums.BattleOptionLabel; import com.swyp.app.domain.battle.enums.BattleType; +import com.swyp.app.domain.tag.enums.TagType; import com.swyp.app.domain.battle.service.BattleService; -import com.swyp.app.domain.home.dto.response.HomeBattleOptionResponse; -import com.swyp.app.domain.home.dto.response.HomeBattleResponse; -import com.swyp.app.domain.home.dto.response.HomeResponse; +import com.swyp.app.domain.home.dto.response.*; import com.swyp.app.domain.notice.enums.NoticePlacement; import com.swyp.app.domain.notice.service.NoticeService; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; -import java.util.ArrayList; import java.util.List; +import java.util.Optional; @Service @RequiredArgsConstructor @@ -29,59 +30,119 @@ public class HomeService { public HomeResponse getHome() { boolean newNotice = !noticeService.getActiveNotices(NoticePlacement.HOME_TOP, null, NOTICE_EXISTS_LIMIT).isEmpty(); - List editorPicks = toHomeBattles(battleService.getEditorPicks()); - List trendingBattles = toHomeBattles(battleService.getTrendingBattles()); - List bestBattles = toHomeBattles(battleService.getBestBattles()); + List editorPickRaw = battleService.getEditorPicks(); + List trendingRaw = battleService.getTrendingBattles(); + List bestRaw = battleService.getBestBattles(); + List voteRaw = battleService.getTodayPicks(BattleType.VOTE); + List quizRaw = battleService.getTodayPicks(BattleType.QUIZ); - List todayPicks = new ArrayList<>(); - todayPicks.addAll(toHomeBattles(battleService.getTodayPicks(BattleType.VOTE))); - todayPicks.addAll(toHomeBattles(battleService.getTodayPicks(BattleType.QUIZ))); - - List excludeIds = collectBattleIds(editorPicks, trendingBattles, bestBattles, todayPicks); - List newBattles = toHomeBattles(battleService.getNewBattles(excludeIds)); + List excludeIds = collectBattleIds(editorPickRaw, trendingRaw, bestRaw, voteRaw, quizRaw); + List newRaw = battleService.getNewBattles(excludeIds); return new HomeResponse( newNotice, - editorPicks, - trendingBattles, - bestBattles, - todayPicks, - newBattles + editorPickRaw.stream().map(this::toEditorPick).toList(), + trendingRaw.stream().map(this::toTrending).toList(), + bestRaw.stream().map(this::toBestBattle).toList(), + quizRaw.stream().map(this::toTodayQuiz).toList(), + voteRaw.stream().map(this::toTodayVote).toList(), + newRaw.stream().map(this::toNewBattle).toList() + ); + } + + private HomeEditorPickResponse toEditorPick(TodayBattleResponse b) { + String optionA = findOptionTitle(b.options(), BattleOptionLabel.A); + String optionB = findOptionTitle(b.options(), BattleOptionLabel.B); + return new HomeEditorPickResponse( + b.battleId(), b.thumbnailUrl(), + optionA, optionB, + b.title(), b.summary(), + b.tags(), b.viewCount() + ); + } + + private HomeTrendingResponse toTrending(TodayBattleResponse b) { + return new HomeTrendingResponse( + b.battleId(), b.thumbnailUrl(), + b.title(), b.tags(), + b.audioDuration(), b.viewCount() + ); + } + + private HomeBestBattleResponse toBestBattle(TodayBattleResponse b) { + List philosophers = findPhilosopherNames(b.tags()); + String philoA = philosophers.size() > 0 ? philosophers.get(0) : null; + String philoB = philosophers.size() > 1 ? philosophers.get(1) : null; + return new HomeBestBattleResponse( + b.battleId(), + philoA, philoB, + b.title(), b.tags(), + b.audioDuration(), b.viewCount() ); } - private List toHomeBattles(List battles) { - return battles.stream() - .map(this::toHomeBattle) + private HomeTodayQuizResponse toTodayQuiz(TodayBattleResponse b) { + return new HomeTodayQuizResponse( + b.battleId(), b.title(), b.summary(), + b.participantsCount(), + b.itemA(), b.itemADesc(), + b.itemB(), b.itemBDesc() + ); + } + + private HomeTodayVoteResponse toTodayVote(TodayBattleResponse b) { + List options = b.options().stream() + .map(o -> new HomeTodayVoteOptionResponse(o.label(), o.title())) .toList(); + return new HomeTodayVoteResponse( + b.battleId(), + b.titlePrefix(), b.titleSuffix(), + b.summary(), b.participantsCount(), + options + ); } - private HomeBattleResponse toHomeBattle(TodayBattleResponse battle) { - return new HomeBattleResponse( - battle.battleId(), - battle.title(), - battle.summary(), - battle.thumbnailUrl(), - battle.type(), - battle.viewCount(), - battle.participantsCount(), - battle.audioDuration(), - battle.tags(), - battle.options().stream() - .map(this::toHomeOption) - .toList() + private HomeNewBattleResponse toNewBattle(TodayBattleResponse b) { + List philosophers = findPhilosopherNames(b.tags()); + String philoA = philosophers.size() > 0 ? philosophers.get(0) : null; + String philoB = philosophers.size() > 1 ? philosophers.get(1) : null; + String imageA = findOptionImageUrl(b.options(), BattleOptionLabel.A); + String imageB = findOptionImageUrl(b.options(), BattleOptionLabel.B); + return new HomeNewBattleResponse( + b.battleId(), b.thumbnailUrl(), + b.title(), b.summary(), + philoA, imageA, + philoB, imageB, + b.tags(), b.audioDuration(), b.viewCount() ); } - private HomeBattleOptionResponse toHomeOption(TodayOptionResponse option) { - return new HomeBattleOptionResponse(option.label(), option.title()); + private String findOptionTitle(List options, BattleOptionLabel label) { + return Optional.ofNullable(options).orElse(List.of()).stream() + .filter(o -> o.label() == label) + .map(TodayOptionResponse::title) + .findFirst().orElse(null); + } + + private List findPhilosopherNames(List tags) { + return Optional.ofNullable(tags).orElse(List.of()).stream() + .filter(t -> t.type() == TagType.PHILOSOPHER) + .map(BattleTagResponse::name) + .toList(); + } + + private String findOptionImageUrl(List options, BattleOptionLabel label) { + return Optional.ofNullable(options).orElse(List.of()).stream() + .filter(o -> o.label() == label) + .map(TodayOptionResponse::imageUrl) + .findFirst().orElse(null); } @SafeVarargs - private List collectBattleIds(List... groups) { + private List collectBattleIds(List... groups) { return List.of(groups).stream() .flatMap(List::stream) - .map(HomeBattleResponse::battleId) + .map(TodayBattleResponse::battleId) .distinct() .toList(); } diff --git a/src/main/java/com/swyp/app/domain/search/controller/SearchController.java b/src/main/java/com/swyp/app/domain/search/controller/SearchController.java new file mode 100644 index 0000000..e3468ed --- /dev/null +++ b/src/main/java/com/swyp/app/domain/search/controller/SearchController.java @@ -0,0 +1,29 @@ +package com.swyp.app.domain.search.controller; + +import com.swyp.app.domain.search.dto.response.SearchBattleListResponse; +import com.swyp.app.domain.search.enums.SearchSortType; +import com.swyp.app.domain.search.service.SearchService; +import com.swyp.app.global.common.response.ApiResponse; +import lombok.RequiredArgsConstructor; +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; + +@RestController +@RequiredArgsConstructor +@RequestMapping("/api/v1/search") +public class SearchController { + + private final SearchService searchService; + + @GetMapping("/battles") + public ApiResponse searchBattles( + @RequestParam(required = false) String category, + @RequestParam(required = false) SearchSortType sort, + @RequestParam(required = false) Integer offset, + @RequestParam(required = false) Integer size + ) { + return ApiResponse.onSuccess(searchService.searchBattles(category, sort, offset, size)); + } +} diff --git a/src/main/java/com/swyp/app/domain/search/dto/response/SearchBattleListResponse.java b/src/main/java/com/swyp/app/domain/search/dto/response/SearchBattleListResponse.java new file mode 100644 index 0000000..bb5b768 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/search/dto/response/SearchBattleListResponse.java @@ -0,0 +1,25 @@ +package com.swyp.app.domain.search.dto.response; + +import com.swyp.app.domain.battle.dto.response.BattleTagResponse; +import com.swyp.app.domain.battle.enums.BattleType; + +import java.util.List; + +public record SearchBattleListResponse( + List items, + Integer nextOffset, + boolean hasNext +) { + + public record SearchBattleItem( + Long battleId, + String thumbnailUrl, + BattleType type, + String title, + String summary, + List tags, + Integer audioDuration, + Integer viewCount + ) { + } +} diff --git a/src/main/java/com/swyp/app/domain/search/enums/SearchSortType.java b/src/main/java/com/swyp/app/domain/search/enums/SearchSortType.java new file mode 100644 index 0000000..e0ace4a --- /dev/null +++ b/src/main/java/com/swyp/app/domain/search/enums/SearchSortType.java @@ -0,0 +1,6 @@ +package com.swyp.app.domain.search.enums; + +public enum SearchSortType { + POPULAR, + LATEST +} diff --git a/src/main/java/com/swyp/app/domain/search/service/SearchService.java b/src/main/java/com/swyp/app/domain/search/service/SearchService.java new file mode 100644 index 0000000..713442c --- /dev/null +++ b/src/main/java/com/swyp/app/domain/search/service/SearchService.java @@ -0,0 +1,90 @@ +package com.swyp.app.domain.search.service; + +import com.swyp.app.domain.battle.dto.response.BattleTagResponse; +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleTag; +import com.swyp.app.domain.battle.repository.BattleRepository; +import com.swyp.app.domain.battle.repository.BattleTagRepository; +import com.swyp.app.domain.search.dto.response.SearchBattleListResponse; +import com.swyp.app.domain.search.enums.SearchSortType; +import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.PageRequest; +import org.springframework.data.domain.Pageable; +import org.springframework.data.domain.Sort; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class SearchService { + + private static final int DEFAULT_PAGE_SIZE = 20; + + private final BattleRepository battleRepository; + private final BattleTagRepository battleTagRepository; + + public SearchBattleListResponse searchBattles(String category, SearchSortType sort, Integer offset, Integer size) { + int pageOffset = offset == null || offset < 0 ? 0 : offset; + int pageSize = size == null || size <= 0 ? DEFAULT_PAGE_SIZE : size; + SearchSortType sortType = sort == null ? SearchSortType.POPULAR : sort; + + Sort pageSort = sortType == SearchSortType.LATEST + ? Sort.by(Sort.Direction.DESC, "createdAt") + : Sort.by(Sort.Direction.DESC, "viewCount"); + Pageable pageable = PageRequest.of(pageOffset / pageSize, pageSize, pageSort); + + List battles; + long totalCount; + + if (category == null || category.isBlank()) { + battles = battleRepository.searchAll(pageable); + totalCount = battleRepository.countSearchAll(); + } else { + battles = battleRepository.searchByCategory(category, pageable); + totalCount = battleRepository.countSearchByCategory(category); + } + + Map> tagMap = loadTagMap(battles); + + List items = battles.stream() + .map(battle -> new SearchBattleListResponse.SearchBattleItem( + battle.getId(), + battle.getThumbnailUrl(), + battle.getType(), + battle.getTitle(), + battle.getSummary(), + tagMap.getOrDefault(battle.getId(), List.of()), + battle.getAudioDuration(), + battle.getViewCount() + )) + .toList(); + + int nextOffset = pageOffset + pageSize; + boolean hasNext = nextOffset < totalCount; + return new SearchBattleListResponse(items, hasNext ? nextOffset : null, hasNext); + } + + private Map> loadTagMap(List battles) { + List battleIds = battles.stream().map(Battle::getId).toList(); + if (battleIds.isEmpty()) return Map.of(); + + List battleTags = battleTagRepository.findByBattleIdIn(battleIds); + return battleTags.stream() + .collect(Collectors.groupingBy( + bt -> bt.getBattle().getId(), + Collectors.mapping( + bt -> new BattleTagResponse( + bt.getTag().getId(), + bt.getTag().getName(), + bt.getTag().getType() + ), + Collectors.toList() + ) + )); + } +} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/MypageResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/MypageResponse.java index 9804cf3..ab5149a 100644 --- a/src/main/java/com/swyp/app/domain/user/dto/response/MypageResponse.java +++ b/src/main/java/com/swyp/app/domain/user/dto/response/MypageResponse.java @@ -16,12 +16,18 @@ public record ProfileInfo( String userTag, String nickname, CharacterType characterType, + String characterLabel, + String characterImageUrl, BigDecimal mannerTemperature ) { } public record PhilosopherInfo( - PhilosopherType philosopherType + PhilosopherType philosopherType, + String philosopherLabel, + String typeName, + String description, + String imageUrl ) { } diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/RecapResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/RecapResponse.java index 7d7f245..ac76fe9 100644 --- a/src/main/java/com/swyp/app/domain/user/dto/response/RecapResponse.java +++ b/src/main/java/com/swyp/app/domain/user/dto/response/RecapResponse.java @@ -13,7 +13,11 @@ public record RecapResponse( ) { public record PhilosopherCard( - PhilosopherType philosopherType + PhilosopherType philosopherType, + String philosopherLabel, + String typeName, + String description, + String imageUrl ) { } diff --git a/src/main/java/com/swyp/app/domain/user/entity/CharacterType.java b/src/main/java/com/swyp/app/domain/user/entity/CharacterType.java index e26e5b6..4bc8cf0 100644 --- a/src/main/java/com/swyp/app/domain/user/entity/CharacterType.java +++ b/src/main/java/com/swyp/app/domain/user/entity/CharacterType.java @@ -1,36 +1,32 @@ package com.swyp.app.domain.user.entity; -import com.fasterxml.jackson.annotation.JsonCreator; -import com.fasterxml.jackson.annotation.JsonValue; +import lombok.Getter; import java.util.Arrays; +@Getter public enum CharacterType { - OWL("owl"), - FOX("fox"), - WOLF("wolf"), - LION("lion"), - PENGUIN("penguin"), - BEAR("bear"), - RABBIT("rabbit"), - CAT("cat"); + OWL("부엉이", "images/characters/owl.png"), + FOX("여우", "images/characters/fox.png"), + WOLF("늑대", "images/characters/wolf.png"), + LION("사자", "images/characters/lion.png"), + PENGUIN("펭귄", "images/characters/penguin.png"), + BEAR("곰", "images/characters/bear.png"), + RABBIT("토끼", "images/characters/rabbit.png"), + CAT("고양이", "images/characters/cat.png"); - private final String value; + private final String label; + private final String imageKey; - CharacterType(String value) { - this.value = value; + CharacterType(String label, String imageKey) { + this.label = label; + this.imageKey = imageKey; } - @JsonValue - public String getValue() { - return value; - } - - @JsonCreator - public static CharacterType from(String value) { + public static CharacterType from(String input) { return Arrays.stream(values()) - .filter(type -> type.value.equalsIgnoreCase(value)) + .filter(type -> type.name().equalsIgnoreCase(input) || type.label.equals(input)) .findFirst() - .orElseThrow(() -> new IllegalArgumentException("Unknown character type: " + value)); + .orElseThrow(() -> new IllegalArgumentException("Unknown character type: " + input)); } } diff --git a/src/main/java/com/swyp/app/domain/user/entity/CharacterTypeConverter.java b/src/main/java/com/swyp/app/domain/user/entity/CharacterTypeConverter.java index 287a520..b4e84db 100644 --- a/src/main/java/com/swyp/app/domain/user/entity/CharacterTypeConverter.java +++ b/src/main/java/com/swyp/app/domain/user/entity/CharacterTypeConverter.java @@ -8,7 +8,7 @@ public class CharacterTypeConverter implements AttributeConverter type.label.equals(label)) + .findFirst() + .orElse(null); + } } diff --git a/src/main/java/com/swyp/app/domain/user/entity/UserProfile.java b/src/main/java/com/swyp/app/domain/user/entity/UserProfile.java index 7e063f5..6131b7b 100644 --- a/src/main/java/com/swyp/app/domain/user/entity/UserProfile.java +++ b/src/main/java/com/swyp/app/domain/user/entity/UserProfile.java @@ -2,6 +2,8 @@ import com.swyp.app.global.common.BaseEntity; import jakarta.persistence.Entity; +import jakarta.persistence.EnumType; +import jakarta.persistence.Enumerated; import jakarta.persistence.FetchType; import jakarta.persistence.Id; import jakarta.persistence.JoinColumn; @@ -29,6 +31,9 @@ public class UserProfile extends BaseEntity { private CharacterType characterType; + @Enumerated(EnumType.STRING) + private PhilosopherType philosopherType; + private BigDecimal mannerTemperature; @Builder @@ -47,4 +52,8 @@ public void update(String nickname, CharacterType characterType) { this.characterType = characterType; } } + + public void updatePhilosopherType(PhilosopherType philosopherType) { + this.philosopherType = philosopherType; + } } diff --git a/src/main/java/com/swyp/app/domain/user/service/MypageService.java b/src/main/java/com/swyp/app/domain/user/service/MypageService.java index 9db9a2e..fa45e85 100644 --- a/src/main/java/com/swyp/app/domain/user/service/MypageService.java +++ b/src/main/java/com/swyp/app/domain/user/service/MypageService.java @@ -28,10 +28,10 @@ import com.swyp.app.domain.user.entity.User; import com.swyp.app.domain.user.entity.UserProfile; import com.swyp.app.domain.user.entity.UserSettings; -import com.swyp.app.domain.user.entity.UserTendencyScore; import com.swyp.app.domain.user.entity.VoteSide; import com.swyp.app.domain.vote.entity.Vote; import com.swyp.app.domain.vote.service.VoteQueryService; +import com.swyp.app.global.infra.s3.service.S3PresignedUrlService; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; @@ -54,22 +54,35 @@ public class MypageService { private final VoteQueryService voteQueryService; private final BattleQueryService battleQueryService; private final PerspectiveQueryService perspectiveQueryService; + private final S3PresignedUrlService s3PresignedUrlService; + @Transactional public MypageResponse getMypage() { User user = userService.findCurrentUser(); UserProfile profile = userService.findUserProfile(user.getId()); + CharacterType characterType = profile.getCharacterType(); + String characterImageUrl = characterType != null + ? s3PresignedUrlService.generatePresignedUrl(characterType.getImageKey()) : null; + MypageResponse.ProfileInfo profileInfo = new MypageResponse.ProfileInfo( user.getUserTag(), profile.getNickname(), - profile.getCharacterType(), + characterType, + characterType != null ? characterType.getLabel() : null, + characterImageUrl, profile.getMannerTemperature() ); - // TODO: 철학자 산출 로직 확정 후 구현, 현재는 임시로 SOCRATES 반환 - MypageResponse.PhilosopherInfo philosopherInfo = new MypageResponse.PhilosopherInfo( - PhilosopherType.SOCRATES - ); + PhilosopherType philosopherType = resolvePhilosopherType(user.getId(), profile); + MypageResponse.PhilosopherInfo philosopherInfo = philosopherType != null + ? new MypageResponse.PhilosopherInfo( + philosopherType, + philosopherType.getLabel(), + philosopherType.getTypeName(), + philosopherType.getDescription(), + s3PresignedUrlService.generatePresignedUrl(philosopherType.getImageKey())) + : null; int currentPoint = creditService.getTotalPoints(user.getId()); TierCode tierCode = TierCode.fromPoints(currentPoint); @@ -84,20 +97,24 @@ public MypageResponse getMypage() { public RecapResponse getRecap() { User user = userService.findCurrentUser(); - UserTendencyScore score = userService.findUserTendencyScore(user.getId()); + UserProfile profile = userService.findUserProfile(user.getId()); - // TODO: 철학자 산출 로직 확정 후 구현, 현재는 임시 값 반환 - RecapResponse.PhilosopherCard myCard = new RecapResponse.PhilosopherCard(PhilosopherType.SOCRATES); - RecapResponse.PhilosopherCard bestMatchCard = new RecapResponse.PhilosopherCard(PhilosopherType.PLATO); - RecapResponse.PhilosopherCard worstMatchCard = new RecapResponse.PhilosopherCard(PhilosopherType.MARX); + PhilosopherType philosopherType = profile.getPhilosopherType(); + if (philosopherType == null) { + return null; + } + + RecapResponse.PhilosopherCard myCard = toPhilosopherCard(philosopherType); + RecapResponse.PhilosopherCard bestMatchCard = toPhilosopherCard(philosopherType.getBestMatch()); + RecapResponse.PhilosopherCard worstMatchCard = toPhilosopherCard(philosopherType.getWorstMatch()); RecapResponse.Scores scores = new RecapResponse.Scores( - score.getPrinciple(), - score.getReason(), - score.getIndividual(), - score.getChange(), - score.getInner(), - score.getIdeal() + philosopherType.getPrinciple(), + philosopherType.getReason(), + philosopherType.getIndividual(), + philosopherType.getChange(), + philosopherType.getInner(), + philosopherType.getIdeal() ); RecapResponse.PreferenceReport preferenceReport = buildPreferenceReport(user.getId()); @@ -285,6 +302,38 @@ public NoticeDetailResponse getNoticeDetail(Long noticeId) { ); } + private static final int PHILOSOPHER_CALC_THRESHOLD = 5; + + private PhilosopherType resolvePhilosopherType(Long userId, UserProfile profile) { + if (profile.getPhilosopherType() != null) { + return profile.getPhilosopherType(); + } + + long totalVotes = voteQueryService.countTotalParticipation(userId); + if (totalVotes < PHILOSOPHER_CALC_THRESHOLD) { + return null; + } + + List battleIds = voteQueryService.findFirstNBattleIds(userId, PHILOSOPHER_CALC_THRESHOLD); + return battleQueryService.getTopPhilosopherTagName(battleIds) + .map(PhilosopherType::fromLabel) + .map(type -> { + profile.updatePhilosopherType(type); + return type; + }) + .orElse(null); + } + + private RecapResponse.PhilosopherCard toPhilosopherCard(PhilosopherType type) { + return new RecapResponse.PhilosopherCard( + type, + type.getLabel(), + type.getTypeName(), + type.getDescription(), + s3PresignedUrlService.generatePresignedUrl(type.getImageKey()) + ); + } + private VoteSide toVoteSide(BattleOptionLabel label) { return label == BattleOptionLabel.A ? VoteSide.PRO : VoteSide.CON; } diff --git a/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java b/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java index 086be02..da6a67e 100644 --- a/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java +++ b/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java @@ -55,4 +55,8 @@ List findByUserIdAndPreVoteOptionLabelOrderByCreatedAtDesc( // MypageService (recap): 사용자가 참여한 모든 투표 (배틀 목록 추출용) List findByUserId(Long userId); + + // MypageService: 철학자 유형 산출용 - 최초 N개 투표 조회 (생성순) + @Query("SELECT v FROM Vote v JOIN FETCH v.battle WHERE v.userId = :userId ORDER BY v.createdAt ASC") + List findByUserIdOrderByCreatedAtAsc(@Param("userId") Long userId, Pageable pageable); } diff --git a/src/main/java/com/swyp/app/domain/vote/service/VoteQueryService.java b/src/main/java/com/swyp/app/domain/vote/service/VoteQueryService.java index 7250919..b7d00c7 100644 --- a/src/main/java/com/swyp/app/domain/vote/service/VoteQueryService.java +++ b/src/main/java/com/swyp/app/domain/vote/service/VoteQueryService.java @@ -68,4 +68,11 @@ public List findParticipatedBattleIds(Long userId) { .distinct() .toList(); } + + public List findFirstNBattleIds(Long userId, int n) { + return voteRepository.findByUserIdOrderByCreatedAtAsc(userId, PageRequest.of(0, n)).stream() + .map(v -> v.getBattle().getId()) + .distinct() + .toList(); + } } diff --git a/src/main/java/com/swyp/app/global/config/S3Config.java b/src/main/java/com/swyp/app/global/config/S3Config.java new file mode 100644 index 0000000..f2ae86f --- /dev/null +++ b/src/main/java/com/swyp/app/global/config/S3Config.java @@ -0,0 +1,27 @@ +package com.swyp.app.global.config; + +import org.springframework.beans.factory.annotation.Value; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import software.amazon.awssdk.auth.credentials.AwsBasicCredentials; +import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider; +import software.amazon.awssdk.regions.Region; +import software.amazon.awssdk.services.s3.presigner.S3Presigner; + +// TODO: S3 Presigned URL 정식 구현 시 교체 필요 (임시 구현) +@Configuration +public class S3Config { + + @Bean + public S3Presigner s3Presigner( + @Value("${spring.cloud.aws.region.static}") String region, + @Value("${spring.cloud.aws.credentials.access-key}") String accessKey, + @Value("${spring.cloud.aws.credentials.secret-key}") String secretKey) { + + return S3Presigner.builder() + .region(Region.of(region)) + .credentialsProvider(StaticCredentialsProvider.create( + AwsBasicCredentials.create(accessKey, secretKey))) + .build(); + } +} diff --git a/src/main/java/com/swyp/app/global/infra/s3/controller/FileUploadController.java b/src/main/java/com/swyp/app/global/infra/s3/controller/FileUploadController.java index 14b2859..c17c9b4 100644 --- a/src/main/java/com/swyp/app/global/infra/s3/controller/FileUploadController.java +++ b/src/main/java/com/swyp/app/global/infra/s3/controller/FileUploadController.java @@ -1,7 +1,9 @@ package com.swyp.app.global.infra.s3.controller; import com.swyp.app.global.common.response.ApiResponse; +import com.swyp.app.global.infra.s3.dto.FileUploadResponse; import com.swyp.app.global.infra.s3.enums.FileCategory; +import com.swyp.app.global.infra.s3.service.S3PresignedUrlService; import com.swyp.app.global.infra.s3.service.S3UploadService; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.Parameter; @@ -26,10 +28,11 @@ public class FileUploadController { private final S3UploadService s3UploadService; + private final S3PresignedUrlService s3PresignedUrlService; @Operation(summary = "S3 파일 업로드", description = "도메인 카테고리(PHILOSOPHER, BATTLE, SCENARIO)에 맞춰 파일을 업로드합니다.") @PostMapping(value = "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE) - public ApiResponse uploadFile( + public ApiResponse uploadFile( @Parameter(description = "업로드할 파일", content = @Content(mediaType = MediaType.MULTIPART_FORM_DATA_VALUE)) @RequestParam("file") MultipartFile multipartFile, @@ -42,10 +45,13 @@ public ApiResponse uploadFile( // 2. 경로 생성 (예: images/battles/UUID_thumb.png) String fileName = category.getPath() + "/" + UUID.randomUUID() + "_" + multipartFile.getOriginalFilename(); - // 3. S3 업로드 - String s3Url = s3UploadService.uploadFile(fileName, tempFile); + // 3. S3 업로드 (S3 키 반환) + String s3Key = s3UploadService.uploadFile(fileName, tempFile); - return ApiResponse.onSuccess(s3Url); + // 4. 미리보기용 Presigned URL 생성 + String presignedUrl = s3PresignedUrlService.generatePresignedUrl(s3Key); + + return ApiResponse.onSuccess(new FileUploadResponse(s3Key, presignedUrl)); } private File convertMultiPartToFile(MultipartFile file) throws IOException { diff --git a/src/main/java/com/swyp/app/global/infra/s3/dto/FileUploadResponse.java b/src/main/java/com/swyp/app/global/infra/s3/dto/FileUploadResponse.java new file mode 100644 index 0000000..beaf366 --- /dev/null +++ b/src/main/java/com/swyp/app/global/infra/s3/dto/FileUploadResponse.java @@ -0,0 +1,4 @@ +package com.swyp.app.global.infra.s3.dto; + +// TODO: S3 Presigned URL 정식 구현 시 교체 필요 (임시 구현) +public record FileUploadResponse(String s3Key, String presignedUrl) {} diff --git a/src/main/java/com/swyp/app/global/infra/s3/enums/FileCategory.java b/src/main/java/com/swyp/app/global/infra/s3/enums/FileCategory.java index f6659ba..11cd0e8 100644 --- a/src/main/java/com/swyp/app/global/infra/s3/enums/FileCategory.java +++ b/src/main/java/com/swyp/app/global/infra/s3/enums/FileCategory.java @@ -6,6 +6,7 @@ public enum FileCategory { PHILOSOPHER("images/philosophers"), // 철학자 이미지 + CHARACTER("images/characters"), // 캐릭터 프로필 이미지 BATTLE("images/battles"), // 배틀 썸네일 SCENARIO("audio/scenarios"); // 시나리오 음성 diff --git a/src/main/java/com/swyp/app/global/infra/s3/service/S3PresignedUrlService.java b/src/main/java/com/swyp/app/global/infra/s3/service/S3PresignedUrlService.java new file mode 100644 index 0000000..ca1fe2e --- /dev/null +++ b/src/main/java/com/swyp/app/global/infra/s3/service/S3PresignedUrlService.java @@ -0,0 +1,65 @@ +package com.swyp.app.global.infra.s3.service; + +import lombok.RequiredArgsConstructor; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.stereotype.Service; +import software.amazon.awssdk.services.s3.model.GetObjectRequest; +import software.amazon.awssdk.services.s3.presigner.S3Presigner; +import software.amazon.awssdk.services.s3.presigner.model.GetObjectPresignRequest; + +import java.time.Duration; +import java.util.Map; +import java.util.stream.Collectors; + +// TODO: S3 Presigned URL 정식 구현 시 교체 필요 (임시 구현) +@Service +@RequiredArgsConstructor +public class S3PresignedUrlService { + + private final S3Presigner s3Presigner; + + @Value("${spring.cloud.aws.s3.bucket}") + private String bucketName; + + @Value("${app.s3.presigned-url.expiration-hours:6}") + private int expirationHours; + + public String generatePresignedUrl(String s3KeyOrUrl) { + if (s3KeyOrUrl == null || s3KeyOrUrl.isBlank()) { + return null; + } + + String key = extractKey(s3KeyOrUrl); + + GetObjectRequest getObjectRequest = GetObjectRequest.builder() + .bucket(bucketName) + .key(key) + .build(); + + GetObjectPresignRequest presignRequest = GetObjectPresignRequest.builder() + .signatureDuration(Duration.ofHours(expirationHours)) + .getObjectRequest(getObjectRequest) + .build(); + + return s3Presigner.presignGetObject(presignRequest).url().toString(); + } + + public Map generatePresignedUrls(Map keyMap) { + if (keyMap == null || keyMap.isEmpty()) { + return keyMap; + } + return keyMap.entrySet().stream() + .collect(Collectors.toMap( + Map.Entry::getKey, + e -> generatePresignedUrl(e.getValue()) + )); + } + + private String extractKey(String input) { + if (input.startsWith("https://") && input.contains(".s3.") && input.contains(".amazonaws.com/")) { + int idx = input.indexOf(".amazonaws.com/") + ".amazonaws.com/".length(); + return input.substring(idx); + } + return input; + } +} diff --git a/src/main/java/com/swyp/app/global/infra/s3/service/S3UploadServiceImpl.java b/src/main/java/com/swyp/app/global/infra/s3/service/S3UploadServiceImpl.java index b11a733..9151a59 100644 --- a/src/main/java/com/swyp/app/global/infra/s3/service/S3UploadServiceImpl.java +++ b/src/main/java/com/swyp/app/global/infra/s3/service/S3UploadServiceImpl.java @@ -24,9 +24,6 @@ public class S3UploadServiceImpl implements S3UploadService { @Value("${spring.cloud.aws.s3.bucket}") private String bucketName; - @Value("${spring.cloud.aws.region.static}") - private String region; - @Override public String uploadFile(String key, File file) { if (file == null || !file.exists()) { @@ -49,10 +46,9 @@ public String uploadFile(String key, File file) { s3Client.putObject(putObjectRequest, RequestBody.fromFile(file)); - String fileUrl = String.format("https://%s.s3.%s.amazonaws.com/%s", bucketName, region, key); - log.info("[AWS S3] 업로드 완료! 실제 URL: {}, Content-Type: {}", fileUrl, contentType); + log.info("[AWS S3] 업로드 완료! 키: {}, Content-Type: {}", key, contentType); - return fileUrl; + return key; } catch (Exception e) { log.error("[AWS S3] 파일 업로드 실패 - 키: {}", key, e); diff --git a/src/main/resources/application.yml b/src/main/resources/application.yml index 2199e27..0a5bf3b 100644 --- a/src/main/resources/application.yml +++ b/src/main/resources/application.yml @@ -95,4 +95,7 @@ jwt: refresh-token-expiration: 1209600000 # 14일 app: - baseUrl: http://localhost:8080 \ No newline at end of file + baseUrl: http://localhost:8080 + s3: + presigned-url: + expiration-hours: 6 \ No newline at end of file diff --git a/src/test/java/com/swyp/app/domain/home/service/HomeServiceTest.java b/src/test/java/com/swyp/app/domain/home/service/HomeServiceTest.java index e7e3403..254a194 100644 --- a/src/test/java/com/swyp/app/domain/home/service/HomeServiceTest.java +++ b/src/test/java/com/swyp/app/domain/home/service/HomeServiceTest.java @@ -5,7 +5,7 @@ import com.swyp.app.domain.battle.enums.BattleOptionLabel; import com.swyp.app.domain.battle.enums.BattleType; import com.swyp.app.domain.battle.service.BattleService; -import com.swyp.app.domain.home.dto.response.HomeBattleResponse; +import com.swyp.app.domain.home.dto.response.*; import com.swyp.app.domain.notice.dto.response.NoticeSummaryResponse; import com.swyp.app.domain.notice.enums.NoticePlacement; import com.swyp.app.domain.notice.service.NoticeService; @@ -51,8 +51,8 @@ void getHome_aggregates_sections_by_spec() { TodayBattleResponse editorPick = battle("editor-id", BATTLE); TodayBattleResponse trendingBattle = battle("trending-id", BATTLE); TodayBattleResponse bestBattle = battle("best-id", BATTLE); - TodayBattleResponse todayVotePick = battle("today-vote-id", VOTE); - TodayBattleResponse quizBattle = quiz("quiz-id"); + TodayBattleResponse todayVote = vote("vote-id"); + TodayBattleResponse todayQuiz = quiz("quiz-id"); TodayBattleResponse newBattle = battle("new-id", BATTLE); NoticeSummaryResponse notice = new NoticeSummaryResponse( @@ -70,33 +70,36 @@ void getHome_aggregates_sections_by_spec() { when(battleService.getEditorPicks()).thenReturn(List.of(editorPick)); when(battleService.getTrendingBattles()).thenReturn(List.of(trendingBattle)); when(battleService.getBestBattles()).thenReturn(List.of(bestBattle)); - when(battleService.getTodayPicks(VOTE)).thenReturn(List.of(todayVotePick)); - when(battleService.getTodayPicks(QUIZ)).thenReturn(List.of(quizBattle)); + when(battleService.getTodayPicks(VOTE)).thenReturn(List.of(todayVote)); + when(battleService.getTodayPicks(QUIZ)).thenReturn(List.of(todayQuiz)); when(battleService.getNewBattles(List.of( editorPick.battleId(), trendingBattle.battleId(), bestBattle.battleId(), - todayVotePick.battleId(), - quizBattle.battleId() + todayVote.battleId(), + todayQuiz.battleId() ))).thenReturn(List.of(newBattle)); var response = homeService.getHome(); assertThat(response.newNotice()).isTrue(); - assertThat(response.editorPicks()).extracting(HomeBattleResponse::title).containsExactly("editor-id"); - assertThat(response.trendingBattles()).extracting(HomeBattleResponse::title).containsExactly("trending-id"); - assertThat(response.bestBattles()).extracting(HomeBattleResponse::title).containsExactly("best-id"); - assertThat(response.todayPicks()).extracting(HomeBattleResponse::title).containsExactly("today-vote-id", "quiz-id"); - assertThat(response.newBattles()).extracting(HomeBattleResponse::title).containsExactly("new-id"); - assertThat(response.todayPicks().get(0).options()).extracting(option -> option.text()).containsExactly("A", "B"); - assertThat(response.todayPicks().get(1).options()).extracting(option -> option.text()).containsExactly("A", "B", "C", "D"); + assertThat(response.editorPicks()).extracting(HomeEditorPickResponse::title).containsExactly("editor-id"); + assertThat(response.trendingBattles()).extracting(HomeTrendingResponse::title).containsExactly("trending-id"); + assertThat(response.bestBattles()).extracting(HomeBestBattleResponse::title).containsExactly("best-id"); + assertThat(response.todayQuizzes()).extracting(HomeTodayQuizResponse::title).containsExactly("quiz-id"); + assertThat(response.todayVotes()).hasSize(1); + assertThat(response.todayVotes().get(0).titlePrefix()).isEqualTo("도덕의 기준은"); + assertThat(response.todayVotes().get(0).options()).extracting(HomeTodayVoteOptionResponse::title) + .containsExactly("결과", "의도", "규칙", "덕"); + assertThat(response.todayQuizzes().get(0).itemA()).isEqualTo("정답"); + assertThat(response.newBattles()).extracting(HomeNewBattleResponse::title).containsExactly("new-id"); verify(battleService).getNewBattles(argThat(ids -> ids.equals(List.of( editorPick.battleId(), trendingBattle.battleId(), bestBattle.battleId(), - todayVotePick.battleId(), - quizBattle.battleId() + todayVote.battleId(), + todayQuiz.battleId() )))); } @@ -117,7 +120,8 @@ void getHome_returns_false_and_empty_lists_when_no_data() { assertThat(response.editorPicks()).isEmpty(); assertThat(response.trendingBattles()).isEmpty(); assertThat(response.bestBattles()).isEmpty(); - assertThat(response.todayPicks()).isEmpty(); + assertThat(response.todayQuizzes()).isEmpty(); + assertThat(response.todayVotes()).isEmpty(); assertThat(response.newBattles()).isEmpty(); } @@ -162,39 +166,39 @@ void getHome_newNotice_true_with_multiple_notices() { private TodayBattleResponse battle(String title, BattleType type) { return new TodayBattleResponse( - generateId(), - title, - "summary", - "thumbnail", - type, - 10, - 20L, - 90, + generateId(), title, "summary", "thumbnail", type, + 10, 20L, 90, List.of(), List.of( new TodayOptionResponse(generateId(), BattleOptionLabel.A, "A", "rep-a", "stance-a", "image-a"), new TodayOptionResponse(generateId(), BattleOptionLabel.B, "B", "rep-b", "stance-b", "image-b") - ) + ), + null, null, null, null, null, null ); } private TodayBattleResponse quiz(String title) { return new TodayBattleResponse( - generateId(), - title, - "summary", - "thumbnail", - QUIZ, - 30, - 40L, - 60, + generateId(), title, "summary", "thumbnail", QUIZ, + 30, 40L, 60, + List.of(), + List.of(), + null, null, "정답", "정답 설명", "오답", "오답 설명" + ); + } + + private TodayBattleResponse vote(String title) { + return new TodayBattleResponse( + generateId(), title, "summary", "thumbnail", VOTE, + 50, 60L, 0, List.of(), List.of( - new TodayOptionResponse(generateId(), BattleOptionLabel.A, "A", "rep-a", "stance-a", "image-a"), - new TodayOptionResponse(generateId(), BattleOptionLabel.B, "B", "rep-b", "stance-b", "image-b"), - new TodayOptionResponse(generateId(), BattleOptionLabel.C, "C", "rep-c", "stance-c", "image-c"), - new TodayOptionResponse(generateId(), BattleOptionLabel.D, "D", "rep-d", "stance-d", "image-d") - ) + new TodayOptionResponse(generateId(), BattleOptionLabel.A, "결과", null, null, null), + new TodayOptionResponse(generateId(), BattleOptionLabel.B, "의도", null, null, null), + new TodayOptionResponse(generateId(), BattleOptionLabel.C, "규칙", null, null, null), + new TodayOptionResponse(generateId(), BattleOptionLabel.D, "덕", null, null, null) + ), + "도덕의 기준은", "이다", null, null, null, null ); } } diff --git a/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java b/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java index 617a27b..5ce1473 100644 --- a/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java +++ b/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java @@ -32,10 +32,10 @@ import com.swyp.app.domain.user.entity.UserRole; import com.swyp.app.domain.user.entity.UserSettings; import com.swyp.app.domain.user.entity.UserStatus; -import com.swyp.app.domain.user.entity.UserTendencyScore; import com.swyp.app.domain.user.entity.VoteSide; import com.swyp.app.domain.vote.entity.Vote; import com.swyp.app.domain.vote.service.VoteQueryService; +import com.swyp.app.global.infra.s3.service.S3PresignedUrlService; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.extension.ExtendWith; @@ -52,6 +52,7 @@ import java.util.concurrent.atomic.AtomicLong; import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.ArgumentMatchers.anyString; import static org.mockito.ArgumentMatchers.eq; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.when; @@ -71,6 +72,8 @@ class MypageServiceTest { private BattleQueryService battleQueryService; @Mock private PerspectiveQueryService perspectiveQueryService; + @Mock + private S3PresignedUrlService s3PresignedUrlService; @InjectMocks private MypageService mypageService; @@ -86,10 +89,12 @@ private Long generateId() { void getMypage_returns_profile_philosopher_tier() { User user = createUser(1L, "myTag"); UserProfile profile = createProfile(user, "nick", CharacterType.OWL); + profile.updatePhilosopherType(PhilosopherType.KANT); when(userService.findCurrentUser()).thenReturn(user); when(userService.findUserProfile(1L)).thenReturn(profile); when(creditService.getTotalPoints(1L)).thenReturn(0); + when(s3PresignedUrlService.generatePresignedUrl(anyString())).thenReturn("https://presigned-url"); MypageResponse response = mypageService.getMypage(); @@ -97,7 +102,9 @@ void getMypage_returns_profile_philosopher_tier() { assertThat(response.profile().nickname()).isEqualTo("nick"); assertThat(response.profile().characterType()).isEqualTo(CharacterType.OWL); assertThat(response.profile().mannerTemperature()).isEqualByComparingTo(BigDecimal.valueOf(36.5)); - assertThat(response.philosopher().philosopherType()).isEqualTo(PhilosopherType.SOCRATES); + assertThat(response.philosopher().philosopherType()).isEqualTo(PhilosopherType.KANT); + assertThat(response.philosopher().typeName()).isEqualTo("원칙형"); + assertThat(response.philosopher().description()).isNotNull(); assertThat(response.tier().tierCode()).isEqualTo(TierCode.WANDERER); assertThat(response.tier().currentPoint()).isZero(); } @@ -106,14 +113,12 @@ void getMypage_returns_profile_philosopher_tier() { @DisplayName("철학자카드와 성향점수와 선호보고서를 반환한다") void getRecap_returns_cards_scores_report() { User user = createUser(1L, "tag"); - UserTendencyScore score = UserTendencyScore.builder() - .user(user) - .principle(10).reason(20).individual(30) - .change(40).inner(50).ideal(60) - .build(); + UserProfile profile = createProfile(user, "nick", CharacterType.OWL); + profile.updatePhilosopherType(PhilosopherType.KANT); when(userService.findCurrentUser()).thenReturn(user); - when(userService.findUserTendencyScore(1L)).thenReturn(score); + when(userService.findUserProfile(1L)).thenReturn(profile); + when(s3PresignedUrlService.generatePresignedUrl(anyString())).thenReturn("https://presigned-url"); when(voteQueryService.countTotalParticipation(1L)).thenReturn(15L); when(voteQueryService.countOpinionChanges(1L)).thenReturn(3L); when(voteQueryService.calculateBattleWinRate(1L)).thenReturn(70); @@ -128,11 +133,11 @@ void getRecap_returns_cards_scores_report() { RecapResponse response = mypageService.getRecap(); - assertThat(response.myCard().philosopherType()).isEqualTo(PhilosopherType.SOCRATES); - assertThat(response.bestMatchCard().philosopherType()).isEqualTo(PhilosopherType.PLATO); - assertThat(response.worstMatchCard().philosopherType()).isEqualTo(PhilosopherType.MARX); - assertThat(response.scores().principle()).isEqualTo(10); - assertThat(response.scores().ideal()).isEqualTo(60); + assertThat(response.myCard().philosopherType()).isEqualTo(PhilosopherType.KANT); + assertThat(response.bestMatchCard().philosopherType()).isEqualTo(PhilosopherType.CONFUCIUS); + assertThat(response.worstMatchCard().philosopherType()).isEqualTo(PhilosopherType.NIETZSCHE); + assertThat(response.scores().principle()).isEqualTo(92); + assertThat(response.scores().ideal()).isEqualTo(45); assertThat(response.preferenceReport().totalParticipation()).isEqualTo(15); assertThat(response.preferenceReport().opinionChanges()).isEqualTo(3); assertThat(response.preferenceReport().battleWinRate()).isEqualTo(70); @@ -141,29 +146,17 @@ void getRecap_returns_cards_scores_report() { } @Test - @DisplayName("투표이력이 없으면 선호보고서가 0값이다") - void getRecap_returns_zero_report_when_no_votes() { + @DisplayName("철학자유형이 미산출이면 recap은 null이다") + void getRecap_returns_null_when_no_philosopher() { User user = createUser(1L, "tag"); - UserTendencyScore score = UserTendencyScore.builder() - .user(user) - .principle(0).reason(0).individual(0) - .change(0).inner(0).ideal(0) - .build(); + UserProfile profile = createProfile(user, "nick", CharacterType.OWL); when(userService.findCurrentUser()).thenReturn(user); - when(userService.findUserTendencyScore(1L)).thenReturn(score); - when(voteQueryService.countTotalParticipation(1L)).thenReturn(0L); - when(voteQueryService.countOpinionChanges(1L)).thenReturn(0L); - when(voteQueryService.calculateBattleWinRate(1L)).thenReturn(0); - when(voteQueryService.findParticipatedBattleIds(1L)).thenReturn(List.of()); - when(battleQueryService.getTopTagsByBattleIds(List.of(), 4)).thenReturn(new LinkedHashMap<>()); + when(userService.findUserProfile(1L)).thenReturn(profile); RecapResponse response = mypageService.getRecap(); - assertThat(response.preferenceReport().totalParticipation()).isZero(); - assertThat(response.preferenceReport().opinionChanges()).isZero(); - assertThat(response.preferenceReport().battleWinRate()).isZero(); - assertThat(response.preferenceReport().favoriteTopics()).isEmpty(); + assertThat(response).isNull(); } @Test From 005ac768b45c25e291aea1c34387fc326370d82a Mon Sep 17 00:00:00 2001 From: Dante0922 <101305519+Dante0922@users.noreply.github.com> Date: Sat, 28 Mar 2026 23:20:58 +0900 Subject: [PATCH 30/70] =?UTF-8?q?#51=20[Refactor]=20User=20=EC=97=94?= =?UTF-8?q?=ED=8B=B0=ED=8B=B0=20=EC=97=B0=EA=B2=B0=20=EB=B0=8F=20=EC=A0=84?= =?UTF-8?q?=20=EB=8F=84=EB=A9=94=EC=9D=B8=20TODO=20=ED=95=B4=EC=86=8C=20(#?= =?UTF-8?q?66)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Summary - Vote, Perspective, PerspectiveComment, PerspectiveLike, CreditHistory의 `Long userId` → `@ManyToOne User` 엔티티 관계로 전환 - Perspective의 `Long battleId`, `Long optionId` → `@ManyToOne Battle`, `@ManyToOne BattleOption`으로 전환 - 전 도메인 컨트롤러의 `Long userId = 1L` 하드코딩 → `@AuthenticationPrincipal Long userId`로 교체 (VoteController, PerspectiveController, PerspectiveCommentController, PerspectiveLikeController) - 해소된 TODO 주석 제거 (S3 임시 구현 3건, AdMob 포인트 합산, Prevote 체크) - #64 작업 포함: S3 Presigned URL, 홈 API 섹션별 DTO, 철학자 유형 산출/확장, 탐색 탭 검색 API ## Changes (29 files) - **Entities** (5): Vote, Perspective, PerspectiveComment, PerspectiveLike, CreditHistory - **Repositories** (5): VoteRepository, PerspectiveRepository, PerspectiveCommentRepository, PerspectiveLikeRepository, CreditHistoryRepository - **Services** (10): VoteServiceImpl, VoteQueryService, PerspectiveService, PerspectiveCommentService, PerspectiveLikeService, PerspectiveQueryService, CreditService, MypageService, ScenarioServiceImpl, BattleServiceImpl - **Controllers** (5): VoteController, PerspectiveController, PerspectiveCommentController, PerspectiveLikeController, ScenarioController - **Infra** (3): S3Config, S3PresignedUrlService, FileUploadResponse — TODO 제거 - **Tests** (2): CreditServiceTest, MypageServiceTest ## Test plan - [x] `./gradlew compileJava compileTestJava` 컴파일 성공 - [x] CreditServiceTest 5개 통과 - [x] MypageServiceTest 12개 통과 - [ ] 로컬 Swagger에서 @AuthenticationPrincipal 동작 확인 - [ ] 투표 → 관점 → 좋아요/댓글 플로우 E2E 확인 Closes #51 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 4.6 --- .../battle/service/BattleServiceImpl.java | 2 +- .../PerspectiveCommentController.java | 15 +++---- .../controller/PerspectiveController.java | 29 ++++++------ .../controller/PerspectiveLikeController.java | 13 +++--- .../perspective/entity/Perspective.java | 35 ++++++++------- .../entity/PerspectiveComment.java | 11 ++--- .../perspective/entity/PerspectiveLike.java | 12 ++--- .../PerspectiveCommentRepository.java | 3 +- .../repository/PerspectiveLikeRepository.java | 3 +- .../service/PerspectiveCommentService.java | 19 +++++--- .../service/PerspectiveLikeService.java | 9 +++- .../service/PerspectiveService.java | 22 ++++++---- .../service/AdMobRewardServiceImpl.java | 3 -- .../controller/ScenarioController.java | 2 +- .../scenario/service/ScenarioServiceImpl.java | 2 +- .../app/domain/user/entity/CreditHistory.java | 12 +++-- .../repository/CreditHistoryRepository.java | 2 +- .../domain/user/service/CreditService.java | 7 ++- .../domain/user/service/MypageService.java | 12 ++--- .../vote/controller/VoteController.java | 15 +++---- .../com/swyp/app/domain/vote/entity/Vote.java | 22 ++++------ .../vote/repository/VoteRepository.java | 24 ++++------ .../app/domain/vote/service/VoteService.java | 3 +- .../domain/vote/service/VoteServiceImpl.java | 27 ++++++++---- .../com/swyp/app/global/config/S3Config.java | 1 - .../infra/s3/dto/FileUploadResponse.java | 1 - .../s3/service/S3PresignedUrlService.java | 1 - .../user/service/CreditServiceTest.java | 13 +++++- .../user/service/MypageServiceTest.java | 44 +++++++++---------- 29 files changed, 192 insertions(+), 172 deletions(-) diff --git a/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java b/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java index 1bba412..ea0671a 100644 --- a/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java +++ b/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java @@ -137,7 +137,7 @@ public BattleUserDetailResponse getBattleDetail(Long battleId) { List allTags = getTagsByBattle(battle); List options = battleOptionRepository.findByBattle(battle); - String voteStatus = voteRepository.findByBattleAndUserId(battle, 1L) + String voteStatus = voteRepository.findByBattleIdAndUserId(battleId, 1L) .map(v -> v.getPostVoteOption() != null ? v.getPostVoteOption().getLabel().name() : "NONE") .orElse("NONE"); diff --git a/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveCommentController.java b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveCommentController.java index d869a23..f7c78c9 100644 --- a/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveCommentController.java +++ b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveCommentController.java @@ -11,6 +11,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; +import org.springframework.security.core.annotation.AuthenticationPrincipal; import org.springframework.web.bind.annotation.DeleteMapping; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.PatchMapping; @@ -33,10 +34,9 @@ public class PerspectiveCommentController { @PostMapping("/perspectives/{perspectiveId}/comments") public ApiResponse createComment( @PathVariable Long perspectiveId, + @AuthenticationPrincipal Long userId, @RequestBody @Valid CreateCommentRequest request ) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; return ApiResponse.onSuccess(commentService.createComment(perspectiveId, userId, request)); } @@ -44,11 +44,10 @@ public ApiResponse createComment( @GetMapping("/perspectives/{perspectiveId}/comments") public ApiResponse getComments( @PathVariable Long perspectiveId, + @AuthenticationPrincipal Long userId, @RequestParam(required = false) String cursor, @RequestParam(required = false) Integer size ) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; return ApiResponse.onSuccess(commentService.getComments(perspectiveId, userId, cursor, size)); } @@ -56,10 +55,9 @@ public ApiResponse getComments( @DeleteMapping("/perspectives/{perspectiveId}/comments/{commentId}") public ApiResponse deleteComment( @PathVariable Long perspectiveId, - @PathVariable Long commentId + @PathVariable Long commentId, + @AuthenticationPrincipal Long userId ) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; commentService.deleteComment(perspectiveId, commentId, userId); return ApiResponse.onSuccess(null); } @@ -69,10 +67,9 @@ public ApiResponse deleteComment( public ApiResponse updateComment( @PathVariable Long perspectiveId, @PathVariable Long commentId, + @AuthenticationPrincipal Long userId, @RequestBody @Valid UpdateCommentRequest request ) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; return ApiResponse.onSuccess(commentService.updateComment(perspectiveId, commentId, userId, request)); } } diff --git a/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java index 4ad3125..e1e4bc1 100644 --- a/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java +++ b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java @@ -12,6 +12,7 @@ import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.validation.Valid; import lombok.RequiredArgsConstructor; +import org.springframework.security.core.annotation.AuthenticationPrincipal; import org.springframework.web.bind.annotation.DeleteMapping; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.PatchMapping; @@ -30,15 +31,13 @@ public class PerspectiveController { private final PerspectiveService perspectiveService; - // TODO: Prevote 의 여부를 Vote 도메인 개발 이후 교체 @Operation(summary = "관점 생성", description = "특정 배틀에 대한 관점을 생성합니다. 사전 투표가 완료된 경우에만 가능합니다.") @PostMapping("/battles/{battleId}/perspectives") public ApiResponse createPerspective( @PathVariable Long battleId, + @AuthenticationPrincipal Long userId, @RequestBody @Valid CreatePerspectiveRequest request ) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; return ApiResponse.onSuccess(perspectiveService.createPerspective(battleId, userId, request)); } @@ -46,37 +45,36 @@ public ApiResponse createPerspective( @GetMapping("/battles/{battleId}/perspectives") public ApiResponse getPerspectives( @PathVariable Long battleId, + @AuthenticationPrincipal Long userId, @RequestParam(required = false) String cursor, @RequestParam(required = false) Integer size, @RequestParam(required = false) String optionLabel ) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; return ApiResponse.onSuccess(perspectiveService.getPerspectives(battleId, userId, cursor, size, optionLabel)); } @Operation(summary = "내 PENDING 관점 조회", description = "특정 배틀에서 내가 작성한 관점이 PENDING 상태인 경우 반환합니다. PENDING 관점이 없으면 404를 반환합니다.") @GetMapping("/battles/{battleId}/perspectives/me/pending") - public ApiResponse getMyPendingPerspective(@PathVariable Long battleId) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; + public ApiResponse getMyPendingPerspective( + @PathVariable Long battleId, + @AuthenticationPrincipal Long userId) { return ApiResponse.onSuccess(perspectiveService.getMyPendingPerspective(battleId, userId)); } @Operation(summary = "관점 삭제", description = "본인이 작성한 관점을 삭제합니다.") @DeleteMapping("/perspectives/{perspectiveId}") - public ApiResponse deletePerspective(@PathVariable Long perspectiveId) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; + public ApiResponse deletePerspective( + @PathVariable Long perspectiveId, + @AuthenticationPrincipal Long userId) { perspectiveService.deletePerspective(perspectiveId, userId); return ApiResponse.onSuccess(null); } @Operation(summary = "관점 검수 재시도", description = "검수 실패(MODERATION_FAILED) 상태의 관점에 대해 GPT 검수를 다시 요청합니다.") @PostMapping("/perspectives/{perspectiveId}/moderation/retry") - public ApiResponse retryModeration(@PathVariable Long perspectiveId) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; + public ApiResponse retryModeration( + @PathVariable Long perspectiveId, + @AuthenticationPrincipal Long userId) { perspectiveService.retryModeration(perspectiveId, userId); return ApiResponse.onSuccess(null); } @@ -85,10 +83,9 @@ public ApiResponse retryModeration(@PathVariable Long perspectiveId) { @PatchMapping("/perspectives/{perspectiveId}") public ApiResponse updatePerspective( @PathVariable Long perspectiveId, + @AuthenticationPrincipal Long userId, @RequestBody @Valid UpdatePerspectiveRequest request ) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; return ApiResponse.onSuccess(perspectiveService.updatePerspective(perspectiveId, userId, request)); } } diff --git a/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveLikeController.java b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveLikeController.java index c73d0f4..abe7cc7 100644 --- a/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveLikeController.java +++ b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveLikeController.java @@ -7,6 +7,7 @@ import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; +import org.springframework.security.core.annotation.AuthenticationPrincipal; import org.springframework.web.bind.annotation.DeleteMapping; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.PathVariable; @@ -30,17 +31,17 @@ public ApiResponse getLikeCount(@PathVariable Long perspectiv @Operation(summary = "좋아요 등록", description = "특정 관점에 좋아요를 등록합니다.") @PostMapping("/perspectives/{perspectiveId}/likes") - public ApiResponse addLike(@PathVariable Long perspectiveId) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; + public ApiResponse addLike( + @PathVariable Long perspectiveId, + @AuthenticationPrincipal Long userId) { return ApiResponse.onSuccess(likeService.addLike(perspectiveId, userId)); } @Operation(summary = "좋아요 취소", description = "특정 관점에 등록한 좋아요를 취소합니다.") @DeleteMapping("/perspectives/{perspectiveId}/likes") - public ApiResponse removeLike(@PathVariable Long perspectiveId) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; + public ApiResponse removeLike( + @PathVariable Long perspectiveId, + @AuthenticationPrincipal Long userId) { return ApiResponse.onSuccess(likeService.removeLike(perspectiveId, userId)); } } diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java b/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java index 622633e..48ece7a 100644 --- a/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java +++ b/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java @@ -1,14 +1,17 @@ package com.swyp.app.domain.perspective.entity; +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleOption; import com.swyp.app.domain.perspective.enums.PerspectiveStatus; +import com.swyp.app.domain.user.entity.User; import com.swyp.app.global.common.BaseEntity; import jakarta.persistence.Column; import jakarta.persistence.Entity; import jakarta.persistence.EnumType; import jakarta.persistence.Enumerated; -import jakarta.persistence.GeneratedValue; -import jakarta.persistence.GenerationType; -import jakarta.persistence.Id; +import jakarta.persistence.FetchType; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; import jakarta.persistence.Table; import jakarta.persistence.UniqueConstraint; import lombok.AccessLevel; @@ -25,17 +28,17 @@ @NoArgsConstructor(access = AccessLevel.PROTECTED) public class Perspective extends BaseEntity { - // TODO: Battle 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "battle_id") 로 교체 - @Column(name = "battle_id", nullable = false) - private Long battleId; + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "battle_id", nullable = false) + private Battle battle; - // TODO: User 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "user_id") 로 교체 - @Column(name = "user_id", nullable = false) - private Long userId; + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id", nullable = false) + private User user; - // TODO: BattleOption 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "option_id") 로 교체 - @Column(name = "option_id", nullable = false) - private Long optionId; + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "option_id", nullable = false) + private BattleOption option; @Column(nullable = false, columnDefinition = "TEXT") private String content; @@ -51,10 +54,10 @@ public class Perspective extends BaseEntity { private PerspectiveStatus status; @Builder - private Perspective(Long battleId, Long userId, Long optionId, String content) { - this.battleId = battleId; - this.userId = userId; - this.optionId = optionId; + private Perspective(Battle battle, User user, BattleOption option, String content) { + this.battle = battle; + this.user = user; + this.option = option; this.content = content; this.likeCount = 0; this.commentCount = 0; diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveComment.java b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveComment.java index 19a940a..bf41727 100644 --- a/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveComment.java +++ b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveComment.java @@ -1,5 +1,6 @@ package com.swyp.app.domain.perspective.entity; +import com.swyp.app.domain.user.entity.User; import com.swyp.app.global.common.BaseEntity; import jakarta.persistence.Column; import jakarta.persistence.Entity; @@ -22,17 +23,17 @@ public class PerspectiveComment extends BaseEntity { @JoinColumn(name = "perspective_id", nullable = false) private Perspective perspective; - // TODO: User 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "user_id") 로 교체 - @Column(name = "user_id", nullable = false) - private Long userId; + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id", nullable = false) + private User user; @Column(nullable = false, columnDefinition = "TEXT") private String content; @Builder - private PerspectiveComment(Perspective perspective, Long userId, String content) { + private PerspectiveComment(Perspective perspective, User user, String content) { this.perspective = perspective; - this.userId = userId; + this.user = user; this.content = content; } diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveLike.java b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveLike.java index 3850c32..db399a6 100644 --- a/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveLike.java +++ b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveLike.java @@ -1,7 +1,7 @@ package com.swyp.app.domain.perspective.entity; +import com.swyp.app.domain.user.entity.User; import com.swyp.app.global.common.BaseEntity; -import jakarta.persistence.Column; import jakarta.persistence.Entity; import jakarta.persistence.FetchType; import jakarta.persistence.JoinColumn; @@ -26,13 +26,13 @@ public class PerspectiveLike extends BaseEntity { @JoinColumn(name = "perspective_id", nullable = false) private Perspective perspective; - // TODO: User 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "user_id") 로 교체 - @Column(name = "user_id", nullable = false) - private Long userId; + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id", nullable = false) + private User user; @Builder - private PerspectiveLike(Perspective perspective, Long userId) { + private PerspectiveLike(Perspective perspective, User user) { this.perspective = perspective; - this.userId = userId; + this.user = user; } } diff --git a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveCommentRepository.java b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveCommentRepository.java index e28e877..ad44196 100644 --- a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveCommentRepository.java +++ b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveCommentRepository.java @@ -16,8 +16,7 @@ public interface PerspectiveCommentRepository extends JpaRepository findByPerspectiveAndCreatedAtBeforeOrderByCreatedAtDesc(Perspective perspective, LocalDateTime cursor, Pageable pageable); - // MypageService: 사용자 댓글 활동 조회 (offset 페이지네이션) - @Query("SELECT c FROM PerspectiveComment c JOIN FETCH c.perspective WHERE c.userId = :userId ORDER BY c.createdAt DESC") + @Query("SELECT c FROM PerspectiveComment c JOIN FETCH c.perspective WHERE c.user.id = :userId ORDER BY c.createdAt DESC") List findByUserIdOrderByCreatedAtDesc(@Param("userId") Long userId, Pageable pageable); long countByUserId(Long userId); diff --git a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveLikeRepository.java b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveLikeRepository.java index 267a6ba..f71877c 100644 --- a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveLikeRepository.java +++ b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveLikeRepository.java @@ -18,8 +18,7 @@ public interface PerspectiveLikeRepository extends JpaRepository findByUserIdOrderByCreatedAtDesc(@Param("userId") Long userId, Pageable pageable); long countByUserId(Long userId); diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java index df7fc6e..88ded3c 100644 --- a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java @@ -10,6 +10,8 @@ import com.swyp.app.domain.perspective.repository.PerspectiveCommentRepository; import com.swyp.app.domain.perspective.repository.PerspectiveRepository; import com.swyp.app.domain.user.dto.response.UserSummary; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.repository.UserRepository; import com.swyp.app.domain.user.service.UserService; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; @@ -30,25 +32,28 @@ public class PerspectiveCommentService { private final PerspectiveRepository perspectiveRepository; private final PerspectiveCommentRepository commentRepository; + private final UserRepository userRepository; private final UserService userQueryService; @Transactional public CreateCommentResponse createComment(Long perspectiveId, Long userId, CreateCommentRequest request) { Perspective perspective = findPerspectiveById(perspectiveId); + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); PerspectiveComment comment = PerspectiveComment.builder() .perspective(perspective) - .userId(userId) + .user(user) .content(request.content()) .build(); commentRepository.save(comment); perspective.incrementCommentCount(); - UserSummary user = userQueryService.findSummaryById(userId); + UserSummary userSummary = userQueryService.findSummaryById(userId); return new CreateCommentResponse( comment.getId(), - new CreateCommentResponse.UserSummary(user.userTag(), user.nickname(), user.characterType()), + new CreateCommentResponse.UserSummary(userSummary.userTag(), userSummary.nickname(), userSummary.characterType()), comment.getContent(), comment.getCreatedAt() ); @@ -67,12 +72,12 @@ public CommentListResponse getComments(Long perspectiveId, Long userId, String c List items = comments.stream() .map(c -> { - UserSummary user = userQueryService.findSummaryById(c.getUserId()); + UserSummary author = userQueryService.findSummaryById(c.getUser().getId()); return new CommentListResponse.Item( c.getId(), - new CommentListResponse.UserSummary(user.userTag(), user.nickname(), user.characterType()), + new CommentListResponse.UserSummary(author.userTag(), author.nickname(), author.characterType()), c.getContent(), - c.getUserId().equals(userId), + c.getUser().getId().equals(userId), c.getCreatedAt() ); }) @@ -116,7 +121,7 @@ private PerspectiveComment findCommentById(Long commentId) { } private void validateOwnership(PerspectiveComment comment, Long userId) { - if (!comment.getUserId().equals(userId)) { + if (!comment.getUser().getId().equals(userId)) { throw new CustomException(ErrorCode.COMMENT_FORBIDDEN); } } diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveLikeService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveLikeService.java index 3b77392..24b3e95 100644 --- a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveLikeService.java +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveLikeService.java @@ -6,6 +6,8 @@ import com.swyp.app.domain.perspective.entity.PerspectiveLike; import com.swyp.app.domain.perspective.repository.PerspectiveLikeRepository; import com.swyp.app.domain.perspective.repository.PerspectiveRepository; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.repository.UserRepository; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; import lombok.RequiredArgsConstructor; @@ -19,6 +21,7 @@ public class PerspectiveLikeService { private final PerspectiveRepository perspectiveRepository; private final PerspectiveLikeRepository likeRepository; + private final UserRepository userRepository; public LikeCountResponse getLikeCount(Long perspectiveId) { Perspective perspective = findPerspectiveById(perspectiveId); @@ -29,8 +32,10 @@ public LikeCountResponse getLikeCount(Long perspectiveId) { @Transactional public LikeResponse addLike(Long perspectiveId, Long userId) { Perspective perspective = findPerspectiveById(perspectiveId); + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); - if (perspective.getUserId().equals(userId)) { + if (perspective.getUser().getId().equals(userId)) { throw new CustomException(ErrorCode.LIKE_SELF_FORBIDDEN); } @@ -40,7 +45,7 @@ public LikeResponse addLike(Long perspectiveId, Long userId) { likeRepository.save(PerspectiveLike.builder() .perspective(perspective) - .userId(userId) + .user(user) .build()); perspective.incrementLikeCount(); diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java index 4e75278..f910766 100644 --- a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java @@ -1,9 +1,12 @@ package com.swyp.app.domain.perspective.service; +import com.swyp.app.domain.battle.entity.Battle; import com.swyp.app.domain.battle.entity.BattleOption; import com.swyp.app.domain.battle.enums.BattleOptionLabel; import com.swyp.app.domain.battle.service.BattleService; import com.swyp.app.domain.perspective.enums.PerspectiveStatus; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.repository.UserRepository; import com.swyp.app.domain.perspective.dto.request.CreatePerspectiveRequest; import com.swyp.app.domain.perspective.dto.request.UpdatePerspectiveRequest; import com.swyp.app.domain.perspective.dto.response.CreatePerspectiveResponse; @@ -38,22 +41,25 @@ public class PerspectiveService { private final BattleService battleService; private final VoteService voteService; private final UserService userQueryService; + private final UserRepository userRepository; private final GptModerationService gptModerationService; @Transactional public CreatePerspectiveResponse createPerspective(Long battleId, Long userId, CreatePerspectiveRequest request) { - battleService.findById(battleId); + Battle battle = battleService.findById(battleId); + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); if (perspectiveRepository.existsByBattleIdAndUserId(battleId, userId)) { throw new CustomException(ErrorCode.PERSPECTIVE_ALREADY_EXISTS); } - Long optionId = voteService.findPreVoteOptionId(battleId, userId); + BattleOption option = voteService.findPreVoteOption(battleId, userId); Perspective perspective = Perspective.builder() - .battleId(battleId) - .userId(userId) - .optionId(optionId) + .battle(battle) + .user(user) + .option(option) .content(request.content()) .build(); @@ -84,8 +90,8 @@ public PerspectiveListResponse getPerspectives(Long battleId, Long userId, Strin List items = perspectives.stream() .map(p -> { - UserSummary user = userQueryService.findSummaryById(p.getUserId()); - BattleOption option = battleService.findOptionById(p.getOptionId()); + UserSummary user = userQueryService.findSummaryById(p.getUser().getId()); + BattleOption option = p.getOption(); boolean isLiked = perspectiveLikeRepository.existsByPerspectiveAndUserId(p, userId); return new PerspectiveListResponse.Item( p.getId(), @@ -154,7 +160,7 @@ private Perspective findPerspectiveById(Long perspectiveId) { } private void validateOwnership(Perspective perspective, Long userId) { - if (!perspective.getUserId().equals(userId)) { + if (!perspective.getUser().getId().equals(userId)) { throw new CustomException(ErrorCode.PERSPECTIVE_FORBIDDEN); } } diff --git a/src/main/java/com/swyp/app/domain/reward/service/AdMobRewardServiceImpl.java b/src/main/java/com/swyp/app/domain/reward/service/AdMobRewardServiceImpl.java index 70114fa..365a6c1 100644 --- a/src/main/java/com/swyp/app/domain/reward/service/AdMobRewardServiceImpl.java +++ b/src/main/java/com/swyp/app/domain/reward/service/AdMobRewardServiceImpl.java @@ -52,9 +52,6 @@ public String processReward(AdMobRewardRequest request) { adRewardHistoryRepository.save(history); - // 6. TODO: 작업 중인 포인트 합산 로직 호출 지점 - // user.addPoint(request.reward_amount()); - log.info("보상 지급 완료: user={}, amount={}", user.getId(), request.reward_amount()); return "OK"; } diff --git a/src/main/java/com/swyp/app/domain/scenario/controller/ScenarioController.java b/src/main/java/com/swyp/app/domain/scenario/controller/ScenarioController.java index 59c7d98..926b048 100644 --- a/src/main/java/com/swyp/app/domain/scenario/controller/ScenarioController.java +++ b/src/main/java/com/swyp/app/domain/scenario/controller/ScenarioController.java @@ -3,7 +3,7 @@ import com.swyp.app.domain.scenario.dto.request.ScenarioCreateRequest; import com.swyp.app.domain.scenario.dto.request.ScenarioStatusUpdateRequest; import com.swyp.app.domain.scenario.dto.response.AdminDeleteResponse; -import com.swyp.app.domain.scenario.dto.response.AdminScenarioDetailResponse; // 🚀 추가 (상세 조회용) +import com.swyp.app.domain.scenario.dto.response.AdminScenarioDetailResponse; import com.swyp.app.domain.scenario.dto.response.AdminScenarioResponse; import com.swyp.app.domain.scenario.dto.response.UserScenarioResponse; import com.swyp.app.domain.scenario.service.ScenarioService; diff --git a/src/main/java/com/swyp/app/domain/scenario/service/ScenarioServiceImpl.java b/src/main/java/com/swyp/app/domain/scenario/service/ScenarioServiceImpl.java index 8dadc05..a5d4b4e 100644 --- a/src/main/java/com/swyp/app/domain/scenario/service/ScenarioServiceImpl.java +++ b/src/main/java/com/swyp/app/domain/scenario/service/ScenarioServiceImpl.java @@ -8,7 +8,7 @@ import com.swyp.app.domain.scenario.dto.request.ScenarioCreateRequest; import com.swyp.app.domain.scenario.dto.request.ScriptRequest; import com.swyp.app.domain.scenario.dto.response.AdminDeleteResponse; -import com.swyp.app.domain.scenario.dto.response.AdminScenarioDetailResponse; // 🚀 추가 +import com.swyp.app.domain.scenario.dto.response.AdminScenarioDetailResponse; import com.swyp.app.domain.scenario.dto.response.AdminScenarioResponse; import com.swyp.app.domain.scenario.dto.response.UserScenarioResponse; import com.swyp.app.domain.scenario.entity.InteractiveOption; diff --git a/src/main/java/com/swyp/app/domain/user/entity/CreditHistory.java b/src/main/java/com/swyp/app/domain/user/entity/CreditHistory.java index ceeea05..e3000ff 100644 --- a/src/main/java/com/swyp/app/domain/user/entity/CreditHistory.java +++ b/src/main/java/com/swyp/app/domain/user/entity/CreditHistory.java @@ -6,7 +6,10 @@ import jakarta.persistence.Entity; import jakarta.persistence.EnumType; import jakarta.persistence.Enumerated; +import jakarta.persistence.FetchType; import jakarta.persistence.Index; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; import jakarta.persistence.Table; import lombok.AccessLevel; import lombok.Builder; @@ -22,8 +25,9 @@ @NoArgsConstructor(access = AccessLevel.PROTECTED) public class CreditHistory extends BaseEntity { - @Column(name = "user_id", nullable = false) - private Long userId; + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id", nullable = false) + private User user; @Enumerated(EnumType.STRING) @Column(name = "credit_type", nullable = false, length = 30) @@ -36,8 +40,8 @@ public class CreditHistory extends BaseEntity { private Long referenceId; @Builder - private CreditHistory(Long userId, CreditType creditType, int amount, Long referenceId) { - this.userId = userId; + private CreditHistory(User user, CreditType creditType, int amount, Long referenceId) { + this.user = user; this.creditType = creditType; this.amount = amount; this.referenceId = referenceId; diff --git a/src/main/java/com/swyp/app/domain/user/repository/CreditHistoryRepository.java b/src/main/java/com/swyp/app/domain/user/repository/CreditHistoryRepository.java index a860eef..775b23c 100644 --- a/src/main/java/com/swyp/app/domain/user/repository/CreditHistoryRepository.java +++ b/src/main/java/com/swyp/app/domain/user/repository/CreditHistoryRepository.java @@ -8,7 +8,7 @@ public interface CreditHistoryRepository extends JpaRepository { - @Query("SELECT COALESCE(SUM(c.amount), 0) FROM CreditHistory c WHERE c.userId = :userId") + @Query("SELECT COALESCE(SUM(c.amount), 0) FROM CreditHistory c WHERE c.user.id = :userId") int sumAmountByUserId(@Param("userId") Long userId); boolean existsByUserIdAndCreditTypeAndReferenceId(Long userId, CreditType creditType, Long referenceId); diff --git a/src/main/java/com/swyp/app/domain/user/service/CreditService.java b/src/main/java/com/swyp/app/domain/user/service/CreditService.java index a9c9ce3..7704791 100644 --- a/src/main/java/com/swyp/app/domain/user/service/CreditService.java +++ b/src/main/java/com/swyp/app/domain/user/service/CreditService.java @@ -5,6 +5,7 @@ import com.swyp.app.domain.user.entity.User; import com.swyp.app.domain.user.enums.CreditType; import com.swyp.app.domain.user.repository.CreditHistoryRepository; +import com.swyp.app.domain.user.repository.UserRepository; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; import lombok.RequiredArgsConstructor; @@ -18,6 +19,7 @@ public class CreditService { private final CreditHistoryRepository creditHistoryRepository; + private final UserRepository userRepository; private final UserService userService; /** @@ -50,8 +52,11 @@ public void addCredit(Long userId, CreditType creditType, Long referenceId) { public void addCredit(Long userId, CreditType creditType, int amount, Long referenceId) { validateReferenceId(referenceId); + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + CreditHistory history = CreditHistory.builder() - .userId(userId) + .user(user) .creditType(creditType) .amount(amount) .referenceId(referenceId) diff --git a/src/main/java/com/swyp/app/domain/user/service/MypageService.java b/src/main/java/com/swyp/app/domain/user/service/MypageService.java index fa45e85..3fcd2ba 100644 --- a/src/main/java/com/swyp/app/domain/user/service/MypageService.java +++ b/src/main/java/com/swyp/app/domain/user/service/MypageService.java @@ -193,7 +193,7 @@ private ContentActivityListResponse buildCommentActivities(User user, int pageOf .map(comment -> { Perspective p = comment.getPerspective(); return toActivityItem(comment.getId().toString(), ActivityType.COMMENT, p, - battleMap.get(p.getBattleId()), optionMap.get(p.getOptionId()), + battleMap.get(p.getBattle().getId()), optionMap.get(p.getOption().getId()), comment.getContent(), comment.getCreatedAt()); }) .toList(); @@ -215,7 +215,7 @@ private ContentActivityListResponse buildLikeActivities(User user, int pageOffse .map(like -> { Perspective p = like.getPerspective(); return toActivityItem(like.getId().toString(), ActivityType.LIKE, p, - battleMap.get(p.getBattleId()), optionMap.get(p.getOptionId()), + battleMap.get(p.getBattle().getId()), optionMap.get(p.getOption().getId()), p.getContent(), like.getCreatedAt()); }) .toList(); @@ -229,7 +229,7 @@ private ContentActivityListResponse.ContentActivityItem toActivityItem( String activityId, ActivityType activityType, Perspective perspective, Battle battle, BattleOption option, String content, LocalDateTime createdAt) { - UserSummary author = userService.findSummaryById(perspective.getUserId()); + UserSummary author = userService.findSummaryById(perspective.getUser().getId()); ContentActivityListResponse.AuthorInfo authorInfo = new ContentActivityListResponse.AuthorInfo( author.userTag(), author.nickname(), CharacterType.from(author.characterType()) ); @@ -237,7 +237,7 @@ private ContentActivityListResponse.ContentActivityItem toActivityItem( return new ContentActivityListResponse.ContentActivityItem( activityId, activityType, perspective.getId().toString(), - perspective.getBattleId().toString(), + perspective.getBattle().getId().toString(), battle != null ? battle.getTitle() : null, authorInfo, option != null ? option.getStance() : null, @@ -248,12 +248,12 @@ private ContentActivityListResponse.ContentActivityItem toActivityItem( } private Map loadBattles(List perspectives) { - List battleIds = perspectives.stream().map(Perspective::getBattleId).distinct().toList(); + List battleIds = perspectives.stream().map(p -> p.getBattle().getId()).distinct().toList(); return battleQueryService.findBattlesByIds(battleIds); } private Map loadOptions(List perspectives) { - List optionIds = perspectives.stream().map(Perspective::getOptionId).distinct().toList(); + List optionIds = perspectives.stream().map(p -> p.getOption().getId()).distinct().toList(); return battleQueryService.findOptionsByIds(optionIds); } diff --git a/src/main/java/com/swyp/app/domain/vote/controller/VoteController.java b/src/main/java/com/swyp/app/domain/vote/controller/VoteController.java index 1d703fd..4bdb9b8 100644 --- a/src/main/java/com/swyp/app/domain/vote/controller/VoteController.java +++ b/src/main/java/com/swyp/app/domain/vote/controller/VoteController.java @@ -9,6 +9,7 @@ import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; +import org.springframework.security.core.annotation.AuthenticationPrincipal; import org.springframework.web.bind.annotation.*; @Tag(name = "투표 (Vote)", description = "사전/사후 투표 실행 및 통계, 내 투표 내역 조회 API") @@ -23,9 +24,8 @@ public class VoteController { @PostMapping("/battles/{battleId}/votes/pre") public ApiResponse preVote( @PathVariable Long battleId, + @AuthenticationPrincipal Long userId, @RequestBody VoteRequest request) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; return ApiResponse.onSuccess(voteService.preVote(battleId, userId, request)); } @@ -33,9 +33,8 @@ public ApiResponse preVote( @PostMapping("/battles/{battleId}/votes/post") public ApiResponse postVote( @PathVariable Long battleId, + @AuthenticationPrincipal Long userId, @RequestBody VoteRequest request) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; return ApiResponse.onSuccess(voteService.postVote(battleId, userId, request)); } @@ -47,9 +46,9 @@ public ApiResponse getVoteStats(@PathVariable Long battleId) @Operation(summary = "내 투표 내역 조회", description = "특정 배틀에 대한 내 사전/사후 투표 내역과 현재 상태를 조회합니다.") @GetMapping("/battles/{battleId}/votes/me") - public ApiResponse getMyVote(@PathVariable Long battleId) { - // TODO: Security 적용 후 @AuthenticationPrincipal로 userId 교체 - Long userId = 1L; + public ApiResponse getMyVote( + @PathVariable Long battleId, + @AuthenticationPrincipal Long userId) { return ApiResponse.onSuccess(voteService.getMyVote(battleId, userId)); } -} \ No newline at end of file +} diff --git a/src/main/java/com/swyp/app/domain/vote/entity/Vote.java b/src/main/java/com/swyp/app/domain/vote/entity/Vote.java index fe9a24b..2c469b1 100644 --- a/src/main/java/com/swyp/app/domain/vote/entity/Vote.java +++ b/src/main/java/com/swyp/app/domain/vote/entity/Vote.java @@ -2,6 +2,7 @@ import com.swyp.app.domain.battle.entity.Battle; import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.user.entity.User; import com.swyp.app.domain.vote.enums.VoteStatus; import com.swyp.app.global.common.BaseEntity; import jakarta.persistence.Column; @@ -9,9 +10,6 @@ import jakarta.persistence.EnumType; import jakarta.persistence.Enumerated; import jakarta.persistence.FetchType; -import jakarta.persistence.GeneratedValue; -import jakarta.persistence.GenerationType; -import jakarta.persistence.Id; import jakarta.persistence.JoinColumn; import jakarta.persistence.ManyToOne; import jakarta.persistence.Table; @@ -26,9 +24,9 @@ @NoArgsConstructor(access = AccessLevel.PROTECTED) public class Vote extends BaseEntity { - // TODO: User 엔티티 병합 후 @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "user_id") 로 교체 - @Column(name = "user_id", nullable = false) - private Long userId; + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id", nullable = false) + private User user; @ManyToOne(fetch = FetchType.LAZY) @JoinColumn(name = "battle_id", nullable = false) @@ -47,28 +45,26 @@ public class Vote extends BaseEntity { private VoteStatus status; @Builder - private Vote(Long userId, Battle battle, BattleOption preVoteOption, + private Vote(User user, Battle battle, BattleOption preVoteOption, BattleOption postVoteOption, VoteStatus status) { - this.userId = userId; + this.user = user; this.battle = battle; this.preVoteOption = preVoteOption; this.postVoteOption = postVoteOption; this.status = status; } - // 사전 투표 생성 팩토리 메서드 - public static Vote createPreVote(Long userId, Battle battle, BattleOption option) { + public static Vote createPreVote(User user, Battle battle, BattleOption option) { return Vote.builder() - .userId(userId) + .user(user) .battle(battle) .preVoteOption(option) .status(VoteStatus.PRE_VOTED) .build(); } - // 사후 투표 실행 상태 변경 메서드 public void doPostVote(BattleOption postOption) { this.postVoteOption = postOption; this.status = VoteStatus.POST_VOTED; } -} \ No newline at end of file +} diff --git a/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java b/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java index da6a67e..cd0ed29 100644 --- a/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java +++ b/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java @@ -5,6 +5,7 @@ import com.swyp.app.domain.battle.enums.BattleOptionLabel; import com.swyp.app.domain.user.entity.User; import com.swyp.app.domain.vote.entity.Vote; +import com.swyp.app.domain.vote.enums.VoteStatus; import org.springframework.data.domain.Pageable; import org.springframework.data.jpa.repository.JpaRepository; import org.springframework.data.jpa.repository.Query; @@ -15,11 +16,9 @@ public interface VoteRepository extends JpaRepository { - // ScenarioService : Battle 엔티티 조회 없이 ID만으로 투표 내역 확인 Optional findByBattleIdAndUserId(Long battleId, Long userId); - // VoteService : 이미 조회된 Battle 엔티티를 활용하여 투표 내역 확인 - Optional findByBattleAndUserId(Battle battle, Long userId); + Optional findByBattleAndUser(Battle battle, User user); long countByBattle(Battle battle); @@ -27,36 +26,29 @@ public interface VoteRepository extends JpaRepository { Optional findTopByBattleOrderByUpdatedAtDesc(Battle battle); - // MypageService: 사용자 투표 기록 조회 (offset 페이지네이션) @Query("SELECT v FROM Vote v JOIN FETCH v.battle JOIN FETCH v.preVoteOption " + - "WHERE v.userId = :userId ORDER BY v.createdAt DESC") + "WHERE v.user.id = :userId ORDER BY v.createdAt DESC") List findByUserIdOrderByCreatedAtDesc(@Param("userId") Long userId, Pageable pageable); - // MypageService: 사용자 투표 기록 - voteSide(PRO/CON) 필터 @Query("SELECT v FROM Vote v JOIN FETCH v.battle JOIN FETCH v.preVoteOption " + - "WHERE v.userId = :userId AND v.preVoteOption.label = :label ORDER BY v.createdAt DESC") + "WHERE v.user.id = :userId AND v.preVoteOption.label = :label ORDER BY v.createdAt DESC") List findByUserIdAndPreVoteOptionLabelOrderByCreatedAtDesc( @Param("userId") Long userId, @Param("label") BattleOptionLabel label, Pageable pageable); - // MypageService: 사용자 투표 전체 수 long countByUserId(Long userId); - // MypageService: 사용자 투표 수 - voteSide 필터 - @Query("SELECT COUNT(v) FROM Vote v WHERE v.userId = :userId AND v.preVoteOption.label = :label") + @Query("SELECT COUNT(v) FROM Vote v WHERE v.user.id = :userId AND v.preVoteOption.label = :label") long countByUserIdAndPreVoteOptionLabel(@Param("userId") Long userId, @Param("label") BattleOptionLabel label); - // MypageService (recap): 사후 투표 완료 수 - long countByUserIdAndStatus(Long userId, com.swyp.app.domain.vote.enums.VoteStatus status); + long countByUserIdAndStatus(Long userId, VoteStatus status); - // MypageService (recap): 입장 변경 수 (사전/사후 투표 옵션이 다른 경우) - @Query("SELECT COUNT(v) FROM Vote v WHERE v.userId = :userId AND v.status = 'POST_VOTED' " + + @Query("SELECT COUNT(v) FROM Vote v WHERE v.user.id = :userId AND v.status = 'POST_VOTED' " + "AND v.preVoteOption <> v.postVoteOption") long countOpinionChangesByUserId(@Param("userId") Long userId); - // MypageService (recap): 사용자가 참여한 모든 투표 (배틀 목록 추출용) List findByUserId(Long userId); // MypageService: 철학자 유형 산출용 - 최초 N개 투표 조회 (생성순) - @Query("SELECT v FROM Vote v JOIN FETCH v.battle WHERE v.userId = :userId ORDER BY v.createdAt ASC") + @Query("SELECT v FROM Vote v JOIN FETCH v.battle WHERE v.user.id = :userId ORDER BY v.createdAt ASC") List findByUserIdOrderByCreatedAtAsc(@Param("userId") Long userId, Pageable pageable); } diff --git a/src/main/java/com/swyp/app/domain/vote/service/VoteService.java b/src/main/java/com/swyp/app/domain/vote/service/VoteService.java index ba47ef5..70e95a7 100644 --- a/src/main/java/com/swyp/app/domain/vote/service/VoteService.java +++ b/src/main/java/com/swyp/app/domain/vote/service/VoteService.java @@ -1,5 +1,6 @@ package com.swyp.app.domain.vote.service; +import com.swyp.app.domain.battle.entity.BattleOption; import com.swyp.app.domain.vote.dto.request.VoteRequest; import com.swyp.app.domain.vote.dto.response.MyVoteResponse; import com.swyp.app.domain.vote.dto.response.VoteResultResponse; @@ -7,7 +8,7 @@ public interface VoteService { - Long findPreVoteOptionId(Long battleId, Long userId); + BattleOption findPreVoteOption(Long battleId, Long userId); VoteStatsResponse getVoteStats(Long battleId); diff --git a/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java b/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java index df70224..c76898b 100644 --- a/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java +++ b/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java @@ -4,6 +4,8 @@ import com.swyp.app.domain.battle.entity.BattleOption; import com.swyp.app.domain.battle.repository.BattleOptionRepository; import com.swyp.app.domain.battle.service.BattleService; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.repository.UserRepository; import com.swyp.app.domain.vote.converter.VoteConverter; import com.swyp.app.domain.vote.dto.request.VoteRequest; import com.swyp.app.domain.vote.dto.response.MyVoteResponse; @@ -29,18 +31,21 @@ public class VoteServiceImpl implements VoteService { private final VoteRepository voteRepository; private final BattleService battleService; private final BattleOptionRepository battleOptionRepository; + private final UserRepository userRepository; @Override - public Long findPreVoteOptionId(Long battleId, Long userId) { + public BattleOption findPreVoteOption(Long battleId, Long userId) { Battle battle = battleService.findById(battleId); + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); - Vote vote = voteRepository.findByBattleAndUserId(battle, userId) + Vote vote = voteRepository.findByBattleAndUser(battle, user) .orElseThrow(() -> new CustomException(ErrorCode.VOTE_NOT_FOUND)); if (vote.getPreVoteOption() == null) { throw new CustomException(ErrorCode.PRE_VOTE_REQUIRED); } - return vote.getPreVoteOption().getId(); + return vote.getPreVoteOption(); } @Override @@ -70,8 +75,10 @@ public VoteStatsResponse getVoteStats(Long battleId) { @Override public MyVoteResponse getMyVote(Long battleId, Long userId) { Battle battle = battleService.findById(battleId); + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); - Vote vote = voteRepository.findByBattleAndUserId(battle, userId) + Vote vote = voteRepository.findByBattleAndUser(battle, user) .orElseThrow(() -> new CustomException(ErrorCode.VOTE_NOT_FOUND)); return VoteConverter.toMyVoteResponse(vote); @@ -81,15 +88,16 @@ public MyVoteResponse getMyVote(Long battleId, Long userId) { @Transactional public VoteResultResponse preVote(Long battleId, Long userId, VoteRequest request) { Battle battle = battleService.findById(battleId); + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); BattleOption option = battleOptionRepository.findById(request.optionId()) .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_OPTION_NOT_FOUND)); - // 이미 투표 내역이 존재하는지 검증 - if (voteRepository.findByBattleAndUserId(battle, userId).isPresent()) { + if (voteRepository.findByBattleAndUser(battle, user).isPresent()) { throw new CustomException(ErrorCode.VOTE_ALREADY_SUBMITTED); } - Vote vote = Vote.createPreVote(userId, battle, option); + Vote vote = Vote.createPreVote(user, battle, option); voteRepository.save(vote); return VoteConverter.toVoteResultResponse(vote); @@ -99,13 +107,14 @@ public VoteResultResponse preVote(Long battleId, Long userId, VoteRequest reques @Transactional public VoteResultResponse postVote(Long battleId, Long userId, VoteRequest request) { Battle battle = battleService.findById(battleId); + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); BattleOption option = battleOptionRepository.findById(request.optionId()) .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_OPTION_NOT_FOUND)); - Vote vote = voteRepository.findByBattleAndUserId(battle, userId) + Vote vote = voteRepository.findByBattleAndUser(battle, user) .orElseThrow(() -> new CustomException(ErrorCode.VOTE_NOT_FOUND)); - // 사전 투표 상태일 때만 사후 투표 가능 if (vote.getStatus() != VoteStatus.PRE_VOTED) { throw new CustomException(ErrorCode.INVALID_VOTE_STATUS); } diff --git a/src/main/java/com/swyp/app/global/config/S3Config.java b/src/main/java/com/swyp/app/global/config/S3Config.java index f2ae86f..cac7a59 100644 --- a/src/main/java/com/swyp/app/global/config/S3Config.java +++ b/src/main/java/com/swyp/app/global/config/S3Config.java @@ -8,7 +8,6 @@ import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3.presigner.S3Presigner; -// TODO: S3 Presigned URL 정식 구현 시 교체 필요 (임시 구현) @Configuration public class S3Config { diff --git a/src/main/java/com/swyp/app/global/infra/s3/dto/FileUploadResponse.java b/src/main/java/com/swyp/app/global/infra/s3/dto/FileUploadResponse.java index beaf366..4a510ac 100644 --- a/src/main/java/com/swyp/app/global/infra/s3/dto/FileUploadResponse.java +++ b/src/main/java/com/swyp/app/global/infra/s3/dto/FileUploadResponse.java @@ -1,4 +1,3 @@ package com.swyp.app.global.infra.s3.dto; -// TODO: S3 Presigned URL 정식 구현 시 교체 필요 (임시 구현) public record FileUploadResponse(String s3Key, String presignedUrl) {} diff --git a/src/main/java/com/swyp/app/global/infra/s3/service/S3PresignedUrlService.java b/src/main/java/com/swyp/app/global/infra/s3/service/S3PresignedUrlService.java index ca1fe2e..fc7b0be 100644 --- a/src/main/java/com/swyp/app/global/infra/s3/service/S3PresignedUrlService.java +++ b/src/main/java/com/swyp/app/global/infra/s3/service/S3PresignedUrlService.java @@ -11,7 +11,6 @@ import java.util.Map; import java.util.stream.Collectors; -// TODO: S3 Presigned URL 정식 구현 시 교체 필요 (임시 구현) @Service @RequiredArgsConstructor public class S3PresignedUrlService { diff --git a/src/test/java/com/swyp/app/domain/user/service/CreditServiceTest.java b/src/test/java/com/swyp/app/domain/user/service/CreditServiceTest.java index a82f810..2a53ae9 100644 --- a/src/test/java/com/swyp/app/domain/user/service/CreditServiceTest.java +++ b/src/test/java/com/swyp/app/domain/user/service/CreditServiceTest.java @@ -5,6 +5,7 @@ import com.swyp.app.domain.user.entity.User; import com.swyp.app.domain.user.enums.CreditType; import com.swyp.app.domain.user.repository.CreditHistoryRepository; +import com.swyp.app.domain.user.repository.UserRepository; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; import org.junit.jupiter.api.DisplayName; @@ -16,6 +17,8 @@ import org.mockito.junit.jupiter.MockitoExtension; import org.springframework.dao.DataIntegrityViolationException; +import java.util.Optional; + import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; import static org.mockito.ArgumentMatchers.any; @@ -30,6 +33,9 @@ class CreditServiceTest { @Mock private CreditHistoryRepository creditHistoryRepository; + @Mock + private UserRepository userRepository; + @Mock private UserService userService; @@ -42,6 +48,7 @@ void addCredit_forCurrentUser_savesDefaultAmount() { User user = org.mockito.Mockito.mock(User.class); when(user.getId()).thenReturn(1L); when(userService.findCurrentUser()).thenReturn(user); + when(userRepository.findById(1L)).thenReturn(Optional.of(user)); creditService.addCredit(CreditType.BATTLE_VOTE, 10L); @@ -49,7 +56,7 @@ void addCredit_forCurrentUser_savesDefaultAmount() { verify(creditHistoryRepository).saveAndFlush(captor.capture()); CreditHistory saved = captor.getValue(); - assertThat(saved.getUserId()).isEqualTo(1L); + assertThat(saved.getUser().getId()).isEqualTo(1L); assertThat(saved.getCreditType()).isEqualTo(CreditType.BATTLE_VOTE); assertThat(saved.getAmount()).isEqualTo(CreditType.BATTLE_VOTE.getDefaultAmount()); assertThat(saved.getReferenceId()).isEqualTo(10L); @@ -69,6 +76,8 @@ void addCredit_withoutReferenceId_throwsException() { @Test @DisplayName("중복 적립 충돌이면 조용히 무시한다") void addCredit_duplicateInsert_ignoresConflict() { + User user = org.mockito.Mockito.mock(User.class); + when(userRepository.findById(1L)).thenReturn(Optional.of(user)); when(creditHistoryRepository.saveAndFlush(any(CreditHistory.class))) .thenThrow(new DataIntegrityViolationException("duplicate")); when(creditHistoryRepository.existsByUserIdAndCreditTypeAndReferenceId(1L, CreditType.BATTLE_VOTE, 10L)) @@ -82,6 +91,8 @@ void addCredit_duplicateInsert_ignoresConflict() { @Test @DisplayName("중복이 아닌 데이터 무결성 오류는 그대로 던진다") void addCredit_nonDuplicateIntegrityFailure_rethrows() { + User user = org.mockito.Mockito.mock(User.class); + when(userRepository.findById(1L)).thenReturn(Optional.of(user)); when(creditHistoryRepository.saveAndFlush(any(CreditHistory.class))) .thenThrow(new DataIntegrityViolationException("broken")); when(creditHistoryRepository.existsByUserIdAndCreditTypeAndReferenceId(1L, CreditType.BATTLE_VOTE, 10L)) diff --git a/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java b/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java index 5ce1473..08908ac 100644 --- a/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java +++ b/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java @@ -166,7 +166,7 @@ void getBattleRecords_returns_paginated_records() { Battle battle = createBattle("배틀 제목"); BattleOption optionA = createOption(battle, BattleOptionLabel.A); Vote vote = Vote.builder() - .userId(1L) + .user(user) .battle(battle) .preVoteOption(optionA) .build(); @@ -192,7 +192,7 @@ void getBattleRecords_returns_no_next_when_last_page() { Battle battle = createBattle("제목"); BattleOption optionA = createOption(battle, BattleOptionLabel.A); Vote vote = Vote.builder() - .userId(1L) + .user(user) .battle(battle) .preVoteOption(optionA) .build(); @@ -227,29 +227,27 @@ void getBattleRecords_applies_vote_side_filter() { @DisplayName("COMMENT 타입으로 댓글활동을 반환한다") void getContentActivities_returns_comments() { User user = createUser(1L, "tag"); - Long battleId = generateId(); - Long optionId = generateId(); + Battle battle = createBattle("배틀"); + Long battleId = battle.getId(); + BattleOption option = createOption(battle, BattleOptionLabel.A); + Long optionId = option.getId(); + Perspective perspective = Perspective.builder() - .battleId(battleId) - .userId(1L) - .optionId(optionId) + .battle(battle) + .user(user) + .option(option) .content("관점 내용") .build(); ReflectionTestUtils.setField(perspective, "id", generateId()); PerspectiveComment comment = PerspectiveComment.builder() .perspective(perspective) - .userId(1L) + .user(user) .content("댓글") .build(); ReflectionTestUtils.setField(comment, "id", generateId()); ReflectionTestUtils.setField(comment, "createdAt", LocalDateTime.now()); - Battle battle = createBattle("배틀"); - ReflectionTestUtils.setField(battle, "id", battleId); - BattleOption option = createOption(battle, BattleOptionLabel.A); - ReflectionTestUtils.setField(option, "id", optionId); - when(userService.findCurrentUser()).thenReturn(user); when(perspectiveQueryService.findUserComments(1L, 0, 20)).thenReturn(List.of(comment)); when(perspectiveQueryService.countUserComments(1L)).thenReturn(1L); @@ -268,28 +266,26 @@ void getContentActivities_returns_comments() { @DisplayName("LIKE 타입으로 좋아요활동을 반환한다") void getContentActivities_returns_likes() { User user = createUser(1L, "tag"); - Long battleId = generateId(); - Long optionId = generateId(); + Battle battle = createBattle("배틀"); + Long battleId = battle.getId(); + BattleOption option = createOption(battle, BattleOptionLabel.B); + Long optionId = option.getId(); + Perspective perspective = Perspective.builder() - .battleId(battleId) - .userId(1L) - .optionId(optionId) + .battle(battle) + .user(user) + .option(option) .content("관점 내용") .build(); ReflectionTestUtils.setField(perspective, "id", generateId()); PerspectiveLike like = PerspectiveLike.builder() .perspective(perspective) - .userId(1L) + .user(user) .build(); ReflectionTestUtils.setField(like, "id", generateId()); ReflectionTestUtils.setField(like, "createdAt", LocalDateTime.now()); - Battle battle = createBattle("배틀"); - ReflectionTestUtils.setField(battle, "id", battleId); - BattleOption option = createOption(battle, BattleOptionLabel.B); - ReflectionTestUtils.setField(option, "id", optionId); - when(userService.findCurrentUser()).thenReturn(user); when(perspectiveQueryService.findUserLikes(1L, 0, 20)).thenReturn(List.of(like)); when(perspectiveQueryService.countUserLikes(1L)).thenReturn(1L); From a2b753ed111882cf680619f28276832f4072ea8f Mon Sep 17 00:00:00 2001 From: Dante0922 <101305519+Dante0922@users.noreply.github.com> Date: Sun, 29 Mar 2026 08:17:45 +0900 Subject: [PATCH 31/70] =?UTF-8?q?#67=20=EC=95=8C=EB=A6=BC(Notification)=20?= =?UTF-8?q?=EB=8F=84=EB=A9=94=EC=9D=B8=20=EC=8B=A0=EC=84=A4=20=EB=B0=8F=20?= =?UTF-8?q?notice=20=ED=86=B5=ED=95=A9=20(#68)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 신규 소셜 가입 user 초기화 및 조회 로직 수정 (Hotfix) - `notification` 도메인 신설: 알림 적재(개인/브로드캐스트), 목록 조회(카테고리 필터, 페이지네이션), 읽음 처리 - `notice` 도메인 전체 삭제 → `notification`으로 통합 (공지/이벤트는 `user=null` 브로드캐스트) - MypageController의 notice 엔드포인트 제거, HomeService를 NotificationService로 전환 --- .../app/domain/home/service/HomeService.java | 10 +- .../notice/controller/NoticeController.java | 41 ------ .../dto/response/NoticeDetailResponse.java | 19 --- .../dto/response/NoticeListResponse.java | 9 -- .../dto/response/NoticeSummaryResponse.java | 18 --- .../swyp/app/domain/notice/entity/Notice.java | 61 --------- .../domain/notice/entity/NoticePlacement.java | 6 - .../app/domain/notice/entity/NoticeType.java | 6 - .../domain/notice/enums/NoticePlacement.java | 6 - .../app/domain/notice/enums/NoticeType.java | 6 - .../notice/repository/NoticeRepository.java | 35 ----- .../domain/notice/service/NoticeService.java | 71 ---------- .../controller/NotificationController.java | 53 ++++++++ .../response/NotificationListResponse.java | 8 ++ .../response/NotificationSummaryResponse.java | 17 +++ .../notification/entity/Notification.java | 73 +++++++++++ .../enums/NotificationCategory.java | 8 ++ .../enums/NotificationDetailCode.java | 24 ++++ .../repository/NotificationRepository.java | 34 +++++ .../service/NotificationService.java | 108 +++++++++++++++ .../app/domain/oauth/service/AuthService.java | 41 +++++- .../user/controller/MypageController.java | 14 -- .../dto/response/NoticeDetailResponse.java | 15 --- .../user/dto/response/NoticeListResponse.java | 21 --- .../repository/UserSettingsRepository.java | 3 + .../UserTendencyScoreRepository.java | 3 + .../domain/user/service/MypageService.java | 31 ----- .../app/domain/user/service/UserService.java | 6 +- .../global/common/exception/ErrorCode.java | 3 + .../domain/home/service/HomeServiceTest.java | 36 ++--- .../notice/service/NoticeServiceTest.java | 67 ---------- .../service/NotificationServiceTest.java | 124 ++++++++++++++++++ .../oauth/service/OAuthServiceTest.java | 40 +++++- .../user/service/MypageServiceTest.java | 48 ------- .../domain/user/service/UserServiceTest.java | 10 +- 35 files changed, 557 insertions(+), 518 deletions(-) delete mode 100644 src/main/java/com/swyp/app/domain/notice/controller/NoticeController.java delete mode 100644 src/main/java/com/swyp/app/domain/notice/dto/response/NoticeDetailResponse.java delete mode 100644 src/main/java/com/swyp/app/domain/notice/dto/response/NoticeListResponse.java delete mode 100644 src/main/java/com/swyp/app/domain/notice/dto/response/NoticeSummaryResponse.java delete mode 100644 src/main/java/com/swyp/app/domain/notice/entity/Notice.java delete mode 100644 src/main/java/com/swyp/app/domain/notice/entity/NoticePlacement.java delete mode 100644 src/main/java/com/swyp/app/domain/notice/entity/NoticeType.java delete mode 100644 src/main/java/com/swyp/app/domain/notice/enums/NoticePlacement.java delete mode 100644 src/main/java/com/swyp/app/domain/notice/enums/NoticeType.java delete mode 100644 src/main/java/com/swyp/app/domain/notice/repository/NoticeRepository.java delete mode 100644 src/main/java/com/swyp/app/domain/notice/service/NoticeService.java create mode 100644 src/main/java/com/swyp/app/domain/notification/controller/NotificationController.java create mode 100644 src/main/java/com/swyp/app/domain/notification/dto/response/NotificationListResponse.java create mode 100644 src/main/java/com/swyp/app/domain/notification/dto/response/NotificationSummaryResponse.java create mode 100644 src/main/java/com/swyp/app/domain/notification/entity/Notification.java create mode 100644 src/main/java/com/swyp/app/domain/notification/enums/NotificationCategory.java create mode 100644 src/main/java/com/swyp/app/domain/notification/enums/NotificationDetailCode.java create mode 100644 src/main/java/com/swyp/app/domain/notification/repository/NotificationRepository.java create mode 100644 src/main/java/com/swyp/app/domain/notification/service/NotificationService.java delete mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/NoticeDetailResponse.java delete mode 100644 src/main/java/com/swyp/app/domain/user/dto/response/NoticeListResponse.java delete mode 100644 src/test/java/com/swyp/app/domain/notice/service/NoticeServiceTest.java create mode 100644 src/test/java/com/swyp/app/domain/notification/service/NotificationServiceTest.java diff --git a/src/main/java/com/swyp/app/domain/home/service/HomeService.java b/src/main/java/com/swyp/app/domain/home/service/HomeService.java index ee31bb8..2bb1ee9 100644 --- a/src/main/java/com/swyp/app/domain/home/service/HomeService.java +++ b/src/main/java/com/swyp/app/domain/home/service/HomeService.java @@ -8,8 +8,8 @@ import com.swyp.app.domain.tag.enums.TagType; import com.swyp.app.domain.battle.service.BattleService; import com.swyp.app.domain.home.dto.response.*; -import com.swyp.app.domain.notice.enums.NoticePlacement; -import com.swyp.app.domain.notice.service.NoticeService; +import com.swyp.app.domain.notification.enums.NotificationCategory; +import com.swyp.app.domain.notification.service.NotificationService; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; @@ -22,13 +22,11 @@ @Transactional(readOnly = true) public class HomeService { - private static final int NOTICE_EXISTS_LIMIT = 1; - private final BattleService battleService; - private final NoticeService noticeService; + private final NotificationService notificationService; public HomeResponse getHome() { - boolean newNotice = !noticeService.getActiveNotices(NoticePlacement.HOME_TOP, null, NOTICE_EXISTS_LIMIT).isEmpty(); + boolean newNotice = notificationService.hasNewBroadcast(NotificationCategory.NOTICE); List editorPickRaw = battleService.getEditorPicks(); List trendingRaw = battleService.getTrendingBattles(); diff --git a/src/main/java/com/swyp/app/domain/notice/controller/NoticeController.java b/src/main/java/com/swyp/app/domain/notice/controller/NoticeController.java deleted file mode 100644 index bc05403..0000000 --- a/src/main/java/com/swyp/app/domain/notice/controller/NoticeController.java +++ /dev/null @@ -1,41 +0,0 @@ -package com.swyp.app.domain.notice.controller; - -import com.swyp.app.domain.notice.dto.response.NoticeDetailResponse; -import com.swyp.app.domain.notice.dto.response.NoticeListResponse; -import com.swyp.app.domain.notice.enums.NoticePlacement; -import com.swyp.app.domain.notice.enums.NoticeType; -import com.swyp.app.domain.notice.service.NoticeService; -import com.swyp.app.global.common.response.ApiResponse; -import io.swagger.v3.oas.annotations.Operation; -import io.swagger.v3.oas.annotations.tags.Tag; -import lombok.RequiredArgsConstructor; -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 = "공지 API", description = "공지사항 조회") -@RestController -@RequiredArgsConstructor -@RequestMapping("/api/v1/notices") -public class NoticeController { - - private final NoticeService noticeService; - - @Operation(summary = "활성 공지 목록 조회") - @GetMapping - public ApiResponse getNotices( - @RequestParam(required = false) NoticeType type, - @RequestParam(required = false) NoticePlacement placement, - @RequestParam(required = false) Integer limit - ) { - return ApiResponse.onSuccess(noticeService.getNoticeList(type, placement, limit)); - } - - @Operation(summary = "활성 공지 상세 조회") - @GetMapping("/{noticeId}") - public ApiResponse getNoticeDetail(@PathVariable Long noticeId) { - return ApiResponse.onSuccess(noticeService.getNoticeDetail(noticeId)); - } -} diff --git a/src/main/java/com/swyp/app/domain/notice/dto/response/NoticeDetailResponse.java b/src/main/java/com/swyp/app/domain/notice/dto/response/NoticeDetailResponse.java deleted file mode 100644 index 0a23be8..0000000 --- a/src/main/java/com/swyp/app/domain/notice/dto/response/NoticeDetailResponse.java +++ /dev/null @@ -1,19 +0,0 @@ -package com.swyp.app.domain.notice.dto.response; - -import com.swyp.app.domain.notice.enums.NoticePlacement; -import com.swyp.app.domain.notice.enums.NoticeType; - -import java.time.LocalDateTime; - -public record NoticeDetailResponse( - Long noticeId, - String title, - String body, - NoticeType type, - NoticePlacement placement, - boolean pinned, - LocalDateTime startsAt, - LocalDateTime endsAt, - LocalDateTime createdAt -) { -} diff --git a/src/main/java/com/swyp/app/domain/notice/dto/response/NoticeListResponse.java b/src/main/java/com/swyp/app/domain/notice/dto/response/NoticeListResponse.java deleted file mode 100644 index d83f91a..0000000 --- a/src/main/java/com/swyp/app/domain/notice/dto/response/NoticeListResponse.java +++ /dev/null @@ -1,9 +0,0 @@ -package com.swyp.app.domain.notice.dto.response; - -import java.util.List; - -public record NoticeListResponse( - List items, - int totalCount -) { -} diff --git a/src/main/java/com/swyp/app/domain/notice/dto/response/NoticeSummaryResponse.java b/src/main/java/com/swyp/app/domain/notice/dto/response/NoticeSummaryResponse.java deleted file mode 100644 index f72b9c9..0000000 --- a/src/main/java/com/swyp/app/domain/notice/dto/response/NoticeSummaryResponse.java +++ /dev/null @@ -1,18 +0,0 @@ -package com.swyp.app.domain.notice.dto.response; - -import com.swyp.app.domain.notice.enums.NoticePlacement; -import com.swyp.app.domain.notice.enums.NoticeType; - -import java.time.LocalDateTime; - -public record NoticeSummaryResponse( - Long noticeId, - String title, - String body, - NoticeType type, - NoticePlacement placement, - boolean pinned, - LocalDateTime startsAt, - LocalDateTime endsAt -) { -} diff --git a/src/main/java/com/swyp/app/domain/notice/entity/Notice.java b/src/main/java/com/swyp/app/domain/notice/entity/Notice.java deleted file mode 100644 index 5563848..0000000 --- a/src/main/java/com/swyp/app/domain/notice/entity/Notice.java +++ /dev/null @@ -1,61 +0,0 @@ -package com.swyp.app.domain.notice.entity; - -import com.swyp.app.domain.notice.enums.NoticePlacement; -import com.swyp.app.domain.notice.enums.NoticeType; -import com.swyp.app.global.common.BaseEntity; -import jakarta.persistence.Column; -import jakarta.persistence.Entity; -import jakarta.persistence.EnumType; -import jakarta.persistence.Enumerated; -import jakarta.persistence.Table; -import lombok.AccessLevel; -import lombok.Builder; -import lombok.Getter; -import lombok.NoArgsConstructor; - -import java.time.LocalDateTime; - -@Getter -@Entity -@Table(name = "notices") -@NoArgsConstructor(access = AccessLevel.PROTECTED) -public class Notice extends BaseEntity { - - @Column(nullable = false, length = 150) - private String title; - - @Column(nullable = false, columnDefinition = "TEXT") - private String body; - - @Enumerated(EnumType.STRING) - @Column(name = "notice_type", nullable = false, length = 30) - private NoticeType type; - - @Enumerated(EnumType.STRING) - @Column(nullable = false, length = 30) - private NoticePlacement placement; - - @Column(name = "is_pinned", nullable = false) - private boolean pinned; - - @Column(name = "starts_at", nullable = false) - private LocalDateTime startsAt; - - @Column(name = "ends_at") - private LocalDateTime endsAt; - - @Column(name = "deleted_at") - private LocalDateTime deletedAt; - - @Builder - private Notice(String title, String body, NoticeType type, NoticePlacement placement, boolean pinned, - LocalDateTime startsAt, LocalDateTime endsAt) { - this.title = title; - this.body = body; - this.type = type; - this.placement = placement; - this.pinned = pinned; - this.startsAt = startsAt; - this.endsAt = endsAt; - } -} diff --git a/src/main/java/com/swyp/app/domain/notice/entity/NoticePlacement.java b/src/main/java/com/swyp/app/domain/notice/entity/NoticePlacement.java deleted file mode 100644 index 180382e..0000000 --- a/src/main/java/com/swyp/app/domain/notice/entity/NoticePlacement.java +++ /dev/null @@ -1,6 +0,0 @@ -package com.swyp.app.domain.notice.entity; - -public enum NoticePlacement { - HOME_TOP, - NOTICE_BOARD -} diff --git a/src/main/java/com/swyp/app/domain/notice/entity/NoticeType.java b/src/main/java/com/swyp/app/domain/notice/entity/NoticeType.java deleted file mode 100644 index be76097..0000000 --- a/src/main/java/com/swyp/app/domain/notice/entity/NoticeType.java +++ /dev/null @@ -1,6 +0,0 @@ -package com.swyp.app.domain.notice.entity; - -public enum NoticeType { - ANNOUNCEMENT, - EVENT -} diff --git a/src/main/java/com/swyp/app/domain/notice/enums/NoticePlacement.java b/src/main/java/com/swyp/app/domain/notice/enums/NoticePlacement.java deleted file mode 100644 index 83564bd..0000000 --- a/src/main/java/com/swyp/app/domain/notice/enums/NoticePlacement.java +++ /dev/null @@ -1,6 +0,0 @@ -package com.swyp.app.domain.notice.enums; - -public enum NoticePlacement { - HOME_TOP, - NOTICE_BOARD -} diff --git a/src/main/java/com/swyp/app/domain/notice/enums/NoticeType.java b/src/main/java/com/swyp/app/domain/notice/enums/NoticeType.java deleted file mode 100644 index edf16d7..0000000 --- a/src/main/java/com/swyp/app/domain/notice/enums/NoticeType.java +++ /dev/null @@ -1,6 +0,0 @@ -package com.swyp.app.domain.notice.enums; - -public enum NoticeType { - ANNOUNCEMENT, - EVENT -} diff --git a/src/main/java/com/swyp/app/domain/notice/repository/NoticeRepository.java b/src/main/java/com/swyp/app/domain/notice/repository/NoticeRepository.java deleted file mode 100644 index b8bfd85..0000000 --- a/src/main/java/com/swyp/app/domain/notice/repository/NoticeRepository.java +++ /dev/null @@ -1,35 +0,0 @@ -package com.swyp.app.domain.notice.repository; - -import com.swyp.app.domain.notice.entity.Notice; -import com.swyp.app.domain.notice.enums.NoticePlacement; -import com.swyp.app.domain.notice.enums.NoticeType; -import org.springframework.data.domain.Pageable; -import org.springframework.data.jpa.repository.JpaRepository; -import org.springframework.data.jpa.repository.Query; -import org.springframework.data.repository.query.Param; - -import java.time.LocalDateTime; -import java.util.List; -import java.util.Optional; - -public interface NoticeRepository extends JpaRepository { - - @Query("SELECT notice FROM Notice notice " + - "WHERE notice.deletedAt IS NULL " + - "AND notice.startsAt <= :now " + - "AND (notice.endsAt IS NULL OR notice.endsAt >= :now) " + - "AND (:type IS NULL OR notice.type = :type) " + - "AND (:placement IS NULL OR notice.placement = :placement) " + - "ORDER BY notice.pinned DESC, notice.startsAt DESC, notice.createdAt DESC") - List findActiveNotices(@Param("now") LocalDateTime now, - @Param("type") NoticeType type, - @Param("placement") NoticePlacement placement, - Pageable pageable); - - @Query("SELECT notice FROM Notice notice " + - "WHERE notice.id = :noticeId " + - "AND notice.deletedAt IS NULL " + - "AND notice.startsAt <= :now " + - "AND (notice.endsAt IS NULL OR notice.endsAt >= :now)") - Optional findActiveById(@Param("noticeId") Long noticeId, @Param("now") LocalDateTime now); -} diff --git a/src/main/java/com/swyp/app/domain/notice/service/NoticeService.java b/src/main/java/com/swyp/app/domain/notice/service/NoticeService.java deleted file mode 100644 index 411c771..0000000 --- a/src/main/java/com/swyp/app/domain/notice/service/NoticeService.java +++ /dev/null @@ -1,71 +0,0 @@ -package com.swyp.app.domain.notice.service; - -import com.swyp.app.domain.notice.dto.response.NoticeDetailResponse; -import com.swyp.app.domain.notice.dto.response.NoticeListResponse; -import com.swyp.app.domain.notice.dto.response.NoticeSummaryResponse; -import com.swyp.app.domain.notice.entity.Notice; -import com.swyp.app.domain.notice.enums.NoticePlacement; -import com.swyp.app.domain.notice.enums.NoticeType; -import com.swyp.app.domain.notice.repository.NoticeRepository; -import com.swyp.app.global.common.exception.CustomException; -import com.swyp.app.global.common.exception.ErrorCode; -import lombok.RequiredArgsConstructor; -import org.springframework.data.domain.PageRequest; -import org.springframework.stereotype.Service; -import org.springframework.transaction.annotation.Transactional; - -import java.time.LocalDateTime; -import java.util.List; - -@Service -@RequiredArgsConstructor -@Transactional(readOnly = true) -public class NoticeService { - - private static final int DEFAULT_LIMIT = 20; - - private final NoticeRepository noticeRepository; - - public List getActiveNotices(NoticePlacement placement, NoticeType type, Integer limit) { - int pageSize = limit == null || limit <= 0 ? DEFAULT_LIMIT : limit; - return noticeRepository.findActiveNotices(LocalDateTime.now(), type, placement, PageRequest.of(0, pageSize)) - .stream() - .map(this::toSummaryResponse) - .toList(); - } - - public NoticeListResponse getNoticeList(NoticeType type, NoticePlacement placement, Integer limit) { - List items = getActiveNotices(placement, type, limit); - return new NoticeListResponse(items, items.size()); - } - - public NoticeDetailResponse getNoticeDetail(Long noticeId) { - Notice notice = noticeRepository.findActiveById(noticeId, LocalDateTime.now()) - .orElseThrow(() -> new CustomException(ErrorCode.NOTICE_NOT_FOUND)); - - return new NoticeDetailResponse( - notice.getId(), - notice.getTitle(), - notice.getBody(), - notice.getType(), - notice.getPlacement(), - notice.isPinned(), - notice.getStartsAt(), - notice.getEndsAt(), - notice.getCreatedAt() - ); - } - - private NoticeSummaryResponse toSummaryResponse(Notice notice) { - return new NoticeSummaryResponse( - notice.getId(), - notice.getTitle(), - notice.getBody(), - notice.getType(), - notice.getPlacement(), - notice.isPinned(), - notice.getStartsAt(), - notice.getEndsAt() - ); - } -} diff --git a/src/main/java/com/swyp/app/domain/notification/controller/NotificationController.java b/src/main/java/com/swyp/app/domain/notification/controller/NotificationController.java new file mode 100644 index 0000000..5dbbfcc --- /dev/null +++ b/src/main/java/com/swyp/app/domain/notification/controller/NotificationController.java @@ -0,0 +1,53 @@ +package com.swyp.app.domain.notification.controller; + +import com.swyp.app.domain.notification.dto.response.NotificationListResponse; +import com.swyp.app.domain.notification.enums.NotificationCategory; +import com.swyp.app.domain.notification.service.NotificationService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import lombok.RequiredArgsConstructor; +import org.springframework.security.core.annotation.AuthenticationPrincipal; +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.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; +import org.springframework.web.bind.annotation.RestController; + +@Tag(name = "알림 API", description = "알림 조회 및 읽음 처리") +@RestController +@RequiredArgsConstructor +@RequestMapping("/api/v1/notifications") +public class NotificationController { + + private final NotificationService notificationService; + + @Operation(summary = "알림 목록 조회") + @GetMapping + public ApiResponse getNotifications( + @AuthenticationPrincipal Long userId, + @RequestParam(required = false) NotificationCategory category, + @RequestParam(defaultValue = "0") int page, + @RequestParam(defaultValue = "20") int size + ) { + return ApiResponse.onSuccess(notificationService.getNotifications(userId, category, page, size)); + } + + @Operation(summary = "알림 개별 읽음 처리") + @PatchMapping("/{notificationId}/read") + public ApiResponse markAsRead( + @AuthenticationPrincipal Long userId, + @PathVariable Long notificationId + ) { + notificationService.markAsRead(userId, notificationId); + return ApiResponse.onSuccess(null); + } + + @Operation(summary = "알림 전체 읽음 처리") + @PatchMapping("/read-all") + public ApiResponse markAllAsRead(@AuthenticationPrincipal Long userId) { + notificationService.markAllAsRead(userId); + return ApiResponse.onSuccess(null); + } +} diff --git a/src/main/java/com/swyp/app/domain/notification/dto/response/NotificationListResponse.java b/src/main/java/com/swyp/app/domain/notification/dto/response/NotificationListResponse.java new file mode 100644 index 0000000..68d03ab --- /dev/null +++ b/src/main/java/com/swyp/app/domain/notification/dto/response/NotificationListResponse.java @@ -0,0 +1,8 @@ +package com.swyp.app.domain.notification.dto.response; + +import java.util.List; + +public record NotificationListResponse( + List items, + boolean hasNext +) {} diff --git a/src/main/java/com/swyp/app/domain/notification/dto/response/NotificationSummaryResponse.java b/src/main/java/com/swyp/app/domain/notification/dto/response/NotificationSummaryResponse.java new file mode 100644 index 0000000..56ffb3a --- /dev/null +++ b/src/main/java/com/swyp/app/domain/notification/dto/response/NotificationSummaryResponse.java @@ -0,0 +1,17 @@ +package com.swyp.app.domain.notification.dto.response; + +import com.swyp.app.domain.notification.enums.NotificationCategory; +import com.swyp.app.domain.notification.enums.NotificationDetailCode; + +import java.time.LocalDateTime; + +public record NotificationSummaryResponse( + Long notificationId, + NotificationCategory category, + int detailCode, + String title, + String body, + Long referenceId, + boolean isRead, + LocalDateTime createdAt +) {} diff --git a/src/main/java/com/swyp/app/domain/notification/entity/Notification.java b/src/main/java/com/swyp/app/domain/notification/entity/Notification.java new file mode 100644 index 0000000..7d8dff6 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/notification/entity/Notification.java @@ -0,0 +1,73 @@ +package com.swyp.app.domain.notification.entity; + +import com.swyp.app.domain.notification.enums.NotificationCategory; +import com.swyp.app.domain.notification.enums.NotificationDetailCode; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.EnumType; +import jakarta.persistence.Enumerated; +import jakarta.persistence.FetchType; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; +import jakarta.persistence.Table; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +import java.time.LocalDateTime; + +@Getter +@Entity +@Table(name = "notifications") +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class Notification extends BaseEntity { + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id") + private User user; + + @Enumerated(EnumType.STRING) + @Column(nullable = false, length = 20) + private NotificationCategory category; + + @Enumerated(EnumType.STRING) + @Column(name = "detail_code", nullable = false, length = 30) + private NotificationDetailCode detailCode; + + @Column(nullable = false, length = 150) + private String title; + + @Column(columnDefinition = "TEXT") + private String body; + + @Column(name = "reference_id") + private Long referenceId; + + @Column(name = "is_read", nullable = false) + private boolean read; + + @Column(name = "read_at") + private LocalDateTime readAt; + + @Builder + private Notification(User user, NotificationCategory category, NotificationDetailCode detailCode, + String title, String body, Long referenceId) { + this.user = user; + this.category = category; + this.detailCode = detailCode; + this.title = title; + this.body = body; + this.referenceId = referenceId; + this.read = false; + } + + public void markAsRead() { + if (!this.read) { + this.read = true; + this.readAt = LocalDateTime.now(); + } + } +} diff --git a/src/main/java/com/swyp/app/domain/notification/enums/NotificationCategory.java b/src/main/java/com/swyp/app/domain/notification/enums/NotificationCategory.java new file mode 100644 index 0000000..0429c3c --- /dev/null +++ b/src/main/java/com/swyp/app/domain/notification/enums/NotificationCategory.java @@ -0,0 +1,8 @@ +package com.swyp.app.domain.notification.enums; + +public enum NotificationCategory { + ALL, + CONTENT, + NOTICE, + EVENT +} diff --git a/src/main/java/com/swyp/app/domain/notification/enums/NotificationDetailCode.java b/src/main/java/com/swyp/app/domain/notification/enums/NotificationDetailCode.java new file mode 100644 index 0000000..0720cc1 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/notification/enums/NotificationDetailCode.java @@ -0,0 +1,24 @@ +package com.swyp.app.domain.notification.enums; + +import lombok.Getter; +import lombok.RequiredArgsConstructor; + +@Getter +@RequiredArgsConstructor +public enum NotificationDetailCode { + + // CONTENT (1~3) + NEW_BATTLE(1, NotificationCategory.CONTENT, "새로운 배틀이 시작되었어요"), + VOTE_RESULT(2, NotificationCategory.CONTENT, "투표 결과가 나왔어요"), + CREDIT_EARNED(3, NotificationCategory.CONTENT, "포인트 적립"), + + // NOTICE (4) + POLICY_CHANGE(4, NotificationCategory.NOTICE, "공지사항"), + + // EVENT (5) + PROMOTION(5, NotificationCategory.EVENT, "이벤트"); + + private final int code; + private final NotificationCategory category; + private final String defaultTitle; +} diff --git a/src/main/java/com/swyp/app/domain/notification/repository/NotificationRepository.java b/src/main/java/com/swyp/app/domain/notification/repository/NotificationRepository.java new file mode 100644 index 0000000..cd49b5b --- /dev/null +++ b/src/main/java/com/swyp/app/domain/notification/repository/NotificationRepository.java @@ -0,0 +1,34 @@ +package com.swyp.app.domain.notification.repository; + +import com.swyp.app.domain.notification.entity.Notification; +import com.swyp.app.domain.notification.enums.NotificationCategory; +import org.springframework.data.domain.Pageable; +import org.springframework.data.domain.Slice; +import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Modifying; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.query.Param; + +public interface NotificationRepository extends JpaRepository { + + @Query(""" + SELECT n FROM Notification n + WHERE (n.user.id = :userId OR n.user IS NULL) + AND (:category IS NULL OR n.category = :category) + ORDER BY n.createdAt DESC + """) + Slice findByUserOrBroadcast( + @Param("userId") Long userId, + @Param("category") NotificationCategory category, + Pageable pageable + ); + + boolean existsByUserIsNullAndCategory(NotificationCategory category); + + @Modifying + @Query(""" + UPDATE Notification n SET n.read = true, n.readAt = CURRENT_TIMESTAMP + WHERE n.user.id = :userId AND n.read = false + """) + int markAllAsReadByUserId(@Param("userId") Long userId); +} diff --git a/src/main/java/com/swyp/app/domain/notification/service/NotificationService.java b/src/main/java/com/swyp/app/domain/notification/service/NotificationService.java new file mode 100644 index 0000000..dc05b05 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/notification/service/NotificationService.java @@ -0,0 +1,108 @@ +package com.swyp.app.domain.notification.service; + +import com.swyp.app.domain.notification.dto.response.NotificationListResponse; +import com.swyp.app.domain.notification.dto.response.NotificationSummaryResponse; +import com.swyp.app.domain.notification.entity.Notification; +import com.swyp.app.domain.notification.enums.NotificationCategory; +import com.swyp.app.domain.notification.enums.NotificationDetailCode; +import com.swyp.app.domain.notification.repository.NotificationRepository; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.repository.UserRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.PageRequest; +import org.springframework.data.domain.Slice; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class NotificationService { + + private static final int DEFAULT_PAGE_SIZE = 20; + + private final NotificationRepository notificationRepository; + private final UserRepository userRepository; + + @Transactional + public Notification createNotification(Long userId, NotificationDetailCode detailCode, String body, Long referenceId) { + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + + Notification notification = Notification.builder() + .user(user) + .category(detailCode.getCategory()) + .detailCode(detailCode) + .title(detailCode.getDefaultTitle()) + .body(body) + .referenceId(referenceId) + .build(); + + return notificationRepository.save(notification); + } + + @Transactional + public Notification createBroadcastNotification(NotificationDetailCode detailCode, String body, Long referenceId) { + Notification notification = Notification.builder() + .user(null) + .category(detailCode.getCategory()) + .detailCode(detailCode) + .title(detailCode.getDefaultTitle()) + .body(body) + .referenceId(referenceId) + .build(); + + return notificationRepository.save(notification); + } + + public NotificationListResponse getNotifications(Long userId, NotificationCategory category, int page, int size) { + int pageSize = size <= 0 ? DEFAULT_PAGE_SIZE : size; + NotificationCategory filterCategory = (category == NotificationCategory.ALL) ? null : category; + Slice slice = notificationRepository.findByUserOrBroadcast( + userId, filterCategory, PageRequest.of(page, pageSize)); + + return new NotificationListResponse( + slice.getContent().stream().map(this::toSummaryResponse).toList(), + slice.hasNext() + ); + } + + @Transactional + public void markAsRead(Long userId, Long notificationId) { + Notification notification = notificationRepository.findById(notificationId) + .orElseThrow(() -> new CustomException(ErrorCode.NOTIFICATION_NOT_FOUND)); + + boolean isOwner = notification.getUser() != null && notification.getUser().getId().equals(userId); + boolean isBroadcast = notification.getUser() == null; + + if (!isOwner && !isBroadcast) { + throw new CustomException(ErrorCode.NOTIFICATION_NOT_FOUND); + } + + notification.markAsRead(); + } + + @Transactional + public int markAllAsRead(Long userId) { + return notificationRepository.markAllAsReadByUserId(userId); + } + + public boolean hasNewBroadcast(NotificationCategory category) { + return notificationRepository.existsByUserIsNullAndCategory(category); + } + + private NotificationSummaryResponse toSummaryResponse(Notification notification) { + return new NotificationSummaryResponse( + notification.getId(), + notification.getCategory(), + notification.getDetailCode().getCode(), + notification.getTitle(), + notification.getBody(), + notification.getReferenceId(), + notification.isRead(), + notification.getCreatedAt() + ); + } +} diff --git a/src/main/java/com/swyp/app/domain/oauth/service/AuthService.java b/src/main/java/com/swyp/app/domain/oauth/service/AuthService.java index a5b5a33..f3f3081 100644 --- a/src/main/java/com/swyp/app/domain/oauth/service/AuthService.java +++ b/src/main/java/com/swyp/app/domain/oauth/service/AuthService.java @@ -12,14 +12,21 @@ import com.swyp.app.domain.oauth.repository.UserSocialAccountRepository; import com.swyp.app.domain.user.entity.UserRole; import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.entity.UserProfile; +import com.swyp.app.domain.user.entity.UserSettings; import com.swyp.app.domain.user.entity.UserStatus; +import com.swyp.app.domain.user.entity.UserTendencyScore; +import com.swyp.app.domain.user.repository.UserProfileRepository; import com.swyp.app.domain.user.repository.UserRepository; +import com.swyp.app.domain.user.repository.UserSettingsRepository; +import com.swyp.app.domain.user.repository.UserTendencyScoreRepository; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; +import java.math.BigDecimal; import java.nio.charset.StandardCharsets; import java.security.MessageDigest; import java.security.NoSuchAlgorithmException; @@ -37,6 +44,9 @@ public class AuthService { private final UserRepository userRepository; private final UserSocialAccountRepository socialAccountRepository; private final AuthRefreshTokenRepository refreshTokenRepository; + private final UserProfileRepository userProfileRepository; + private final UserSettingsRepository userSettingsRepository; + private final UserTendencyScoreRepository userTendencyScoreRepository; private final JwtProvider jwtProvider; public LoginResponse login(String provider, LoginRequest request) { @@ -63,6 +73,7 @@ public LoginResponse login(String provider, LoginRequest request) { .status(UserStatus.ACTIVE) .build(); userRepository.save(user); + initializeUserDomain(user); // 소셜 계정 연결 socialAccount = UserSocialAccount.builder() @@ -177,6 +188,34 @@ private String generateUserTag() { return "pique-" + UUID.randomUUID().toString().substring(0, 8); } + private void initializeUserDomain(User user) { + userProfileRepository.save(UserProfile.builder() + .user(user) + .nickname(user.getUserTag()) + .mannerTemperature(BigDecimal.valueOf(36.5)) + .build()); + + userSettingsRepository.save(UserSettings.builder() + .user(user) + .newBattleEnabled(false) + .battleResultEnabled(true) + .commentReplyEnabled(true) + .newCommentEnabled(false) + .contentLikeEnabled(false) + .marketingEventEnabled(true) + .build()); + + userTendencyScoreRepository.save(UserTendencyScore.builder() + .user(user) + .principle(0) + .reason(0) + .individual(0) + .change(0) + .inner(0) + .ideal(0) + .build()); + } + // refresh token 해시 private String hashToken(String token) { try { @@ -187,4 +226,4 @@ private String hashToken(String token) { throw new RuntimeException("토큰 해시 실패", e); } } -} \ No newline at end of file +} diff --git a/src/main/java/com/swyp/app/domain/user/controller/MypageController.java b/src/main/java/com/swyp/app/domain/user/controller/MypageController.java index 84e03e4..62741f0 100644 --- a/src/main/java/com/swyp/app/domain/user/controller/MypageController.java +++ b/src/main/java/com/swyp/app/domain/user/controller/MypageController.java @@ -6,11 +6,8 @@ import com.swyp.app.domain.user.dto.response.ContentActivityListResponse; import com.swyp.app.domain.user.dto.response.MypageResponse; import com.swyp.app.domain.user.dto.response.MyProfileResponse; -import com.swyp.app.domain.user.dto.response.NoticeDetailResponse; -import com.swyp.app.domain.user.dto.response.NoticeListResponse; import com.swyp.app.domain.user.dto.response.NotificationSettingsResponse; import com.swyp.app.domain.user.dto.response.RecapResponse; -import com.swyp.app.domain.notice.enums.NoticeType; import com.swyp.app.domain.user.entity.ActivityType; import com.swyp.app.domain.user.entity.VoteSide; @@ -82,15 +79,4 @@ public ApiResponse updateNotificationSettings( return ApiResponse.onSuccess(mypageService.updateNotificationSettings(request)); } - @GetMapping("/notices") - public ApiResponse getNotices( - @RequestParam(required = false) NoticeType type - ) { - return ApiResponse.onSuccess(mypageService.getNotices(type)); - } - - @GetMapping("/notices/{noticeId}") - public ApiResponse getNoticeDetail(@PathVariable Long noticeId) { - return ApiResponse.onSuccess(mypageService.getNoticeDetail(noticeId)); - } } diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/NoticeDetailResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/NoticeDetailResponse.java deleted file mode 100644 index 845c368..0000000 --- a/src/main/java/com/swyp/app/domain/user/dto/response/NoticeDetailResponse.java +++ /dev/null @@ -1,15 +0,0 @@ -package com.swyp.app.domain.user.dto.response; - -import com.swyp.app.domain.notice.enums.NoticeType; - -import java.time.LocalDateTime; - -public record NoticeDetailResponse( - Long noticeId, - NoticeType type, - String title, - String body, - boolean isPinned, - LocalDateTime publishedAt -) { -} diff --git a/src/main/java/com/swyp/app/domain/user/dto/response/NoticeListResponse.java b/src/main/java/com/swyp/app/domain/user/dto/response/NoticeListResponse.java deleted file mode 100644 index 4b0b1da..0000000 --- a/src/main/java/com/swyp/app/domain/user/dto/response/NoticeListResponse.java +++ /dev/null @@ -1,21 +0,0 @@ -package com.swyp.app.domain.user.dto.response; - -import com.swyp.app.domain.notice.enums.NoticeType; - -import java.time.LocalDateTime; -import java.util.List; - -public record NoticeListResponse( - List items -) { - - public record NoticeItem( - Long noticeId, - NoticeType type, - String title, - String bodyPreview, - boolean isPinned, - LocalDateTime publishedAt - ) { - } -} diff --git a/src/main/java/com/swyp/app/domain/user/repository/UserSettingsRepository.java b/src/main/java/com/swyp/app/domain/user/repository/UserSettingsRepository.java index 6559e6f..2908f0d 100644 --- a/src/main/java/com/swyp/app/domain/user/repository/UserSettingsRepository.java +++ b/src/main/java/com/swyp/app/domain/user/repository/UserSettingsRepository.java @@ -1,7 +1,10 @@ package com.swyp.app.domain.user.repository; import com.swyp.app.domain.user.entity.UserSettings; +import java.util.Optional; import org.springframework.data.jpa.repository.JpaRepository; public interface UserSettingsRepository extends JpaRepository { + + Optional findByUserId(Long userId); } diff --git a/src/main/java/com/swyp/app/domain/user/repository/UserTendencyScoreRepository.java b/src/main/java/com/swyp/app/domain/user/repository/UserTendencyScoreRepository.java index db4324d..770218d 100644 --- a/src/main/java/com/swyp/app/domain/user/repository/UserTendencyScoreRepository.java +++ b/src/main/java/com/swyp/app/domain/user/repository/UserTendencyScoreRepository.java @@ -1,7 +1,10 @@ package com.swyp.app.domain.user.repository; import com.swyp.app.domain.user.entity.UserTendencyScore; +import java.util.Optional; import org.springframework.data.jpa.repository.JpaRepository; public interface UserTendencyScoreRepository extends JpaRepository { + + Optional findByUserId(Long userId); } diff --git a/src/main/java/com/swyp/app/domain/user/service/MypageService.java b/src/main/java/com/swyp/app/domain/user/service/MypageService.java index 3fcd2ba..fc4cefe 100644 --- a/src/main/java/com/swyp/app/domain/user/service/MypageService.java +++ b/src/main/java/com/swyp/app/domain/user/service/MypageService.java @@ -12,12 +12,6 @@ import com.swyp.app.domain.user.dto.response.BattleRecordListResponse; import com.swyp.app.domain.user.dto.response.ContentActivityListResponse; import com.swyp.app.domain.user.dto.response.MypageResponse; -import com.swyp.app.domain.notice.dto.response.NoticeSummaryResponse; -import com.swyp.app.domain.notice.enums.NoticePlacement; -import com.swyp.app.domain.notice.enums.NoticeType; -import com.swyp.app.domain.notice.service.NoticeService; -import com.swyp.app.domain.user.dto.response.NoticeDetailResponse; -import com.swyp.app.domain.user.dto.response.NoticeListResponse; import com.swyp.app.domain.user.dto.response.NotificationSettingsResponse; import com.swyp.app.domain.user.dto.response.RecapResponse; import com.swyp.app.domain.user.dto.response.UserSummary; @@ -49,7 +43,6 @@ public class MypageService { private static final int DEFAULT_PAGE_SIZE = 20; private final UserService userService; - private final NoticeService noticeService; private final CreditService creditService; private final VoteQueryService voteQueryService; private final BattleQueryService battleQueryService; @@ -278,30 +271,6 @@ public NotificationSettingsResponse updateNotificationSettings(UpdateNotificatio return toNotificationSettingsResponse(settings); } - public NoticeListResponse getNotices(NoticeType type) { - List notices = noticeService.getActiveNotices( - NoticePlacement.NOTICE_BOARD, type, null - ); - - List items = notices.stream() - .map(notice -> new NoticeListResponse.NoticeItem( - notice.noticeId(), notice.type(), notice.title(), - notice.body(), notice.pinned(), notice.startsAt() - )) - .toList(); - - return new NoticeListResponse(items); - } - - public NoticeDetailResponse getNoticeDetail(Long noticeId) { - com.swyp.app.domain.notice.dto.response.NoticeDetailResponse notice = - noticeService.getNoticeDetail(noticeId); - return new NoticeDetailResponse( - notice.noticeId(), notice.type(), notice.title(), - notice.body(), notice.pinned(), notice.startsAt() - ); - } - private static final int PHILOSOPHER_CALC_THRESHOLD = 5; private PhilosopherType resolvePhilosopherType(Long userId, UserProfile profile) { diff --git a/src/main/java/com/swyp/app/domain/user/service/UserService.java b/src/main/java/com/swyp/app/domain/user/service/UserService.java index 6275bad..d9d2e08 100644 --- a/src/main/java/com/swyp/app/domain/user/service/UserService.java +++ b/src/main/java/com/swyp/app/domain/user/service/UserService.java @@ -53,17 +53,17 @@ public User findCurrentUser() { } public UserProfile findUserProfile(Long userId) { - return userProfileRepository.findById(userId) + return userProfileRepository.findByUserId(userId) .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); } public UserSettings findUserSettings(Long userId) { - return userSettingsRepository.findById(userId) + return userSettingsRepository.findByUserId(userId) .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); } public UserTendencyScore findUserTendencyScore(Long userId) { - return userTendencyScoreRepository.findById(userId) + return userTendencyScoreRepository.findByUserId(userId) .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); } } diff --git a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java index 553116a..5475497 100644 --- a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java +++ b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java @@ -43,6 +43,9 @@ public enum ErrorCode { // Notice NOTICE_NOT_FOUND(HttpStatus.NOT_FOUND, "NOTICE_404", "존재하지 않는 공지사항입니다."), + // Notification + NOTIFICATION_NOT_FOUND(HttpStatus.NOT_FOUND, "NOTIFICATION_404", "존재하지 않는 알림입니다."), + // Battle BATTLE_NOT_FOUND (HttpStatus.NOT_FOUND, "BATTLE_404", "존재하지 않는 배틀입니다."), BATTLE_CLOSED (HttpStatus.CONFLICT, "BATTLE_409_CLS", "종료된 배틀입니다."), diff --git a/src/test/java/com/swyp/app/domain/home/service/HomeServiceTest.java b/src/test/java/com/swyp/app/domain/home/service/HomeServiceTest.java index 254a194..a558e86 100644 --- a/src/test/java/com/swyp/app/domain/home/service/HomeServiceTest.java +++ b/src/test/java/com/swyp/app/domain/home/service/HomeServiceTest.java @@ -6,9 +6,8 @@ import com.swyp.app.domain.battle.enums.BattleType; import com.swyp.app.domain.battle.service.BattleService; import com.swyp.app.domain.home.dto.response.*; -import com.swyp.app.domain.notice.dto.response.NoticeSummaryResponse; -import com.swyp.app.domain.notice.enums.NoticePlacement; -import com.swyp.app.domain.notice.service.NoticeService; +import com.swyp.app.domain.notification.enums.NotificationCategory; +import com.swyp.app.domain.notification.service.NotificationService; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.extension.ExtendWith; @@ -16,7 +15,6 @@ import org.mockito.Mock; import org.mockito.junit.jupiter.MockitoExtension; -import java.time.LocalDateTime; import java.util.List; import java.util.concurrent.atomic.AtomicLong; @@ -34,7 +32,7 @@ class HomeServiceTest { @Mock private BattleService battleService; @Mock - private NoticeService noticeService; + private NotificationService notificationService; @InjectMocks private HomeService homeService; @@ -55,18 +53,7 @@ void getHome_aggregates_sections_by_spec() { TodayBattleResponse todayQuiz = quiz("quiz-id"); TodayBattleResponse newBattle = battle("new-id", BATTLE); - NoticeSummaryResponse notice = new NoticeSummaryResponse( - generateId(), - "notice", - "body", - null, - NoticePlacement.HOME_TOP, - true, - LocalDateTime.now().minusDays(1), - null - ); - - when(noticeService.getActiveNotices(NoticePlacement.HOME_TOP, null, 1)).thenReturn(List.of(notice)); + when(notificationService.hasNewBroadcast(NotificationCategory.NOTICE)).thenReturn(true); when(battleService.getEditorPicks()).thenReturn(List.of(editorPick)); when(battleService.getTrendingBattles()).thenReturn(List.of(trendingBattle)); when(battleService.getBestBattles()).thenReturn(List.of(bestBattle)); @@ -106,7 +93,7 @@ void getHome_aggregates_sections_by_spec() { @Test @DisplayName("데이터가 없으면 false와 빈리스트를 반환한다") void getHome_returns_false_and_empty_lists_when_no_data() { - when(noticeService.getActiveNotices(NoticePlacement.HOME_TOP, null, 1)).thenReturn(List.of()); + when(notificationService.hasNewBroadcast(NotificationCategory.NOTICE)).thenReturn(false); when(battleService.getEditorPicks()).thenReturn(List.of()); when(battleService.getTrendingBattles()).thenReturn(List.of()); when(battleService.getBestBattles()).thenReturn(List.of()); @@ -130,7 +117,7 @@ void getHome_returns_false_and_empty_lists_when_no_data() { void getHome_excludes_only_editor_pick_ids() { TodayBattleResponse editorPick = battle("editor-only", BATTLE); - when(noticeService.getActiveNotices(NoticePlacement.HOME_TOP, null, 1)).thenReturn(List.of()); + when(notificationService.hasNewBroadcast(NotificationCategory.NOTICE)).thenReturn(false); when(battleService.getEditorPicks()).thenReturn(List.of(editorPick)); when(battleService.getTrendingBattles()).thenReturn(List.of()); when(battleService.getBestBattles()).thenReturn(List.of()); @@ -144,14 +131,9 @@ void getHome_excludes_only_editor_pick_ids() { } @Test - @DisplayName("공지가 여러개여도 newNotice는 true이다") - void getHome_newNotice_true_with_multiple_notices() { - NoticeSummaryResponse notice1 = new NoticeSummaryResponse( - generateId(), "notice1", "body1", null, - NoticePlacement.HOME_TOP, true, LocalDateTime.now().minusDays(1), null - ); - - when(noticeService.getActiveNotices(NoticePlacement.HOME_TOP, null, 1)).thenReturn(List.of(notice1)); + @DisplayName("공지 브로드캐스트가 있으면 newNotice는 true이다") + void getHome_newNotice_true_with_broadcast() { + when(notificationService.hasNewBroadcast(NotificationCategory.NOTICE)).thenReturn(true); when(battleService.getEditorPicks()).thenReturn(List.of()); when(battleService.getTrendingBattles()).thenReturn(List.of()); when(battleService.getBestBattles()).thenReturn(List.of()); diff --git a/src/test/java/com/swyp/app/domain/notice/service/NoticeServiceTest.java b/src/test/java/com/swyp/app/domain/notice/service/NoticeServiceTest.java deleted file mode 100644 index 6f5d196..0000000 --- a/src/test/java/com/swyp/app/domain/notice/service/NoticeServiceTest.java +++ /dev/null @@ -1,67 +0,0 @@ -package com.swyp.app.domain.notice.service; - -import com.swyp.app.domain.notice.entity.Notice; -import com.swyp.app.domain.notice.enums.NoticePlacement; -import com.swyp.app.domain.notice.enums.NoticeType; -import com.swyp.app.domain.notice.repository.NoticeRepository; -import com.swyp.app.global.common.exception.CustomException; -import org.junit.jupiter.api.DisplayName; -import org.junit.jupiter.api.Test; -import org.junit.jupiter.api.extension.ExtendWith; -import org.mockito.InjectMocks; -import org.mockito.Mock; -import org.mockito.junit.jupiter.MockitoExtension; -import org.springframework.data.domain.Pageable; - -import java.time.LocalDateTime; -import java.util.List; -import java.util.Optional; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; -import static org.mockito.ArgumentMatchers.any; -import static org.mockito.ArgumentMatchers.eq; -import static org.mockito.Mockito.when; - -@ExtendWith(MockitoExtension.class) -class NoticeServiceTest { - - @Mock - private NoticeRepository noticeRepository; - - @InjectMocks - private NoticeService noticeService; - - @Test - @DisplayName("활성공지 목록을 개수와 함께 반환한다") - void getNoticeList_returns_active_notices_with_count() { - Notice notice = Notice.builder() - .title("공지") - .body("내용") - .type(NoticeType.ANNOUNCEMENT) - .placement(NoticePlacement.HOME_TOP) - .pinned(true) - .startsAt(LocalDateTime.now().minusDays(1)) - .endsAt(LocalDateTime.now().plusDays(1)) - .build(); - - when(noticeRepository.findActiveNotices(any(LocalDateTime.class), eq(NoticeType.ANNOUNCEMENT), - eq(NoticePlacement.HOME_TOP), any(Pageable.class))).thenReturn(List.of(notice)); - - var response = noticeService.getNoticeList(NoticeType.ANNOUNCEMENT, NoticePlacement.HOME_TOP, 5); - - assertThat(response.totalCount()).isEqualTo(1); - assertThat(response.items()).hasSize(1); - assertThat(response.items().getFirst().title()).isEqualTo("공지"); - } - - @Test - @DisplayName("활성공지가 없으면 예외를 던진다") - void getNoticeDetail_throws_when_no_active_notice() { - Long noticeId = 1L; - when(noticeRepository.findActiveById(eq(noticeId), any(LocalDateTime.class))).thenReturn(Optional.empty()); - - assertThatThrownBy(() -> noticeService.getNoticeDetail(noticeId)) - .isInstanceOf(CustomException.class); - } -} diff --git a/src/test/java/com/swyp/app/domain/notification/service/NotificationServiceTest.java b/src/test/java/com/swyp/app/domain/notification/service/NotificationServiceTest.java new file mode 100644 index 0000000..5b97761 --- /dev/null +++ b/src/test/java/com/swyp/app/domain/notification/service/NotificationServiceTest.java @@ -0,0 +1,124 @@ +package com.swyp.app.domain.notification.service; + +import com.swyp.app.domain.notification.dto.response.NotificationListResponse; +import com.swyp.app.domain.notification.entity.Notification; +import com.swyp.app.domain.notification.enums.NotificationCategory; +import com.swyp.app.domain.notification.enums.NotificationDetailCode; +import com.swyp.app.domain.notification.repository.NotificationRepository; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.repository.UserRepository; +import com.swyp.app.global.common.exception.CustomException; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.extension.ExtendWith; +import org.mockito.ArgumentCaptor; +import org.mockito.InjectMocks; +import org.mockito.Mock; +import org.mockito.junit.jupiter.MockitoExtension; +import org.springframework.data.domain.Pageable; +import org.springframework.data.domain.SliceImpl; + +import java.util.List; +import java.util.Optional; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +@ExtendWith(MockitoExtension.class) +class NotificationServiceTest { + + @Mock + private NotificationRepository notificationRepository; + + @Mock + private UserRepository userRepository; + + @InjectMocks + private NotificationService notificationService; + + @Test + @DisplayName("개인 알림을 생성한다") + void createNotification_creates_personal_notification() { + Long userId = 1L; + User user = createMockUser(); + when(userRepository.findById(userId)).thenReturn(Optional.of(user)); + when(notificationRepository.save(any(Notification.class))).thenAnswer(i -> i.getArgument(0)); + + Notification result = notificationService.createNotification( + userId, NotificationDetailCode.NEW_BATTLE, "새 배틀이 시작되었습니다", 100L); + + assertThat(result.getCategory()).isEqualTo(NotificationCategory.CONTENT); + assertThat(result.getDetailCode()).isEqualTo(NotificationDetailCode.NEW_BATTLE); + assertThat(result.getBody()).isEqualTo("새 배틀이 시작되었습니다"); + assertThat(result.getReferenceId()).isEqualTo(100L); + } + + @Test + @DisplayName("브로드캐스트 알림을 생성한다") + void createBroadcastNotification_creates_with_null_user() { + when(notificationRepository.save(any(Notification.class))).thenAnswer(i -> i.getArgument(0)); + + Notification result = notificationService.createBroadcastNotification( + NotificationDetailCode.POLICY_CHANGE, "서비스 정책이 변경되었습니다", 50L); + + assertThat(result.getUser()).isNull(); + assertThat(result.getCategory()).isEqualTo(NotificationCategory.NOTICE); + assertThat(result.getDetailCode()).isEqualTo(NotificationDetailCode.POLICY_CHANGE); + } + + @Test + @DisplayName("알림 목록을 카테고리별로 조회한다") + void getNotifications_returns_filtered_list() { + Long userId = 1L; + Notification notification = Notification.builder() + .user(null) + .category(NotificationCategory.CONTENT) + .detailCode(NotificationDetailCode.NEW_BATTLE) + .title("새로운 배틀이 시작되었어요") + .body("배틀 내용") + .referenceId(1L) + .build(); + + when(notificationRepository.findByUserOrBroadcast(eq(userId), eq(NotificationCategory.CONTENT), any(Pageable.class))) + .thenReturn(new SliceImpl<>(List.of(notification))); + + NotificationListResponse response = notificationService.getNotifications(userId, NotificationCategory.CONTENT, 0, 20); + + assertThat(response.items()).hasSize(1); + assertThat(response.items().getFirst().category()).isEqualTo(NotificationCategory.CONTENT); + assertThat(response.items().getFirst().detailCode()).isEqualTo(1); + assertThat(response.hasNext()).isFalse(); + } + + @Test + @DisplayName("존재하지 않는 알림 읽음 처리 시 예외를 던진다") + void markAsRead_throws_when_not_found() { + when(notificationRepository.findById(999L)).thenReturn(Optional.empty()); + + assertThatThrownBy(() -> notificationService.markAsRead(1L, 999L)) + .isInstanceOf(CustomException.class); + } + + @Test + @DisplayName("전체 읽음 처리를 실행한다") + void markAllAsRead_calls_repository() { + Long userId = 1L; + when(notificationRepository.markAllAsReadByUserId(userId)).thenReturn(5); + + int count = notificationService.markAllAsRead(userId); + + assertThat(count).isEqualTo(5); + verify(notificationRepository).markAllAsReadByUserId(userId); + } + + private User createMockUser() { + return User.builder() + .userTag("test-user-tag") + .nickname("테스트유저") + .build(); + } +} diff --git a/src/test/java/com/swyp/app/domain/oauth/service/OAuthServiceTest.java b/src/test/java/com/swyp/app/domain/oauth/service/OAuthServiceTest.java index a77bb0b..dc253ce 100644 --- a/src/test/java/com/swyp/app/domain/oauth/service/OAuthServiceTest.java +++ b/src/test/java/com/swyp/app/domain/oauth/service/OAuthServiceTest.java @@ -11,7 +11,10 @@ import com.swyp.app.domain.user.entity.User; import com.swyp.app.domain.user.entity.UserRole; import com.swyp.app.domain.user.entity.UserStatus; +import com.swyp.app.domain.user.repository.UserProfileRepository; import com.swyp.app.domain.user.repository.UserRepository; +import com.swyp.app.domain.user.repository.UserSettingsRepository; +import com.swyp.app.domain.user.repository.UserTendencyScoreRepository; import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.extension.ExtendWith; @@ -33,6 +36,9 @@ class OAuthServiceTest { @Mock private UserRepository userRepository; @Mock private UserSocialAccountRepository socialAccountRepository; @Mock private AuthRefreshTokenRepository refreshTokenRepository; + @Mock private UserProfileRepository userProfileRepository; + @Mock private UserSettingsRepository userSettingsRepository; + @Mock private UserTendencyScoreRepository userTendencyScoreRepository; @Mock private JwtProvider jwtProvider; private AuthService authService; @@ -42,7 +48,9 @@ void setUp() { // 수동 주입으로 안정성 확보 authService = new AuthService( kakaoOAuthClient, googleOAuthClient, userRepository, - socialAccountRepository, refreshTokenRepository, jwtProvider + socialAccountRepository, refreshTokenRepository, + userProfileRepository, userSettingsRepository, userTendencyScoreRepository, + jwtProvider ); } @@ -81,4 +89,32 @@ void setUp() { assertThat(response.isNewUser()).isFalse(); verify(refreshTokenRepository).save(any()); } -} \ No newline at end of file + + @Test + void login_구글_신규유저_기본_user_domain_초기화() { + String provider = "GOOGLE"; + LoginRequest request = new LoginRequest("auth-code", "redirect-uri"); + OAuthUserInfo userInfo = new OAuthUserInfo("google_123", "new@test.com", "profile_url"); + + User savedUser = User.builder() + .userTag("pique-test") + .role(UserRole.USER) + .status(UserStatus.ACTIVE) + .build(); + + when(googleOAuthClient.getAccessToken(anyString(), anyString())).thenReturn("mock-access-token"); + when(googleOAuthClient.getUserInfo(anyString())).thenReturn(userInfo); + when(socialAccountRepository.findByProviderAndProviderUserId(anyString(), anyString())) + .thenReturn(Optional.empty()); + when(userRepository.save(any(User.class))).thenReturn(savedUser); + when(jwtProvider.createAccessToken(any(), anyString())).thenReturn("jwt-access"); + when(jwtProvider.createRefreshToken()).thenReturn("jwt-refresh"); + + LoginResponse response = authService.login(provider, request); + + assertThat(response.isNewUser()).isTrue(); + verify(userProfileRepository).save(any()); + verify(userSettingsRepository).save(any()); + verify(userTendencyScoreRepository).save(any()); + } +} diff --git a/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java b/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java index 08908ac..2141d49 100644 --- a/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java +++ b/src/test/java/com/swyp/app/domain/user/service/MypageServiceTest.java @@ -6,10 +6,6 @@ import com.swyp.app.domain.battle.enums.BattleStatus; import com.swyp.app.domain.battle.enums.BattleType; import com.swyp.app.domain.battle.service.BattleQueryService; -import com.swyp.app.domain.notice.dto.response.NoticeSummaryResponse; -import com.swyp.app.domain.notice.enums.NoticePlacement; -import com.swyp.app.domain.notice.enums.NoticeType; -import com.swyp.app.domain.notice.service.NoticeService; import com.swyp.app.domain.perspective.entity.Perspective; import com.swyp.app.domain.perspective.entity.PerspectiveComment; import com.swyp.app.domain.perspective.entity.PerspectiveLike; @@ -18,8 +14,6 @@ import com.swyp.app.domain.user.dto.response.BattleRecordListResponse; import com.swyp.app.domain.user.dto.response.ContentActivityListResponse; import com.swyp.app.domain.user.dto.response.MypageResponse; -import com.swyp.app.domain.user.dto.response.NoticeDetailResponse; -import com.swyp.app.domain.user.dto.response.NoticeListResponse; import com.swyp.app.domain.user.dto.response.NotificationSettingsResponse; import com.swyp.app.domain.user.dto.response.RecapResponse; import com.swyp.app.domain.user.dto.response.UserSummary; @@ -63,8 +57,6 @@ class MypageServiceTest { @Mock private UserService userService; @Mock - private NoticeService noticeService; - @Mock private CreditService creditService; @Mock private VoteQueryService voteQueryService; @@ -355,46 +347,6 @@ void updateNotificationSettings_updates_and_returns() { assertThat(response.marketingEventEnabled()).isTrue(); } - @Test - @DisplayName("공지사항 목록을 반환한다") - void getNotices_returns_notice_list() { - NoticeSummaryResponse notice = new NoticeSummaryResponse( - 1L, "공지 제목", "본문", - NoticeType.ANNOUNCEMENT, NoticePlacement.NOTICE_BOARD, - true, LocalDateTime.now().minusDays(1), null - ); - - when(noticeService.getActiveNotices(NoticePlacement.NOTICE_BOARD, NoticeType.ANNOUNCEMENT, null)) - .thenReturn(List.of(notice)); - - NoticeListResponse response = mypageService.getNotices(NoticeType.ANNOUNCEMENT); - - assertThat(response.items()).hasSize(1); - assertThat(response.items().get(0).title()).isEqualTo("공지 제목"); - assertThat(response.items().get(0).isPinned()).isTrue(); - } - - @Test - @DisplayName("공지사항 상세를 반환한다") - void getNoticeDetail_returns_notice_detail() { - Long noticeId = 1L; - com.swyp.app.domain.notice.dto.response.NoticeDetailResponse noticeDetail = - new com.swyp.app.domain.notice.dto.response.NoticeDetailResponse( - noticeId, "상세 제목", "상세 본문", - NoticeType.EVENT, NoticePlacement.NOTICE_BOARD, - false, LocalDateTime.now(), null, LocalDateTime.now() - ); - - when(noticeService.getNoticeDetail(noticeId)).thenReturn(noticeDetail); - - NoticeDetailResponse response = mypageService.getNoticeDetail(noticeId); - - assertThat(response.noticeId()).isEqualTo(noticeId); - assertThat(response.title()).isEqualTo("상세 제목"); - assertThat(response.type()).isEqualTo(NoticeType.EVENT); - assertThat(response.isPinned()).isFalse(); - } - private User createUser(Long id, String userTag) { User user = User.builder() .userTag(userTag) diff --git a/src/test/java/com/swyp/app/domain/user/service/UserServiceTest.java b/src/test/java/com/swyp/app/domain/user/service/UserServiceTest.java index 56d530f..409f289 100644 --- a/src/test/java/com/swyp/app/domain/user/service/UserServiceTest.java +++ b/src/test/java/com/swyp/app/domain/user/service/UserServiceTest.java @@ -74,7 +74,7 @@ void findSummaryById_returns_user_summary() { UserProfile profile = createProfile(user, "nick", CharacterType.OWL); when(userRepository.findById(1L)).thenReturn(Optional.of(user)); - when(userProfileRepository.findById(1L)).thenReturn(Optional.of(profile)); + when(userProfileRepository.findByUserId(1L)).thenReturn(Optional.of(profile)); UserSummary summary = userService.findSummaryById(1L); @@ -100,7 +100,7 @@ void updateMyProfile_updates_nickname_and_character() { UserProfile profile = createProfile(user, "oldNick", CharacterType.OWL); when(userRepository.findTopByOrderByIdDesc()).thenReturn(Optional.of(user)); - when(userProfileRepository.findById(1L)).thenReturn(Optional.of(profile)); + when(userProfileRepository.findByUserId(1L)).thenReturn(Optional.of(profile)); UpdateUserProfileRequest request = new UpdateUserProfileRequest("newNick", CharacterType.FOX); MyProfileResponse response = userService.updateMyProfile(request); @@ -116,7 +116,7 @@ void findUserProfile_returns_profile() { User user = createUser(1L, "tag"); UserProfile profile = createProfile(user, "nick", CharacterType.BEAR); - when(userProfileRepository.findById(1L)).thenReturn(Optional.of(profile)); + when(userProfileRepository.findByUserId(1L)).thenReturn(Optional.of(profile)); UserProfile result = userService.findUserProfile(1L); @@ -138,7 +138,7 @@ void findUserSettings_returns_settings() { .marketingEventEnabled(false) .build(); - when(userSettingsRepository.findById(1L)).thenReturn(Optional.of(settings)); + when(userSettingsRepository.findByUserId(1L)).thenReturn(Optional.of(settings)); UserSettings result = userService.findUserSettings(1L); @@ -160,7 +160,7 @@ void findUserTendencyScore_returns_score() { .ideal(60) .build(); - when(userTendencyScoreRepository.findById(1L)).thenReturn(Optional.of(score)); + when(userTendencyScoreRepository.findByUserId(1L)).thenReturn(Optional.of(score)); UserTendencyScore result = userService.findUserTendencyScore(1L); From 68453d0f540e3d21f2db88915b53b40a3a603891 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EC=A4=80=ED=98=81?= <127603139+HYH0804@users.noreply.github.com> Date: Sun, 29 Mar 2026 10:43:57 +0900 Subject: [PATCH 32/70] =?UTF-8?q?#62=20[Feat]=20=ED=9D=A5=EB=AF=B8?= =?UTF-8?q?=EB=A1=9C=EC=9A=B4=20=EB=B0=B0=ED=8B=80=20=EA=B8=B0=EB=8A=A5=20?= =?UTF-8?q?=EC=B6=94=EA=B0=80=20(#70)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## #️⃣ 연관된 이슈 - #62 ## 📝 작업 내용 ### ✨ Feat t | 내용 | 파일 | |------|------| | 철학자 유형 기반 흥미로운 배틀 추천 API 구현 | `RecommendationController.java`, `RecommendationService.java` | | 관점/댓글 신고 API 구현 (10회 누적 시 자동 숨김) | `ReportController.java`, `ReportService.java`, `PerspectiveReport.java`, `CommentReport.java` | | 철학자 결과 공유 딥링크 리다이렉트 페이지 구현 | `ShareController.java`, `result.html` | | 내 투표 내역 응답에 `battleTitle`, `opinionChanged` 추가 | `MyVoteResponse.java`, `VoteConverter.java` | | 관점/댓글 응답에 캐릭터 이미지 Presigned URL 추가 | `PerspectiveService.java`, `PerspectiveCommentService.java` | | 철학자 유형 산출 로직 구현 (투표 이력 기반) | `UserService.java` | | 테스트용 JWT 발급 엔드포인트 추가 | `TestController.java` | ### ♻️ Refactor | 내용 | 파일 | |------|------| | 내 관점 조회 API 상태 필터 제거 및 응답 구조 확장 (`/me/pending` → `/me`) | `PerspectiveController.java`, `PerspectiveService.java`, `MyPerspectiveResponse.java` | | `RecommendationController` userId 추출 방식 `@RequestParam` → `@AuthenticationPrincipal` 변경 | `RecommendationController.java` | ### 🐛 Fix | 내용 | 파일 | |------|------| | `findUserProfile` `findById` → `findByUserId` 수정 (user_id FK 기준 조회) | `UserService.java` | | `PerspectiveStatus`에 `HIDDEN` 추가 및 DB CHECK 제약 조건 대응 | `PerspectiveStatus.java` | ## 📌 공유 사항 > 1. 공유 링크(`GET /result/{userId}`) 내 딥링크 스킴(`picke://`), Android 패키지명(`com.swyp.picke`), iOS App Store ID는 앱팀 확인 후 교체 필요합니다. > 2. 신고 임계값은 현재 10회로 설정되어 있습니다. (`ReportService.REPORT_THRESHOLD`) > 3. 캐릭터/철학자 이미지는 S3 버킷에 `images/characters/`, `images/philosophers/` 경로로 파일이 업로드되어 있어야 Presigned URL이 정상 동작합니다. ## ✅ 체크리스트 - [ x ] Reviewer에 팀원들을 선택했나요? - [ x ] Assignees에 본인을 선택했나요? - [ x ] 컨벤션에 맞는 Type을 선택했나요? - [ x ] Development에 이슈를 연동했나요? - [ x ] Merge 하려는 브랜치가 올바르게 설정되어 있나요? - [ x ] 컨벤션을 지키고 있나요? - [ x ] 로컬에서 실행했을 때 에러가 발생하지 않나요? - [ x ] 팀원들에게 PR 링크 공유를 했나요? ## 📸 스크린샷 ## 💬 리뷰 요구사항 > 1. 천수님이 작업하신 이후 로컬에서 pull 받고 한거라 이미 반영되어있는 코드들이라서 크게 보실건 없습니다. > 2. 그래도 보시겠다 하시면 RecommendationService.java , ReportService.java , ShareController.java에서 출발하여 타임리프의 result.html에서 처리되는 딥링크 , S3 Presigned URL로 바꾼 `PerspectiveService.java`, `PerspectiveCommentService.java` --------- Co-authored-by: Claude Sonnet 4.6 --- .gitignore | 3 +- docker-compose.yml | 2 +- .../battle/repository/BattleRepository.java | 22 ++++ .../swyp/app/domain/oauth/jwt/JwtFilter.java | 4 +- .../controller/CommentLikeController.java | 37 ++++++ .../controller/PerspectiveController.java | 25 ++-- .../controller/ReportController.java | 40 +++++++ .../dto/request/CreatePerspectiveRequest.java | 2 + .../dto/request/UpdatePerspectiveRequest.java | 2 + .../dto/response/CommentListResponse.java | 5 +- .../dto/response/CreateCommentResponse.java | 6 +- .../dto/response/MyPerspectiveResponse.java | 11 +- .../response/PerspectiveDetailResponse.java | 19 +++ .../dto/response/PerspectiveListResponse.java | 7 +- .../perspective/entity/CommentLike.java | 37 ++++++ .../perspective/entity/CommentReport.java | 36 ++++++ .../perspective/entity/Perspective.java | 4 + .../entity/PerspectiveComment.java | 20 ++++ .../perspective/entity/PerspectiveReport.java | 36 ++++++ .../perspective/enums/PerspectiveStatus.java | 2 +- .../repository/CommentLikeRepository.java | 14 +++ .../repository/CommentReportRepository.java | 12 ++ .../PerspectiveReportRepository.java | 12 ++ .../repository/PerspectiveRepository.java | 4 + .../service/CommentLikeService.java | 60 ++++++++++ .../service/PerspectiveCommentService.java | 41 ++++++- .../service/PerspectiveService.java | 68 +++++++++-- .../perspective/service/ReportService.java | 80 +++++++++++++ .../controller/RecommendationController.java | 9 +- .../response/RecommendationListResponse.java | 6 +- .../service/RecommendationService.java | 110 +++++++++++++++++- .../share/controller/ShareController.java | 16 +++ .../test/controller/TestController.java | 17 ++- .../app/domain/user/service/UserService.java | 33 ++++++ .../domain/vote/converter/VoteConverter.java | 7 +- .../vote/dto/response/MyVoteResponse.java | 4 +- .../vote/repository/VoteRepository.java | 12 ++ .../app/domain/vote/service/VoteService.java | 2 + .../domain/vote/service/VoteServiceImpl.java | 7 ++ .../global/common/exception/ErrorCode.java | 5 + .../exception/GlobalExceptionHandler.java | 14 ++- .../app/global/config/SecurityConfig.java | 9 +- .../resources/templates/share/result.html | 92 +++++++++++++++ 43 files changed, 906 insertions(+), 48 deletions(-) create mode 100644 src/main/java/com/swyp/app/domain/perspective/controller/CommentLikeController.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/controller/ReportController.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveDetailResponse.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/entity/CommentLike.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/entity/CommentReport.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveReport.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/repository/CommentLikeRepository.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/repository/CommentReportRepository.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveReportRepository.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/service/CommentLikeService.java create mode 100644 src/main/java/com/swyp/app/domain/perspective/service/ReportService.java create mode 100644 src/main/java/com/swyp/app/domain/share/controller/ShareController.java create mode 100644 src/main/resources/templates/share/result.html diff --git a/.gitignore b/.gitignore index 2020e07..162d997 100644 --- a/.gitignore +++ b/.gitignore @@ -39,4 +39,5 @@ out/ ### Setting ### .env postgres_data/ -src/main/resources/application-local.yml \ No newline at end of file +src/main/resources/application-local.yml +.claude \ No newline at end of file diff --git a/docker-compose.yml b/docker-compose.yml index f3a2073..c2bde65 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -10,7 +10,7 @@ services: POSTGRES_USER: ${DB_USER} POSTGRES_PASSWORD: ${DB_PASSWORD} ports: - - "${DB_PORT}:5433" + - "${DB_PORT}:5432" volumes: - ./postgres_data:/var/lib/postgresql/data networks: diff --git a/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java b/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java index 4c888e0..7d59075 100644 --- a/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java +++ b/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java @@ -72,4 +72,26 @@ public interface BattleRepository extends JpaRepository { "WHERE t.type = 'CATEGORY' AND t.name = :categoryName " + "AND b.status = 'PUBLISHED' AND b.deletedAt IS NULL") long countSearchByCategory(@Param("categoryName") String categoryName); + + // 추천 폴백용: 전체 배틀 대상 인기 점수순 조회 (철학자 유형 로직 미구현 시 사용) + // Score = V*1.0 + C*1.5 + Vw*0.2 + @Query("SELECT b FROM Battle b " + + "WHERE b.id NOT IN :excludeBattleIds " + + "AND b.status = 'PUBLISHED' AND b.deletedAt IS NULL " + + "ORDER BY (b.totalParticipantsCount * 1.0 + b.commentCount * 1.5 + b.viewCount * 0.2) DESC") + List findPopularBattlesExcluding( + @Param("excludeBattleIds") List excludeBattleIds, + Pageable pageable); + + // 추천용: 특정 유저들이 참여한 배틀 중 이미 참여한 배틀 제외하고 인기 점수순 조회 + // Score = V*1.0 + C*1.5 + Vw*0.2 (R은 추후 반영 예정) + @Query("SELECT b FROM Battle b " + + "WHERE b.id IN :candidateBattleIds " + + "AND b.id NOT IN :excludeBattleIds " + + "AND b.status = 'PUBLISHED' AND b.deletedAt IS NULL " + + "ORDER BY (b.totalParticipantsCount * 1.0 + b.commentCount * 1.5 + b.viewCount * 0.2) DESC") + List findRecommendedBattles( + @Param("candidateBattleIds") List candidateBattleIds, + @Param("excludeBattleIds") List excludeBattleIds, + Pageable pageable); } \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/oauth/jwt/JwtFilter.java b/src/main/java/com/swyp/app/domain/oauth/jwt/JwtFilter.java index a25ef4f..5fbf408 100644 --- a/src/main/java/com/swyp/app/domain/oauth/jwt/JwtFilter.java +++ b/src/main/java/com/swyp/app/domain/oauth/jwt/JwtFilter.java @@ -39,7 +39,9 @@ public class JwtFilter extends OncePerRequestFilter { "/swagger-ui", // 스웨거 UI 리소스 전체 "/v3/api-docs", // OpenAPI 스펙 전체 "/api/v1/home", // 홈 화면 - "/api/v1/notices" // 공지사항 + "/api/v1/notices", // 공지사항 + "/api/test", // 테스트용 + "/result" // 공유 링크 리다이렉트 ); @Override diff --git a/src/main/java/com/swyp/app/domain/perspective/controller/CommentLikeController.java b/src/main/java/com/swyp/app/domain/perspective/controller/CommentLikeController.java new file mode 100644 index 0000000..652e01f --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/controller/CommentLikeController.java @@ -0,0 +1,37 @@ +package com.swyp.app.domain.perspective.controller; + +import com.swyp.app.domain.perspective.dto.response.LikeResponse; +import com.swyp.app.domain.perspective.service.CommentLikeService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import lombok.RequiredArgsConstructor; +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 Like)", description = "댓글 좋아요 등록, 취소 API") +@RestController +@RequestMapping("/api/v1") +@RequiredArgsConstructor +public class CommentLikeController { + + private final CommentLikeService commentLikeService; + + @Operation(summary = "댓글 좋아요 등록", description = "특정 댓글에 좋아요를 등록합니다.") + @PostMapping("/comments/{commentId}/likes") + public ApiResponse addLike(@PathVariable Long commentId, + @AuthenticationPrincipal Long userId) { + return ApiResponse.onSuccess(commentLikeService.addLike(commentId, userId)); + } + + @Operation(summary = "댓글 좋아요 취소", description = "특정 댓글에 등록한 좋아요를 취소합니다.") + @DeleteMapping("/comments/{commentId}/likes") + public ApiResponse removeLike(@PathVariable Long commentId, + @AuthenticationPrincipal Long userId) { + return ApiResponse.onSuccess(commentLikeService.removeLike(commentId, userId)); + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java index e1e4bc1..c5971a5 100644 --- a/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java +++ b/src/main/java/com/swyp/app/domain/perspective/controller/PerspectiveController.java @@ -4,6 +4,7 @@ import com.swyp.app.domain.perspective.dto.request.UpdatePerspectiveRequest; import com.swyp.app.domain.perspective.dto.response.CreatePerspectiveResponse; import com.swyp.app.domain.perspective.dto.response.MyPerspectiveResponse; +import com.swyp.app.domain.perspective.dto.response.PerspectiveDetailResponse; import com.swyp.app.domain.perspective.dto.response.PerspectiveListResponse; import com.swyp.app.domain.perspective.dto.response.UpdatePerspectiveResponse; import com.swyp.app.domain.perspective.service.PerspectiveService; @@ -31,6 +32,15 @@ public class PerspectiveController { private final PerspectiveService perspectiveService; + @Operation(summary = "관점 단건 조회", description = "특정 관점의 상세 정보를 조회합니다.") + @GetMapping("/perspectives/{perspectiveId}") + public ApiResponse getPerspectiveDetail( + @PathVariable Long perspectiveId, + @AuthenticationPrincipal Long userId) { + return ApiResponse.onSuccess(perspectiveService.getPerspectiveDetail(perspectiveId, userId)); + } + + // TODO: Prevote 의 여부를 Vote 도메인 개발 이후 교체 @Operation(summary = "관점 생성", description = "특정 배틀에 대한 관점을 생성합니다. 사전 투표가 완료된 경우에만 가능합니다.") @PostMapping("/battles/{battleId}/perspectives") public ApiResponse createPerspective( @@ -41,24 +51,25 @@ public ApiResponse createPerspective( return ApiResponse.onSuccess(perspectiveService.createPerspective(battleId, userId, request)); } - @Operation(summary = "관점 리스트 조회", description = "특정 배틀의 관점 목록을 커서 기반 페이지네이션으로 조회합니다. optionLabel(A/B)로 필터링 가능합니다.") + @Operation(summary = "관점 리스트 조회", description = "특정 배틀의 관점 목록을 커서 기반 페이지네이션으로 조회합니다. optionLabel(A/B)로 필터링, sort(latest/popular)로 정렬 가능합니다.") @GetMapping("/battles/{battleId}/perspectives") public ApiResponse getPerspectives( @PathVariable Long battleId, @AuthenticationPrincipal Long userId, @RequestParam(required = false) String cursor, @RequestParam(required = false) Integer size, - @RequestParam(required = false) String optionLabel + @RequestParam(required = false) String optionLabel, + @RequestParam(required = false, defaultValue = "latest") String sort ) { - return ApiResponse.onSuccess(perspectiveService.getPerspectives(battleId, userId, cursor, size, optionLabel)); + return ApiResponse.onSuccess(perspectiveService.getPerspectives(battleId, userId, cursor, size, optionLabel, sort)); } - @Operation(summary = "내 PENDING 관점 조회", description = "특정 배틀에서 내가 작성한 관점이 PENDING 상태인 경우 반환합니다. PENDING 관점이 없으면 404를 반환합니다.") - @GetMapping("/battles/{battleId}/perspectives/me/pending") - public ApiResponse getMyPendingPerspective( + @Operation(summary = "내 관점 조회", description = "특정 배틀에서 내가 작성한 관점을 조회합니다. 상태(PENDING/PUBLISHED/REJECTED 등)와 무관하게 반환하며, 작성한 관점이 없으면 404를 반환합니다.") + @GetMapping("/battles/{battleId}/perspectives/me") + public ApiResponse getMyPerspective( @PathVariable Long battleId, @AuthenticationPrincipal Long userId) { - return ApiResponse.onSuccess(perspectiveService.getMyPendingPerspective(battleId, userId)); + return ApiResponse.onSuccess(perspectiveService.getMyPerspective(battleId, userId)); } @Operation(summary = "관점 삭제", description = "본인이 작성한 관점을 삭제합니다.") diff --git a/src/main/java/com/swyp/app/domain/perspective/controller/ReportController.java b/src/main/java/com/swyp/app/domain/perspective/controller/ReportController.java new file mode 100644 index 0000000..8bf749d --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/controller/ReportController.java @@ -0,0 +1,40 @@ +package com.swyp.app.domain.perspective.controller; + +import com.swyp.app.domain.perspective.service.ReportService; +import com.swyp.app.global.common.response.ApiResponse; +import io.swagger.v3.oas.annotations.Operation; +import io.swagger.v3.oas.annotations.tags.Tag; +import lombok.RequiredArgsConstructor; +import org.springframework.security.core.annotation.AuthenticationPrincipal; +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 = "신고 (Report)", description = "관점/댓글 신고 API") +@RestController +@RequestMapping("/api/v1") +@RequiredArgsConstructor +public class ReportController { + + private final ReportService reportService; + + @Operation(summary = "관점 신고", description = "관점을 신고합니다. 신고 5회 누적 시 자동 숨김 처리됩니다.") + @PostMapping("/perspectives/{perspectiveId}/reports") + public ApiResponse reportPerspective( + @PathVariable Long perspectiveId, + @AuthenticationPrincipal Long userId) { + reportService.reportPerspective(perspectiveId, userId); + return ApiResponse.onSuccess(null); + } + + @Operation(summary = "댓글 신고", description = "댓글을 신고합니다. 신고 5회 누적 시 자동 숨김 처리됩니다.") + @PostMapping("/perspectives/{perspectiveId}/comments/{commentId}/reports") + public ApiResponse reportComment( + @PathVariable Long perspectiveId, + @PathVariable Long commentId, + @AuthenticationPrincipal Long userId) { + reportService.reportComment(commentId, userId); + return ApiResponse.onSuccess(null); + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/request/CreatePerspectiveRequest.java b/src/main/java/com/swyp/app/domain/perspective/dto/request/CreatePerspectiveRequest.java index 04994b3..b152fc8 100644 --- a/src/main/java/com/swyp/app/domain/perspective/dto/request/CreatePerspectiveRequest.java +++ b/src/main/java/com/swyp/app/domain/perspective/dto/request/CreatePerspectiveRequest.java @@ -1,8 +1,10 @@ package com.swyp.app.domain.perspective.dto.request; import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.Size; public record CreatePerspectiveRequest( @NotBlank + @Size(max = 200) String content ) {} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/request/UpdatePerspectiveRequest.java b/src/main/java/com/swyp/app/domain/perspective/dto/request/UpdatePerspectiveRequest.java index 0cc75f3..0408ba6 100644 --- a/src/main/java/com/swyp/app/domain/perspective/dto/request/UpdatePerspectiveRequest.java +++ b/src/main/java/com/swyp/app/domain/perspective/dto/request/UpdatePerspectiveRequest.java @@ -1,8 +1,10 @@ package com.swyp.app.domain.perspective.dto.request; import jakarta.validation.constraints.NotBlank; +import jakarta.validation.constraints.Size; public record UpdatePerspectiveRequest( @NotBlank + @Size(max = 200) String content ) {} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/CommentListResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/CommentListResponse.java index 3bcab1c..59f36bd 100644 --- a/src/main/java/com/swyp/app/domain/perspective/dto/response/CommentListResponse.java +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/CommentListResponse.java @@ -11,10 +11,13 @@ public record CommentListResponse( public record Item( Long commentId, UserSummary user, + String stance, String content, + int likeCount, + boolean isLiked, boolean isMine, LocalDateTime createdAt ) {} - public record UserSummary(String userTag, String nickname, String characterType) {} + public record UserSummary(String userTag, String nickname, String characterType, String characterImageUrl) {} } diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/CreateCommentResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/CreateCommentResponse.java index b6ac69d..21e4d73 100644 --- a/src/main/java/com/swyp/app/domain/perspective/dto/response/CreateCommentResponse.java +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/CreateCommentResponse.java @@ -5,8 +5,12 @@ public record CreateCommentResponse( Long commentId, UserSummary user, + String stance, String content, + int likeCount, + boolean isLiked, + boolean isMine, LocalDateTime createdAt ) { - public record UserSummary(String userTag, String nickname, String characterType) {} + public record UserSummary(String userTag, String nickname, String characterType, String characterImageUrl) {} } diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/MyPerspectiveResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/MyPerspectiveResponse.java index c7dd689..80f2b42 100644 --- a/src/main/java/com/swyp/app/domain/perspective/dto/response/MyPerspectiveResponse.java +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/MyPerspectiveResponse.java @@ -6,7 +6,16 @@ public record MyPerspectiveResponse( Long perspectiveId, + UserSummary user, + OptionSummary option, String content, + int likeCount, + int commentCount, + boolean isLiked, PerspectiveStatus status, LocalDateTime createdAt -) {} +) { + public record UserSummary(String userTag, String nickname, String characterType, String characterImageUrl) {} + + public record OptionSummary(Long optionId, String label, String title, String stance) {} +} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveDetailResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveDetailResponse.java new file mode 100644 index 0000000..5732bd2 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveDetailResponse.java @@ -0,0 +1,19 @@ +package com.swyp.app.domain.perspective.dto.response; + +import java.time.LocalDateTime; + +public record PerspectiveDetailResponse( + Long perspectiveId, + UserSummary user, + OptionSummary option, + String content, + int likeCount, + int commentCount, + boolean isLiked, + boolean isMyPerspective, + LocalDateTime createdAt +) { + public record UserSummary(String userTag, String nickname, String characterType, String characterImageUrl) {} + + public record OptionSummary(Long optionId, String label, String title, String stance) {} +} diff --git a/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveListResponse.java b/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveListResponse.java index 23cfa6e..5c5b846 100644 --- a/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveListResponse.java +++ b/src/main/java/com/swyp/app/domain/perspective/dto/response/PerspectiveListResponse.java @@ -16,18 +16,21 @@ public record Item( int likeCount, int commentCount, boolean isLiked, + boolean isMyPerspective, LocalDateTime createdAt ) {} public record UserSummary( String userTag, String nickname, - String characterType + String characterType, + String characterImageUrl ) {} public record OptionSummary( Long optionId, String label, - String title + String title, + String stance ) {} } diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/CommentLike.java b/src/main/java/com/swyp/app/domain/perspective/entity/CommentLike.java new file mode 100644 index 0000000..2210a5c --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/entity/CommentLike.java @@ -0,0 +1,37 @@ +package com.swyp.app.domain.perspective.entity; + +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Column; +import jakarta.persistence.Entity; +import jakarta.persistence.FetchType; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; +import jakarta.persistence.Table; +import jakarta.persistence.UniqueConstraint; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +@Getter +@Entity +@Table( + name = "comment_likes", + uniqueConstraints = @UniqueConstraint(columnNames = {"comment_id", "user_id"}) +) +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class CommentLike extends BaseEntity { + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "comment_id", nullable = false) + private PerspectiveComment comment; + + @Column(name = "user_id", nullable = false) + private Long userId; + + @Builder + private CommentLike(PerspectiveComment comment, Long userId) { + this.comment = comment; + this.userId = userId; + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/CommentReport.java b/src/main/java/com/swyp/app/domain/perspective/entity/CommentReport.java new file mode 100644 index 0000000..958265c --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/entity/CommentReport.java @@ -0,0 +1,36 @@ +package com.swyp.app.domain.perspective.entity; + +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Entity; +import jakarta.persistence.FetchType; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; +import jakarta.persistence.Table; +import jakarta.persistence.UniqueConstraint; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +@Getter +@Entity +@Table(name = "comment_reports", + uniqueConstraints = @UniqueConstraint(columnNames = {"comment_id", "user_id"})) +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class CommentReport extends BaseEntity { + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "comment_id", nullable = false) + private PerspectiveComment comment; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id", nullable = false) + private User user; + + @Builder + private CommentReport(PerspectiveComment comment, User user) { + this.comment = comment; + this.user = user; + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java b/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java index 48ece7a..ecc3a3c 100644 --- a/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java +++ b/src/main/java/com/swyp/app/domain/perspective/entity/Perspective.java @@ -80,6 +80,10 @@ public void reject() { this.status = PerspectiveStatus.REJECTED; } + public void hide() { + this.status = PerspectiveStatus.HIDDEN; + } + public void incrementLikeCount() { this.likeCount++; } diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveComment.java b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveComment.java index bf41727..b69156d 100644 --- a/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveComment.java +++ b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveComment.java @@ -30,14 +30,34 @@ public class PerspectiveComment extends BaseEntity { @Column(nullable = false, columnDefinition = "TEXT") private String content; + @Column(name = "like_count", nullable = false) + private int likeCount = 0; + + @Column(nullable = false) + private boolean hidden = false; + @Builder private PerspectiveComment(Perspective perspective, User user, String content) { this.perspective = perspective; this.user = user; this.content = content; + this.likeCount = 0; + this.hidden = false; + } + + public void hide() { + this.hidden = true; } public void updateContent(String content) { this.content = content; } + + public void incrementLikeCount() { + this.likeCount++; + } + + public void decrementLikeCount() { + if (this.likeCount > 0) this.likeCount--; + } } diff --git a/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveReport.java b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveReport.java new file mode 100644 index 0000000..63467c0 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/entity/PerspectiveReport.java @@ -0,0 +1,36 @@ +package com.swyp.app.domain.perspective.entity; + +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.global.common.BaseEntity; +import jakarta.persistence.Entity; +import jakarta.persistence.FetchType; +import jakarta.persistence.JoinColumn; +import jakarta.persistence.ManyToOne; +import jakarta.persistence.Table; +import jakarta.persistence.UniqueConstraint; +import lombok.AccessLevel; +import lombok.Builder; +import lombok.Getter; +import lombok.NoArgsConstructor; + +@Getter +@Entity +@Table(name = "perspective_reports", + uniqueConstraints = @UniqueConstraint(columnNames = {"perspective_id", "user_id"})) +@NoArgsConstructor(access = AccessLevel.PROTECTED) +public class PerspectiveReport extends BaseEntity { + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "perspective_id", nullable = false) + private Perspective perspective; + + @ManyToOne(fetch = FetchType.LAZY) + @JoinColumn(name = "user_id", nullable = false) + private User user; + + @Builder + private PerspectiveReport(Perspective perspective, User user) { + this.perspective = perspective; + this.user = user; + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/enums/PerspectiveStatus.java b/src/main/java/com/swyp/app/domain/perspective/enums/PerspectiveStatus.java index f7ce2ce..cd49700 100644 --- a/src/main/java/com/swyp/app/domain/perspective/enums/PerspectiveStatus.java +++ b/src/main/java/com/swyp/app/domain/perspective/enums/PerspectiveStatus.java @@ -1,5 +1,5 @@ package com.swyp.app.domain.perspective.enums; public enum PerspectiveStatus { - PENDING, PUBLISHED, REJECTED, MODERATION_FAILED + PENDING, PUBLISHED, REJECTED, MODERATION_FAILED, HIDDEN } diff --git a/src/main/java/com/swyp/app/domain/perspective/repository/CommentLikeRepository.java b/src/main/java/com/swyp/app/domain/perspective/repository/CommentLikeRepository.java new file mode 100644 index 0000000..0359f10 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/repository/CommentLikeRepository.java @@ -0,0 +1,14 @@ +package com.swyp.app.domain.perspective.repository; + +import com.swyp.app.domain.perspective.entity.CommentLike; +import com.swyp.app.domain.perspective.entity.PerspectiveComment; +import org.springframework.data.jpa.repository.JpaRepository; + +import java.util.Optional; + +public interface CommentLikeRepository extends JpaRepository { + + boolean existsByCommentAndUserId(PerspectiveComment comment, Long userId); + + Optional findByCommentAndUserId(PerspectiveComment comment, Long userId); +} diff --git a/src/main/java/com/swyp/app/domain/perspective/repository/CommentReportRepository.java b/src/main/java/com/swyp/app/domain/perspective/repository/CommentReportRepository.java new file mode 100644 index 0000000..47de545 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/repository/CommentReportRepository.java @@ -0,0 +1,12 @@ +package com.swyp.app.domain.perspective.repository; + +import com.swyp.app.domain.perspective.entity.CommentReport; +import com.swyp.app.domain.perspective.entity.PerspectiveComment; +import org.springframework.data.jpa.repository.JpaRepository; + +public interface CommentReportRepository extends JpaRepository { + + boolean existsByCommentAndUserId(PerspectiveComment comment, Long userId); + + long countByComment(PerspectiveComment comment); +} diff --git a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveReportRepository.java b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveReportRepository.java new file mode 100644 index 0000000..20a1fa5 --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveReportRepository.java @@ -0,0 +1,12 @@ +package com.swyp.app.domain.perspective.repository; + +import com.swyp.app.domain.perspective.entity.Perspective; +import com.swyp.app.domain.perspective.entity.PerspectiveReport; +import org.springframework.data.jpa.repository.JpaRepository; + +public interface PerspectiveReportRepository extends JpaRepository { + + boolean existsByPerspectiveAndUserId(Perspective perspective, Long userId); + + long countByPerspective(Perspective perspective); +} diff --git a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveRepository.java b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveRepository.java index 7f4d50b..4a86ec2 100644 --- a/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveRepository.java +++ b/src/main/java/com/swyp/app/domain/perspective/repository/PerspectiveRepository.java @@ -22,4 +22,8 @@ public interface PerspectiveRepository extends JpaRepository List findByBattleIdAndOptionIdAndStatusOrderByCreatedAtDesc(Long battleId, Long optionId, PerspectiveStatus status, Pageable pageable); List findByBattleIdAndOptionIdAndStatusAndCreatedAtBeforeOrderByCreatedAtDesc(Long battleId, Long optionId, PerspectiveStatus status, LocalDateTime cursor, Pageable pageable); + + List findByBattleIdAndStatusOrderByLikeCountDescCreatedAtDesc(Long battleId, PerspectiveStatus status, Pageable pageable); + + List findByBattleIdAndOptionIdAndStatusOrderByLikeCountDescCreatedAtDesc(Long battleId, Long optionId, PerspectiveStatus status, Pageable pageable); } diff --git a/src/main/java/com/swyp/app/domain/perspective/service/CommentLikeService.java b/src/main/java/com/swyp/app/domain/perspective/service/CommentLikeService.java new file mode 100644 index 0000000..ca5b04e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/service/CommentLikeService.java @@ -0,0 +1,60 @@ +package com.swyp.app.domain.perspective.service; + +import com.swyp.app.domain.perspective.dto.response.LikeResponse; +import com.swyp.app.domain.perspective.entity.CommentLike; +import com.swyp.app.domain.perspective.entity.PerspectiveComment; +import com.swyp.app.domain.perspective.repository.CommentLikeRepository; +import com.swyp.app.domain.perspective.repository.PerspectiveCommentRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +@Service +@RequiredArgsConstructor +@Transactional(readOnly = true) +public class CommentLikeService { + + private final PerspectiveCommentRepository commentRepository; + private final CommentLikeRepository commentLikeRepository; + + @Transactional + public LikeResponse addLike(Long commentId, Long userId) { + PerspectiveComment comment = findCommentById(commentId); + + if (comment.getUser().getId().equals(userId)) { + throw new CustomException(ErrorCode.LIKE_SELF_FORBIDDEN); + } + + if (commentLikeRepository.existsByCommentAndUserId(comment, userId)) { + throw new CustomException(ErrorCode.LIKE_ALREADY_EXISTS); + } + + commentLikeRepository.save(CommentLike.builder() + .comment(comment) + .userId(userId) + .build()); + comment.incrementLikeCount(); + + return new LikeResponse(comment.getId(), comment.getLikeCount(), true); + } + + @Transactional + public LikeResponse removeLike(Long commentId, Long userId) { + PerspectiveComment comment = findCommentById(commentId); + + CommentLike like = commentLikeRepository.findByCommentAndUserId(comment, userId) + .orElseThrow(() -> new CustomException(ErrorCode.LIKE_NOT_FOUND)); + + commentLikeRepository.delete(like); + comment.decrementLikeCount(); + + return new LikeResponse(comment.getId(), comment.getLikeCount(), false); + } + + private PerspectiveComment findCommentById(Long commentId) { + return commentRepository.findById(commentId) + .orElseThrow(() -> new CustomException(ErrorCode.COMMENT_NOT_FOUND)); + } +} diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java index 88ded3c..39c0d6b 100644 --- a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveCommentService.java @@ -1,5 +1,7 @@ package com.swyp.app.domain.perspective.service; +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.battle.service.BattleService; import com.swyp.app.domain.perspective.dto.request.CreateCommentRequest; import com.swyp.app.domain.perspective.dto.request.UpdateCommentRequest; import com.swyp.app.domain.perspective.dto.response.CommentListResponse; @@ -7,14 +9,18 @@ import com.swyp.app.domain.perspective.dto.response.UpdateCommentResponse; import com.swyp.app.domain.perspective.entity.Perspective; import com.swyp.app.domain.perspective.entity.PerspectiveComment; +import com.swyp.app.domain.perspective.repository.CommentLikeRepository; import com.swyp.app.domain.perspective.repository.PerspectiveCommentRepository; import com.swyp.app.domain.perspective.repository.PerspectiveRepository; import com.swyp.app.domain.user.dto.response.UserSummary; import com.swyp.app.domain.user.entity.User; import com.swyp.app.domain.user.repository.UserRepository; +import com.swyp.app.domain.user.entity.CharacterType; import com.swyp.app.domain.user.service.UserService; +import com.swyp.app.domain.vote.service.VoteService; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; +import com.swyp.app.global.infra.s3.service.S3PresignedUrlService; import lombok.RequiredArgsConstructor; import org.springframework.data.domain.PageRequest; import org.springframework.stereotype.Service; @@ -33,7 +39,11 @@ public class PerspectiveCommentService { private final PerspectiveRepository perspectiveRepository; private final PerspectiveCommentRepository commentRepository; private final UserRepository userRepository; + private final CommentLikeRepository commentLikeRepository; private final UserService userQueryService; + private final VoteService voteService; + private final BattleService battleService; + private final S3PresignedUrlService s3PresignedUrlService; @Transactional public CreateCommentResponse createComment(Long perspectiveId, Long userId, CreateCommentRequest request) { @@ -51,10 +61,21 @@ public CreateCommentResponse createComment(Long perspectiveId, Long userId, Crea perspective.incrementCommentCount(); UserSummary userSummary = userQueryService.findSummaryById(userId); + String characterImageUrl = s3PresignedUrlService.generatePresignedUrl( + CharacterType.from(userSummary.characterType()).getImageKey()); + Long postVoteOptionId = voteService.findPostVoteOptionId(perspective.getBattle().getId(), userId); + String stance = null; + if (postVoteOptionId != null) { + stance = battleService.findOptionById(postVoteOptionId).getStance(); + } return new CreateCommentResponse( comment.getId(), - new CreateCommentResponse.UserSummary(userSummary.userTag(), userSummary.nickname(), userSummary.characterType()), + new CreateCommentResponse.UserSummary(userSummary.userTag(), userSummary.nickname(), userSummary.characterType(), characterImageUrl), + stance, comment.getContent(), + 0, + false, + true, comment.getCreatedAt() ); } @@ -70,13 +91,27 @@ public CommentListResponse getComments(Long perspectiveId, Long userId, String c : commentRepository.findByPerspectiveAndCreatedAtBeforeOrderByCreatedAtDesc( perspective, LocalDateTime.parse(cursor), pageable); + Long battleId = perspective.getBattle().getId(); List items = comments.stream() + .filter(c -> !c.isHidden()) .map(c -> { - UserSummary author = userQueryService.findSummaryById(c.getUser().getId()); + UserSummary user = userQueryService.findSummaryById(c.getUser().getId()); + String characterImageUrl = s3PresignedUrlService.generatePresignedUrl( + CharacterType.from(user.characterType()).getImageKey()); + Long postVoteOptionId = voteService.findPostVoteOptionId(battleId, c.getUser().getId()); + String stance = null; + if (postVoteOptionId != null) { + BattleOption option = battleService.findOptionById(postVoteOptionId); + stance = option.getStance(); + } + boolean isLiked = commentLikeRepository.existsByCommentAndUserId(c, userId); return new CommentListResponse.Item( c.getId(), - new CommentListResponse.UserSummary(author.userTag(), author.nickname(), author.characterType()), + new CommentListResponse.UserSummary(user.userTag(), user.nickname(), user.characterType(), characterImageUrl), + stance, c.getContent(), + c.getLikeCount(), + isLiked, c.getUser().getId().equals(userId), c.getCreatedAt() ); diff --git a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java index f910766..43d64f6 100644 --- a/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java +++ b/src/main/java/com/swyp/app/domain/perspective/service/PerspectiveService.java @@ -11,16 +11,19 @@ import com.swyp.app.domain.perspective.dto.request.UpdatePerspectiveRequest; import com.swyp.app.domain.perspective.dto.response.CreatePerspectiveResponse; import com.swyp.app.domain.perspective.dto.response.MyPerspectiveResponse; +import com.swyp.app.domain.perspective.dto.response.PerspectiveDetailResponse; import com.swyp.app.domain.perspective.dto.response.PerspectiveListResponse; import com.swyp.app.domain.perspective.dto.response.UpdatePerspectiveResponse; import com.swyp.app.domain.perspective.entity.Perspective; import com.swyp.app.domain.perspective.repository.PerspectiveLikeRepository; import com.swyp.app.domain.perspective.repository.PerspectiveRepository; import com.swyp.app.domain.user.dto.response.UserSummary; +import com.swyp.app.domain.user.entity.CharacterType; import com.swyp.app.domain.user.service.UserService; import com.swyp.app.domain.vote.service.VoteService; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; +import com.swyp.app.global.infra.s3.service.S3PresignedUrlService; import lombok.RequiredArgsConstructor; import org.springframework.data.domain.PageRequest; import org.springframework.stereotype.Service; @@ -43,6 +46,30 @@ public class PerspectiveService { private final UserService userQueryService; private final UserRepository userRepository; private final GptModerationService gptModerationService; + private final S3PresignedUrlService s3PresignedUrlService; + + public PerspectiveDetailResponse getPerspectiveDetail(Long perspectiveId, Long userId) { + Perspective perspective = findPerspectiveById(perspectiveId); + if (perspective.getStatus() == PerspectiveStatus.HIDDEN) { + throw new CustomException(ErrorCode.PERSPECTIVE_NOT_FOUND); + } + UserSummary user = userQueryService.findSummaryById(perspective.getUser().getId()); + String characterImageUrl = s3PresignedUrlService.generatePresignedUrl( + CharacterType.from(user.characterType()).getImageKey()); + BattleOption option = perspective.getOption(); + boolean isLiked = perspectiveLikeRepository.existsByPerspectiveAndUserId(perspective, userId); + return new PerspectiveDetailResponse( + perspective.getId(), + new PerspectiveDetailResponse.UserSummary(user.userTag(), user.nickname(), user.characterType(), characterImageUrl), + new PerspectiveDetailResponse.OptionSummary(option.getId(), option.getLabel().name(), option.getTitle(), option.getStance()), + perspective.getContent(), + perspective.getLikeCount(), + perspective.getCommentCount(), + isLiked, + perspective.getUser().getId().equals(userId), + perspective.getCreatedAt() + ); + } @Transactional public CreatePerspectiveResponse createPerspective(Long battleId, Long userId, CreatePerspectiveRequest request) { @@ -68,39 +95,47 @@ public CreatePerspectiveResponse createPerspective(Long battleId, Long userId, C return new CreatePerspectiveResponse(saved.getId(), saved.getStatus(), saved.getCreatedAt()); } - public PerspectiveListResponse getPerspectives(Long battleId, Long userId, String cursor, Integer size, String optionLabel) { + public PerspectiveListResponse getPerspectives(Long battleId, Long userId, String cursor, Integer size, String optionLabel, String sort) { battleService.findById(battleId); int pageSize = (size == null || size <= 0) ? DEFAULT_PAGE_SIZE : size; PageRequest pageable = PageRequest.of(0, pageSize); + boolean isPopular = "popular".equalsIgnoreCase(sort); List perspectives; if (optionLabel != null) { BattleOptionLabel label = BattleOptionLabel.valueOf(optionLabel.toUpperCase()); BattleOption option = battleService.findOptionByBattleIdAndLabel(battleId, label); - perspectives = cursor == null - ? perspectiveRepository.findByBattleIdAndOptionIdAndStatusOrderByCreatedAtDesc(battleId, option.getId(), PerspectiveStatus.PUBLISHED, pageable) - : perspectiveRepository.findByBattleIdAndOptionIdAndStatusAndCreatedAtBeforeOrderByCreatedAtDesc(battleId, option.getId(), PerspectiveStatus.PUBLISHED, LocalDateTime.parse(cursor), pageable); + perspectives = isPopular + ? perspectiveRepository.findByBattleIdAndOptionIdAndStatusOrderByLikeCountDescCreatedAtDesc(battleId, option.getId(), PerspectiveStatus.PUBLISHED, pageable) + : cursor == null + ? perspectiveRepository.findByBattleIdAndOptionIdAndStatusOrderByCreatedAtDesc(battleId, option.getId(), PerspectiveStatus.PUBLISHED, pageable) + : perspectiveRepository.findByBattleIdAndOptionIdAndStatusAndCreatedAtBeforeOrderByCreatedAtDesc(battleId, option.getId(), PerspectiveStatus.PUBLISHED, LocalDateTime.parse(cursor), pageable); } else { - perspectives = cursor == null - ? perspectiveRepository.findByBattleIdAndStatusOrderByCreatedAtDesc(battleId, PerspectiveStatus.PUBLISHED, pageable) - : perspectiveRepository.findByBattleIdAndStatusAndCreatedAtBeforeOrderByCreatedAtDesc(battleId, PerspectiveStatus.PUBLISHED, LocalDateTime.parse(cursor), pageable); + perspectives = isPopular + ? perspectiveRepository.findByBattleIdAndStatusOrderByLikeCountDescCreatedAtDesc(battleId, PerspectiveStatus.PUBLISHED, pageable) + : cursor == null + ? perspectiveRepository.findByBattleIdAndStatusOrderByCreatedAtDesc(battleId, PerspectiveStatus.PUBLISHED, pageable) + : perspectiveRepository.findByBattleIdAndStatusAndCreatedAtBeforeOrderByCreatedAtDesc(battleId, PerspectiveStatus.PUBLISHED, LocalDateTime.parse(cursor), pageable); } List items = perspectives.stream() .map(p -> { UserSummary user = userQueryService.findSummaryById(p.getUser().getId()); + String characterImageUrl = s3PresignedUrlService.generatePresignedUrl( + CharacterType.from(user.characterType()).getImageKey()); BattleOption option = p.getOption(); boolean isLiked = perspectiveLikeRepository.existsByPerspectiveAndUserId(p, userId); return new PerspectiveListResponse.Item( p.getId(), - new PerspectiveListResponse.UserSummary(user.userTag(), user.nickname(), user.characterType()), - new PerspectiveListResponse.OptionSummary(option.getId(), option.getLabel().name(), option.getTitle()), + new PerspectiveListResponse.UserSummary(user.userTag(), user.nickname(), user.characterType(), characterImageUrl), + new PerspectiveListResponse.OptionSummary(option.getId(), option.getLabel().name(), option.getTitle(), option.getStance()), p.getContent(), p.getLikeCount(), p.getCommentCount(), isLiked, + p.getUser().getId().equals(userId), p.getCreatedAt() ); }) @@ -130,14 +165,25 @@ public UpdatePerspectiveResponse updatePerspective(Long perspectiveId, Long user return new UpdatePerspectiveResponse(perspective.getId(), perspective.getContent(), perspective.getUpdatedAt()); } - public MyPerspectiveResponse getMyPendingPerspective(Long battleId, Long userId) { + public MyPerspectiveResponse getMyPerspective(Long battleId, Long userId) { battleService.findById(battleId); Perspective perspective = perspectiveRepository.findByBattleIdAndUserId(battleId, userId) - .filter(p -> p.getStatus() == PerspectiveStatus.PENDING) .orElseThrow(() -> new CustomException(ErrorCode.PERSPECTIVE_NOT_FOUND)); + + UserSummary user = userQueryService.findSummaryById(userId); + String characterImageUrl = s3PresignedUrlService.generatePresignedUrl( + CharacterType.from(user.characterType()).getImageKey()); + BattleOption option = perspective.getOption(); + boolean isLiked = perspectiveLikeRepository.existsByPerspectiveAndUserId(perspective, userId); + return new MyPerspectiveResponse( perspective.getId(), + new MyPerspectiveResponse.UserSummary(user.userTag(), user.nickname(), user.characterType(), characterImageUrl), + new MyPerspectiveResponse.OptionSummary(option.getId(), option.getLabel().name(), option.getTitle(), option.getStance()), perspective.getContent(), + perspective.getLikeCount(), + perspective.getCommentCount(), + isLiked, perspective.getStatus(), perspective.getCreatedAt() ); diff --git a/src/main/java/com/swyp/app/domain/perspective/service/ReportService.java b/src/main/java/com/swyp/app/domain/perspective/service/ReportService.java new file mode 100644 index 0000000..b94cb7e --- /dev/null +++ b/src/main/java/com/swyp/app/domain/perspective/service/ReportService.java @@ -0,0 +1,80 @@ +package com.swyp.app.domain.perspective.service; + +import com.swyp.app.domain.perspective.entity.CommentReport; +import com.swyp.app.domain.perspective.entity.Perspective; +import com.swyp.app.domain.perspective.entity.PerspectiveComment; +import com.swyp.app.domain.perspective.entity.PerspectiveReport; +import com.swyp.app.domain.perspective.repository.CommentReportRepository; +import com.swyp.app.domain.perspective.repository.PerspectiveCommentRepository; +import com.swyp.app.domain.perspective.repository.PerspectiveReportRepository; +import com.swyp.app.domain.perspective.repository.PerspectiveRepository; +import com.swyp.app.domain.user.entity.User; +import com.swyp.app.domain.user.repository.UserRepository; +import com.swyp.app.global.common.exception.CustomException; +import com.swyp.app.global.common.exception.ErrorCode; +import lombok.RequiredArgsConstructor; +import org.springframework.stereotype.Service; +import org.springframework.transaction.annotation.Transactional; + +@Service +@RequiredArgsConstructor +public class ReportService { + + private static final int REPORT_THRESHOLD = 10; + + private final PerspectiveRepository perspectiveRepository; + private final PerspectiveCommentRepository commentRepository; + private final PerspectiveReportRepository perspectiveReportRepository; + private final CommentReportRepository commentReportRepository; + private final UserRepository userRepository; + + @Transactional + public void reportPerspective(Long perspectiveId, Long userId) { + Perspective perspective = perspectiveRepository.findById(perspectiveId) + .orElseThrow(() -> new CustomException(ErrorCode.PERSPECTIVE_NOT_FOUND)); + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + + if (perspective.getUser().getId().equals(userId)) { + throw new CustomException(ErrorCode.REPORT_SELF_FORBIDDEN); + } + if (perspectiveReportRepository.existsByPerspectiveAndUserId(perspective, userId)) { + throw new CustomException(ErrorCode.REPORT_ALREADY_EXISTS); + } + + perspectiveReportRepository.save(PerspectiveReport.builder() + .perspective(perspective) + .user(user) + .build()); + + long reportCount = perspectiveReportRepository.countByPerspective(perspective); + if (reportCount >= REPORT_THRESHOLD) { + perspective.hide(); + } + } + + @Transactional + public void reportComment(Long commentId, Long userId) { + PerspectiveComment comment = commentRepository.findById(commentId) + .orElseThrow(() -> new CustomException(ErrorCode.COMMENT_NOT_FOUND)); + User user = userRepository.findById(userId) + .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); + + if (comment.getUser().getId().equals(userId)) { + throw new CustomException(ErrorCode.REPORT_SELF_FORBIDDEN); + } + if (commentReportRepository.existsByCommentAndUserId(comment, userId)) { + throw new CustomException(ErrorCode.REPORT_ALREADY_EXISTS); + } + + commentReportRepository.save(CommentReport.builder() + .comment(comment) + .user(user) + .build()); + + long reportCount = commentReportRepository.countByComment(comment); + if (reportCount >= REPORT_THRESHOLD) { + comment.hide(); + } + } +} diff --git a/src/main/java/com/swyp/app/domain/recommendation/controller/RecommendationController.java b/src/main/java/com/swyp/app/domain/recommendation/controller/RecommendationController.java index 4fb5076..b4500f3 100644 --- a/src/main/java/com/swyp/app/domain/recommendation/controller/RecommendationController.java +++ b/src/main/java/com/swyp/app/domain/recommendation/controller/RecommendationController.java @@ -6,10 +6,10 @@ import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import lombok.RequiredArgsConstructor; +import org.springframework.security.core.annotation.AuthenticationPrincipal; 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 = "추천 (Recommendation)", description = "배틀 추천 API") @@ -20,12 +20,11 @@ public class RecommendationController { private final RecommendationService recommendationService; - @Operation(summary = "흥미 기반 배틀 추천 조회", description = "특정 배틀 기반으로 흥미로운 배틀 목록을 추천합니다. (추천 정책 미확정)") + @Operation(summary = "흥미 기반 배틀 추천 조회", description = "특정 배틀 기반으로 흥미로운 배틀 목록을 추천합니다.") @GetMapping("/battles/{battleId}/recommendations/interesting") public ApiResponse getInterestingBattles( @PathVariable Long battleId, - @RequestParam(required = false) String cursor, - @RequestParam(required = false) Integer size) { - return ApiResponse.onSuccess(recommendationService.getInterestingBattles(battleId, cursor, size)); + @AuthenticationPrincipal Long userId) { + return ApiResponse.onSuccess(recommendationService.getInterestingBattles(battleId, userId)); } } diff --git a/src/main/java/com/swyp/app/domain/recommendation/dto/response/RecommendationListResponse.java b/src/main/java/com/swyp/app/domain/recommendation/dto/response/RecommendationListResponse.java index 05b1190..b6241f7 100644 --- a/src/main/java/com/swyp/app/domain/recommendation/dto/response/RecommendationListResponse.java +++ b/src/main/java/com/swyp/app/domain/recommendation/dto/response/RecommendationListResponse.java @@ -7,8 +7,11 @@ public record RecommendationListResponse(List items, String nextCursor, bo public record Item( Long battleId, String title, + String summary, + Integer audioDuration, + Integer viewCount, List tags, - int participantsCount, + long participantsCount, List options ) {} @@ -18,6 +21,7 @@ public record OptionSummary( Long optionId, String label, String title, + String stance, String representative, String imageUrl ) {} diff --git a/src/main/java/com/swyp/app/domain/recommendation/service/RecommendationService.java b/src/main/java/com/swyp/app/domain/recommendation/service/RecommendationService.java index da8beab..88202cd 100644 --- a/src/main/java/com/swyp/app/domain/recommendation/service/RecommendationService.java +++ b/src/main/java/com/swyp/app/domain/recommendation/service/RecommendationService.java @@ -1,27 +1,127 @@ package com.swyp.app.domain.recommendation.service; +import com.swyp.app.domain.battle.entity.Battle; +import com.swyp.app.domain.battle.entity.BattleOption; +import com.swyp.app.domain.battle.entity.BattleOptionTag; +import com.swyp.app.domain.battle.repository.BattleOptionRepository; +import com.swyp.app.domain.battle.repository.BattleOptionTagRepository; +import com.swyp.app.domain.battle.repository.BattleRepository; import com.swyp.app.domain.battle.service.BattleService; import com.swyp.app.domain.recommendation.dto.response.RecommendationListResponse; -import com.swyp.app.domain.tag.service.TagService; +import com.swyp.app.domain.tag.enums.TagType; +import com.swyp.app.domain.user.entity.PhilosopherType; +import com.swyp.app.domain.user.service.UserService; +import com.swyp.app.domain.vote.repository.VoteRepository; import lombok.RequiredArgsConstructor; +import org.springframework.data.domain.PageRequest; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; +import java.util.ArrayList; import java.util.List; +import java.util.stream.Collectors; @Service @RequiredArgsConstructor @Transactional(readOnly = true) public class RecommendationService { + private static final int SAME_TYPE_COUNT = 3; + private static final int OPPOSITE_TYPE_COUNT = 2; + private final BattleService battleService; - private final TagService tagService; + private final BattleRepository battleRepository; + private final BattleOptionRepository battleOptionRepository; + private final BattleOptionTagRepository battleOptionTagRepository; + private final VoteRepository voteRepository; + private final UserService userService; - public RecommendationListResponse getInterestingBattles(Long battleId, String cursor, Integer size) { + public RecommendationListResponse getInterestingBattles(Long battleId, Long userId) { battleService.findById(battleId); - // TODO: 흥미 기반 배틀 추천 정책 미확정 (추후 구현) + // 현재 유저의 철학자 유형 및 반대 유형 + PhilosopherType myType = userService.getPhilosopherType(userId); + PhilosopherType oppositeType = myType.getWorstMatch(); + + // 현재 유저가 이미 참여한 배틀 ID 목록 (제외 대상) + List excludeBattleIds = voteRepository.findParticipatedBattleIdsByUserId(userId); + if (excludeBattleIds.isEmpty()) excludeBattleIds = List.of(-1L); + + List sameTypeUserIds = findUserIdsByPhilosopherType(myType); + List oppositeTypeUserIds = findUserIdsByPhilosopherType(oppositeType); + + // 같은 유형 유저들이 참여한 배틀 후보 ID + List sameCandidateIds = sameTypeUserIds.isEmpty() + ? List.of() + : voteRepository.findParticipatedBattleIdsByUserIds(sameTypeUserIds); + + // 반대 유형 유저들이 참여한 배틀 후보 ID + List oppositeCandidateIds = oppositeTypeUserIds.isEmpty() + ? List.of() + : voteRepository.findParticipatedBattleIdsByUserIds(oppositeTypeUserIds); + + // 인기 점수 기준 배틀 조회 (Score = V*1.0 + C*1.5 + Vw*0.2) + // 철학자 유형 로직 미구현 시 인기 배틀로 폴백 + List sameBattles = sameCandidateIds.isEmpty() + ? battleRepository.findPopularBattlesExcluding(excludeBattleIds, PageRequest.of(0, SAME_TYPE_COUNT)) + : battleRepository.findRecommendedBattles(sameCandidateIds, excludeBattleIds, PageRequest.of(0, SAME_TYPE_COUNT)); + + List oppositeBattles = oppositeCandidateIds.isEmpty() + ? battleRepository.findPopularBattlesExcluding(excludeBattleIds, PageRequest.of(0, OPPOSITE_TYPE_COUNT)) + : battleRepository.findRecommendedBattles(oppositeCandidateIds, excludeBattleIds, PageRequest.of(0, OPPOSITE_TYPE_COUNT)); + + List result = new ArrayList<>(); + result.addAll(sameBattles); + result.addAll(oppositeBattles); + + List items = result.stream() + .map(this::toItem) + .collect(Collectors.toList()); + + return new RecommendationListResponse(items, null, false); + } + + private RecommendationListResponse.Item toItem(Battle battle) { + List options = battleOptionRepository.findByBattle(battle); + + List optionSummaries = options.stream() + .map(opt -> new RecommendationListResponse.OptionSummary( + opt.getId(), + opt.getLabel().name(), + opt.getTitle(), + opt.getStance(), + opt.getRepresentative(), + opt.getImageUrl() + )) + .toList(); + + // CATEGORY 태그만 노출 + List tagSummaries = options.stream() + .flatMap(opt -> battleOptionTagRepository.findByBattleOption(opt).stream()) + .map(BattleOptionTag::getTag) + .filter(tag -> tag.getType() == TagType.CATEGORY) + .distinct() + .map(tag -> new RecommendationListResponse.TagSummary(tag.getId(), tag.getName())) + .toList(); + + return new RecommendationListResponse.Item( + battle.getId(), + battle.getTitle(), + battle.getSummary(), + battle.getAudioDuration(), + battle.getViewCount(), + tagSummaries, + battle.getTotalParticipantsCount(), + optionSummaries + ); + } - return new RecommendationListResponse(List.of(), null, false); + /** + * TODO: 철학자 유형별 유저 ID 조회 구현 필요 + * - 사후투표 시 BattleOptionTag(PHILOSOPHER 타입) 기반으로 유저별 철학자 점수 누적 테이블 구현 후 대체 + * - 현재는 빈 리스트 반환 + */ + private List findUserIdsByPhilosopherType(PhilosopherType type) { + return List.of(); } } diff --git a/src/main/java/com/swyp/app/domain/share/controller/ShareController.java b/src/main/java/com/swyp/app/domain/share/controller/ShareController.java new file mode 100644 index 0000000..f5542fa --- /dev/null +++ b/src/main/java/com/swyp/app/domain/share/controller/ShareController.java @@ -0,0 +1,16 @@ +package com.swyp.app.domain.share.controller; + +import org.springframework.stereotype.Controller; +import org.springframework.ui.Model; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PathVariable; + +@Controller +public class ShareController { + + @GetMapping("/result/{userId}") + public String result(@PathVariable Long userId, Model model) { + model.addAttribute("userId", userId); + return "share/result"; + } +} diff --git a/src/main/java/com/swyp/app/domain/test/controller/TestController.java b/src/main/java/com/swyp/app/domain/test/controller/TestController.java index 40a9d9c..97094bf 100644 --- a/src/main/java/com/swyp/app/domain/test/controller/TestController.java +++ b/src/main/java/com/swyp/app/domain/test/controller/TestController.java @@ -1,19 +1,34 @@ package com.swyp.app.domain.test.controller; -import com.swyp.app.global.common.response.ApiResponse; // 패키지 경로 확인! +import com.swyp.app.domain.oauth.jwt.JwtProvider; +import com.swyp.app.global.common.response.ApiResponse; +import lombok.RequiredArgsConstructor; 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; +import java.util.Map; @RestController @RequestMapping("/api/test") +@RequiredArgsConstructor public class TestController { + private final JwtProvider jwtProvider; + @GetMapping("/response") public ApiResponse> testResponse() { List teamMembers = List.of("주천수", "팀원2", "팀원3", "팀원4"); return ApiResponse.onSuccess(teamMembers); } + + @GetMapping("/token") + public ApiResponse> getTestToken( + @RequestParam(defaultValue = "1") Long userId + ) { + String token = jwtProvider.createAccessToken(userId, "USER"); + return ApiResponse.onSuccess(Map.of("accessToken", token)); + } } \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/user/service/UserService.java b/src/main/java/com/swyp/app/domain/user/service/UserService.java index d9d2e08..b427986 100644 --- a/src/main/java/com/swyp/app/domain/user/service/UserService.java +++ b/src/main/java/com/swyp/app/domain/user/service/UserService.java @@ -1,8 +1,10 @@ package com.swyp.app.domain.user.service; +import com.swyp.app.domain.battle.service.BattleQueryService; import com.swyp.app.domain.user.dto.request.UpdateUserProfileRequest; import com.swyp.app.domain.user.dto.response.MyProfileResponse; import com.swyp.app.domain.user.dto.response.UserSummary; +import com.swyp.app.domain.user.entity.PhilosopherType; import com.swyp.app.domain.user.entity.User; import com.swyp.app.domain.user.entity.UserProfile; import com.swyp.app.domain.user.entity.UserSettings; @@ -11,21 +13,28 @@ import com.swyp.app.domain.user.repository.UserRepository; import com.swyp.app.domain.user.repository.UserSettingsRepository; import com.swyp.app.domain.user.repository.UserTendencyScoreRepository; +import com.swyp.app.domain.vote.service.VoteQueryService; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; +import java.util.List; + @Service @RequiredArgsConstructor @Transactional(readOnly = true) public class UserService { + private static final int PHILOSOPHER_CALC_THRESHOLD = 5; + private final UserRepository userRepository; private final UserProfileRepository userProfileRepository; private final UserSettingsRepository userSettingsRepository; private final UserTendencyScoreRepository userTendencyScoreRepository; + private final VoteQueryService voteQueryService; + private final BattleQueryService battleQueryService; @Transactional public MyProfileResponse updateMyProfile(UpdateUserProfileRequest request) { @@ -40,6 +49,30 @@ public MyProfileResponse updateMyProfile(UpdateUserProfileRequest request) { ); } + @Transactional + public PhilosopherType getPhilosopherType(Long userId) { + UserProfile profile = findUserProfile(userId); + + if (profile.getPhilosopherType() != null) { + return profile.getPhilosopherType(); + } + + long totalVotes = voteQueryService.countTotalParticipation(userId); + if (totalVotes < PHILOSOPHER_CALC_THRESHOLD) { + return PhilosopherType.SOCRATES; + } + + List battleIds = voteQueryService.findFirstNBattleIds(userId, PHILOSOPHER_CALC_THRESHOLD); + return battleQueryService.getTopPhilosopherTagName(battleIds) + .map(PhilosopherType::fromLabel) + .map(type -> { + profile.updatePhilosopherType(type); + return type; + }) + .orElse(PhilosopherType.SOCRATES); + } + + public UserSummary findSummaryById(Long userId) { User user = userRepository.findById(userId) .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND)); diff --git a/src/main/java/com/swyp/app/domain/vote/converter/VoteConverter.java b/src/main/java/com/swyp/app/domain/vote/converter/VoteConverter.java index 1332244..ed03722 100644 --- a/src/main/java/com/swyp/app/domain/vote/converter/VoteConverter.java +++ b/src/main/java/com/swyp/app/domain/vote/converter/VoteConverter.java @@ -18,10 +18,15 @@ public static VoteResultResponse toVoteResultResponse(Vote vote) { // 내 투표 내역 변환 public static MyVoteResponse toMyVoteResponse(Vote vote) { + boolean opinionChanged = vote.getPreVoteOption() != null + && vote.getPostVoteOption() != null + && !vote.getPreVoteOption().getId().equals(vote.getPostVoteOption().getId()); return new MyVoteResponse( + vote.getBattle().getTitle(), toOptionInfo(vote.getPreVoteOption()), toOptionInfo(vote.getPostVoteOption()), - vote.getStatus() + vote.getStatus(), + opinionChanged ); } diff --git a/src/main/java/com/swyp/app/domain/vote/dto/response/MyVoteResponse.java b/src/main/java/com/swyp/app/domain/vote/dto/response/MyVoteResponse.java index 378463f..fa3f98f 100644 --- a/src/main/java/com/swyp/app/domain/vote/dto/response/MyVoteResponse.java +++ b/src/main/java/com/swyp/app/domain/vote/dto/response/MyVoteResponse.java @@ -3,9 +3,11 @@ import com.swyp.app.domain.vote.enums.VoteStatus; public record MyVoteResponse( + String battleTitle, OptionInfo preVote, OptionInfo postVote, - VoteStatus status + VoteStatus status, + boolean opinionChanged ) { public record OptionInfo(Long optionId, String label, String title) {} } diff --git a/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java b/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java index cd0ed29..d26084c 100644 --- a/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java +++ b/src/main/java/com/swyp/app/domain/vote/repository/VoteRepository.java @@ -51,4 +51,16 @@ List findByUserIdAndPreVoteOptionLabelOrderByCreatedAtDesc( // MypageService: 철학자 유형 산출용 - 최초 N개 투표 조회 (생성순) @Query("SELECT v FROM Vote v JOIN FETCH v.battle WHERE v.user.id = :userId ORDER BY v.createdAt ASC") List findByUserIdOrderByCreatedAtAsc(@Param("userId") Long userId, Pageable pageable); + + // 추천용: 유저가 참여한 배틀 ID 조회 + @Query("SELECT v.battle.id FROM Vote v WHERE v.user.id = :userId") + List findParticipatedBattleIdsByUserId(@Param("userId") Long userId); + + // 추천용: 특정 배틀에 참여한 유저 ID 조회 + @Query("SELECT DISTINCT v.user.id FROM Vote v WHERE v.battle.id IN :battleIds") + List findUserIdsByBattleIds(@Param("battleIds") List battleIds); + + // 추천용: 특정 유저들이 참여한 배틀 ID 조회 + @Query("SELECT v.battle.id FROM Vote v WHERE v.user.id IN :userIds") + List findParticipatedBattleIdsByUserIds(@Param("userIds") List userIds); } diff --git a/src/main/java/com/swyp/app/domain/vote/service/VoteService.java b/src/main/java/com/swyp/app/domain/vote/service/VoteService.java index 70e95a7..2606da7 100644 --- a/src/main/java/com/swyp/app/domain/vote/service/VoteService.java +++ b/src/main/java/com/swyp/app/domain/vote/service/VoteService.java @@ -10,6 +10,8 @@ public interface VoteService { BattleOption findPreVoteOption(Long battleId, Long userId); + Long findPostVoteOptionId(Long battleId, Long userId); + VoteStatsResponse getVoteStats(Long battleId); MyVoteResponse getMyVote(Long battleId, Long userId); diff --git a/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java b/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java index c76898b..89c0fe3 100644 --- a/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java +++ b/src/main/java/com/swyp/app/domain/vote/service/VoteServiceImpl.java @@ -48,6 +48,13 @@ public BattleOption findPreVoteOption(Long battleId, Long userId) { return vote.getPreVoteOption(); } + @Override + public Long findPostVoteOptionId(Long battleId, Long userId) { + return voteRepository.findByBattleIdAndUserId(battleId, userId) + .map(vote -> vote.getPostVoteOption() != null ? vote.getPostVoteOption().getId() : null) + .orElse(null); + } + @Override public VoteStatsResponse getVoteStats(Long battleId) { Battle battle = battleService.findById(battleId); diff --git a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java index 5475497..d29456d 100644 --- a/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java +++ b/src/main/java/com/swyp/app/global/common/exception/ErrorCode.java @@ -72,6 +72,7 @@ public enum ErrorCode { PERSPECTIVE_FORBIDDEN (HttpStatus.FORBIDDEN, "PERSPECTIVE_403", "본인 관점만 수정/삭제할 수 있습니다."), PERSPECTIVE_POST_VOTE_REQUIRED (HttpStatus.CONFLICT, "PERSPECTIVE_VOTE_409", "사후 투표가 완료되지 않았습니다."), PERSPECTIVE_MODERATION_NOT_FAILED (HttpStatus.BAD_REQUEST,"PERSPECTIVE_400", "검수 실패 상태의 관점이 아닙니다."), + PERSPECTIVE_CONTENT_TOO_LONG (HttpStatus.BAD_REQUEST,"PERSPECTIVE_400_LEN", "관점 내용은 200자를 초과할 수 없습니다."), // Comment COMMENT_NOT_FOUND(HttpStatus.NOT_FOUND, "COMMENT_NOT_FOUND", "존재하지 않는 댓글입니다."), @@ -82,6 +83,10 @@ public enum ErrorCode { LIKE_NOT_FOUND (HttpStatus.NOT_FOUND, "LIKE_404", "좋아요를 누른 적 없는 관점입니다."), LIKE_SELF_FORBIDDEN(HttpStatus.FORBIDDEN, "LIKE_403", "본인 관점에는 좋아요를 누를 수 없습니다."), + // Report + REPORT_ALREADY_EXISTS(HttpStatus.CONFLICT, "REPORT_409", "이미 신고한 항목입니다."), + REPORT_SELF_FORBIDDEN(HttpStatus.FORBIDDEN, "REPORT_403", "본인 글은 신고할 수 없습니다."), + // Vote VOTE_NOT_FOUND (HttpStatus.NOT_FOUND, "VOTE_404", "투표 내역이 없습니다."), VOTE_ALREADY_SUBMITTED(HttpStatus.CONFLICT, "VOTE_409_SUB", "이미 투표가 완료되었습니다."), diff --git a/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java b/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java index 156bd9a..5efe311 100644 --- a/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java +++ b/src/main/java/com/swyp/app/global/common/exception/GlobalExceptionHandler.java @@ -24,10 +24,22 @@ public ResponseEntity> handleCustomException(CustomException e .body(ApiResponse.onFailure(code.getHttpStatus().value(), code.getCode(), code.getMessage())); } + @ExceptionHandler(MethodArgumentNotValidException.class) + public ResponseEntity> handleValidation(MethodArgumentNotValidException e) { + boolean isContentSizeViolation = e.getBindingResult().getFieldErrors().stream() + .anyMatch(fe -> "content".equals(fe.getField()) && "Size".equals(fe.getCode())); + ErrorCode code = isContentSizeViolation + ? ErrorCode.PERSPECTIVE_CONTENT_TOO_LONG + : ErrorCode.COMMON_INVALID_PARAMETER; + log.warn("Validation failed: {}", e.getMessage()); + return ResponseEntity + .status(code.getHttpStatus()) + .body(ApiResponse.onFailure(code.getHttpStatus().value(), code.getCode(), code.getMessage())); + } + @ExceptionHandler({ HttpMessageNotReadableException.class, MethodArgumentTypeMismatchException.class, - MethodArgumentNotValidException.class, ConstraintViolationException.class, IllegalArgumentException.class }) diff --git a/src/main/java/com/swyp/app/global/config/SecurityConfig.java b/src/main/java/com/swyp/app/global/config/SecurityConfig.java index ae11cd1..43eceb2 100644 --- a/src/main/java/com/swyp/app/global/config/SecurityConfig.java +++ b/src/main/java/com/swyp/app/global/config/SecurityConfig.java @@ -18,7 +18,8 @@ @EnableWebSecurity @EnableMethodSecurity @RequiredArgsConstructor -public class SecurityConfig { +public class +SecurityConfig { private final JwtProvider jwtProvider; @@ -32,9 +33,11 @@ public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { .requestMatchers( "/", "/api/v1/auth/**", "/api/v1/home", "/api/v1/notices/**", - "/swagger-ui/**", "/v3/api-docs/**", + "/api/test/**", + "/swagger-ui/**", "/swagger-ui.html", "/v3/api-docs/**", "/js/**", "/css/**", "/images/**", "/favicon.ico", - "/api/v1/admin/login", "/api/v1/admin" + "/api/v1/admin/login", "/api/v1/admin", + "/result/**" ).permitAll() // 2. 관리자 HTML 화면 렌더링 요청 diff --git a/src/main/resources/templates/share/result.html b/src/main/resources/templates/share/result.html new file mode 100644 index 0000000..b75c451 --- /dev/null +++ b/src/main/resources/templates/share/result.html @@ -0,0 +1,92 @@ + + + + + + Pické - 철학자 유형 결과 + + + + + + + +
+ + + + + + + +
+ + + + + From 3e2485c6dd1371fd53082e58854afd1fdb814bd7 Mon Sep 17 00:00:00 2001 From: Dante0922 <101305519+Dante0922@users.noreply.github.com> Date: Sun, 29 Mar 2026 15:57:51 +0900 Subject: [PATCH 33/70] =?UTF-8?q?[Hotfix]=20Home=20API=20NPE=20=EC=88=98?= =?UTF-8?q?=EC=A0=95=20=EB=B0=8F=20=EC=B2=A0=ED=95=99=EC=9E=90=20=EC=9D=B4?= =?UTF-8?q?=EB=AF=B8=EC=A7=80=20presigned=20URL=20=EC=97=B0=EB=8F=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../battle/converter/BattleConverter.java | 3 +++ .../app/domain/home/service/HomeService.java | 19 ++++++++++----- .../domain/user/entity/PhilosopherType.java | 24 ++++++++++++++++--- 3 files changed, 37 insertions(+), 9 deletions(-) diff --git a/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java b/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java index 2cf1dd9..932e3c5 100644 --- a/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java +++ b/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java @@ -126,6 +126,7 @@ public BattleUserDetailResponse toUserDetailResponse(Battle b, List tags, L } private List toOptionResponses(List options) { + if (options == null) return List.of(); return options.stream() .map(o -> { List optionTags = optionTagRepository.findByBattleOption(o).stream() @@ -141,12 +142,14 @@ private List toOptionResponses(List options) } private List toTodayOptionResponses(List options) { + if (options == null) return List.of(); return options.stream().map(o -> new TodayOptionResponse( o.getId(), o.getLabel(), o.getTitle(), o.getRepresentative(), o.getStance(), o.getImageUrl() )).toList(); } private List toTagResponses(List tags, TagType targetType) { + if (tags == null) return List.of(); return tags.stream() .filter(t -> targetType == null || t.getType() == targetType) .map(t -> new BattleTagResponse(t.getId(), t.getName(), t.getType())) diff --git a/src/main/java/com/swyp/app/domain/home/service/HomeService.java b/src/main/java/com/swyp/app/domain/home/service/HomeService.java index 2bb1ee9..32fc703 100644 --- a/src/main/java/com/swyp/app/domain/home/service/HomeService.java +++ b/src/main/java/com/swyp/app/domain/home/service/HomeService.java @@ -10,6 +10,8 @@ import com.swyp.app.domain.home.dto.response.*; import com.swyp.app.domain.notification.enums.NotificationCategory; import com.swyp.app.domain.notification.service.NotificationService; +import com.swyp.app.domain.user.entity.PhilosopherType; +import com.swyp.app.global.infra.s3.service.S3PresignedUrlService; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; @@ -24,6 +26,7 @@ public class HomeService { private final BattleService battleService; private final NotificationService notificationService; + private final S3PresignedUrlService s3PresignedUrlService; public HomeResponse getHome() { boolean newNotice = notificationService.hasNewBroadcast(NotificationCategory.NOTICE); @@ -89,7 +92,7 @@ private HomeTodayQuizResponse toTodayQuiz(TodayBattleResponse b) { } private HomeTodayVoteResponse toTodayVote(TodayBattleResponse b) { - List options = b.options().stream() + List options = Optional.ofNullable(b.options()).orElse(List.of()).stream() .map(o -> new HomeTodayVoteOptionResponse(o.label(), o.title())) .toList(); return new HomeTodayVoteResponse( @@ -104,8 +107,8 @@ private HomeNewBattleResponse toNewBattle(TodayBattleResponse b) { List philosophers = findPhilosopherNames(b.tags()); String philoA = philosophers.size() > 0 ? philosophers.get(0) : null; String philoB = philosophers.size() > 1 ? philosophers.get(1) : null; - String imageA = findOptionImageUrl(b.options(), BattleOptionLabel.A); - String imageB = findOptionImageUrl(b.options(), BattleOptionLabel.B); + String imageA = findRepresentativeImageUrl(b.options(), BattleOptionLabel.A); + String imageB = findRepresentativeImageUrl(b.options(), BattleOptionLabel.B); return new HomeNewBattleResponse( b.battleId(), b.thumbnailUrl(), b.title(), b.summary(), @@ -129,11 +132,15 @@ private List findPhilosopherNames(List tags) { .toList(); } - private String findOptionImageUrl(List options, BattleOptionLabel label) { + private String findRepresentativeImageUrl(List options, BattleOptionLabel label) { return Optional.ofNullable(options).orElse(List.of()).stream() .filter(o -> o.label() == label) - .map(TodayOptionResponse::imageUrl) - .findFirst().orElse(null); + .map(TodayOptionResponse::representative) + .findFirst() + .map(PhilosopherType::fromLabel) + .map(PhilosopherType::getImageKey) + .map(s3PresignedUrlService::generatePresignedUrl) + .orElse(null); } @SafeVarargs diff --git a/src/main/java/com/swyp/app/domain/user/entity/PhilosopherType.java b/src/main/java/com/swyp/app/domain/user/entity/PhilosopherType.java index 3b70e6a..cf4eaee 100644 --- a/src/main/java/com/swyp/app/domain/user/entity/PhilosopherType.java +++ b/src/main/java/com/swyp/app/domain/user/entity/PhilosopherType.java @@ -45,7 +45,25 @@ public enum PhilosopherType { BUDDHA("붓다", "내면형", "외부의 소음에서 벗어나 마음속 깊은 평화와 고요를 찾는 수행자", "LAOZI", "ARISTOTLE", 35, 55, 42, 48, 96, 62, - "images/philosophers/buddha.png"); + "images/philosophers/buddha.png"), + AQUINAS("토마스 아퀴나스", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/aquinas.png"), + CAMUS("카뮈", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/camus.png"), + CHOE_HANGI("최한기", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/choe_hangi.png"), + DESCARTES("데카르트", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/descartes.png"), + EPICURUS("에피쿠로스", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/epicurus.png"), + FROMM("에리히 프롬", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/fromm.png"), + HOBBES("홉스", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/hobbes.png"), + HUME("흄", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/hume.png"), + JEONG_YAKYONG("정약용", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/jeong_yakyong.png"), + JUNG("융", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/jung.png"), + LEIBNIZ("라이프니츠", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/leibniz.png"), + MENCIUS("맹자", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/mencius.png"), + MILL("존 스튜어트 밀", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/mill.png"), + RAWLS("롤스", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/rawls.png"), + SCHOPENHAUER("쇼펜하우어", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/schopenhauer.png"), + XUNZI("순자", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/xunzi.png"), + YI_HWANG("이황", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/yi_hwang.png"), + YI_I("이이", null, null, null, null, 0, 0, 0, 0, 0, 0, "images/philosophers/yi_i.png"); private final String label; private final String typeName; @@ -80,11 +98,11 @@ public enum PhilosopherType { } public PhilosopherType getBestMatch() { - return valueOf(bestMatchName); + return bestMatchName != null ? valueOf(bestMatchName) : null; } public PhilosopherType getWorstMatch() { - return valueOf(worstMatchName); + return worstMatchName != null ? valueOf(worstMatchName) : null; } public static PhilosopherType fromLabel(String label) { From 0fc3f5423aba67ca66dd800fa7d5ac9efcc9deda Mon Sep 17 00:00:00 2001 From: Dante0922 <101305519+Dante0922@users.noreply.github.com> Date: Sun, 29 Mar 2026 16:11:43 +0900 Subject: [PATCH 34/70] =?UTF-8?q?[Hotfix]=20HomeService=20stream=20NPE=20?= =?UTF-8?q?=EC=88=98=EC=A0=95=20(#74)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Summary - `findRepresentativeImageUrl`, `findOptionTitle`에서 `representative`/`title`이 null일 때 `findFirst()` → `Optional.of(null)` NPE 발생하는 문제 수정 - `.filter(Objects::nonNull)`을 `findFirst()` 앞에 추가 ## Test plan - [ ] Home API (`GET /api/v1/home`) 정상 응답 확인 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.6 --- .../java/com/swyp/app/domain/home/service/HomeService.java | 3 +++ 1 file changed, 3 insertions(+) diff --git a/src/main/java/com/swyp/app/domain/home/service/HomeService.java b/src/main/java/com/swyp/app/domain/home/service/HomeService.java index 32fc703..a23475f 100644 --- a/src/main/java/com/swyp/app/domain/home/service/HomeService.java +++ b/src/main/java/com/swyp/app/domain/home/service/HomeService.java @@ -17,6 +17,7 @@ import org.springframework.transaction.annotation.Transactional; import java.util.List; +import java.util.Objects; import java.util.Optional; @Service @@ -122,6 +123,7 @@ private String findOptionTitle(List options, BattleOptionLa return Optional.ofNullable(options).orElse(List.of()).stream() .filter(o -> o.label() == label) .map(TodayOptionResponse::title) + .filter(Objects::nonNull) .findFirst().orElse(null); } @@ -136,6 +138,7 @@ private String findRepresentativeImageUrl(List options, Bat return Optional.ofNullable(options).orElse(List.of()).stream() .filter(o -> o.label() == label) .map(TodayOptionResponse::representative) + .filter(Objects::nonNull) .findFirst() .map(PhilosopherType::fromLabel) .map(PhilosopherType::getImageKey) From 0cfd73dc74b79230c4cf0d7de8bb1a2536697bf4 Mon Sep 17 00:00:00 2001 From: Youwol <153346797+si-zero@users.noreply.github.com> Date: Sun, 29 Mar 2026 16:12:00 +0900 Subject: [PATCH 35/70] =?UTF-8?q?#63=20[CI/CD]=20Nginx=20Reverse=20Proxy?= =?UTF-8?q?=20=EB=B0=8F=20Certbot=20=EA=B8=B0=EB=B0=98=EC=9D=98=20SSL=20?= =?UTF-8?q?=EC=9D=B8=EC=A6=9D=20(#71)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../swyp/app/global/config/SwaggerConfig.java | 31 +++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/src/main/java/com/swyp/app/global/config/SwaggerConfig.java b/src/main/java/com/swyp/app/global/config/SwaggerConfig.java index 8c9aef7..932907e 100644 --- a/src/main/java/com/swyp/app/global/config/SwaggerConfig.java +++ b/src/main/java/com/swyp/app/global/config/SwaggerConfig.java @@ -5,8 +5,13 @@ import io.swagger.v3.oas.models.info.Info; import io.swagger.v3.oas.models.security.SecurityRequirement; import io.swagger.v3.oas.models.security.SecurityScheme; +import java.util.Arrays; +import java.util.List; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; +import org.springframework.web.cors.CorsConfiguration; +import org.springframework.web.cors.CorsConfigurationSource; +import org.springframework.web.cors.UrlBasedCorsConfigurationSource; @Configuration public class SwaggerConfig { @@ -32,4 +37,30 @@ public OpenAPI openAPI() { .addSecuritySchemes("bearerAuth", securityScheme)) .addSecurityItem(securityRequirement); } + + @Bean + public CorsConfigurationSource corsConfigurationSource() { + CorsConfiguration configuration = new CorsConfiguration(); + + // 허용할 오리진(도메인) 설정 + configuration.setAllowedOrigins(List.of( + "http://localhost:3000", + "https://picke.store", + "https://www.picke.store" + )); + + // 허용할 HTTP 메서드 + configuration.setAllowedMethods(Arrays.asList("GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS")); + + // 허용할 헤더 + configuration.setAllowedHeaders(List.of("*")); + + // 자격 증명(쿠키, Authorization 헤더 등) 허용 + configuration.setAllowCredentials(true); + + // 모든 경로(/**)에 대해 위 설정 적용 + UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource(); + source.registerCorsConfiguration("/**", configuration); + return source; + } } \ No newline at end of file From e5515777bd47781c09f2f100cd633ad8a38bdd6e Mon Sep 17 00:00:00 2001 From: Youwol <153346797+si-zero@users.noreply.github.com> Date: Sun, 29 Mar 2026 17:22:39 +0900 Subject: [PATCH 36/70] =?UTF-8?q?#75=20[Hotfix]=20=EB=B8=8C=EB=9D=BC?= =?UTF-8?q?=EC=9A=B0=EC=A0=80=20=EC=9E=90=EC=B2=B4=20=EC=B0=A8=EB=8B=A8=20?= =?UTF-8?q?=EC=9D=B4=EC=8A=88=20=EC=88=98=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../app/global/config/SecurityConfig.java | 31 +++++++++++++ .../swyp/app/global/config/SwaggerConfig.java | 43 ++++++------------- 2 files changed, 44 insertions(+), 30 deletions(-) diff --git a/src/main/java/com/swyp/app/global/config/SecurityConfig.java b/src/main/java/com/swyp/app/global/config/SecurityConfig.java index 43eceb2..a197f58 100644 --- a/src/main/java/com/swyp/app/global/config/SecurityConfig.java +++ b/src/main/java/com/swyp/app/global/config/SecurityConfig.java @@ -2,6 +2,8 @@ import com.swyp.app.domain.oauth.jwt.JwtFilter; import com.swyp.app.domain.oauth.jwt.JwtProvider; +import java.util.Arrays; +import java.util.List; import lombok.RequiredArgsConstructor; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @@ -13,6 +15,9 @@ import org.springframework.security.config.http.SessionCreationPolicy; import org.springframework.security.web.SecurityFilterChain; import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter; +import org.springframework.web.cors.CorsConfiguration; +import org.springframework.web.cors.CorsConfigurationSource; +import org.springframework.web.cors.UrlBasedCorsConfigurationSource; @Configuration @EnableWebSecurity @@ -55,4 +60,30 @@ public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { return http.build(); } + + @Bean + public CorsConfigurationSource corsConfigurationSource() { + CorsConfiguration configuration = new CorsConfiguration(); + + // 허용할 오리진(도메인) 설정 + configuration.setAllowedOrigins(List.of( + "http://localhost:3000", + "https://picke.store", + "https://www.picke.store" + )); + + // 허용할 HTTP 메서드 + configuration.setAllowedMethods(Arrays.asList("GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS")); + + // 허용할 헤더 + configuration.setAllowedHeaders(List.of("*")); + + // 자격 증명(쿠키, Authorization 헤더 등) 허용 + configuration.setAllowCredentials(true); + + // 모든 경로(/**)에 대해 위 설정 적용 + UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource(); + source.registerCorsConfiguration("/**", configuration); + return source; + } } diff --git a/src/main/java/com/swyp/app/global/config/SwaggerConfig.java b/src/main/java/com/swyp/app/global/config/SwaggerConfig.java index 932907e..d908faa 100644 --- a/src/main/java/com/swyp/app/global/config/SwaggerConfig.java +++ b/src/main/java/com/swyp/app/global/config/SwaggerConfig.java @@ -5,19 +5,26 @@ import io.swagger.v3.oas.models.info.Info; import io.swagger.v3.oas.models.security.SecurityRequirement; import io.swagger.v3.oas.models.security.SecurityScheme; -import java.util.Arrays; +import io.swagger.v3.oas.models.servers.Server; import java.util.List; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; -import org.springframework.web.cors.CorsConfiguration; -import org.springframework.web.cors.CorsConfigurationSource; -import org.springframework.web.cors.UrlBasedCorsConfigurationSource; @Configuration public class SwaggerConfig { @Bean public OpenAPI openAPI() { + // 1. 운영 서버 주소 명시 + Server prodServer = new Server(); + prodServer.setUrl("https://picke.store"); + prodServer.setDescription("Production Server"); + + // 2. 로컬 테스트용 서버 주소 + Server localServer = new Server(); + localServer.setUrl("http://localhost:8080"); + localServer.setDescription("Local Development Server"); + SecurityScheme securityScheme = new SecurityScheme() .type(SecurityScheme.Type.HTTP) .scheme("bearer") @@ -29,6 +36,8 @@ public OpenAPI openAPI() { new SecurityRequirement().addList("bearerAuth"); return new OpenAPI() + // 3. 서버 리스트 등록 + .servers(List.of(prodServer, localServer)) .info(new Info() .title("PIQUE API 명세서") .description("PIQUE 서비스 API 명세서입니다.") @@ -37,30 +46,4 @@ public OpenAPI openAPI() { .addSecuritySchemes("bearerAuth", securityScheme)) .addSecurityItem(securityRequirement); } - - @Bean - public CorsConfigurationSource corsConfigurationSource() { - CorsConfiguration configuration = new CorsConfiguration(); - - // 허용할 오리진(도메인) 설정 - configuration.setAllowedOrigins(List.of( - "http://localhost:3000", - "https://picke.store", - "https://www.picke.store" - )); - - // 허용할 HTTP 메서드 - configuration.setAllowedMethods(Arrays.asList("GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS")); - - // 허용할 헤더 - configuration.setAllowedHeaders(List.of("*")); - - // 자격 증명(쿠키, Authorization 헤더 등) 허용 - configuration.setAllowCredentials(true); - - // 모든 경로(/**)에 대해 위 설정 적용 - UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource(); - source.registerCorsConfiguration("/**", configuration); - return source; - } } \ No newline at end of file From 8fa6b6e6a398933c9ce9287b42f07ef68567b0d2 Mon Sep 17 00:00:00 2001 From: JOO <107450745+jucheonsu@users.noreply.github.com> Date: Sun, 29 Mar 2026 23:47:55 +0900 Subject: [PATCH 37/70] =?UTF-8?q?#69=20[Feat]=20S3=20=EB=B3=B4=EC=95=88=20?= =?UTF-8?q?=EC=B2=98=EB=A6=AC=20=EB=B0=8F=20TTS=20=EC=9E=AC=EC=82=AC?= =?UTF-8?q?=EC=9A=A9=20=EC=A0=84=EB=9E=B5=20=EB=8F=84=EC=9E=85,=20?= =?UTF-8?q?=EA=B4=80=EB=A6=AC=EC=9E=90=20=ED=8F=BC=20=EA=B0=9C=ED=8E=B8=20?= =?UTF-8?q?=EB=B0=8F=20N+1=20=EA=B0=9C=EC=84=A0=20(#77)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../battle/converter/BattleConverter.java | 56 ++++-- .../dto/request/AdminBattleCreateRequest.java | 2 + .../repository/BattleOptionRepository.java | 2 +- .../battle/repository/BattleRepository.java | 4 +- .../repository/BattleTagRepository.java | 4 +- .../domain/battle/service/BattleService.java | 10 +- .../battle/service/BattleServiceImpl.java | 124 +++++++----- .../app/domain/home/service/HomeService.java | 54 +++-- .../controller/ScenarioController.java | 10 +- .../dto/request/ScenarioCreateRequest.java | 2 + .../app/domain/scenario/entity/Scenario.java | 4 +- .../domain/scenario/entity/ScenarioNode.java | 9 + .../app/domain/scenario/entity/Script.java | 13 ++ .../service/ScenarioAudioPipelineService.java | 32 ++- .../scenario/service/ScenarioServiceImpl.java | 190 ++++++++++++++---- .../global/common/exception/ErrorCode.java | 1 + .../infra/media/service/FFmpegService.java | 63 +++--- .../infra/s3/service/S3UploadService.java | 4 + .../infra/s3/service/S3UploadServiceImpl.java | 126 ++++++++++-- src/main/resources/application.yml | 15 +- .../resources/static/js/admin/api/api-load.js | 135 ++++++++++--- .../resources/static/js/admin/api/api-save.js | 59 +++++- .../static/js/admin/chat/chat-editor.js | 42 ++-- .../static/js/admin/chat/chat-preview.js | 4 +- .../resources/static/js/admin/ui/ui-sync.js | 15 +- .../admin/components/form-battle.html | 94 ++++++--- .../templates/admin/fragments/preview.html | 14 +- .../templates/admin/picke-create.html | 7 +- .../resources/templates/admin/picke-list.html | 3 +- .../domain/home/service/HomeServiceTest.java | 60 +++--- 30 files changed, 856 insertions(+), 302 deletions(-) diff --git a/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java b/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java index 932e3c5..dc75c26 100644 --- a/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java +++ b/src/main/java/com/swyp/app/domain/battle/converter/BattleConverter.java @@ -6,14 +6,15 @@ import com.swyp.app.domain.battle.entity.BattleOption; import com.swyp.app.domain.battle.entity.BattleOptionTag; import com.swyp.app.domain.battle.enums.BattleCreatorType; -import com.swyp.app.domain.battle.enums.BattleStatus; import com.swyp.app.domain.battle.repository.BattleOptionTagRepository; import com.swyp.app.domain.tag.entity.Tag; import com.swyp.app.domain.tag.enums.TagType; import com.swyp.app.domain.user.entity.User; +import com.swyp.app.global.infra.s3.service.S3UploadService; import lombok.RequiredArgsConstructor; import org.springframework.stereotype.Component; +import java.time.Duration; import java.util.List; @Component @@ -37,7 +38,7 @@ public Battle toEntity(AdminBattleCreateRequest request, User admin) { .thumbnailUrl(request.thumbnailUrl()) .type(request.type()) .targetDate(request.targetDate()) - .status(BattleStatus.PENDING) + .status(request.status()) .creatorType(BattleCreatorType.ADMIN) .creator(admin) .build(); @@ -74,7 +75,15 @@ public BattleSimpleResponse toSimpleResponse(Battle b) { ); } - public AdminBattleDetailResponse toAdminDetailResponse(Battle b, List tags, List opts) { + // 관리자용 상세 응답 변환 (보안 URL 적용) + public AdminBattleDetailResponse toAdminDetailResponse( + Battle b, List tags, List opts, S3UploadService s3Service) { + + // 썸네일 보안 URL + String secureThumbnail = (b.getThumbnailUrl() != null && !b.getThumbnailUrl().isBlank()) + ? s3Service.getPresignedUrl(b.getThumbnailUrl(), Duration.ofMinutes(10)) + : null; + return new AdminBattleDetailResponse( b.getId(), b.getTitle(), @@ -82,7 +91,7 @@ public AdminBattleDetailResponse toAdminDetailResponse(Battle b, List tags, b.getTitleSuffix(), b.getSummary(), b.getDescription(), - b.getThumbnailUrl(), + secureThumbnail, b.getType(), b.getItemA(), b.getItemADesc(), @@ -92,20 +101,29 @@ public AdminBattleDetailResponse toAdminDetailResponse(Battle b, List tags, b.getStatus(), b.getCreatorType(), toTagResponses(tags, null), - toOptionResponses(opts), + toOptionResponses(opts, s3Service), b.getCreatedAt(), b.getUpdatedAt() ); } - public BattleUserDetailResponse toUserDetailResponse(Battle b, List tags, List opts, Long partCount, String voteStatus) { + // 유저 상세 응답 변환 + public BattleUserDetailResponse toUserDetailResponse( + Battle b, List tags, List opts, + Long partCount, String voteStatus, String secureThumbnail, + S3UploadService s3Service) { + BattleSummaryResponse summary = new BattleSummaryResponse( - b.getId(), b.getTitle(), b.getSummary(), b.getThumbnailUrl(), b.getType(), + b.getId(), + b.getTitle(), + b.getSummary(), + secureThumbnail, + b.getType(), b.getViewCount() == null ? 0 : b.getViewCount(), partCount == null ? 0L : partCount, b.getAudioDuration() == null ? 0 : b.getAudioDuration(), toTagResponses(tags, null), - toOptionResponses(opts) + toOptionResponses(opts, s3Service) ); return new BattleUserDetailResponse( @@ -125,22 +143,35 @@ public BattleUserDetailResponse toUserDetailResponse(Battle b, List tags, L ); } - private List toOptionResponses(List options) { + // 철학자 이미지 보안 처리를 포함한 옵션 응답 변환 + private List toOptionResponses(List options, S3UploadService s3Service) { if (options == null) return List.of(); + return options.stream() .map(o -> { List optionTags = optionTagRepository.findByBattleOption(o).stream() .map(BattleOptionTag::getTag) .toList(); + // 철학자 이미지 방어 로직 (null/공백일 경우 s3Service 호출 안 함) + String securePhilosopherImg = (o.getImageUrl() != null && !o.getImageUrl().isBlank()) + ? s3Service.getPresignedUrl(o.getImageUrl(), Duration.ofMinutes(10)) + : null; + return new BattleOptionResponse( - o.getId(), o.getLabel(), o.getTitle(), o.getStance(), - o.getRepresentative(), o.getQuote(), o.getImageUrl(), + o.getId(), + o.getLabel(), + o.getTitle(), + o.getStance(), + o.getRepresentative(), + o.getQuote(), + securePhilosopherImg, toTagResponses(optionTags, null) ); }).toList(); } + // 투데이 옵션 응답 변환 private List toTodayOptionResponses(List options) { if (options == null) return List.of(); return options.stream().map(o -> new TodayOptionResponse( @@ -148,6 +179,7 @@ private List toTodayOptionResponses(List opti )).toList(); } + // 태그 응답 변환 private List toTagResponses(List tags, TagType targetType) { if (tags == null) return List.of(); return tags.stream() @@ -155,4 +187,4 @@ private List toTagResponses(List tags, TagType targetTyp .map(t -> new BattleTagResponse(t.getId(), t.getName(), t.getType())) .toList(); } -} +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleCreateRequest.java b/src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleCreateRequest.java index 451dd72..fb1781d 100644 --- a/src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleCreateRequest.java +++ b/src/main/java/com/swyp/app/domain/battle/dto/request/AdminBattleCreateRequest.java @@ -1,5 +1,6 @@ package com.swyp.app.domain.battle.dto.request; +import com.swyp.app.domain.battle.enums.BattleStatus; import com.swyp.app.domain.battle.enums.BattleType; import java.time.LocalDate; import java.util.List; @@ -12,6 +13,7 @@ public record AdminBattleCreateRequest( String description, String thumbnailUrl, BattleType type, + BattleStatus status, String itemA, String itemADesc, String itemB, diff --git a/src/main/java/com/swyp/app/domain/battle/repository/BattleOptionRepository.java b/src/main/java/com/swyp/app/domain/battle/repository/BattleOptionRepository.java index e97d03d..9eb8325 100644 --- a/src/main/java/com/swyp/app/domain/battle/repository/BattleOptionRepository.java +++ b/src/main/java/com/swyp/app/domain/battle/repository/BattleOptionRepository.java @@ -12,5 +12,5 @@ public interface BattleOptionRepository extends JpaRepository findByBattle(Battle battle); Optional findByBattleAndLabel(Battle battle, BattleOptionLabel label); - + List findByBattleIn(List battles); } diff --git a/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java b/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java index 7d59075..957a57e 100644 --- a/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java +++ b/src/main/java/com/swyp/app/domain/battle/repository/BattleRepository.java @@ -35,11 +35,11 @@ public interface BattleRepository extends JpaRepository { "ORDER BY (battle.totalParticipantsCount + (battle.commentCount * 5)) DESC") List findBestBattles(Pageable pageable); - // 4. 오늘의 Pické (단일 타입) + // 4. 오늘의 Pické @Query("SELECT battle FROM Battle battle " + "WHERE battle.type = :type AND battle.targetDate = :today " + "AND battle.status = 'PUBLISHED' AND battle.deletedAt IS NULL") - List findTodayPicks(@Param("type") BattleType type, @Param("today") LocalDate today); + List findTodayPicks(@Param("type") BattleType type, @Param("today") LocalDate today, Pageable pageable); // 5. 새로운 배틀 @Query("SELECT battle FROM Battle battle " + diff --git a/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java b/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java index 6a157fb..cfeaee0 100644 --- a/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java +++ b/src/main/java/com/swyp/app/domain/battle/repository/BattleTagRepository.java @@ -13,7 +13,9 @@ public interface BattleTagRepository extends JpaRepository { List findByBattle(Battle battle); void deleteByBattle(Battle battle); boolean existsByTag(Tag tag); - + // N+1 방지를 위해 Tag까지 한 번에 가져오는 쿼리 + @Query("SELECT bt FROM BattleTag bt JOIN FETCH bt.tag WHERE bt.battle IN :battles") + List findByBattleIn(@Param("battles") List battles); // MypageService (recap): 여러 배틀의 태그를 한번에 조회 @Query("SELECT bt FROM BattleTag bt JOIN FETCH bt.tag WHERE bt.battle.id IN :battleIds") List findByBattleIdIn(@Param("battleIds") List battleIds); diff --git a/src/main/java/com/swyp/app/domain/battle/service/BattleService.java b/src/main/java/com/swyp/app/domain/battle/service/BattleService.java index 1348813..5a13726 100644 --- a/src/main/java/com/swyp/app/domain/battle/service/BattleService.java +++ b/src/main/java/com/swyp/app/domain/battle/service/BattleService.java @@ -20,19 +20,19 @@ public interface BattleService { // === [사용자용 - 홈 화면 5단 로직 지원 API] === // 1. 에디터 픽 조회 (isEditorPick = true) - List getEditorPicks(); + List getEditorPicks(int limit); // 2. 지금 뜨는 배틀 조회 (최근 24시간 투표 급증순) - List getTrendingBattles(); + List getTrendingBattles(int limit); // 3. Best 배틀 조회 (누적 지표 랭킹) - List getBestBattles(); + List getBestBattles(int limit); // 4. 오늘의 Pické 조회 (단일 타입 매칭) - List getTodayPicks(BattleType type); + List getTodayPicks(BattleType type, int limit); // 5. 새로운 배틀 조회 (중복 제외 리스트) - List getNewBattles(List excludeIds); + List getNewBattles(List excludeIds, int limit); // === [사용자용 - 기본 API] === diff --git a/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java b/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java index ea0671a..46813bf 100644 --- a/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java +++ b/src/main/java/com/swyp/app/domain/battle/service/BattleServiceImpl.java @@ -22,6 +22,7 @@ import com.swyp.app.domain.vote.repository.VoteRepository; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; +import com.swyp.app.global.infra.s3.service.S3UploadService; import lombok.RequiredArgsConstructor; import org.springframework.data.domain.Page; import org.springframework.data.domain.PageRequest; @@ -29,10 +30,14 @@ import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; +import java.time.Duration; import java.time.LocalDate; import java.time.LocalDateTime; import java.util.ArrayList; +import java.util.Collections; import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; @Service @RequiredArgsConstructor @@ -47,6 +52,7 @@ public class BattleServiceImpl implements BattleService { private final UserRepository userRepository; private final VoteRepository voteRepository; private final BattleConverter battleConverter; + private final S3UploadService s3UploadService; @Override public Battle findById(Long battleId) { @@ -62,35 +68,36 @@ public Battle findById(Long battleId) { // [사용자용 - 홈 화면 5단 로직] @Override - public List getEditorPicks() { - List battles = battleRepository.findEditorPicks(BattleStatus.PUBLISHED, PageRequest.of(0, 10)); + public List getEditorPicks(int limit) { + List battles = battleRepository.findEditorPicks(BattleStatus.PUBLISHED, PageRequest.of(0, limit)); return convertToTodayResponses(battles); } @Override - public List getTrendingBattles() { + public List getTrendingBattles(int limit) { LocalDateTime yesterday = LocalDateTime.now().minusDays(1); - List battles = battleRepository.findTrendingBattles(yesterday, PageRequest.of(0, 5)); + List battles = battleRepository.findTrendingBattles(yesterday, PageRequest.of(0, limit)); return convertToTodayResponses(battles); } @Override - public List getBestBattles() { - List battles = battleRepository.findBestBattles(PageRequest.of(0, 5)); + public List getBestBattles(int limit) { + List battles = battleRepository.findBestBattles(PageRequest.of(0, limit)); return convertToTodayResponses(battles); } @Override - public List getTodayPicks(BattleType type) { - List battles = battleRepository.findTodayPicks(type, LocalDate.now()); + public List getTodayPicks(BattleType type, int limit) { + // findTodayPicks 레포지토리 메서드에 Pageable을 이미 추가하셨다면 문제없이 동작합니다! + List battles = battleRepository.findTodayPicks(type, LocalDate.now(), PageRequest.of(0, limit)); return convertToTodayResponses(battles); } @Override - public List getNewBattles(List excludeIds) { + public List getNewBattles(List excludeIds, int limit) { List finalExcludeIds = (excludeIds == null || excludeIds.isEmpty()) ? List.of(-1L) : excludeIds; - List battles = battleRepository.findNewBattlesExcluding(finalExcludeIds, PageRequest.of(0, 10)); + List battles = battleRepository.findNewBattlesExcluding(finalExcludeIds, PageRequest.of(0, limit)); return convertToTodayResponses(battles); } @@ -129,19 +136,30 @@ public TodayBattleListResponse getTodayBattles() { return new TodayBattleListResponse(items, items.size()); } + // [사용자용 상세 조회] - 썸네일 + 철학자 이미지 보안 처리 @Override + @Transactional(readOnly = true) public BattleUserDetailResponse getBattleDetail(Long battleId) { Battle battle = findById(battleId); - battle.increaseViewCount(); - - List allTags = getTagsByBattle(battle); + List tags = getTagsByBattle(battle); List options = battleOptionRepository.findByBattle(battle); + // 1. 썸네일 보안 URL 생성 + String secureThumbnail = s3UploadService.getPresignedUrl(battle.getThumbnailUrl(), Duration.ofMinutes(10)); String voteStatus = voteRepository.findByBattleIdAndUserId(battleId, 1L) .map(v -> v.getPostVoteOption() != null ? v.getPostVoteOption().getLabel().name() : "NONE") .orElse("NONE"); - return battleConverter.toUserDetailResponse(battle, allTags, options, battle.getTotalParticipantsCount(), voteStatus); + // 2. 컨버터를 통해 전체 조립 (철학자 이미지는 컨버터 내부에서 s3UploadService로 처리) + return battleConverter.toUserDetailResponse( + battle, + tags, + options, + battle.getTotalParticipantsCount(), + "NONE", + secureThumbnail, + s3UploadService // 철학자 이미지 변환을 위해 전달 + ); } @Override @@ -166,6 +184,7 @@ public BattleVoteResponse vote(Long battleId, Long optionId) { // [관리자용 API] + // [관리자용 생성] - 생성 직후 결과 화면에서도 이미지가 보이게 처리 @Override @Transactional @PreAuthorize("hasRole('ADMIN')") @@ -196,7 +215,9 @@ public AdminBattleDetailResponse createBattle(AdminBattleCreateRequest request, } savedOptions.add(option); } - return battleConverter.toAdminDetailResponse(battle, getTagsByBattle(battle), savedOptions); + + // 생성 후 응답 시 s3UploadService 전달 + return battleConverter.toAdminDetailResponse(battle, getTagsByBattle(battle), savedOptions, s3UploadService); } private void saveBattleOptionTags(BattleOption option, List tagIds) { @@ -207,42 +228,33 @@ private void saveBattleOptionTags(BattleOption option, List tagIds) { )); } + // [관리자용 수정] - 수정 완료 후 결과 화면에서도 이미지가 보이게 처리 @Override @Transactional @PreAuthorize("hasRole('ADMIN')") public AdminBattleDetailResponse updateBattle(Long battleId, AdminBattleUpdateRequest request) { - // [STEP 2] 서버 터미널에 출력 - System.out.println("====== [백엔드 수신 로그] ======"); - System.out.println("ID: " + battleId); - System.out.println("제목: " + request.title()); - System.out.println("공연A: " + request.itemA()); - System.out.println("A설명: " + request.itemADesc()); - System.out.println("선택지A: " + (request.options() != null ? request.options().get(0).title() : "null")); - System.out.println("=============================="); - Battle battle = findById(battleId); - // 1. 배틀 필드 업데이트 + // 썸네일 이미지가 변경되었다면 기존 S3 파일 삭제 (스토리지 낭비 방지) + if (battle.getThumbnailUrl() != null && !battle.getThumbnailUrl().equals(request.thumbnailUrl())) { + s3UploadService.deleteFile(battle.getThumbnailUrl()); + } + + // 배틀 필드 업데이트 battle.update( - request.title(), - request.titlePrefix(), - request.titleSuffix(), - request.itemA(), - request.itemADesc(), - request.itemB(), - request.itemBDesc(), - request.summary(), - request.description(), - request.thumbnailUrl(), - request.targetDate(), - request.audioDuration(), - request.status() + request.title(), request.titlePrefix(), request.titleSuffix(), + request.itemA(), request.itemADesc(), request.itemB(), request.itemBDesc(), + request.summary(), request.description(), request.thumbnailUrl(), + request.targetDate(), request.audioDuration(), request.status() ); - // 2. 태그 업데이트 + // 태그 업데이트 if (request.tagIds() != null) { battleTagRepository.deleteByBattle(battle); - saveBattleTags(battle, request.tagIds()); + battleTagRepository.flush(); // DB에 DELETE 쿼리를 즉시 전송해서 완전히 비워버림 + + // request.tagIds()에 혹시 모를 중복값이 있으면 distinct()로 제거하고 저장 + saveBattleTags(battle, request.tagIds().stream().distinct().toList()); } // 3. 선택지 업데이트 @@ -253,14 +265,19 @@ public AdminBattleDetailResponse updateBattle(Long battleId, AdminBattleUpdateRe .filter(o -> o.getLabel() == optReq.label()) .findFirst() .ifPresent(o -> { + // 철학자/선택지 이미지가 변경되었다면 기존 S3 파일 삭제 + if (o.getImageUrl() != null && !o.getImageUrl().equals(optReq.imageUrl())) { + s3UploadService.deleteFile(o.getImageUrl()); + } + o.update(optReq.title(), optReq.stance(), optReq.representative(), optReq.quote(), optReq.imageUrl()); }); } } - // 변경된 옵션 다시 조회해서 응답 포함 List updatedOptions = battleOptionRepository.findByBattle(battle); - return battleConverter.toAdminDetailResponse(battle, getTagsByBattle(battle), updatedOptions); + // 업데이트 후 응답 시 s3UploadService 전달 + return battleConverter.toAdminDetailResponse(battle, getTagsByBattle(battle), updatedOptions, s3UploadService); } @Override @@ -274,10 +291,27 @@ public AdminBattleDeleteResponse deleteBattle(Long battleId) { // [공통 헬퍼 메서드] + // N+1 개선 버전 private List convertToTodayResponses(List battles) { + if (battles == null || battles.isEmpty()) { + return Collections.emptyList(); + } + + // 1. IN 쿼리로 모든 옵션과 태그를 한 번에 가져와서 배틀 ID별로 그룹핑 + Map> optionsMap = battleOptionRepository.findByBattleIn(battles) + .stream().collect(Collectors.groupingBy(battleOption -> battleOption.getBattle().getId())); + + Map> tagsMap = battleTagRepository.findByBattleIn(battles) + .stream().collect(Collectors.groupingBy( + battleTag -> battleTag.getBattle().getId(), + Collectors.mapping(BattleTag::getTag, Collectors.toList()) + )); + + // 2. DB 쿼리 없이 메모리(Map)에서 꺼내서 조립만 수행 return battles.stream().map(battle -> { - List tags = getTagsByBattle(battle); - List options = battleOptionRepository.findByBattle(battle); + List tags = tagsMap.getOrDefault(battle.getId(), Collections.emptyList()); + List options = optionsMap.getOrDefault(battle.getId(), Collections.emptyList()); + return battleConverter.toTodayResponse(battle, tags, options); }).toList(); } @@ -307,4 +341,4 @@ public BattleOption findOptionByBattleIdAndLabel(Long battleId, BattleOptionLabe return battleOptionRepository.findByBattleAndLabel(b, label) .orElseThrow(() -> new CustomException(ErrorCode.BATTLE_OPTION_NOT_FOUND)); } -} +} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/home/service/HomeService.java b/src/main/java/com/swyp/app/domain/home/service/HomeService.java index a23475f..868013a 100644 --- a/src/main/java/com/swyp/app/domain/home/service/HomeService.java +++ b/src/main/java/com/swyp/app/domain/home/service/HomeService.java @@ -32,14 +32,15 @@ public class HomeService { public HomeResponse getHome() { boolean newNotice = notificationService.hasNewBroadcast(NotificationCategory.NOTICE); - List editorPickRaw = battleService.getEditorPicks(); - List trendingRaw = battleService.getTrendingBattles(); - List bestRaw = battleService.getBestBattles(); - List voteRaw = battleService.getTodayPicks(BattleType.VOTE); - List quizRaw = battleService.getTodayPicks(BattleType.QUIZ); + // DB 쿼리 단계에서 LIMIT을 걸어 필요한 개수만 깔끔하게 조회! + List editorPickRaw = battleService.getEditorPicks(10); + List trendingRaw = battleService.getTrendingBattles(4); + List bestRaw = battleService.getBestBattles(3); + List voteRaw = battleService.getTodayPicks(BattleType.VOTE, 1); + List quizRaw = battleService.getTodayPicks(BattleType.QUIZ, 1); List excludeIds = collectBattleIds(editorPickRaw, trendingRaw, bestRaw, voteRaw, quizRaw); - List newRaw = battleService.getNewBattles(excludeIds); + List newRaw = battleService.getNewBattles(excludeIds, 3); return new HomeResponse( newNotice, @@ -52,29 +53,38 @@ public HomeResponse getHome() { ); } + // 에디터픽 썸네일 Presigned URL 적용 private HomeEditorPickResponse toEditorPick(TodayBattleResponse b) { String optionA = findOptionTitle(b.options(), BattleOptionLabel.A); String optionB = findOptionTitle(b.options(), BattleOptionLabel.B); + + String secureThumb = (b.thumbnailUrl() != null && !b.thumbnailUrl().isBlank()) + ? s3PresignedUrlService.generatePresignedUrl(b.thumbnailUrl()) : null; + return new HomeEditorPickResponse( - b.battleId(), b.thumbnailUrl(), + b.battleId(), secureThumb, optionA, optionB, b.title(), b.summary(), b.tags(), b.viewCount() ); } + // 트렌딩 썸네일 Presigned URL 적용 private HomeTrendingResponse toTrending(TodayBattleResponse b) { + String secureThumb = (b.thumbnailUrl() != null && !b.thumbnailUrl().isBlank()) + ? s3PresignedUrlService.generatePresignedUrl(b.thumbnailUrl()) : null; + return new HomeTrendingResponse( - b.battleId(), b.thumbnailUrl(), + b.battleId(), secureThumb, b.title(), b.tags(), b.audioDuration(), b.viewCount() ); } private HomeBestBattleResponse toBestBattle(TodayBattleResponse b) { - List philosophers = findPhilosopherNames(b.tags()); - String philoA = philosophers.size() > 0 ? philosophers.get(0) : null; - String philoB = philosophers.size() > 1 ? philosophers.get(1) : null; + String philoA = findOptionRepresentative(b.options(), BattleOptionLabel.A); + String philoB = findOptionRepresentative(b.options(), BattleOptionLabel.B); + return new HomeBestBattleResponse( b.battleId(), philoA, philoB, @@ -104,14 +114,19 @@ private HomeTodayVoteResponse toTodayVote(TodayBattleResponse b) { ); } + // newBattle 썸네일 Presigned URL 적용 private HomeNewBattleResponse toNewBattle(TodayBattleResponse b) { - List philosophers = findPhilosopherNames(b.tags()); - String philoA = philosophers.size() > 0 ? philosophers.get(0) : null; - String philoB = philosophers.size() > 1 ? philosophers.get(1) : null; + String philoA = findOptionRepresentative(b.options(), BattleOptionLabel.A); + String philoB = findOptionRepresentative(b.options(), BattleOptionLabel.B); + String imageA = findRepresentativeImageUrl(b.options(), BattleOptionLabel.A); String imageB = findRepresentativeImageUrl(b.options(), BattleOptionLabel.B); + + String secureThumb = (b.thumbnailUrl() != null && !b.thumbnailUrl().isBlank()) + ? s3PresignedUrlService.generatePresignedUrl(b.thumbnailUrl()) : null; + return new HomeNewBattleResponse( - b.battleId(), b.thumbnailUrl(), + b.battleId(), secureThumb, b.title(), b.summary(), philoA, imageA, philoB, imageB, @@ -127,6 +142,15 @@ private String findOptionTitle(List options, BattleOptionLa .findFirst().orElse(null); } + // 옵션에서 철학자 이름(Representative)을 추출하는 메서드 + private String findOptionRepresentative(List options, BattleOptionLabel label) { + return Optional.ofNullable(options).orElse(List.of()).stream() + .filter(o -> o.label() == label) + .map(TodayOptionResponse::representative) + .filter(Objects::nonNull) + .findFirst().orElse(null); + } + private List findPhilosopherNames(List tags) { return Optional.ofNullable(tags).orElse(List.of()).stream() .filter(t -> t.type() == TagType.PHILOSOPHER) diff --git a/src/main/java/com/swyp/app/domain/scenario/controller/ScenarioController.java b/src/main/java/com/swyp/app/domain/scenario/controller/ScenarioController.java index 926b048..fa73965 100644 --- a/src/main/java/com/swyp/app/domain/scenario/controller/ScenarioController.java +++ b/src/main/java/com/swyp/app/domain/scenario/controller/ScenarioController.java @@ -50,7 +50,15 @@ public ApiResponse> createScenario( @RequestBody ScenarioCreateRequest request) { Long scenarioId = scenarioService.createScenario(request); - return ApiResponse.onSuccess(Map.of("scenarioId", scenarioId, "status", "DRAFT")); + + // Map.of 대신 null에도 안전한 HashMap 사용 + Map response = new java.util.HashMap<>(); + response.put("scenarioId", scenarioId); + + // 고정값 대신 프론트에서 보낸 상태값(PENDING 등)을 그대로 반환! + response.put("status", request.status()); + + return ApiResponse.onSuccess(response); } @Operation(summary = "시나리오 내용 수정") diff --git a/src/main/java/com/swyp/app/domain/scenario/dto/request/ScenarioCreateRequest.java b/src/main/java/com/swyp/app/domain/scenario/dto/request/ScenarioCreateRequest.java index 71bf375..feb4004 100644 --- a/src/main/java/com/swyp/app/domain/scenario/dto/request/ScenarioCreateRequest.java +++ b/src/main/java/com/swyp/app/domain/scenario/dto/request/ScenarioCreateRequest.java @@ -1,9 +1,11 @@ package com.swyp.app.domain.scenario.dto.request; +import com.swyp.app.domain.scenario.enums.ScenarioStatus; import java.util.List; public record ScenarioCreateRequest( Long battleId, Boolean isInteractive, + ScenarioStatus status, List nodes ) {} \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/entity/Scenario.java b/src/main/java/com/swyp/app/domain/scenario/entity/Scenario.java index 94ed4da..edc3a5c 100644 --- a/src/main/java/com/swyp/app/domain/scenario/entity/Scenario.java +++ b/src/main/java/com/swyp/app/domain/scenario/entity/Scenario.java @@ -65,7 +65,7 @@ public void addNode(ScenarioNode node) { node.assignScenario(this); } - public void clearNodes() { - this.nodes.clear(); + public void clearAudios() { + this.audios.clear(); } } \ No newline at end of file diff --git a/src/main/java/com/swyp/app/domain/scenario/entity/ScenarioNode.java b/src/main/java/com/swyp/app/domain/scenario/entity/ScenarioNode.java index f5891d9..88ef845 100644 --- a/src/main/java/com/swyp/app/domain/scenario/entity/ScenarioNode.java +++ b/src/main/java/com/swyp/app/domain/scenario/entity/ScenarioNode.java @@ -60,6 +60,15 @@ public void addOption(InteractiveOption option) { option.assignNode(this); } + public void updateBasicInfo(Boolean isStartNode) { + this.isStartNode = isStartNode; + } + + public void clearOptionsAndLinks() { + this.autoNextNodeId = null; + this.options.clear(); + } + public void updateAutoNextNodeId(Long autoNextNodeId) { this.autoNextNodeId = autoNextNodeId; } diff --git a/src/main/java/com/swyp/app/domain/scenario/entity/Script.java b/src/main/java/com/swyp/app/domain/scenario/entity/Script.java index 07c8b35..10d0e54 100644 --- a/src/main/java/com/swyp/app/domain/scenario/entity/Script.java +++ b/src/main/java/com/swyp/app/domain/scenario/entity/Script.java @@ -31,6 +31,9 @@ public class Script extends BaseEntity { @Column(columnDefinition = "TEXT") private String text; // SSML 태그가 포함된 텍스트 + @Column(name = "audio_url") + private String audioUrl; + @Builder public Script(Integer startTimeMs, SpeakerType speakerType, String speakerName, String text) { this.startTimeMs = startTimeMs; @@ -39,6 +42,16 @@ public Script(Integer startTimeMs, SpeakerType speakerType, String speakerName, this.text = text; } + public void updateAudioUrl(String audioUrl) { + this.audioUrl = audioUrl; + } + + public void updateContent(SpeakerType speakerType, String speakerName, String newText) { + this.speakerType = speakerType; + this.speakerName = speakerName; + this.text = newText; + } + public void assignNode(ScenarioNode node) { this.node = node; } diff --git a/src/main/java/com/swyp/app/domain/scenario/service/ScenarioAudioPipelineService.java b/src/main/java/com/swyp/app/domain/scenario/service/ScenarioAudioPipelineService.java index d41b3a9..2107bd3 100644 --- a/src/main/java/com/swyp/app/domain/scenario/service/ScenarioAudioPipelineService.java +++ b/src/main/java/com/swyp/app/domain/scenario/service/ScenarioAudioPipelineService.java @@ -31,9 +31,9 @@ public class ScenarioAudioPipelineService { private static final int SILENCE_MS = 600; @Async - @Transactional(propagation = Propagation.REQUIRES_NEW) // 비동기 전용 독립 트랜잭션 보장 + @Transactional(propagation = Propagation.REQUIRES_NEW) public void generateAndMergeAudioAsync(Long scenarioId) { - // 부모 트랜잭션이 커밋된 후에 도는 것이므로 데이터가 완벽하게 보임 + Scenario scenario = scenarioRepository.findById(scenarioId).orElseThrow(); log.info("\n=================================================="); @@ -41,18 +41,38 @@ public void generateAndMergeAudioAsync(Long scenarioId) { log.info("[시나리오 타입] 인터랙티브(분기) 여부: {}", scenario.getIsInteractive()); try { - log.info("--- [1단계] TTS API 호출 및 캐싱 ---"); + log.info("--- [1단계] TTS API 호출 및 캐싱 (S3 조각 활용) ---"); Map ttsCache = new HashMap<>(); int apiCallCount = 0; for (ScenarioNode node : scenario.getNodes()) { for (Script script : node.getScripts()) { - ttsCache.put(script.getId(), ttsService.generateTtsWithSsml(script.getText(), script.getSpeakerType())); - apiCallCount++; + File audioFile; + + // 1. 텍스트가 안 바뀌어서 DB에 S3 URL이 살아있다면? (재사용) + if (script.getAudioUrl() != null) { + log.info(">> 기존 오디오 재사용 (S3 다운로드): 스크립트 ID {}", script.getId()); + audioFile = s3UploadService.downloadFile(script.getAudioUrl()); + } + // 2. 텍스트가 바뀌었거나 새로 추가되었다면? (새로 생성 후 S3에 저장) + else { + log.info(">> 새 오디오 생성 (TTS API 호출): 스크립트 ID {}", script.getId()); + audioFile = ttsService.generateTtsWithSsml(script.getText(), script.getSpeakerType()); + + // 새로 만든 조각 파일을 다음 수정을 위해 S3에 업로드 (chunks 폴더) + String chunkKey = FileCategory.SCENARIO.getPath() + "/chunks/" + UUID.randomUUID() + ".mp3"; + String chunkUrl = s3UploadService.uploadFile(chunkKey, audioFile); + + // DB 엔티티에 새로 만든 S3 주소 기록 (dirty checking으로 자동 저장됨) + script.updateAudioUrl(chunkUrl); + + apiCallCount++; + } + + ttsCache.put(script.getId(), audioFile); } } log.info("[API 호출 통계] 💳 TTS API가 총 {}회 호출되어 캐시에 저장되었습니다.", apiCallCount); - File silence = ffmpegService.createSilenceFile(SILENCE_MS); // 경로 탐색 diff --git a/src/main/java/com/swyp/app/domain/scenario/service/ScenarioServiceImpl.java b/src/main/java/com/swyp/app/domain/scenario/service/ScenarioServiceImpl.java index a5d4b4e..047139f 100644 --- a/src/main/java/com/swyp/app/domain/scenario/service/ScenarioServiceImpl.java +++ b/src/main/java/com/swyp/app/domain/scenario/service/ScenarioServiceImpl.java @@ -23,6 +23,7 @@ import com.swyp.app.domain.vote.repository.VoteRepository; import com.swyp.app.global.common.exception.CustomException; import com.swyp.app.global.common.exception.ErrorCode; +import com.swyp.app.global.infra.s3.service.S3UploadService; import lombok.RequiredArgsConstructor; import org.springframework.security.access.prepost.PreAuthorize; import org.springframework.stereotype.Service; @@ -45,6 +46,7 @@ public class ScenarioServiceImpl implements ScenarioService { private final VoteRepository voteRepository; private final ScenarioConverter scenarioConverter; private final ScenarioAudioPipelineService audioPipelineService; + private final S3UploadService s3Service; // [유저용] 시나리오 조회 (투표 기반 맞춤 오디오 제공) @Override @@ -94,11 +96,19 @@ public Long createScenario(ScenarioCreateRequest request) { Scenario scenario = Scenario.builder() .battle(battle) .isInteractive(request.isInteractive()) - .status(ScenarioStatus.PENDING) + .status(request.status()) .creatorType(CreatorType.ADMIN) .build(); - mapAndAddNodesToScenario(scenario, request); + // 1. 부모 시나리오 먼저 저장 (ID 발급) + scenarioRepository.save(scenario); + + // 2. 노드 및 스크립트 저장 (이때 모든 Script의 audioUrl은 null 상태) + smartUpdateNodesToScenario(scenario, request); + + // 3. 오디오 파이프라인 호출 (트랜잭션 커밋 후 비동기 실행) + triggerAudioPipeline(scenario.getId()); + return scenario.getId(); } @@ -113,10 +123,18 @@ public void updateScenarioContent(Long scenarioId, ScenarioCreateRequest request throw new CustomException(ErrorCode.SCENARIO_ALREADY_PUBLISHED); } - scenario.clearNodes(); - scenarioRepository.flush(); + // 스마트 업데이트 로직 호출 (수정 사항이 있었는지 boolean으로 반환받음) + boolean isModified = smartUpdateNodesToScenario(scenario, request); - mapAndAddNodesToScenario(scenario, request); + // 대본 내용(노드, 대사 등)이 하나라도 바뀌었다면? + if (isModified) { + // 1. 기존에 만들어둔 '최종 병합 오디오(A루트, B루트 등)'를 S3에서 전부 삭제! + for (String mergedAudioUrl : scenario.getAudios().values()) { + if (mergedAudioUrl != null) s3Service.deleteFile(mergedAudioUrl); + } + // 2. DB에서 최종 오디오 URL 초기화 + scenario.clearAudios(); + } } @Override @@ -126,10 +144,6 @@ public AdminScenarioResponse updateScenarioStatus(Long scenarioId, ScenarioStatu Scenario scenario = scenarioRepository.findById(scenarioId) .orElseThrow(() -> new CustomException(ErrorCode.SCENARIO_NOT_FOUND)); - if (scenario.getStatus() == status) { - return new AdminScenarioResponse(scenario.getId(), scenario.getStatus(), "이미 처리된 요청입니다."); - } - scenario.updateStatus(status); scenarioRepository.saveAndFlush(scenario); @@ -158,58 +172,146 @@ public AdminDeleteResponse deleteScenario(Long scenarioId) { return new AdminDeleteResponse(true, LocalDateTime.now()); } - private void mapAndAddNodesToScenario(Scenario scenario, ScenarioCreateRequest request) { - Map nodeMap = new HashMap<>(); + // 부분 업데이트 및 노드 삭제 시 S3 정리 로직 + private boolean smartUpdateNodesToScenario(Scenario scenario, ScenarioCreateRequest request) { + boolean isModified = false; + Map existingNodeMap = new HashMap<>(); + for (ScenarioNode node : scenario.getNodes()) { + existingNodeMap.put(node.getNodeName(), node); + } + Map updatedNodeMap = new HashMap<>(); for (NodeRequest nodeReq : request.nodes()) { - ScenarioNode node = ScenarioNode.builder() - .nodeName(nodeReq.nodeName()) - .isStartNode(nodeReq.isStartNode()) - .audioDuration(0) - .build(); - - if (nodeReq.scripts() != null) { - for (ScriptRequest scriptReq : nodeReq.scripts()) { - node.addScript(Script.builder() - .startTimeMs(0) - .speakerType(scriptReq.speakerType()) - .speakerName(scriptReq.speakerName()) - .text(scriptReq.text()) - .build()); + ScenarioNode existingNode = existingNodeMap.get(nodeReq.nodeName()); + + if (existingNode != null) { + existingNode.updateBasicInfo(nodeReq.isStartNode()); + + // 대사 변경 여부 체크 + boolean scriptChanged = updateScriptsSmartly(existingNode, nodeReq.scripts()); + if (scriptChanged) isModified = true; + + updatedNodeMap.put(existingNode.getNodeName(), existingNode); + existingNode.clearOptionsAndLinks(); + } else { + isModified = true; // 새 노드 생성됨 + ScenarioNode newNode = ScenarioNode.builder() + .nodeName(nodeReq.nodeName()) + .isStartNode(nodeReq.isStartNode()) + .audioDuration(0) + .build(); + + if (nodeReq.scripts() != null) { + for (ScriptRequest scriptReq : nodeReq.scripts()) { + newNode.addScript(Script.builder() + .startTimeMs(0) + .speakerType(scriptReq.speakerType()) + .speakerName(scriptReq.speakerName()) + .text(scriptReq.text()) + .build()); + } } + scenario.addNode(newNode); + updatedNodeMap.put(newNode.getNodeName(), newNode); } - scenario.addNode(node); } - scenarioRepository.saveAndFlush(scenario); + // 노드가 삭제될 때, 그 안에 있던 개별 대사의 오디오 파일도 S3에서 삭제 + boolean nodesRemoved = scenario.getNodes().removeIf(node -> { + boolean shouldRemove = !updatedNodeMap.containsKey(node.getNodeName()); + if (shouldRemove) { + for (Script script : node.getScripts()) { + if (script.getAudioUrl() != null) { + s3Service.deleteFile(script.getAudioUrl()); // S3에서 삭제 + } + } + } + return shouldRemove; + }); - for (ScenarioNode savedNode : scenario.getNodes()) { - nodeMap.put(savedNode.getNodeName(), savedNode); - } + if (nodesRemoved) isModified = true; + scenarioRepository.flush(); + // 링크 재구축 로직 for (NodeRequest nodeReq : request.nodes()) { - ScenarioNode parentNode = nodeMap.get(nodeReq.nodeName()); - + ScenarioNode parentNode = updatedNodeMap.get(nodeReq.nodeName()); if (nodeReq.autoNextNode() != null && !nodeReq.autoNextNode().isBlank()) { - ScenarioNode targetAutoNode = nodeMap.get(nodeReq.autoNextNode()); - if (targetAutoNode != null) { - parentNode.updateAutoNextNodeId(targetAutoNode.getId()); - } + Optional.ofNullable(updatedNodeMap.get(nodeReq.autoNextNode())) + .ifPresent(target -> parentNode.updateAutoNextNodeId(target.getId())); } - if (nodeReq.interactiveOptions() != null) { for (OptionRequest optReq : nodeReq.interactiveOptions()) { - ScenarioNode targetNode = nodeMap.get(optReq.nextNodeName()); - if (targetNode != null) { - parentNode.addOption(InteractiveOption.builder() - .label(optReq.label()) - .nextNodeId(targetNode.getId()) - .build()); + Optional.ofNullable(updatedNodeMap.get(optReq.nextNodeName())) + .ifPresent(target -> parentNode.addOption(InteractiveOption.builder() + .label(optReq.label()) + .nextNodeId(target.getId()) + .build())); + } + } + } + scenarioRepository.flush(); + return isModified; + } + + /** + * 공통 로직: 트랜잭션이 성공적으로 DB에 반영(Commit)된 후 비동기 오디오 작업 시작 + */ + private void triggerAudioPipeline(Long scenarioId) { + TransactionSynchronizationManager.registerSynchronization(new TransactionSynchronization() { + @Override + public void afterCommit() { + audioPipelineService.generateAndMergeAudioAsync(scenarioId); + } + }); + } + + // 텍스트 변경 및 대사 삭제 시 S3 정리 로직 + private boolean updateScriptsSmartly(ScenarioNode existingNode, java.util.List requestedScripts) { + boolean isModified = false; + if (requestedScripts == null) return false; + java.util.List