Studio sumber terbuka

Dashboard Studio menyediakan opsi open-source (lisensi MPL-2.0) untuk tim teknis yang memerlukan kustomisasi frontend di luar konfigurasi standar. Modifikasi UI, integrasikan dengan aplikasi yang ada, atau terapkan sistem desain kustom sambil mempertahankan kemampuan analitik penuh.

Kasus penggunaan

Skenario umum ketika pendekatan open-source dapat berguna:

• Branding kustom dan integrasi sistem desain

• Alur kerja UI khusus industri

• Analitik tersemat dalam aplikasi kepemilikan

• Implementasi white-label untuk mitra

Prasyarat

Komponen	Persyaratan
Akses IoT Query	Instance aktif dengan kredensial database yang valid
Autentikasi	Token JWT dari Navixy Authentication Gateway
Lingkungan pengembangan	Node.js 18+, npm, Git
Keterampilan teknis	React, TypeScript, PostgreSQL, pengembangan web modern

Lihat App Connect dalam dokumentasi pengembang kami untuk rincian implementasi autentikasi.

Komponen open-source

Implementasi open-source Dashboard Studio terdiri dari tiga komponen utama:

Repositori GitHub

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

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

Paket npm

Distribusi yang disederhanakan untuk integrasi proyek JavaScript. Paket mencerminkan basis kode GitHub dengan alur instalasi npm standar. Lihat repositori README untuk instruksi instalasi dan penomoran versi.

Gateway autentikasi

Generasi token JWT melalui gateway autentikasi Navixy. Backend menangani manajemen sesi secara transparan. Lihat App Connect dalam dokumentasi pengembang kami untuk rincian implementasi.

Memulai

Langkah pengaturan:

1. Tinjau repositori README

2. Pastikan Anda memiliki akses IoT Query yang aktif

3. Pasang Node.js 18+ dan npm

4. Ikuti panduan Quick Start repositori untuk penyebaran lokal

5. Tinjau dokumentasi arsitektur sebelum melakukan kustomisasi

Dokumentasi dalam repositori

Repositori menyertakan panduan komprehensif untuk bekerja dengan basis kode:

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

Semua file dokumentasi berada di dalam folder /docs repositori. Basis kode menggunakan TypeScript secara menyeluruh untuk keamanan tipe dan antarmuka komponen yang jelas.

Opsi kustomisasi

Implementasi open-source menyediakan akses frontend penuh untuk modifikasi:

UI dan desain

• Perpustakaan komponen (warna, tipografi, spasi, pola UI)

• Integrasi sistem desain kustom

• Modifikasi tema

Editor dashboard

• Algoritme tata letak kustom

• Metode pengaturan panel alternatif

• Alur kerja yang disederhanakan untuk kelompok pengguna tertentu

Visualisasi

• Ganti komponen grafik yang ada dengan komponen kustom

• Tambahkan jenis visualisasi baru

• Modifikasi perilaku rendering grafik

Integrasi

• Implementasi single sign-on

• Navigasi bersama dengan aplikasi yang ada

• Tampilan analitik tersemat

Tinjau ARCHITECTURE.md file di repositori sebelum modifikasi signifikan untuk memahami hubungan komponen dan perubahan yang diperlukan.

Kesejajaran fitur dengan versi standar

Dashboard Studio open-source mempertahankan kesejajaran fitur penuh dengan versi yang dihosting oleh Navixy:

Fitur	Open-source	Standar
Editor dashboard (drag-and-drop, panel, baris)	✓	✓
Eksekusi SQL (keamanan, timeout, caching)	✓	✓
Visualisasi (bar, pie, table, stat)	✓	✓
Organisasi menu (seksI, pengurutan ulang)	✓	✓
Pembaruan dan fitur baru	✓	✓

Repositori menerima pembaruan rutin yang selaras dengan rilis versi yang dihosting. Jenis visualisasi baru, kemampuan editor, dan peningkatan kinerja muncul di kedua model penyebaran secara bersamaan.

Model dukungan dan pemeliharaan

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

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

Dukungan dan bantuan

Untuk dukungan teknis dan bantuan terkait IoT Query, hubungi tim dukungan kami di [email protected].