Peluncur Interaktif: jalankan.sh & jalankan.bat
Peluncur Interaktif CuanAff (./jalankan.sh untuk pengguna macOS/Linux dan jalankan.bat untuk pengguna Windows) adalah antarmuka berbasis menu angka ramah pemula yang dirancang agar siapa pun dapat mengoperasikan website afiliasi tanpa perlu menghafal atau mengetik perintah terminal yang rumit. Cukup dengan menekan angka 1 sampai 5 di keyboard, Anda dapat memeriksa kesiapan laptop, mengganti nama brand toko, mengimpor puluhan produk dari spreadsheet CSV, melihat pratinjau website secara lokal, hingga menayangkan website ke internet secara gratis ($0/bulan) melalui Cloudflare Pages.
⚡ Fungsi Cepat
- Bebas Tekanan Terminal (Zero Terminal Barrier): Tidak perlu menghafal perintah panjang atau parameter bendera (
--flag). Cukup pilih angka menu 0–5 lalu ikuti pertanyaan panduan di layar. - Lintas Sistem Operasi Tanpa Hambatan: Disediakan dalam dua format bawaan: skrip Shell Bash (
jalankan.sh) untuk macOS & Linux, serta skrip Batch (jalankan.bat) untuk Windows. - Deteksi Cerdas Kesiapan Komputer: Jika runtime PHP belum terpasang di komputer Anda, jendela peluncur tidak akan error atau menutup mendadak, melainkan menampilkan kotak petunjuk instalasi kilat yang membimbing Anda langkah demi langkah.
- Alur Bisnis Terpadu 1 Pintu: Menyediakan 5 aksi terpenting pemilik website: diagnostik sistem, kustomisasi nama brand, impor produk dari CSV, pratinjau offline lokal, dan publikasi online.
- Pintasan Argumen Angka Langsung: Anda juga dapat memicu menu tertentu secara cepat tanpa masuk ke menu utama (misal:
./jalankan.sh 1ataujalankan.bat 4).
🛠️ Jalur A: Cara Menjalankan Peluncur
Jalankan skrip peluncur sesuai sistem operasi laptop Anda:
1. Untuk Pengguna macOS & Linux:
Buka jendela Terminal di folder proyek CuanAff, lalu ketik:
bash
./jalankan.sh(Jika muncul pesan izin ditolak saat pertama kali dijalankan, aktifkan izin eksekusi sekali saja dengan: chmod +x jalankan.sh)
2. Untuk Pengguna Windows:
Buka folder proyek CuanAff di File Explorer, lalu klik ganda (double-click) pada berkas jalankan.bat, atau jalankan lewat Command Prompt / PowerShell:
cmd
jalankan.bat3. Pintasan Eksekusi Cepat Berbasis Nomor:
Anda dapat langsung mengeksekusi menu tertentu tanpa harus menunggu tampilan menu pembuka:
bash
# Menjalankan menu [1] Cek Kesiapan Laptop
./jalankan.sh 1
# Menjalankan menu [2] Atur Nama & Brand Situs
./jalankan.sh 2
# Menjalankan menu [3] Import Produk dari CSV & Publish
./jalankan.sh 3
# Menjalankan menu [4] Lihat Preview Website Lokal
./jalankan.sh 4
# Menjalankan menu [5] Tayangkan ke Cloudflare Pages
./jalankan.sh 5Pratinjau Tampilan Menu Interaktif:
text
======================================================================
CUANAFF — PELUNCUR INTERAKTIF RAMAH PEMULA
======================================================================
[✓] Runtime PHP aktif. Siap digunakan.
Silakan pilih menu yang ingin dijalankan:
[1] Cek Kesiapan Laptop (PHP, Node.js, Composer, Status Katalog)
[2] Atur Nama & Brand Situs (Ganti nama brand & logo teks header)
[3] Import Produk dari CSV (Batch import CSV & opsi publish instan)
[4] Lihat Preview Website (Rakit & pratinjau halaman di browser lokal)
[5] Tayangkan ke Cloudflare (Publikasi online dengan domain/Pages)
[0] Keluar
======================================================================
Pilih menu [0-5]:🤖 Jalur B: Prompt AI Siap Salin
Bagi Anda yang menggunakan asisten coding pintar (Antigravity, CommandCode, Cursor) atau web AI chat (ChatGPT, Claude), Anda dapat meminta AI untuk mengoperasikan fungsi peluncur interaktif secara langsung tanpa repot memilih menu satu per satu.
Kolaborasi Alami dengan Coding Agent
Coding Agent (seperti Antigravity dan CommandCode) dapat menjalankan skrip helper di balik layar peluncur (scripts/launcher-helper.php) secara otomatis dan melaporkan hasilnya langsung ke ruang obrolan Anda.
Template Prompt AI Menjalankan Fungsi Peluncur:
Template Prompt AI (Tinggal Salin & Sesuaikan Kebutuhan)
text
Halo AI, tolong bantu saya mengoperasikan fitur peluncur CuanAff untuk situs saya:
Situs Target: [CONTOH: tas]
Kebutuhan Saya Saat Ini:
[PILIH SALAH SATU ATAU SESUAIKAN KEBUTUHAN DI BAWAH INI]:
- Opsi A: Jalankan diagnostik kesiapan laptop saya dengan "php scripts/launcher-helper.php check".
- Opsi B: Ubah nama brand situs "tas" menjadi "KoperKu ID" dan slogan menjadi "Rekomendasi Koper Travel Terbaik".
- Opsi C: Impor daftar produk dari file data-koper.csv ke situs "tas" dan lakukan simulasi aman (dry-run).
- Opsi D: Rakit website "tas" dengan "php cuanaff site:build tas" dan jalankan server lokal untuk saya lihat di browser.
- Opsi E: Lakukan simulasi penayangan ke Cloudflare Pages dengan "php cuanaff site:publish tas --dry-run".
Tolong jalankan langkah yang sesuai, periksa apakah ada kendala, dan laporkan hasilnya secara ringkas!Keunggulan Dual-Track untuk Pengguna Pemula
Jika Anda sedang santai di depan laptop dan tidak membuka AI, gunakan jalankan.bat atau ./jalankan.sh untuk memilih menu dengan satu tombol keyboard. Namun jika Anda sedang berkonsultasi dengan asisten AI coding (seperti Antigravity atau Cursor), gunakan prompt di atas agar asisten AI yang menyelesaikan pekerjaannya untuk Anda.
⚙️ Peta & Opsi Peluncur Interaktif
Berikut adalah fungsi mendalam dan perintah yang dieksekusi di balik layar dari setiap opsi peluncur interaktif:
| Nomor Opsi | Nama Opsi di Layar | Perintah CLI di Balik Layar | Fungsi & Manfaat Praktis |
|---|---|---|---|
| [1] | Cek Kesiapan Laptop | php scripts/launcher-helper.php check | Memeriksa runtime PHP (>= 8.2), ketersediaan ekstensi (curl, mbstring, sqlite, zip), kesiapan Node.js, Composer, dan folder katalog data. |
| [2] | Atur Nama & Brand Situs | php scripts/launcher-helper.php branding | Mengubah nama brand website, tagline slogan, dan teks logo di bilah navigasi atas tanpa perlu menyunting file config.yaml secara manual. |
| [3] | Import Produk dari CSV | php cuanaff product:import-csv <site> <file> [--publish] | Meminta nama situs dan file CSV, mengimpor puluhan produk sekaligus, dan memberikan opsi langsung tayang (direct publish) ke internet. |
| [4] | Lihat Preview Website | php cuanaff site:build <site> & server lokal | Mengompilasi berkas website menjadi HTML siap saji, lalu menyalakan server lokal ringan di http://localhost:8000 untuk ditinjau di browser. |
| [5] | Tayangkan ke Cloudflare | php cuanaff site:publish <site> [--dry-run] | Menerbitkan website ke jaringan Cloudflare Pages ($0/bulan) dengan pilihan simulasi aman (dry-run) atau rilis publik langsung. |
| [0] | Keluar | Exit skrip | Menutup jendela peluncur interaktif secara bersih dan aman. |
📱 Pengalaman Nyata Pengguna Non-Teknis
Dengan memanfaatkan peluncur interaktif jalankan.sh atau jalankan.bat:
- Kepercayaan Diri Tinggi Sejak Hari Pertama:
- Pemula yang belum pernah menyentuh terminal atau koding tidak akan merasa takut salah mengetik perintah, karena antarmuka memandu setiap langkah dengan jelas.
- Kecepatan Kerja Tanpa Hambatan:
- Ingin melihat tampilan website di laptop setelah menambah produk? Cukup tekan angka
4lalu tekan Enter. Website Anda langsung dirakit dalam 2 detik.
- Ingin melihat tampilan website di laptop setelah menambah produk? Cukup tekan angka
- Pencegahan Kesalahan Manusia (Human Error Safeguard):
- Peluncur otomatis menyediakan nilai bawaan (default value) pada setiap isian formulir (seperti nama situs atau pilihan mode publish), mencegah kesalahan input yang tidak disengaja.
- Jembatan Mulus Menuju Skalabilitas:
- Saat bisnis ulasan Anda berkembang dan Anda mulai terbiasa, Anda dapat berpindah secara fleksibel antara peluncur interaktif, baris perintah CLI, maupun asisten AI coding kapan saja tanpa batas!