🐛 [Fix] Watch 공유 Keychain Access Group entitlement 복구 (#1213)

[JEONG-J]

🔗 관련 이슈

Closes #1213

✨ PR 유형

🐛 버그 수정 — #1147 번들 ID 정렬 과정에서 유실된 공유 Keychain Access Group entitlement 복구

📷 스크린샷 or 영상(UI 변경 시)

해당 없음

🛠️ 작업내용

PR #627(744ad80b)이 넣었던 공유 Keychain Access Group entitlement 를 #1147(a68f93c2)이 "미사용" 사유로 iOS·watch 양쪽에서 제거했습니다(워치 entitlements 는 파일째 삭제, Project.swift 의 entitlements: 인자도 함께 사라짐). 현행 번들 ID 체계 기준으로 복구합니다.

• UMCApp/UMCApp.entitlements — keychain-access-groups 추가
  • 첫 항목 $(AppIdentifierPrefix)com.umc.product.shared(공유 그룹), 둘째 항목 $(AppIdentifierPrefix)com.umc.product(기본 그룹)
  • 기존 키 5개는 무변경
• UMCApp/UMCWatchApp/UMCWatchApp.entitlements — 신규 생성
  • 첫 항목 $(AppIdentifierPrefix)com.umc.product.shared, 둘째 항목 $(AppIdentifierPrefix)com.umc.product.watchkitapp
• UMCApp/UMCWatchApp/Project.swift — watchAppProject(entitlements: .file(path: "UMCWatchApp.entitlements")) 배선
  • 파일만 만들고 인자를 안 넘기면 무효라 이 한 줄이 핵심입니다
• UMCApp/Core/Network/Sources/Auth/KeychainTokenStore.swift — access group 동작을 설명하는 문서 주석만 추가, 로직 무변경
• docs/claude/build-and-modules.md — 「공유 Keychain Access Group」 소절 추가 (세 번째 유실 방지용 규약 문서화)

검증

• tuist install + tuist generate 성공
• 생성된 UMCWatchApp.xcodeproj/project.pbxproj 에 CODE_SIGN_ENTITLEMENTS = UMCWatchApp.entitlements (Debug/Release 양쪽) 확인
• cd UMCApp && make test → TEST SUCCEEDED (32 tests / 5 suites, iPhone 17 Pro 시뮬레이터)
• plutil -lint 두 entitlements 모두 통과

📋 추후 진행 상황

• 워치 단독 API 호출은 이 PR 로 동작하지 않습니다. Apple Watch 는 자체 keychain 을 가진 별개 기기라, access group 을 맞춰도 워치가 iPhone 의 keychain 항목을 읽을 수 없습니다. access group 은 동일 기기 내 동일 팀 서명 타겟 간 공유 메커니즘입니다. 이슈 완료 조건 중 "실제 페어링 기기에서 워치가 iPhone 저장 토큰을 읽어오는지 검증"은 이 경로로는 성립하지 않습니다.
• 실제 토큰 전달 경로는 WatchConnectivity 로 iPhone→Watch 전송 후 워치 자체 keychain 에 저장하는 것입니다 (♻️ Refactor: WatchConnectivity 도메인 페이로드 계약 정의 + 양방향 수신 경로 구현 #1210 페이로드 계약 / 🐛 Bug: iOS 앱에 WCSession 미배선 — CoreWatchConnectivity 링크·DI 등록·activate() 호출 없음 #1211 WCSession 배선).
• 그 전제로 TokenStore·KeychainTokenStore 의 멀티플랫폼 모듈 추출이 필요합니다. 현재 CoreNetwork 는 KakaoSDK(iOS 13+ 전용)·GoogleSignIn(macOS/iOS 전용)에 의존해 watchOS 빌드가 불가능하므로, 소셜 로그인 SDK 없는 별도 모듈로 떼어내야 합니다 → 🍀 ETC: WatchConnectivity 테스트 타겟 + CI watchOS 빌드 검증 추가 #1216 범위.
• 사람이 해야 할 일: Apple Developer 포털에서 App ID com.umc.product · com.umc.product.watchkitapp 두 개에 Keychain Sharing capability 와 com.umc.product.shared 그룹 등록. 미등록이면 실기기/아카이브 서명이 실패하고 런타임 증상은 SecItemAdd 의 errSecMissingEntitlement(-34018) 입니다. 시뮬레이터 빌드·테스트는 영향 없습니다.

📌 리뷰 포인트

• 그룹 식별자 확정: 현행 번들 ID 체계(com.umc.product / .watchkitapp / group.com.umc.product.widget)에 맞춰 $(AppIdentifierPrefix)com.umc.product.shared 로 정했습니다. 팀 ID 를 문자열로 박지 않고 레포 관례대로 $(AppIdentifierPrefix) 를 사용합니다.
• 배열 순서가 계약입니다. kSecAttrAccessGroup 미지정 SecItemAdd 는 배열 첫 항목에 저장하므로, 공유 그룹을 첫 번째에 두면 Swift 쪽에 팀 프리픽스 문자열을 만들지 않고도 토큰이 공유 그룹으로 갑니다. KeychainTokenStore 가 access group 을 지정하지 않으므로 로직 변경이 필요 없었습니다.
• 둘째 항목은 안전장치입니다. 검색·삭제 쿼리는 access group 미지정 시 앱이 가진 모든 그룹을 훑으므로, 기존 배포판이 기본 그룹에 저장한 토큰이 계속 읽힙니다 → 업데이트 시 강제 로그아웃 없음. 이 줄을 빼면 전 사용자 재로그인입니다.

✅ Checklist

PR이 다음 요구 사항을 충족하는지 확인해주세요!!!

• 커밋 메시지 컨벤션에 맞게 작성했습니다
  • 해당 링크 : 깃 모지 컨벤션
• 유지-보수를 위해 주석처리를 잘 작성하였는가?
  • 해당 링크 : Xcode 주석 정리