ios-client/docs/architecture.md

架构

分层与依赖

依赖单向无环：App → feature/* → core/*，App 额外依赖 CoreRepository 装配具体实现。

App ──► FeatureHome / FeatureCheckin / FeaturePlan / FeatureProfile / FeatureAuth
         │
         └──► CoreDomain（协议 + UseCase）──► CoreModel
                ▲
                └── CoreRepository（Fake* 实现）

• CoreModel：领域模型，Sendable 值类型，叶子不依赖任何模块。
• CoreDomain：Repository 协议 + UseCase，纯 Swift（不 import SwiftUI / 数据框架）。
• CoreRepository：Fake 实现（当前），未来替换为 OfflineFirst（编排 CoreNetwork / CoreDatabase）。

数据流（MVVM 单向）

Screen(.task) ──► ViewModel.load() ──► UseCase ──► Repository（AsyncThrowingStream）
       ▲                                          │
       └────────── uiState（@Observable）◄──── yield

• ViewModel：@MainActor @Observable final class，private(set) var uiState。
• UiState：enum 关联值（对应 Kotlin sealed interface）。
• 每次 load() 先 loadTask?.cancel() 再开新 Task，实现 flatMapLatest 语义。

会话 / 登录态

SessionRepository 持进程内登录态（Fake 用 Combine CurrentValueSubject<Bool, Never>），AppContainer 持单例注入所有 ViewModel。

• 外层 Task 观察 observeIsLoggedIn()；登录态变化 → 取消内层数据 Task → 重新订阅。
• Home：已登录 observeHome()（isGuest=false）/ 游客 observeGuestHome()（isGuest=true），无 loggedOut 态（游客落地页即未登录首页）。
• checkin / plan / profile：登录态 false → .loggedOut；true → .loading → 数据。

Feature 一览

Feature	UiState	数据源（Repository）
FeatureHome	loading / success(HomeData, isGuest) / error	observeHome / observeGuestHome
FeatureCheckin	loading / success(CheckinRecord) / loggedOut / error	observeCheckin + submitCheckin
FeaturePlan	loading / success(PlanRecord) / loggedOut / error	observePlan（+ observePlanSubmit / savePlan）
FeatureProfile	loading / success(UserProfile) / loggedOut / error	observeProfile
FeatureAuth	表单态（isSendingCode / countdownSeconds / isSubmitting / errorMessage）	requestSmsCode / login

设计 tokens

品牌色 / 状态色 / 渐变定义在 DesignSystem/DesignTokens.swift（DS.Color / DS.Gradient），对齐 wechat-clock-mini / android-client 的 designsystem。