Files
quoter/docs/features.md
Untone d6b286f478
Some checks failed
Deploy / deploy (push) Has been skipped
CI / lint (push) Failing after 7s
CI / test (push) Has been cancelled
0.5.1
2025-09-01 22:52:33 +03:00

3.5 KiB
Raw Blame History

Функциональность проекта Quoter

Основные возможности

🖼️ Обработка изображений

  • Загрузка и хранение изображений
  • Генерация thumbnail'ов различных размеров
  • Поддержка форматов: JPG, PNG, GIF, WebP, HEIC, TIFF
  • Автоматическое определение формата изображений

🔐 Аутентификация и авторизация

  • Система токенов для пользователей
  • Управление квотами загрузки (5GB на пользователя)
  • Проверка прав доступа к файлам

📁 Управление файлами

  • Загрузка файлов через multipart form data
  • Хранение в S3-совместимых хранилищах
  • Поиск файлов по паттернам
  • Кэширование списков файлов

🌐 HTTP API

  • RESTful endpoints для всех операций
  • Поддержка CORS для веб-приложений
  • Обработка ошибок с детальными сообщениями
  • Проксирование запросов к файлам

📊 Мониторинг и логирование

  • Интеграция с Sentry для отслеживания ошибок
  • Логирование всех операций
  • Метрики производительности

Технические особенности

🧪 Тестирование

  • Полное покрытие unit тестами (36 тестов)
  • Интеграционные тесты для всех компонентов
  • Моки для внешних зависимостей
  • Тесты производительности

🚀 Развертывание

  • Docker контейнеризация
  • Автоматизированный CI/CD конвейер
  • Поддержка различных окружений
  • Масштабируемая архитектура

🔧 Конфигурация

  • Гибкая настройка через переменные окружения
  • Поддержка различных S3 провайдеров
  • Настраиваемые квоты и лимиты
  • Конфигурация CORS политик

Архитектура

Модули

  • core.rs - основная бизнес-логика и GraphQL API
  • auth.rs - аутентификация и управление пользователями
  • handlers/ - HTTP обработчики запросов
  • thumbnail.rs - генерация thumbnail'ов
  • s3_utils.rs - работа с S3-совместимыми хранилищами
  • lookup.rs - поиск и определение типов файлов
  • overlay.rs - наложение водяных знаков и метаданных

Зависимости

  • Actix Web для HTTP сервера
  • Redis для кэширования
  • AWS SDK для S3 операций
  • Image crate для обработки изображений
  • Sentry для мониторинга

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

  • Основная функциональность реализована
  • Полное покрытие тестами
  • CI/CD конвейер настроен
  • Документация обновлена
  • 🚀 Готов к продакшн деплою