feat: 首页改为落地页并接入登录态

IosClientKit/Sources/FeatureHome/HomeScreen.swift

@@ -5,9 +5,22 @@ import DesignSystem
 
 public struct HomeScreen: View {
     private let viewModel: HomeViewModel
+    private let onNavigateToCheckin: () -> Void
+    private let onNavigateToPlan: () -> Void
+    private let onNavigateToAuth: () -> Void
 
-    public init(viewModel: HomeViewModel) {
+    @State private var showLoginDialog = false
+
+    public init(
+        viewModel: HomeViewModel,
+        onNavigateToCheckin: @escaping () -> Void,
+        onNavigateToPlan: @escaping () -> Void,
+        onNavigateToAuth: @escaping () -> Void
+    ) {
         self.viewModel = viewModel
+        self.onNavigateToCheckin = onNavigateToCheckin
+        self.onNavigateToPlan = onNavigateToPlan
+        self.onNavigateToAuth = onNavigateToAuth
     }
 
     public var body: some View {
@@ -21,57 +34,153 @@ public struct HomeScreen: View {
         switch viewModel.uiState {
         case .loading:
             LoadingView()
-        case .empty:
-            EmptyStateView(title: "今天还没有待打卡的习惯", systemImage: "checkmark.circle")
-        case .success(let data):
-            successContent(data)
         case .error(let message):
             ErrorView(message: message) { viewModel.load() }
+        case .success(let data, let isGuest):
+            successContent(data, isGuest: isGuest)
         }
     }
 
-    private func successContent(_ data: HomeData) -> some View {
+    private func successContent(_ data: HomeData, isGuest: Bool) -> some View {
-        List {
+        ScrollView {
-            Section {
+            VStack(spacing: DS.Spacing.md) {
-                VStack(alignment: .leading, spacing: DS.Spacing.sm) {
+                HeroCard(data: data)
-                    Text(data.greeting)
+                ModuleGrid(modules: data.modules) { module in
-                        .font(.largeTitle.bold())
+                    handleModuleTap(module, isGuest: isGuest)
-                    Text(data.summary)
-                        .font(.subheadline)
-                        .foregroundStyle(.secondary)
                 }
-                .padding(.vertical, DS.Spacing.sm)
+                IntroSection(intros: data.intros)
             }
+            .padding(DS.Spacing.md)
+        }
+        .background(DS.Color.brandPaper)
+        .alert("登录提示", isPresented: $showLoginDialog) {
+            Button("取消", role: .cancel) {}
+            Button("去登录") { onNavigateToAuth() }
+        } message: {
+            Text("登录后使用此功能，是否前往登录？")
+        }
+    }
 
-            Section("今日打卡") {
+    private func handleModuleTap(_ module: HomeModule, isGuest: Bool) {
-                ForEach(data.habits) { habit in
+        if isGuest {
-                    HabitRow(habit: habit)
+            showLoginDialog = true
-                }
+            return
-            }
+        }
+        switch module.destination {
+        case .checkin: onNavigateToCheckin()
+        case .plan: onNavigateToPlan()
+        case .about: break
         }
     }
 }
 
-private struct HabitRow: View {
+// MARK: - Hero 卡
-    let habit: Habit
+
+private struct HeroCard: View {
+    let data: HomeData
 
     var body: some View {
-        HStack {
+        VStack(alignment: .leading, spacing: DS.Spacing.sm) {
-            Image(systemName: habit.isCheckedInToday ? "checkmark.circle.fill" : "circle")
+            Text(data.greeting)
-                .foregroundStyle(habit.isCheckedInToday ? DS.Color.success : DS.Color.warning)
+                .font(.caption.bold())
-                .font(.title3)
+                .foregroundStyle(DS.Color.brandLightAmber)
-            VStack(alignment: .leading, spacing: 2) {
+                .padding(.horizontal, DS.Spacing.sm)
-                Text(habit.title)
+                .padding(.vertical, DS.Spacing.xs)
-                    .font(.headline)
+                .background(DS.Color.brandGold.opacity(0.18))
-                Text(habit.detail)
+                .clipShape(Capsule())
-                    .font(.caption)
+            Text(data.displayName)
-                    .foregroundStyle(.secondary)
+                .font(.title2.bold())
-            }
+                .foregroundStyle(.white)
-            Spacer()
+            Text(data.encouragement)
-            Text("🔥 \(habit.streakDays) 天")
+                .font(.subheadline)
-                .font(.caption)
+                .foregroundStyle(DS.Color.brandCream)
-                .foregroundStyle(.secondary)
         }
-        .padding(.vertical, DS.Spacing.xs)
+        .padding(DS.Spacing.lg)
+        .frame(maxWidth: .infinity, alignment: .leading)
+        .background(DS.Gradient.hero)
+        .clipShape(RoundedRectangle(cornerRadius: 24, style: .continuous))
+    }
+}
+
+// MARK: - 模块宫格
+
+private struct ModuleGrid: View {
+    let modules: [HomeModule]
+    let onTap: (HomeModule) -> Void
+
+    private let columns = Array(repeating: GridItem(.flexible(), spacing: DS.Spacing.sm), count: 3)
+
+    var body: some View {
+        LazyVGrid(columns: columns, spacing: DS.Spacing.sm) {
+            ForEach(modules) { module in
+                ModuleItem(module: module, onTap: onTap)
+            }
+        }
+    }
+}
+
+private struct ModuleItem: View {
+    let module: HomeModule
+    let onTap: (HomeModule) -> Void
+
+    var body: some View {
+        VStack(spacing: DS.Spacing.sm) {
+            Text(module.emoji)
+                .font(.title2)
+                .frame(width: 44, height: 44)
+                .background(DS.Color.brandChip)
+                .clipShape(Circle())
+            Text(module.title)
+                .font(.footnote.bold())
+                .foregroundStyle(DS.Color.brandDark)
+            Text(module.description)
+                .font(.caption2)
+                .foregroundStyle(DS.Color.brandMuted)
+                .multilineTextAlignment(.center)
+        }
+        .frame(maxWidth: .infinity)
+        .padding(.vertical, DS.Spacing.md)
+        .background(Color.white)
+        .clipShape(RoundedRectangle(cornerRadius: 22, style: .continuous))
+        .contentShape(Rectangle())
+        .onTapGesture { onTap(module) }
+    }
+}
+
+// MARK: - 产品介绍
+
+private struct IntroSection: View {
+    let intros: [IntroCard]
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: DS.Spacing.sm) {
+            Text("产品介绍")
+                .font(.title3.bold())
+                .foregroundStyle(DS.Color.brandDark)
+            ForEach(intros, id: \.title) { intro in
+                IntroItem(intro: intro)
+            }
+        }
+        .frame(maxWidth: .infinity, alignment: .leading)
+    }
+}
+
+private struct IntroItem: View {
+    let intro: IntroCard
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: DS.Spacing.xs) {
+            Text(intro.title)
+                .font(.subheadline.bold())
+                .foregroundStyle(DS.Color.brandGold)
+            Text(intro.body)
+                .font(.subheadline)
+                .foregroundStyle(DS.Color.brandBrown)
+                .lineSpacing(4)
+        }
+        .padding(DS.Spacing.md)
+        .frame(maxWidth: .infinity, alignment: .leading)
+        .background(Color.white)
+        .clipShape(RoundedRectangle(cornerRadius: 16, style: .continuous))
     }
 }

IosClientKit/Sources/FeatureHome/HomeUiState.swift

@@ -1,9 +1,8 @@
 import CoreModel
 
-/// Kotlin: sealed interface HomeUiState → Swift: enum 关联值
+/// 首页状态（对应 Kotlin sealed interface UiState）。
 public enum HomeUiState {
     case loading
-    case success(HomeData)
+    case success(HomeData, isGuest: Bool)
-    case empty
     case error(String)
 }

IosClientKit/Sources/FeatureHome/HomeViewModel.swift

@@ -8,24 +8,47 @@ public final class HomeViewModel {
     public private(set) var uiState: HomeUiState = .loading
 
     private let homeUseCase: HomeUseCase
+    private let sessionUseCase: SessionUseCase
     private var loadTask: Task<Void, Never>?
+    private var dataTask: Task<Void, Never>?
 
-    public init(homeUseCase: HomeUseCase) {
+    public init(homeUseCase: HomeUseCase, sessionUseCase: SessionUseCase) {
         self.homeUseCase = homeUseCase
+        self.sessionUseCase = sessionUseCase
     }
 
     public func load() {
-        // flatMapLatest 的等价：新 load 前先取消旧的观察。
+        // flatMapLatest 的等价：登录态变化时重新订阅对应数据源。
         loadTask?.cancel()
         loadTask = Task { [weak self] in
             guard let self else { return }
-            self.uiState = .loading
             do {
-                for try await data in self.homeUseCase.observeHome() {
+                for try await isLoggedIn in self.sessionUseCase.observeIsLoggedIn() {
-                    self.uiState = data.habits.isEmpty ? .empty : .success(data)
+                    self.reload(isLoggedIn: isLoggedIn)
+                }
+            } catch is CancellationError {
+            } catch {
+                self.uiState = .error(error.localizedDescription)
+            }
+        }
+    }
+
+    private func reload(isLoggedIn: Bool) {
+        dataTask?.cancel()
+        uiState = .loading
+        dataTask = Task { [weak self] in
+            guard let self else { return }
+            do {
+                if isLoggedIn {
+                    for try await data in self.homeUseCase.observeHome() {
+                        self.uiState = .success(data, isGuest: false)
+                    }
+                } else {
+                    for try await data in self.homeUseCase.observeGuestHome() {
+                        self.uiState = .success(data, isGuest: true)
+                    }
                 }
             } catch is CancellationError {
-                // 被更新的 load() 取代，保持当前状态即可。
             } catch {
                 self.uiState = .error(error.localizedDescription)
             }