RESTForge Studio
Dokumentasi RESTForge Studio - Editor visual berbasis GUI untuk menyusun konfigurasi RESTForge
RESTForge Studio
The Visual Workshop for the Forge
RESTForge Studio adalah editor berbasis GUI yang menjadi permukaan visual untuk menyusun konfigurasi RESTForge. Studio memungkinkan penyusunan konfigurasi backend dan frontend melalui form interaktif, tanpa harus menulis file JSON secara manual.
Peran dalam Ekosistem (Role in Ecosystem)
RESTForge Studio bukan produk yang berdiri sendiri. Studio berperan sebagai antarmuka visual yang menghubungkan dua produk utama:
┌─────────────────────────────────┐
│ RESTForge Studio │
│ (Visual GUI) │
│ │
│ • Editor konfigurasi backend │
│ • Editor konfigurasi frontend │
│ • Tombol jalankan │
│ • Navigasi project │
└───────────────┬─────────────────┘
│
┌──────────┴──────────┐
│ │
▼ ▼
┌─────────────┐ ┌─────────────┐
│ RESTForge │ │ RESTForge │
│ Server │ │ Apps │
│ (Backend) │ │ (Frontend) │
└─────────────┘ └─────────────┘Fungsi Utama (Key Functions)
| Fungsi | Deskripsi |
|---|---|
| Editor Konfigurasi Backend | Form visual untuk menyusun konfigurasi yang akan diproses oleh RESTForge Server, mencakup definisi endpoint, field, validasi, dan query |
| Editor Konfigurasi Frontend | Form visual untuk menyusun konfigurasi yang akan diproses oleh RESTForge Apps, mencakup halaman, form layout, tabel, dan filter |
| Tombol Jalankan | Satu klik untuk meminta RESTForge Server atau RESTForge Apps memproses konfigurasi yang sedang dikerjakan |
| Navigasi Project | Pengelolaan banyak konfigurasi dalam satu project dengan navigasi dan fitur pencarian |
Prinsip Desain (Design Principles)
Studio dirancang dengan satu prinsip utama: Studio tidak pernah memproses konfigurasi sendiri. Seluruh pemrosesan tetap dilakukan oleh produk masing-masing. RESTForge Server memproses konfigurasi backend, RESTForge Apps memproses konfigurasi frontend.
Prinsip ini menghasilkan tiga konsekuensi positif:
| Konsekuensi | Penjelasan |
|---|---|
| Satu Sumber Kebenaran | Tidak ada duplikasi pemrosesan antara Studio dan produk lain, sehingga hasilnya selalu identik |
| Evolusi Independen | RESTForge Server dan RESTForge Apps dapat berkembang tanpa harus sinkron dengan rilis Studio |
| Pengalaman Konsisten | Pengguna yang berpindah dari cara visual ke cara manual akan mendapatkan hasil yang sama persis |
Pola ini serupa dengan Android Studio yang tidak membangun aplikasi Android secara langsung, melainkan meminta build tools yang terpisah untuk memprosesnya. Studio menyediakan permukaan visual, sedangkan produk lain tetap menjadi sumber kebenaran tunggal.
Pilihan Jalur Kerja (Workflow Options)
Studio memberikan fleksibilitas dalam cara kerja. Tiga jalur berikut dapat dipilih sesuai preferensi tim:
| Jalur | Pengguna yang Cocok | Komponen yang Dipakai |
|---|---|---|
| Jalur Visual | Pengguna yang lebih nyaman dengan antarmuka visual dan perubahan cepat berulang | RESTForge Studio sebagai permukaan utama, produk lain dipanggil otomatis |
| Jalur Manual | Pengguna yang lebih nyaman menyusun konfigurasi sendiri di text editor | RESTForge Server dan RESTForge Apps langsung, tanpa Studio |
| Jalur Gabungan | Tim yang menggabungkan keduanya sesuai tahap pekerjaan | Visual untuk tahap awal, manual untuk penyesuaian detail |
Ketiga jalur ini menghasilkan output yang identik karena Studio hanya menyusun konfigurasi, bukan memproses. Konfigurasi yang disusun di Studio dapat dibuka di text editor, dan sebaliknya.
Konfigurasi yang Dikelola (Managed Configurations)
Studio mengelola dua jenis konfigurasi yang saling terkait:
| Jenis Konfigurasi | Disusun Dengan | Diproses Oleh |
|---|---|---|
| Konfigurasi Backend | RESTForge Studio atau text editor | RESTForge Server |
| Konfigurasi Frontend | RESTForge Studio atau text editor | RESTForge Apps |
Konversi dua arah antar konfigurasi dimungkinkan, sehingga konfigurasi backend dapat dipakai sebagai sumber kebenaran bagi frontend tanpa perlu menyusun ulang definisi data dari awal.