Merge branch 'develop' into release-server

Author: zie-ning

.claude/CLAUDE.md

@@ -0,0 +1,54 @@
+# 모노레포 가이드라인 (루트)
+
+## 구성
+
+이 저장소는 "길벗" 서비스의 `android/`(Kotlin/Compose 앱)와 `backend/`(Spring Boot API)를
+함께 담은 모노레포다. 각 모듈은 자체 `.claude/CLAUDE.md`를 갖고 있어(`android/.claude/CLAUDE.md`,
+`backend/.claude/CLAUDE.md`) 해당 디렉터리 아래에서 작업할 때 자동으로 함께 적용된다.
+
+## Claude Code 세션 실행 관행
+
+Claude Code 세션은 **항상 저장소 루트**(`2026-capstone-26/`)에서 실행한다. Claude Code가
+`backend/.claude/`, `android/.claude/`를 하위 디렉터리 스코프로 자동 인식하므로, 모듈별로
+세션을 나눌 필요가 없다 — `backend/` 파일을 다룰 때는 `backend/.claude/CLAUDE.md`와
+`backend/.claude/rules/`, `backend/.claude/skills/`가, `android/` 파일을 다룰 때는
+`android/.claude/CLAUDE.md`가 자동으로 함께 적용된다. 두 모듈을 넘나드는 작업(예: API 스펙
+변경이 앱에 미치는 영향 확인)도 한 세션에서 처리할 수 있다.
+
+## 커밋 정책 (필수)
+
+**사용자가 명시적으로 커밋하라고 지시하기 전까지는 절대 `git commit`(및 `git push`)을 실행하지
+않는다.** 코드/문서/설정 변경을 완료했더라도, 그 자체가 커밋 승인을 의미하지 않는다. Plan
+Mode에서 계획에 커밋 단계가 포함되어 사용자가 그 계획을 승인한 경우는 예외적으로 해당
+커밋들에 한해 명시적 지시로 간주하되, 그 외의 모든 상황에서는 변경 후 반드시 커밋 여부를
+먼저 물어보거나 사용자의 명령을 기다린다. `android/`, `backend/` 모두 동일하게 적용된다.
+
+## 공용 Git & GitHub 규칙
+
+`android/`, `backend/` 모두에 적용되는 공용 규칙은 이 디렉터리(`.claude/rules/`)에 둔다.
+모듈 전용 규칙(예: backend의 RDS 접속 절차)은 각 모듈의 `.claude/rules/`에 남아 있다.
+
+- 커밋 메시지 형식·브랜치 명명: [git-commit.md](rules/git-commit.md)
+- 이슈 작성 구조: [github-issue.md](rules/github-issue.md)
+- PR 작성 구조: [github-pr.md](rules/github-pr.md)
+
+### 모듈별 라벨
+
+이슈/PR을 만들 때 작업 대상 모듈에 따라 라벨을 다르게 붙인다.
+
+| 작업 대상      | 라벨      |
+|------------|---------|
+| `backend/` | `💻BE`  |
+| `android/` | `📱AND` |
+
+## GitHub 템플릿
+
+`.github/ISSUE_TEMPLATE/이슈-템플릿.md`, `.github/pull_request_template.md`가
+`android/`, `backend/` 공용 템플릿이다. GitHub은 저장소 루트의 `.github/`만 인식하므로,
+모듈별로 별도 템플릿을 두지 않는다.
+
+## 포트폴리오 관점 제안
+
+- 이 저장소는 개발자 취업을 위한 포트폴리오로 사용됩니다.
+- 작업 중 단순 구현을 넘어 포트폴리오에서 어필 가능한 개선점(테스트/CI 강화, 코드 품질 자동화, 아키텍처 개선, 성능 개선 사항, 트러플 슈팅, 기술적 의사결정 포인트 등)
+  을 발견하면 코드를 임의로 고치지 말고 최종 응답에서 제안합니다.

backend/.claude/rules/git-commit.md .claude/rules/git-commit.mdbackend/.claude/rules/git-commit.md renamed to .claude/rules/git-commit.md

@@ -26,7 +26,7 @@
 ## 커밋 메시지 형식
 
 ```
-<type> #<이슈번호>: <한국어 설명>
+<type> : <한국어 설명>
 ```
 
 작업이 특정 이슈에 연결되지 않는 경우에만 이슈 번호를 생략한다.
@@ -40,18 +40,23 @@
   추가한다. [중요]대부분의 커밋은 제목 한 줄로 끝난다.
 - 이슈/커밋 관련 CLAUDE.md 공통 규칙(예외 메시지·로그·테스트 메서드명은 한국어)도 함께 지킨다.
 
-## 브랜치 명명
+## 프로세스
 
-```
-<type>/#<이슈번호>-<slug>
-```
+1. 스테이지된 파일 확인, 스테이지된 파일이 있으면 해당 파일만 커밋
+2. 여러 논리적 변경사항에 대한 diff 분석
+3. 필요시 분할 제안
 
-이슈 번호가 없는 작업(문서 정리, 잡일성 chore 등)은 이슈 번호를 생략한다.
+## 브랜치 명명
 
 ```
 <type>/<slug>
 ```
 
-예시: `feat/#38-weekly`, `fix/#4-place-search`, `docs/readme`, `chore/gitignore`.
-
+예시: `docs/readme`, `chore/gitignore`.
 `slug`는 영어 kebab-case로, 무엇을 하는 브랜치인지 간단히 드러나게 짓는다.
+
+## 참고사항
+
+- 스테이지된 파일이 있으면 해당 파일만 커밋
+- 분할 제안을 위한 diff 분석
+- **커밋에 Claude 서명 절대 추가하지 않음**

backend/.claude/rules/github-issue.md .claude/rules/github-issue.mdbackend/.claude/rules/github-issue.md renamed to .claude/rules/github-issue.md

@@ -1,9 +1,10 @@
 # 이슈 작성 규칙
 
 이 저장소(모노레포 루트 `2026-capstone-26`)의 `.github/ISSUE_TEMPLATE/이슈-템플릿.md`가
-실제 이슈 템플릿이다. `backend/`는 이 루트 저장소의 하위 디렉터리이므로 GitHub이 이 템플릿을
-그대로 적용한다. `.github/ISSUE_TEMPLATE/config.yml`에서 `blank_issues_enabled: false`로
-설정되어 있어, 템플릿 없이 빈 이슈를 만드는 것 자체가 막혀 있다.
+`backend/`, `android/` 작업 공용 이슈 템플릿이다. GitHub은 저장소 루트의 `.github/`만
+인식하므로, `backend/`나 `android/` 어느 쪽에서 작업하든 이 루트 템플릿이 그대로 적용된다.
+`.github/ISSUE_TEMPLATE/config.yml`에서 `blank_issues_enabled: false`로 설정되어 있어,
+템플릿 없이 빈 이슈를 만드는 것 자체가 막혀 있다.
 
 ## 제목 형식
 
@@ -20,8 +21,13 @@
 
 ## 라벨
 
-`backend/` 작업으로 만드는 이슈에는 항상 `💻BE` 라벨을 붙인다. 템플릿의 `labels: ''`는
-기본값이 없다는 뜻이므로, `gh issue create --label "💻BE"`처럼 직접 지정해야 한다.
+작업 대상 모듈에 따라 라벨을 다르게 붙인다.
+
+- `backend/` 아래 작업으로 만드는 이슈 → 항상 `💻BE` 라벨
+- `android/` 아래 작업으로 만드는 이슈 → 항상 `📱AND` 라벨
+
+템플릿의 `labels: ''`는 기본값이 없다는 뜻이므로, `gh issue create --label "💻BE"` /
+`gh issue create --label "📱AND"`처럼 직접 지정해야 한다.
 
 ## 본문 구조 (실제 템플릿)
 
@@ -48,3 +54,15 @@
 이슈를 새로 만들면 GitHub이 부여한 번호를 이후 커밋/브랜치/PR에서 일관되게 사용한다.
 자세한 커밋·브랜치 형식은 [git-commit.md](git-commit.md), PR에서 이슈를 닫는 방법은
 [github-pr.md](github-pr.md) 참고.
+
+## 초안 작성 워크플로우
+
+사용자가 이슈 작성을 요청하면:
+
+- 이슈 본문 마크다운 전체를 대화창에 그대로 출력하지 않는다. 스크래치패드(세션의 임시 파일
+  디렉터리)에 `.md` 파일로 작성하고, 그 파일 경로만 짧게 안내한다.
+- 사용자가 그 파일을 직접 열어 수정할 수 있다는 전제로 대기한다.
+- "올려줘"/"게시해줘"처럼 명시적으로 게시를 지시받으면, 그 시점에 파일을 다시 읽어(사용자가
+  수정했을 수 있으므로 항상 최신 내용을 반영) `gh issue create --body-file <경로>`로 그대로
+  게시한다. 이미 알고 있는 이전 버전 내용을 임의로 다시 쓰지 않는다.
+- 명시적 게시 지시 전까지는 `gh issue create`를 절대 실행하지 않는다.

.claude/rules/github-pr.md

@@ -0,0 +1,63 @@
+# PR 작성 규칙
+
+이 저장소(모노레포 루트 `2026-capstone-26`)의 `.github/pull_request_template.md`가
+`backend/`, `android/` 작업 공용 PR 템플릿이다. GitHub은 저장소 루트의 `.github/`만
+인식하므로, `backend/`나 `android/` 어느 쪽에서 작업하든 이 루트 템플릿이 자동으로 채워진다.
+
+## 병합 방식
+
+기존 관례(일반 merge, squash 아님)를 유지한다. 커밋 이력을 보존하는 방식이므로,
+PR에 올라가는 개별 커밋 메시지도 [git-commit.md](git-commit.md) 형식을 지켜야
+merge 후 로그가 지저분해지지 않는다.
+
+## 라벨
+
+작업 대상 모듈에 따라 라벨을 다르게 붙인다.
+
+- `backend/` 아래 작업으로 만드는 PR → 항상 `💻BE` 라벨
+- `android/` 아래 작업으로 만드는 PR → 항상 `📱AND` 라벨
+
+PR 템플릿은 프론트매터가 없어 라벨을 지정할 방법이 없으므로, `gh pr create --label "💻BE"` /
+`gh pr create --label "📱AND"`처럼 직접 지정해야 한다.
+
+## 제목 형식
+
+```
+<type> : <한국어 요약>
+```
+
+## 본문 구조 (실제 템플릿)
+
+```markdown
+## 🛰️ Issue Number
+
+## 🪐 작업 내용
+
+## 📚 추가 리팩토링 가능성
+```
+
+- **Issue Number**: 관련 이슈 번호(`#<번호>`)를 적는다. 템플릿 자체는 GitHub의 자동 종료
+  키워드를 쓰지 않으므로, PR 병합과 동시에 이슈를 자동으로 닫고 싶으면 `closes #<번호>`처럼
+  종료 키워드를 명시적으로 함께 적어야 한다. 이슈와 무관한 PR(잡일성 chore 등)이면 비워둔다.
+- **작업 내용**: 무엇을 왜 바꿨는지, 리뷰어가 알아야 할 설계/구현 포인트를 bullet로 정리한다.
+- **추가 리팩토링 가능성**: 이번 PR 범위 밖이지만 발견한 개선점을 남긴다. `backend/`
+  작업이라면 `backend/.claude/CLAUDE.md`의 "포트폴리오 관점 제안" 규칙과 같은 맥락 —
+  임의로 고치지 말고 여기에 적어 다음 작업으로 넘긴다.
+
+## 작성 톤 & 가독성
+
+- "작업 내용"이 길어지면 한 덩어리로 쓰지 말고 `###` 하위 섹션(예: `### 배경`, `### 변경 사항`,
+  `### 테스트`)이나 `-` bullet으로 쪼갠다. 리뷰어가 스크롤 없이 훑을 수 있는 길이를 기준으로
+  삼는다.
+
+## 초안 작성 워크플로우
+
+사용자가 pr 작성을 요청하면:
+
+- PR 본문 마크다운 전체를 대화창에 그대로 출력하지 않는다. 스크래치패드(세션의 임시 파일
+  디렉터리)에 `.md` 파일로 작성하고, 그 파일 경로만 짧게 안내한다.
+- 사용자가 그 파일을 직접 열어 수정할 수 있다는 전제로 대기한다.
+- "올려줘"/"게시해줘"처럼 명시적으로 게시를 지시받으면, 그 시점에 파일을 다시 읽어(사용자가
+  수정했을 수 있으므로 항상 최신 내용을 반영) `gh pr create --body-file <경로>`로 그대로
+  게시한다. 이미 알고 있는 이전 버전 내용을 임의로 다시 쓰지 않는다.
+- 명시적 게시 지시 전까지는 `gh pr create`를 절대 실행하지 않는다.

backend/.claude/settings.json .claude/settings.jsonbackend/.claude/settings.json renamed to .claude/settings.json

@@ -1,13 +1,11 @@
 {
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
   "plansDirectory": "./.claude/plans/",
   "outputStyle": "Explanatory",
   "permissions": {
     "defaultMode": "plan",
-    "additionalDirectories": [
-      "../"
-    ],
     "deny": [
-      "Read(./.env.local)"
+      "Read(./backend/.env.local)"
     ]
   }
-}
+}

.gitignore

@@ -24,6 +24,12 @@ AGENTS.md
 agents.md
 .codex/
 
+# Claude
+.claude/settings.local.json
+.claude/plans
+
+/reference
+
 # =========================
 # Android module (root-level safety)
 # =========================
@@ -54,21 +60,23 @@ android/**/*.dex
 # =========================
 
 backend/.env.local
+backend/local.properties
 backend/build/
 backend/out/
 backend/target/
 backend/node_modules/
 backend/AGENTS.md
-backend/.claude/plans
 backend/.claude/rules/*.local.md
-backend/.claude/settings.local.json
+backend/.claude/plans/
 backend/.gradle
 backend/build
 backend/out
 backend/gilbut-firebase-adminsdk.json
+backend/docs/resume
+backend/.claude/skills/resume-bullet
+backend/.claude/skills/portfolio-ppt
 # test data
 /backend/src/test/resources/test-data
+/backend/portfolio
 # Keep placeholder
-!backend/.gitkeep
-
-/reference
+!backend/.gitkeep

README.md

@@ -67,7 +67,7 @@
 
 <div align="center">
 
-![img.png](docs/images/img_6.png)
+![img.png](docs/images/서비스 아키텍처.png)
 </div>
 
 <br>

android/.claude/CLAUDE.md

@@ -0,0 +1,42 @@
+# 저장소 가이드라인
+
+## 목적
+
+이 파일은 `android/`에서 작업하는 기여자와 코딩 에이전트를 위한 로컬 작업 규칙을 정의합니다.
+
+## 프로젝트 개요
+
+"길벗"은 위치 데이터를 수집해 사용자에게는 기억 보조를, 보호자에게는 안심 확인을 제공하는 서비스입니다.
+이동 경로 기록/조회, 15분 이상 체류한 장소 자동 저장, 외출·귀가 시각 기록, 개인 메모, 보호자의 실시간 위치 확인과 요약 통계 조회가 핵심 기능입니다.
+이 앱(API 24+)은 `backend/`의 Spring Boot 백엔드와 통신하며 Kakao/Google 지도 API를 연동합니다.
+
+## 기술 스택
+
+- Kotlin + Jetpack Compose(`kotlin.compose` 플러그인), KSP
+- minSdk 24 / compileSdk·targetSdk 36, JVM 17
+- Kakao OAuth(`kakao.nativeAppKey`) 로그인, Google Maps API 연동
+- 시크릿(`kakao.nativeAppKey`, `app.baseUrl`, `google.mapsApiKey`)은 `local.properties`로 관리(커밋 금지)
+
+## 코드/UI 규칙
+
+상세 네이밍(Route/Screen/ViewModel/UiState/Effect), 문자열 규칙(하드코딩 금지, `stringResource`,
+UI 카피 한국어 우선), UI State 패턴(`AsyncUiState<T>`), 기능 폴더 구조는
+[DEVELOPMENT_GUIDELINES.md](../DEVELOPMENT_GUIDELINES.md)를 참고합니다.
+
+라우트/장소/카메라/권한/daynote 저장 정책 등 앱 사이드 정책의 단일 소스는
+[docs/global-policy.md](../docs/global-policy.md)입니다.
+
+## Git & GitHub Workflow
+
+`backend/`와 공용으로 쓰는 규칙이라 저장소 루트 `.claude/rules/`에 있습니다.
+
+- 커밋 메시지 형식과 브랜치 명명 규칙: [../../.claude/rules/git-commit.md](../../.claude/rules/git-commit.md) 참고.
+- 이슈 작성 구조: [../../.claude/rules/github-issue.md](../../.claude/rules/github-issue.md) 참고.
+- PR 작성 구조: [../../.claude/rules/github-pr.md](../../.claude/rules/github-pr.md) 참고. android 작업 이슈/PR 라벨은 `📱AND`.
+
+## 작업 스타일
+
+- 편집하기 전에 관련 코드와 컨텍스트를 조사합니다.
+- 새로운 추상화를 도입하기 전에 기존 패턴(Route/Screen/ViewModel/UiState)을 재사용합니다.
+- 커밋 정책(사용자가 명시적으로 지시하기 전까지 절대 커밋/푸시하지 않음)은
+  [../../.claude/CLAUDE.md](../../.claude/CLAUDE.md)의 "커밋 정책" 참고.