v1.0.0

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,7 @@
+## Situation
+
+## Task
+
+## Action
+
+## Result

.github/workflows/code-review.yml

@@ -0,0 +1,48 @@
+name: Claude Code Review
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+
+jobs:
+  claude-review:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude'))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: anthropics/claude-code-action@beta
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          model: "claude-sonnet-4-6"
+          custom_instructions: |
+            당신은 iOS/Swift 전문 코드 리뷰어입니다. 한국어로 리뷰를 작성하세요.
+
+            ## 리뷰 기준
+            - 잠재적 버그 및 로직 오류
+            - 성능 이슈 (불필요한 연산, 메모리 누수, 비효율적인 데이터 처리 등)
+            - Swift/iOS 안티패턴
+            - SwiftData, Vision Framework 등 프레임워크 오용
+
+            ## Pn 룰 적용
+            모든 리뷰 코멘트에 아래 우선순위를 명시하세요.
+            - P1: 반드시 수정 필요 (버그, 크래시 가능성)
+            - P2: 적극적으로 수정 권장
+            - P3: 웬만하면 반영 권장
+            - P4: 반영해도 좋고 넘어가도 좋음
+            - P5: 사소한 의견
+
+            ## 형식
+            각 코멘트를 `[P1]`, `[P2]` 등으로 시작하고, 이유와 개선 방법을 함께 작성하세요.
+            해결 방법이 여러 개인 경우, 각 방법을 간단히 나열하고 장단점을 요약한 뒤 추천 방법을 명시하세요.
+            코드를 직접 수정하거나 커밋하지 말고, 제안만 간단하게 작성하세요.
+            코드 제안 시 함수나 의미있는 블록 단위로 코드 블록을 제공하세요.

.github/workflows/ios-ci.yml

@@ -0,0 +1,73 @@
+name: iOS CI
+
+on:
+  push:
+    branches: [ main, dev ]
+  pull_request:
+    branches: [ main, dev ]
+
+jobs:
+  build-and-test:
+    name: Build and Test
+    runs-on: macos-latest
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+
+    - name: Set up Xcode
+      uses: maxim-lobanov/setup-xcode@v1
+      with:
+        xcode-version: latest-stable
+
+    - name: Show Xcode version
+      run: xcodebuild -version
+
+    - name: Find latest iOS Simulator
+      id: find-simulator
+      run: |
+        ALL_DEVICES=$(xcrun simctl list devices available | grep "iPhone")
+
+        NUMBERED_IPHONES=$(echo "$ALL_DEVICES" | grep -E "iPhone [0-9]+" | sed -E 's/.*iPhone ([0-9]+).*/\1/' | sort -n -u)
+        LATEST_NUMBER=$(echo "$NUMBERED_IPHONES" | tail -1)
+
+        echo "최신 iPhone 버전: $LATEST_NUMBER"
+
+        SIMULATOR_ID=""
+        for MODEL in "iPhone $LATEST_NUMBER Pro Max" "iPhone $LATEST_NUMBER Pro" "iPhone $LATEST_NUMBER Plus" "iPhone $LATEST_NUMBER"; do
+          FOUND=$(echo "$ALL_DEVICES" | grep "$MODEL" | tail -1)
+          if [ -n "$FOUND" ]; then
+            SIMULATOR_ID=$(echo "$FOUND" | grep -oE '[A-F0-9]{8}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{12}')
+            SIMULATOR_NAME=$(echo "$FOUND" | sed -E 's/^[[:space:]]*([^(]+).*/\1/' | xargs)
+            echo "simulator_id=$SIMULATOR_ID" >> $GITHUB_OUTPUT
+            echo "simulator_name=$SIMULATOR_NAME" >> $GITHUB_OUTPUT
+            echo "선택된 시뮬레이터: $SIMULATOR_NAME ($SIMULATOR_ID)"
+            break
+          fi
+        done
+
+        if [ -z "$SIMULATOR_ID" ]; then
+          echo "사용 가능한 iPhone 시뮬레이터를 찾을 수 없습니다."
+          xcrun simctl list devices available
+          exit 1
+        fi
+
+    - name: Build SpendLearning
+      run: |
+        cd SpendLearning
+        xcodebuild clean build \
+          -project SpendLearning.xcodeproj \
+          -scheme SpendLearning \
+          -destination "platform=iOS Simulator,id=${{ steps.find-simulator.outputs.simulator_id }}" \
+          CODE_SIGNING_ALLOWED=NO \
+          CODE_SIGNING_REQUIRED=NO
+
+    - name: Test SpendLearning
+      run: |
+        cd SpendLearning
+        xcodebuild test \
+          -project SpendLearning.xcodeproj \
+          -scheme SpendLearning \
+          -destination "platform=iOS Simulator,id=${{ steps.find-simulator.outputs.simulator_id }}" \
+          CODE_SIGNING_ALLOWED=NO \
+          CODE_SIGNING_REQUIRED=NO \

.gitignore

@@ -1,62 +1,110 @@
+# Created by https://www.toptal.com/developers/gitignore/api/swift,xcode,macos
+# Edit at https://www.toptal.com/developers/gitignore?templates=swift,xcode,macos
+### macOS ###
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+# Icon must end with two \r
+Icon
+# Thumbnails
+._*
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+### macOS Patch ###
+# iCloud generated files
+*.icloud
+### Swift ###
 # Xcode
 #
 # gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore
-
 ## User settings
+*.xcuserstate
+*.xcuserdatad
 xcuserdata/
-
+## compatibility with Xcode 8 and earlier (ignoring not required starting Xcode 9)
+*.xcscmblueprint
+*.xccheckout
+## compatibility with Xcode 3 and earlier (ignoring not required starting Xcode 4)
+build/
+DerivedData/
+*.moved-aside
+*.pbxuser
+!default.pbxuser
+*.mode1v3
+!default.mode1v3
+*.mode2v3
+!default.mode2v3
+*.perspectivev3
+!default.perspectivev3
 ## Obj-C/Swift specific
 *.hmap
-
 ## App packaging
 *.ipa
 *.dSYM.zip
 *.dSYM
-
 ## Playgrounds
 timeline.xctimeline
 playground.xcworkspace
-
 # Swift Package Manager
-#
 # Add this line if you want to avoid checking in source code from Swift Package Manager dependencies.
 # Packages/
 # Package.pins
 # Package.resolved
 # *.xcodeproj
-#
 # Xcode automatically generates this directory with a .xcworkspacedata file and xcuserdata
 # hence it is not needed unless you have added a package configuration file to your project
 # .swiftpm
-
 .build/
-
 # CocoaPods
-#
 # We recommend against adding the Pods directory to your .gitignore. However
 # you should judge for yourself, the pros and cons are mentioned at:
 # https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
-#
 # Pods/
-#
 # Add this line if you want to avoid checking in source code from the Xcode workspace
 # *.xcworkspace
-
 # Carthage
-#
 # Add this line if you want to avoid checking in source code from Carthage dependencies.
 # Carthage/Checkouts
-
 Carthage/Build/
-
+# Accio dependency management
+Dependencies/
+.accio/
 # fastlane
-#
 # It is recommended to not store the screenshots in the git repo.
 # Instead, use fastlane to re-generate the screenshots whenever they are needed.
 # For more information about the recommended setup visit:
 # https://docs.fastlane.tools/best-practices/source-control/#source-control
-
 fastlane/report.xml
 fastlane/Preview.html
 fastlane/screenshots/**/*.png
 fastlane/test_output
+# Code Injection
+# After new code Injection tools there’s a generated folder /iOSInjectionProject
+# https://github.com/johnno1962/injectionforxcode
+iOSInjectionProject/
+### Xcode ###
+## Xcode 8 and earlier
+### Xcode Patch ###
+*.xcodeproj/*
+!*.xcodeproj/project.pbxproj
+!*.xcodeproj/xcshareddata/
+!*.xcodeproj/project.xcworkspace/
+!*.xcworkspace/contents.xcworkspacedata
+/*.gcno
+**/xcshareddata/WorkspaceSettings.xcsettings
+
+# End of https://www.toptal.com/developers/gitignore/api/swift,xcode,macos
+

README.md

@@ -1,2 +1,38 @@
 # SpendLearning
-소비학습 - 돈을 쓸 때마다 똑똑해지는, 나를 위한 지출 전용 머신러닝 가계부
+
+소비 전용 가계부 앱. 지출만 기록하고, 소비 패턴을 학습해 피드백을 제공한다.
+
+---
+
+## 주요 기능
+
+### 소비 기록
+- 달력 화면에서 날짜 선택 후 소비 기록
+- 금액, 카테고리, 메모(선택) 입력
+- 최근 기록 빠른 입력 지원
+
+### 통계
+- 카테고리별 비율 (원그래프)
+- 이번 달 / 이번 년도 / 저번 년도 전환 가능
+- 이번 달·년도는 직전 기간 대비 증감 표시
+
+### AI 피드백
+- 소비 패턴을 학습해 피드백 제공
+  - 카테고리 이상 지출 감지
+  - 고정 지출 패턴 알림
+  - 절약 성공 칭찬
+  - 이번 달 소비 예측
+- 메인 화면 상단 카드 + 푸시 알림으로 노출
+
+### 토스 캡쳐 자동 기록
+- 토스 거래내역 캡쳐 후 앱에서 불러오면 OCR로 자동 파싱
+- 내용 확인 및 카테고리 선택 후 기록 완료
+
+### 카테고리
+- 기본 제공: 식비, 카페/디저트, 교통, 쇼핑, 구독, 의료/건강, 여가/문화, 기타
+- 사용자 커스텀 추가 가능
+
+### 기타
+- iCloud 백업/복원
+- 소비 기록 수정/삭제
+- 첫 실행 온보딩 (카테고리 설정, 토스 캡쳐 기능 안내)