update: vibe documenting

qisthidev · qisthidev · commit 2cebec70ea77 · 2025-04-23T21:04:02.000+07:00
diff --git a/source/docs/v6/installation.md b/source/docs/v6/installation.md
@@ -9,19 +9,122 @@ section: content
 
 ## Server Requirements
 
-1. PHP >= 8.0
-1. Laravel >= 8.0
-1. MySQL, MariaDB, atau PostgreSQL
+1. PHP >= 8.2
+1. Laravel >= 11.0
+1. SQLite, MySQL, MariaDB, atau PostgreSQL
 1. PHP Extensions:
-    - BCMath
-    - Ctype
-    - GD
-    - JSON
-    - Mbstring
-    - OpenSSL
-    - PDO
-    - Tokenizer
-    - XML
+   - BCMath - Untuk perhitungan matematika presisi tinggi
+   - Ctype - Untuk validasi tipe karakter
+   - cURL - Untuk membuat HTTP requests ke layanan eksternal
+   - DOM - Untuk manipulasi dokumen XML/HTML
+   - Exif - Untuk membaca metadata dari file gambar
+   - Fileinfo - Untuk deteksi tipe MIME
+   - Filter - Untuk sanitasi dan validasi data
+   - GD - Untuk manipulasi gambar (diperlukan fitur media dan avatar)
+   - Hash - Untuk hashing dan enkripsi
+   - Iconv - Untuk konversi encoding karakter
+   - JSON - Untuk pemrosesan data JSON
+   - Libxml - Diperlukan untuk ekstensi DOM dan XML
+   - Mbstring - Untuk penanganan string multibyte
+   - OpenSSL - Untuk enkripsi dan fitur keamanan
+   - PCRE - Untuk regular expressions
+   - PDO - Untuk koneksi database
+   - Session - Untuk manajemen session user
+   - Tokenizer - Untuk pemrosesan PHP code
+   - XML - Untuk pemrosesan data XML dan API responses
+   - XMLWriter - Untuk menghasilkan file XML
+   - Zip - Untuk kompresi dan dekompresi file
+   - Zlib - Untuk kompresi data
+
+### Cara Memeriksa PHP Extensions
+
+Ada beberapa cara untuk memeriksa ekstensi PHP yang terinstal pada sistem kamu:
+
+1. **Melalui Terminal/Command Line**:
+
+   ```bash
+   php -m
+   ```
+
+   Perintah ini akan menampilkan daftar semua ekstensi PHP yang terinstall.
+
+2. **Melalui Script PHP**:
+   Buat file bernama `phpinfo.php` dengan konten berikut:
+
+   ```php
+   <?php phpinfo(); ?>
+   ```
+
+   Letakkan file tersebut di direktori web server kamu dan akses melalui browser.
+
+3. **Melalui Composer pada Project Laravolt**:
+   ```bash
+   composer check-platform-reqs
+   ```
+   Perintah ini akan memeriksa apakah sistem kamu memenuhi semua kebutuhan platform dari packages yang terinstall.
+
+### Cara Menginstall PHP Extensions
+
+Berikut cara instalasi ekstensi PHP yang umum digunakan pada berbagai sistem operasi:
+
+#### Pada Ubuntu/Debian:
+
+```bash
+sudo apt-get update
+sudo apt-get install php8.2-bcmath php8.2-curl php8.2-xml php8.2-gd php8.2-mbstring php8.2-zip
+# Ganti 8.2 dengan versi PHP yang kamu gunakan
+```
+
+#### Pada CentOS/RHEL:
+
+```bash
+sudo yum install php-bcmath php-curl php-xml php-gd php-mbstring php-zip
+```
+
+#### Pada macOS (menggunakan Homebrew):
+
+```bash
+brew install php
+# PHP dari Homebrew biasanya sudah menyertakan sebagian besar ekstensi yang dibutuhkan
+```
+
+#### Pada Windows (XAMPP/WAMP):
+
+Sebagian besar ekstensi sudah diaktifkan secara default. Untuk mengaktifkan ekstensi tambahan:
+
+1. Buka file `php.ini` (biasanya terletak di folder instalasi PHP)
+2. Cari baris yang berisi nama ekstensi (contoh: `;extension=gd`)
+3. Hapus tanda titik koma (`;`) di awal baris untuk mengaktifkan ekstensi tersebut
+4. Restart web server
+
+### Troubleshooting Umum
+
+1. **Error "Call to undefined function"**:
+   Pesan error ini biasanya menunjukkan bahwa ekstensi PHP yang dibutuhkan belum terinstall atau belum diaktifkan.
+
+2. **Error saat instalasi Composer**:
+
+   ```
+   Problem 1
+       - laravolt/laravolt requires ext-gd * -> the requested PHP extension gd is missing from your system.
+   ```
+
+   Solusi: Install ekstensi yang diminta menggunakan petunjuk di atas.
+
+3. **Error pada gambar atau avatar**:
+   Jika fitur manipulasi gambar tidak berfungsi, pastikan ekstensi GD terinstall dengan benar:
+
+   ```bash
+   php -m | grep gd
+   ```
+
+   Jika tidak ada output, artinya ekstensi GD belum terinstall.
+
+4. **Mengecek versi PHP**:
+   ```bash
+   php --version
+   ```
+   Pastikan menggunakan PHP 8.2 atau lebih tinggi untuk Laravolt v6.
 
 ## Instalasi Laravolt
 
@@ -30,7 +133,6 @@ Pastikan konfigurasi sudah benar dan halaman default Laravel sudah bisa diakses
 
 Jika aplikasi Laravel sudah siap, lanjutkan dengan langkah-langkah berikut:
 
-
 ### 1. Install Package
 
 ```bash
@@ -62,27 +164,54 @@ php artisan laravolt:admin
 ```
 
 Atau, cara yang lebih singkat tanpa perlu menjawab pertanyaan satu persatu:
+
 ```bash
 php artisan laravolt:admin Administrator admin@laravolt.dev secret
 ```
 
 ### 5. Local Development
 
-Sebagaimana diketahui, untuk menjalankan aplikasi PHP dibutuhkan sebuah ***web server***. Jika kamu sudah meng-install PHP, maka kamu bisa memanfaatkan server bawaan PHP. Cukup jalankan perintah:
+Sebagaimana diketahui, untuk menjalankan aplikasi PHP dibutuhkan sebuah **_web server_**. Berikut beberapa cara untuk menjalankan Laravolt di lingkungan pengembangan lokal:
+
+#### Menggunakan PHP Built-in Server dari Laravel
+
+Cara paling sederhana untuk menjalankan aplikasi Laravel adalah dengan server development via PHP built-in server. Jalankan perintah berikut:
 
 ```bash
 php artisan serve
 ```
 
-Selanjutkan aplikasimu bisa diakses di http://localhost:8000. Login dengan user admin yang sudah dibuat sebelumnya.
+Aplikasi bisa diakses di http://localhost:8000.
+
+#### Menggunakan Script Composer
+
+Sejak Laravel 11, terdapat script `dev` yang bisa digunakan untuk menjalankan beberapa service sekaligus. Jika kamu menggunakan Laravel 11.28 ke atas, cukup jalankan:
+
+```bash
+composer dev
+```
+
+Script ini akan menjalankan beberapa service sekaligus (Vite, queue worker, logs, webserver) dalam satu terminal.
+
+<!-- TODO: Serve menggunakan docker-compose.yml, akan dibuatkan di malescast.com -->
+
+#### Alternatif Tool Pengembangan Lokal
+
+Jika membutuhkan development server yang lebih lengkap, silakan mencoba beberapa alternatif berikut:
+
+1. [Laravel Herd](https://herd.laravel.com/) - Official development server dari Laravel
+1. [Laragon](https://laragon.org/) - Rekomendasi untuk Windows, semua kebutuhan sudah terintegrasi
+1. [XAMPP](https://www.apachefriends.org/index.html) - Populer untuk pemula
+1. [WampServer](http://www.wampserver.com/en) - Alternatif untuk Windows
+1. [Laravel Valet](https://laravel.com/docs/master/valet) - Khusus untuk macOS
+1. [Laradock](https://laradock.io/) - Solusi Docker lengkap untuk ekosistem Laravel
+
+### 6. Login ke Aplikasi
 
-Selamat, kamu berhasil meng-install Laravolt!
+Setelah server berjalan, akses aplikasi melalui browser dan login menggunakan kredensial admin yang telah dibuat sebelumnya:
 
-Jika membutuhkan development server yang lebih lengkap dan _robust_, silakan mencoba beberapa alternatif berikut ini:
+- URL: http://localhost:8000/auth/login
+- Email: email yang diinput saat menjalankan command `laravolt:admin` (default: admin@laravolt.dev)
+- Password: password yang diinput saat menjalankan command `laravolt:admin` (default: secret)
 
-0. [Laravel Sail (docker)](https://laravel.com/docs/master/sail)
-1. [Laragon](https://laragon.org/)
-2. [XAMPP](https://www.apachefriends.org/index.html)
-3. [WampServer](http://www.wampserver.com/en)
-5. [Laravel Valet](https://laravel.com/docs/8.x/valet)
-6. [Laradock (docker)](https://laradock.io/)
+Selamat, kamu berhasil meng-install dan menjalankan Laravolt!
diff --git a/source/docs/v6/introduction.md b/source/docs/v6/introduction.md
@@ -7,9 +7,9 @@ section: content
 
 # Introduction
 
-Laravolt adalah sebuah **_platform_** untuk membangun sistem informasi yang telah disesuaikan dengan kebutuhan pengguna di Indonesia.
+Laravolt adalah **_platform_** pemberdayaan digital yang memadukan kerangka teknis dan filosofis untuk membangun sistem informasi yang berkelanjutan, lahir dari pengalaman mendalam menghadapi kompleksitas unik lanskap teknologi Indonesia.
 
-Sebagai sebuah platform, maka Laravolt bukan hanya kumpulan baris kode, yang ditulis bersama-sama oleh para kontributor lalu di-*packaging* sedemikian dan diberi nama. Laravolt bukan sekedar template admin yang bisa dipakai berulang-ulang. Laravolt bukan hanya sekumpulan *library* yang telah teruji di medan tempur sehingga kamu bisa dengan tenang memakainya. Laravolt bukan hanya gimmick dan branding dari [Javan](https://javan.co.id).
+Sebagai sebuah platform, maka Laravolt bukan hanya kumpulan baris kode, yang ditulis bersama-sama oleh para kontributor lalu di-_packaging_ sedemikian dan diberi nama. Laravolt bukan sekedar template admin yang bisa dipakai berulang-ulang. Laravolt bukan hanya sekumpulan _library_ yang telah teruji di medan tempur sehingga kamu bisa dengan tenang memakainya. Laravolt bukan hanya gimmick dan branding dari [Javan](https://javan.co.id).
 
 Lebih daripada itu, Laravolt adalah:
 
@@ -21,16 +21,16 @@ Lebih daripada itu, Laravolt adalah:
 
 #### 1. Sukses Mengembangkan Sistem
 
-Karakteristik sebuah proyek pengembangan sistem informasi di Indonesia sangat unik. Ada banyak permintaan yang terkadang menurut kita (vendor) tidak ideal secara proses bisnis, tetapi mau tidak mau harus dipenuhi, atau sistem tidak akan digunakan.
+Karakteristik sebuah proyek pengembangan sistem informasi di Indonesia sangat unik. Ada banyak permintaan yang terkadang menurut kita (_vendor_) tidak ideal secara proses bisnis, tetapi mau tidak mau harus dipenuhi, atau sistem tidak akan digunakan.
 
-Proses SDLC yang ideal di atas kertas, yang tampak menjanjikan di presentasi awal, pada akhirnya tidak bisa diterapkan secara *kaffah* (menyeluruh). Ada banyak kepentingan, ada banyak birokrasi, ada banyak tantangan yang harus dihadapi demi terwujudnya sebuah proyek sistem informasi yang sukses.
+Proses SDLC yang ideal di atas kertas, yang tampak menjanjikan di presentasi awal, pada akhirnya tidak bisa diterapkan secara _kaffah_ (menyeluruh). Ada banyak kepentingan, ada banyak birokrasi, ada banyak tantangan yang harus dihadapi demi terwujudnya sebuah proyek sistem informasi yang sukses.
 
-Laravolt hadir untuk memastikan tercapainya sukses dari sisi teknis, sehingga *Project Manager* bisa fokus ke aspek lain yang tidak kalah penting.
+Laravolt hadir untuk memastikan tercapainya sukses dari sisi teknis, sehingga tim pengembang bisa fokus ke aspek lain yang tidak kalah penting.
 
 #### 2. Sukses Mengembangkan Programmer
-Faktor lain yang tidak kalah penting adalah kualitas sumber daya manusia (programmer). Programmer yang berpengalaman lebih memilih bergabung ke startup, mendirikan startup, atau mengerjakan proyek dari luar negeri.
 
-Tinggallah para programmer yang masih hijau, masih polos, dan masih membutuhkan kasih sayang (dari mentor). Mereka yang baru lulus dari sekolah, mereka yang baru menerima ijazah setelah sekian tahun kuliah. Mereka inilah yang akan menjadi ujung tombak kemajuan IT di Indonesia, ujung tombak suksesnya penerapan e-government di pemerintahan. Mereka tidak kalah kelas, hanya butuh lebih banyak jam terbang, butuh lebih banyak masalah untuk diterabas.
+Faktor lain yang tidak kalah penting adalah kualitas sumber daya manusia (baca: _programmer_). Para pembuat program yang berpengalaman lebih memilih bergabung ke startup, mendirikan startup, atau mengerjakan proyek dari luar negeri.
 
-Apakah kamu bagian dari "mereka"?
+Tinggallah para programmer yang berpotensi besar namun masih dalam tahap pengembangan kompetensi. Mereka yang baru menyelesaikan pendidikan formal, mereka yang sedang membangun fondasi karir di dunia teknologi. Mereka adalah masa depan ekosistem IT Indonesia, kunci keberhasilan transformasi digital dan e-government. Bukan kualitas yang mereka kekurangan, melainkan kesempatan untuk mengasah kemampuan dan menghadapi tantangan nyata. Laravolt hadir sebagai jembatan yang menghubungkan potensi dan pengalaman.
 
+Apakah kamu siap menjadi bagian dari perubahan ini?
