[Feat] #132 - 작품 평가 피처 구현

[Naknakk]

💡 Issue

closed #132

💭 Summary

작품 상세에서 사용자가 작품을 평가할 수 있는 NovelReviewFeature를 새로 추가함.

이번 PR에서는 리뷰 화면의 기본 편집 흐름을 먼저 완성함. 진입 시 선택된 읽기 상태를 기준으로 기존 리뷰 초안을 불러오고, 사용자는 독서 기간·별점·매력 포인트를 수정한 뒤 저장 가능. 키워드 영역은 추후 탐색/선택 화면으로 연결하기 위한 진입 버튼까지만 배치함.

🔑 Key Changes

1. 작품 평가 화면 추가

• NovelReviewFeature 모듈을 새로 만들고, 외부에서는 NovelReviewFactory.makeView(...)만 통해 화면을 생성하도록 구성함.

2. 독서 기간 입력 흐름

• watching, watched, quit 상태별로 필요한 날짜만 부모 화면에 전달하고, 최종 ReadingPeriod 생성과 정규화는 Domain 쪽 정책에 맡김.
• 미래 날짜로 굴린 경우 스크롤 중에는 강제로 끊지 않고, 스크롤이 멈춘 뒤 직전 유효 날짜로 되돌림.
• 편집 중인 쪽을 기준으로 함. watched에서 시작이 종료를 넘으면 종료를, 종료가 시작보다 빠르면 시작을 끌어다 맞춤.

3. 저장 전 이탈 방어

• 사용자가 내용을 수정한 뒤 뒤로가기를 누르면 “그만 작성” 확인 알럿을 띄움.
• 로드 중 뒤로가기를 누르는 경우에는 로드 완료를 기다리지 않고 바로 닫음.
• 닫기 이후 늦게 도착한 로드 결과가 현재 draft나 loading 상태를 다시 덮어쓰지 않도록 loadTask 취소와 isClosing 가드 추가함.
• 로딩 화면은 루트 뷰를 교체하지 않고 overlay로 보여줌. 로드 완료 시점과 뒤로가기 dismiss가 겹칠 때 navigation pop이 취소되는 현상을 막기 위한 처리.

4. 도메인 정책과 서버 데이터 방어

• ReadingPeriod에 미래 날짜를 허용하지 않는 불변식 추가함.
• Data mapper에서도 서버에서 미래 날짜나 역전된 기간이 내려오면 조용히 보정하지 않고 매핑 실패로 처리함.
• UI 휠은 사용자 입력을 막는 1차 방어선이고, Domain 불변식은 외부 데이터까지 막는 최종 방어선 역할.

5. 공용 UI와 에러 표현

• 키워드 섹션에 사용할 WSSSearchBarButton 추가함. 실제 입력창은 아니고, 검색바처럼 보이는 탭 버튼.
• 매력 포인트 초과처럼 사용자가 정상적으로 만날 수 있는 검증 에러는 토스트로 보여줌.
• 그 외 네트워크/서버/예상 밖의 도메인 에러는 일반 에러 토스트로 묶고, 원인은 logger에 남김.
• 필요한 디자인 에셋과 토스트 타입도 함께 보강함.

6. Demo와 테스트

• NovelReviewFeature Demo 앱을 추가해 Mock 데이터와 실서버 연결을 전환하며 확인할 수 있게 함.

📱 Simulation

실서버 데모

mock 데모

🧑‍🧒‍🧒 To Reviewer

• 키워드 탐색/선택 화면 연결은 아직 포함하지 않음. 이번 PR에서는 키워드 영역 진입 버튼까지만 작업함.

※ Reference