diff --git a/docs/20260331_하드코딩텍스트_I18n통일계획.md b/docs/20260331_하드코딩텍스트_I18n통일계획.md new file mode 100644 index 0000000..d4fa0d5 --- /dev/null +++ b/docs/20260331_하드코딩텍스트_I18n통일계획.md @@ -0,0 +1,538 @@ +# 20260331 하드코딩 텍스트 I18n.swift 통일 계획 + +## 작업 체크리스트 +- [x] 코드베이스 하드코딩 문구 탐색 전략 수립 (병렬 탐색 + 정적 검색) +- [x] `I18n.swift`와 `Localizable.xcstrings` 혼재 지점 식별 +- [x] 하드코딩 문구 변경 대상 파일 인벤토리 산출 및 문서화 +- [ ] 1차 전환: SwiftUI/View 레이어 하드코딩 문구를 `I18n.*` 참조로 교체 +- [ ] 2차 전환: ViewModel/Manager/Repository 레이어의 사용자 노출 문구를 `I18n.*`로 이관 +- [ ] 3차 정리: `Localizable.xcstrings` 의존 경로 제거 및 회귀 점검 +- [ ] 최종 검증: 빌드/테스트/수동 QA 완료 후 체크리스트 마감 + +## 커밋 전략 (권장) +- **권장 방식: 모듈별 커밋** (일괄 커밋 비권장) +- 이유: + - 변경량이 커서(현재 대상 330개) 일괄 커밋 시 리뷰/롤백/원인추적 비용이 급증함. + - 모듈별 커밋은 회귀가 발생해도 영향 범위를 모듈 단위로 제한할 수 있음. + - 충돌 해결 시에도 모듈 경계가 명확해 병합 리스크가 낮아짐. +- 권장 순서: + 1. 공통 선행 커밋: `I18n.swift` 공통 키/네임스페이스 토대 정리 + 2. 모듈별 커밋: 각 모듈의 키 추가 + 호출부 교체 + 모듈 단위 검증 + 3. 마무리 커밋: `Localizable.xcstrings` 의존 제거/정리 및 최종 검증 결과 반영 + +## 수용 기준 (Acceptance Criteria) +- [ ] 사용자에게 노출되는 하드코딩 문자열이 `SodaLive/Sources/**`에 남아있지 않다. +- [ ] 신규/기존 UI 문구 접근이 `I18n.swift` 네임스페이스를 통해 일관되게 이루어진다. +- [ ] `Localizable.xcstrings` 기반 직접 참조(`LocalizedStringKey`/`String(localized:)`/`NSLocalizedString`)가 제거되거나 예외 사유가 문서화된다. +- [ ] 문자열 치환 후 `SodaLive`, `SodaLive-dev` Debug 빌드가 성공한다. +- [ ] 테스트 가능 범위(스킴 제약 감안)와 주요 화면 수동 QA 결과가 문서 하단 검증 기록에 누적된다. + +## 탐지 기준 및 범위 +- 범위: `SodaLive/Sources/**/*.swift` +- 기준: + - 문자열 리터럴 중 한글 포함(`"...가-힣..."`) 항목 + - SwiftUI 하드코딩 패턴 (`Text("...")`, `Button("...")`, `placeholder: "..."`) + - 사용자 노출 가능 메시지 패턴 (`errorMessage = "..."`, `showToast(...)`, `SodaDialog(...)`) +- 제외 원칙(구현 단계에서 최종 필터링): 로그/디버그 전용 문자열, URL/키/식별자/이벤트명 등 비노출 텍스트 + +## 현황 스냅샷 +- `I18n.` 사용 파일: 93개 (`grep: \bI18n\.`) +- String Catalog 계열 API 사용 파일: 21개 (`grep: NSLocalizedString|String(localized:)|LocalizedStringKey`) +- 하드코딩 후보 파일(자동 탐지 합집합): 360개 +- 제외 확정: 비노출 문자열(로그/채널 prefix/API path/아이콘명/색상코드/Preview 샘플) 30개 파일 +- 최종 변경 대상: 330개 파일 + +## 외부 레퍼런스 기반 전환 원칙 (librarian 반영) +- `LocalizedStringResource`를 로컬라이즈 문자열 표현의 기본 타입으로 사용한다. (`I18n.swift` accessor 반환 타입 설계 시 우선 고려) +- String Catalog(`.xcstrings`)와 레거시 포맷은 병존 가능하므로, 모듈 단위 점진 이관 전략을 사용한다. +- Swift 문자열 자동 추출 설정(`Use Compiler to Extract Swift Strings`)을 점검해 누락 리스크를 줄인다. +- 동적 키/런타임 생성 문자열은 자동 추출이 어려우므로, 수동 관리 대상(manual string)으로 별도 추적한다. +- 복수형(pluralization), 포맷 토큰(`%d`, `%@`)은 이관 시 깨지기 쉬운 구간이므로 변환 검증 체크포인트를 별도 둔다. +- 접근성 문자열(`accessibilityLabel`, `accessibilityHint`)도 i18n 적용 범위에 포함한다. + +## 주요 리스크 체크포인트 +- [ ] 포맷 토큰/인자 순서 불일치로 인한 문구 깨짐 여부 검증 +- [ ] plural 규칙 손실 여부 검증 +- [ ] 동적 문자열 누락 여부 검증(수동 관리 목록 대조) +- [ ] 접근성 레이블/힌트 미전환 누락 검증 + +## I18n 키 네이밍/네임스페이스 전략 (librarian 반영) +- 최상위 네임스페이스는 모듈 기준(`I18n.Live`, `I18n.Chat`, `I18n.MyPage`)으로 고정한다. +- 2차 네임스페이스는 화면/도메인 기준(`I18n.Live.Room`, `I18n.Chat.Talk`)으로 확장한다. +- 3차 네임스페이스는 컴포넌트/다이얼로그 기준(`I18n.Live.Room.Dialog`)으로 분리한다. +- 키 이름은 문구 원문이 아닌 역할 중심(`title`, `subtitle`, `confirmButton`, `emptyStateMessage`)으로 작성한다. +- 파라미터가 필요한 문구는 프로퍼티가 아닌 함수(`func rankTitle(_ count: Int) -> String`)로 선언한다. +- 중복 문구는 도메인 내부 중복 생성 대신 `I18n.Common`으로 승격해 재사용한다. +- 대규모 이관 단계에서는 키 rename을 금지하고, 화면 단위 교체 + 화면 단위 QA 순서로 진행한다. + +## 변경 대상 파일 요약 +- 총 대상 파일 수: 330 +- 상위 모듈 수: 21 + +| 모듈 | 파일 수 | +|---|---:| +| `Audition` | 13 | +| `Chat` | 28 | +| `Content` | 78 | +| `CustomView` | 3 | +| `Dialog` | 6 | +| `Explorer` | 40 | +| `Follow` | 1 | +| `Home` | 9 | +| `IAP` | 1 | +| `ImagePicker` | 1 | +| `Live` | 56 | +| `Main` | 3 | +| `Message` | 13 | +| `MyPage` | 41 | +| `Notification` | 2 | +| `Onboarding` | 1 | +| `Report` | 4 | +| `SearchChannel` | 1 | +| `Settings` | 15 | +| `UI` | 6 | +| `User` | 8 | + +## 변경 대상 파일 전체 목록 +### Audition (13) +- [ ] `SodaLive/Sources/Audition/Applicant/ApplyMethodView.swift` +- [ ] `SodaLive/Sources/Audition/Applicant/AuditionApplicantItemView.swift` +- [ ] `SodaLive/Sources/Audition/Applicant/AuditionApplicantRecordingView.swift` +- [ ] `SodaLive/Sources/Audition/Applicant/AuditionApplyView.swift` +- [ ] `SodaLive/Sources/Audition/AuditionItemView.swift` +- [ ] `SodaLive/Sources/Audition/AuditionView.swift` +- [ ] `SodaLive/Sources/Audition/AuditionViewModel.swift` +- [ ] `SodaLive/Sources/Audition/Detail/AuditionDetailView.swift` +- [ ] `SodaLive/Sources/Audition/Detail/AuditionDetailViewModel.swift` +- [ ] `SodaLive/Sources/Audition/Detail/AuditionSoundManager.swift` +- [ ] `SodaLive/Sources/Audition/Role/AuditionDetailRoleItemView.swift` +- [ ] `SodaLive/Sources/Audition/Role/AuditionRoleDetailView.swift` +- [ ] `SodaLive/Sources/Audition/Role/AuditionRoleDetailViewModel.swift` + +### Chat (28) +- [ ] `SodaLive/Sources/Chat/Character/CharacterItemView.swift` +- [ ] `SodaLive/Sources/Chat/Character/CharacterSectionView.swift` +- [ ] `SodaLive/Sources/Chat/Character/CharacterView.swift` +- [ ] `SodaLive/Sources/Chat/Character/CharacterViewModel.swift` +- [ ] `SodaLive/Sources/Chat/Character/Detail/CharacterDetailView.swift` +- [ ] `SodaLive/Sources/Chat/Character/Detail/Gallery/CharacterDetailGalleryView.swift` +- [ ] `SodaLive/Sources/Chat/Character/New/ViewModels/NewCharacterListViewModel.swift` +- [ ] `SodaLive/Sources/Chat/Character/New/Views/NewCharacterListView.swift` +- [ ] `SodaLive/Sources/Chat/Character/Recent/RecentCharacterItemView.swift` +- [ ] `SodaLive/Sources/Chat/Character/Recent/RecentCharacterSectionView.swift` +- [ ] `SodaLive/Sources/Chat/ChatTabView.swift` +- [ ] `SodaLive/Sources/Chat/Original/Detail/OriginalWorkDetailHeaderView.swift` +- [ ] `SodaLive/Sources/Chat/Original/Detail/OriginalWorkDetailView.swift` +- [ ] `SodaLive/Sources/Chat/Original/Detail/OriginalWorkDetailViewModel.swift` +- [ ] `SodaLive/Sources/Chat/Original/OriginalTabItemView.swift` +- [ ] `SodaLive/Sources/Chat/Original/OriginalWorkViewModel.swift` +- [ ] `SodaLive/Sources/Chat/Talk/Room/ChatRoomView.swift` +- [ ] `SodaLive/Sources/Chat/Talk/Room/ChatRoomViewModel.swift` +- [ ] `SodaLive/Sources/Chat/Talk/Room/Message/AiMessageItemView.swift` +- [ ] `SodaLive/Sources/Chat/Talk/Room/Message/TypingIndicatorItemView.swift` +- [ ] `SodaLive/Sources/Chat/Talk/Room/Message/UserMessageItemView.swift` +- [ ] `SodaLive/Sources/Chat/Talk/Room/Quota/ChatQuotaNoticeItemView.swift` +- [ ] `SodaLive/Sources/Chat/Talk/Room/Settings/ChatBgSelectionView.swift` +- [ ] `SodaLive/Sources/Chat/Talk/Room/Settings/ChatBgSelectionViewModel.swift` +- [ ] `SodaLive/Sources/Chat/Talk/Room/Settings/ChatSettingsView.swift` +- [ ] `SodaLive/Sources/Chat/Talk/TalkItemView.swift` +- [ ] `SodaLive/Sources/Chat/Talk/TalkView.swift` +- [ ] `SodaLive/Sources/Chat/Talk/TalkViewModel.swift` + +### Content (78) +- [ ] `SodaLive/Sources/Content/All/ByTheme/ContentAllByThemeView.swift` +- [ ] `SodaLive/Sources/Content/All/ByTheme/ContentAllByThemeViewModel.swift` +- [ ] `SodaLive/Sources/Content/All/ContentAllView.swift` +- [ ] `SodaLive/Sources/Content/All/ContentNewAllItemView.swift` +- [ ] `SodaLive/Sources/Content/All/ContentNewAllView.swift` +- [ ] `SodaLive/Sources/Content/All/ContentRankingAllView.swift` +- [ ] `SodaLive/Sources/Content/All/ContentRankingAllViewModel.swift` +- [ ] `SodaLive/Sources/Content/Category/ContentListCategoryView.swift` +- [ ] `SodaLive/Sources/Content/ContentItemView.swift` +- [ ] `SodaLive/Sources/Content/ContentListItemView.swift` +- [ ] `SodaLive/Sources/Content/ContentListView.swift` +- [ ] `SodaLive/Sources/Content/ContentPlayManager.swift` +- [ ] `SodaLive/Sources/Content/ContentRepository.swift` +- [ ] `SodaLive/Sources/Content/Create/ContentCreateSelectThemeView.swift` +- [ ] `SodaLive/Sources/Content/Create/ContentCreateSelectThemeViewModel.swift` +- [ ] `SodaLive/Sources/Content/Create/ContentCreateView.swift` +- [ ] `SodaLive/Sources/Content/Create/ContentCreateViewModel.swift` +- [ ] `SodaLive/Sources/Content/Create/QuarterTimePickerView.swift` +- [ ] `SodaLive/Sources/Content/Create/SelectDatePicker.swift` +- [ ] `SodaLive/Sources/Content/Curation/ContentCurationView.swift` +- [ ] `SodaLive/Sources/Content/Curation/ContentCurationViewModel.swift` +- [ ] `SodaLive/Sources/Content/Detail/AudioContentDeleteDialogView.swift` +- [ ] `SodaLive/Sources/Content/Detail/AudioContentReportDialogView.swift` +- [ ] `SodaLive/Sources/Content/Detail/Comment/AudioContentCommentItemView.swift` +- [ ] `SodaLive/Sources/Content/Detail/Comment/AudioContentCommentListView.swift` +- [ ] `SodaLive/Sources/Content/Detail/Comment/AudioContentCommentListViewModel.swift` +- [ ] `SodaLive/Sources/Content/Detail/Comment/AudioContentListReplyView.swift` +- [ ] `SodaLive/Sources/Content/Detail/Comment/AudioContentListReplyViewModel.swift` +- [ ] `SodaLive/Sources/Content/Detail/Comment/ContentDetailCommentView.swift` +- [ ] `SodaLive/Sources/Content/Detail/ContentDetailInfoLimitedEditionView.swift` +- [ ] `SodaLive/Sources/Content/Detail/ContentDetailInfoView.swift` +- [ ] `SodaLive/Sources/Content/Detail/ContentDetailMenuView.swift` +- [ ] `SodaLive/Sources/Content/Detail/ContentDetailMosaicView.swift` +- [ ] `SodaLive/Sources/Content/Detail/ContentDetailOtherContentView.swift` +- [ ] `SodaLive/Sources/Content/Detail/ContentDetailPlayView.swift` +- [ ] `SodaLive/Sources/Content/Detail/ContentDetailPreviousNextContentButtonView.swift` +- [ ] `SodaLive/Sources/Content/Detail/ContentDetailPurchaseButton.swift` +- [ ] `SodaLive/Sources/Content/Detail/ContentDetailView.swift` +- [ ] `SodaLive/Sources/Content/Detail/ContentDetailViewModel.swift` +- [ ] `SodaLive/Sources/Content/Detail/ContentOrderConfirmDialogView.swift` +- [ ] `SodaLive/Sources/Content/Detail/ContentOrderDialogView.swift` +- [ ] `SodaLive/Sources/Content/Detail/LiveRoomDonationDialogView.swift` +- [ ] `SodaLive/Sources/Content/Main/Banner/ContentMainBannerViewModel.swift` +- [ ] `SodaLive/Sources/Content/Main/V2/ContentMainContentThemeView.swift` +- [ ] `SodaLive/Sources/Content/Modify/ContentModifyView.swift` +- [ ] `SodaLive/Sources/Content/Modify/ContentModifyViewModel.swift` +- [ ] `SodaLive/Sources/Content/Player/ContentPlayerView.swift` +- [ ] `SodaLive/Sources/Content/Playlist/ContentPlaylistItemView.swift` +- [ ] `SodaLive/Sources/Content/Playlist/ContentPlaylistListView.swift` +- [ ] `SodaLive/Sources/Content/Playlist/ContentPlaylistListViewModel.swift` +- [ ] `SodaLive/Sources/Content/Playlist/Create/ContentPlaylistCreateView.swift` +- [ ] `SodaLive/Sources/Content/Playlist/Create/ContentPlaylistCreateViewModel.swift` +- [ ] `SodaLive/Sources/Content/Playlist/Create/PlaylistAddContentItemView.swift` +- [ ] `SodaLive/Sources/Content/Playlist/Create/PlaylistAddContentView.swift` +- [ ] `SodaLive/Sources/Content/Playlist/Create/PlaylistCreateContentView.swift` +- [ ] `SodaLive/Sources/Content/Playlist/Detail/ContentPlaylistDetailView.swift` +- [ ] `SodaLive/Sources/Content/Playlist/Detail/ContentPlaylistDetailViewModel.swift` +- [ ] `SodaLive/Sources/Content/Playlist/Detail/PlaylistContentItemView.swift` +- [ ] `SodaLive/Sources/Content/Playlist/Modify/ContentPlaylistModifyView.swift` +- [ ] `SodaLive/Sources/Content/Playlist/Modify/ContentPlaylistModifyViewModel.swift` +- [ ] `SodaLive/Sources/Content/Series/Content/SeriesContentAllView.swift` +- [ ] `SodaLive/Sources/Content/Series/Content/SeriesContentAllViewModel.swift` +- [ ] `SodaLive/Sources/Content/Series/Content/SeriesContentListItemView.swift` +- [ ] `SodaLive/Sources/Content/Series/DayOfWeekSeriesView.swift` +- [ ] `SodaLive/Sources/Content/Series/Detail/SeriesDetailHomeView.swift` +- [ ] `SodaLive/Sources/Content/Series/Detail/SeriesDetailIntroductionView.swift` +- [ ] `SodaLive/Sources/Content/Series/Detail/SeriesDetailView.swift` +- [ ] `SodaLive/Sources/Content/Series/Detail/SeriesDetailViewModel.swift` +- [ ] `SodaLive/Sources/Content/Series/Main/ByGenre/SeriesMainByGenreViewModel.swift` +- [ ] `SodaLive/Sources/Content/Series/Main/DayOfWeek/SeriesMainDayOfWeekView.swift` +- [ ] `SodaLive/Sources/Content/Series/Main/DayOfWeek/SeriesMainDayOfWeekViewModel.swift` +- [ ] `SodaLive/Sources/Content/Series/Main/Home/SeriesMainHomeView.swift` +- [ ] `SodaLive/Sources/Content/Series/Main/Home/SeriesMainHomeViewModel.swift` +- [ ] `SodaLive/Sources/Content/Series/Main/SeriesMainItemView.swift` +- [ ] `SodaLive/Sources/Content/Series/Main/SeriesMainView.swift` +- [ ] `SodaLive/Sources/Content/Series/SeriesItemView.swift` +- [ ] `SodaLive/Sources/Content/Series/SeriesListAllView.swift` +- [ ] `SodaLive/Sources/Content/Series/SeriesListAllViewModel.swift` + +### CustomView (3) +- [ ] `SodaLive/Sources/CustomView/ChatTextFieldView.swift` +- [ ] `SodaLive/Sources/CustomView/ExpandableTextView.swift` +- [ ] `SodaLive/Sources/CustomView/IconAndTitleToggleButton.swift` + +### Dialog (6) +- [ ] `SodaLive/Sources/Dialog/ApplyAuditionCompleteDialog.swift` +- [ ] `SodaLive/Sources/Dialog/CommunityPostPurchaseDialog.swift` +- [ ] `SodaLive/Sources/Dialog/CreatorFollowNotifyDialog.swift` +- [ ] `SodaLive/Sources/Dialog/LivePaymentDialog.swift` +- [ ] `SodaLive/Sources/Dialog/LiveRoomPasswordDialog.swift` +- [ ] `SodaLive/Sources/Dialog/MemberProfileDialog.swift` + +### Explorer (40) +- [ ] `SodaLive/Sources/Explorer/ExplorerSectionView.swift` +- [ ] `SodaLive/Sources/Explorer/ExplorerView.swift` +- [ ] `SodaLive/Sources/Explorer/ExplorerViewModel.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/ChannelDonation/ChannelDonationAllView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/ChannelDonation/ChannelDonationItemView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/All/Comment/CreatorCommunityCommentItemView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/All/Comment/CreatorCommunityCommentListView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/All/Comment/CreatorCommunityCommentListViewModel.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/All/Comment/CreatorCommunityCommentReplyView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/All/Comment/CreatorCommunityCommentReplyViewModel.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/All/Comment/CreatorCommunityCommentView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/All/CreatorCommunityAllItemLockView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/All/CreatorCommunityAllView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/All/CreatorCommunityAllViewModel.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/All/CreatorCommunityMenuView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/All/Player/CreatorCommunityMediaPlayerManager.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/CreatorCommunityItemView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/CreatorCommunityMoreItemView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/CreatorCommunityNoPostsItemView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/Modify/CreatorCommunityModifyView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/Modify/CreatorCommunityModifyViewModel.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/Write/CreatorCommunityRecordingVoiceView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/Write/CreatorCommunitySoundManager.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/Write/CreatorCommunityWriteView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/CreatorCommunity/Write/CreatorCommunityWriteViewModel.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/FanTalk/UserProfileFanTalkAllView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/FanTalk/UserProfileFanTalkCheersItemView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/FanTalk/UserProfileFanTalkView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/FanTalk/UserProfileFanTalkViewModel.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/FollowerList/FollowerListView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/Series/UserProfileSeriesView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/UserProfileActivitySummaryView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/UserProfileContentView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/UserProfileDonationAllView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/UserProfileDonationAllViewModel.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/UserProfileDonationView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/UserProfileIntroduceView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/UserProfileLiveView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/UserProfileView.swift` +- [ ] `SodaLive/Sources/Explorer/Profile/UserProfileViewModel.swift` + +### Follow (1) +- [ ] `SodaLive/Sources/Follow/FollowCreatorView.swift` + +### Home (9) +- [ ] `SodaLive/Sources/Home/HomeAuditionView.swift` +- [ ] `SodaLive/Sources/Home/HomeCreatorRankingItemView.swift` +- [ ] `SodaLive/Sources/Home/HomeLatestContentView.swift` +- [ ] `SodaLive/Sources/Home/HomeLiveItemView.swift` +- [ ] `SodaLive/Sources/Home/HomeTabView.swift` +- [ ] `SodaLive/Sources/Home/HomeWeeklyChartItemView.swift` +- [ ] `SodaLive/Sources/Home/HomeWeeklyChartView.swift` +- [ ] `SodaLive/Sources/Home/RecommendChannel/RecommendChannelContentItemView.swift` +- [ ] `SodaLive/Sources/Home/RecommendChannel/RecommendChannelItemView.swift` + +### IAP (1) +- [ ] `SodaLive/Sources/IAP/StoreManager.swift` + +### ImagePicker (1) +- [ ] `SodaLive/Sources/ImagePicker/ImagePicker.swift` + +### Live (56) +- [ ] `SodaLive/Sources/Live/Cancel/LiveCancelDialog.swift` +- [ ] `SodaLive/Sources/Live/LatestFinishedLiveItemView.swift` +- [ ] `SodaLive/Sources/Live/LiveReplayListView.swift` +- [ ] `SodaLive/Sources/Live/LiveView.swift` +- [ ] `SodaLive/Sources/Live/LiveViewModel.swift` +- [ ] `SodaLive/Sources/Live/Now/All/LiveNowAllItemView.swift` +- [ ] `SodaLive/Sources/Live/Now/All/LiveNowAllView.swift` +- [ ] `SodaLive/Sources/Live/Now/LiveNowItemView.swift` +- [ ] `SodaLive/Sources/Live/Now/SectionLiveNowView.swift` +- [ ] `SodaLive/Sources/Live/RecommendChannel/SectionRecommendChannelView.swift` +- [ ] `SodaLive/Sources/Live/Reservation/All/LiveReservationAllItemView.swift` +- [ ] `SodaLive/Sources/Live/Reservation/All/LiveReservationAllView.swift` +- [ ] `SodaLive/Sources/Live/Reservation/Complete/LiveReservationCompleteView.swift` +- [ ] `SodaLive/Sources/Live/Reservation/LiveReservationItemView.swift` +- [ ] `SodaLive/Sources/Live/Reservation/MyLiveReservationItemView.swift` +- [ ] `SodaLive/Sources/Live/Reservation/SectionLiveReservationView.swift` +- [ ] `SodaLive/Sources/Live/Room/Chat/LiveRoomChatItemView.swift` +- [ ] `SodaLive/Sources/Live/Room/Chat/LiveRoomDonationChatItemView.swift` +- [ ] `SodaLive/Sources/Live/Room/Chat/LiveRoomHeartDonationChatItemView.swift` +- [ ] `SodaLive/Sources/Live/Room/Chat/LiveRoomJoinChatItemView.swift` +- [ ] `SodaLive/Sources/Live/Room/Chat/LiveRoomRouletteDonationChatItemView.swift` +- [ ] `SodaLive/Sources/Live/Room/Create/LiveRoomCreateView.swift` +- [ ] `SodaLive/Sources/Live/Room/Create/Tag/LiveRoomCreateTagView.swift` +- [ ] `SodaLive/Sources/Live/Room/Create/Tag/LiveRoomCreateTagViewModel.swift` +- [ ] `SodaLive/Sources/Live/Room/Detail/LiveDetailView.swift` +- [ ] `SodaLive/Sources/Live/Room/Detail/LiveDetailViewModel.swift` +- [ ] `SodaLive/Sources/Live/Room/Dialog/LiveRoomDonationMessageDialog.swift` +- [ ] `SodaLive/Sources/Live/Room/Dialog/LiveRoomDonationMessageItemView.swift` +- [ ] `SodaLive/Sources/Live/Room/Dialog/LiveRoomDonationRankingDialog.swift` +- [ ] `SodaLive/Sources/Live/Room/Dialog/LiveRoomDonationRankingItemView.swift` +- [ ] `SodaLive/Sources/Live/Room/Dialog/LiveRoomDonationRankingTotalCanView.swift` +- [ ] `SodaLive/Sources/Live/Room/Dialog/LiveRoomHeartRankingDialog.swift` +- [ ] `SodaLive/Sources/Live/Room/Dialog/LiveRoomHeartRankingItemView.swift` +- [ ] `SodaLive/Sources/Live/Room/Dialog/LiveRoomInfoEditDialog.swift` +- [ ] `SodaLive/Sources/Live/Room/Dialog/LiveRoomNoChattingDialogView.swift` +- [ ] `SodaLive/Sources/Live/Room/Dialog/LiveRoomProfileDialog.swift` +- [ ] `SodaLive/Sources/Live/Room/Dialog/LiveRoomProfileItemTitleView.swift` +- [ ] `SodaLive/Sources/Live/Room/Dialog/LiveRoomProfilesDialogView.swift` +- [ ] `SodaLive/Sources/Live/Room/Dialog/LiveRoomUserProfileDialogView.swift` +- [ ] `SodaLive/Sources/Live/Room/Edit/LiveRoomEditView.swift` +- [ ] `SodaLive/Sources/Live/Room/Edit/LiveRoomEditViewModel.swift` +- [ ] `SodaLive/Sources/Live/Room/LiveRoomViewModel.swift` +- [ ] `SodaLive/Sources/Live/Room/Menu/LiveRoomMenuSelectView.swift` +- [ ] `SodaLive/Sources/Live/Room/Menu/MenuSettingsView.swift` +- [ ] `SodaLive/Sources/Live/Room/Menu/MenuSettingsViewModel.swift` +- [ ] `SodaLive/Sources/Live/Room/Routlette/Config/RouletteSettingsOptionView.swift` +- [ ] `SodaLive/Sources/Live/Room/Routlette/Config/RouletteSettingsView.swift` +- [ ] `SodaLive/Sources/Live/Room/Routlette/Config/RouletteSettingsViewModel.swift` +- [ ] `SodaLive/Sources/Live/Room/Routlette/RoulettePreviewDialog.swift` +- [ ] `SodaLive/Sources/Live/Room/V2/Component/Button/LiveRoomNewChatView.swift` +- [ ] `SodaLive/Sources/Live/Room/V2/Component/View/LiveRoomInfoGuestView.swift` +- [ ] `SodaLive/Sources/Live/Room/V2/Component/View/LiveRoomInfoHostView.swift` +- [ ] `SodaLive/Sources/Live/Room/V2/Component/View/LiveRoomInputChatView.swift` +- [ ] `SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift` +- [ ] `SodaLive/Sources/Live/SectionCommunityPostView.swift` +- [ ] `SodaLive/Sources/Live/SectionLatestFinishedLiveView.swift` + +### Main (3) +- [ ] `SodaLive/Sources/Main/EventPopupDialogView.swift` +- [ ] `SodaLive/Sources/Main/Home/BottomTabView.swift` +- [ ] `SodaLive/Sources/Main/Home/HomeView.swift` + +### Message (13) +- [ ] `SodaLive/Sources/Message/MessageFilterTabView.swift` +- [ ] `SodaLive/Sources/Message/MessageView.swift` +- [ ] `SodaLive/Sources/Message/Text/Detail/TextMessageDetailView.swift` +- [ ] `SodaLive/Sources/Message/Text/Detail/TextMessageDetailViewModel.swift` +- [ ] `SodaLive/Sources/Message/Text/SelectRecipient/SelectRecipientView.swift` +- [ ] `SodaLive/Sources/Message/Text/SelectRecipient/SelectRecipientViewModel.swift` +- [ ] `SodaLive/Sources/Message/Text/TextMessageView.swift` +- [ ] `SodaLive/Sources/Message/Text/Write/TextMessageWriteView.swift` +- [ ] `SodaLive/Sources/Message/Voice/SoundManager.swift` +- [ ] `SodaLive/Sources/Message/Voice/VoiceMessageItemView.swift` +- [ ] `SodaLive/Sources/Message/Voice/VoiceMessageView.swift` +- [ ] `SodaLive/Sources/Message/Voice/VoiceMessageViewModel.swift` +- [ ] `SodaLive/Sources/Message/Voice/Write/VoiceMessageWriteView.swift` + +### MyPage (41) +- [ ] `SodaLive/Sources/MyPage/Auth/AuthButtonView.swift` +- [ ] `SodaLive/Sources/MyPage/Block/BlockMemberListView.swift` +- [ ] `SodaLive/Sources/MyPage/Block/BlockedMemberListItemView.swift` +- [ ] `SodaLive/Sources/MyPage/Can/Charge/CanChargeView.swift` +- [ ] `SodaLive/Sources/MyPage/Can/Charge/CanChargeViewModel.swift` +- [ ] `SodaLive/Sources/MyPage/Can/Coupon/CanChargeCouponButtonView.swift` +- [ ] `SodaLive/Sources/MyPage/Can/Coupon/CanCouponNoticeItemView.swift` +- [ ] `SodaLive/Sources/MyPage/Can/Payment/CanPaymentView.swift` +- [ ] `SodaLive/Sources/MyPage/Can/Payment/CanPaymentViewModel.swift` +- [ ] `SodaLive/Sources/MyPage/Can/Payment/CanPgPaymentView.swift` +- [ ] `SodaLive/Sources/MyPage/Can/Payment/CanPgPaymentViewModel.swift` +- [ ] `SodaLive/Sources/MyPage/Can/Payment/Temp/CanPaymentTempView.swift` +- [ ] `SodaLive/Sources/MyPage/Can/Payment/Temp/CanPaymentTempViewModel.swift` +- [ ] `SodaLive/Sources/MyPage/Can/Status/CanStatusView.swift` +- [ ] `SodaLive/Sources/MyPage/Can/Status/CanStatusViewModel.swift` +- [ ] `SodaLive/Sources/MyPage/Can/Status/CanUseStatusView.swift` +- [ ] `SodaLive/Sources/MyPage/CanCardView.swift` +- [ ] `SodaLive/Sources/MyPage/MyPageView.swift` +- [ ] `SodaLive/Sources/MyPage/MyPageViewModel.swift` +- [ ] `SodaLive/Sources/MyPage/OrderList/OrderListAllInnerView.swift` +- [ ] `SodaLive/Sources/MyPage/OrderList/OrderListAllView.swift` +- [ ] `SodaLive/Sources/MyPage/OrderList/OrderListAllViewModel.swift` +- [ ] `SodaLive/Sources/MyPage/OrderList/OrderListItemView.swift` +- [ ] `SodaLive/Sources/MyPage/OrderList/OrderListView.swift` +- [ ] `SodaLive/Sources/MyPage/Point/PointStatusView.swift` +- [ ] `SodaLive/Sources/MyPage/Point/PointStatusViewModel.swift` +- [ ] `SodaLive/Sources/MyPage/Point/Use/PointUseStatusView.swift` +- [ ] `SodaLive/Sources/MyPage/Profile/Nickname/NicknameUpdateView.swift` +- [ ] `SodaLive/Sources/MyPage/Profile/Nickname/NicknameUpdateViewModel.swift` +- [ ] `SodaLive/Sources/MyPage/Profile/ProfileUpdateView.swift` +- [ ] `SodaLive/Sources/MyPage/Profile/Tag/MemberTagView.swift` +- [ ] `SodaLive/Sources/MyPage/Profile/Tag/MemberTagViewModel.swift` +- [ ] `SodaLive/Sources/MyPage/ReservationStatus/Cancel/LiveReservationCancelView.swift` +- [ ] `SodaLive/Sources/MyPage/ReservationStatus/LiveReservationStatusItemView.swift` +- [ ] `SodaLive/Sources/MyPage/ReservationStatus/LiveReservationStatusView.swift` +- [ ] `SodaLive/Sources/MyPage/ReservationStatus/LiveReservationStatusViewModel.swift` +- [ ] `SodaLive/Sources/MyPage/ReservationStatusView.swift` +- [ ] `SodaLive/Sources/MyPage/ServiceCenter/FaqView.swift` +- [ ] `SodaLive/Sources/MyPage/ServiceCenter/ServiceCenterButtonView.swift` +- [ ] `SodaLive/Sources/MyPage/ServiceCenter/ServiceCenterView.swift` +- [ ] `SodaLive/Sources/MyPage/ServiceCenter/ServiceCenterViewModel.swift` + +### Notification (2) +- [ ] `SodaLive/Sources/Notification/List/PushNotificationListItemView.swift` +- [ ] `SodaLive/Sources/Notification/List/PushNotificationListView.swift` + +### Onboarding (1) +- [ ] `SodaLive/Sources/Onboarding/OnboardingView.swift` + +### Report (4) +- [ ] `SodaLive/Sources/Report/CheersReportDialogView.swift` +- [ ] `SodaLive/Sources/Report/ProfileReportDialogView.swift` +- [ ] `SodaLive/Sources/Report/ProfileReportMenuView.swift` +- [ ] `SodaLive/Sources/Report/UserReportDialogView.swift` + +### SearchChannel (1) +- [ ] `SodaLive/Sources/SearchChannel/SearchChannelView.swift` + +### Settings (15) +- [ ] `SodaLive/Sources/Settings/Content/ContentSettingsView.swift` +- [ ] `SodaLive/Sources/Settings/Event/EventDetailView.swift` +- [ ] `SodaLive/Sources/Settings/Event/EventListView.swift` +- [ ] `SodaLive/Sources/Settings/Event/EventListViewModel.swift` +- [ ] `SodaLive/Sources/Settings/Language/Models/LanguageOption.swift` +- [ ] `SodaLive/Sources/Settings/Language/Views/LanguageSettingsView.swift` +- [ ] `SodaLive/Sources/Settings/Notice/NoticeDetailView.swift` +- [ ] `SodaLive/Sources/Settings/Notice/NoticeListView.swift` +- [ ] `SodaLive/Sources/Settings/Notice/NoticeListViewModel.swift` +- [ ] `SodaLive/Sources/Settings/Notification/NotificationSettingsDialog.swift` +- [ ] `SodaLive/Sources/Settings/Notification/NotificationSettingsView.swift` +- [ ] `SodaLive/Sources/Settings/Notification/NotificationSettingsViewModel.swift` +- [ ] `SodaLive/Sources/Settings/SettingsView.swift` +- [ ] `SodaLive/Sources/Settings/SignOut/SignOutView.swift` +- [ ] `SodaLive/Sources/Settings/Terms/TermsViewModel.swift` + +### UI (6) +- [ ] `SodaLive/Sources/UI/Component/SelectedButtonView.swift` +- [ ] `SodaLive/Sources/UI/Component/SeriesDetailTabView.swift` +- [ ] `SodaLive/Sources/UI/Component/SeriesItemBadgeView.swift` +- [ ] `SodaLive/Sources/UI/Component/SeriesKeywordChipView.swift` +- [ ] `SodaLive/Sources/UI/Component/SeriesListBigItemView.swift` +- [ ] `SodaLive/Sources/UI/Component/SeriesListItemView.swift` + +### User (8) +- [ ] `SodaLive/Sources/User/FindPassword/FindPasswordView.swift` +- [ ] `SodaLive/Sources/User/FindPassword/FindPasswordViewModel.swift` +- [ ] `SodaLive/Sources/User/Login/LoginView.swift` +- [ ] `SodaLive/Sources/User/Login/LoginViewModel.swift` +- [ ] `SodaLive/Sources/User/SignUp/SignUpView.swift` +- [ ] `SodaLive/Sources/User/SignUp/SignUpViewModel.swift` +- [ ] `SodaLive/Sources/User/UserTextField.swift` +- [ ] `SodaLive/Sources/User/UserViewModel.swift` + +## 검증 기록 +### 1차 계획 수립 (2026-03-31) +- 무엇/왜/어떻게: + - 무엇: 하드코딩 문구 전수 후보를 수집하고, `I18n.swift` 단일화 전환 계획 문서를 작성. + - 왜: 현재 `Localizable.xcstrings`와 `I18n.swift` 혼재로 인해 유지보수/일관성 비용이 증가하고 있어 단일 경로 정리가 필요. + - 어떻게: explore/librarian 병렬 탐색 + grep/ast-grep 직접 검색을 병행해 대상 파일 인벤토리를 생성. +- 실행 명령/도구: + - `task(subagent_type="explore", ... )` x3 (SwiftUI/UIKIt/혼재지점 탐색) + - `task(subagent_type="librarian", ... )` x2 (외부 레퍼런스/네이밍 전략) + - `grep("\"[^\"]*[가-힣][^\"]*\"", include=*.swift, path=SodaLive/Sources)` + - `grep("\bI18n\.", include=*.swift, path=SodaLive/Sources)` + - `grep("NSLocalizedString\(|String\(localized:|LocalizedStringKey\(", include=*.swift, path=SodaLive/Sources)` + - `grep("Text\(\"[^\"]+\"\)", include=*.swift, path=SodaLive/Sources)` + - `ast_grep_search(pattern="Text(\"$TEXT\")", lang=swift, paths=[SodaLive/Sources])` + - 보조 집계 스크립트: `python3` (후보 파일 dedupe/모듈별 집계) +- 결과: + - 하드코딩 후보 파일 360개 산출 및 모듈별 분류 완료. + - `rg` 명령은 환경에 설치되어 있지 않아(`command not found`) grep/ast-grep/파이썬 스캔으로 대체. + + +### 2차 계획 보강 (외부 i18n 레퍼런스 반영, 2026-03-31) +- 무엇/왜/어떻게: + - 무엇: iOS i18n 통합 시 주의점(포맷 토큰/복수형/접근성/동적 키)을 계획 문서에 체크포인트로 반영. + - 왜: 파일 목록만으로는 전환 품질을 담보하기 어려워, 이행 단계별 검증 기준을 사전에 고정할 필요가 있음. + - 어떻게: `librarian` 조사 결과를 기반으로 전환 원칙/리스크 항목을 문서 상단에 추가. +- 실행 명령/도구: + - `background_output(task_id="bg_535935bc")` +- 결과: + - 외부 레퍼런스 기반 전환 원칙 6개 및 리스크 체크포인트 4개 반영 완료. + - 남은 `librarian` 1개(네이밍 전략)는 완료 알림 수신 후 동일 문서에 추가 반영 예정. + +### 3차 계획 보강 (I18n 키 네이밍 전략 반영, 2026-03-31) +- 무엇/왜/어떻게: + - 무엇: `I18n.swift` 단일화 시 키 충돌/확장 혼선을 줄이기 위한 네이밍/계층 전략을 반영. + - 왜: 파일 전수 목록만으로는 장기 유지보수 규칙이 부족해, 이관 이후에도 일관성을 유지할 기준이 필요함. + - 어떻게: `librarian` 네이밍 전략 조사 결과를 정리해 문서 상단에 별도 전략 섹션으로 추가. +- 실행 명령/도구: + - `background_output(task_id="bg_3bd27691")` +- 결과: + - 모듈/화면/컴포넌트 3단계 네임스페이스와 역할 중심 키 네이밍 기준 반영 완료. + - 파라미터 문자열 함수화, 공통 키 승격(`I18n.Common`), 키 rename 금지 원칙 반영 완료. + - 중복 계획 문서(`20260331_I18n키네임스페이스구조계획.md`)는 단일 계획 문서 원칙에 맞춰 제거. + +### 4차 계획 보강 (Agora 후보 제외 반영, 2026-03-31) +- 무엇/왜/어떻게: + - 무엇: `SodaLive/Sources/Agora/Agora.swift`를 변경 대상 목록에서 제외. + - 왜: 해당 파일의 문자열은 `DEBUG_LOG` 메시지/내부 채널 prefix 등 사용자 노출 텍스트가 아니라 i18n 전환 범위와 맞지 않음. + - 어떻게: 변경 대상 섹션에서 `Agora` 모듈과 파일 체크리스트 항목을 제거하고 요약 카운트를 재산정. +- 실행 명령/도구: + - `grep("\"[^\"]*\"", include=Agora.swift, path=SodaLive/Sources/Agora)` + - `grep("Agora|총 대상 파일 수|상위 모듈 수", include=20260331_하드코딩텍스트_I18n통일계획.md, path=docs)` + - `python3` (문서 내 체크리스트 파일 수/모듈 수 재계산) +- 결과: + - 변경 대상 파일 수 `360 → 359`, 상위 모듈 수 `25 → 24`로 갱신. + - `Agora.swift` 체크리스트 항목 제거 및 문서 내 제외 사유 명시 완료. + +### 5차 계획 보강 (비노출 문자열 전수 제외 반영, 2026-03-31) +- 무엇/왜/어떻게: + - 무엇: 변경 대상 359개를 재검토해 비노출 문자열만 가진 파일을 계획에서 제외. + - 왜: i18n 전환 대상은 사용자 노출 문구여야 하며, 내부 로그/채널명/API 경로/프리뷰 샘플 문자열은 범위 외이기 때문. + - 어떻게: 후보 전수 스캔 후 파일별 문자열 컨텍스트를 리뷰해 비노출 29개 파일을 추가 제외(이전 Agora 1개 제외 포함 총 30개 제외). +- 실행 명령/도구: + - `read(SodaLive/Sources/Common/TextViewWrapper.swift)` + - `grep("\"[^\"]*\"", include=Agora.swift, path=SodaLive/Sources/Agora)` + - `python3` (후보 파일 컨텍스트 분류/제외 리스트 산출/문서 섹션 재생성) +- 결과: + - `Common/TextViewWrapper.swift` 제외(실사용 문자열 없음, Preview 샘플만 존재). + - 내부 로그/채널 prefix/API path/아이콘명/색상코드/Preview 샘플만 가진 29개 파일 추가 제외 완료. + - 변경 대상 파일 수 `359 → 330`, 상위 모듈 수 `24 → 21`으로 갱신. + - 예외 유지: `Content/Detail/ContentDetailPurchaseButton.swift`는 `"원으로"/"캔으로"` 사용자 노출 텍스트가 있어 유지.