TestMe SwiftApp 🧠

Мобильное приложение для создания флеш-карточек и прохождения тестов, разработанное на SwiftUI.

Описание проекта

TestMe - это iOS приложение, которое помогает эффективно запоминать информацию с помощью техники флеш-карточек. Пользователи могут создавать свои категории, добавлять карточки с терминами и определениями, а затем тестировать свои знания в режиме викторины.

Основные функции

• 📚 Создание категорий для группировки карточек
• 🗃️ Добавление и редактирование флеш-карточек
• 🔄 Просмотр карточек в режиме карусели
• ✅ Отметка выученных карточек
• 📊 Статистика прогресса обучения
• 📝 Тестирование знаний в режиме квиза

Скриншоты приложения

Пользовательский интерфейс

Основные экраны

1. Главная (HomeView)

   • Приветственный баннер
   • Недавние категории
   • Статистика обучения

2. Категории (CategoriesView)

   • Список всех категорий
   • Создание и редактирование категорий

3. Детали категории (CategoryDetailView)

   • Список карточек в категории
   • Добавление и редактирование карточек
   • Начало квиза или просмотра в режиме карусели

4. Квиз (QuizView)

   • Интерактивные карточки с вопросами
   • Самооценка знаний (Знаю/Не знаю)
   • Результаты тестирования

5. Статистика (StatsView)

   • Общая статистика прогресса
   • История результатов квизов

Особенности реализации

• Использование UserDefaults для хранения данных
• MVVM архитектура приложения
• Кастомные компоненты UI
• Адаптивный дизайн для различных размеров экрана
• Анимации переходов между состояниями

Требования

• iOS 15.0+
• Xcode 14.0+
• Swift 5.5+

Используемые технологии

• SwiftUI
• UserDefaults (через StorageService)
• MVVM (Model-View-ViewModel)
• Combine

Структура проекта

TestMe/
├── View/
│   ├── MainView.swift
│   ├── HomeView.swift
│   ├── CategoriesView.swift
│   ├── CategoryDetailView.swift
│   ├── QuizView.swift
│   ├── StatsView.swift
│   └── Components/
│       ├── FlashcardView.swift
│       ├── CategoryCardView.swift
│       ├── FlashcardsCarouselView.swift
│       ├── FlashcardDetailView.swift
│       └── CardFieldView.swift
├── ViewModel/
│   ├── CategoryViewModel.swift
│   ├── FlashcardViewModel.swift
│   └── QuizViewModel.swift
├── Model/
│   ├── Category.swift
│   ├── Flashcard.swift
│   └── QuizResult.swift
├── Service/
│   └── StorageService.swift
├── ContentView.swift
└── TestMeApp.swift

Установка и запуск

Необходимые инструменты

1. macOS Ventura (13.0) или новее
2. Xcode 14.0 или новее
3. Git
4. Учетная запись Apple ID (для запуска на физическом устройстве)

Шаги по установке

1. Клонирование репозитория

   git clone https://github.com/berrrchik/TestMe-SwiftApp
   cd TestMe

2. Открытие проекта

   • Откройте Xcode
   • Выберите File → Open
   • Найдите склонированную папку проекта
   • Выберите файл TestMe.xcodeproj

3. Настройка проекта

   • В Xcode выберите нужный симулятор iOS или подключенное устройство

4. Запуск приложения

   • Нажмите кнопку Run (▶️) или используйте сочетание клавиш Cmd + R
   • Дождитесь завершения сборки и запуска приложения