> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/ru/dashboard-studio/open-source-studio.md).

# Studio с открытым исходным кодом

Разверните Dashboard Studio в своей инфраструктуре с полной настройкой фронтенда React. Сохраняйте функциональное соответствие, контролируя брендинг и дизайн

Dashboard Studio предоставляет вариант с открытым исходным кодом (лицензия MPL-2.0) для технических команд, которым нужна кастомизация фронтенда сверх стандартной настройки. Изменяйте UI, интегрируйте его с существующими приложениями или внедряйте собственные системы дизайна, сохраняя при этом полные аналитические возможности.

### Сценарии использования

Распространенные сценарии, когда подход с открытым исходным кодом может быть полезен:

* Интеграция фирменного стиля и системы дизайна по индивидуальному заказу
* Специализированные рабочие процессы UI для конкретных отраслей
* Встроенная аналитика в проприетарных приложениях
* Реализации white-label для партнеров

### Требования

| Компонент              | Требование                                                        |
| ---------------------- | ----------------------------------------------------------------- |
| **доступ к IoT Query** | Активный экземпляр с действительными учетными данными базы данных |
| **Аутентификация**     | JWT-токен из шлюза аутентификации Navixy                          |
| **Среда разработки**   | Узел.js 18+, npm, Git                                             |
| **Технические навыки** | React, TypeScript, PostgreSQL, современная веб-разработка         |

{% hint style="info" %}
См. [Подключение приложений](/docs/navixy-api/user-api/resources/commons/user/applications/app-connect.md) в нашей документации для разработчиков с подробностями реализации аутентификации.
{% endhint %}

## Компоненты с открытым исходным кодом

Открытая реализация Dashboard Studio состоит из трех основных компонентов:

### Репозиторий GitHub

**Расположение:** <https://github.com/Navixy/navixy-iot-query-dashboard>

Репозиторий содержит полное фронтенд-приложение React, серверные службы Узел.js, файлы конфигурации и подробную документацию. Клонируйте репозиторий для локальной разработки или чтобы ознакомиться с архитектурой перед реализацией.

### Пакет npm

Упрощенное распространение для интеграции в JavaScript-проект. Пакет повторяет кодовую базу GitHub с обычным процессом установки npm. См. репозиторий [README](https://github.com/Navixy/navixy-iot-query-dashboard?tab=readme-ov-file#navixy-iot-query-dashboard) для инструкций по установке и версионированию.

### Шлюз аутентификации

Генерация JWT-токена через шлюз аутентификации Navixy. Бэкенд прозрачно управляет сессиями. См. [Подключение приложений](/docs/navixy-api/user-api/resources/commons/user/applications/app-connect.md) в нашей документации для разработчиков, чтобы узнать детали реализации.

## Начало работы

**Шаги настройки:**

1. Ознакомьтесь с репозиторием [README](https://github.com/Navixy/navixy-iot-query-dashboard)
2. Убедитесь, что у вас есть активный доступ к IoT Query
3. Установите Узел.js 18+ и npm
4. Следуйте инструкциям репозитория [Руководство по быстрому старту](https://github.com/Navixy/navixy-iot-query-dashboard) для локального развертывания
5. Ознакомьтесь с [документацией по архитектуре](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/docs/ARCHITECTURE.md) перед внесением изменений

### Документация в репозитории

Репозиторий содержит подробные руководства по работе с кодовой базой:

| Документ                                                                                                   | Содержимое                                                                 |
| ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| [**ARCHITECTURE.md**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/docs/ARCHITECTURE.md) | Системное проектирование, структура компонентов, Поток данных              |
| [**DEVELOPMENT.md**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/docs/DEVELOPMENT.md)   | Локальная настройка, стандарты кодирования, тестирование, рабочие процессы |
| [**API.md**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/docs/API.md)                   | Конечные точки backend, форматы запросов/ответов, аутентификация           |
| [**DEPLOYMENT.md**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/docs/DEPLOYMENT.md)     | Размещение в production для различных сред                                 |

Все файлы документации находятся в папке репозитория [`/docs`](https://github.com/Navixy/navixy-iot-query-dashboard/tree/main/docs) Папка. Во всей кодовой базе используется TypeScript для безопасности типов и четких интерфейсов компонентов.

### Варианты настройки

Реализация с открытым исходным кодом предоставляет полный доступ к frontend для внесения изменений:

{% columns %}
{% column %}
**UI и дизайн**

* Библиотека компонентов (цвета, типографика, интервалы, шаблоны UI)
* Интеграция собственной дизайн-системы
* Изменение темы

**Редактор панели мониторинга**

* Пользовательские алгоритмы компоновки
* Альтернативные методы размещения панелей
* Упрощенные рабочие процессы для определенных групп пользователей
  {% endcolumn %}

{% column %}
**Визуализации**

* Замените существующие компоненты графиков собственными
* Добавлять новые типы визуализаций
* Изменять поведение отрисовки графиков

**Интеграция**

* Реализация единого входа
* Единая навигация с существующими приложениями
* Встроенные представления аналитики
  {% endcolumn %}
  {% endcolumns %}

Ознакомьтесь с [`ARCHITECTURE.md`](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/docs/ARCHITECTURE.md) файл в репозитории перед значительными изменениями, чтобы понять взаимосвязи компонентов и необходимые изменения.

### Паритет функций со стандартной версией

Dashboard Studio с открытым исходным кодом сохраняет полное соответствие функциям версии, размещаемой на Navixy:

| Функция                                                                      | С открытым исходным кодом | Стандартная версия |
| ---------------------------------------------------------------------------- | ------------------------- | ------------------ |
| Редактор панели мониторинга (перетаскивание, панели, строки)                 | ✓                         | ✓                  |
| Выполнение SQL (безопасность, тайм-ауты, кеширование)                        | ✓                         | ✓                  |
| Визуализации (столбчатая диаграмма, круговая диаграмма, таблица, показатель) | ✓                         | ✓                  |
| Организация меню (разделы, изменение порядка)                                | ✓                         | ✓                  |
| Обновления и новые функции                                                   | ✓                         | ✓                  |

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

### Модель поддержки и техобслуживания

| Ответственность                        | Ваша команда | Navixy |
| -------------------------------------- | ------------ | ------ |
| Основные обновления Dashboard Studio   |              | ✓      |
| Патчи безопасности                     |              | ✓      |
| Совместимость с API IoT Query          |              | ✓      |
| Обновления документации                |              | ✓      |
| Техобслуживание пользовательского кода | ✓            |        |
| Инфраструктура развертывания           | ✓            |        |
| Синхронизация с upstream               | ✓            |        |
| Тестирование после обновлений          | ✓            |        |

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

{% hint style="info" %}

#### Поддержка и помощь

По вопросам технической поддержки и помощи по IoT Query свяжитесь с нашей службой поддержки по адресу <iotquery@navixy.com>.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/analytics/ru/dashboard-studio/open-source-studio.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.