Pusat Bantuan CloudPro Solution POS System

Panduan lengkap instalasi, penyiapan database, modul operasional kasir, hingga aktivasi lisensi sistem.

🚀 1. Instalasi Web Server Lokal

Persiapan Lingkungan

Aplikasi CloudProSolution POS System dibangun menggunakan PHP dan MySQL. Sebelum dapat dijalankan di komputer lokal Anda, pastikan web server lokal telah terpasang dengan baik.

Rekomendasi Software Web Server:

Web Server OS Utama Kelebihan Status Relevansi
WampServer Windows Mudah dalam pengalihan versi PHP, stabil untuk lingkungan toko. Sangat Direkomendasikan
Laragon Windows Proses cepat, pembuatan virtual host otomatis, dan ringan. Alternatif Bagus
XAMPP Windows / Mac / Linux Populer dan dukungan lintas platform. Alternatif

Panduan Detail Instalasi WampServer (Windows)

1

Unduh Master Installer

Kunjungi situs resmi WampServer di https://wampserver.aviatechno.net/. Pilih paket versi 64-bit yang menyertakan **PHP versi 7.x** atau lebih tinggi.

2

Jalankan Setup & Tentukan Direktori

Buka berkas installer `.exe` dengan hak akses Administrator. Biarkan direktori instalasi pada opsi default di C:\wamp64 untuk mempermudah pemetaan path file.

3

Konfigurasi Environment Variable (System PATH)

Daftarkan PATH PHP ke Windows agar perintah PHP dapat dijalankan secara global melalui Command Prompt (CMD):

  1. Buka System Properties -> Environment Variables.
  2. Pada kotak System variables, pilih Path lalu klik Edit.
  3. Tambahkan jalur lokasi PHP Anda: C:\wamp64\bin\php\php7.x.x
⚠️
Penting: Pastikan pustaka Visual C++ Redistributable (VC14, VC15, dll.) sudah terpasang di Windows Anda sebelum menginstal WAMP agar tidak timbul error DLL saat Apache dinyalakan.

🛠️ 2. Konfigurasi Berkas & Database

Langkah Teknis

Ikuti panduan di bawah untuk menempatkan berkas source code dan mengatur pengalihan direktori aplikasi:

1

Ekstraksi File Source Code

Ekstrak arsip CloudProSolution.zip lalu pindahkan folder tersebut ke dalam direktori root web server lokal Anda:

C:\wamp64\www\CloudProSolution
2

Pengubahan Nama Folder Root (Opsional)

Anda diizinkan mengubah nama folder CloudProSolution sesuai dengan nama toko Anda (misalnya menjadi alsamart), sehingga alamat akses menjadi localhost/alsamart.

3

Pengeditan File Header Redireksi (WAJIB jika folder diubah)

Jika Anda mengubah nama folder utama, Anda wajib memperbarui lokasi pengalihan pada file index.php yang berada di root folder: 

// Kondisi awal (Standard):
header('Location: /cloudprosolution/app/login.php');

// Kondisi setelah diubah ke 'alsamart':
header('Location: /alsamart/app/login.php');
💡
Tips Pembuatan Database: Pada dasarnya ketika pertama kali membuka aplikasi maka database dengan nama pos_db sudah otomatis dibuat, namun jika terjadi kendala anda bisa membuat sendiri melalui phpmyadmin. Buka phpMyAdmin di http://localhost/phpmyadmin/, buat database baru dengan nama pos_db, lalu impor berkas `.sql` yang telah disediakan pada folder database/pos_db.sql.

🖥️ 3. Panduan Operasional Sistem

Petunjuk Penggunaan

Sistem CloudPro POS terbagi menjadi beberapa modul utama yang saling terintegrasi:

1. Pengaturan Sistem

PRO

Pusat kontrol konfigurasi toko:

  • Profil Perusahaan: Sesuaikan nama toko, alamat, nomor telepon, dan logo untuk nota cetak.
  • Manage User: Atur peran (*role*) dan hak akses kasir/admin.
  • Skema Diskon & Poin: Atur nominal pembelanjaan minimal untuk mendapatkan poin diskon.
  • Backup Database: Ekspor data rutin untuk mencegah kehilangan data.

2. Master Barang & Stok

BASIC

Manajemen persediaan barang dagangan:

  • Tambah Produk: Input nama produk, kode barcode, harga beli, harga jual, dan stok awal.
  • Restock Barang: Tambah jumlah stok secara cepat saat barang baru tiba dari supplier.
  • Kategori & Satuan: Kelompokkan produk berdasarkan jenis (makanan, minuman) dan satuan (pcs, pack, kg).

3. Point of Sales (Kasir)

BASIC

Layar utama transaksi jual beli:

  • Input Barcode: Mendukung pemindaian menggunakan *Barcode Scanner* USB/Bluetooth.
  • Pencarian Cepat: Ketik nama produk jika barcode rusak/tidak ada.
  • Diskon & Poin: Terapkan potongan diskon otomatis berdasarkan poin pelanggan.
  • Cetak Struk: Langsung terhubung dengan printer thermal 58mm / 80mm.
  • Sangat disarankan menggunakan printer thermal 80mm agar tampilan struk lebih rapi.

4. Modul Laporan

PRO

Analisis bisnis dan audit keuangan:

  • Laporan Penjualan: Pantau omset harian, mingguan, hingga bulanan.
  • Laporan Keuntungan (Profit): Perhitungan selisih harga jual dan HPP secara terperinci.
  • Laporan Stok Kritis: Peringatan dini untuk produk yang hampir habis.

🔑 4. Registrasi & Aktivasi Lisensi

Aktivasi

Setiap instalasi baru mendapatkan **Masa Uji Coba (Trial) 14 Hari** secara otomatis. Untuk beralih ke versi penuh (*Full Version*), ikuti skema aktivasi berikut:

1

Buka Halaman Aktivasi

Masuk ke aplikasi menggunakan akun trial anda, pada pesan notifikasi terdapat tombol Upgrade & Aktivasi. Klik Upgrade untuk mengirimkan permintaan pembelian lisensi

2

Salin Device Code

Sistem akan menampilkan opsi lisensi Versi Basic atau Versi Pro dan Device Code unik yang dihasilkan secara otomatis sesuai perangkat keras komputer Anda. lengkapi isian formulir permohonan pangajuan lisensi. Pastikan perangkat Anda terhubung ke internet saat proses pengajuan.

3

Kirim Konfirmasi via WhatsApp

Kirimkan Device Code dan data anda beserta paket lisensi yang dipilih (Basic/Pro) ke layanan WhatsApp resmi kami (0896-8280-0844). Tim support kami akan menerbitkan License Key yang valid.

4

Input License Key & Selesai

Tempelkan (*paste*) Device Code dan License Key yang Anda terima ke dalam kolom yang tersedia, lalu klik tombol Aktivasi Lisensi. Status aplikasi Anda akan langsung berubah menjadi Full Version.

❓ 5. Pertanyaan Umum & Pemecahan Masalah

Troubleshooting

Temukan jawaban cepat atas kendala teknis yang sering ditemui:

Penyebab: Aplikasi dijalankan di web server dengan versi PHP di bawah 7.0 (misal PHP 5.6).

Solusi: Switch versi PHP Anda ke versi 7.x.x atau yang lebih tinggi melalui kontrol panel WAMP/Laragon/XAMPP, lalu restart layanan web server Anda.

Solusi: Periksa berkas konfigurasi koneksi pada lokasi app/config.php. Pastikan parameter berikut sudah tepat:

  • DB_HOST: localhost
  • DB_USER: root (default WAMP/XAMPP)
  • DB_PASS: (kosongkan jika tidak memakai password)
  • DB_NAME: pos_db

Solusi: Pastikan driver printer thermal sudah terpasang dengan benar di Windows dan terdeteksi sebagai Default Printer. Pada dialog cetak browser (Chrome/Edge), sesuaikan pilihan ukuran kertas ke 58mm atau 80mm serta matikan opsi Headers and Footers.

Buka berkas catatan error di C:\wamp64\logs\php_error.log. Salin atau tangkap layar (*screenshot*) pesan error tersebut, lalu kirimkan ke tim support kami via WhatsApp di 0852-8041-6001 atau email cloudprosolution@gmail.com untuk mendapatkan penanganan lebih lanjut.

Penyebab: Terjadi kesalahan fatal pada skrip PHP, konfigurasi `.htaccess` yang keliru, atau batas memori server (*memory limit*) terlampaui.

Solusi:

  • Periksa file `php_error.log` pada direktori server (misal: `C:\wamp64\logs\php_error.log`) untuk melihat baris kode yang rusak.
  • Jika menggunakan `.htaccess`, coba ganti nama file tersebut sementara untuk memastikan tidak ada kesalahan direktif/mod_rewrite.
  • Naikkan batas memori pada `php.ini` dengan mengubah `memory_limit = 256M`.

Penyebab: Proses eksekusi skrip PHP (seperti ekspor/impor data berukuran besar atau laporan tahunan) memakan waktu lebih lama dari batas waktu bawaan server (30 detik).

Solusi: Buka file `php.ini` dan naikkan nilai `max_execution_time = 300` (5 menit), atau tambahkan perintah `set_time_limit(300);` pada bagian paling atas skrip PHP yang memproses data. Jangan lupa untuk me-restart Web Server.

Penyebab: Sesi PHP (*Session*) telah kadaluwarsa, cookie browser terblokir, atau folder penyimpanan session di server penuh/tidak memiliki izin akses (*permission*).

Solusi:

  • Bersihkan *Cache* dan *Cookies* pada peramban web (browser) Anda.
  • Periksa konfigurasi `session.gc_maxlifetime` pada `php.ini` dan sesuaikan nilainya (misal: `14400` untuk 4 jam).
  • Pastikan folder temporary session (misal: `C:\wamp64\tmp`) memiliki hak akses baca/tulis (*read/write*).

Penyebab: Ukuran file yang diunggah melebihi batas maksimal yang diizinkan oleh konfigurasi PHP server.

Solusi: Buka file `php.ini` dan sesuaikan dua parameter berikut agar lebih besar dari ukuran file yang diunggah: 

upload_max_filesize = 10M
post_max_size = 12M

Penyebab: Ketidaksesuaian pengaturan enkoding karakter (*character set*) antara skrip PHP, koneksi database, dan header HTML.

Solusi: Pastikan tag `` terpasang pada HTML, dan setel *collation* koneksi MySQL ke `utf8mb4` pada berkas koneksi database PHP: 

$mysqli->set_charset("utf8mb4");

Penyebab: Jalur (*path*) ke berkas CSS/JS menggunakan *absolute path* yang masih mengarah ke URL lama, atau masalah *caching* browser.

Solusi: Tekan `Ctrl + F5` untuk melakukan *Hard Refresh* pada browser. Jika belum berubah, periksa konstanta `BASE_URL` pada file konfigurasi aplikasi dan sesuaikan dengan folder/domain baru Anda.

Penyebab: Aplikasi melakukan permintaan AJAX/API ke domain, IP, atau port yang berbeda tanpa izin *Cross-Origin Resource Sharing*.

Solusi: Tambahkan header CORS pada berkas endpoint PHP yang dipanggil: 

header("Access-Control-Allow-Origin: *");header("Access-Control-Allow-Headers: *");

📞 6. Kontak Support & Bantuan Direct

Layanan Konsumen
💡
Informasi Konsumen: Jika Anda mengalami kendala operasional, masalah teknis, atau memiliki pertanyaan seputar aplikasi, silakan hubungi tim layanan pelanggan kami melalui nomor telepon/WhatsApp atau email resmi di bawah ini. Tim kami siap membantu Anda.

Telepon / WhatsApp

Fast Response

📱 089682800844

Hubungi via panggilan seluler atau pesan WhatsApp untuk bantuan cepat.

Email Support

Resmi

✉️ cloudprosolution@gmail.com

Kirimkan pertanyaan atau laporan kendala terperinci beserta tangkapan layar (screenshot).