Progress Quest

Android-приложение для управления задачами и личной продуктивностью с фокусом на ежедневный дашборд, Pomodoro и геймификацию прогресса.

Возможности

• Задачи и планирование
  • Дашборд «Сегодня»
  • Создание/редактирование задач
  • Экран планирования
  • Контекстные сущности: рабочие пространства (workspaces), представления (views), команды (teams)
• Pomodoro
  • Таймер с отдельным экраном настроек
  • Foreground service для фоновой работы таймера
• Геймификация
  • Экран прогресса, сад (garden), челленджи
• Профиль
  • Настройки, редактирование профиля, статистика
• Облако и синхронизация
  • Firebase Auth / Firestore / Cloud Functions / FCM / Storage

Технологии

• Язык / сборка
  • Kotlin
  • Gradle Kotlin DSL
  • Java 17 (jvmTarget = 17)
• UI
  • Jetpack Compose
  • Material 3
  • Navigation Compose
  • Splash Screen API
• DI / фоновые задачи
  • Hilt (+ интеграция с WorkManager)
  • WorkManager
• Данные
  • Room (KSP)
  • DataStore
• Сеть
  • Retrofit + OkHttp
  • Kotlin Serialization (+ Gson для частных случаев)
• Прочее
  • Timber (логирование)
  • Coil (изображения)
  • Vico (графики)
  • AndroidX Credentials / Google Identity Services (Credential Manager)

Требования

• Android Studio (актуальная версия)
• JDK 17
• Android SDK
  • compileSdk = 35
  • minSdk = 26

Быстрый старт

1. Открой проект в Android Studio.
2. Выполни синхронизацию Gradle (Gradle Sync).
3. Настрой Firebase:
   • Создай Firebase Project.
   • Добавь Android-приложение с applicationId:
     • com.example.progressquest
   • Скачай google-services.json и положи файл в:
     • app/google-services.json

Файл google-services.json намеренно игнорируется Git.

Сборка и запуск

• Debug APK
  • ./gradlew assembleDebug
• Установка на устройство/эмулятор
  • ./gradlew installDebug

Запуск удобнее всего выполнять из Android Studio через стандартную конфигурацию запуска.

Тесты

• Unit-тесты
  • ./gradlew test
• Инструментальные тесты
  • ./gradlew connectedAndroidTest

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

• app/ — основной Android-модуль
• app/src/main/java/com/example/progressquest/
  • app/ — точки входа приложения (Application/Activity) и контейнер Compose UI
  • core/ — базовые компоненты (DI, data, session, ui, utils)
  • feature/ — функциональные модули (auth, task, pomodoro, gamification, statistics, workspace, view, team)
  • fcm/ — интеграция Firebase Cloud Messaging
  • sync/ — задачи синхронизации/фоновые компоненты

Лицензия

MIT License — см. файл LICENSE.