[리뷰] 달력 기능

[leeari95]

🗣 설명

• 모여봐요 동물의숲 특별한 이벤트가 열리는 날을 확인할 수 있는 이벤트 달력을 의미하는 듯...?

📋 체크리스트

구현해야하는 이슈 체크리스트

• 완료하지 못한 체크리스트
• 완료한 체크리스트

[leeari95]

@claude
아래 json 데이터 가지고 이벤트 달력을 만들 수 있지 않을까? 아이디어 제안해줘~
참고로 UI는 대시보드탭, 즉 메인 화면에 새롭게 섹션을 추가할 예정이야.
https://github.com/leeari95/animal-crossing/blob/release/3.0.0/json/data/Seasons%20and%20Events.json

[claude]

Claude finished @leeari95's task in 3m 49s —— View job

---

이벤트 달력 구현 아이디어 제안

• 작업 목록 생성
• JSON 데이터 구조 분석
• 대시보드 기존 코드 파악
• 아이디어 제안 작성

---

1. JSON 데이터 구조 예상

EnvironmentsVariable.repoURL 기반으로 Seasons and Events.json 파일 경로는 이미 앱에서 쓰는 패턴과 동일합니다. 예상되는 필드:

[
  {
    "name": "Bug-Off",
    "startDate": "Jun 27",
    "endDate": "Sep 27",
    "hemisphere": "Northern",
    "type": "Seasonal",
    "translations": { "kRko": "벌레잡기 대회", ... }
  }
]

첫 번째 할 일: JSON 파일을 직접 열어서 실제 필드명 확인 필요 (name, startDate, endDate, hemisphere, translations 등)

---

2. 데이터 레이어 (기존 패턴 그대로)

Request

// SeasonsAndEventsRequest.swift
struct SeasonsAndEventsRequest: APIRequest {
    typealias Response = [SeasonEventResponseDTO]
    let method: HTTPMethod = .get
    let baseURL: URL? = URL(string: EnvironmentsVariable.repoURL)
    let path: String = "Seasons and Events.json"
    var headers: [String: String]? = [:]
    var parameters: [String: String] { [:] }
}

Model

struct SeasonEvent {
    let name: String
    let startDate: String    // "Jan 1" 형식
    let endDate: String      // "Jan 31" 형식
    let hemisphere: String?  // "Northern" / "Southern" / nil(양쪽 공통)
    let translations: Translations
    
    var isActiveToday: Bool { /* 오늘 날짜가 범위 안에 있는지 */ }
    var localizedName: String { translations.localizedName() }
}

Items.shared 연동

// Items.swift에 추가
private let seasonEvents = BehaviorRelay<[SeasonEvent]>(value: [])

// 유저 반구에 맞게 필터링한 Driver
var currentSeasonEvents: Driver<[SeasonEvent]> {
    Observable.combineLatest(seasonEvents, currentUserInfo)
        .map { events, userInfo in
            events.filter { event in
                guard let hemisphere = event.hemisphere else { return true }
                return hemisphere.lowercased() == userInfo?.hemisphere.rawValue.lowercased()
            }
        }
        .asDriver(onErrorJustReturn: [])
}

---

3. UI 옵션 (3가지 제안)

Option A: 이번 달 이벤트 타임라인 카드 🌸 (추천)

달력보다 심플한 수평 스크롤 카드 리스트 형식.
오늘 진행 중인 이벤트 + 이번 달 예정 이벤트를 카드로 표시.

╔══════════════════════════════════════╗
║  🗓 이번 달 이벤트                   ║
╠══════════════════════════════════════╣
║  ┌──────────┐ ┌──────────┐           ║
║  │ 🎣       │ │ 🪲       │           ║
║  │ 낚시 대회│ │벌레잡기  │           ║
║  │ 진행 중  │ │ Jun 27   │           ║
║  │ ~Jun 30  │ │          │           ║
║  └──────────┘ └──────────┘           ║
╚══════════════════════════════════════╝

• 현재 진행 중인 이벤트: 초록 배지 "진행 중"
• 예정 이벤트: 날짜만 표시
• 탭하면 이벤트 상세 모달 (이름, 기간, 설명)

Option B: 미니 월간 달력 📅

UICalendarView (iOS 16+) 또는 커스텀 그리드로 구현.
이벤트가 있는 날에 컬러 도트 표시.

╔══════════════════════════════════════╗
║  🗓 이벤트 달력         < Jun 2025 > ║
╠══════════════════════════════════════╣
║  일  월  화  수  목  금  토           ║
║   1   2   3   4   5   6   7          ║
║   8   9  10  11  12  13  14          ║
║  15  16  17  18  19  20  21          ║
║  22  23  24  25  26  27● 28          ║
║                        ↑             ║
║                  이벤트 있음         ║
╚══════════════════════════════════════╝

• 이벤트 기간 전체를 하이라이트 (범위 선택 스타일)
• 오늘 날짜 강조 (기존 UserInfoView에서 날짜 표시 패턴 참고)
• 단점: UICalendarView는 iOS 16+ 이상만 지원

Option C: 진행 중 이벤트 배너 (가장 심플) ⚡

현재 진행 중인 이벤트가 있을 때만 나타나는 상단 배너.

╔══════════════════════════════════════╗
║  🎣 낚시 대회 진행 중! (~ Jun 30)   ║
╚══════════════════════════════════════╝

• 이벤트 없으면 섹션 자체를 숨김 (isHidden)
• 구현 제일 간단, 사용자 시선 집중에 효과적

---

4. 아키텍처 구현 계획 (Option A 기준)

기존 NpcsSectionReactor 패턴을 그대로 따릅니다:

SeasonsAndEventsRequest
    ↓
SeasonEventResponseDTO.toDomain()
    ↓
SeasonEvent (Model)
    ↓
Items.shared.currentSeasonEvents: Driver<[SeasonEvent]>
    ↓
EventCalendarSectionReactor (ReactorKit)
    ↓
EventCalendarView (UIView + RxSwift)
    ↓
SectionView("이번 달 이벤트", iconName: "calendar")

필요한 파일 목록:

파일	위치
SeasonsAndEventsRequest.swift	Networking/Request/
SeasonEventResponseDTO.swift	Networking/Response/
SeasonEvent.swift	Models/
EventCalendarSectionReactor.swift	Presentation/Dashboard/ViewModels/
EventCalendarView.swift	Presentation/Dashboard/Views/
Items.swift	기존 파일 수정
DashboardViewController.swift	기존 파일 수정

---

5. 반구(Hemisphere) 필터링

유저 정보에 이미 hemisphere 필드가 있어서, Items.shared에서 바로 필터링 가능:

// 북반구: Cherry Blossom (봄), Mushroom Season (가을)
// 남반구: 반대 계절

이벤트 데이터에 hemisphere 필드가 null이면 양쪽 공통 이벤트로 처리.

---

6. 로컬라이제이션

translations 필드를 활용해서 ko.lproj/en.lproj 추가:

"이번 달 이벤트" = "This Month's Events";
"진행 중" = "In Progress";
"예정" = "Upcoming";

---

요약 및 추천

	Option A (타임라인)	Option B (달력)	Option C (배너)
구현 복잡도	중	높음	낮음
정보량	많음	많음	적음
UX 직관성	⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐
기존 패턴 적합성	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐

Option A (수평 스크롤 이벤트 카드) 를 추천합니다. 기존 NpcsView의 수평 스크롤 패턴을 재활용할 수 있고, 이벤트 기간·진행 상태를 한눈에 파악할 수 있습니다. 실제 JSON 데이터 필드를 확인한 뒤 세부 DTO 설계를 확정하면 바로 구현에 들어갈 수 있어요!