# Studio sumber terbuka

Dashboard Studio menyediakan opsi sumber terbuka (lisensi MPL-2.0) bagi tim teknis yang memerlukan kustomisasi frontend di luar konfigurasi standar. Modifikasi UI, integrasikan dengan aplikasi yang sudah ada, atau implementasikan sistem desain kustom sambil tetap mempertahankan kemampuan analitik penuh.

### Kasus penggunaan

Skenario umum, ketika pendekatan sumber terbuka dapat berguna:

* Integrasi branding kustom dan sistem desain
* Alur kerja UI khusus untuk industri tertentu
* Analitik tertanam dalam aplikasi proprietari
* Implementasi white-label untuk mitra

### Prasyarat

| Komponen                    | Persyaratan                                            |
| --------------------------- | ------------------------------------------------------ |
| **Akses IoT Query**         | Instans aktif dengan kredensial basis data yang valid  |
| **Autentikasi**             | Token JWT dari Navixy Authentication Gateway           |
| **Lingkungan pengembangan** | Node.js 18+, npm, Git                                  |
| **Keahlian teknis**         | React, TypeScript, PostgreSQL, pengembangan web modern |

{% hint style="info" %}
Lihat [App Connect](/docs/navixy-api/user-api/backend-api/resources/commons/user/applications/app-connect.md) di dokumentasi pengembang kami untuk detail implementasi autentikasi.
{% endhint %}

## Komponen sumber terbuka

Implementasi sumber terbuka Dashboard Studio terdiri dari tiga komponen utama:

### Repositori GitHub

**Lokasi:** <https://github.com/SquareGPS/navixy-iot-query-dashboard>

Repositori ini berisi aplikasi frontend React lengkap, layanan backend Node.js, file konfigurasi, dan dokumentasi yang komprehensif. Klon repositori ini untuk pengembangan lokal atau untuk meninjau arsitektur sebelum implementasi.

### Paket npm

Distribusi yang disederhanakan untuk integrasi proyek JavaScript. Paket ini mencerminkan basis kode GitHub dengan alur instalasi npm standar. Lihat repositori [README](https://github.com/SquareGPS/navixy-iot-query-dashboard?tab=readme-ov-file#navixy-iot-query-dashboard) untuk instruksi instalasi dan versioning.

### Gateway autentikasi

Pembuatan token JWT melalui gateway autentikasi Navixy. Backend menangani manajemen sesi secara transparan. Lihat [App Connect](/docs/navixy-api/user-api/backend-api/resources/commons/user/applications/app-connect.md) di dokumentasi pengembang kami untuk detail implementasi.

## Memulai

**Langkah penyiapan:**

1. Tinjau repositori [README](https://github.com/SquareGPS/navixy-iot-query-dashboard)
2. Pastikan Anda memiliki akses IoT Query aktif
3. Instal Node.js 18+ dan npm
4. Ikuti repositori [Panduan Quick Start](https://github.com/SquareGPS/navixy-iot-query-dashboard) untuk penerapan lokal
5. Tinjau [dokumentasi arsitektur](https://github.com/SquareGPS/navixy-iot-query-dashboard/blob/main/docs/ARCHITECTURE.md) sebelum melakukan kustomisasi

### Dokumentasi dalam repositori

Repositori ini mencakup panduan lengkap untuk bekerja dengan basis kode:

| Dokumen                                                                                                       | Konten                                                     |
| ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [**ARCHITECTURE.md**](https://github.com/SquareGPS/navixy-iot-query-dashboard/blob/main/docs/ARCHITECTURE.md) | Desain sistem, struktur komponen, alur data                |
| [**DEVELOPMENT.md**](https://github.com/SquareGPS/navixy-iot-query-dashboard/blob/main/docs/DEVELOPMENT.md)   | Penyiapan lokal, standar pengkodean, pengujian, alur kerja |
| [**API.md**](https://github.com/SquareGPS/navixy-iot-query-dashboard/blob/main/docs/API.md)                   | Endpoint backend, format request/response, autentikasi     |
| [**DEPLOYMENT.md**](https://github.com/SquareGPS/navixy-iot-query-dashboard/blob/main/docs/DEPLOYMENT.md)     | Hosting produksi untuk berbagai lingkungan                 |

Semua file dokumentasi terletak di [`/docs`](https://github.com/SquareGPS/navixy-iot-query-dashboard/tree/main/docs) folder repositori. Basis kode ini menggunakan TypeScript secara menyeluruh untuk keamanan tipe dan antarmuka komponen yang jelas.

### Opsi kustomisasi

Implementasi sumber terbuka menyediakan akses frontend penuh untuk modifikasi:

{% columns %}
{% column %}
**UI dan desain**

* Pustaka komponen (warna, tipografi, spasi, pola UI)
* Integrasi sistem desain kustom
* Modifikasi tema

**Editor dashboard**

* Algoritma tata letak kustom
* Metode pengaturan panel alternatif
* Alur kerja yang disederhanakan untuk kelompok pengguna tertentu
  {% endcolumn %}

{% column %}
**Visualisasi**

* Ganti komponen bagan yang ada dengan komponen kustom
* Tambahkan jenis visualisasi baru
* Modifikasi perilaku rendering bagan

**Integrasi**

* Implementasi single sign-on
* Navigasi bersama dengan aplikasi yang sudah ada
* Tampilan analitik tertanam
  {% endcolumn %}
  {% endcolumns %}

Tinjau [`ARCHITECTURE.md`](https://github.com/SquareGPS/navixy-iot-query-dashboard/blob/main/docs/ARCHITECTURE.md) file di repositori sebelum melakukan modifikasi signifikan untuk memahami hubungan antarkomponen dan perubahan yang diperlukan.

### Kesetaraan fitur dengan versi standar

Dashboard Studio sumber terbuka mempertahankan kesetaraan fitur penuh dengan versi yang di-host oleh Navixy:

| Fitur                                          | Sumber terbuka | Standar |
| ---------------------------------------------- | -------------- | ------- |
| Editor dashboard (drag-and-drop, panel, baris) | ✓              | ✓       |
| Eksekusi SQL (keamanan, timeout, caching)      | ✓              | ✓       |
| Visualisasi (batang, pai, tabel, statistik)    | ✓              | ✓       |
| Organisasi menu (bagian, penyusunan ulang)     | ✓              | ✓       |
| Pembaruan dan fitur baru                       | ✓              | ✓       |

Repositori menerima pembaruan rutin yang selaras dengan rilis versi yang di-host. Jenis visualisasi baru, kemampuan editor, dan peningkatan performa muncul di kedua model penerapan secara simultan.

### Model dukungan dan pemeliharaan

| Tanggung jawab                  | Tim Anda | Navixy |
| ------------------------------- | -------- | ------ |
| Pembaruan inti Dashboard Studio |          | ✓      |
| Tambalan keamanan               |          | ✓      |
| Kompatibilitas API IoT Query    |          | ✓      |
| Pembaruan dokumentasi           |          | ✓      |
| Pemeliharaan kode kustom        | ✓        |        |
| Infrastruktur penerapan         | ✓        |        |
| Sinkronisasi dengan upstream    | ✓        |        |
| Pengujian setelah pembaruan     | ✓        |        |

Pantau repositori untuk rilis yang berisi perbaikan bug, tambalan keamanan, dan fitur. Uji kustomisasi Anda setelah pembaruan sebelum menerapkannya ke produksi.

{% hint style="info" %}

#### Dukungan dan bantuan

Untuk dukungan teknis dan bantuan dengan IoT Query, hubungi tim dukungan kami di <iotquery@navixy.com>.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.