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