Sedia Inventory - Sistem Manajemen Inventaris & Logistik Multi-Gudang

Sebuah sistem manajemen inventaris dan rantai pasok logistik modern (enterprise inventory management platform) yang dirancang untuk melacak alokasi stok multi-gudang, otomatisasi pengadaan barang (purchase order), rekonsiliasi audit fisik (stock opname), dan visualisasi analitik kesehatan stok secara real-time. Dibangun secara menyeluruh (end-to-end) sebagai Full-Stack Engineer (Laravel & Flutter) — menghadirkan backend REST API yang aman dan terstruktur serta aplikasi desktop & tablet multi-platform yang responsif dan interaktif.

---

Ringkasan Proyek

• Kategori: Proyek Enterprise / Portofolio Showcase
• Peran: Full-Stack Engineer (Backend Laravel & Frontend Flutter)
• Teknologi Backend: Laravel 11, PHP 8.2+, MySQL / MariaDB, Laravel Sanctum, Eloquent ORM, Database Transactions, RESTful API Architecture
• Teknologi Frontend: Flutter 3.x, Dart (Sound Null Safety), BLoC Pattern (flutter_bloc), Freezed, Dio / HTTP Client, FL Chart, SvgPicture, CachedNetworkImage, Adaptive Table Layouts

---

Latar Belakang & Motivasi

Dalam operasional bisnis ritel, grosir, dan pergudangan modern, pengelolaan stok di berbagai cabang gudang sering menghadapi tantangan operasional yang nyata. Masalah umum yang kerap terjadi antara lain stock drift (selisih antara stok tercatat di sistem dengan stok fisik aktual di rak), keterlambatan informasi stok yang menipis antar cabang gudang, dan alur pengadaan barang yang terpisah menggunakan pencatatan manual atau spreadsheet yang rentan kesalahan.

Sedia Inventory dikembangkan sebagai solusi digital terpadu yang otomatis, transparan, dan mudah digunakan untuk menyelesaikan permasalahan tersebut:

• Visibilitas Stok Multi-Gudang Terpusat: Memantau alokasi dan ketersediaan stok di setiap cabang gudang secara rinci dan real-time.
• Peringatan Stok Menipis Otomatis: Memberikan notifikasi dini kepada manajer sebelum produk habis berdasarkan batas minimum stok (alert stock) yang dapat diatur.
• Siklus Pengadaan Barang Terintegrasi: Mengelola alur pembelian dari pemesanan ke pemasok hingga penerimaan barang di gudang dengan kalkulasi finansial otomatis.
• Rekonsiliasi Audit yang Transparan: Mempermudah pencatatan berkala Stock Opname fisik dengan laporan selisih yang jelas dan catatan investigasi audit yang terdokumentasi.
• Pengalaman Pengguna Multi-Platform: Menghadirkan antarmuka modern dan nyaman yang dapat diakses dengan lancar di perangkat desktop, tablet, maupun mobile.

---

Kontribusi Full-Stack Saya

Perancangan Arsitektur Sistem & Pemodelan Data Relasional

• Merancang arsitektur aplikasi full-stack secara mandiri dari awal, menghubungkan backend REST API Laravel dengan aplikasi klien Flutter multi-platform secara efisien.
• Menyusun skema basis data relasional ternormalisasi yang mencakup master data (Kategori, Merek, Satuan, Pemasok), produk, alokasi multi-gudang, faktur pembelian, dan riwayat audit.
• Menerapkan isolasi data multi-tenant berbasis perusahaan (company_id) pada seluruh model, kueri, dan middleware guna menjamin keamanan dan privasi data bisnis.

Pengembangan Backend API & Integritas Transaksi (Laravel)

• Membangun endpoint REST API yang aman dan terstruktur untuk seluruh modul, lengkap dengan validasi data masukan, transformasi respon JSON standar, dan penanganan error yang rapi.
• Menerapkan mekanisme transaksi basis data (DB::transaction) pada alur bisnis penting—seperti penerimaan stok faktur pembelian dan penyesuaian stok opname—untuk memastikan keutuhan data (ACID compliance).
• Membuat pipeline seeder basis data yang idempoten (DatabaseSeeder) berisi katalog produk komersial, data pemasok, dan cabang gudang untuk kemudahan pengujian dan demonstrasi sistem.
• Mengamankan komunikasi API menggunakan autentikasi berbasis token Laravel Sanctum lengkap dengan middleware rute terproteksi.

Pengembangan Aplikasi Klien Multi-Platform (Flutter)

• Merancang dan membangun antarmuka pengguna modern yang responsif dan dioptimalkan untuk layar desktop, tablet, dan mobile dengan tema visual profesional (Storeflow Enterprise Green).
• Mengimplementasikan arsitektur state management BLoC (flutter_bloc), menciptakan alur data event-state yang terprediksi, operasi asinkronus yang mulus, dan pembaruan antarmuka yang cepat.
• Mengintegrasikan dashboard analitik visual interaktif (FL Chart) untuk menyajikan grafik persebaran stok gudang, proporsi kategori, dan tabel peringatan stok kritis secara langsung.
• Merekayasa komponen tabel data adaptif yang mampu menampilkan informasi padat secara rapi tanpa mengalami masalah layout overflow.

Standardisasi Data, Lokalisasi & Ketahanan Media

• Mengimplementasikan pemformatan mata uang lokal (Rupiah) dan penanggalan standar Indonesia yang aman (type-safe) di seluruh tampilan transaksi dan katalog.
• Membangun logika kalkulasi otomatis untuk faktur pembelian yang menghitung subtotal item, persentase pajak, diskon, dan total keseluruhan secara presisi.
• Mengembangkan sistem pemuatan dan caching gambar jaringan yang dilengkapi gambar fallback vektor offline, memastikan tampilan katalog tetap rapi meskipun koneksi lambat atau gambar belum diunggah.

---

Fitur Produk Inti

1. Executive Dashboard & Analytics

• Kartu ringkasan KPI langsung (Total Produk, Kategori Aktif, Merek Mitra, dan Peringatan Stok Kritis).
• Grafik visual interaktif untuk memantau volume stok per gudang dan proporsi kategori produk.
• Tabel pemantauan Stock Alert otomatis dengan penanda status (Aman, Menipis, Habis) dan identifikasi SKU.

2. Manajemen Stok Multi-Gudang

• Pendaftaran dan pengelolaan data fasilitas cabang gudang regional.
• Pemetaan alokasi stok per produk di setiap cabang gudang (WarehouseStock), mempermudah mutasi dan pelacakan barang.

3. Tata Kelola Master Data Lengkap

• Katalog produk lengkap dengan kode SKU, harga beli, harga jual, satuan, batas minimum stok, dan foto produk.
• Direktori kategori, merek, satuan, dan pemasok (Supplier) lengkap dengan data kontak dan alamat.

4. Modul Pengadaan / Purchase Order (PO)

• Pemantauan siklus hidup faktur pembelian dari pemasok (Pending, Ordered, Received).
• Perhitungan otomatis subtotal item, diskon, pajak, dan total keseluruhan dalam format Rupiah.
• Riwayat jatuh tempo, atribusi pemasok, dan arsip dokumen pengadaan.

5. Audit & Stock Opname

• Pencatatan digital hasil penghitungan fisik barang di gudang dibandingkan dengan data sistem.
• Perhitungan deviasi/selisih otomatis lengkap dengan catatan investigasi hasil audit.

6. Halaman Masuk (Login) yang Modern

• Tampilan autentikasi profesional bertema logistik modern dengan tata letak adaptif dan validasi keamanan.

---

Tantangan Teknis & Solusi

1. Menjaga Konsistensi Stok Antar Gudang & Mencegah Race Condition

• Tantangan: Dalam sistem multi-gudang, kuantitas stok terus berubah akibat penerimaan barang pembelian, mutasi antar cabang, dan penyesuaian audit. Tanpa sinkronisasi yang ketat, operasi yang berjalan bersamaan dapat memicu selisih data atau stok negatif.
• Solusi: Menggunakan mekanisme transaksi basis data (DB::transaction) di backend. Setiap pergerakan stok diproses secara atomik—jika ada satu langkah yang gagal, seluruh proses dibatalkan secara aman (rollback), sehingga angka stok selalu akurat 100%.

2. Merancang Tabel Data Adaptif untuk Informasi Padat di Berbagai Ukuran Layar

• Tantangan: Tabel data inventaris memuat banyak kolom (SKU, Nama Produk, Kategori, Jumlah Stok, Batas Minimum, Harga Satuan, Badge Status, dan Tombol Aksi). Pada layar laptop kecil atau tablet, menampilkan data padat ini sering menyebabkan teks terpotong atau error layout overflow.
• Solusi: Merekayasa ulang komponen tabel menggunakan pembangun batasan tata letak dinamis (LayoutBuilder) dengan batas lebar minimum (math.max(constraints.maxWidth, targetWidth)) dan geser horizontal yang halus. Pendekatan ini membuat tabel tampil proporsional di layar lebar dan tetap mudah digeser serta dibaca di layar sempit.

3. Pengelolaan State Aplikasi yang Skalabel pada Alur Kerja Kompleks

• Tantangan: Mengatur alur data dari berbagai panggilan API interdependen, filter pencarian, form modal bertingkat, dan pembaruan dashboard secara bersamaan tanpa menyebabkan lag antarmuka (UI jank) atau desinkronisasi state.
• Solusi: Menerapkan pola arsitektur BLoC di seluruh modul aplikasi. Dengan memisahkan logika bisnis dari komponen tampilan serta memanfaatkan state Freezed yang immutable (initial, loading, success, failed), aplikasi memiliki alur data yang terprediksi, transisi asinkronus yang mulus, dan respon yang cepat.

4. Penanganan Media dan Gambar yang Andal dengan Strategi Fallback

• Tantangan: Menampilkan foto produk dan logo merek saat pengguna berada di jaringan internet yang tidak stabil, atau saat item inventaris baru belum memiliki foto unggahan.
• Solusi: Membangun pipeline pemuatan gambar multi-lapis yang menggabungkan caching disk jaringan (CachedNetworkImage), indikator pemuatan shimmer, dan sistem fallback emblem vektor lokal. Hal ini menjamin tampilan antarmuka selalu utuh dan konsisten tanpa kotak gambar rusak.

5. Standardisasi Format Mata Uang & Angka Antar Lapisan Sistem

• Tantangan: Nilai nominal harga pada faktur pembelian dan produk sering memiliki format yang bervariasi (integer, desimal, string) antara database, respon JSON, dan tampilan frontend, yang berisiko memicu crash parsing runtime atau tampilan angka yang membingungkan.
• Solusi: Mengembangkan ekstensi pemformatan type-safe dan getter khusus pada model data yang secara otomatis membersihkan, mengonversi, dan memformat seluruh nilai nominal ke format standar Rupiah Indonesia (Rp 15.800.000), menjamin konsistensi laporan keuangan di seluruh modul.

---

Pembelajaran Teknis & Poin Kunci

• Pemodelan Data Relasional Berorientasi Bisnis: Memperdalam pemahaman dalam menerjemahkan alur bisnis pergudangan yang kompleks—seperti distribusi multi-gudang, alur pembelian, dan audit stok—menjadi arsitektur basis data relasional yang kokoh dan terstruktur.
• Penguasaan State Management Enterprise: Menguasai implementasi pola BLoC pada Flutter untuk membangun arsitektur antarmuka yang modular, mudah diuji (testable), dan stabil untuk aplikasi berskala besar.
• Desain UI/UX yang Defensif untuk Aplikasi Bisnis: Memahami pentingnya merancang antarmuka bisnis yang tahan terhadap berbagai kondisi—mulai dari batas tata letak responsif, loading state, penanganan error, hingga kenyamanan pembacaan data padat.
• Integritas Data & Keandalan Menyeluruh: Menyadari pentingnya transaksi basis data, validasi masukan, dan tipe data yang aman untuk mencegah inkonsistensi data pada perangkat lunak operasional bisnis.
• Kecepatan & Sinergi Pengembangan Full-Stack: Memperoleh pengalaman langsung dalam menggabungkan keunggulan backend tangguh (Laravel) dengan fleksibilitas antarmuka multi-platform modern (Flutter) untuk menghadirkan solusi perangkat lunak yang siap pakai secara efisien.