PacketApp 📱

A modern Android application for activity management with a robust Ktor backend. PacketApp helps users organize their daily activities and tasks efficiently.

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

🚧 В разработке (Development in Progress)

О проекте 🚀

PacketApp - это Android-приложение для планирования и анализа покупок с поддержкой группового доступа, разработанное с использованием Kotlin и Jetpack Compose. Приложение поддерживает сканирование чеков, имеет WebSocket чат, а также содержит аутентификацию пользователей.

Функционал ✨

• 🔐 Аутентификация

  • Регистрация новых пользователей
  • Вход в систему
  • Сброс пароля
  • JWT-аутентификация

• 📝 Управление покупками

  • Создание новых товаров
  • Просмотр списка товаров
  • Создание групп пользователей
  • Добавление пользователей в группу
  • Просмотр истории покупок
  • Общение в чате группы

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

  • Современный дизайн с использованием Jetpack Compose
  • Адаптивный интерфейс
  • Удобная навигация

Технологии 🛠️

Технология	Описание
Kotlin	Основной язык программирования
Jetpack Compose	Современный UI-фреймворк
Ktor	Серверный фреймворк
PostgreSQL	База данных
Exposed ORM	Объектно-реляционное отображение
JWT	Аутентификация
SharedPreferences	Локальное хранение данных
Coroutines	Асинхронное программирование
Flow	Реактивное программирование

Установка ⚙️

Предварительные требования

• Android Studio Arctic Fox или новее
• JDK 11 или новее
• PostgreSQL 13 или новее

Клиентская часть (Android)

1. Клонируйте репозиторий:

git clone https://github.com/yourusername/PacketApp.git

2. Откройте проект в Android Studio

3. Синхронизируйте Gradle зависимости

4. Запустите приложение на эмуляторе или физическом устройстве

Серверная часть (Ktor)

1. Перейдите в директорию сервера:

cd server

2. Настройте базу данных PostgreSQL:

# Создайте базу данных
createdb packetapp

# Настройте переменные окружения
export DB_URL=jdbc:postgresql://localhost:5432/packetapp
export DB_USER=your_username
export DB_PASSWORD=your_password

3. Запустите сервер:

./gradlew run

API-эндпоинты 🌐

Эндпоинт	Метод	Описание
/api/auth/register	POST	Регистрация нового пользователя
/api/auth/login	POST	Вход в систему
/api/auth/reset-password	POST	Сброс пароля
/api/activities	GET	Получение списка активностей
/api/activities	POST	Создание новой активности
/api/activities/{id}	PUT	Обновление активности
/api/activities/{id}	DELETE	Удаление активности

Скриншоты 📸

Скриншоты будут добавлены позже

Будущие улучшения 🔮

• Добавить аналитику расходов
• Реализовать систему уведомлений
• Добавить интеграцию с популярными магазинами
• Реализовать систему рекомендаций
• Добавить поддержку нескольких языков
• Улучшить систему безопасности
• Добавление push-уведомлений

Контрибьютинг 🤝

Мы приветствуем вклад в развитие проекта! Чтобы внести свой вклад:

1. Форкните репозиторий
2. Создайте ветку для ваших изменений (git checkout -b feature/amazing-feature)
3. Зафиксируйте изменения (git commit -m 'Add some amazing feature')
4. Отправьте изменения в ваш форк (git push origin feature/amazing-feature)
5. Откройте Pull Request

Лицензия 📜

Этот проект распространяется под лицензией MIT. Подробности смотрите в файле LICENSE.

Контакты 📧

• GitHub: @Kovalyovv
• Email: your.email@example.com

---

_{Built with ❤️ by [Kovalyovv]}