[Refactor] #256 - 피드 새로고침 경로 통일·피드 탭 상시 mount 보존 + 온보딩 QA·UI 마감

[Naknakk]

💡 Issue

• closed [Refactor] 피드 목록 새로고침 경로 통일 - feedCreatedVersion 기구 제거 #256

💭 Summary

피드 최신화 전략을 앱 전역에서 하나로 통일했어요 — "재진입엔 다녀온 셀만 상세 API로 동기화, 새 글은 그 화면발 작성 성공 복귀 신호로만 리셋"이 소소피드와 작품 상세 피드 탭에 똑같이 적용돼요.

여기에 피드 서브탭 상시 mount(탭별 스크롤 보존), 온보딩 QA(#257 통합), UI 마감 수정 여러 건이 함께 실려 있어요.

🔑 Key Changes

피드 새로고침 통일 (핵심)

• 소소피드·작품 상세 피드 탭 모두 재진입 시 목록을 다시 받지 않고, 다녀온 셀만 피드 상세 API로 동기화해요(삭제·숨김이면 셀 제거, 스크롤·목록 길이 보존).
• 작품 상세의 "보던 개수만큼 window 재조회"(NovelFeedPageSizePolicy)는 새 글 유입 시 기존 글이 밀려나는 실결함이 있어 삭제했어요.
• 새 글 반영은 피드 탭 연필 작성 성공 복귀 신호(탭 Root 로컬 Binding)로만 — 예전 앱 전역 신호(FeedListInvalidation)는 제거했어요.
• 셀 동기화 대기열은 진행 중 동기화가 끝나는 즉시 이어서 소비해요(리뷰에서 잡힌 drain 누락 수정).
• 피드 목록의 로드 실패 표현([Feat] 내 서재 재진입 시 보고 있던 개수만큼 갱신 #195 계약)도 함께 구현했어요 — 어느 로드 실패든 그 탭 콘텐츠 자리에 NetworkErrorView(재시도)가 뜨고, 좋아요·삭제·신고 실패는 토스트예요(예전엔 전부 무표시 — 아래 To Reviewer 참고).

피드 서브탭 상시 mount (2026-09-09 확정)

• 내 피드↔소소피드 전환 시 재조회하지 않고, 두 리스트를 ZStack에 상시 mount해 탭별 스크롤 깊이까지 보존해요.
• 로딩 표시는 loadingTab: FeedTab?으로 "어느 탭의 로드인지"를 들고 다녀요(공유 Bool이면 엉뚱한 탭에 스피너가 뜨는 문제 — 리뷰 반영).
• 내 피드 빈 화면의 "피드 작성" CTA를 실제 작성 진입(onRoute(.createFeed))으로 배선했어요(죽은 버튼이었어요).

온보딩 QA (#257 통합)

• 미가입 재로그인 시 재온보딩 게이트(isOnboardingCompleted 로컬 저장 + 부트스트랩 게이트, Domain 테스트 5개 포함).
• 인트로 배너 캐러셀을 TabView → 순수 SwiftUI 페이저로 교체(실기기에서 selection 어긋나는 UIKit 브리지 버그 회피).
• 로그인 취소 무토스트·SE 토스트 위치·장르 전환 슬라이드·키보드·로띠 1회 재생·닉네임 필드 포커스 유지 등 세부 QA.

UI 마감·기타

• 반응형 네비바(작품·컬렉션 상세) 배경 히트테스트를 표시 상태와 연동 — 바에 가려진 콘텐츠로 탭이 관통하던 문제 수정.
• 서재 매력포인트 정렬을 평가·필터와 통일(enum 선언 순서를 디자인 정본으로 승격 + 순서 고정 테스트 추가).
• WSSNovelCoverImage에 .backdrop placeholder 신설 — 블러 아래 로딩 스피너가 회색 네모 잔상으로 보이던 문제 수정(홈 오늘의 발견·작품 상세 헤더).
• 오늘의 발견 카드 눌림 효과를 카드 단위 균일 페이드로 교체(compositingGroup — 기본 스타일은 층별로 옅어져 표지만 도드라졌어요).
• 작품 상세 네비바 종·threedots 버튼 터치영역을 우측 끝까지 확장했어요.
• 완결·휴재 복귀 알림 목록 시작점에 상단 여백 8을 추가했어요.
• 닫기 확인 알럿이 있는 3화면(피드 작성·작품 평가·컬렉션 만들기)의 스와이프 뒤로가기를 통일했어요 — 예전엔 조용히 막혀 "스와이프가 안 먹는 화면"이었는데, 이제 스와이프 시도를 감지해 back 버튼과 같은 확인 알럿을 띄워요(wssCustomNavigationBar의 swipeBackEnabled: Bool → swipeBackConfirmation: (() -> Void)? 교체).
• QueryItemConvertible 빈 배열은 쿼리 자체를 생략(서버는 미전송과 동일 취급).
• App 최소버전 17.0 명시·Mac(Designed for iPad) 실행 대상 제거.
• V1 동작 계약서 2개(Feed·NovelDetail)의 stale 판정 대거 갱신(추출 후 구현 완료된 항목들), docs/ARCHITECTURE.md SplashFeature 배선 서술 정정, [Fix] 작품 상세 — 피드 목록 변경 직후 화면 전환 시 무한 레이아웃 루프(라이브락) #239 라이브락 옛 결정론 조건(피드 3개+작성 복귀) 3회 재관찰 미재현 기록.

📱 Simulation

(첨부 예정)

🧑‍🧒‍🧒 To Reviewer

리뷰 수렴 내역 — wss-pr-reviewer(opus)·wss-feature-reviewer(opus)·Codex CLI(코드)·Codex CLI(문서 감사) 4자 병렬 리뷰를 돌렸고, 🔴 0·🟡 9건을 전부 반영/처리했어요(2라운드 delta 검증까지 완료).

결정이 필요한 것 1 → 해소 — 작성 복귀 리셋의 실패 갭 (2026-09-10 구현)

• 이 화면의 로드 실패 표현([Feat] 내 서재 재진입 시 보고 있던 개수만큼 갱신 #195 계약)을 이번 PR에서 구현하는 것으로 결정·반영했어요 — 죽은 errorMessage를 탭별 RepositoryError?로 교체하고, 첫 페이지·더보기·당겨서 새로고침·작성 복귀 재로드 어느 실패든 그 탭 콘텐츠 자리에 NetworkErrorView(재시도)가 떠요.
• 재시도는 그 탭을 비우고 처음부터 다시 세워요(NovelDetail.retryFeeds와 같은 결) — "아직 남긴 기록이 없어요" 빈 화면 트랩이 사라졌어요. 좋아요·삭제·신고 실패는 .networkDelay 토스트로 표현해요(역시 무표시였던 갭).
• 남은 갭: 인증 만료 라우팅은 여전히 미배선이라 401도 "일시적 오류" 실패 뷰로 흡수돼요(예전 조용한 빈 화면보단 개선) — docs/TODO.md 12절에 후속 등재.

확인 요청 1 → 확인 완료 — 상세탐색 무필터 서버 회귀 없음

• dev 서버(/novels/filtered)에 파라미터 생략 버전과 빈 값(?genres=&…) 버전을 각각 보내 비교했어요(2026-09-09).
• 무필터: 두 방식 모두 resultCount 95,598·반환 목록 완전 동일 / 장르(romance)만: 두 방식 모두 38,944·목록 동일.
• 서버가 둘을 동일 취급하는 게 확인돼 회귀 없음으로 닫아요(기록: Projects/Core/Networking/CLAUDE.md).

반영하지 않고 남긴 Nit (전부 리포트 원문 기준, 판단 필요하거나 무해)

• 온보딩 인트로 페이저 selection 상한 클램프 — 도달 경로를 못 찾았고 실기기 검증된 코드라 재검증 없이 안 건드렸어요.
• needs…ForCreatedFeed: Binding<Bool> = .constant(false) Factory 기본값 제거 — 새 조립 지점의 배선 누락을 컴파일러가 잡게 하려면 제거가 맞지만 API 변경이라 보류.
• 작품 상세 리셋 신호에 novelID 미탑재(엉뚱한 상세가 소비해도 피해는 재조회 1회), 작성 복귀 직후 "0개의 기록" 순간 노출, cellTopYs 딕셔너리의 옛 ID 누적(무해), 상시 mount 렌더 비용(SE급 스크롤 프레임 확인 권장), tabButton 높이 44pt 미달, UnifiedFadeButtonStyle 두 번째 사용처 생기면 WSSComponent 승격.

※ Reference

• Projects/Feature/FeedFeature/CLAUDE.md 화면 동작 계약(피드 목록) — 이번 통일의 정본
• Projects/Feature/NovelDetailFeature/CLAUDE.md 로드 절 2026-09-08 재판정
• docs/TODO.md 14절 — [Feat] 앱 배선 — 스플래시 부트스트랩·강제 업데이트 알럿·세션 복원·캐시 삭제·검색 네비·크로스스크린 피드백 채널 #236 실기기 QA 목록(이번 변경 검증 시 함께 참고)

🤖 Generated with Claude Code

[github-actions]

테스트 커버리지 리포트

Module	Coverage
AuthData	55.3%
AuthDomain	98.2%
BaseDomain	70.3%
CollectionDomain	98.3%
CollectionFeature	0.0%
CommentData	0.0%
CommentDomain	94.9%
FeedData	62.8%
FeedDomain	98.6%
HomeFeature	0.0%
Keychain	0.0%
LibraryFeature	0.0%
Networking	78.0%
NotificationData	33.9%
NotificationDomain	100.0%
NotificationFeature	0.0%
NovelData	15.4%
NovelDetailFeature	0.0%
NovelDomain	92.9%
NovelReviewData	77.4%
NovelReviewDomain	96.8%
NovelReviewFeature	5.1%
ProfileData	45.7%
ProfileDomain	97.1%
RecommendationData	54.7%
RecommendationDomain	91.7%
SearchData	5.1%
SearchDomain	100.0%
SettingData	31.1%
SettingDomain	99.0%
SocialData	46.4%
SocialDomain	87.5%
SplashData	77.1%
SplashDomain	95.5%
SplashFeature	32.9%

_{Generated by CI on 2026-09-10 01:49 KST}