1 为什么需要 Domain 层

在传统 MVC / MVVM 中，我们往往把业务规则写进 ViewController 或 ViewModel。
问题随规模放大而爆发：

痛点	具体表现
可测试性差	单元测试必须启动 UIKit，跑真机或模拟器
业务难复用	同样的计费、权限逻辑被多处复制
维护成本高	UI 改版常常误伤业务代码

Domain 层 = 把“业务世界”的概念模型与用例流程抽离出来，形成纯 Swift 代码；UI 与外部数据存取只依赖它，却不影响它。

2 三层架构速览

层级	依赖方向	关键词
Presentation	⬇︎ 调用 UseCase	UIKit / SwiftUI / Combine / Bloc
Domain	纯 Swift	Entity•ValueObject•UseCase•Repository协议
Data / Infrastructure	⬆︎ 实现 Repository	URLSession / CoreData / Realm / BLE

依赖只允许由外向内，Domain 不感知任何框架。

3 关键概念

角色	职责	要点
Entity	有唯一标识 + 生命周期，如 `Order`	行为应遵守不变式
Value Object	无标识，靠值判等，如 `Money`	必须不可变
Use Case (Interactor)	满足用户故事的业务流程，如 `PlaceOrder`	只依赖协议
Repository 协议	Domain 访问数据的抽象	不关心具体存储方式

Place Order 意思是：下单 / 提交订单

4 Swift 代码实战

场景：展示并更新聊天未读数

4.1 Entity 与 Value Object

// Value Object
struct UnreadCount: Equatable {let value: Intinit(_ raw: Int) {precondition(raw >= 0, "Unread cannot be negative")value = raw}
}// Entity
struct Conversation: Identifiable, Equatable {let id: UUIDprivate(set) var unread: UnreadCountmutating func markAllRead() {unread = .init(0)}
}

4.2 Repository 协议

protocol ConversationRepository {/// 从缓存或网络获取未读数func unreadCount() async throws -> UnreadCount/// 将未读数持久化func save(_ count: UnreadCount) async throws
}

4.3 Use Case

/// 单一职责：获取并缓存未读数
struct GetUnreadCountUseCase {private let repo: ConversationRepositoryinit(repo: ConversationRepository) { self.repo = repo }func execute() async throws -> UnreadCount {let count = try await repo.unreadCount()try await repo.save(count)      // 读完即写缓存return count}
}

4.4 Data 层实现（摘录）

final class ConversationApiDataSource: ConversationRepository {private let api: URLSessionprivate let cache: UserDefaultsfunc unreadCount() async throws -> UnreadCount {let (data, _) = try await api.data(from: URL(string: "/unread")!)let json = try JSONDecoder().decode(UnreadDTO.self, from: data)return .init(json.total)}func save(_ count: UnreadCount) async throws {cache.set(count.value, forKey: "unread_total")}
}

4.5 Presentation 层集成

final class UnreadCubit: Cubit<UnreadState> {private let getCount: GetUnreadCountUseCaseinit(getCount: GetUnreadCountUseCase) {self.getCount = getCountsuper.init(Initial())}@MainActorfunc fetch() {Task {emit(Loading())do {let count = try await getCount.execute()emit(Loaded(count))} catch {emit(Failed(error))}}}
}

UI 只感知 UnreadState，不关心 Repository 具体实现。
想改用 Realm 缓存？仅替换 ConversationApiDataSource，Domain 与 UI 零改动。

5 单元测试策略

final class FakeConversationRepo: ConversationRepository {var next: UnreadCount = .init(3)func unreadCount() async throws -> UnreadCount { next }func save(_ count: UnreadCount) async throws { /* no-op */ }
}func testGetUnreadCount() async throws {let repo = FakeConversationRepo()let useCase = GetUnreadCountUseCase(repo: repo)let result = try await useCase.execute()XCTAssertEqual(result, .init(3))
}