[NL-68]: 번호 상세 화면 API (#44)

TTOzzi · web-flow · commit b7553130bca2 · 2025-08-17T18:47:46.000+09:00
* [NL-68]: 번호 상세 화면 API 연동

* [NL-68]: 타이머 로직 구현

* [NL-68]: footer 영역 버튼 로직 구현

* [NL-68]: navigation title 설정 로직 구현
diff --git a/Feature/Home/Sources/Home/HomeViewModel.swift b/Feature/Home/Sources/Home/HomeViewModel.swift
@@ -50,8 +50,11 @@ public final class HomeViewModel {
             with: [:])
         }
       case .recommended:
-        // TODO: 번호 상세
-        break
+        Task { @MainActor in
+          homeRouter.navigate(
+            to: HomeRoute.recommendationDetail, how: .push(hidesBottomBarWhenPushed: true),
+            with: ["shouldCreateRecommendation": false])
+        }
       case .needsResultCheck:
         // TODO: 결과
         break
diff --git a/Feature/Home/Sources/HomeAssembly.swift b/Feature/Home/Sources/HomeAssembly.swift
@@ -13,6 +13,9 @@ public final class HomeAssembly: Assembly {
     container.register(HomeService.self) { _ in
       return HomeService()
     }
+    container.register(RecommendationDetailService.self) { _ in
+      return RecommendationDetailService()
+    }
     container.register(HomeRouter.self) { _ in
       return HomeRouter()
     }
diff --git a/Feature/Home/Sources/HomeRouter.swift b/Feature/Home/Sources/HomeRouter.swift
@@ -14,7 +14,8 @@ enum HomeRoute {
 }
 
 final class HomeRouter: Routable {
-  private var factories: [HomeRoute: () -> UIViewController] = [:]
+  // TODO: 생성 시점 data 주입을 위한 구조 논의 필요
+  private var factories: [HomeRoute: ([String: Any]) -> UIViewController] = [:]
 
   public nonisolated init() {
     Task { @MainActor in
@@ -24,19 +25,20 @@ final class HomeRouter: Routable {
 
   public func setFactories() {
     self.factories = [
-      .recommendationLoading: {
+      .recommendationLoading: { _ in
         return RecommendationLoadingViewController()
       },
-      .recommendationDetail: {
-        return RecommendationDetailViewController(viewModel: RecommendationDetailViewModel())
+      .recommendationDetail: { data in
+        let shouldCreateRecommendation = data["shouldCreateRecommendation"] as? Bool
+        return RecommendationDetailViewController(viewModel: RecommendationDetailViewModel(shouldCreateRecommendation: shouldCreateRecommendation ?? true))
       },
     ]
   }
 
   public func navigate(to route: Any, how: NavigateType, with data: [String: Any]) {
     guard let homeRoute = route as? HomeRoute else { return }
     guard let factory = factories[homeRoute] else { return }
-    let viewController = factory()
+    let viewController = factory(data)
     manageViewController(viewController, how: how)
   }
 }
diff --git a/Feature/Home/Sources/HomeTarget.swift b/Feature/Home/Sources/HomeTarget.swift
@@ -21,6 +21,17 @@ enum HomeTarget {
     var headers: [String: String]? { nil }
     let userID: String
   }
+  
+  struct CreateLottoRecommendation: BaseTargetType {
+    
+    typealias Response = LottoRecommendationDTO
+
+    var path: String { "users/\(userID)/lotto-recommendation" }
+    var httpTask: HTTPTask { .requestPlain }
+    var httpMethod: HTTPMethod { .post }
+    var headers: [String: String]? { nil }
+    let userID: String
+  }
 
   struct GetUserDailyFortunes: BaseTargetType {
 
diff --git a/Feature/Home/Sources/RecommendationDetail/AIAnalysisResultCollectionViewCell.swift b/Feature/Home/Sources/RecommendationDetail/AIAnalysisResultCollectionViewCell.swift
@@ -10,7 +10,7 @@ import Extension
 import UIKit
 
 struct AIAnalysisResultCollectionViewCellModel: RecommendationDetailCellModel {
-  let description: NSAttributedString  // TODO: 확인 필요
+  let description: String
   let items: [NumberRecommendationItem]
 }
 
@@ -32,7 +32,7 @@ final class AIAnalysisResultCollectionViewCell: UICollectionViewCell {
     $0.layoutMargins = UIEdgeInsets(top: 20, left: 20, bottom: 20, right: 20)
   }
   private lazy var descriptionLabel = UILabel().then {
-    $0.style = Typography.Body_14_B
+    $0.style = Typography.Body_14_B.lineHeightMultiple(1.2)
     $0.textColor = STColors.gray1.color
     $0.numberOfLines = .zero
   }
@@ -70,7 +70,7 @@ final class AIAnalysisResultCollectionViewCell: UICollectionViewCell {
   }
 
   func update(with model: AIAnalysisResultCollectionViewCellModel) {
-    descriptionLabel.attributedText = model.description
+    descriptionLabel.styledText = model.description
 
     recommendationStackView.arrangedSubviews.forEach {
       $0.removeFromSuperview()
@@ -85,17 +85,8 @@ final class AIAnalysisResultCollectionViewCell: UICollectionViewCell {
 
 @available(iOS 17.0, *)
 #Preview {
-  let description = "콩떡님은 화(火) 기운이 강하여\n‘지존 만수르’ 예요"
-  let attributedString = NSMutableAttributedString(
-    string: description,
-    attributes: Typography.Body_14_B.color(STColors.gray1.color).attributes
-  )
-  if let range = (description as NSString).range(of: "‘지존 만수르’") as NSRange? {
-    attributedString.addAttributes(
-      Typography.Body_14_B.color(STColors.primary2.color).attributes, range: range)
-  }
   let cellModel = AIAnalysisResultCollectionViewCellModel(
-    description: attributedString,
+    description: "콩떡님은 화(火) 기운이 강하여\n‘지존 만수르’ 예요",
     items: [
       .init(title: "화(火) 기운과 잘 맞는 숫자", numbers: [9, 11]),
       .init(title: "재물운 좋을 때 잘 나오는 숫자", numbers: [24, 33]),
diff --git a/Feature/Home/Sources/RecommendationDetail/NumberRecommendationCollectionViewCell.swift b/Feature/Home/Sources/RecommendationDetail/NumberRecommendationCollectionViewCell.swift
@@ -5,6 +5,8 @@
 //  Created by ttozzi on 8/7/25.
 //
 
+import Base
+import Combine
 import DesignSystem
 import Extension
 import UIKit
@@ -13,10 +15,30 @@ struct NumberRecommendationCollectionViewCellModel: RecommendationDetailCellMode
   let roundText: String
   let title: String
   let numbers: [Int]
-  let timeUntilDraw: String  // TODO: 확인 필요
+  var secondsUntilResult: Int { // TODO: 기기 시간 설정을 바꾼 경우, 오후 8시 35분이 지났으나 서버에서 결과 조회가 준비되지 않은 경우 논의 필요
+    var calendar = Calendar(identifier: .gregorian)
+    calendar.timeZone = .current
+    calendar.locale = Locale(identifier: "ko_KR")
+    calendar.firstWeekday = 2
+    calendar.minimumDaysInFirstWeek = 4
+    
+    let now = Date()
+    guard let weekStart = calendar.date(from: calendar.dateComponents([.yearForWeekOfYear, .weekOfYear], from: now)),
+          let saturday = calendar.date(byAdding: .day, value: 5, to: weekStart),
+          let target = calendar.date(bySettingHour: 20, minute: 35, second: 0, of: saturday) else {
+      return 0
+    }
+    
+    let diff = target.timeIntervalSince(now)
+    if diff >= 0 {
+      return Int(diff)
+    }
+    let next = calendar.date(byAdding: .day, value: 7, to: target)!
+    return max(0, Int(next.timeIntervalSince(now)))
+  }
 }
 
-final class NumberRecommendationCollectionViewCell: UICollectionViewCell {
+final class NumberRecommendationCollectionViewCell: BaseCollectionViewCell {
 
   private lazy var contentStackView = UIStackView().then {
     $0.spacing = 16
@@ -47,7 +69,10 @@ final class NumberRecommendationCollectionViewCell: UICollectionViewCell {
     $0.textColor = STColors.gray1.color
     $0.textAlignment = .right
   }
-
+  private var countdownCancellable: AnyCancellable?
+  private let timerFinishedSubject = PassthroughSubject<Void, Never>()
+  var timerFinished: AnyPublisher<Void, Never> { timerFinishedSubject.eraseToAnyPublisher() }
+  
   override init(frame: CGRect) {
     super.init(frame: frame)
     setupUI()
@@ -57,6 +82,12 @@ final class NumberRecommendationCollectionViewCell: UICollectionViewCell {
     fatalError("init(coder:) has not been implemented")
   }
 
+  override func prepareForReuse() {
+    super.prepareForReuse()
+    countdownCancellable?.cancel()
+    countdownCancellable = nil
+  }
+  
   private func setupUI() {
     contentView.backgroundColor = STColors.white.color
     contentView.layer.cornerRadius = 12
@@ -109,7 +140,54 @@ final class NumberRecommendationCollectionViewCell: UICollectionViewCell {
       ball.number = String(number)
       numberBallStackView.addArrangedSubview(ball)
     }
-    timeUntilDrawLabel.styledText = model.timeUntilDraw
+    startCountdown(seconds: model.secondsUntilResult)
+  }
+  
+  private func startCountdown(seconds: Int) {
+    countdownCancellable?.cancel()
+    
+    let secs = max(0, seconds)
+    let target = Date().addingTimeInterval(TimeInterval(secs))
+    
+    countdownCancellable = Timer.publish(every: 1, on: .main, in: .common)
+      .autoconnect()
+      .handleEvents(receiveSubscription: { [weak self] _ in
+        self?.timeUntilDrawLabel.styledText = self?.countdownText(from: Int(target.timeIntervalSinceNow))
+      })
+      .map { _ in
+        return max(0, Int(target.timeIntervalSinceNow))
+      }
+      .sink { [weak self] remaining in
+        self?.timeUntilDrawLabel.styledText = self?.countdownText(from: remaining)
+        if remaining == 0 {
+          self?.countdownCancellable?.cancel()
+          self?.timeUntilDrawLabel.textColor = STColors.red3.color
+          self?.timerFinishedSubject.send(())
+        }
+      }
+  }
+  
+  private func countdownText(from seconds: Int) -> String {
+    if seconds <= 0 {
+      return "0초"
+    }
+    let d = seconds / 86_400
+    let h = (seconds % 86_400) / 3_600
+    let m = (seconds % 3_600) / 60
+    let s = seconds % 60
+    
+    var parts: [String] = []
+    if d > 0 {
+      parts.append("\(d)일")
+    }
+    if h > 0 || d > 0 {
+      parts.append("\(h)시간")
+    }
+    if m > 0 || h > 0 || d > 0 {
+      parts.append("\(m)분")
+    }
+    parts.append("\(s)초")
+    return parts.joined(separator: " ")
   }
 
   private func makeTextStackView(title: String, descriptionLabel: UILabel) -> UIStackView {
@@ -138,8 +216,7 @@ final class NumberRecommendationCollectionViewCell: UICollectionViewCell {
   let cellModel = NumberRecommendationCollectionViewCellModel(
     roundText: "1181회",
     title: "콩떡님을 위한 로또 번호 추천",
-    numbers: [9, 11, 18, 24, 33, 42],
-    timeUntilDraw: "6일 2시간 59분 32초"
+    numbers: [9, 11, 18, 24, 33, 42]
   )
   let cell = NumberRecommendationCollectionViewCell()
   cell.update(with: cellModel)
diff --git a/Feature/Home/Sources/RecommendationDetail/RecommendationDetailService.swift b/Feature/Home/Sources/RecommendationDetail/RecommendationDetailService.swift
@@ -0,0 +1,84 @@
+//
+//  RecommendationDetailService.swift
+//  Home
+//
+//  Created by ttozzi on 8/17/25.
+//
+
+import Auth
+import DIInjector
+import Foundation
+import NetworkCore
+
+struct RecommendationDetailService {
+  
+  @Injected private var userDataManager: UserDataManager
+  @Injected private var networkProvider: NetworkProvider
+  private var username: String? { userDataManager.user?.name }
+  var navigationTitle: String {
+    guard let username else {
+      return "로또 번호"
+    }
+    return "\(username)의 로또 번호"
+  }
+  
+  func createRecommendation() async throws -> [any RecommendationDetailCellModel] {
+    let target = HomeTarget.CreateLottoRecommendation(userID: userDataManager.userID)
+    let lottoRecommendation = try await networkProvider.request(target: target)
+    return try makeSections(from: lottoRecommendation)
+  }
+  
+  func fetchRecommendation() async throws -> [any RecommendationDetailCellModel] {
+    let target = HomeTarget.GetLottoRecommendation(
+      userID: userDataManager.userID)
+    let lottoRecommendation = try await networkProvider.request(target: target)
+    return try makeSections(from: lottoRecommendation)
+  }
+  
+  private func makeSections(from recommendation: LottoRecommendationDTO) throws -> [any RecommendationDetailCellModel] {
+    let title = if let username = userDataManager.user?.name {
+      "\(username)님을 위한 로또 번호 추천"
+    } else {
+      "로또 번호 추천"
+    }
+    guard let content = recommendation.content else {
+      throw NSError() // TODO: 예외 처리
+    }
+    return [
+      NumberRecommendationCollectionViewCellModel(
+        roundText: "\(recommendation.round)회",
+        title: title,
+        numbers: [
+          content.num1,
+          content.num2,
+          content.num3,
+          content.num4,
+          content.num5,
+          content.num6
+        ]
+      ),
+      AIAnalysisResultCollectionViewCellModel(
+        description: content.reason,
+        items: [
+          .init(title: "\(content.strongElement) 기운과 잘 맞는 숫자", numbers: [content.num1, content.num2]),
+          .init(title: "재물운 좋을 때 잘 나오는 숫자", numbers: [content.num3, content.num4]),
+          .init(title: "최근 자주 나온 번호", numbers: [content.num5, content.num6]),
+        ]
+      ),
+      DescriptionListCollectionViewCellModel(
+        descriptions: [
+          "요즘 많이 나오는 번호가 들어 있소",
+          "연속 숫자 3개 이상 없이 안정적인 조합이오",
+          "홀짝이 고르게 섞였소이다",
+          "끝자리가 같은 수가 한 쌍 있소",
+        ]
+      ),
+      AvoidNumberCollectionViewCellModel(
+        items: [
+          .init(title: "\(content.weakElement) 기운과\n상충하는 숫자", numbers: content.coldNums),
+          .init(title: "최근 100회 동안\n거의 안 나온 숫자", numbers: content.infrequentNums),
+        ]
+      ),
+    ]
+  }
+}
diff --git a/Feature/Home/Sources/RecommendationDetail/RecommendationDetailViewController.swift b/Feature/Home/Sources/RecommendationDetail/RecommendationDetailViewController.swift
diff --git a/Feature/Home/Sources/RecommendationDetail/RecommendationDetailViewModel.swift b/Feature/Home/Sources/RecommendationDetail/RecommendationDetailViewModel.swift
diff --git a/Feature/Home/Sources/RecommendationDetail/RecommendationLoadingViewController.swift b/Feature/Home/Sources/RecommendationDetail/RecommendationLoadingViewController.swift

Original file line number	Diff line number	Diff line change
`@@ -13,6 +13,9 @@ public final class HomeAssembly: Assembly {`
`13`	`13`	`container.register(HomeService.self) { _ in`
`14`	`14`	`return HomeService()`
`15`	`15`	`}`
	`16`	`+ container.register(RecommendationDetailService.self) { _ in`
	`17`	`+ return RecommendationDetailService()`
	`18`	`+ }`
`16`	`19`	`container.register(HomeRouter.self) { _ in`
`17`	`20`	`return HomeRouter()`
`18`	`21`	`}`