feat: add 10 roadmap integration projects

Complete sample projects demonstrating framework combinations:

1. 🛒 EcommerceApp - SwiftUI + SwiftData + StoreKit 2 + PassKit + CloudKit
2. 🚴 FitTracker - SwiftUI + HealthKit + MapKit + CoreLocation + ActivityKit
3. 🤖 AIAssistant - SwiftUI + Foundation Models + App Intents + Vision
4. 📸 PhotoLab - SwiftUI + PhotosUI + Core Image + PencilKit + Vision
5. 🎮 SpaceBlast - SwiftUI + SpriteKit + Core Haptics
6. 💬 PeerChat - SwiftUI + MultipeerConnectivity + UserNotifications
7. 🏠 SmartHome - SwiftUI + Core Bluetooth + Core NFC
8. 🔐 SecureNotes - SwiftUI + SwiftData + CryptoKit + LocalAuthentication
9. 🗺️ TravelGuide - SwiftUI + MapKit + WeatherKit + EventKit
10. 📄 DocReader - SwiftUI + PDFKit + Vision + VisionKit

Each project includes:
- Complete SwiftUI app structure
- Framework integration examples
- README with learning points

Author: M1zz

roadmap-projects/AIAssistant/AIAssistant/AIAssistantApp.swift

@@ -0,0 +1,40 @@
+import SwiftUI
+
+@main
+struct AIAssistantApp: App {
+    var body: some Scene {
+        WindowGroup {
+            ContentView()
+        }
+    }
+}
+
+struct ContentView: View {
+    @State private var selectedTab = 0
+    
+    var body: some View {
+        TabView(selection: $selectedTab) {
+            ChatView()
+                .tabItem {
+                    Label("채팅", systemImage: "bubble.left.and.bubble.right")
+                }
+                .tag(0)
+            
+            ImageAnalysisView()
+                .tabItem {
+                    Label("이미지 분석", systemImage: "photo.on.rectangle.angled")
+                }
+                .tag(1)
+            
+            SettingsView()
+                .tabItem {
+                    Label("설정", systemImage: "gear")
+                }
+                .tag(2)
+        }
+    }
+}
+
+#Preview {
+    ContentView()
+}

roadmap-projects/AIAssistant/AIAssistant/Intents/ChatIntent.swift

@@ -0,0 +1,52 @@
+import AppIntents
+import FoundationModels
+
+// MARK: - Ask AI Intent
+struct AskAIIntent: AppIntent {
+    static var title: LocalizedStringResource = "AI에게 질문하기"
+    static var description = IntentDescription("AI 어시스턴트에게 질문합니다.")
+    
+    @Parameter(title: "질문", requestValueDialog: "무엇을 물어볼까요?")
+    var question: String
+    
+    static var parameterSummary: some ParameterSummary {
+        Summary("AI에게 \(\.$question) 물어보기")
+    }
+    
+    func perform() async throws -> some IntentResult & ReturnsValue<String> & ProvidesDialog {
+        // Foundation Models 사용
+        let session = LanguageModelSession()
+        
+        do {
+            let response = try await session.respond(to: question)
+            return .result(
+                value: response.content,
+                dialog: IntentDialog(stringLiteral: response.content)
+            )
+        } catch {
+            return .result(
+                value: "죄송합니다, 답변을 생성할 수 없습니다.",
+                dialog: "AI 응답 생성 중 오류가 발생했습니다."
+            )
+        }
+    }
+    
+    // Siri 제안
+    static var openAppWhenRun: Bool = false
+}
+
+// MARK: - App Shortcuts Provider
+struct AIShortcutsProvider: AppShortcutsProvider {
+    static var appShortcuts: [AppShortcut] {
+        AppShortcut(
+            intent: AskAIIntent(),
+            phrases: [
+                "AI한테 물어봐 \(.applicationName)",
+                "\(.applicationName)에서 \(\.$question) 물어봐",
+                "AI 어시스턴트한테 질문해줘 \(.applicationName)"
+            ],
+            shortTitle: "AI에게 질문",
+            systemImageName: "sparkles"
+        )
+    }
+}

roadmap-projects/AIAssistant/AIAssistant/Managers/AIManager.swift

@@ -0,0 +1,110 @@
+import Foundation
+import FoundationModels
+
+@Observable
+final class AIManager {
+    private var session: LanguageModelSession?
+    
+    private(set) var isGenerating = false
+    private(set) var currentResponse = ""
+    private(set) var isAvailable = false
+    
+    init() {
+        Task {
+            await checkAvailability()
+        }
+    }
+    
+    // MARK: - Availability Check
+    @MainActor
+    func checkAvailability() async {
+        let status = SystemLanguageModel.default.availability
+        
+        switch status {
+        case .available:
+            isAvailable = true
+        case .unavailable:
+            isAvailable = false
+        @unknown default:
+            isAvailable = false
+        }
+    }
+    
+    // MARK: - Create Session
+    @MainActor
+    func createSession(systemPrompt: String = "당신은 친절하고 도움이 되는 AI 어시스턴트입니다. 한국어로 답변해주세요.") {
+        let instructions = SystemLanguageModel.Instructions(systemPrompt)
+        session = LanguageModelSession(instructions: instructions)
+    }
+    
+    // MARK: - Send Message (Streaming)
+    @MainActor
+    func sendMessage(_ text: String) async throws -> String {
+        guard isAvailable else {
+            throw AIError.notAvailable
+        }
+        
+        if session == nil {
+            createSession()
+        }
+        
+        guard let session else {
+            throw AIError.sessionNotCreated
+        }
+        
+        isGenerating = true
+        currentResponse = ""
+        
+        defer { isGenerating = false }
+        
+        // 스트리밍 응답
+        let stream = session.streamResponse(to: text)
+        
+        for try await partial in stream {
+            currentResponse = partial.content
+        }
+        
+        return currentResponse
+    }
+    
+    // MARK: - Send Message (Non-streaming)
+    @MainActor
+    func sendMessageSync(_ text: String) async throws -> String {
+        guard isAvailable else {
+            throw AIError.notAvailable
+        }
+        
+        if session == nil {
+            createSession()
+        }
+        
+        guard let session else {
+            throw AIError.sessionNotCreated
+        }
+        
+        isGenerating = true
+        defer { isGenerating = false }
+        
+        let response = try await session.respond(to: text)
+        return response.content
+    }
+    
+    // MARK: - Reset Session
+    func resetSession() {
+        session = nil
+    }
+    
+    enum AIError: LocalizedError {
+        case notAvailable
+        case sessionNotCreated
+        
+        var errorDescription: String? {
+            switch self {
+            case .notAvailable:
+                return "AI 모델을 사용할 수 없습니다. iOS 26 이상 및 Apple Silicon이 필요합니다."
+            case .sessionNotCreated:
+                return "AI 세션을 생성할 수 없습니다."
+            }
+        }
+    }
+}

roadmap-projects/AIAssistant/AIAssistant/Managers/VisionManager.swift

@@ -0,0 +1,135 @@
+import Foundation
+import Vision
+import UIKit
+
+@Observable
+final class VisionManager {
+    private(set) var recognizedText = ""
+    private(set) var detectedObjects: [DetectedObject] = []
+    private(set) var isProcessing = false
+    
+    struct DetectedObject: Identifiable {
+        let id = UUID()
+        let label: String
+        let confidence: Float
+        let boundingBox: CGRect
+    }
+    
+    // MARK: - Text Recognition (OCR)
+    @MainActor
+    func recognizeText(from image: UIImage) async throws -> String {
+        guard let cgImage = image.cgImage else {
+            throw VisionError.invalidImage
+        }
+        
+        isProcessing = true
+        defer { isProcessing = false }
+        
+        return try await withCheckedThrowingContinuation { continuation in
+            let request = VNRecognizeTextRequest { request, error in
+                if let error {
+                    continuation.resume(throwing: error)
+                    return
+                }
+                
+                let observations = request.results as? [VNRecognizedTextObservation] ?? []
+                let text = observations.compactMap { $0.topCandidates(1).first?.string }.joined(separator: "\n")
+                
+                continuation.resume(returning: text)
+            }
+            
+            // 한국어 + 영어 인식
+            request.recognitionLanguages = ["ko-KR", "en-US"]
+            request.recognitionLevel = .accurate
+            
+            let handler = VNImageRequestHandler(cgImage: cgImage)
+            
+            do {
+                try handler.perform([request])
+            } catch {
+                continuation.resume(throwing: error)
+            }
+        }
+    }
+    
+    // MARK: - Image Classification
+    @MainActor
+    func classifyImage(_ image: UIImage) async throws -> [DetectedObject] {
+        guard let cgImage = image.cgImage else {
+            throw VisionError.invalidImage
+        }
+        
+        isProcessing = true
+        defer { isProcessing = false }
+        
+        return try await withCheckedThrowingContinuation { continuation in
+            let request = VNClassifyImageRequest { request, error in
+                if let error {
+                    continuation.resume(throwing: error)
+                    return
+                }
+                
+                let observations = request.results as? [VNClassificationObservation] ?? []
+                let objects = observations.prefix(5).map { observation in
+                    DetectedObject(
+                        label: observation.identifier,
+                        confidence: observation.confidence,
+                        boundingBox: .zero
+                    )
+                }
+                
+                continuation.resume(returning: objects)
+            }
+            
+            let handler = VNImageRequestHandler(cgImage: cgImage)
+            
+            do {
+                try handler.perform([request])
+            } catch {
+                continuation.resume(throwing: error)
+            }
+        }
+    }
+    
+    // MARK: - Face Detection
+    @MainActor
+    func detectFaces(in image: UIImage) async throws -> Int {
+        guard let cgImage = image.cgImage else {
+            throw VisionError.invalidImage
+        }
+        
+        isProcessing = true
+        defer { isProcessing = false }
+        
+        return try await withCheckedThrowingContinuation { continuation in
+            let request = VNDetectFaceRectanglesRequest { request, error in
+                if let error {
+                    continuation.resume(throwing: error)
+                    return
+                }
+                
+                let faceCount = request.results?.count ?? 0
+                continuation.resume(returning: faceCount)
+            }
+            
+            let handler = VNImageRequestHandler(cgImage: cgImage)
+            
+            do {
+                try handler.perform([request])
+            } catch {
+                continuation.resume(throwing: error)
+            }
+        }
+    }
+    
+    enum VisionError: LocalizedError {
+        case invalidImage
+        
+        var errorDescription: String? {
+            switch self {
+            case .invalidImage:
+                return "이미지를 처리할 수 없습니다."
+            }
+        }
+    }
+}