StackScout - v1.1.0

v1.1.0: Расширение источников данных, усиление аналитики и стабильности платформы

Минорный релиз StackScout после v1.0.0, сфокусированный на масштабировании платформы:
добавлены новые интеграции источников, усилены аналитические сценарии, улучшены
административные операции и повышена стабильность frontend/backend контуров.

Что сделано в этом выпуске:

Источники данных и скрейпинг

• Добавлена интеграция с новыми источниками данных (включая GitHub, GitLab, Maven Central, npm, NuGet)
• Расширена оркестрация скрейпинга для нескольких экосистем
• Улучшено управление источниками через сервисный слой и адаптеры
• Доработаны задачи скрейпинга и разрешения для корректной работы внешних интеграций

Аналитика и дашборд

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

Поиск и исследование библиотек

• Расширены фильтры поиска (включая фильтрацию по минимальному Health Score)
• Улучшены элементы управления фильтрами и их поведение в интерфейсе
• Доработан пользовательский сценарий исследования библиотек на странице Explore
• Выполнены улучшения разметки и читаемости карточек/результатов

Административная панель

• Усилены административные операции обслуживания данных
• Доработан мониторинг скрейперов (включая сценарий Resume)
• Расширена статистика в админ-разделе по библиотекам и задачам
• Улучшены UX-потоки в разделах maintenance, users и scrapers

Frontend

• Добавлены системные страницы загрузки и ошибок
• Улучшена навигация на мобильных устройствах
• Обновлены страницы Home и About: актуализирован контент и структура блоков
• Улучшены отдельные UI-компоненты (кнопки, отступы, состояние интерфейсов)

Backend

• Расширен набор сервисов для внешних интеграций
• Усилена логика обработки данных и API-эндпоинтов под новые сценарии
• Доработаны сервисные контракты для административных операций
• Повышена надежность исполнения фоновых и интеграционных операций

Infrastructure

• Обновлены команды управления Docker через pnpm
• Улучшен процесс сборки и обновления контейнеров
• Подтверждена корректная сборка и запуск сервисов в docker-compose

Документация и сопровождение

• Актуализированы ключевые документы по архитектуре и структуре проекта
• Обновлены инструкции и справочные материалы для разработки
• Выполнена чистка устаревших артефактов и служебных файлов

Исправления и оптимизации

• Исправлены дефекты в UI и административных потоках
• Улучшена обработка пограничных состояний в аналитике
• Выполнен рефакторинг отдельных модулей frontend/backend
• Повышена общая консистентность и качество кода

StackScout - v1.0.0

v1.0.0: Первый стабильный релиз - Административная панель, система подписок и расширенный функционал

Первый мажорный релиз StackScout представляет значительные улучшения платформы, включая полноценную административную панель, систему подписок и уведомлений, расширенные фильтры поиска и множество улучшений в архитектуре и пользовательском опыте.

Что сделано в этом выпуске:

Административная панель

• Полноценная админ-панель с мониторингом и управлением системой
• Управление скрейперами - мониторинг статуса, ручное сканирование пакетов, просмотр логов
• Управление библиотеками - модерация, обновление статуса, пересчет Health Score, нормализация лицензий
• Управление пользователями - просмотр, редактирование, назначение ролей, сброс паролей
• Системные настройки - централизованное управление конфигурацией
• Статистика дашборда - детальная аналитика по библиотекам, пользователям и активности системы
• Регламентные работы - автоматизированное планирование задач сканирования

Система подписок и обновлений

• Подписки на библиотеки - возможность отслеживать интересующие проекты
• Лента обновлений - страница с актуальными изменениями в подписанных библиотеках
• Управление подписками - централизованная страница для управления всеми подписками
• Компоненты интерфейса - кнопка подписки, бейдж статуса, карточки обновлений
• API интеграция - контроллеры и сервисы для работы с подписками
• БД миграции - новые таблицы для хранения подписок и обновлений

Улучшенная авторизация и безопасность

• JWT токены в cookies - безопасное хранение токенов аутентификации
• Middleware защита - автоматическая проверка токенов и прав доступа
• Система ролей - динамическое назначение ролей USER и ADMIN
• Восстановление пароля - функционал запроса и подтверждения сброса пароля
• Модальное окно входа - быстрая авторизация без перехода на отдельную страницу
• Умный редирект - автоматический возврат на предыдущую страницу после входа

Расширенная фильтрация и поиск

• Фильтры по источникам - быстрая фильтрация по PyPI, npm, Maven
• Фильтр по рейтингу - кнопка "Высокий рейтинг" для библиотек с Health Score выше 80%
• Расширенные фильтры - диалоговое окно с настройкой минимального рейтинга здоровья
• Синхронизация с URL - все фильтры сохраняются в адресной строке
• Работа с пагинацией - корректная фильтрация при переключении страниц

Метрики здоровья библиотек

• Детальные метрики - оценка актуальности, активности, репозитория и сообщества
• Визуализация данных - компоненты графиков для наглядного представления статистики
• Общий рейтинг - агрегированный Health Score на основе всех метрик
• Обновленный дизайн - улучшенное отображение метрик в деталях библиотеки

Frontend

• Обновленная навигация - меню пользователя, индикатор авторизации
• Детальная страница библиотеки - с вкладками, графиками и полной информацией
• Обзорный дашборд - статистика и ключевые показатели на главной панели
• Улучшенная пагинация - с синхронизацией состояния через URL
• Скелетоны загрузки - плавные анимации во время загрузки данных
• Кастомные тултипы - подсказки для графиков и метрик
• Обработка ошибок - улучшенные сообщения об ошибках и fallback интерфейсы
• React Suspense - оптимизация загрузки компонентов

Backend

• Обновление Spring Boot до версии 3.5.11
• Global Exception Handling для единообразной обработки ошибок
• Jackson JSR310 для работы с датами и временем
• AdminController с REST API для административных операций
• AdminService с бизнес-логикой управления системой
• PasswordResetService для восстановления паролей
• ScraperTaskService для управления заданиями сканирования
• Модульные тесты для хуков подписок и обновлений
• Расширенная валидация данных в DTO

База данных

• Flyway миграции V5-V8 - таблицы для скрейперов, подписок, токенов сброса паролей, модерации
• Индексы производительности для оптимизации запросов
• ER-диаграмма в документации для визуализации схемы
• Нормализация данных для целостности и консистентности

Infrastructure

• Оптимизация Docker - многоступенчатая сборка, уменьшенный размер образов
• Health checks для мониторинга состояния сервисов
• Обновленные CORS настройки для корректной работы frontend-backend
• Стандартизация портов PostgreSQL на 5432
• Оптимизация Redis для эффективного кэширования
• Настройка RabbitMQ для асинхронной обработки задач

Документация

• API.md обновлена с новыми endpoints для админ-панели и подписок
• ARCHITECTURE.md дополнена описанием новых компонентов системы
• DATABASE.md актуализирована с новыми таблицами и схемами
• README.md обновлен с актуальными инструкциями и требованиями
• QUICKSTART.md дополнен информацией о новых возможностях
• Postman коллекции обновлены запросами для тестирования новых API

Исправления и оптимизации

• Удалены неиспользуемые импорты и зависимости
• Рефакторинг компонентов для упрощения структуры
• Улучшена обработка null-значений
• Исправлена JSX структура в компонентах
• Оптимизированы SQL запросы
• Упрощена система уведомлений
• Очищена устаревшая документация
• Исправлены иконки в интерфейсе
• Улучшена валидация форм

Примечания:

• Миграции БД обязательны - при обновлении автоматически применятся новые таблицы
• JWT в cookies требует поддержки cookies в клиентских приложениях
• Система ролей - существующим пользователям роль ADMIN назначается вручную
• Frontend требует Node.js 20+ и pnpm для установки зависимостей
• Backend требует Java 21+ и PostgreSQL 14+ для работы
• Полная документация доступна в папке /docs проекта

StackScout - v0.1.0

v0.1.0: Запуск полнофункционального приложения - Frontend, документация и улучшения

Четвёртый релиз StackScout включает значительные обновления в инфраструктуре, добавление полнофункционального фронтенда на Next.js, расширенную документацию и множество технических улучшений в кодовой базе.

Что сделано в этом выпуске:

Frontend

• Next.js 15 приложение с современной структурой App Router
• Визуальные интерфейсы: Главная страница, дашборд анализа, раздел исследования, страница "О проекте"
• Material-UI компоненты и кастомная тема для киберпанк стиля
• Tailwind CSS 4 для стилизации и адаптивного дизайна
• API интеграция с бэкенд сервисом
• Навигация с интерактивным навбаром

Backend

• JWT аутентификация и Spring Security конфигурация
• Улучшена конфигурация ApplicationConfig, JwtAuthenticationFilter и SecurityConfig
• RabbitMQ интеграция для асинхронной обработки задач сканирования
• Redis кэширование для повышения производительности
• Коллектор сообщений (CollectorConsumer/Producer) для обработки задач из очередей
• Планировщик задач (CollectorScheduler) для автоматизации сканирования

Документация

• API.md - полная документация REST API с примерами
• ARCHITECTURE.md - детальное описание архитектуры системы и компонентов
• CONTRIBUTING.md - руководство для контрибьюторов
• DATABASE.md - документация по схеме БД и миграциям
• QUICKSTART.md - быстрое руководство по запуску приложения
• README.md (обновлён) - с актуальной информацией о стеке технологий

Infrastructure

• Docker конфигурация для контейнеризации приложения
• Docker Compose для управления PostgreSQL, Redis и RabbitMQ
• Flyway миграции (V4 - таблица пользователей)
• GitHub Actions CI/CD пайплайны (заготовки)
• Dockerfile для сборки контейнера приложения

Исправления и оптимизации

• Исправлена обработка данных из Docker Hub API
• Исправлено управление JWT токенами в AuthService
• Оптимизирована работа с БД через Spring Data JPA
• Удалены ненужные классы (SecurityProperties)
• Добавлена поддержка CORS для фронтенд приложения
• Обновлены зависимости (Material-UI, emotion, pnpm)
• Исправлена статистика в DashboardPage

Примечания:

• Релиз не меняет публичные API - все существующие endpoint'ы остаются совместимы
• Миграции БД не представляют опасности - добавлена только новая таблица usuarios
• Frontend требует Node.js 20+ и pnpm для установки зависимостей
• Backend требует Java 21 и PostgreSQL 14+ для work
• Полная документация доступна в папке /docs и в README файлах каждого модуля

StackScout - v0.0.3

v0.0.3: Обновления инфраструктуры и документации

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

Что сделано в этом выпуске:

• Инфраструктура: PostgreSQL перенастроен на стандартный порт 5432 для совместимости со средой разработки и деплоем.
• Документация: обновлена дорожная карта и список задач в README.
• Кодовая база: добавлены комментарии в исходные файлы для упрощения навигации и поддержки.

Примечания:

• Релиз не меняет публичные API.
• Миграции БД не затрагиваются.

StackScout - v0.0.2

v0.0.2: Базовые CRUD-операции и бизнес-логика

Второй релиз StackScout знаменует переход от инфраструктурного каркаса к функциональной системе. В этой версии реализованы основные операции работы с данными и ключевые сущности платформы, что превращает проект из "скелета" в полноценное работающее приложение с REST API
 

Что сделано в этом выпуске:

 

• Модели данных: Реализованы три ключевые сущности - Library (библиотеки), License (лицензии) и ScanJob (задачи сканирования) с полной JPA-разметкой и индексами для оптимизации запросов
• CRUD операции: Разработаны полнофункциональные REST контроллеры для всех сущностей с поддержкой создания, чтения, обновления и удаления данных
• Слой репозиториев: Настроены Spring Data JPA репозитории с кастомными методами поиска и фильтрации (поиск по имени, источнику, статусу, типу лицензии)
• Бизнес-логика: Реализованы сервисы с продвинутой функциональностью - пагинация, сортировка, поиск библиотек, фильтрация по "здоровью", статистика по лицензиям и задачам
• API документация: Все эндпоинты аннотированы через Swagger/OpenAPI с подробными описаниями операций и параметров
• Валидация данных: Интегрирована Bean Validation для проверки входных данных на уровне DTO
• Обработка ошибок: Настроен глобальный обработчик исключений с понятными сообщениями об ошибках
   

Реализованные эндпоинты:

 
Библиотеки (/api/v1/libraries)

• GET / - получение всех библиотек с пагинацией и сортировкой
• GET /{id} - получение библиотеки по ID

StackScout - v0.0.1

v0.0.1: Основание проекта и архитектурный каркас

Первый технический релиз StackScout. На данном этапе мы полностью подготовили инфраструктуру и среду разработки для реализации нашей платформы. Кодовая база на данный момент представляет собой "скелет" будущего приложения

Что сделано в этом выпуске:

• Структура проекта: Инициализирована база на Spring Boot 3.4.1 (Java 21) с использованием Gradle (Kotlin DSL)
• Docker-окружение: Настроены Dockerfile и docker-compose.yml для развертывания инфраструктуры (PostgreSQL, Redis, RabbitMQ). CI/CD Foundation: Настроены GitHub Actions для автоматической сборки и тестирования проекта
• Документация: Подготовлен расширенный README с описанием архитектуры, алгоритмов оценки "здоровья" библиотек и дорожной картой (Roadmap)
• Конфигурация: Настроены базовые профили приложения (dev, prod) и интеграция с H2 для быстрой разработки

Следующие шаги:

Реализация базовых CRUD-операций и запуск первого модуля сбора данных (Data Collector) для PyPI