Open-source Studio
Dashboard Studio предоставляет вариант с открытым исходным кодом (лицензия MPL-2.0) для технических команд, которым требуется настройка фронтенда за пределами стандартной конфигурации. Изменяйте интерфейс, интегрируйте с существующими приложениями или реализуйте собственные дизайн-системы, сохраняя полные аналитические возможности.
Сценарии использования
Распространённые ситуации, когда подход с открытым исходным кодом может быть полезен:
Индивидуальный брендинг и интеграция дизайн-системы
Специализированные отраслевые рабочие процессы интерфейса
Встраиваемая аналитика в проприетарные приложения
White-label реализации для партнёров
Требования
Доступ к IoT Query
Активный экземпляр с действительными учётными данными базы данных
Аутентификация
JWT-токен от Navixy Authentication Gateway
Среда разработки
Node.js 18+, npm, Git
Технические навыки
React, TypeScript, PostgreSQL, современные веб-технологии
Компоненты с открытым исходным кодом
Открытая реализация Dashboard Studio состоит из трёх основных компонентов:
Репозиторий GitHub
Расположение: https://github.com/SquareGPS/navixy-iot-query-dashboard
Репозиторий содержит полноценное React-приложение фронтенда, бэкенд-сервисы на Node.js, конфигурационные файлы и подробную документацию. Клонируйте репозиторий для локальной разработки или для изучения архитектуры перед внедрением.
npm-пакет
Упрощённое распространение для интеграции в JavaScript-проекты. Пакет повторяет кодовую базу репозитория и использует стандартный рабочий процесс установки через npm. См. репозиторий README для инструкций по установке и указаний по версиям.
Шлюз аутентификации
Генерация JWT-токенов через Navixy authentication gateway. Бэкенд прозрачно управляет сессиями. См. Authentication Gateway в нашей документации для разработчиков для деталей реализации.
Начало работы
Шаги настройки:
Изучите репозиторий README
Убедитесь, что у вас есть активный доступ к IoT Query
Установите Node.js 18+ и npm
Следуйте руководству Quick Start для локального развёртывания
Изучите документацию по архитектуре перед кастомизацией
Документация в репозитории
Репозиторий включает подробные руководства по работе с кодовой базой:
Проектирование системы, структура компонентов, поток данных
Локальная настройка, стандарты кодирования, тестирование, рабочие процессы
Бэкенд-эндпойнты, форматы запросов/ответов, аутентификация
Хостинг в продакшне для различных сред
Все файлы документации находятся в папке /docs репозитория. Во всей кодовой базе используется TypeScript для типовой безопасности и чётких интерфейсов компонентов.
Варианты кастомизации
Реализация с открытым исходным кодом предоставляет полный доступ к фронтенду для модификаций:
Интерфейс и дизайн
Библиотека компонентов (цвета, типографика, интервалы, паттерны UI)
Интеграция пользовательской дизайн‑системы
Изменения тем оформления
Редактор дашбордов
Пользовательские алгоритмы компоновки
Альтернативные методы расположения панелей
Упрощённые рабочие процессы для конкретных групп пользователей
Визуализации
Заменяйте существующие компоненты графиков на собственные
Добавляйте новые типы визуализаций
Изменяйте поведение рендеринга графиков
Интеграция
Реализация единого входа (SSO)
Общая навигация с существующими приложениями
Встраиваемые представления аналитики
Изучите ARCHITECTURE.md файл в репозитории перед значительными изменениями, чтобы понять взаимосвязи компонентов и необходимые изменения.
Паритет функционала со стандартной версией
Открытая реализация Dashboard Studio сохраняет полный паритет функциональности с версией, хостящейся у Navixy:
Редактор дашбордов (drag-and-drop, панели, строки)
✓
✓
Выполнение SQL (безопасность, тайм‑ауты, кэширование)
✓
✓
Визуализации (столбчатые, круговые, таблица, stat)
✓
✓
Организация меню (разделы, изменение порядка)
✓
✓
Обновления и новые функции
✓
✓
Репозиторий регулярно получает обновления, синхронизированные с релизами хостинговой версии. Новые типы визуализаций, возможности редактора и улучшения производительности появляются в обеих моделях развёртывания одновременно.
Модель поддержки и сопровождения
Основные обновления Dashboard Studio
✓
Исправления безопасности
✓
Совместимость с IoT Query API
✓
Обновления документации
✓
Поддержка собственного кода
✓
Инфраструктура развёртывания
✓
Синхронизация с upstream
✓
Тестирование после обновлений
✓
Отслеживайте релизы в репозитории, содержащие исправления ошибок, патчи безопасности и новые функции. Тестируйте свои кастомизации после обновлений перед развёртыванием в продакшн.
Поддержка и помощь
Для технической поддержки и помощи по IoT Query свяжитесь с нашей службой поддержки по адресу [email protected].
Последнее обновление
Это было полезно?