project-architecture

项目架构 DNA

目录结构

App/
├── Features/              # 功能模块（每个模块自包含）
│   ├── Camera/
│   │   ├── CameraVC.swift
│   │   ├── CameraViewModel.swift
│   │   ├── CameraService.swift
│   │   └── Views/
│   │       ├── CameraPreviewView.swift
│   │       └── CameraControlView.swift
│   ├── Settings/
│   │   ├── SettingsVC.swift
│   │   ├── SettingsViewModel.swift
│   │   └── SettingsService.swift
│   └── Paywall/
│       ├── PaywallVC.swift
│       ├── PaywallViewModel.swift
│       └── Views/
│           ├── PlanCardView.swift
│           └── FeatureListView.swift
├── Core/                  # 跨模块基础设施
│   ├── Network/           # API 层
│   │   ├── NetworkService.swift
│   │   ├── APIEndpoint.swift
│   │   └── NetworkError.swift
│   ├── Storage/           # 本地持久化
│   │   ├── CoreDataStack.swift
│   │   ├── KeychainStorage.swift
│   │   └── UserDefaultsStorage.swift
│   ├── Analytics/         # 埋点
│   │   └── AnalyticsManager.swift
│   └── Extensions/        # Swift 扩展
│       ├── String+Localized.swift
│       ├── UIView+Constraints.swift
│       └── UIColor+Hex.swift
├── DesignSystem/          # UI 组件库
│   ├── AppColors.swift
│   ├── AppFonts.swift
│   ├── Layout.swift
│   └── Components/        # 可复用 UI 组件
│       ├── LoadingView.swift
│       ├── EmptyStateView.swift
│       └── PrimaryButton.swift
└── Resources/
    ├── Assets.xcassets
    ├── Localizable.strings
    └── Models/            # CoreML 模型文件

---

架构模式：MVVM

View (VC + UIView)
  ↕ 绑定（closure / Combine）
ViewModel（业务逻辑 + 状态）
  ↕ 调用
Service / Repository（数据层）

• VC 职责： 初始化视图、绑定 ViewModel、响应用户事件
• ViewModel 职责： 处理业务逻辑、持有状态、调用 Service
• Service 职责： 网络请求、本地存储、设备能力（相机、麦克风）
• 禁止跨层直接调用（VC 不直接调 Service，ViewModel 不操作 UIView）

---

ViewModel 完整模板

Closure 绑定模式

import Foundation

protocol HomeViewModelProtocol {
    var onItemsUpdated: (() -> Void)? { get set }
    var onError: ((AppError) -> Void)? { get set }
    var onLoadingStateChanged: ((Bool) -> Void)? { get set }
    var items: [Item] { get }
    func loadData()
    func didSelectItem(at index: Int)
}

final class HomeViewModel: HomeViewModelProtocol {
    var onItemsUpdated: (() -> Void)?
    var onError: ((AppError) -> Void)?
    var onLoadingStateChanged: ((Bool) -> Void)?

    private(set) var items: [Item] = [] {
        didSet { onItemsUpdated?() }
    }

    private let service: ItemServiceProtocol
    private weak var navigation: HomeNavigation?

    init(service: ItemServiceProtocol, navigation: HomeNavigation) {
        self.service = service
        self.navigation = navigation
    }

    func loadData() {
        onLoadingStateChanged?(true)
        service.fetchItems { [weak self] result in
            self?.onLoadingStateChanged?(false)
            switch result {
            case .success(let items):
                self?.items = items
            case .failure(let error):
                self?.onError?(error)
            }
        }
    }

    func didSelectItem(at index: Int) {
        guard index < items.count else { return }
        navigation?.showDetail(itemID: items[index].id)
    }
}