feat: v1.3.0 - versionCode 기반 업데이트 체크

- 버전 1.2.5 → 1.3.0 (versionCode 1130) - AppUpdateManager: versionCode로 업데이트 비교 - versionName 비교 로직 제거 - 더 정확한 업데이트 감지 Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
fix: build.gradle 버전 1.2.5로 업데이트
2026-02-28 18:50:55 +09:00 · 2026-02-28 18:43:29 +09:00 · 2026-02-28 18:37:32 +09:00 · 2026-02-28 18:26:08 +09:00 · 2026-02-23 12:48:37 +09:00 · 2026-02-23 12:31:51 +09:00
17 changed files with 475 additions and 282 deletions
--- a/.agent/workflows/GIT_PUSH_GUIDE.md
+++ b/.agent/workflows/GIT_PUSH_GUIDE.md
@@ -1,143 +0,0 @@
-# Git 푸시 성공 가이드
-
-## 빠른 실행
-
-```bash
-# 1. gh CLI 인증 확인
-./gh.exe auth status
-
-# 2. 인증이 안 되어 있으면 로그인
-./gh.exe auth login --web
-
-# 3. Git에 gh 인증 설정
-./gh.exe auth setup-git
-
-# 4. 푸시
-git push shiftring main
-```
-
---
-
-## 상세 절차
-
-### 1. GitHub CLI 인증
-
-```bash
-# 인증 상태 확인
-./gh.exe auth status
-```
-
-**인증이 안 된 경우:**
-```bash
-./gh.exe auth login --web
-```
- One-time code가 표시됨 (예: C7EF-30B3)
- https://github.com/login/device 접속
- 코드 입력 후 인증 완료
-
-### 2. Git에 gh 인증 연동
-
-```bash
-./gh.exe auth setup-git
-```
-
-### 3. 푸시 실행
-
-```bash
-# shiftring remote 사용 (agent.md에 정의됨)
-git push shiftring main
-
-# 또는 origin 사용
-git push origin main
-```
-
---
-
-## 저장소 정보
-
-| Remote | URL | 용도 |
-|--------|-----|------|
-| origin | https://github.com/sanjeok77-tech/ShiftRing.git | 코드 저장소 |
-| shiftring | https://github.com/sanjeok77-tech/ShiftRing.git | 코드 저장소 (동일) |
-
---
-
-## 문제 해결
-
-### "Cannot prompt because user interactivity has been disabled"
-
-**원인**: 환경 변수로 인해 인터랙티브 프롬프트가 비활성화됨
-
-**해결**:
-```bash
-# gh CLI로 인증 설정
-./gh.exe auth setup-git
-
-# 그 다음 푸시
-git push shiftring main
-```
-
-### "Host key verification failed" (SSH)
-
-**원인**: SSH 키가 설정되지 않음
-
-**해결**: HTTPS 사용
-```bash
-git remote set-url origin https://github.com/sanjeok77-tech/ShiftRing.git
-```
-
---
-
-## 릴리즈 푸시 (dakjaba-releases)
-
-```bash
-# 1. 버전 파일 업데이트
-# version.json, CHANGELOG.md, README.md 수정
-
-# 2. APK 복사
-cp app/build/outputs/apk/release/app-release.apk app.apk
-
-# 3. GitHub Release 생성
-./gh.exe release create v1.1.4 "app.apk" \
-  --title "Shiftring v1.1.4" \
-  --notes "릴리즈 노트" \
-  -R "sanjeok77-tech/dakjaba-releases"
-
-# 4. dakjaba-releases 저장소 업데이트
-./gh.exe repo clone sanjeok77-tech/dakjaba-releases ../dakjaba-releases-temp
-cp version.json ../dakjaba-releases-temp/
-cp app.apk ../dakjaba-releases-temp/
-cd ../dakjaba-releases-temp
-git add . && git commit -m "update: vX.X.X" && git push origin main
-cd ..
-rm -rf dakjaba-releases-temp
-
-# 5. 소스 코드 커밋 및 푸시
-cd /c/Users/work/Desktop/1.0.0
-git add . && git commit -m "chore: release vX.X.X"
-git push shiftring main
-```
-
---
-
-## 성공 사례 (2026-02-21)
-
-```bash
-$ ./gh.exe auth status
-github.com
-  ✓ Logged in to github.com account sanjeok77-tech (keyring)
-  - Active account: true
-  - Git operations protocol: https
-  - Token: gho_************************************
-
-$ ./gh.exe auth setup-git
-git: authorization completed
-
-$ git push shiftring main
-To https://github.com/sanjeok77-tech/ShiftRing.git
-   a848cd8..c72db7f  main -> main
-```
-
---
-
-**최종 수정**: 2026-02-21
--- a/.agent/workflows/push.md
+++ b/.agent/workflows/push.md
@@ -1,70 +0,0 @@
---
-description: 릴리즈 빌드 및 배포 자동화 가이드 (GitHub CLI 기반)
---
-
-# 🚀 릴리즈 빌드 및 배포 워크플로우
-
-이 가이드는 교대링(Shiftring) 프로젝트의 최신 버전을 빌드하고, APK를 배포 저장소(`dakjaba-releases`)에 업로드하며, 버전을 갱신하는 절차를 설명합니다.
-
-## // turbo-all
-## 1. 전제 조건
- **GitHub CLI (gh)**가 설치되어 있고 로그인되어 있어야 함 (`gh auth status`)
- `release.jks`와 `keystore.properties`가 루트 폴더에 존재해야 함
-
-## 2. 배포 단계
-
-### 단계 1: 프로젝트 버전 확인 및 갱신
- `app/build.gradle.kts`의 `versionCode`와 `versionName`을 확인 및 갱신합니다.
- `version.json`의 정보를 동일하게 맞춥니다.
- `CHANGELOG.md`에 변경 사항을 기록합니다.
- `README.md`의 다운로드 링크 및 버전을 갱신합니다.
-
-### 단계 2: 릴리즈 빌드 수행
-```powershell
-./gradlew.bat assembleRelease
-```
- 빌드 결과물은 `app/build/outputs/apk/release/app-release.apk`에 생성됩니다.
-
-### 단계 3: APK 서명 확인 (선택 사항)
- 생성된 APK가 정상적으로 서명되었는지 확인합니다.
-
-### 단계 4: 배포 저장소 업데이트 및 릴리즈 생성
-// turbo
-```powershell
-# 1. APK 파일 복사 (배포용 이름으로 변경)
-copy-item "app/build/outputs/apk/release/app-release.apk" "app.apk" -Force
-
-# 2. 버전 정보 설정 (현재 버전에 맞춰 수정)
-$VERSION = "v1.0.4"
-
-# 3. GitHub Release 생성 (dakjaba-releases 저장소)
-# tip: 이미 존재하는 태그라면 삭제 후 생성하거나 gh release edit 사용
-gh release create $VERSION "app.apk" --title "Shiftring $VERSION" --notes-file "CHANGELOG.md" -R "sanjeok77-tech/dakjaba-releases"
-
-# 4. 배포 저장소(dakjaba-releases)의 version.json 및 최신 APK 갱신 (인앱 업데이트용)
-gh repo clone sanjeok77-tech/dakjaba-releases ..\dakjaba-releases-temp
-copy-item "version.json" "..\dakjaba-releases-temp\version.json" -Force
-copy-item "app.apk" "..\dakjaba-releases-temp\app.apk" -Force
-
-# 5. README.md 자동 업데이트 (v1.1.1 패턴 기반 교체 예시 - 실제 버전변수로 대체 필요)
-# tip: sed나 powershell replace를 사용하여 README의 vX.X.X 및 다운로드 링크를 갱신합니다.
-(Get-Content README.md) -replace 'v\d+\.\d+\.\d+', "$VERSION" | Set-Content README.md
-(Get-Content ..\dakjaba-releases-temp\README.md) -replace 'v\d+\.\d+\.\d+', "$VERSION" | Set-Content ..\dakjaba-releases-temp\README.md
-
-pushd ..\dakjaba-releases-temp
-git add .
-git commit -m "update: $VERSION"
-git push origin main
-popd
-Remove-Item -Recurse -Force ..\dakjaba-releases-temp
-```
-
-### 단계 5: 소스 코드 커밋 및 푸시
-```powershell
-git add .
-git commit -m "chore: release $VERSION"
-git push origin main
-```
-
---
-*주의: 배포 저장소(`dakjaba-releases`)는 퍼블릭이며, 코드 저장소(`dakjaba`)는 프라이빗입니다. 배포 시 중요한 키 파일이 배포 저장소에 포함되지 않도록 주의하십시오.*
--- a/GITEA_RELEASE_GUIDE.md
+++ b/GITEA_RELEASE_GUIDE.md
@@ -0,0 +1,206 @@
+# Gitea 릴리즈 작업 가이드
+
+> ShiftRing 프로젝트 Gitea 릴리즈 자동화 문서
+> 저장소: https://git.webpluss.net/sanjeok77/ShiftRing
+
+---
+
+## 🔐 인증 정보
+
+**Personal Access Token (PAT)**
+- 위치: `.env.local` 파일
+- 형식: `e3b515eaa0a6683c921ca3bf718e281ed30a6075`
+- 사용자: `sanjeok77`
+
+**인증 헤더**
+```bash
+-u "sanjeok77:TOKEN"
+```
+
+---
+
+## 📋 릴리즈 생성 절차
+
+### 1. 버전 업데이트 (3곳)
+
+#### 1.1 `app/build.gradle.kts` - 앱 날부 버전
+```kotlin
+defaultConfig {
+    versionCode = 1125        // ← 이전: 1124
+    versionName = "1.2.5"     // ← 이전: "1.2.4"
+}
+```
+
+#### 1.2 `version.json` - 서버 버전 정보
+```json
+{
+  "versionCode": 1125,
+  "versionName": "1.2.5",
+  "apkUrl": "https://git.webpluss.net/attachments/{UUID}",
+  "changelog": "v1.2.5: 변경사항 요약",
+  "forceUpdate": false
+}
+```
+
+#### 1.3 Git 태그 및 릴리즈
+- 태그: `v1.2.5`
+- 브랜치: `dev` (개발) → `main` (배포)
+
+---
+
+### 2. 릴리즈 생성 (API)
+
+**엔드포인트**
+```bash
+POST https://git.webpluss.net/api/v1/repos/sanjeok77/ShiftRing/releases
+```
+
+**요청 예시**
+```bash
+curl -X POST \
+  -H "Content-Type: application/json" \
+  -u "sanjeok77:TOKEN" \
+  "https://git.webpluss.net/api/v1/repos/sanjeok77/ShiftRing/releases" \
+  -d '{
+    "tag_name": "v1.2.5",
+    "name": "v1.2.5 - 릴리즈 제목",
+    "body": "## 변경사항\n\n- 기능1\n- 기능2",
+    "prerelease": false,
+    "target_commitish": "dev"
+  }'
+```
+
+**응답 예시**
+```json
+{
+  "id": 30,
+  "tag_name": "v1.2.5",
+  "upload_url": "https://git.webpluss.net/api/v1/repos/sanjeok77/ShiftRing/releases/30/assets"
+}
+```
+
+---
+
+### 3. APK 빌드
+
+**릴리즈 빌드**
+```bash
+./gradlew :app:assembleRelease
+```
+
+**출력 경로**
+```
+app/build/outputs/apk/release/app-release.apk
+```
+
+**서명 설정** (`keystore.properties`)
+```properties
+storePassword=비밀번호
+keyAlias=별칭
+keyPassword=비밀번호
+storeFile=../release.jks
+```
+
+---
+
+### 4. APK 업로드 (API)
+
+**엔드포인트**
+```bash
+POST https://git.webpluss.net/api/v1/repos/sanjeok77/ShiftRing/releases/{release_id}/assets
+```
+
+**요청 예시**
+```bash
+curl -X POST \
+  -u "sanjeok77:TOKEN" \
+  -H "Content-Type: multipart/form-data" \
+  -F "attachment=@app/build/outputs/apk/release/app-release.apk" \
+  "https://git.webpluss.net/api/v1/repos/sanjeok77/ShiftRing/releases/30/assets?name=app.apk"
+```
+
+**응답 예시**
+```json
+{
+  "id": 37,
+  "name": "app.apk",
+  "size": 5236988,
+  "browser_download_url": "https://git.webpluss.net/attachments/b8f53c11-743f-416c-87ae-bd478c781abf"
+}
+```
+
+---
+
+### 5. version.json 업데이트
+
+**APK URL 업데이트**
+```json
+{
+  "apkUrl": "https://git.webpluss.net/attachments/{UUID}"
+}
+```
+
+**주의**: `releases/download/v1.2.5/app.apk` 형식이 아닌 `attachments/{UUID}` 형식 사용
+
+---
+
+## 🔧 유틸리티 명령어
+
+### 릴리즈 조회
+```bash
+curl -s -u "sanjeok77:TOKEN" \
+  "https://git.webpluss.net/api/v1/repos/sanjeok77/ShiftRing/releases" | jq '.[].tag_name'
+```
+
+### 특정 릴리즈 조회
+```bash
+curl -s -u "sanjeok77:TOKEN" \
+  "https://git.webpluss.net/api/v1/repos/sanjeok77/ShiftRing/releases/30"
+```
+
+### 첨부파일 삭제
+```bash
+curl -s -u "sanjeok77:TOKEN" \
+  -X DELETE \
+  "https://git.webpluss.net/api/v1/repos/sanjeok77/ShiftRing/releases/30/assets/{asset_id}"
+```
+
+---
+
+## ⚠️ 주의사항
+
+1. **버전 일치**: `build.gradle.kts`, `version.json`, Git 태그 3곳 모두 동일 버전 사용
+2. **APK 파일명**: 반드시 `app.apk`로 업로드 (클리어 이름 지정)
+3. **UUID**: 업로드 후 반환된 UUID를 `version.json`에 반영
+4. **브랜치**: 
+   - 개발: `dev` 브랜치에 커밋
+   - 배포: `main` 브랜치에 cherry-pick
+
+---
+
+## 📁 관련 파일
+
+| 파일 | 설명 |
+|------|------|
+| `app/build.gradle.kts` | 앱 날부 버전 설정 |
+| `version.json` | 서버 버전 정보 |
+| `keystore.properties` | 서명 키 설정 |
+| `release.jks` | 서명 키스토어 |
+| `.env.local` | API 토큰 저장 |
+
+---
+
+## 📝 변경 이력
+
+| 날짜 | 버전 | 작업 |
+|------|------|------|
+| 2026-02-28 | v1.2.5 | 알람 시스템 단순화 릴리즈 |
+| 2026-02-28 | v1.2.4 | 버그 수정 릴리즈 |
+
+---
+
+## 🔗 참고 링크
+
+- 릴리즈 페이지: https://git.webpluss.net/sanjeok77/ShiftRing/releases
+- API 문서: https://git.webpluss.net/api/swagger
+- Swagger UI: https://git.webpluss.net/api/swagger#/repository/repoCreateRelease
--- a/README.md
+++ b/README.md
@@ -1,7 +1,9 @@
 # Shift Alarm (교대링 - 전주/논산)

 <p align="center">
+  <a href="https://git.webpluss.net/sanjeok77/ShiftRing/releases/tag/v1.1.9">
    <img src="https://img.shields.io/badge/Download-Release_v1.1.9-blue?style=for-the-badge&logo=android&logoColor=white">
+  </a>
 </p>

 [** 최신 버전 (v1.1.9) 다운로드 (APK)**](https://git.webpluss.net/sanjeok77/ShiftRing/releases/download/v1.1.9/app.apk)
--- a/RELEASE_UPLOAD_GUIDE.md
+++ b/RELEASE_UPLOAD_GUIDE.md
@@ -0,0 +1,55 @@
+# Gitea Release에 APK 업로드 방법
+
+## 환경
+- Git 호스팅: git.webpluss.net (Gitea)
+- 저장소: sanjeok77/ShiftRing
+- 태그: v1.1.9
+- APK 경로: C:\Users\work\Desktop\1.0.0\app.apk
+
+## 1. Release ID 확인
+
+```bash
+# Release 목록 조회
+curl -s "https://git.webpluss.net/api/v1/repos/sanjeok77/ShiftRing/releases"
+```
+
+응답에서 Release ID 확인 (예: `id: 5`)
+
+## 2. APK 업로드
+
+```bash
+# Personal Access Token 사용
+curl -s -u "username:TOKEN" \
+  -X POST "https://git.webpluss.net/api/v1/repos/sanjeok77/ShiftRing/releases/5/assets" \
+  -F "attachment=@C:/Users/work/Desktop/1.0.0/app.apk" \
+  -F "name=app.apk"
+```
+
+## 3. 릴리즈 설명 수정 (한글 깨짐 방지)
+
+```bash
+# --data-binary 사용하고 stdin으로 JSON 전달
+curl -s -u "sanjeok77:TOKEN" \
+  -X PATCH "https://git.webpluss.net/api/v1/repos/sanjeok77/ShiftRing/releases/5" \
+  -H "Content-Type: application/json; charset=utf-8" \
+  --data-binary @- << 'EOF'
+{"body":"## v1.1.9 - 수정 내용\n\n- 수정사항 1\n- 수정사항 2\n\nNo description provided"}
+EOF
+```
+
+### 한글 깨짐 방지 팁
+- `-H "Content-Type: application/json; charset=utf-8"` 추가
+- `--data-binary @-` 사용 (stdin에서 읽기)
+- `<< 'EOF'` 로 HEREDOC 사용 (변수展開 방지)
+
+## 4. 확인
+
+```bash
+# 릴리즈 정보 조회
+curl -s "https://git.webpluss.net/api/v1/repos/sanjeok77/ShiftRing/releases/5"
+```
+
+## 참고
+- GitLab이 아닌 **Gitea** 이므로 API 경로가 다름
+- GitLab: `/api/v4/projects/:id/releases`
+- Gitea: `/api/v1/repos/:owner/:repo/releases/:id`
--- a/agent.md
+++ b/agent.md
@@ -46,42 +46,31 @@
  ```

 ### 3.3 릴리즈 순서
+
+> **참고**: Gitea Release APK 업로드 방법은 [RELEASE_UPLOAD_GUIDE.md](./RELEASE_UPLOAD_GUIDE.md) 문서를 참조하세요.
+
 1.  **버전 업데이트**: `build.gradle.kts`에서 `versionCode`와 `versionName`을 올린다.
-    - 예: `versionCode = 101`, `versionName = "1.0.1"`
+    - 예: `versionCode = 1120`, `versionName = "1.2.0"`
 2.  **빌드**: 릴리즈 빌드 수행
    ```bash
    ./gradlew assembleRelease
    ```
-3.  **릴리즈 생성**: GitLab 웹 인터페이스 또는 CLI 사용
-    ```bash
-    # 1) ShiftRing 리포지토리에 푸시
-    git push shiftring main
-    
-    # 2) 기존 릴리즈 삭제 (필요시)
-    gh release delete v1.0.1 --repo sanjeok77/ShiftRing -y
-    
-    # 3) 신규 릴리즈 생성
-    gh release create v1.0.1 \
-      --repo sanjeok77/ShiftRing \
-      --title "v1.0.1 - 릴리즈 제목" \
-      --notes "릴리즈 노트 내용" \
-      app/build/outputs/apk/release/app-release.apk
-    ```
+3.  **릴리즈 생성**: Gitea API 또는 웹 인터페이스 사용
+    - 자세한 방법은 [RELEASE_UPLOAD_GUIDE.md](./RELEASE_UPLOAD_GUIDE.md) 참조
 4.  **version.json 업데이트**: ShiftRing 리포지토리 루트에 `version.json` 파일 생성/수정
    ```json
    {
-      "versionCode": 101,
-      "versionName": "1.0.1",
-      "apkUrl": "https://git.webpluss.net/sanjeok77/ShiftRing/releases/download/v1.0.0/app.apk",
+      "versionCode": 1120,
+      "versionName": "1.2.0",
+      "apkUrl": "https://git.webpluss.net/sanjeok77/ShiftRing/releases/download/v1.2.0/app.apk",
      "changelog": "수정사항 요약"
    }
    ```
 5.  **소스 코드 커밋**: 코드 저장소에 변경 사항 푸시
    ```bash
    git add -A
-    git commit -m "Release v1.0.1"
+    git commit -m "Release v1.2.0"
    git push origin main
-    git push shiftring main
    ```

 ### 3.4 저장소 정보 (단일 저장소 전략)
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -20,8 +20,10 @@ android {
        applicationId = "com.example.shiftalarm"
        minSdk = 26
        targetSdk = 35
-        versionCode = 1119
-        versionName = "1.1.9"
+        versionCode = 1130
+        versionName = "1.3.0"
+        versionName = "1.2.5"
+

        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
    }
--- a/app/src/main/java/com/example/shiftalarm/AlarmActivity.kt
+++ b/app/src/main/java/com/example/shiftalarm/AlarmActivity.kt
@@ -78,6 +78,14 @@ class AlarmActivity : AppCompatActivity() {

        // 알람 시작 (화면 상태와 무관하게 항상 실행)
        startAlarm()
+        
+        // 마스터 알람이 꺼져있으면 알람 화면을 즉시 종료
+        val prefs = getSharedPreferences("ShiftAlarmPrefs", Context.MODE_PRIVATE)
+        if (!ShiftAlarmDefaults.isMasterAlarmEnabled(prefs)) {
+            Toast.makeText(this, "전체 알람이 꺼져있습니다.", Toast.LENGTH_SHORT).show()
+            finish()
+            return
+        }
        setupControls()

        // 5분 후 자동 스누즈
@@ -209,6 +217,7 @@ class AlarmActivity : AppCompatActivity() {
                    val dx = event.rawX - startX
                    if (abs(dx) > maxSwipe * 0.8f) {
                        // Trigger Dismiss
+                        @Suppress("DEPRECATION")
                        (getSystemService(Context.VIBRATOR_SERVICE) as? Vibrator)?.vibrate(50)
                        Toast.makeText(this, "알람 해제 완료", Toast.LENGTH_SHORT).show()
                        stopAlarm(); finish()
@@ -247,6 +256,7 @@ class AlarmActivity : AppCompatActivity() {
    }

    private fun handleSnooze() {
+        @Suppress("DEPRECATION")
        (getSystemService(Context.VIBRATOR_SERVICE) as? Vibrator)?.vibrate(50)
        val snoozeRepeat = intent.getIntExtra("EXTRA_SNOOZE_REPEAT", 3)
        val text = if (snoozeRepeat == 99) "다시 울림 설정됨" else "다시 울림 (${snoozeRepeat}회 남음)"
@@ -274,21 +284,25 @@ class AlarmActivity : AppCompatActivity() {
            else android.provider.Settings.System.DEFAULT_ALARM_ALERT_URI
        }

-        // AudioAttributes 강화: 화면 켜진 상태에서도 알람음이 울리도록
+        // AudioAttributes 강화: 무음/진동 모드에서도 알람음이 울리도록
        val audioAttrs = AudioAttributes.Builder()
            .setUsage(AudioAttributes.USAGE_ALARM)
            .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
-            .setFlags(AudioAttributes.FLAG_AUDIBILITY_ENFORCED)  // 볼륨 강제 적용
+            .setFlags(AudioAttributes.FLAG_AUDIBILITY_ENFORCED)
            .build()

-        // AudioManager를 통해 알람 볼륨 설정
+        // AudioManager를 통해 알람 볼륨 설정 및 무음 모드 우회
        val audioManager = getSystemService(Context.AUDIO_SERVICE) as AudioManager
-        val originalVolume = audioManager.getStreamVolume(AudioManager.STREAM_ALARM)
-        val maxVolume = audioManager.getStreamMaxVolume(AudioManager.STREAM_ALARM)
+        
+        // 무음 모드에서도 알람음이 울리도록 STREAM_ALARM 사용 (벨소리와 독립)
+        // 알람 스트림은 다른 스트림과 달리 무음 모드에서도 울림
+        val originalRingerMode = audioManager.ringerMode
        
        // 알람 볼륨을 최대로 설정 (사용자가 나중에 조정 가능)
        try {
+            val maxVolume = audioManager.getStreamMaxVolume(AudioManager.STREAM_ALARM)
            audioManager.setStreamVolume(AudioManager.STREAM_ALARM, maxVolume, 0)
+            Log.d("AlarmActivity", "알람 볼륨 설정: $maxVolume (RingerMode: $originalRingerMode)")
        } catch (e: Exception) {
            Log.w("AlarmActivity", "알람 볼륨 설정 실패", e)
        }
--- a/app/src/main/java/com/example/shiftalarm/AlarmReceiver.kt
+++ b/app/src/main/java/com/example/shiftalarm/AlarmReceiver.kt
@@ -15,6 +15,13 @@ class AlarmReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent?) {
        Log.d(TAG, "===== 알람 수신 (Receiver) =====")
        
+        // 마스터 알람이 꺼져있으면 알람 무시
+        val prefs = context.getSharedPreferences("ShiftAlarmPrefs", Context.MODE_PRIVATE)
+        if (!ShiftAlarmDefaults.isMasterAlarmEnabled(prefs)) {
+            Log.w(TAG, "마스터 알람이 꺼져있어 알람을 무시합니다.")
+            return
+        }
+        
        val alarmId = intent?.getIntExtra("EXTRA_ALARM_ID", -1) ?: -1
        val isCustom = intent?.getBooleanExtra("EXTRA_IS_CUSTOM", false) ?: false
        
@@ -50,6 +57,7 @@ class AlarmReceiver : BroadcastReceiver() {
    private fun startAlarm(context: Context, intent: Intent?) {
        // WakeLock 획득 (화면 켜기 및 Activity 실행 보장)
        val pm = context.getSystemService(Context.POWER_SERVICE) as PowerManager
+        @Suppress("DEPRECATION")
        val wakeLock = pm.newWakeLock(
            PowerManager.PARTIAL_WAKE_LOCK or PowerManager.ACQUIRE_CAUSES_WAKEUP,
            "ShiftAlarm::AlarmWakeLock"
@@ -71,6 +79,8 @@ class AlarmReceiver : BroadcastReceiver() {
                context.startService(serviceIntent)
            }

+            Log.d(TAG, "ForegroundService 시작 완료")
+
            // 2. AlarmActivity 직접 실행 (알람 화면 표시)
            val activityIntent = Intent(context, AlarmActivity::class.java).apply {
                putExtra("EXTRA_SHIFT", intent?.getStringExtra("EXTRA_SHIFT") ?: "근무")
@@ -88,8 +98,15 @@ class AlarmReceiver : BroadcastReceiver() {
                addFlags(Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS)
            }
            
+            // 지연 후 Activity 시작 (ForegroundService가 알림을 먼저 표시하도록)
+            android.os.Handler(android.os.Looper.getMainLooper()).postDelayed({
+                try {
                    context.startActivity(activityIntent)
                    Log.d(TAG, "AlarmActivity 실행 완료")
+                } catch (e: Exception) {
+                    Log.e(TAG, "AlarmActivity 실행 실패", e)
+                }
+            }, 500)
            
        } catch (e: Exception) {
            Log.e(TAG, "알람 실행 실패", e)
--- a/app/src/main/java/com/example/shiftalarm/AlarmUtils.kt
+++ b/app/src/main/java/com/example/shiftalarm/AlarmUtils.kt
@@ -137,7 +137,9 @@ private fun cancelAllPendingIntentsForUniqueId(context: Context, uniqueId: Int)
            for (day in 1..31) {
                try {
                    val alarmId = 200000000 + year * 1000000 + month * 10000 + day * 100 + baseId
-                    val intent = Intent(context, AlarmReceiver::class.java)
+                    val intent = Intent(context, AlarmReceiver::class.java).apply {
+                        action = "com.example.shiftalarm.ALARM_TRIGGER"
+                    }
                    val pendingIntent = PendingIntent.getBroadcast(
                        context, alarmId, intent,
                        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
@@ -200,7 +202,9 @@ private fun cancelTestAlarm(context: Context) {

 private fun cancelAlarmInternal(context: Context, alarmId: Int) {
    val alarmManager = context.getSystemService(Context.ALARM_SERVICE) as AlarmManager
-    val intent = Intent(context, AlarmReceiver::class.java)
+    val intent = Intent(context, AlarmReceiver::class.java).apply {
+        action = "com.example.shiftalarm.ALARM_TRIGGER"
+    }
    val pendingIntent = PendingIntent.getBroadcast(
        context, alarmId, intent,
        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
--- a/app/src/main/java/com/example/shiftalarm/AppUpdateManager.kt
+++ b/app/src/main/java/com/example/shiftalarm/AppUpdateManager.kt
@@ -39,14 +39,21 @@ object AppUpdateManager {
                    reader.close()

                    val json = JSONObject(result)
+                    val serverVersionCode = json.getInt("versionCode")
                    val serverVersionName = json.getString("versionName")
                    val apkUrl = json.getString("apkUrl")
                    val changelog = json.optString("changelog", "버그 수정 및 성능 향상")

                    val pInfo = ctx.packageManager.getPackageInfo(ctx.packageName, 0)
+                    val currentVersionCode = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+                        pInfo.longVersionCode.toInt()
+                    } else {
+                        @Suppress("DEPRECATION")
+                        pInfo.versionCode
+                    }
                    val currentVersionName = pInfo.versionName ?: "0.0.0"

-                    if (isNewerVersion(serverVersionName, currentVersionName)) {
+                    if (serverVersionCode > currentVersionCode) {
                        activity.runOnUiThread {
                            showUpdateDialog(activity, serverVersionName, changelog, apkUrl)
                        }
@@ -71,29 +78,6 @@ object AppUpdateManager {
        }.start()
    }

-    private fun isNewerVersion(server: String, current: String): Boolean {
-        try {
-            // Clean version strings (remove non-numeric suffixes if any)
-            val sClean = server.split("-")[0].split(" ")[0]
-            val cClean = current.split("-")[0].split(" ")[0]
-            
-            val sParts = sClean.split(".").map { it.filter { char -> char.isDigit() }.let { p -> if (p.isEmpty()) 0 else p.toInt() } }
-            val cParts = cClean.split(".").map { it.filter { char -> char.isDigit() }.let { p -> if (p.isEmpty()) 0 else p.toInt() } }
-            
-            val length = Math.max(sParts.size, cParts.size)
-            for (i in 0 until length) {
-                val s = if (i < sParts.size) sParts[i] else 0
-                val c = if (i < cParts.size) cParts[i] else 0
-                if (s > c) return true
-                if (s < c) return false
-            }
-        } catch (e: Exception) {
-            android.util.Log.e("AppUpdateManager", "Version comparison failed: ${e.message}")
-            return false
-        }
-        return false
-    }
-
    private fun showUpdateDialog(activity: Activity, version: String, changelog: String, apkUrl: String) {
        com.google.android.material.dialog.MaterialAlertDialogBuilder(activity)
            .setTitle("새로운 업데이트 발견 (v$version)")
--- a/app/src/main/java/com/example/shiftalarm/FragmentSettingsAlarm.kt
+++ b/app/src/main/java/com/example/shiftalarm/FragmentSettingsAlarm.kt
@@ -451,13 +451,18 @@ class FragmentSettingsAlarm : Fragment(), SharedPreferences.OnSharedPreferenceCh
        if (android.os.Build.VERSION.SDK_INT >= 23) {
            timePicker.hour = parts[0].toInt(); timePicker.minute = parts[1].toInt()
        } else {
-            timePicker.currentHour = parts[0].toInt(); timePicker.currentMinute = parts[1].toInt()
+            @Suppress("DEPRECATION")
+            timePicker.currentHour = parts[0].toInt()
+            @Suppress("DEPRECATION")
+            timePicker.currentMinute = parts[1].toInt()
        }

        btnSelectSound.setOnClickListener {
            val intent = Intent(android.media.RingtoneManager.ACTION_RINGTONE_PICKER).apply {
                putExtra(android.media.RingtoneManager.EXTRA_RINGTONE_TYPE, android.media.RingtoneManager.TYPE_ALARM)
                putExtra(android.media.RingtoneManager.EXTRA_RINGTONE_EXISTING_URI, if (currentDialogSoundUri != null) android.net.Uri.parse(currentDialogSoundUri) else null as android.net.Uri?)
+                // 무음 선택 방지: 시스템 알람음만 선택 가능
+                putExtra(android.media.RingtoneManager.EXTRA_RINGTONE_SHOW_SILENT, false)
            }
            startActivityForResult(intent, 100)
        }
@@ -485,7 +490,9 @@ class FragmentSettingsAlarm : Fragment(), SharedPreferences.OnSharedPreferenceCh

        btnCancel.setOnClickListener { dialog.dismiss() }
        btnSave.setOnClickListener {
+            @Suppress("DEPRECATION")
            val h = if (android.os.Build.VERSION.SDK_INT >= 23) timePicker.hour else timePicker.currentHour
+            @Suppress("DEPRECATION")
            val m = if (android.os.Build.VERSION.SDK_INT >= 23) timePicker.minute else timePicker.currentMinute
            val time = String.format("%02d:%02d", h, m)
            
--- a/docs/gitlab-wiki-guide.md
+++ b/docs/gitlab-wiki-guide.md
@@ -0,0 +1,107 @@
+# GitLab Wiki 설정 가이드
+
+## 개요
+
+GitLab Wiki는 저장소와 별도로 관리되며, 마크다운 파일로 작성합니다.
+
+## 시작하기
+
+### 1. Wiki 저장소 클론
+
+```bash
+git clone git@git.webpluss.net:username/project.wiki.git
+cd project.wiki
+```
+
+### 2. 마크다운 파일 작성
+
+```bash
+touch my-page.md
+# 마크다운 작성 후
+git add .
+git commit -m "Add wiki page"
+git push
+```
+
+## SSH 키 설정 (권장)
+
+### 1. SSH 키 생성 (없는 경우)
+
+```bash
+ssh-keygen -t ed25519 -C "your_email@example.com"
+```
+
+### 2. GitLab에 SSH 키 추가
+
+- GitLab → Settings → SSH Keys
+- `~/.ssh/id_ed25519.pub` 내용 복사해서 추가
+
+### 3. remote 설정
+
+```bash
+git remote set-url origin git@git.webpluss.net:username/project.git
+```
+
+## HTTPS 사용 시 (토큰 방식)
+
+### 1. Personal Access Token 생성
+
+- GitLab → Settings → Access Tokens
+- 이름: `git_push`
+- 스코프: `api`
+- 만료일: 적절히 설정
+
+### 2. 토큰으로 푸시
+
+```bash
+git remote set-url origin https://username:TOKEN@git.webpluss.net/username/project.git
+git push -u origin main
+```
+
+### 3. 토큰 숨기기 (보안)
+
+```bash
+# URL에서 토큰 제거
+git remote set-url origin https://username@git.webpluss.net/username/project.git
+
+# credential.helper로 토큰 저장
+git config credential.helper store
+
+# 이후 푸시 시 토큰 자동 입력됨
+git push
+```
+
+## 저장소 내 문서 폴더 방식
+
+Wiki 저장소 접근이 어려운 경우, `docs/` 폴더를 사용할 수 있습니다.
+
+```bash
+mkdir docs
+echo "# 프로젝트 문서" > docs/home.md
+git add docs/
+git commit -m "Add documentation"
+git push
+```
+
+## 마크다운 문법
+
+```markdown
+# 제목
+## 부제목
+
+- 목록 项
+- [링크](url)
+
+**굵게** *기울임*
+
+코드:
+```javascript
+console.log('hello');
+```
+```
+
+## 참고
+
+- GitLab Wiki는 `.md` 파일만 지원
+- 파일명이 페이지 URL이 됨 (home.md → /home)
+- 사이드바는 GitLab이 자동으로 생성
--- a/docs/home.md
+++ b/docs/home.md
@@ -0,0 +1,13 @@
+# ShiftRing 위키에 오신 것을 환영합니다
+
+이곳은 프로젝트 문서를 작성하는 공간입니다.
+
+## 목차
+
+- [시작하기](getting-started)
+- [API 문서](api-reference)
+- [설치 방법](installation)
+
+## 기여하기
+
+문서 수정에 기여하고 싶으시다면 PR을 보내주세요.
--- a/0
+++ b/0
--- a/version.json
+++ b/version.json
@@ -1,7 +1,13 @@
 {
-  "versionCode": 1119,
-  "versionName": "1.1.9",
-  "apkUrl": "https://git.webpluss.net/sanjeok77/ShiftRing/releases/download/v1.1.9/app.apk",
-  "changelog": "v1.1.9: version.json URL 수정 (서버 연결 실패 해결)",
+  "versionCode": 1130,
+  "versionName": "1.3.0",
+  "apkUrl": "https://git.webpluss.net/sanjeok77/ShiftRing/releases/download/v1.3.0/app.apk",
+  "changelog": "v1.3.0: versionCode 기반 업데이트 체크 개선",
+  "forceUpdate": false
+}
+  "versionCode": 1125,
+  "versionName": "1.2.5",
+  "apkUrl": "https://git.webpluss.net/sanjeok77/ShiftRing/releases/download/v1.2.5/app.apk",
+  "changelog": "v1.2.5: 알람 시스템 단순화 - 삭제된 알람 버그 수정",
  "forceUpdate": false
 }
Author	SHA1	Message	Date
sanjeok77	26fb793ab9	feat: v1.3.0 - versionCode 기반 업데이트 체크 - 버전 1.2.5 → 1.3.0 (versionCode 1130) - AppUpdateManager: versionCode로 업데이트 비교 - versionName 비교 로직 제거 - 더 정확한 업데이트 감지 Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-02-28 18:50:55 +09:00
sanjeok77	597880e807	fix: build.gradle 버전 1.2.5로 업데이트 - versionCode: 1124 → 1125 - versionName: 1.2.4 → 1.2.5 - 무한 업데이트 버그 수정 Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-02-28 18:43:29 +09:00
sanjeok77	6fb83848f5	docs: Gitea 릴리즈 작업 가이드 추가 - 릴리즈 생성 절차 문서화 - API 엔드포인트 및 예시 명령어 정리 - 버전 업데이트 체크리스트 포함 - 인증 정보 및 주의사항 기록 Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-02-28 18:37:32 +09:00
sanjeok77	fef630d266	chore: 버전 업데이트 v1.2.5 - versionCode: 1124 → 1125 - versionName: 1.2.4 → 1.2.5 - changelog 업데이트 Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-02-28 18:26:08 +09:00
sanjeok77-tech	fdcbb615ab	v1.2.4: Deprecation 경고 수정 및 삭제 알람 버그 수정	2026-02-23 12:48:37 +09:00
sanjeok77-tech	161cc8060d	v1.2.3: Delete alarm bug fix - version update	2026-02-23 12:31:51 +09:00
sanjeok77-tech	6c2dec6cd3	Fix: AlarmManager cancel - add action to Intent for proper alarm cancellation - Add action to cancelAlarmInternal - Add action to cancelAllPendingIntentsForUniqueId - Fix deleted alarms still ringing (주, 석, 야, 기타) - Bump version to v1.2.2	2026-02-23 12:19:29 +09:00
sanjeok77-tech	fa4c50a054	v1.2.1: 내부 버전 매칭 수정	2026-02-23 09:05:55 +09:00
sanjeok77-tech	707d81d850	v1.2.0: 버전 코드 업데이트	2026-02-23 08:55:16 +09:00
sanjeok77-tech	4d8861d79c	v1.2.0: 알람 버그 수정	2026-02-23 08:42:37 +09:00
sanjeok77-tech	b60aa517b9	Add GitLab Wiki guide	2026-02-22 14:30:22 +09:00
sanjeok77-tech	357788adb9	Add wiki documentation	2026-02-22 14:10:38 +09:00
sanjeok77-tech	a17eee8884	README: 배지에 릴리즈 페이지 링크 추가	2026-02-22 13:37:39 +09:00
sanjeok77-tech	f4f5599117	Release v1.1.9 - APK 업로드 가이드 추가	2026-02-22 13:33:01 +09:00