Merge branch 'develop' into feat/all-logic-test

# Conflicts:
#	core/common/build.gradle.kts
#	gradle/libs.versions.toml

Author: PeraSite

.agents/skills/deploy-eatssu/SKILL.md

@@ -0,0 +1,164 @@
+---
+name: deploy-eatssu
+description: EAT-SSU Android 앱 릴리즈 자동화. 버전 범프, 릴리즈 노트 작성, release 브랜치 생성, PR 생성까지 전체 배포 플로우를 실행한다. "배포", "릴리즈", "release", "deploy", "출시", "버전 올려" 등의 키워드에 반응.
+version: 1.0.0
+---
+
+# Deploy EAT-SSU
+
+EAT-SSU Android 앱의 Google Play Store 릴리즈를 자동화하는 스킬.
+
+## 트리거
+
+사용자가 다음과 같이 요청할 때 이 스킬을 사용한다:
+- "배포해줘", "릴리즈 만들어줘", "출시해줘"
+- "버전 올려줘", "X.Y.Z 버전 만들어줘"
+- "release 브랜치 만들어줘"
+- "deploy", "release", "publish"
+
+## 전제 조건
+
+- `develop` 브랜치가 최신 상태여야 한다
+- 새 버전 번호가 필요하다 (사용자 지정 또는 자동 결정)
+
+## 릴리즈 플로우
+
+### Step 1: 버전 결정
+
+사용자가 버전을 지정하지 않았으면, 현재 버전을 확인하고 적절한 다음 버전을 제안한다.
+
+```bash
+# 현재 버전 확인
+grep 'versionName' app/build.gradle.kts | head -1
+grep 'versionCode' app/build.gradle.kts | head -1
+
+# 최신 태그 확인
+git tag --list | sort -V | tail -5
+```
+
+버전 규칙:
+- `versionName`: Semantic Versioning (`X.Y.Z`)
+- `versionCode`: 정수, 항상 +1 증가
+- 태그 형식: `X.Y.Z` (v 접두사 없음)
+- 릴리즈 노트 파일명: `release-notes/v<버전>.yml` (v 접두사 포함)
+→ 태그는 v 없이, 릴리즈 노트 파일명은 v 포함
+
+### Step 2: 변경사항 파악
+
+직전 릴리즈 태그 이후의 커밋을 분석한다.
+
+```bash
+# 이전 태그 이후 커밋 목록 (머지 커밋 제외)
+git log <이전태그>..develop --oneline --no-merges
+
+# 변경된 파일 통계
+git diff <이전태그>..develop --stat
+```
+
+각 커밋의 의미를 파악하여:
+- 사용자에게 보이는 변경 (Feat, Fix) → 릴리즈 노트에 포함
+- 내부 변경 (Refactor, CI/CD, Chore) → 릴리즈 노트에서 제외하되 PR 본문에는 포함
+
+### Step 3: develop 브랜치에서 release 브랜치 생성
+
+```bash
+git checkout develop
+git pull origin develop
+git checkout -b release/<버전>
+```
+
+### Step 4: 버전 범프
+
+`app/build.gradle.kts`의 `defaultConfig` 블록에서:
+
+```kotlin
+versionCode = <기존 + 1>
+versionName = "<새 버전>"
+```
+
+### Step 5: 릴리즈 노트 작성
+
+`release-notes/v<버전>.yml` 파일을 생성한다.
+
+형식:
+```yaml
+ko: |
+  - 한국어 릴리즈 노트 항목
+en: |
+  - English release note item
+```
+
+규칙 (반드시 준수):
+1. 각 항목은 `-`로 시작
+2. **한국어와 영어 모두 작성 필수**
+3. 개발자 용어 사용 금지 — 사용자 친화적 언어 사용
+4. 최소 10자 이상의 내용
+5. CI/CD, 리팩토링 등 사용자에게 보이지 않는 변경은 "앱의 안정성과 성능을 개선했어요" 류로 통합
+6. 이 내용이 **Google Play Store에 그대로 업로드**됨 (ko → Korea, en → Global)
+
+### Step 6: 커밋
+
+```bash
+git add app/build.gradle.kts release-notes/v<버전>.yml
+git commit -m "release: <버전>"
+```
+
+커밋 메시지는 반드시 `release: X.Y.Z` 형식을 사용한다.
+
+### Step 7: 푸시 & PR 생성
+
+```bash
+git push -u origin release/<버전>
+```
+
+PR 생성:
+- **base**: `develop`
+- **head**: `release/<버전>`
+- **title**: `release: <버전>`
+- **body**: 아래 템플릿 사용
+
+```markdown
+## Release <버전>
+
+### 변경사항 (<이전버전> → <새버전>)
+
+| 커밋 | 설명 | PR |
+|------|------|----|
+| `<hash>` | <커밋 메시지> | #<PR번호> |
+| ... | ... | ... |
+
+### 릴리즈 노트 (Play Store)
+
+**한국어**
+- <릴리즈 노트 항목들>
+
+**English**
+- <릴리즈 노트 항목들>
+
+### 버전 정보
+- `versionCode`: <이전> → <새>
+- `versionName`: <이전버전> → <새버전>
+```
+
+## PR 머지 후 자동 처리
+
+PR이 `develop`에 머지되면 GitHub Actions (`release.yml`)가 자동으로:
+
+1. Fastlane으로 Release AAB 빌드
+2. Google Play Store `production` 트랙에 배포
+3. GitHub Release 생성 (태그 + 자동 릴리즈 노트 + AAB 첨부)
+4. Slack 알림 전송
+
+## 수동 배포 (workflow_dispatch)
+
+GitHub Actions 탭에서 직접 실행도 가능:
+1. Actions → **Production Release** 워크플로우
+2. **Run workflow** 클릭
+3. `version`, `track` (internal/alpha/beta/production), `release_notes` 입력
+
+## 주의사항
+
+- **절대 `main`/`master`에 직접 푸시하지 않는다** — 항상 PR을 통해 머지
+- 릴리즈 노트 YAML 파일이 없거나 내용이 부족하면 Play Store 배포가 실패할 수 있다
+- `versionCode`는 Play Store에서 고유해야 하므로 **반드시 증가**시킨다
+- GitHub Secrets가 올바르게 설정되어 있어야 CI/CD가 동작한다

.github/workflows/debug.yml

@@ -152,3 +152,25 @@ jobs:
             issue_number: context.payload.pull_request.number,
             body,
           });
+
+    - name: Slack notification for App Distribution
+      if: success()
+      uses: 8398a7/action-slack@v3
+      with:
+        status: success
+        text: |
+          🔥 Firebase App Distribution 배포 완료!
+          
+          PR: #${{ github.event.pull_request.number }} - ${{ github.event.pull_request.title }}
+          브랜치: ${{ github.event.pull_request.head.ref }}
+          테스터 그룹: eat-ssu-android-qa
+        custom_payload: |
+          {
+            attachments: [{
+              color: 'good',
+              text: '🔥 Firebase App Distribution 배포 완료!\n\nPR: #${{ github.event.pull_request.number }} - ${{ github.event.pull_request.title }}\n브랜치: ${{ github.event.pull_request.head.ref }}\n테스터 그룹: eat-ssu-android-qa'
+            }]
+          }
+      env:
+        SLACK_WEBHOOK_URL: ${{ secrets.SLACK_APP_DISTRIBUTION_WEBHOOK_URL }}
+

.github/workflows/release.yml

@@ -184,22 +184,34 @@ jobs:
           if [ -f "$RELEASE_NOTE_FILE" ]; then
             echo "✅ $RELEASE_NOTE_FILE 파일 발견"
             echo "exists=true" >> $GITHUB_OUTPUT
-            
-            RELEASE_NOTES_CONTENT=$(ruby -e "require 'yaml'; begin; puts YAML.load_file('$RELEASE_NOTE_FILE')['ko']; rescue; end")
-            
-            if [ -z "$RELEASE_NOTES_CONTENT" ]; then
-               echo "⚠️ YAML 파일에서 'ko' 항목을 찾을 수 없거나 비어있습니다."
-               echo "release_notes=" >> $GITHUB_OUTPUT
-            else
-               echo "release_notes<<EOF" >> $GITHUB_OUTPUT
-               echo "$RELEASE_NOTES_CONTENT" >> $GITHUB_OUTPUT
-               echo "EOF" >> $GITHUB_OUTPUT
-               echo "📄 릴리즈 노트 내용:"
-               echo "$RELEASE_NOTES_CONTENT"
+
+            RELEASE_NOTES_KO=$(ruby -e "require 'yaml'; begin; data = YAML.load_file('$RELEASE_NOTE_FILE') || {}; puts((data['ko-KR'] || data['ko'] || '').to_s); rescue; end")
+            RELEASE_NOTES_EN=$(ruby -e "require 'yaml'; begin; data = YAML.load_file('$RELEASE_NOTE_FILE') || {}; puts((data['en-US'] || data['en'] || '').to_s); rescue; end")
+
+            if [ -z "$RELEASE_NOTES_KO" ]; then
+               echo "⚠️ YAML 파일에서 한국어 릴리즈 노트(ko/ko-KR)를 찾지 못했습니다."
+            fi
+
+            if [ -z "$RELEASE_NOTES_EN" ]; then
+               echo "⚠️ YAML 파일에서 영어 릴리즈 노트(en/en-US)를 찾지 못했습니다."
             fi
+
+            echo "release_notes_ko<<EOF" >> $GITHUB_OUTPUT
+            echo "$RELEASE_NOTES_KO" >> $GITHUB_OUTPUT
+            echo "EOF" >> $GITHUB_OUTPUT
+
+            echo "release_notes_en<<EOF" >> $GITHUB_OUTPUT
+            echo "$RELEASE_NOTES_EN" >> $GITHUB_OUTPUT
+            echo "EOF" >> $GITHUB_OUTPUT
+
+            echo "📄 한국어 릴리즈 노트:"
+            echo "$RELEASE_NOTES_KO"
+            echo "📄 영어 릴리즈 노트:"
+            echo "$RELEASE_NOTES_EN"
           else
             echo "⚠️ $RELEASE_NOTE_FILE 파일을 찾을 수 없습니다."
-            echo "release_notes=" >> $GITHUB_OUTPUT
+            echo "release_notes_ko=" >> $GITHUB_OUTPUT
+            echo "release_notes_en=" >> $GITHUB_OUTPUT
           fi
 
       - name: Find previous tag for release notes
@@ -311,9 +323,13 @@ jobs:
             
             버전명: ${{ steps.extract_info.outputs.version }}
             
-            PlayStore 릴리즈 노트
+            PlayStore 릴리즈 노트 (KO)
             
-            ${{ steps.check_release_notes.outputs.release_notes != '' && steps.check_release_notes.outputs.release_notes || '릴리즈 노트가 없습니다.' }}
+            ${{ steps.check_release_notes.outputs.release_notes_ko != '' && steps.check_release_notes.outputs.release_notes_ko || '한국어 릴리즈 노트가 없습니다.' }}
+
+            PlayStore 릴리즈 노트 (EN)
+
+            ${{ steps.check_release_notes.outputs.release_notes_en != '' && steps.check_release_notes.outputs.release_notes_en || 'English release notes are missing.' }}
             
             GitHub 릴리즈노트
             
@@ -322,7 +338,7 @@ jobs:
             {
               attachments: [{
                 color: '${{ job.status }}' === 'success' ? 'good' : 'danger',
-                text: '[Android 업데이트 올렸습니다!]\n\n버전명: ${{ steps.extract_info.outputs.version }}\n\nPlayStore 릴리즈 노트\n\n${{ steps.check_release_notes.outputs.release_notes != '' && steps.check_release_notes.outputs.release_notes || '릴리즈 노트가 없습니다.' }}\n\nGitHub 릴리즈노트\n\n${{ steps.github_release_notes.outputs.github_notes != '' && steps.github_release_notes.outputs.github_notes || '- [Fix] 릴리즈 노트를 가져올 수 없습니다.' }}'
+                text: '[Android 업데이트 올렸습니다!]\n\n버전명: ${{ steps.extract_info.outputs.version }}\n\nPlayStore 릴리즈 노트 (KO)\n\n${{ steps.check_release_notes.outputs.release_notes_ko != '' && steps.check_release_notes.outputs.release_notes_ko || '한국어 릴리즈 노트가 없습니다.' }}\n\nPlayStore 릴리즈 노트 (EN)\n\n${{ steps.check_release_notes.outputs.release_notes_en != '' && steps.check_release_notes.outputs.release_notes_en || 'English release notes are missing.' }}\n\nGitHub 릴리즈노트\n\n${{ steps.github_release_notes.outputs.github_notes != '' && steps.github_release_notes.outputs.github_notes || '- [Fix] 릴리즈 노트를 가져올 수 없습니다.' }}'
               }]
             }
         env:

app/build.gradle.kts

@@ -3,6 +3,7 @@ import java.util.Properties
 plugins {
     alias(libs.plugins.android.application)
     alias(libs.plugins.kotlin.android)
+    alias(libs.plugins.kotlin.serialization)
     alias(libs.plugins.compose.compiler)
     alias(libs.plugins.google.services)
     alias(libs.plugins.firebase.crashlytics)
@@ -29,8 +30,8 @@ android {
         applicationId = "com.eatssu.android"
         minSdk = 28
         targetSdk = 35
-        versionCode = 53
-        versionName = "3.2.2"
+        versionCode = 58
+        versionName = "3.2.4"
 
       testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
     }
@@ -197,10 +198,7 @@ dependencies {
 
     //retrofit2: 서버통신
     implementation(libs.retrofit)
-    implementation(libs.retrofit.converter.gson)
 
-    // Gson for JSON parsing
-    implementation(libs.gson)
 
     //OkHttp: 통신 로그 확인하기 위함
     implementation(libs.okhttp)
@@ -277,6 +275,10 @@ dependencies {
     // Paging3
     implementation(libs.androidx.paging.runtime)
     implementation(libs.androidx.paging.compose)
+
+    // Kotlin Serialization
+    implementation(libs.kotlinx.serialization.json)
+    implementation(libs.retrofit.kotlinx.serialization.converter)
 }
 
 configurations.all {

app/src/main/java/com/eatssu/android/data/remote/dto/request/ChangeNicknameRequest.kt

@@ -1,5 +1,8 @@
 package com.eatssu.android.data.remote.dto.request
 
+import kotlinx.serialization.Serializable
+
+@Serializable
 data class ChangeNicknameRequest(
     val nickname: String,
-)
+)

app/src/main/java/com/eatssu/android/data/remote/dto/request/CheckValidTokenRequest.kt

@@ -1,5 +1,8 @@
 package com.eatssu.android.data.remote.dto.request
 
+import kotlinx.serialization.Serializable
+
+@Serializable
 data class CheckValidTokenRequest(
     val token: String,
-)
+)

app/src/main/java/com/eatssu/android/data/remote/dto/request/LoginWithKakaoRequest.kt

@@ -1,15 +1,17 @@
 package com.eatssu.android.data.remote.dto.request
 
 import com.eatssu.common.enums.DeviceType
-import com.google.gson.annotations.SerializedName
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
 
+@Serializable
 data class LoginWithKakaoRequest(
-    @SerializedName("email")
+    @SerialName("email")
     val email: String,
 
-    @SerializedName("providerId")
+    @SerialName("providerId")
     val providerId: String,
 
-    @SerializedName("deviceType")
+    @SerialName("deviceType")
     val deviceType: DeviceType,
 )

app/src/main/java/com/eatssu/android/data/remote/dto/request/ModifyReviewRequest.kt

@@ -1,16 +1,19 @@
 package com.eatssu.android.data.remote.dto.request
 
-import com.google.gson.annotations.SerializedName
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
 
+@Serializable
 data class ModifyReviewRequest(
-    @SerializedName("rating") val rating: Int? = null,
-    @SerializedName("menuLikes") val menuLikes: List<MenuLikes> = arrayListOf(),
-    @SerializedName("content") val content: String? = null
+    @SerialName("rating") val rating: Int? = null,
+    @SerialName("menuLikes") val menuLikes: List<MenuLikes> = arrayListOf(),
+    @SerialName("content") val content: String? = null
 ) {
+    @Serializable
     data class MenuLikes(
 
-        @SerializedName("menuId") val menuId: Long? = null,
-        @SerializedName("isLike") val isLike: Boolean? = null
+        @SerialName("menuId") val menuId: Long? = null,
+        @SerialName("isLike") val isLike: Boolean? = null
 
     )
 }

app/src/main/java/com/eatssu/android/data/remote/dto/request/ReportRequest.kt

@@ -1,14 +1,16 @@
 package com.eatssu.android.data.remote.dto.request
 
-import com.google.gson.annotations.SerializedName
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
 
+@Serializable
 data class ReportRequest(
-    @SerializedName("reviewId")
+    @SerialName("reviewId")
     val reviewId: Long,
 
-    @SerializedName("reportType")
+    @SerialName("reportType")
     val reportType: String,
 
-    @SerializedName("content")
+    @SerialName("content")
     val content: String,
 )