Lewati ke konten utama

Panduan Pengguna Git Demo ERP & POS

Selamat datang di Buku Panduan Operasional Resmi Git Demo ERP & POS. Sistem ini dirancang untuk mengintegrasikan seluruh lini bisnis enterprise Anda—mulai dari manajemen produk, operasional multi-gudang dan transfer stok, transaksi kasir Point of Sale (POS) toko fisik, pemesanan penjualan B2B (Sales Order), pengadaan barang (Purchase Order), kontrol alur persetujuan berjenjang (Approval Engine), hingga pembukuan akuntansi dan laporan keuangan multi-cabang.

Akses Sistem

Aplikasi web enterprise dapat diakses melalui browser modern di alamat http://localhost:5173, sedangkan layanan REST API Backend beroperasi pada port http://localhost:8080. Untuk operasional kasir lapangan, aplikasi Android Mobile POS siap melayani transaksi secara cepat dan terisolasi per sesi kasir.

1. Arsitektur & Prinsip Utama Sistem​

Sistem Git Demo ERP & POS dibangun di atas beberapa prinsip dasar yang menjamin integritas data dan keamanan operasional:

  1. Multi-Tenancy Mutlak (Tenant Hard Boundary): Setiap tenant (perusahaan/organisasi) memiliki batas isolasi data yang kedap (tenant_id). Pengguna dari satu perusahaan tidak akan pernah dapat melihat atau memanipulasi data milik perusahaan lain.
  2. Isolasi Akses Cabang (Branch Security Default-Deny): Pengguna ditugaskan ke cabang-cabang operasional tertentu. Pengguna hanya dapat membuat dan melihat transaksi yang terjadi pada cabang yang diotorisasikan kepadanya.
  3. Akuntansi Berpasangan (Double-Entry Bookkeeping): Seluruh pergerakan persediaan barang dan uang dicatat dengan prinsip berpasangan. Saldo stok gudang tidak disimpan dalam satu angka manual melainkan merupakan hasil agregasi kartu mutasi (Stock Ledger) yang bebas selisih (zero-drift).
  4. Sistem Pengendalian Dokumen (Stateful Business Workflow): Setiap transaksi operasional bergerak secara teratur melalui tahapan siklus bisnis (Stage), misalnya Draft $\to$ Confirmed $\to$ Done. Dokumen yang telah berstatus Done dikunci secara permanen (immutable) untuk melindungi keabsahan audit audit trail.

2. Peran & Hak Akses Pengguna (User Roles)​

Sistem menerapkan pembagian tanggung jawab pengguna berbasis wewenang (Role-Based Access Control / RBAC) serta wewenang persetujuan berbasis jabatan:

A. Peran Bawaan Sistem (Built-in Roles)​

Setiap perusahaan baru otomatis dibekali 4 peran operasional siap pakai:

  • Administrator Perusahaan (ADMIN_TENANT): Mengelola pengguna, cabang, peran, nomor seri transaksi, rute gudang, dan konfigurasi alur persetujuan.
  • Supervisor Toko (POS_ADMIN): Mengawasi operasional retail, mengatur register kasir, otorisasi diskon di luar plafon kasir, pembatalan/void struk, dan evaluasi laba harian cabang.
  • Kasir (CASHIER): Buka/tutup sesi kasir, input modal awal, scan barcode produk, terima pembayaran tunai/non-tunai, dan cetak struk belanja terenkripsi hash (tanpa izin hapus data).
  • Pengguna Umum (USER): Akses pantau baca saja (read-only) untuk monitoring transaksi tanpa hak modifikasi.

B. Peran Fungsional Kustom (Custom Roles)​

Administrator Perusahaan dapat menambahkan peran kerja spesifik sesuai struktur organisasi perusahaan:

  • Staff Penjualan (Sales): Pembuatan pesanan penjualan (Sales Order v2), penyesuaian diskon wewenang, dan penanganan retur penjualan.
  • Staff Pengadaan (Purchasing): Pembuatan Purchase Order, pemantauan status persetujuan harga beli, dan pencatatan tagihan pemasok.
  • Petugas Gudang (Warehouse): Penerimaan barang (Receipt), pengeluaran pengiriman (Delivery), transfer stok 2 langkah, perakitan paket (Assembly), dan Stock Opname fisik.
  • Staff Keuangan (Finance & Accounting): Pencatatan beban non-stok (Expense), rekonsiliasi kas sesi POS, dan verifikasi jurnal umum.
Pejabat Penyetuju Transaksi (Approver)

Wewenang untuk menyetujui dokumen transaksi bernilai besar (Approval) tidak ditentukan oleh peran akun (role), melainkan melekat pada Jabatan Karyawan (Employee Position) di modul SDM/Kepegawaian.

3. Struktur Navigasi Portal Panduan​

Portal panduan pengguna ini disusun berdasarkan alur kerja harian pengguna (Workflow-based Documentation):

Petunjuk Penggunaan

Gunakan kotak pencarian di sudut kanan atas layar (atau tekan tombol pintas keyboard Ctrl + K / Cmd + K) untuk mencari istilah, nama field, atau kode kesalahan secara instan tanpa koneksi internet.