Update docs structure to root and fix links

2026-01-26 13:32:07 +07:00 · 2026-01-18 11:35:30 +07:00
parent c977c8dc1b
commit 2ef1f20e54
80 changed files with 227 additions and 188 deletions
--- a/id/docs/guide/docker-aapanel.md
+++ b/id/docs/guide/docker-aapanel.md
@@ -0,0 +1,105 @@
+# Deploy di aaPanel (Docker)
+
+aaPanel adalah salah satu panel hosting paling populer yang memiliki modul **Docker Manager** yang sangat memudahkan manajemen container. Kami merekomendasikan penggunaan gaya "Native" aaPanel agar manajemen resource dan env lebih rapi.
+
+::: tip PRASYARAT
+Pastikan Anda sudah menginstall modul **Docker** dari App Store di dalam aaPanel Anda.
+:::
+
+## 1. Siapkan Konfigurasi
+
+Metode ini memisahkan konfigurasi (di file `.env`) dari template logic, sehingga Anda bisa dengan mudah mengubah port atau resource limit tanpa mengedit file YAML yang rumit.
+
+**File Environment (`.env`)**
+Buat file baru bernama `.env` (atau simpan teks ini untuk nanti):
+
+```ini
+VERSION=latest
+CONTAINER_NAME=mivo
+HOST_IP=0.0.0.0
+APP_PORT=8085
+APP_PATH=/www/dk_project/mivo
+APP_ENV=production
+APP_DEBUG=false
+TZ=Asia/Jakarta
+CPUS=1.0
+MEMORY_LIMIT=512M
+```
+
+**Penjelasan Atribut:**
+- `APP_PATH`: **Penting**. Ini harus sama persis dengan lokasi project di aaPanel Anda (defaultnya `/www/dk_project/<nama_project>`).
+- `APP_PORT`: Port host yang ingin dibuka (default `8080`).
+- `CPUS` & `MEMORY_LIMIT`: Batasan resource agar container tidak membebani server/VPS Anda.
+
+## 2. Buat Project di aaPanel
+
+1. Login ke dashboard aaPanel.
+2. Masuk ke menu **Docker** > **Project** (atau **Compose** di versi lama).
+3. Klik tombol **Add Project**.
+4. Isi form sebagai berikut:
+   - **Name**: `mivo` (atau nama lain yang Anda suka)
+   - **Path**: Perhatikan path yang muncul otomatis (biasanya `/www/dk_project/mivo`). **Pastikan `APP_PATH` di .env Anda sesuai dengan path ini!**
+   - **Compose Template**: Copy-paste kode YAML berikut:
+
+```yaml
+version: '3.8'
+
+services:
+  mivo:
+    image: ghcr.io/mivodev/mivo:${VERSION:-latest}
+    container_name: ${CONTAINER_NAME:-mivo}
+    restart: unless-stopped
+    ports:
+      - "${HOST_IP:-0.0.0.0}:${APP_PORT:-8085}:80"
+    volumes:
+      # Database & Sessions
+      - ${APP_PATH:-.}/mivo_data:/var/www/html/app/Database
+      
+      # Custom Logos
+      - ${APP_PATH:-.}/mivo_logos:/var/www/html/public/assets/img/logos
+      
+      # Environment file (Optional - mapped from host)
+      # - ${APP_PATH:-.}/.env:/var/www/html/.env
+      
+    environment:
+      - APP_ENV=${APP_ENV:-production}
+      - APP_DEBUG=${APP_DEBUG:-false}
+      - TZ=${TZ:-Asia/Jakarta}
+      
+    deploy:
+      resources:
+        limits:
+          cpus: '${CPUS:-1.0}'
+          memory: ${MEMORY_LIMIT:-512M}
+
+    networks:
+      - mivo_net
+
+networks:
+  mivo_net:
+    driver: bridge
+```
+
+5. **Tunggu!** Sebelum klik "Confirm":
+   - Cari bagian konfigurasi **.env** (biasanya berupa tab atau input area di samping/bawah editor YAML).
+   - Paste konten `.env` yang sudah Anda siapkan di langkah 1 ke sana.
+6. Klik **Confirm** untuk memulai deployment.
+
+## 3. Verifikasi Deployment
+
+aaPanel akan otomatis mendownload image dan menjalankan container.
+
+- **Lokasi Data**: Database Anda aman tersimpan di `/www/dk_project/mivo/mivo_data`. folder ini tidak akan hilang walau container dihapus.
+- **Lokasi Logo**: Upload logo kustom Anda ke `/www/dk_project/mivo/mivo_logos`.
+
+## 4. Setup Domain (Reverse Proxy)
+
+Agar MIVO bisa diakses menggunakan domain (contoh: `mivo.domainanda.com`):
+
+1. Ke menu **Website** > **Add Site**.
+2. Masukkan nama domain Anda.
+3. Pada **PHP Version**, pilih **Static** (atau langsung Reverse Proxy jika ada opsinya).
+4. Setelah site dibuat, buka settingannya > **Reverse Proxy** > **Add Reverse Proxy**.
+5. **Target URL**: `http://127.0.0.1:8085` (Ganti `8085` sesuai dengan `APP_PORT` Anda).
+6. Simpan dan aktifkan SSL agar lebih aman.
+
--- a/id/docs/guide/docker.md
+++ b/id/docs/guide/docker.md
@@ -0,0 +1,78 @@
+---
+title: Panduan Docker
+---
+
+# Panduan Docker
+
+Image Docker ini dibangun di atas **Alpine Linux** dan **Nginx**, dioptimalkan untuk performa tinggi dan penggunaan sumber daya rendah.
+
+## <Icon name="Zap" color="warning" /> Mulai Cepat
+
+Jalankan MIVO dengan satu perintah:
+
+```bash
+docker run -d \
+  --name mivo \
+  -p 8080:80 \
+  -e APP_KEY=base64:YOUR_GENERATED_KEY \
+  -e APP_ENV=production \
+  -v mivo_data:/var/www/html/app/Database \
+  -v mivo_config:/var/www/html/.env \
+  ghcr.io/mivodev/mivo:latest
+```
+
+Buka browser Anda dan navigasi ke `http://localhost:8080`.
+
+**Pengaturan Awal:**
+Jika ini adalah pertama kali dijalankan, Anda akan diarahkan ke **Web Installer**. Ikuti instruksi di layar untuk membuat database dan akun admin.
+
+## <Icon name="Wrench" color="primary" /> Docker Compose
+
+Untuk pengaturan yang lebih permanen, gunakan `docker-compose.yml`:
+
+```yaml
+services:
+  mivo:
+    image: ghcr.io/mivodev/mivo:latest
+    container_name: mivo
+    restart: unless-stopped
+    ports:
+      - "8080:80"
+    environment:
+      - APP_ENV=production
+      - TZ=Asia/Jakarta
+    volumes:
+      - ./mivo-data:/var/www/html/app/Database
+```
+
+## <Icon name="Tags" color="info" /> Tags
+
+- `latest`: Rilis stabil (direkomendasikan).
+- `edge`: Build terbaru dari branch `main` (bleeding edge).
+- `v1.x.x`: Versi rilis spesifik.
+
+## <Icon name="Sliders" color="success" /> Variabel Lingkungan
+
+| Variabel | Deskripsi | Default |
+| :--- | :--- | :--- |
+| `APP_ENV` | Lingkungan aplikasi (`production` atau `local`). | `production` |
+| `APP_DEBUG` | Aktifkan mode debug (`true` atau `false`). | `false` |
+| `APP_KEY` | String acak ca 32-karakter (base64). Dibuat otomatis saat install pertama kali jika kosong. | |
+| `TZ` | Zona waktu untuk container. | `UTC` |
+
+## <Icon name="Folder" color="primary" /> Volume
+
+Persist data Anda dengan me-mount path ini:
+
+- `/var/www/html/app/Database`: Menyimpan database SQLite dan file sesi. **(Penting)**
+- `/var/www/html/public/assets/img/logos`: Menyimpan logo kustom yang diupload.
+
+## <Icon name="Heart" color="danger" /> Dukung Proyek Ini
+
+Jika Anda merasa MIVO bermanfaat, harap pertimbangkan untuk mendukung pengembangannya. Kontribusi Anda sangat berarti untuk kelangsungan proyek ini!
+
+[![SociaBuzz Tribe](https://img.shields.io/badge/SociaBuzz-Tribe-green?style=for-the-badge&logo=sociabuzz&logoColor=white)](https://sociabuzz.com/dyzulkdev/tribe)
+
+---
+*Dibuat dengan <Icon name="Heart" color="danger" /> oleh MivoDev*
+
--- a/id/docs/guide/index.md
+++ b/id/docs/guide/index.md
@@ -0,0 +1,24 @@
+---
+title: Pengenalan
+---
+
+# Pengenalan
+
+Selamat datang di Panduan MIVO. Bagian ini akan membantu Anda memahami apa itu MIVO dan bagaimana cara menjalankannya di sistem Anda.
+
+## <Icon name="Zap" color="warning" /> Apa itu MIVO?
+
+MIVO adalah sistem Manajemen Voucher Mikrotik yang modern dan ringan. Sistem ini dirancang agar efisien, cepat, dan mudah digunakan, memberikan pengalaman yang mulus untuk pengelolaan Hotspot.
+
+## <Icon name="BookOpen" color="primary" /> Navigasi
+
+Jelajahi bagian berikut untuk memulai:
+
+- **[Panduan Instalasi](/id/docs/guide/installation)**: Pelajari cara menginstal MIVO di berbagai platform.
+- **[Panduan Docker](/id/docs/guide/docker)**: Cara yang direkomendasikan untuk menjalankan MIVO menggunakan container.
+- **[Buku Manual](/id/docs/manual/)**: Instruksi detail tentang cara menggunakan fitur-fitur MIVO.
+
+## <Icon name="Heart" color="danger" /> Dukungan
+
+MIVO adalah proyek open-source. Jika Anda merasa MIVO bermanfaat, harap pertimbangkan untuk mendukung pengembangannya melalui [donasi](https://sociabuzz.com/dyzulkdev/tribe) atau [berkontribusi](https://github.com/dyzulk/mivo) langsung ke kode program.
+
--- a/id/docs/guide/installation.md
+++ b/id/docs/guide/installation.md
@@ -0,0 +1,122 @@
+---
+title: Panduan Instalasi
+---
+
+# Panduan Instalasi
+
+Panduan ini mencakup instalasi di berbagai platform. MIVO dirancang agar ringan dan berjalan di hampir semua server yang mendukung PHP.
+
+## <Icon name="ClipboardList" color="primary" /> Persyaratan Umum {#persyaratan}
+*   **PHP**: 8.0 atau lebih tinggi
+*   **Ekstensi**: `sqlite3`, `openssl`, `mbstring`, `json`
+*   **Database**: SQLite (Berbasis file, tidak perlu server database)
+
+---
+
+## <Icon name="Container" color="info" /> Docker (Direkomendasikan) {#docker}
+Cara termudah untuk menjalankan MIVO.
+
+1.  **Build & Run**
+    ```bash
+    docker-compose up -d --build
+    ```
+    Buka `http://localhost:8080`
+    
+2.  **Manual Pull (Alternatif)**
+    Jika Anda lebih suka menarik image secara manual:
+    ```bash
+    docker pull ghcr.io/mivodev/mivo:latest  # Stable
+    docker pull ghcr.io/mivodev/mivo:v1.0.0  # Versi Spesifik
+    docker pull ghcr.io/mivodev/mivo:edge    # Bleeding Edge
+    ```
+
+*Catatan: Database disimpan secara permanen di `app/Database` melalui volume.*
+
+---
+
+## <Icon name="Server" color="success" /> Web Server {#web-server}
+
+### Nginx
+Nginx tidak membaca `.htaccess`. Gunakan blok konfigurasi ini di blok `server` Anda:
+
+```nginx
+server {
+    listen 80;
+    server_name domain-anda.com;
+    root /path/to/mivo/public;
+    index index.php;
+
+    location / {
+        try_files $uri $uri/ /index.php?$query_string;
+    }
+
+    location ~ \.php$ {
+        include snippets/fastcgi-php.conf;
+        fastcgi_pass unix:/run/php/php8.2-fpm.sock; # Sesuaikan versi
+    }
+
+    location ~ /\.ht {
+        deny all;
+    }
+}
+```
+
+---
+
+## <Icon name="Smartphone" color="warning" /> Mobile / STB {#mobile-stb}
+
+### Awebserver
+1.  Salin file MIVO ke folder `/htdocs`.
+2.  Arahkan document root ke `public` jika didukung, atau akses via `http://localhost:8080/public`.
+3.  Pastikan versi PHP kompatibel.
+
+### Termux
+1.  Install PHP: `pkg install php`
+2.  Masuk ke direktori MIVO: `cd mivo`
+3.  Gunakan built-in server:
+    ```bash
+    php mivo serve --host=0.0.0.0 --port=8080
+    ```
+4.  Akses melalui browser.
+
+---
+
+## <Icon name="Globe" color="info" /> Shared Hosting {#shared-hosting}
+Kebanyakan shared hosting menggunakan Apache atau OpenLiteSpeed, yang didukung penuh.
+
+1.  **Upload File**: Upload file MIVO ke `public_html/mivo` (atau folder subdomain).
+2.  **Arahkan Domain**:
+    *   **Direkomendasikan**: Pergi ke "Domains" atau "Subdomains" di cPanel dan set **Document Root** agar menunjuk langsung ke folder `public/` (contoh: `public_html/mivo/public`).
+    *   **Alternatif**: Jika tidak bisa mengubah Document Root, Anda bisa memindahkan isi `public/` ke root `public_html` dan memindahkan `app/`, `routes/`, dll satu level ke atas (tidak disarankan untuk keamanan).
+3.  **Versi PHP**: Pilih PHP 8.0+ di menu "Select PHP Version".
+4.  **Ekstensi**: Pastikan `sqlite3` dan `fileinfo` dicentang.
+
+---
+
+## <Icon name="Cloud" color="primary" /> VPS & Cloud {#vps-cloud}
+
+### aaPanel
+1.  **Buat Website**: Tambah situs -> PHP-8.x.
+2.  **Direktori Situs**:
+    *   Set **Running Directory** ke `/public`.
+    *   Hapus centang "Anti-XSS" (terkadang memblokir penyimpanan konfigurasi).
+3.  **URL Rewrite**: Pilih template `thinkphp` atau `laravel` yang kompatibel.
+4.  **Izin File**: Chown user `www` ke direktori situs.
+
+### PaaS Cloud (Railway / Render / Heroku)
+> [!WARNING]
+> MIVO menggunakan SQLite. Kebanyakan PaaS Cloud menggunakan **Ephemeral Filesytem** (Data hilang saat restart).
+> Anda WAJIB menggunakan **Persistent Volume/Disk**.
+
+---
+
+## <Icon name="Settings" color="success" /> Pasca-Instalasi {#pasca-instalasi}
+Setelah menyiapkan server:
+1.  Salin `.env.example` ke `.env` (jika belum dilakukan).
+2.  **Install Aplikasi**
+    *   **Opsi A: CLI**
+        Jalankan `php mivo install` di terminal Anda.
+    *   **Opsi B: Web Installer**
+        Buka `http://domain-anda.com/install` di browser.
+
+
--- a/id/docs/manual/index.md
+++ b/id/docs/manual/index.md
@@ -0,0 +1,30 @@
+---
+title: Buku Panduan
+---
+
+# Buku Panduan
+
+Selamat datang di **Buku Panduan MIVO**. Bagian ini mencakup aspek fungsional penggunaan aplikasi untuk mengelola jaringan Anda.
+
+## <Icon name="BookOpen" color="primary" /> Topik
+
+### <Icon name="Settings" color="info" /> [Pengaturan Global](/id/docs/manual/settings/)
+Konfigurasikan pengaturan tingkat sistem:
+- **Manajemen Router**: Hubungkan dan kelola perangkat Mikrotik Anda.
+- **Template Voucher**: Desain dan sesuaikan tata letak voucher Anda.
+- **Logo Brand**: Unggah logo khusus untuk hotspot Anda.
+- **API & CORS**: Ekspos data router Anda dengan aman ke aplikasi pihak ketiga.
+
+### <Icon name="Activity" color="success" /> [Operasional Router](/id/docs/manual/router/)
+Kelola tugas harian router Anda setelah terhubung:
+- **Dashboard**: Pantau traffic real-time dan kesehatan sistem.
+- **Manajemen Hotspot**: Buat user, profil, dan generate voucher.
+- **Laporan**: Lacak penjualan Anda dan lihat log sistem.
+- **Tools Sistem**: Reboot, scheduler, dan manajemen DHCP.
+
+---
+
+> [!TIP]
+> Panduan ini fokus pada **penggunaan** aplikasi. Untuk instalasi dan konfigurasi server, silakan merujuk ke [Panduan](/id/docs/guide/installation).
+
+
--- a/id/docs/manual/router/dashboard.md
+++ b/id/docs/manual/router/dashboard.md
@@ -0,0 +1,29 @@
+# Dashboard & Pemantauan
+
+Dashboard berfungsi sebagai pusat kendali real-time untuk router Mikrotik Anda. Fitur ini mengumpulkan data penting dari API Mikrotik untuk memberikan gambaran instan tentang kesehatan jaringan Anda.
+
+## <Icon name="LineChart" color="primary" /> Monitor Traffic Real-time
+
+MIVO dilengkapi dengan monitor trafik langsung yang berkomunikasi langsung dengan interface Mikrotik Anda.
+- **Pemilihan Interface**: Pilih interface fisik atau virtual apa pun (contoh: `ether1`, `wlan1`, `bridge-hotspot`).
+- **Grafik Langsung**: Lihat trafik masuk dan keluar dalam satuan bits/sec atau bytes/sec.
+- **Pelacakan Puncak**: Identifikasi lonjakan bandwidth dengan cepat.
+
+## <Icon name="Cpu" color="warning" /> Sumber Daya Router
+
+Pantau kesehatan fisik perangkat keras Mikrotik Anda:
+- **Beban CPU**: Ditampilkan dalam persentase. Beban CPU yang tinggi mungkin menunjukkan perlunya pemutakhiran perangkat keras atau optimasi konfigurasi.
+- **Memori**: Melacak RAM yang bebas vs total RAM.
+- **Uptime**: Menunjukkan berapa lama router telah berjalan sejak reboot terakhir.
+- **Penyimpanan**: Pantau ruang yang tersedia pada memori flash router Anda.
+
+## <Icon name="Smartphone" color="success" /> Sesi Aktif
+
+Ringkasan cepat pengguna yang saat ini terautentikasi:
+- **Total Online**: Hitungan real-time pengguna yang sedang menggunakan hotspot.
+- **IP/MAC Aktif**: Pantau perangkat yang terhubung secara garis besar.
+
+> [!TIP]
+> Biarkan Dashboard tetap terbuka selama jam sibuk untuk memantau kepadatan atau upaya akses yang tidak sah.
+
+
--- a/id/docs/manual/router/hotspot.md
+++ b/id/docs/manual/router/hotspot.md
@@ -0,0 +1,41 @@
+# Manajemen Hotspot
+
+Alat komprehensif untuk mengelola server Hotspot Mikrotik Anda, mulai dari pembuatan user hingga kontrol akses tingkat lanjut.
+
+## <Icon name="Users" color="primary" /> User Hotspot {#users}
+
+Halaman User (`/hotspot/users`) adalah database pusat untuk semua akun wifi Anda.
+- **Pembuatan Manual**: Tambah user tunggal dengan username dan password spesifik.
+- **Cetak Satuan**: Arahkan kursor ke user untuk melihat ikon cetak. Ini menggunakan template default yang ditetapkan pada profil mereka.
+- **Cetak Massal**: Pilih beberapa user dan gunakan menu **Batch Actions** untuk mencetak semuanya sekaligus dalam satu halaman.
+- **Monitor Status**: Lihat apakah user sedang login (Aktif) secara langsung di dalam daftar.
+
+## <Icon name="Layers" color="info" /> Profil User {#profiles}
+
+Profil User (`/hotspot/profiles`) menentukan aturan untuk setiap jenis voucher (contoh: 1 Jam, 1 Hari).
+- **Rate Limit**: Kontrol kecepatan unggah dan unduh (contoh: `512k/1M`).
+- **Shared Users**: Batasi berapa banyak perangkat yang dapat menggunakan akun yang sama secara bersamaan.
+- **Validity**: Atur berapa lama akun tetap aktif setelah login pertama.
+- **Harga**: Simpan harga jual untuk keperluan laporan.
+
+## <Icon name="Ticket" color="success" /> Generator Voucher {#generate}
+
+Generate ratusan voucher dalam hitungan detik (`/hotspot/generate`).
+1. **Jumlah**: Pilih berapa banyak voucher yang akan dibuat.
+2. **Server**: Pilih server hotspot mana yang dituju (biasanya `all`).
+3. **User Mode**: Pilih antara `Username & Password` atau `Username = Password`.
+4. **Prefix**: Tambahkan awalan (prefix) tetap pada setiap username yang dibuat.
+
+## <Icon name="Zap" color="warning" /> Sesi Aktif & Cookies {#active}
+
+Pantau dan kontrol koneksi saat ini (`/hotspot/active` dan `/hotspot/cookies`).
+- **Kick User**: Putuskan sesi user yang sedang aktif secara paksa.
+- **Cookies**: Kelola token 'remember me'. Menghapus cookie memaksa user untuk login kembali pada koneksi berikutnya.
+
+## <Icon name="ShieldCheck" color="danger" /> Keamanan & Akses {#security}
+
+Pengaturan lanjutan untuk akses jaringan tanpa persyaratan voucher biasa.
+- **IP Bindings**: Lewati login hotspot untuk alamat MAC atau IP tertentu (contoh: untuk printer kantor atau server).
+- **Walled Garden**: Izinkan akses ke situs web atau domain tertentu (contoh: portal bank Anda) bahkan sebelum user login.
+
+
--- a/id/docs/manual/router/index.md
+++ b/id/docs/manual/router/index.md
@@ -0,0 +1,17 @@
+# Operasional Router
+
+Operasional router adalah tugas-tugas spesifik dalam sesi setelah terhubung ke perangkat Mikrotik. Pengaturan ini bervariasi tergantung pada sesi router mana yang sedang Anda gunakan.
+
+## <Icon name="Activity" color="primary" /> Ikhtisar
+
+Setelah Anda memilih sesi dari sidebar, Anda mendapatkan akses ke alat-alat berikut:
+
+- **[Dashboard](/id/docs/manual/router/dashboard)**: Pemantauan traffic secara real-time.
+- **[Manajemen Hotspot](/id/docs/manual/router/hotspot)**: User, Profil, dan Voucher.
+- **[Laporan](/id/docs/manual/router/reports)**: Laporan penjualan dan log sistem.
+- **[Tools Sistem](/id/docs/manual/router/tools)**: Reboot, Scheduler, dan DHCP.
+
+## <Icon name="Zap" color="warning" /> Sinkronisasi Real-time
+
+MIVO berkomunikasi langsung dengan API Mikrotik Anda. Sebagian besar perubahan akan langsung diterapkan pada perangkat Anda.
+
--- a/id/docs/manual/router/quick-print.md
+++ b/id/docs/manual/router/quick-print.md
@@ -0,0 +1,28 @@
+# Cetak Cepat (Quick Print)
+
+Quick Print adalah modul khusus untuk penjualan voucher kecepatan tinggi. Fitur ini memungkinkan Anda untuk menampilkan paket tertentu yang ingin dijual dan mencetaknya dengan satu klik.
+
+## <Icon name="BarChart2" color="primary" /> Dashboard Penjualan
+
+Halaman utama (`/quick-print`) menampilkan "Paket" Anda dalam bentuk kartu besar yang dapat diklik.
+- **Generate Instan**: Mengklik paket akan langsung memerintahkan router untuk membuat user baru.
+- **Cetak Otomatis**: Setelah user dibuat, dialog cetak untuk voucher tersebut akan terbuka secara otomatis.
+
+## <Icon name="Library" color="info" /> Manajemen Paket
+
+Akses bagian **Kelola** (`/quick-print/manage`) untuk mempersonalisasi dashboard penjualan Anda.
+
+### <Icon name="PlusCircle" color="success" /> Menambah Paket
+- **Profil**: Pilih profil user Mikrotik.
+- **Harga**: Tentukan harga tampilan (bisa berbeda dengan komentar di Mikrotik).
+- **Template**: Tetapkan template voucher khusus untuk paket ini.
+
+### <Icon name="Trash2" color="danger" /> Menghapus Paket
+Menghapus paket di sini hanya menghapusnya dari dashboard Quick Print; **tidak** menghapus profil dari router Mikrotik Anda.
+
+## <Icon name="Printer" color="warning" /> Alur Kerja
+1. **Admin** memilih paket dari dashboard.
+2. **MIVO** membuat akun username/password acak di Mikrotik.
+3. **MIVO** mengambil template yang ditentukan dan mengirimkannya ke engine cetak browser.
+
+
--- a/id/docs/manual/router/reports.md
+++ b/id/docs/manual/router/reports.md
@@ -0,0 +1,29 @@
+# Laporan & Log
+
+Analisis performa bisnis Anda dan pantau aktivitas sistem melalui alat pelaporan yang mendetail.
+
+## <Icon name="BarChart" color="success" /> Laporan Penjualan {#selling}
+
+Halaman Laporan Penjualan (`/reports/selling`) memberikan rincian pendapatan Anda secara mendetail.
+- **Garis Waktu**: Lihat penjualan berdasarkan hari, bulan, atau rentang tanggal khusus.
+- **Detail**: Lihat profil mana yang terjual, stempel waktu (timestamp), dan harganya.
+- **Ekspor**: (Jika tersedia) Ekspor data Anda untuk keperluan akuntansi offline.
+
+## <Icon name="BarChart2" color="primary" /> Resume Penjualan {#resume}
+
+Halaman Resume (`/reports/resume`) menawarkan pandangan tingkat tinggi yang disederhanakan tentang pertumbuhan bisnis Anda.
+- **Total Pendapatan**: Gabungan pendapatan dari seluruh penjualan voucher.
+- **Jumlah Voucher**: Total voucher yang terjual vs yang dibuat (generated).
+- **Perbandingan Sesi**: Bandingkan performa di berbagai sesi router yang berbeda.
+
+## <Icon name="ClipboardList" color="info" /> Log Sistem {#logs}
+
+Pantau peristiwa real-time dari router Mikrotik Anda (`/reports/user-log`).
+- **Peristiwa**: Lacak login user, logout, eksekusi script, dan error sistem.
+- **Pemecahan Masalah**: Gunakan log ini untuk mengidentifikasi mengapa user tidak dapat terhubung atau kapan sesi terputus.
+- **Live Stream**: Log diperbarui secara otomatis saat peristiwa terjadi di router.
+
+> [!NOTE]
+> MIVO mengambil log ini langsung dari circular buffer Mikrotik. Bersihkan log Anda pada terminal Mikrotik jika buffer menjadi terlalu besar.
+
+
--- a/id/docs/manual/router/tools.md
+++ b/id/docs/manual/router/tools.md
@@ -0,0 +1,27 @@
+# Tools Sistem
+
+Utilitas penting untuk memelihara, menjadwalkan, dan memantau fungsi inti router Mikrotik Anda.
+
+## <Icon name="Network" color="info" /> DHCP Leases
+
+Halaman DHCP Leases (`/network/dhcp`) memungkinkan Anda memantau semua perangkat yang terhubung ke jaringan LAN atau Hotspot Anda, bahkan sebelum mereka login.
+- **Pelacakan Lease**: Lihat penetapan IP, alamat MAC, dan hostname dari perangkat yang terhubung.
+- **Monitor Pra-Login**: Berguna untuk mengidentifikasi perangkat yang terhubung tetapi kesulitan mencapai halaman login hotspot.
+
+## <Icon name="Clock" color="primary" /> Scheduler Router
+
+MIVO menyediakan antarmuka lengkap (`/system/scheduler`) untuk mengelola script dan jadwal internal Mikrotik.
+- **Daftar Tugas**: Lihat semua tugas terjadwal yang aktif dan dinonaktifkan di router Anda.
+- **Kelola Tugas**: Tambah, ubah, atau hapus tugas langsung dari MIVO.
+- **Otomatisasi**: Gunakan ini untuk eksekusi script berkala, seperti menghapus user yang kedaluwarsa atau menghasilkan laporan otomatis.
+
+## <Icon name="Zap" color="warning" /> Tindakan Kritis
+
+Picukan perintah tingkat sistem secara langsung dari antarmuka MIVO:
+- **<Icon name="RefreshCw" color="info" /> Reboot**: Muat ulang perangkat keras Mikrotik Anda dengan aman.
+- **<Icon name="Power" color="danger" /> Shutdown**: Matikan perangkat. Perhatikan bahwa Anda memerlukan akses fisik ke router untuk menghidupkannya kembali.
+
+> [!WARNING]
+> Tindakan ini segera dieksekusi pada router Mikrotik Anda. Pastikan tidak ada operasi kritis yang sedang berjalan sebelum melakukan reboot.
+
+
--- a/id/docs/manual/settings/api-cors.md
+++ b/id/docs/manual/settings/api-cors.md
@@ -0,0 +1,16 @@
+# API & CORS
+
+MIVO memungkinkan aplikasi eksternal untuk mengakses data router Anda secara aman melalui REST API.
+
+## <Icon name="Unlock" color="warning" /> Kebijakan CORS
+
+Untuk memungkinkan situs web Anda (misal: pengecek status) memanggil API MIVO, Anda harus memasukkan domain tersebut ke daftar putih (whitelist).
+
+1.  Buka **Pengaturan** > **API & CORS**.
+2.  Tambahkan URL situs web Anda (termasuk `https://`).
+3.  Simpan perubahan.
+
+## <Icon name="Terminal" color="info" /> Dokumentasi
+
+Dokumentasi API mendetail tersedia di bagian pengembang.
+
--- a/id/docs/manual/settings/index.md
+++ b/id/docs/manual/settings/index.md
@@ -0,0 +1,17 @@
+# Pengaturan Global
+
+Pengaturan global mengontrol instance MIVO Anda secara sistem lunak. Ini adalah konfigurasi tingkat sistem yang tidak bergantung pada koneksi Mikrotik tertentu.
+
+## <Icon name="Settings" color="primary" /> Ikhtisar
+
+Akses pengaturan ini dari menu kanan atas atau sidebar utama.
+
+- **[Router](/id/docs/manual/settings/routers)**: Kelola koneksi Mikrotik Anda.
+- **[Template](/id/docs/manual/settings/templates)**: Kustomisasi desain voucher.
+- **[Logo](/id/docs/manual/settings/logos)**: Unggah logo brand.
+- **[API & CORS](/id/docs/manual/settings/api-cors)**: Konfigurasi akses API.
+
+## <Icon name="Shield" color="info" /> Administrasi
+
+Anda juga dapat mengelola administrator MIVO dan perilaku sistem umum (Zona Waktu, Bahasa) di sini.
+
--- a/id/docs/manual/settings/logos.md
+++ b/id/docs/manual/settings/logos.md
@@ -0,0 +1,30 @@
+# Logo Brand
+
+Manajemen Logo memungkinkan Anda untuk mengelola galeri aset brand yang digunakan untuk kustomisasi voucher Hotspot Mikrotik dan antarmuka aplikasi.
+
+## <Icon name="Image" color="primary" /> Tujuan
+
+Dengan mengunggah logo bisnis Anda di sini, Anda dapat menciptakan pengalaman brand yang profesional bagi pelanggan Anda. Logo-logo ini disimpan terpusat dan dapat dipanggil secara dinamis di berbagai bagian MIVO.
+
+## <Icon name="UploadCloud" color="success" /> Proses Mengunggah
+
+1.  Buka **Pengaturan** > **Logo**.
+2.  **Drag & Drop** atau klik area unggah untuk memilih file Anda.
+3.  **Format yang Didukung**: PNG, JPG, SVG, dan GIF didukung. Disarankan menggunakan PNG transparan atau SVG untuk tampilan terbaik di voucher.
+
+## <Icon name="Hash" color="info" /> Logo ID & Fitur Copy
+
+Setiap logo yang Anda unggah akan diberikan **Short ID** yang unik (contoh: `lg01`, `logo_wifi`).
+
+### <Icon name="Copy" color="primary" /> Cara Menggunakan Copy ID
+Di galeri logo, arahkan kursor ke logo apapun untuk memunculkan tombol **Copy ID**.
+- **Fungsi**: Mengklik tombol ini akan menyalin ID unik tersebut ke clipboard Anda.
+- **Integrasi**: Gunakan ID ini di dalam **Voucher Template Editor** (contoh: `&#123;&#123;logo:lg01&#125;&#125;`) untuk menampilkan logo spesifik tersebut pada voucher yang dicetak.
+
+## <Icon name="Trash2" color="danger" /> Manajemen
+
+Anda dapat menghapus logo yang tidak digunakan kapan saja.
+> [!WARNING]
+> Menghapus logo akan menyebabkan template voucher yang mereferensikan ID-nya menampilkan gambar yang rusak (placeholder).
+
+
--- a/id/docs/manual/settings/routers.md
+++ b/id/docs/manual/settings/routers.md
@@ -0,0 +1,29 @@
+# Manajemen Router
+
+Untuk mulai mengelola Mikrotik Anda, pertama-tama Anda perlu menghubungkannya ke MIVO.
+
+## <Icon name="PlusCircle" color="success" /> Menghubungkan Router
+
+1.  Buka **Pengaturan** > **Router**.
+2.  Klik **Tambah Router**.
+3.  Isi detailnya:
+    - **Nama Sesi**: Identitas unik untuk koneksi ini.
+    - **Alamat IP**: IP Mikrotik atau nama DNS Anda.
+    - **Username/Password**: Akun API Mikrotik Anda.
+    - **Port**: Biasanya 8728 (API).
+
+## <Icon name="Activity" color="info" /> Status Koneksi
+
+MIVO akan mencoba terhubung ke router secara real-time. Jika status berwarna hijau, Anda siap memulai pengelolaan!
+
+## <Icon name="Database" color="warning" /> Backup & Restore
+
+Lindungi konfigurasi Anda dengan membuat cadangan (backup) database MIVO Anda.
+
+- **Backup**: Membuat file JSON yang berisi semua sesi router dan pengaturan global.
+- **Restore**: Unggah file cadangan MIVO yang telah disimpan sebelumnya untuk memulihkan data Anda.
+
+> [!CAUTION]
+> Melakukan restore akan menimpa pengaturan dan sesi Anda yang ada saat ini.
+
+
--- a/id/docs/manual/settings/system.md
+++ b/id/docs/manual/settings/system.md
@@ -0,0 +1,21 @@
+# Pengaturan Sistem
+
+Kelola akun administrator MIVO Anda dan perilaku aplikasi secara global.
+
+## <Icon name="UserCheck" color="primary" /> Akun Admin
+
+Ubah kredensial administrator MIVO Anda untuk menjaga keamanan sistem.
+- **Username**: Nama yang digunakan untuk login.
+- **Password**: Kata sandi aman untuk akses.
+
+## <Icon name="Globe" color="info" /> Konfigurasi Global
+
+Sesuaikan pengaturan lingkungan untuk seluruh aplikasi:
+- **Bahasa**: Pilih bahasa antarmuka pilihan Anda (Inggris/Indonesia).
+- **Zona Waktu**: Atur waktu lokal untuk laporan dan log yang akurat.
+- **Mata Uang**: Tentukan simbol mata uang yang digunakan dalam voucher dan laporan.
+
+## <Icon name="ShieldAlert" color="warning" /> Keamanan
+
+MIVO menggunakan autentikasi berbasis sesi. Pastikan Anda melakukan logout saat menggunakan terminal publik.
+
--- a/id/docs/manual/settings/templates.md
+++ b/id/docs/manual/settings/templates.md
@@ -0,0 +1,15 @@
+# Template Voucher
+
+MIVO memiliki engine template yang mumpuni untuk membuat voucher yang cantik dan siap cetak.
+
+## <Icon name="FileCode" color="primary" /> Kustomisasi Template
+
+Template menggunakan HTML dan placeholder khusus untuk menampilkan data voucher.
+
+- **Variabel**: `{{username}}`, `{{password}}`, `{{price}}`, dll.
+- **Preview**: Uji template Anda secara instan dari editor.
+
+## <Icon name="Printer" color="info" /> Cetak Cepat
+
+Setelah template disimpan, template tersebut akan tersedia di menu **Cetak Cepat** (Quick Print) di dalam sesi router Anda.
+