klaus/sodalive-ios
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
222520d5e9ce340f5a52a47cde53370da55c95cf
sodalive-ios/docs/20260331_하드코딩텍스트_I18n통일계획.md

36 KiB
Raw Blame History

20260331 하드코딩 텍스트 I18n.swift 통일 계획

작업 체크리스트

  • 코드베이스 하드코딩 문구 탐색 전략 수립 (병렬 탐색 + 정적 검색)
  • I18n.swift와 Localizable.xcstrings 혼재 지점 식별
  • 하드코딩 문구 변경 대상 파일 인벤토리 산출 및 문서화
  • 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는 "원으로"/"캔으로" 사용자 노출 텍스트가 있어 유지.

6차 구현 (Audition 모듈 13개 i18n 전환, 2026-03-31)

  • 무엇/왜/어떻게:
    • 무엇: 변경 대상 목록의 Audition 모듈 13개 파일을 전수 처리해 사용자 노출 하드코딩 문구를 I18n.* 참조로 교체.
    • 왜: Audition 영역의 UI/토스트/다이얼로그/오류 메시지가 하드코딩 상태여서 다국어 일관성이 깨지고 유지보수 비용이 높았기 때문.
    • 어떻게: explore/librarian/Oracle 병렬 분석 + grep/ast_grep_search 직접 검증으로 누락 지점을 수집한 뒤, I18n.swift에 I18n.Audition 네임스페이스를 추가하고 호출부를 모듈 단위로 일괄 치환.
  • 실행 명령/도구:
    • task(subagent_type="explore", ...) x2 (bg_f58a087c, bg_02b03b28)
    • task(subagent_type="librarian", ...) x2 (bg_f62866ac, bg_5cd8656b)
    • task(subagent_type="oracle", ...) x1 (bg_81c2c04e)
    • grep("\"[^\"]*[가-힣][^\"]*\"", include=*.swift, path=SodaLive/Sources/Audition)
    • ast_grep_search(pattern="Text(\"$TEXT\")", lang=swift, paths=[SodaLive/Sources/Audition])
    • xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" -configuration Debug build
    • xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build
    • xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" test
    • xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" test
  • 결과:
    • Audition 호출부 치환 완료 파일: ApplyMethodView, AuditionApplicantRecordingView, AuditionApplyView, AuditionView, AuditionViewModel, AuditionDetailView, AuditionDetailViewModel, AuditionSoundManager, AuditionDetailRoleItemView, AuditionRoleDetailView, AuditionRoleDetailViewModel.
    • I18n.swift에 I18n.Audition(List/ApplyMethod/Apply/Recording/Detail/Vote/Sound) 키셋 추가 및 공통 오류는 I18n.Common.commonError로 통합.
    • 녹음 자동 파일명(voiceon_now_voice_*)이 사용자에게 그대로 보이던 문제를 displayFileName 처리(I18n.Audition.Apply.recordedVoiceFileName)로 보정.
    • Audition 모듈 하드코딩 한글 재검증 결과, 남은 문자열은 Preview 샘플/DEBUG_LOG/서버 메시지 분기 비교(비노출 로직)만 존재.
    • 빌드 검증: SodaLive, SodaLive-dev Debug 빌드 모두 성공(** BUILD SUCCEEDED **).
    • 테스트 검증: 두 스킴 모두 Scheme ... is not currently configured for the test action.로 테스트 액션 미구성 확인(코드 실패 아님, 스킴 제약).