История изменений¶

Список изменений, новых возможностей и исправлений ошибок в каждой версии Р13.Орбита.

[1.3.0] - 2026-01-15¶

✨ Новые возможности¶

Материализованные датасеты в ClickHouse - Датасеты теперь сохраняются как таблицы в ClickHouse для улучшенной производительности - Поддержка больших датасетов (> 1M строк) - Автоматическая очистка устаревших датасетов

Новый обработчик запросов в R7-Офис плагине - Улучшенная интеграция с Р7-Офис - Поддержка batch-запросов - Автоматическое форматирование результатов в таблицы

Заглушка инструмента "Категоризация" - Подготовка к функциональности категоризации данных - Базовая инфраструктура для ML-моделей

🔧 Улучшения¶

• Оптимизация работы с большими результатами запросов
• Улучшена стабильность при работе с несколькими LLM провайдерами
• Обновлены примеры доменов с лучшими few-shot examples

🐛 Исправления¶

• Исправлена ошибка с timeout при создании визуализаций больших датасетов
• Исправлена утечка памяти при длительной работе API сервера
• Исправлена ошибка с кодировкой при работе с русскими названиями таблиц

📦 Docker образ¶

docker pull your-registry.company.com/orbita:1.3.0

⬆️ Обновление¶

# См. инструкцию по обновлению
https://docs.orbita.company.com/maintenance/update/

Требуется миграция БД: Да

docker exec orbita alembic upgrade head

[1.2.5] - 2025-12-20¶

🐛 Исправления¶

• [Критично] Исправлена SQL injection уязвимость в обработчике пользовательских фильтров
• Исправлена ошибка с подключением к ClickHouse при использовании SSL
• Исправлена проблема с аутентификацией через Keycloak в некоторых конфигурациях

🔒 Безопасность¶

• Обновлены зависимости с критическими уязвимостями
• Улучшена валидация SQL запросов

📦 Docker образ¶

docker pull your-registry.company.com/orbita:1.2.5

⬆️ Обновление¶

Рекомендуется немедленное обновление из-за критических исправлений безопасности.

docker pull your-registry.company.com/orbita:1.2.5
docker stop orbita
docker rm orbita
docker run -d --name orbita ... your-registry.company.com/orbita:1.2.5

Требуется миграция БД: Нет

[1.2.0] - 2025-11-10¶

✨ Новые возможности¶

Поддержка множественных LLM провайдеров - Добавлена поддержка GigaChat (Сбер) - Добавлена поддержка Nebius AI Studio - Fallback между провайдерами при недоступности

Улучшенный CLI - Новый интерактивный режим с autocomplete - Цветной вывод для лучшей читаемости - Поддержка истории команд (через readline)

API rate limiting - Гибкая настройка лимитов по ролям пользователей - Redis backend для distributed rate limiting - Информативные ответы при превышении лимитов

🔧 Улучшения¶

• Оптимизирован SQL генератор для сложных JOIN запросов
• Улучшена обработка временных зон в датах
• Добавлена поддержка экспорта результатов в Excel
• Обновлен Swagger UI до версии 5.0

🐛 Исправления¶

• Исправлена ошибка с пустыми результатами при использовании LIMIT
• Исправлена проблема с визуализацией графиков с null значениями
• Исправлена ошибка с encoding при работе с нестандартными символами

📦 Docker образ¶

docker pull your-registry.company.com/orbita:1.2.0

⬆️ Обновление¶

# См. инструкцию по обновлению
https://docs.orbita.company.com/maintenance/update/

Требуется миграция БД: Да

docker exec orbita alembic upgrade head

⚠️ Breaking Changes¶

• METADATA_DB_URL теперь обязательная переменная (SQLite по умолчанию больше не используется)
• Изменен формат ответа API endpoint /api/v1/datasets (добавлено поле metadata)

[1.1.5] - 2025-10-15¶

🐛 Исправления¶

• Исправлена ошибка с подключением к PostgreSQL после рестарта
• Исправлена проблема с CORS в production окружении
• Исправлена ошибка с сохранением больших визуализаций

🔧 Улучшения¶

• Улучшена производительность при работе с большими доменами (> 100 таблиц)
• Добавлено логирование медленных SQL запросов

📦 Docker образ¶

docker pull your-registry.company.com/orbita:1.1.5

Требуется миграция БД: Нет

[1.1.0] - 2025-09-01¶

✨ Новые возможности¶

Визуализация данных - Автоматическое создание графиков из результатов запросов - Поддержка типов: столбчатый, линейный, круговой, точечный - Сохранение визуализаций в БД метаданных

Управление датасетами - Сохранение результатов запросов как именованных датасетов - Повторное использование датасетов для визуализаций - Управление датасетами через API и CLI

Telemetry и мониторинг - Интеграция с OpenTelemetry - Экспорт метрик в Prometheus - Distributed tracing через Jaeger

🔧 Улучшения¶

• Добавлена поддержка агрегационных функций в SQL генераторе
• Улучшена обработка сложных WHERE условий
• Оптимизирован connection pooling к ClickHouse

🐛 Исправления¶

• Исправлена ошибка с неправильной генерацией JOIN для связанных таблиц
• Исправлена проблема с таймаутами на длинных запросах
• Исправлена ошибка с кодировкой UTF-8 в логах

📦 Docker образ¶

docker pull your-registry.company.com/orbita:1.1.0

Требуется миграция БД: Да

⚠️ Breaking Changes¶

• Изменен формат конфигурации доменов (добавлено поле relationships)
• API endpoint /api/v1/query переименован в /api/v1/queries

[1.0.0] - 2025-07-15¶

🎉 Первый стабильный релиз¶

Основная функциональность: - Преобразование естественного языка в SQL запросы - Поддержка множественных доменов данных - REST API с OpenAPI документацией - Интерактивный CLI клиент - Поддержка ClickHouse в качестве хранилища данных - Интеграция с OpenAI, Ollama

Безопасность: - Защита от SQL injection - Аутентификация через Keycloak - RBAC (Role-Based Access Control)

Инфраструктура: - Docker образы для deployment - Docker Compose для локальной разработки - PostgreSQL для хранения метаданных

📦 Docker образ¶

docker pull your-registry.company.com/orbita:1.0.0

Поддержка версий¶

Получение обновлений¶

Как узнать о новых версиях¶

1. Email рассылка - подпишитесь на рассылку релизов
2. Корпоративный мессенджер - канал #orbita-updates
3. Проверка вручную - сравните версии

# Текущая версия
curl http://localhost:8000/health | jq '.version'

# Последняя доступная версия
curl -s https://your-registry.company.com/v2/orbita/tags/list | \
  jq -r '.tags[]' | sort -V | tail -1

Миграция между мажорными версиями¶

1.x → 2.x (когда будет доступно)¶

При выходе мажорной версии 2.0 будет предоставлен подробный гайд по миграции, включающий:

• Список breaking changes
• Пошаговую инструкцию обновления
• Скрипты миграции данных
• Период overlap support (обе версии поддерживаются параллельно)

Архив версий¶

Старые версии Docker образов хранятся в registry:

# Список всех доступных версий
curl -s https://your-registry.company.com/v2/orbita/tags/list | jq '.tags'

# Загрузить конкретную версию
docker pull your-registry.company.com/orbita:1.0.0

Формат changelog¶

Каждый релиз содержит следующие разделы:

• ✨ Новые возможности - новая функциональность
• 🔧 Улучшения - оптимизации и улучшения существующего
• 🐛 Исправления - исправления ошибок
• 🔒 Безопасность - патчи безопасности
• ⚠️ Breaking Changes - изменения, ломающие обратную совместимость
• 📦 Docker образ - команда для загрузки
• ⬆️ Обновление - инструкции по обновлению

Политика безопасности¶

Критические уязвимости¶

Критические патчи безопасности выпускаются как patch релизы (например, 1.2.5) и должны быть установлены немедленно.

Уведомления о безопасности: - Email рассылка с пометкой [SECURITY] - Срочное сообщение в корпоративном мессенджере - Подробности в changelog с тегом 🔒

CVE отслеживание¶

Все известные уязвимости отслеживаются и исправляются в соответствии с SLA:

• Критичные (CVSS 9.0-10.0) - patch в течение 48 часов
• Высокие (CVSS 7.0-8.9) - patch в течение 7 дней
• Средние (CVSS 4.0-6.9) - patch в следующем minor релизе
• Низкие (CVSS 0.1-3.9) - patch в следующем major релизе

Обратная связь¶

Если у вас есть предложения по улучшению продукта или вы обнаружили ошибку:

1. Сообщите администратору или в службу поддержки
2. Опишите проблему максимально подробно
3. Приложите логи и версию системы

# Информация для отчета об ошибке
echo "Version: $(curl -s http://localhost:8000/health | jq -r '.version')"
echo "Docker Image: $(docker inspect orbita -f '{{.Config.Image}}')"
docker logs orbita --tail 50 > orbita-error-$(date +%Y%m%d).log

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

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