Source Code Aplikasi Gudang CodeIgniter 4 Lengkap dengan Fitur Stok

Hampir setiap freelancer developer pasti pernah dapat project sistem inventory dari toko retail, distributor, atau gudang UMKM. Masalahnya, membangun dari nol itu capek dan lama — apalagi kalau deadline udah ketat. Artikel ini showcase aplikasi manajemen gudang & stok berbasis CodeIgniter 4 yang sudah production-ready. Sistemnya ringan, bisa jalan di shared hosting murah, dan dilengkapi fitur-fitur essensial yang 99% kebutuhan UMKM. Ada versi lite gratis dan versi pro dengan fitur advanced — tinggal customize sesuai kebutuhan klien kamu.

Kita mulai dari masalah sebenarnya: UMKM di Indonesia punya kebutuhan mendesak untuk track stok barang secara digital, tapi budget sangat terbatas. Sebagian masih pake excel atau bahkan catat manual di buku. Dari sisi developer, biasanya kita harus rebuild sistem dari awal, padahal logika dasar inventory di mana-mana sama.

Solusinya? Source code aplikasi gudang & stok yang bisa di-reuse, di-customize, dan diluncurkan dalam hitungan hari. Artikel ini akan kasih kamu blueprint lengkap plus penjelasan fitur-fitur inti yang paling sering diminta klien.

Kebutuhan Fungsional Sistem Inventory Tipikal

Sebelum dive ke code, penting ketahui bahwa mayoritas UMKM butuh fitur-fitur basic ini:

Master Data — kelola kategori barang, supplier, lokasi gudang, user & role access
Transaksi Barang Masuk — catat pembelian dari supplier dengan nomor PO
Transaksi Barang Keluar — catat penjualan atau pemakaian barang
Stok Opname — verifikasi stok fisik vs sistem untuk audit & koreksi
Alert Stok Minimum — warning otomatis kalau stok sudah di bawah threshold
Laporan Pergerakan Barang — lihat history masuk-keluar per item dengan tanggal & jumlah
Export ke Excel — financial team butuh data raw untuk analisis lebih lanjut
Multi-Gudang — pilihan untuk bisnis yang punya cabang atau lokasi penyimpanan berbeda

Sistem yang kita showcase mencakup semua poin di atas, plus sudah terintegrasi dengan user management untuk kontrol akses per role.

Arsitektur Teknis: CodeIgniter 4 + MySQL

Stack yang dipilih adalah CodeIgniter 4 karena beberapa alasan praktis:

Lightweight & Fast — framework PHP modern tapi minimal dependency, cocok untuk shared hosting
Dokumentasi Jelas — lebih mudah dari Laravel untuk project UMKM skala kecil-sedang
Database-Agnostic — bisa MySQL, PostgreSQL, atau database lain tanpa perlu overhaul besar
Built-in Security — CSRF protection, input validation, password hashing udah included
Modular Structure — easy untuk customize feature per klien

Database model menggunakan MySQL dengan struktur table standar inventory: tabel barang, kategori, supplier, gudang, stok, transaksi_masuk, transaksi_keluar, dan stok_opname. Setiap transaksi langsung update table stok, jadi data selalu fresh.

Fitur Inti & Use Case Praktis

1. Dashboard Ringkas
Halaman utama menampilkan snapshot: total item barang, jumlah stok keseluruhan, items dengan stok minimum, dan transaksi hari ini. User langsung tahu situasi gudang tanpa perlu drill down.

2. Form Barang Masuk (Purchasing)
Warehouse staff input nomor PO, pilih supplier, tanggal penerimaan, lalu list detail barang yang diterima (item, qty, harga satuan, total). Sistem auto-generate nomor transaksi dan langsung update stok real-time. Ada juga field untuk foto bukti receipt jika diperlukan.

3. Form Barang Keluar (Sales/Consumption)
Bisa set tipe keluar: penjualan, retur, pemakaian internal, atau scrap. Pilih barang, qty, alasan, dan user bisa attach catatan khusus. Sistem validasi otomatis jika qty keluar > stok tersedia — safety check agar tidak bisa overselling.

4. Stok Opname Berkala
Feature untuk audit fisik gudang. User bisa buat form baru, scanning/input item dengan qty fisik, sistem bandingkan ke stok sistem, dan auto-calculate selisih. Hasil opname bisa approve & post untuk koreksi stok, atau reject jika ada error input. Semua tercatat untuk accountability.

5. Alert Stok Minimum
Setiap barang punya field stok_minimum. Dashboard dan report punya highlight khusus untuk items yang stoknya sudah approaching atau under minimum. Bisa set email notification ke admin agar tidak ketinggalan reorder.

6. Laporan Pergerakan Barang
Fitur analitik dasar tapi powerful: user bisa filter per barang, tanggal range, dan type transaksi (masuk/keluar), lalu lihat urutan kronologis dengan saldo running setiap transaksi. Helpful untuk trace barang tertentu atau audit trail.

7. Export Excel
Semua laporan utama (stok summary, history transaksi, opname result) bisa di-export ke Excel dengan formatting rapi. Finance team bisa langsung pakai data itu untuk analisis atau reconciliation dengan akuntansi.

8. Multi-Gudang (Optional untuk versi Pro)
Jika klien punya lebih dari satu lokasi, sistem support assign barang ke gudang tertentu, transfer antar gudang, dan laporan per lokasi. Field gudang_id di tabel stok memudahkan segmentasi ini.

Keunggulan di Lapangan

Beberapa alasan kenapa sistem ini cocok untuk UMKM Indonesia:

Murah & Cepat Deploy — tidak perlu server mahal, bisa di-hosting umum dengan budget Rp 50-100rb/bulan. Installation script tinggal run, database auto-created.
User-Friendly UI — interface sederhana tanpa jargon IT berlebihan, admin atau warehouse staff bisa langsung pakai minimal training.
Offline-Tolerant — meski berbasis web, data sudah tersimpan di database lokal, jadi kalau internet putus sesaat tidak terlalu critical.
Flexible Customize — kode modular memudahkan freelancer menambah field atau fitur khusus per klien (misal: nomor seri barang, batch tracking, dll).
Audit Trail Lengkap — setiap transaksi tercatat siapa yang input, kapan, dengan data apa. Penting untuk compliance & internal control UMKM.

Versi Lite vs Pro

Sistem disediakan dalam dua varian:

Versi Lite (Gratis)
Fitur dasar: master data, transaksi masuk/keluar, stok summary, laporan simple, single gudang. Cocok untuk toko kecil atau startup yang mau trial dulu. Source code terbuka, bisa dimodifikasi sesuai kebutuhan (open source license).

Versi Pro (Berbayar)
Tambahan: multi-gudang, stok opname advanced, barcode/QR scanning integration, multi-user dengan granular permissions, email notification, API endpoint untuk integrasi sistem lain (misal: e-commerce), priority support. Harga one-time atau subscription tahunan tergantung lisensi.

Contoh Database Schema Singkat

Untuk referensi cepat, berikut struktur tabel utama:

-- Tabel Barang
CREATE TABLE barang (
  id INT PRIMARY KEY AUTO_INCREMENT,
  nama_barang VARCHAR(255) NOT NULL,
  kategori_id INT,
  sku VARCHAR(50) UNIQUE,
  harga_beli DECIMAL(10,2),
  harga_jual DECIMAL(10,2),
  satuan VARCHAR(20),
  stok_minimum INT DEFAULT 10,
  created_at TIMESTAMP,
  updated_at TIMESTAMP
);

-- Tabel Stok (jika multi-gudang)
CREATE TABLE stok (
  id INT PRIMARY KEY AUTO_INCREMENT,
  barang_id INT NOT NULL,
  gudang_id INT,
  qty_tersedia INT DEFAULT 0,
  updated_at TIMESTAMP,
  FOREIGN KEY (barang_id) REFERENCES barang(id)
);

-- Tabel Transaksi Masuk
CREATE TABLE transaksi_masuk (
  id INT PRIMARY KEY AUTO_INCREMENT,
  no_transaksi VARCHAR(50) UNIQUE,
  supplier_id INT,
  tgl_masuk DATE,
  user_id INT,
  total_qty INT,
  status ENUM('draft','posted') DEFAULT 'draft',
  created_at TIMESTAMP,
  updated_at TIMESTAMP
);

-- Tabel Detail Transaksi Masuk
CREATE TABLE detail_transaksi_masuk (
  id INT PRIMARY KEY AUTO_INCREMENT,
  transaksi_masuk_id INT,
  barang_id INT,
  qty INT,
  harga_satuan DECIMAL(10,2),
  FOREIGN KEY (transaksi_masuk_id) REFERENCES transaksi_masuk(id),
  FOREIGN KEY (barang_id) REFERENCES barang(id)
);

Struktur mirip untuk transaksi keluar, opname, dan master data lainnya. Detail lengkap ada di source code itu sendiri.

Tips Implementasi untuk Freelancer

Kustomisasi dari Awal — jangan hardcode requirement spesifik klien, bikin field atau setting configurable agar reusable untuk klien berikutnya.
User Onboarding — sertakan panduan login, screenshoot feature penting, dan video demo singkat. User adoption lebih cepat, support ticket berkurang.
Backup Rutin — setup automated backup MySQL ke cloud storage (AWS S3, Google Drive) agar klien tenang data mereka aman.
Monitoring & Logging — log error dan aktivitas, monitor jika ada query lambat (query log, slow query log). Proaktif detect issue sebelum komplain.
Update & Maintenance — CodeIgniter 4 terus di-maintain, selalu update dependency & security patch. Inform klien tentang update schedule.

Kesimpulan

Sistem manajemen gudang & stok berbasis CodeIgniter 4 adalah solusi praktis untuk mengakselerasi project inventory kamu. Stack yang ringan, mudah di-customize, dan cocok untuk UMKM yang belum siap investasi ERP enterprise. Dengan source code yang terstruktur, kamu bisa scale delivery project — mulai dari toko kecil hingga distributor menengah.

Versi lite tersedia gratis untuk pembelajaran & trial, sedangkan versi pro dengan fitur advanced seperti multi-gudang, barcode scanning, dan API tersedia dengan licensing flexible. Jika kamu tertarik melihat demo lengkap, akses source code, atau butuh customization khusus, hubungi tim DuaMasa Tech melalui form kontak atau email. Kami juga sediakan extended support & training untuk memastikan implementasi lancar di side klien kamu.