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

Lihat App Connect di dokumentasi pengembang kami untuk detail implementasi autentikasi.

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 untuk instruksi instalasi dan versioning.

Gateway autentikasi

Pembuatan token JWT melalui gateway autentikasi Navixy. Backend menangani manajemen sesi secara transparan. Lihat App Connect di dokumentasi pengembang kami untuk detail implementasi.

Memulai

Langkah penyiapan:

1. Tinjau repositori README

2. Pastikan Anda memiliki akses IoT Query aktif

3. Instal Node.js 18+ dan npm

4. Ikuti repositori Panduan Quick Start untuk penerapan lokal

5. Tinjau dokumentasi arsitektur sebelum melakukan kustomisasi

Dokumentasi dalam repositori

Repositori ini mencakup panduan lengkap untuk bekerja dengan basis kode:

Dokumen	Konten
ARCHITECTURE.md	Desain sistem, struktur komponen, alur data
DEVELOPMENT.md	Penyiapan lokal, standar pengkodean, pengujian, alur kerja
API.md	Endpoint backend, format request/response, autentikasi
DEPLOYMENT.md	Hosting produksi untuk berbagai lingkungan

Semua file dokumentasi terletak di /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:

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

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

Tinjau 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.

Dukungan dan bantuan

Untuk dukungan teknis dan bantuan dengan IoT Query, hubungi tim dukungan kami di [e-mail].