Help Center & User Guide

Learn how to maximize SIMAJURAZ for your business operations with this detailed guide.

KB_ABOUT_OS_TITLE

KB_ABOUT_OS_P1

Proyek ini dikerjakan, disponsori, dan dikelola langsung oleh tim dari RAZ Creative Studio. Kami merilis keseluruhan basis kode (source code) aplikasi ini ke publik dengan lisensi Open Source (MIT). Ini berarti Anda bebas mengunduh, mempelajari, memodifikasi, dan menggunakan aplikasi ini untuk keperluan pribadi maupun bisnis (komersial) secara 100% gratis.

KB_NAV_TECH

KB_TECH_P1

  • KB_TECH_L1
  • KB_TECH_L2
  • KB_TECH_L3
  • KB_TECH_L4
  • KB_TECH_L5

Struktur Folder Utama (Project Structure)

SIMAJURAZ/
├── api/ # Kumpulan endpoint (Logika pemrosesan data, AJAX, Backend)
├── assets/ # File CSS utama, JavaScript interaktif, Font, dan Gambar
├── includes/ # File bantuan seperti fungsi i18n (Bahasa) dan library eksternal
├── index.php # Landing page dan antarmuka depan pengguna publik
├── RAZconfig.php # File konfigurasi dinamis (Routing koneksi database)
├── RAZinstall.php# GUI Instalasi (Otomatisasi migrasi struktur tabel DDL)
├── RAZpos.php # Halaman antarmuka Kasir (Point of Sale Utama)
├── RAZdashboard.php # Panel ringkasan analitik dan pusat komando Owner
└── README.md # Dokumentasi esensial repositori GitHub

KB_INSTALL_TITLE

KB_INSTALL_P1

KB_INSTALL_A

  1. KB_INSTALL_A1
  2. KB_INSTALL_A2
  3. KB_INSTALL_A3
  4. KB_INSTALL_A4
  5. KB_INSTALL_A5
  6. KB_INSTALL_A6

KB_INSTALL_B

  1. KB_INSTALL_B1
  2. KB_INSTALL_B2
  3. KB_INSTALL_B3
  4. KB_INSTALL_B4
  5. KB_INSTALL_B5
  6. KB_INSTALL_B6

KB_RAZ_TITLE

KB_RAZ_P1

KB_RAZ_S1

KB_RAZ_S1_D

KB_RAZ_S2

KB_RAZ_S2_D

KB_RAZ_S3

KB_RAZ_S3_D

KB_RAZ_BTN

KB_CLOUD_TITLE

KB_CLOUD_P1

KB_CLOUD_INFO

1. Registration & Store Settings

Selamat datang di SIMAJURAZ! Sebelum mulai berjualan, mari kita siapkan akun dan profil toko Anda.

A. Cara Mendaftar Akun Toko Baru

Register
  1. Buka halaman Login dengan mengeklik tombol "Masuk / Login" di pojok kanan atas halaman utama.
  2. Pada form login, perhatikan bagian paling bawah dan klik teks bertuliskan Daftar di sini. Form akan otomatis berubah menjadi form Pendaftaran.
  3. Pengisian Form Pendaftaran:
    • Nama Toko: Ketikkan nama usaha Anda (misalnya "Kedai Kopi Senja"). Nama ini akan menjadi identitas utama Anda di sistem.
    • Username: Buat sebuah nama pengguna tanpa spasi (misalnya kopisenja). Ingat username ini karena akan selalu digunakan setiap kali Anda login!
    • Password: Masukkan kata sandi rahasia yang kuat. Jangan beritahukan kepada siapa pun.
  4. Setelah semua terisi, klik tombol biru Daftar & Mulai. Anda akan langsung dibawa masuk ke halaman Dashboard!

B. Mengatur Profil & Invoice Toko

Settings
  1. Setelah masuk (login), lihat panel menu di sebelah kiri layar (Sidebar). Klik menu Pengaturan Toko berlogo roda gigi.
  2. Di tab Profil Toko, Anda bisa melengkapi:
    • Jenis Usaha: Pilih kategori bisnis Anda (F&B, Ritel, Jasa, dll).
    • Alamat Lengkap: Masukkan alamat toko fisik Anda. Alamat ini akan tercetak otomatis di struk belanja pelanggan.
    • Logo Toko: Klik kotak "Unggah Logo" untuk memilih file foto logo Anda dari komputer/HP. Logo inilah yang akan menjadi ikon di sudut nota.
  3. Selanjutnya, pindah ke tab Pengaturan Invoice di sebelah kanan atas:
    • Prefix Invoice: Ini adalah huruf awalan untuk nomor struk Anda. Jika Anda mengisi INV, maka nota pertama akan bernama INV-2026-001. Jika toko Anda bernama "Senja", Anda bisa memakai prefix SNJ.
    • Teks Header Struk: Kalimat sapaan yang muncul di bagian paling atas struk (misal: "Selamat Datang di Kedai Kami").
    • Teks Footer Struk: Kalimat penutup di bagian paling bawah struk (misal: "Barang yang sudah dibeli tidak dapat ditukar. Terima Kasih!").
    • Pilihan Template Struk: SIMAJURAZ menyediakan beberapa gaya desain struk (Minimalist, Standard, dll). Pilih salah satu, lalu klik tombol abu-abu Preview Invoice untuk melihat persis bagaimana struk itu akan dicetak nantinya!
  4. Pastikan Anda mengeklik tombol biru Simpan Pengaturan di pojok kanan bawah agar semua data tidak hilang.

C. Mengganti Password & Menambah Karyawan

Add Employee
  1. Ubah Password Sendiri: Di menu Pengaturan yang sama, buka tab Akun Saya. Masukkan password lama Anda untuk verifikasi, lalu ketik password baru. Klik Simpan.
  2. Mendaftarkan Kasir/Karyawan: Agar karyawan tidak memakai akun utama Anda (yang bisa melihat rahasia keuangan), buatkan mereka akun sendiri! Buka menu Karyawan di panel sebelah kiri.
  3. Klik tombol hijau Tambah Karyawan di sudut kanan atas. Sebuah jendela (*modal*) akan muncul.
  4. Di dalam jendela tersebut, pilih peran karyawan (misal: Kasir). Buatkan username (contoh: kasir1) dan password default (contoh: 123456). Berikan kredensial ini kepada karyawan Anda agar ia bisa login di perangkat kasir. (Karyawan nantinya bisa mengubah passwordnya sendiri via menu pengaturan mereka).

2. Inventory Management

Inventori adalah otak dari toko Anda. Pastikan Anda mengisi data barang seakurat mungkin sebelum bertransaksi.

A. Menambah & Menghapus Kategori

  1. Buka menu Inventori.
  2. Sebelum membuat barang, buatlah "Grup" barang terlebih dahulu. Klik tombol Tambah Kategori.
  3. Ketik nama kategori (contoh: "Minuman Dingin" atau "Bahan Baku"). Klik Simpan. Kategori akan muncul sebagai "Chip" tombol yang bisa diklik.
  4. Jika ada kategori salah ketik, Anda bisa menghapusnya dengan menekan ikon Tempat Sampah (Tong Sampah) merah di sebelahnya.

B. Menambah Barang Secara Detail

Inventory Modal
  1. Klik tombol hijau Tambah Barang. Sebuah jendela form besar akan menutupi layar. Mari kita isi satu per satu:
  2. Unggah Foto Produk: Di sebelah kiri, klik kotak bergambar kamera. Pilih foto makanan/produk Anda. Foto ini sangat berguna di halaman Kasir agar mata Anda cepat mengenali barang.
  3. Nama Barang & Kategori: Isi nama produk (misal: "Kopi Susu Gula Aren"). Lalu pilih Kategorinya dari daftar yang sudah Anda buat tadi.
  4. SKU atau Barcode Scanner: SKU (Stock Keeping Unit) adalah kode identitas produk.
    • Jika toko kelontong: Arahkan kursor (*mouse*) ke kolom ini, lalu tembak barcode di kemasan jajan menggunakan alat Barcode Scanner. Angka akan otomatis terisi!
    • Jika kafe/restoran: Anda bisa mengarang kode sendiri, misalnya KPS-001.
  5. HPP (Harga Pokok) vs Harga Jual:
    • HPP (Harga Pokok Penjualan): Ini adalah MODAL DASAR barang tersebut. Berapa biaya yang Anda keluarkan untuk membuat/membeli 1 item ini? Jangan dikosongkan dan jangan diisi salah! Jika HPP salah, Laba Rugi Anda tidak akan pernah akurat.
    • Harga Jual: Ini adalah harga yang akan dibayarkan oleh pelanggan di kasir.
    • Setelah mengisi keduanya, lihat ke teks kecil di bawahnya: Sistem akan otomatis menghitung Margin Keuntungan Anda (contoh: +30%).
  6. Manajemen Stok:
    • Stok Awal: Masukkan jumlah barang fisik yang ada di toko/gudang Anda saat ini. Stok ini otomatis BERKURANG SATU setiap kali kasir menekan tombol Bayar!
    • Batas Minimum Stok: Angka peringatan. Misalnya diisi `5`. Saat stok barang tersisa 5, tulisan stok akan berubah warna menjadi MERAH. Ini adalah alarm agar Anda segera kulakan/restock.
  7. Periksa kembali semua isian. Jika sudah yakin, klik tombol biru Simpan Barang di pojok kanan bawah. Selesai!

3. POS Operations

Halaman Kasir (Point of Sale) didesain untuk transaksi super cepat. Tidak boleh ada antrean yang terhambat di sini!

A. Membuka Shift Kasir (Wajib)

  1. Masuk ke menu Kasir (POS). Jika ini adalah transaksi pertama Anda di hari ini, sebuah layar gelap (*modal*) akan memblokir Anda.
  2. Ini adalah prosedur keamanan. Anda wajib menekan Buka Shift.
  3. Di dalam form tersebut, ketikkan Nominal Uang Kembalian yang saat ini ada di laci kasir tunai fisik Anda (misalnya Anda menaruh uang receh Rp 100.000).
  4. Tujuannya? Saat toko tutup nanti, uang di laci fisik harus sama persis dengan angka di laporan sistem (Modal awal + Total Penjualan Tunai).

B. Menambahkan Item ke Keranjang

  1. Di sisi kiri layar terdapat etalase barang Anda. Klik kotak bergambar produk tersebut, dan ia akan melompat masuk ke "Keranjang Belanja" di sisi kanan.
  2. Penggunaan Barcode: Anda tidak perlu repot mengeklik! Pastikan kursor (*mouse*) berada di layar, ambil produk fisik pelanggan, dan "TIT!" tembak dengan Barcode Scanner. Barang akan langsung masuk keranjang seketika. Sangat cepat!
  3. Ubah Kuantitas (Jumlah): Di panel keranjang kanan, jika pelanggan beli 3 kopi, cukup tekan tombol + di sebelah nama barang sampai angkanya jadi 3. Tekan - jika ingin mengurangi, atau tekan ikon tong sampah untuk membatalkan item tersebut.

C. Melakukan Pembayaran

Payment Modal
  1. Jika pesanan sudah sesuai, klik tombol hijau raksasa BAYAR di pojok kanan bawah. Jendela Pembayaran akan muncul.
  2. Lihat angka besar di tengah: Itu adalah Total Tagihan pelanggan.
  3. Pilih Metode Pembayaran:
    • Tunai (Cash): Jika pelanggan menyerahkan uang kertas. Ketikkan jumlah uang yang diberikan (misal: Tagihan Rp 45.000, pelanggan memberi uang Rp 50.000. Ketik "50000" di kolom Nominal Dibayar). Sistem akan otomatis memunculkan tulisan Kembalian: Rp 5.000.
    • Tombol Cepat Uang Pas: Jika malas mengetik, kami sediakan tombol cepat di bawahnya (Uang Pas, 20.000, 50.000, 100.000). Klik saja tombol tersebut!
    • Transfer / QRIS / Non-Tunai: Jika pelanggan bayar via m-banking. Pilih opsi ini. Kolom nominal akan hilang karena pembayaran non-tunai dianggap SELALU PAS (tidak ada kembalian). Uang ini tidak akan tercatat masuk laci kasir fisik, melainkan kas digital.
  4. Klik tombol besar Proses Bayar. Transaksi selesai! Stok barang di inventori langsung terpotong.

D. Mencetak & Membagikan Struk

Receipt Modal
  1. Setelah "Proses Bayar" ditekan, jendela baru akan muncul menampilkan wujud asli struk (lengkap dengan logo toko Anda!).
  2. Di bawah gambar struk tersebut, ada 3 tombol:
  3. Tombol Cetak Struk: Akan menyambungkan layar ke Printer Thermal Bluetooth/USB Anda. Struk fisik akan keluar.
  4. Tombol Bagikan: Akan membuat file struk digital yang bisa langsung Anda kirim via WhatsApp ke nomor pelanggan. Go Green!
  5. Tombol Tutup: Jika pelanggan tidak butuh struk. Layar kasir akan bersih kembali siap untuk pelanggan berikutnya.

4. Finance & Cash Flow

Modul Keuangan memantau aliran darah bisnis Anda (uang masuk dan keluar). Arus Kas ini berinteraksi langsung dengan Laba Rugi akhir.

A. Membaca Laporan Laba Rugi

  1. Buka menu Laporan > Laba Rugi.
  2. Di sini, Anda tidak perlu menghitung manual lagi. Rumus cerdas kami bekerja 24 jam: (Semua Uang Penjualan Barang) DIKURANGI (Total HPP / Modal Barang Tersebut) DIKURANGI (Semua Pengeluaran Ekstra Toko).
  3. Hasil akhirnya akan tampil besar di kotak Laba Bersih. Laba ini menunjukkan keuntungan riil Anda setelah dipotong beban operasional.
  4. Gunakan ikon Kalender di atas untuk memfilter: Apakah Anda ingin melihat Laba hari ini saja? Laba seminggu ini? Atau bulan lalu?

B. Menginput Pemasukan Lain (Selain Jualan)

Income Modal
  1. Buka menu Keuangan. Anda akan berada di tab Arus Kas (Buku Kas).
  2. Jika ada uang masuk yang BUKAN dari jualan kasir (contoh: Uang hasil jual kardus bekas minuman, atau uang parkir), klik tombol hijau Pemasukan.
  3. Di form yang muncul: Ketikkan Nominal (contoh: 25000) dan Deskripsi (contoh: "Jual kardus bekas"). Klik Simpan. Uang ini akan mendongkrak Laba Bersih Anda.

C. Menginput Pengeluaran Toko

Expense Modal
  1. Ini fitur SANGAT PENTING. Setiap uang yang keluar dari laci untuk operasional toko harus dicatat! Jika tidak, Laba Bersih Anda akan terlihat palsu (seolah besar padahal banyak hutang listrik).
  2. Klik tombol merah Pengeluaran.
  3. Di form yang muncul: Ketikkan Nominal (contoh: 150000) dan Deskripsi (contoh: "Beli Gas Elpiji 3Kg" atau "Bayar Tukang Sampah"). Klik Simpan.
  4. Uang ini akan otomatis mengurangi Laba Bersih di Laporan Akhir.

D. Menghapus / Mengedit Catatan yang Salah

  1. Di bawah tombol tadi, ada Tabel Riwayat Buku Kas yang menampilkan list semua uang masuk & keluar.
  2. Cari catatan yang salah (misal typo mengetik 150.000 padahal 15.000).
  3. Lihat ke ujung paling kanan baris tabel tersebut, di bawah kolom "Aksi".
  4. Klik ikon Pensil (Edit) untuk mengubah nominalnya, ATAU klik ikon Tempat Sampah Merah (Hapus) untuk menghapus catatan tersebut sepenuhnya dari sistem.

5. Employee Payroll

SIMAJURAZ memiliki modul Payroll cerdas. Gaji yang Anda bayarkan ke karyawan akan langsung tercatat sebagai pengeluaran toko tanpa perlu mencatat dua kali di buku!

A. Memproses Penggajian

Payroll Modal
  1. Buka menu Karyawan di panel sebelah kiri.
  2. Abaikan tab Daftar Karyawan, klik tab di sebelahnya: Penggajian (Payroll).
  3. Di sana terdapat tombol hijau terang bertuliskan Bayar Gaji. Klik tombol tersebut! Jendela *Form Slip Gaji* akan muncul.
  4. Pengisian Rincian Gaji:
    • Pilih Karyawan: Klik dropdown dan pilih nama kasir/staf yang akan digaji. (Otomatis mengambil data dari Daftar Karyawan).
    • Gaji Pokok: Masukkan gaji dasar bulanan/hariannya. Misal: 2000000.
    • Bonus: Jika target penjualannya bagus, berikan ia bonus. Masukkan nominalnya (opsional). Misal: 100000.
    • Potongan / Kasbon: Jika karyawan tersebut punya kebiasaan mengutang barang dagangan atau utang kasbon, masukkan total utangnya di form ini. Ini akan memotong gajinya. Misal: 50000.
  5. Perhatikan teks tebal di bawahnya! Sistem telah menghitung Total Gaji Bersih secara *live* (Gaji + Bonus - Kasbon).
  6. Klik tombol Simpan & Bayar. Selesai! Uang tersebut telah masuk ke buku Arus Kas toko sebagai beban Pengeluaran Gaji.

B. Cetak Bukti Slip Gaji

  1. Karyawan Anda butuh bukti tertulis? Bisa! Setelah ditekan simpan tadi, lihat ke "Tabel Riwayat Penggajian" di bawahnya.
  2. Cari catatan gajinya, geser ke paling kanan pada kolom Aksi, lalu klik tombol biru bertuliskan Download Slip.
  3. Browser akan langsung mengunduh file PDF profesional yang menampilkan rincian persis potongan dan bonus gajinya, lengkap dengan logo toko Anda di atasnya!

6. Premium COGS Calculator

Fitur rahasia para pengusaha F&B (Kafe/Resto). Kalkulator ini akan membongkar Harga Modal (*Food Cost*) asli dari sebuah resep secara terperinci.

Cara Simulasi Harga Racikan Makanan:

HPP Calculator
  1. Buka menu Kalkulator HPP.
  2. Klik tombol besar Buat Perhitungan Baru. Anda akan dihadapkan pada satu halaman form panjang yang terbagi 4 Tahapan. Mari kita isi dari atas ke bawah:
  3. Tahap 1 (Info Dasar): Beri nama resep ini. Misalnya: "Kopi Susu Gula Aren Cup Medium". Masukkan juga target jumlah porsi jika resep ini dibuat masal (biasanya 1 porsi saja).
  4. Tahap 2 (Input Bahan Baku Utama): Ini adalah bagian terseru. Klik tombol + Tambah Bahan.
    • Nama Bahan: Ketik "Biji Kopi Arabica".
    • Harga Beli Mentah: Berapa Anda beli 1 bungkusnya? Misal: Rp 100.000.
    • Berat Total Mentah: 1 bungkus itu berapa isinya? Misal: 1000 Gram (1 Kg).
    • Takaran Untuk 1 Porsi: Untuk bikin 1 cup kopi, butuh berapa gram? Misal: 15 Gram.
    • AJAIB! Kalkulator akan memecah harga Rp 100rb/kg tadi dan menyimpulkan bahwa modal kopi untuk 1 cup tersebut hanyalah Rp 1.500 perak! Lakukan hal yang sama untuk Susu UHT dan Gula Aren.
  5. Tahap 3 (Input Bahan Kemasan & Ekstra):
    • Klik tombol tambah di form bahan kemasan. Masukkan item seperti "Gelas Cup Plastik" (misal: Beli 50pcs harga 20rb, berarti 1pcs modalnya Rp 400). Masukkan sedotan, kantong plastik, dll.
    • Jangan lupa biaya gas elpiji dan tenaga listrik barista per porsi agar tidak bocor alus!
  6. Tahap 4 (Kalkulasi Target Margin):
    • Setelah sistem menghitung total keseluruhan modal dari Tahap 2 & 3 (misalnya Total HPP racikan = Rp 5.000), saatnya menentukan untung!
    • Di kolom Target Margin, ketik berapa persen untung yang Anda inginkan. Misal: 50%.
    • Sistem akan menyimpulkan: Untuk dapat untung 50%, Anda HARUS menjual produk ini di harga minimal Rp 10.000! Ini adalah fungsi Rekomendasi Harga Jual.
  7. Setelah puas melihat hasilnya, Anda bisa keluar. Jika Anda menjual produk ini, jangan lupa mendaftarkannya di menu **Inventori** dan masukkan nilai Rp 5000 di kolom HPP, dan Rp 10000 di kolom Harga Jual!

7. Profit Sharing System

Membuka toko dengan modal patungan teman/saudara? Jangan berantem masalah persentase untung! Gunakan fitur ini agar perhitungannya *fair* dan transparan.

A. Mendaftarkan Nama Investor

Profit Share
  1. Buka menu Keuangan. Abaikan tab Arus Kas, klik tab di sebelahnya: Bagi Hasil (Profit Share).
  2. Di bawah tulisan Distribusi Bagi Hasil, klik tombol tambah (ikon orang+). Jendela modal akan muncul.
  3. Form Investor:
    • Nama Investor: Masukkan nama partner bisnis Anda (misal: Bapak Budi).
    • Porsi / Persentase: Berapa kesepakatan jatah bersihnya? Ketik angkanya saja (misal: 30 untuk 30%). Pastikan total porsi semua investor tidak lebih dari 100%.
  4. Klik Simpan. Nama Bapak Budi kini muncul di tabel investor dengan persentase 30%.

B. Menghitung Pencairan Laba Bulanan

  1. Setiap menjelang awal bulan tutup buku (tanggal 30/31), masuk kembali ke halaman ini.
  2. Lihat panel Riwayat Laporan Bagi Hasil. Klik tombol biru Generate Laporan Bagi Hasil.
  3. Sebuah jendela kalender akan muncul. Pilih Rentang Tanggal (Pilih tanggal 1 sampai tanggal 30/31 di bulan tersebut).
  4. Klik Proses & Kalkulasi.
  5. Apa yang terjadi? Sistem akan berlari memeriksa total Laba Bersih Anda pada bulan tersebut (Total Penjualan - HPP - Beli Gas - Gaji Karyawan). Misalkan laba bersih final adalah Rp 10.000.000.
  6. Sistem akan memecahkan uang 10 Juta itu secara otomatis! Sistem mencatat: Jatah Bapak Budi (30%) adalah Rp 3.000.000, Jatah Owner (Sisa 70%) adalah Rp 7.000.000.
  7. Riwayat pembagian ini akan abadi di tabel. Anda bisa klik Cetak PDF untuk diserahkan ke Bapak Budi sebagai bukti transparansi. Jika uang sudah ditransfer, klik tombol Tandai Sudah Dibayar agar laporannya berstatus hijau (Lunas).

8. Print & Export PDF Reports

Kecanggihan sebuah sistem terletak pada kemampuan mencetak laporannya. Di SIMAJURAZ, hampir setiap halaman punya tombol Ekspor PDF sekali klik yang akan men- *download* dokumen ukuran A4 yang sangat rapi untuk diserahkan ke atasan.

Cara Mencari Tombol Ekspor di Setiap Fitur:

Reports
  • Laba Rugi Lengkap: Buka menu Laporan > Laba Rugi. Atur filter tanggal (Dari - Sampai). Setelah angka labanya muncul, klik tombol abu-abu berlogo PDF merah bertuliskan Ekspor PDF di pojok kanan atas tabel. Laporan final akan terunduh.
  • Laporan Riwayat Struk (Transaksi): Buka menu Laporan > Transaksi Penjualan. Di sini Anda bisa melihat daftar struk 1, struk 2, dst. Cari tombol Ekspor PDF di atas tabel untuk men-download log seluruh nota penjualan Anda bulan itu.
  • Laporan Arus Kas (Uang Masuk/Keluar): Buka menu Laporan > Arus Kas. Tekan tombol Ekspor PDF. Laporan ini bagaikan mutasi rekening Bank Anda, isinya runtutan tanggal kapan beli gas, kapan uang parkir masuk, dsb.
  • Laporan Nilai Gudang (Inventori): Buka halaman Inventori. Tombol Ekspor PDF di sini berfungsi untuk "Opname Stok". Sistem akan mencetak daftar barang, sisa stok, dan mengkalikannya dengan HPP untuk memberitahu Anda, "Oh, nilai seluruh harta karun barang dagangan saya di gudang saat ini adalah 25 Juta Rupiah".
  • Slip Gaji & Bagi Hasil: Seperti yang dijelaskan di bab sebelumnya, Slip Gaji Karyawan didownload dengan mengeklik tombol Download Slip di menu Karyawan. Sedangkan Laporan Investor didownload di menu Bagi Hasil. Keduanya juga berwujud file PDF siap *print*.