@shaykec/app-agent 1.0.5 → 1.0.7

package/templates/ios/LearnTemplate/LearnTemplate/Data/LocalStorage/LocalStorageProvider.swift

@@ -0,0 +1,325 @@
+import CoreData
+import Foundation
+
+/// Core Data–backed implementation of DataRepository.
+/// Stores learning data in a local SQLite database.
+/// Pre-seeds default data from MockDataProvider on first launch.
+///
+/// Usage: LocalStorageProvider.shared (singleton, like MockDataProvider)
+final class LocalStorageProvider: ObservableObject, DataRepository {
+    static let shared = LocalStorageProvider()
+
+    @Published var courses: [Course] = []
+    @Published var categories: [Category] = []
+    @Published var flashcardDecks: [FlashcardDeck] = []
+    @Published var leaderboardEntries: [LeaderboardEntry] = []
+    @Published var achievements: [Achievement] = []
+    @Published var userProgress: UserProgress = MockDataProvider.defaultUserProgress
+
+    private let stack: CoreDataStack
+    private var context: NSManagedObjectContext { stack.viewContext }
+    private let userProgressKey = "userProgress"
+
+    private init(stack: CoreDataStack = .shared) {
+        self.stack = stack
+        loadData()
+        self.userProgress = loadUserProgress()
+
+        // Pre-seed from MockDataProvider on first launch (empty DB)
+        if courses.isEmpty {
+            seedDefaultData()
+            loadData()
+            userProgress = loadUserProgress()
+        }
+    }
+
+    // MARK: - Data Loading
+
+    func loadData() {
+        fetchCourses()
+        fetchCategories()
+        fetchFlashcardDecks()
+        fetchLeaderboardEntries()
+        fetchAchievements()
+    }
+
+    // MARK: - Course Operations
+
+    func getCourses() -> [Course] {
+        courses
+    }
+
+    func getCourse(id: String) -> Course? {
+        courses.first { $0.id == id }
+    }
+
+    func getLessons(courseId: String) -> [Lesson] {
+        guard let course = getCourse(id: courseId) else { return [] }
+        return course.lessons
+    }
+
+    // MARK: - Quiz Operations
+
+    func getQuiz(lessonId: String) -> Quiz? {
+        // Find lesson's course and generate quiz (same as MockDataProvider)
+        for course in courses {
+            if let lesson = course.lessons.first(where: { $0.id == lessonId }) {
+                return MockDataProvider.makeQuizForLesson(lessonId: lessonId, courseId: course.id)
+            }
+        }
+        return nil
+    }
+
+    func submitQuizScore(lessonId: String, score: Double, timeSpent: Int) {
+        // Update progress based on quiz score
+        let xpEarned = AppConfig.Business.xpPerQuiz
+        var progress = userProgress
+        progress.totalXP += xpEarned
+        progress.completedLessons += 1
+        progress.averageQuizScore = (progress.averageQuizScore * Double(progress.completedLessons - 1) + score) / Double(progress.completedLessons)
+        progress.level = progress.totalXP / AppConfig.Business.levelUpThreshold
+        updateProgress(progress)
+    }
+
+    // MARK: - Flashcard Operations
+
+    func getFlashcardDecks() -> [FlashcardDeck] {
+        flashcardDecks
+    }
+
+    func updateFlashcard(deckId: String, cardId: String, difficulty: FlashcardDifficulty) {
+        guard let deckIndex = flashcardDecks.firstIndex(where: { $0.id == deckId }),
+              let cardIndex = flashcardDecks[deckIndex].cards.firstIndex(where: { $0.id == cardId }) else {
+            return
+        }
+        flashcardDecks[deckIndex].cards[cardIndex].difficulty = difficulty
+        flashcardDecks[deckIndex].cards[cardIndex].repetitions += 1
+        
+        // Update mastery
+        let masteredCards = flashcardDecks[deckIndex].cards.filter { $0.difficulty == .easy && $0.repetitions >= 3 }.count
+        flashcardDecks[deckIndex].mastery = Double(masteredCards) / Double(flashcardDecks[deckIndex].totalCards)
+        
+        // Save to Core Data
+        guard let entity = fetchFlashcardDeckEntity(byId: deckId) else { return }
+        entity.update(from: flashcardDecks[deckIndex])
+        stack.save()
+        fetchFlashcardDecks()
+    }
+
+    // MARK: - Progress Operations
+
+    func getProgress() -> UserProgress {
+        userProgress
+    }
+
+    func updateProgress(_ progress: UserProgress) {
+        userProgress = progress
+        saveUserProgress(progress)
+    }
+
+    func markLessonComplete(courseId: String, lessonId: String) {
+        guard let courseIndex = courses.firstIndex(where: { $0.id == courseId }),
+              let lessonIndex = courses[courseIndex].lessons.firstIndex(where: { $0.id == lessonId }) else {
+            return
+        }
+        courses[courseIndex].lessons[lessonIndex].isCompleted = true
+        courses[courseIndex].completedLessons += 1
+        courses[courseIndex].progress = Double(courses[courseIndex].completedLessons) / Double(courses[courseIndex].totalLessons)
+        
+        // Update in Core Data
+        guard let entity = fetchCourseEntity(byId: courseId) else { return }
+        entity.update(from: courses[courseIndex])
+        stack.save()
+        fetchCourses()
+        
+        // Update user progress
+        var progress = userProgress
+        progress.totalXP += AppConfig.Business.xpPerLesson
+        progress.completedLessons += 1
+        progress.level = progress.totalXP / AppConfig.Business.levelUpThreshold
+        if courses[courseIndex].progress >= 1.0 {
+            progress.completedCourses += 1
+        }
+        updateProgress(progress)
+    }
+
+    func updateStreak() {
+        var progress = userProgress
+        progress.currentStreak += 1
+        if progress.currentStreak > progress.longestStreak {
+            progress.longestStreak = progress.currentStreak
+        }
+        progress.totalXP += AppConfig.Business.xpPerStreak
+        updateProgress(progress)
+    }
+
+    // MARK: - Leaderboard Operations
+
+    func getLeaderboard() -> [LeaderboardEntry] {
+        leaderboardEntries.sorted { $0.rank < $1.rank }
+    }
+
+    // MARK: - Achievement Operations
+
+    func unlockAchievement(achievementId: String) {
+        guard let entity = fetchAchievementEntity(byId: achievementId) else { return }
+        entity.isUnlocked = true
+        entity.unlockedDate = Date()
+        stack.save()
+        fetchAchievements()
+    }
+
+    // MARK: - Reset
+
+    func reset() {
+        // Delete all entities
+        let entities = ["CourseEntity", "CategoryEntity", "FlashcardDeckEntity", "LeaderboardEntryEntity", "AchievementEntity"]
+        for entityName in entities {
+            let request = NSFetchRequest<NSFetchRequestResult>(entityName: entityName)
+            let deleteRequest = NSBatchDeleteRequest(fetchRequest: request)
+            _ = try? context.execute(deleteRequest)
+        }
+        // Reset UserProgress
+        UserDefaults.standard.removeObject(forKey: userProgressKey)
+        stack.save()
+        seedDefaultData()
+        loadData()
+        userProgress = loadUserProgress()
+    }
+
+    // MARK: - Private Fetch Helpers
+
+    private func fetchCourses() {
+        let request = NSFetchRequest<CourseEntity>(entityName: "CourseEntity")
+        request.sortDescriptors = [NSSortDescriptor(key: "title", ascending: true)]
+        do {
+            let entities = try context.fetch(request)
+            courses = entities.map { $0.toCourse() }
+        } catch {
+            print("[LocalStorageProvider] Failed to fetch courses: \(error.localizedDescription)")
+        }
+    }
+
+    private func fetchCategories() {
+        let request = NSFetchRequest<CategoryEntity>(entityName: "CategoryEntity")
+        request.sortDescriptors = [NSSortDescriptor(key: "name", ascending: true)]
+        do {
+            let entities = try context.fetch(request)
+            categories = entities.map { $0.toCategory() }
+        } catch {
+            print("[LocalStorageProvider] Failed to fetch categories: \(error.localizedDescription)")
+        }
+    }
+
+    private func fetchFlashcardDecks() {
+        let request = NSFetchRequest<FlashcardDeckEntity>(entityName: "FlashcardDeckEntity")
+        request.sortDescriptors = [NSSortDescriptor(key: "title", ascending: true)]
+        do {
+            let entities = try context.fetch(request)
+            flashcardDecks = entities.map { $0.toFlashcardDeck() }
+        } catch {
+            print("[LocalStorageProvider] Failed to fetch flashcard decks: \(error.localizedDescription)")
+        }
+    }
+
+    private func fetchLeaderboardEntries() {
+        let request = NSFetchRequest<LeaderboardEntryEntity>(entityName: "LeaderboardEntryEntity")
+        request.sortDescriptors = [NSSortDescriptor(key: "rank", ascending: true)]
+        do {
+            let entities = try context.fetch(request)
+            leaderboardEntries = entities.map { $0.toLeaderboardEntry() }
+        } catch {
+            print("[LocalStorageProvider] Failed to fetch leaderboard entries: \(error.localizedDescription)")
+        }
+    }
+
+    private func fetchAchievements() {
+        let request = NSFetchRequest<AchievementEntity>(entityName: "AchievementEntity")
+        request.sortDescriptors = [NSSortDescriptor(key: "title", ascending: true)]
+        do {
+            let entities = try context.fetch(request)
+            achievements = entities.map { $0.toAchievement() }
+        } catch {
+            print("[LocalStorageProvider] Failed to fetch achievements: \(error.localizedDescription)")
+        }
+    }
+
+    // MARK: - Entity Fetch Helpers
+
+    private func fetchCourseEntity(byId id: String) -> CourseEntity? {
+        let request = NSFetchRequest<CourseEntity>(entityName: "CourseEntity")
+        request.predicate = NSPredicate(format: "id == %@", id)
+        request.fetchLimit = 1
+        return try? context.fetch(request).first
+    }
+
+    private func fetchFlashcardDeckEntity(byId id: String) -> FlashcardDeckEntity? {
+        let request = NSFetchRequest<FlashcardDeckEntity>(entityName: "FlashcardDeckEntity")
+        request.predicate = NSPredicate(format: "id == %@", id)
+        request.fetchLimit = 1
+        return try? context.fetch(request).first
+    }
+
+    private func fetchAchievementEntity(byId id: String) -> AchievementEntity? {
+        let request = NSFetchRequest<AchievementEntity>(entityName: "AchievementEntity")
+        request.predicate = NSPredicate(format: "id == %@", id)
+        request.fetchLimit = 1
+        return try? context.fetch(request).first
+    }
+
+    // MARK: - Seeding
+
+    /// Seeds default data from MockDataProvider on first launch.
+    private func seedDefaultData() {
+        // Seed categories
+        for category in MockDataProvider.defaultCategories {
+            let entity = CategoryEntity(context: context)
+            entity.update(from: category)
+        }
+
+        // Seed courses (includes lessons)
+        for course in MockDataProvider.makeDefaultCourses(categories: MockDataProvider.defaultCategories) {
+            let entity = CourseEntity(context: context)
+            entity.update(from: course)
+        }
+
+        // Seed flashcard decks (includes cards)
+        for deck in MockDataProvider.defaultFlashcardDecks {
+            let entity = FlashcardDeckEntity(context: context)
+            entity.update(from: deck)
+        }
+
+        // Seed leaderboard entries
+        for entry in MockDataProvider.defaultLeaderboardEntries {
+            let entity = LeaderboardEntryEntity(context: context)
+            entity.update(from: entry)
+        }
+
+        // Seed achievements
+        for achievement in MockDataProvider.defaultAchievements {
+            let entity = AchievementEntity(context: context)
+            entity.update(from: achievement)
+        }
+
+        // Seed user progress (stored in UserDefaults)
+        saveUserProgress(MockDataProvider.defaultUserProgress)
+
+        stack.save()
+    }
+
+    // MARK: - User Progress Helpers
+
+    private func loadUserProgress() -> UserProgress {
+        guard let data = UserDefaults.standard.data(forKey: userProgressKey),
+              let progress = try? JSONDecoder().decode(UserProgress.self, from: data) else {
+            return MockDataProvider.defaultUserProgress
+        }
+        return progress
+    }
+
+    private func saveUserProgress(_ progress: UserProgress) {
+        if let data = try? JSONEncoder().encode(progress) {
+            UserDefaults.standard.set(data, forKey: userProgressKey)
+        }
+    }
+}

package/templates/ios/LearnTemplate/LearnTemplate/Features/Courses/CourseDetailView.swift

@@ -1,4 +1,5 @@
 import SwiftUI
+// EmptyStateView is in Core/Components/EmptyStateView.swift
 
 struct CourseDetailView: View {
     let course: Course
@@ -71,11 +72,15 @@ struct CourseDetailView: View {
                         .font(AppConfig.Theme.Typography.title2)
                         .padding(.horizontal)
                     
-                    ForEach(Array(course.lessons.enumerated()), id: \.element.id) { index, lesson in
-                        NavigationLink(destination: LessonPlayerView(lesson: lesson, course: course)) {
-                            LessonRow(lesson: lesson, index: index)
+                    if course.lessons.isEmpty {
+                        EmptyStateView(config: .noItems(message: "No items available yet."))
+                    } else {
+                        ForEach(Array(course.lessons.enumerated()), id: \.element.id) { index, lesson in
+                            NavigationLink(destination: LessonPlayerView(lesson: lesson, course: course)) {
+                                LessonRow(lesson: lesson, index: index)
+                            }
+                            .accessibilityIdentifier("course_detail_lesson_\(index)_row")
                         }
-                        .accessibilityIdentifier("course_detail_lesson_\(index)_row")
                     }
                 }
             }

package/templates/ios/LearnTemplate/LearnTemplate/Features/Courses/CourseListView.swift

@@ -1,4 +1,5 @@
 import SwiftUI
+// EmptyStateView is in Core/Components/EmptyStateView.swift
 
 struct CourseListView: View {
     @StateObject private var viewModel = CourseListViewModel()
@@ -39,11 +40,15 @@ struct CourseListView: View {
                         .font(AppConfig.Theme.Typography.title2)
                         .padding(.horizontal)
                     
-                    ForEach(Array(filteredCourses.enumerated()), id: \.element.id) { index, course in
-                        NavigationLink(destination: CourseDetailView(course: course)) {
-                            CourseCard(course: course)
+                    if filteredCourses.isEmpty {
+                        EmptyStateView(config: searchText.isEmpty ? .noItems(message: "No courses available yet.") : .noResults(searchQuery: searchText))
+                    } else {
+                        ForEach(Array(filteredCourses.enumerated()), id: \.element.id) { index, course in
+                            NavigationLink(destination: CourseDetailView(course: course)) {
+                                CourseCard(course: course)
+                            }
+                            .accessibilityIdentifier("course_list_course_\(index)_card")
                         }
-                        .accessibilityIdentifier("course_list_course_\(index)_card")
                     }
                 }
             }

package/templates/ios/LearnTemplate/LearnTemplate/Features/Flashcards/FlashcardView.swift

@@ -1,4 +1,5 @@
 import SwiftUI
+// EmptyStateView is in Core/Components/EmptyStateView.swift
 
 struct FlashcardView: View {
     let deck: FlashcardDeck

package/templates/ios/LearnTemplate/LearnTemplate/Features/Leaderboard/LeaderboardView.swift

@@ -1,4 +1,5 @@
 import SwiftUI
+// EmptyStateView is in Core/Components/EmptyStateView.swift
 
 struct LeaderboardView: View {
     @StateObject private var viewModel = LeaderboardViewModel()

package/templates/ios/LearnTemplate/LearnTemplate/Features/Lessons/LessonPlayerView.swift

@@ -1,4 +1,5 @@
 import SwiftUI
+// EmptyStateView is in Core/Components/EmptyStateView.swift
 
 struct LessonPlayerView: View {
     let lesson: Lesson

package/templates/ios/LearnTemplate/LearnTemplate/Features/Onboarding/OnboardingView.swift

@@ -1,4 +1,5 @@
 import SwiftUI
+// EmptyStateView is in Core/Components/EmptyStateView.swift
 
 struct OnboardingView: View {
     @EnvironmentObject var appState: AppState
@@ -7,9 +8,13 @@ struct OnboardingView: View {
     var body: some View {
         VStack(spacing: 0) {
             TabView(selection: $currentPage) {
-                ForEach(0..<AppConfig.Onboarding.slides.count, id: \.self) { index in
-                    OnboardingPage(slide: AppConfig.Onboarding.slides[index])
-                        .tag(index)
+                if AppConfig.Onboarding.slides.isEmpty {
+                    EmptyStateView(config: .noItems(message: "No items available yet."))
+                } else {
+                    ForEach(0..<AppConfig.Onboarding.slides.count, id: \.self) { index in
+                        OnboardingPage(slide: AppConfig.Onboarding.slides[index])
+                            .tag(index)
+                    }
                 }
             }
             .tabViewStyle(.page)

package/templates/ios/LearnTemplate/LearnTemplate/Features/Profile/ProfileView.swift

@@ -1,4 +1,5 @@
 import SwiftUI
+// EmptyStateView is in Core/Components/EmptyStateView.swift
 
 struct ProfileView: View {
     @StateObject private var viewModel = ProfileViewModel()

package/templates/ios/LearnTemplate/LearnTemplate/Features/Progress/ProgressDashboardView.swift

@@ -1,4 +1,5 @@
 import SwiftUI
+// EmptyStateView is in Core/Components/EmptyStateView.swift
 
 struct ProgressDashboardView: View {
     @StateObject private var viewModel = ProgressDashboardViewModel()

package/templates/ios/LearnTemplate/LearnTemplate/Features/Quiz/QuizView.swift

@@ -1,4 +1,5 @@
 import SwiftUI
+// EmptyStateView is in Core/Components/EmptyStateView.swift
 
 struct QuizView: View {
     let quiz: Quiz

package/templates/ios/LearnTemplate/LearnTemplate/Features/Settings/SettingsView.swift

@@ -1,4 +1,5 @@
 import SwiftUI
+// EmptyStateView is in Core/Components/EmptyStateView.swift
 
 struct SettingsView: View {
     @Environment(\.dismiss) var dismiss

package/templates/ios/LearnTemplate/LearnTemplate/MockData/MockDataProvider.swift

@@ -159,7 +159,7 @@ class MockDataProvider: ObservableObject, DataRepository {
         LocalPersistence.save(userProgress, filename: Self.progressKey)
     }
     
-    func unlockAchievement(_ achievementId: String) {
+    func unlockAchievement(achievementId: String) {
         if let index = achievements.firstIndex(where: { $0.id == achievementId }) {
             achievements[index].isUnlocked = true
             achievements[index].unlockedDate = Date()

package/templates/ios/LearnTemplate/LearnTemplate.xcodeproj/project.pbxproj

@@ -9,15 +9,26 @@
 /* Begin PBXBuildFile section */
 		0AC4767A169535264B30C64B /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 68E4ED3F9350CC9FAF668613 /* Assets.xcassets */; };
 		22F501EDBC6B1998510DE616 /* CourseDetailView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 5E4FE42ACCD58DB292013D10 /* CourseDetailView.swift */; };
+		23757BC9A6FFD7FDC0C6C141 /* LocalStorageProvider.swift in Sources */ = {isa = PBXBuildFile; fileRef = 367C7031E8E83F19044E63B1 /* LocalStorageProvider.swift */; };
+		3032D7772E824B2C09EC7A49 /* CategoryEntity.swift in Sources */ = {isa = PBXBuildFile; fileRef = 90E823A7431313278A8E19F7 /* CategoryEntity.swift */; };
 		34A95C681B046EE2C2E28715 /* AppConfig.swift in Sources */ = {isa = PBXBuildFile; fileRef = CE0B8D7B93D8F181B7637FF5 /* AppConfig.swift */; };
 		38850C2D16AA5E54356B68FC /* FlashcardView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 6247E9CC6A85E8F199FA04E5 /* FlashcardView.swift */; };
 		3BE95A86FCA5F7F97EC37E38 /* LearnTemplateApp.swift in Sources */ = {isa = PBXBuildFile; fileRef = 4148F3F7CAE33439E29FAC20 /* LearnTemplateApp.swift */; };
+		3C6DF34F9BBA396AAD9136D9 /* LeaderboardEntryEntity.swift in Sources */ = {isa = PBXBuildFile; fileRef = 880997FD02E7F418E27296F4 /* LeaderboardEntryEntity.swift */; };
+		3D2E0BE43BFFEA8B198DC964 /* DataRepositoryTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 48A1C69147E6DCCE57FBDDA8 /* DataRepositoryTests.swift */; };
 		3F146A2C4C61E64F943A3238 /* ProgressDashboardView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 035194D1B5B81D965A7C568F /* ProgressDashboardView.swift */; };
+		45460361CE0B827B56B21571 /* FlashcardDeckEntity.swift in Sources */ = {isa = PBXBuildFile; fileRef = 48B67327579F6EA04F876899 /* FlashcardDeckEntity.swift */; };
+		4591AB5294C394CF4B4BC27F /* CoreDataStack.swift in Sources */ = {isa = PBXBuildFile; fileRef = C259FE97B0FA43516A635F9C /* CoreDataStack.swift */; };
+		6ED712B55593B158C0FB3CA0 /* EmptyStateView.swift in Sources */ = {isa = PBXBuildFile; fileRef = F71EF994ED5F6ABFAC328D22 /* EmptyStateView.swift */; };
 		87DEFE1E34C8C4636FA83BC1 /* LocalPersistence.swift in Sources */ = {isa = PBXBuildFile; fileRef = 6CF31105D635EF2264E2D5F7 /* LocalPersistence.swift */; };
+		905311BBA548F791D5247E19 /* Strings.swift in Sources */ = {isa = PBXBuildFile; fileRef = A27EFD9AE1E3C8B50C5EF9D6 /* Strings.swift */; };
+		939556DBD054FA292CCAEF9F /* CourseEntity.swift in Sources */ = {isa = PBXBuildFile; fileRef = C4401AB97E4C4E956AEC4547 /* CourseEntity.swift */; };
 		97C016A9C1B497D3B7C57E4B /* ProfileView.swift in Sources */ = {isa = PBXBuildFile; fileRef = AEAB96CB58BAEF366162B8FE /* ProfileView.swift */; };
 		9BE8E74A96403E91E87F1FB1 /* CourseListView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 93E9BA5B3034D6058D2CCD00 /* CourseListView.swift */; };
 		A09A47F4B8782DCA2DF390E1 /* QuizView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A42FFE5DB23FCBD0D047D30D /* QuizView.swift */; };
 		A48A10F36B5B5DBBBE7D276B /* SettingsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C8CD6AB06A98340133AEF3BB /* SettingsView.swift */; };
+		AA9F95C036F51FA9EE963CFE /* DataSourceResolver.swift in Sources */ = {isa = PBXBuildFile; fileRef = 3AEF6A6A911661CECAA45315 /* DataSourceResolver.swift */; };
+		AF1FCDDF5477C7E62229C344 /* DataRepository.swift in Sources */ = {isa = PBXBuildFile; fileRef = ACAFC076A996F1C9345589C9 /* DataRepository.swift */; };
 		B8EA5859BD34B223267EF760 /* LessonPlayerView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 84F876BB041FBF04CE551359 /* LessonPlayerView.swift */; };
 		C48B218B574E231395C52A78 /* Models.swift in Sources */ = {isa = PBXBuildFile; fileRef = 13CD9F55E4F59151A2497614 /* Models.swift */; };
 		C6A64CD8D5ED92A97B7AF44A /* Colors.swift in Sources */ = {isa = PBXBuildFile; fileRef = D62C735EEFEDB1A552866B61 /* Colors.swift */; };
@@ -27,6 +38,7 @@
 		E147AC166600C1B5BEC4E467 /* ProgressRingView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 5674B38A333F2E6362C1599A /* ProgressRingView.swift */; };
 		EAF873FADAC6F030B408692A /* OnboardingView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C31E860EE0A8156D26547A49 /* OnboardingView.swift */; };
 		F29ACCC25AE6E1848E21D454 /* MockDataProviderTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 11AC0D21FBDEBF56194151A2 /* MockDataProviderTests.swift */; };
+		FBF7026ADBF2362C09AF23AE /* AchievementEntity.swift in Sources */ = {isa = PBXBuildFile; fileRef = 01D5E40C55725F9E9712BD50 /* AchievementEntity.swift */; };
 /* End PBXBuildFile section */
 
 /* Begin PBXContainerItemProxy section */
@@ -40,11 +52,16 @@
 /* End PBXContainerItemProxy section */
 
 /* Begin PBXFileReference section */
+		01D5E40C55725F9E9712BD50 /* AchievementEntity.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AchievementEntity.swift; sourceTree = "<group>"; };
 		035194D1B5B81D965A7C568F /* ProgressDashboardView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ProgressDashboardView.swift; sourceTree = "<group>"; };
 		11AC0D21FBDEBF56194151A2 /* MockDataProviderTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MockDataProviderTests.swift; sourceTree = "<group>"; };
 		13CD9F55E4F59151A2497614 /* Models.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Models.swift; sourceTree = "<group>"; };
 		3286CFBF87788D7E2D7FC024 /* LearnTemplate.app */ = {isa = PBXFileReference; includeInIndex = 0; lastKnownFileType = wrapper.application; path = LearnTemplate.app; sourceTree = BUILT_PRODUCTS_DIR; };
+		367C7031E8E83F19044E63B1 /* LocalStorageProvider.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LocalStorageProvider.swift; sourceTree = "<group>"; };
+		3AEF6A6A911661CECAA45315 /* DataSourceResolver.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DataSourceResolver.swift; sourceTree = "<group>"; };
 		4148F3F7CAE33439E29FAC20 /* LearnTemplateApp.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LearnTemplateApp.swift; sourceTree = "<group>"; };
+		48A1C69147E6DCCE57FBDDA8 /* DataRepositoryTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DataRepositoryTests.swift; sourceTree = "<group>"; };
+		48B67327579F6EA04F876899 /* FlashcardDeckEntity.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = FlashcardDeckEntity.swift; sourceTree = "<group>"; };
 		5674B38A333F2E6362C1599A /* ProgressRingView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ProgressRingView.swift; sourceTree = "<group>"; };
 		5AF3D1E4BD3066DDDDB49A30 /* ModelsTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ModelsTests.swift; sourceTree = "<group>"; };
 		5E4FE42ACCD58DB292013D10 /* CourseDetailView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CourseDetailView.swift; sourceTree = "<group>"; };
@@ -53,22 +70,30 @@
 		6CF31105D635EF2264E2D5F7 /* LocalPersistence.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LocalPersistence.swift; sourceTree = "<group>"; };
 		81F647CA3690AB61CB8AAB49 /* MockDataProvider.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MockDataProvider.swift; sourceTree = "<group>"; };
 		84F876BB041FBF04CE551359 /* LessonPlayerView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LessonPlayerView.swift; sourceTree = "<group>"; };
+		880997FD02E7F418E27296F4 /* LeaderboardEntryEntity.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LeaderboardEntryEntity.swift; sourceTree = "<group>"; };
+		90E823A7431313278A8E19F7 /* CategoryEntity.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CategoryEntity.swift; sourceTree = "<group>"; };
 		93E9BA5B3034D6058D2CCD00 /* CourseListView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CourseListView.swift; sourceTree = "<group>"; };
+		A27EFD9AE1E3C8B50C5EF9D6 /* Strings.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Strings.swift; sourceTree = "<group>"; };
 		A42FFE5DB23FCBD0D047D30D /* QuizView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = QuizView.swift; sourceTree = "<group>"; };
+		ACAFC076A996F1C9345589C9 /* DataRepository.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DataRepository.swift; sourceTree = "<group>"; };
 		AEAB96CB58BAEF366162B8FE /* ProfileView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ProfileView.swift; sourceTree = "<group>"; };
+		C259FE97B0FA43516A635F9C /* CoreDataStack.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CoreDataStack.swift; sourceTree = "<group>"; };
 		C31E860EE0A8156D26547A49 /* OnboardingView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = OnboardingView.swift; sourceTree = "<group>"; };
+		C4401AB97E4C4E956AEC4547 /* CourseEntity.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CourseEntity.swift; sourceTree = "<group>"; };
 		C8CD6AB06A98340133AEF3BB /* SettingsView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SettingsView.swift; sourceTree = "<group>"; };
 		CB1415883AAA8D53EBE1BBB0 /* LearnTemplateTests.xctest */ = {isa = PBXFileReference; includeInIndex = 0; lastKnownFileType = wrapper.cfbundle; path = LearnTemplateTests.xctest; sourceTree = BUILT_PRODUCTS_DIR; };
 		CE0B8D7B93D8F181B7637FF5 /* AppConfig.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppConfig.swift; sourceTree = "<group>"; };
 		D1D954F25533BE5C9A8AA4C5 /* LeaderboardView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LeaderboardView.swift; sourceTree = "<group>"; };
 		D62C735EEFEDB1A552866B61 /* Colors.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Colors.swift; sourceTree = "<group>"; };
 		EDAE6391195DE7FD9FF44350 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist; path = Info.plist; sourceTree = "<group>"; };
+		F71EF994ED5F6ABFAC328D22 /* EmptyStateView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = EmptyStateView.swift; sourceTree = "<group>"; };
 /* End PBXFileReference section */
 
 /* Begin PBXGroup section */
 		1330A9D81D4F869F61C7E43A /* LearnTemplateTests */ = {
 			isa = PBXGroup;
 			children = (
+				48A1C69147E6DCCE57FBDDA8 /* DataRepositoryTests.swift */,
 				11AC0D21FBDEBF56194151A2 /* MockDataProviderTests.swift */,
 				5AF3D1E4BD3066DDDDB49A30 /* ModelsTests.swift */,
 			);
@@ -118,9 +143,24 @@
 			);
 			sourceTree = "<group>";
 		};
+		5109CF146F1FD04EE986E517 /* LocalStorage */ = {
+			isa = PBXGroup;
+			children = (
+				01D5E40C55725F9E9712BD50 /* AchievementEntity.swift */,
+				90E823A7431313278A8E19F7 /* CategoryEntity.swift */,
+				C259FE97B0FA43516A635F9C /* CoreDataStack.swift */,
+				C4401AB97E4C4E956AEC4547 /* CourseEntity.swift */,
+				48B67327579F6EA04F876899 /* FlashcardDeckEntity.swift */,
+				880997FD02E7F418E27296F4 /* LeaderboardEntryEntity.swift */,
+				367C7031E8E83F19044E63B1 /* LocalStorageProvider.swift */,
+			);
+			path = LocalStorage;
+			sourceTree = "<group>";
+		};
 		56AC80BE3D4580915813288C /* Components */ = {
 			isa = PBXGroup;
 			children = (
+				F71EF994ED5F6ABFAC328D22 /* EmptyStateView.swift */,
 				5674B38A333F2E6362C1599A /* ProgressRingView.swift */,
 			);
 			path = Components;
@@ -129,7 +169,10 @@
 		65E6763EA247F5628DAC8F32 /* Data */ = {
 			isa = PBXGroup;
 			children = (
+				ACAFC076A996F1C9345589C9 /* DataRepository.swift */,
+				3AEF6A6A911661CECAA45315 /* DataSourceResolver.swift */,
 				6CF31105D635EF2264E2D5F7 /* LocalPersistence.swift */,
+				5109CF146F1FD04EE986E517 /* LocalStorage */,
 			);
 			path = Data;
 			sourceTree = "<group>";
@@ -200,6 +243,7 @@
 		A390A39A6B037353D413D432 /* Core */ = {
 			isa = PBXGroup;
 			children = (
+				A27EFD9AE1E3C8B50C5EF9D6 /* Strings.swift */,
 				56AC80BE3D4580915813288C /* Components */,
 				82B32F722DBE110E1DE269A3 /* Theme */,
 			);
@@ -347,6 +391,7 @@
 			isa = PBXSourcesBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
+				3D2E0BE43BFFEA8B198DC964 /* DataRepositoryTests.swift in Sources */,
 				F29ACCC25AE6E1848E21D454 /* MockDataProviderTests.swift in Sources */,
 				D3873DA6F624CE0978C26D10 /* ModelsTests.swift in Sources */,
 			);
@@ -356,15 +401,25 @@
 			isa = PBXSourcesBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
+				FBF7026ADBF2362C09AF23AE /* AchievementEntity.swift in Sources */,
 				34A95C681B046EE2C2E28715 /* AppConfig.swift in Sources */,
+				3032D7772E824B2C09EC7A49 /* CategoryEntity.swift in Sources */,
 				C6A64CD8D5ED92A97B7AF44A /* Colors.swift in Sources */,
+				4591AB5294C394CF4B4BC27F /* CoreDataStack.swift in Sources */,
 				22F501EDBC6B1998510DE616 /* CourseDetailView.swift in Sources */,
+				939556DBD054FA292CCAEF9F /* CourseEntity.swift in Sources */,
 				9BE8E74A96403E91E87F1FB1 /* CourseListView.swift in Sources */,
+				AF1FCDDF5477C7E62229C344 /* DataRepository.swift in Sources */,
+				AA9F95C036F51FA9EE963CFE /* DataSourceResolver.swift in Sources */,
+				6ED712B55593B158C0FB3CA0 /* EmptyStateView.swift in Sources */,
+				45460361CE0B827B56B21571 /* FlashcardDeckEntity.swift in Sources */,
 				38850C2D16AA5E54356B68FC /* FlashcardView.swift in Sources */,
+				3C6DF34F9BBA396AAD9136D9 /* LeaderboardEntryEntity.swift in Sources */,
 				DD0A7EA55EA6F51A378F94E8 /* LeaderboardView.swift in Sources */,
 				3BE95A86FCA5F7F97EC37E38 /* LearnTemplateApp.swift in Sources */,
 				B8EA5859BD34B223267EF760 /* LessonPlayerView.swift in Sources */,
 				87DEFE1E34C8C4636FA83BC1 /* LocalPersistence.swift in Sources */,
+				23757BC9A6FFD7FDC0C6C141 /* LocalStorageProvider.swift in Sources */,
 				D469867AAE6B16A5B4E2A049 /* MockDataProvider.swift in Sources */,
 				C48B218B574E231395C52A78 /* Models.swift in Sources */,
 				EAF873FADAC6F030B408692A /* OnboardingView.swift in Sources */,
@@ -373,6 +428,7 @@
 				E147AC166600C1B5BEC4E467 /* ProgressRingView.swift in Sources */,
 				A09A47F4B8782DCA2DF390E1 /* QuizView.swift in Sources */,
 				A48A10F36B5B5DBBBE7D276B /* SettingsView.swift in Sources */,
+				905311BBA548F791D5247E19 /* Strings.swift in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};

package/templates/ios/LearnTemplate/LearnTemplateTests/DataRepositoryTests.swift

@@ -0,0 +1,26 @@
+import XCTest
+@testable import LearnTemplate
+
+/// Tests that MockDataProvider conforms to DataRepository and that
+/// DataSourceResolver returns the correct implementation.
+final class DataRepositoryTests: XCTestCase {
+
+    // MARK: - DataRepository Protocol Conformance
+
+    func testMockDataProviderConformsToDataRepository() {
+        let repo: any DataRepository = MockDataProvider.shared
+        XCTAssertNotNil(repo, "MockDataProvider should conform to DataRepository")
+    }
+
+    func testDataSourceResolverReturnsMock() {
+        let repo = DataSourceResolver.repository
+        XCTAssertNotNil(repo, "DataSourceResolver should return a non-nil repository")
+        XCTAssertTrue(repo is MockDataProvider, "When active is .mock, should return MockDataProvider")
+    }
+
+    func testRepositoryLoadData() {
+        let repo: any DataRepository = MockDataProvider.shared
+        XCTAssertFalse(repo.courses.isEmpty, "courses should not be empty")
+        XCTAssertFalse(repo.categories.isEmpty, "categories should not be empty")
+    }
+}