📦 ROADMAP STRATEGIS & BLUEPRINT FILTER MODUL MONITORING STOK & LOGISTIK

Standar Arsitektur Filter, Penelusuran Mutasi Multi-Gudang, dan Analitik Valuasi Persediaan#

BUMDes Bolulango — Kabupaten Boalemo, Gorontalo Grand Design Edisi 2026.2 — Selaras dengan SAK EP Bab 13 & Tata Kelola Rantai Pasok BUMDes

---

🧭 1. Latar Belakang & Filosofi Tata Kelola Logistik Desa#

Modul Monitoring Stok & Logistik (/dashboard/inventori/stok) adalah sentral visibilitas rantai pasok fisik (supply chain) BUMDes Bolulango yang menaungi 25 unit dan sub-unit usaha (Peternakan Bio-Liv, Pabrik Pakan, Perkebunan Jagung, Sawah Padi, Toko Ritel Sembako, Sablon, Katering, hingga TPS3R).

Persediaan (inventory) adalah modal kas kerja yang berwujud fisik. Oleh karena itu:

1. Transparansi Stok Riil vs Buku Besar Akuntansi: Setiap satuan fisik di kartu stok gudang (warehouse_stocks) harus berpasangan dengan pencatatan nilai perolehan di akun Persediaan SAK EP (1-105.xx).
2. Konteks Multi-Unit & Multi-Gudang: Pengelola gudang harus mampu mengamati stok fasilitas fisik mereka secara spesifik tanpa tercampur baur dengan unit lain, namun Direksi Holding tetap memiliki hak supervisi konsolidasian penuh.
3. Pencegahan Modal Mengendap (Dead Stock): BUMDes membutuhkan penyaringan data yang cerdas untuk membedakan barang siap pakai, barang yang butuh restock darurat, dan perlengkapan sarana yang berstatus alat/peralatan.

Dokumen roadmap ini menetapkan peta jalan pengembangan fitur filter dan kemampuan audit inventori secara terencana, terukur, dan berstandar enterprise.

---

🔍 2. Baseline Arsitektur Pasca-Audit & Remediasi (Oktober 2026)#

Pada audit sistem tanggal 17 Oktober 2026, telah diselesaikan fondasi kritis berikut:

• Auto-Sync Work Context: Rute /dashboard/inventori/stok telah terintegrasi ke UnitUrlSyncProvider. Jika pengguna memilih unit kerja (misal: Unit Peternakan) di navigasi atas, filter halaman stok langsung mengunci data ke unit tersebut secara otomatis.
• Eliminasi Alarm Palsu (Zero False Alarm): Ambang batas restock diperbaiki sehingga katalog bersaldo 0 tanpa batas minimum (min_stock = 0) tidak lagi memicu alarm palsu.
• Transisi Halus SPA: Penggantian filter unit menggunakan router Next.js (router.push + useTransition) tanpa full page reload.
• Integritas Stok Riil 2 Oktober 2025: Pembersihan 11 master barang uji coba lama berhasil memulihkan saldo fisik persediaan riil ke nilai presisi Rp 36.889.780 (Pakan Mix 3.822 kg, Tray Karton 36 bal, Tray Plastik 31 pcs, Paket OVK 4 paket, APD & Alat kebersihan).

---

🗺️ 3. Peta Jalan Pengembangan Fitur (3-Phase Strategic Roadmap)#

Memuat diagram alur...

---

🟢 FASE 1: Quick Wins — Filter Esensial Harian (Target: Sprint 1)

Fokus: Memaksimalkan kenyamanan kerja staf logistik harian dan merapikan tampilan daftar barang.

1.1 Tombol Filter Status Stok Cepat (Quick Filter Chips)

Menempatkan bilah tombol pill interaktif di atas tabel inventori:

• Semua Katalog: Menampilkan seluruh produk yang terdaftar di unit aktif.
• Tersedia (Stok Fisik > 0): Fitur Utama. Menyembunyikan seluruh katalog kosong sehingga daftar barang hanya berisi item yang benar-benar siap diambil/dipakai di kandang/gudang.
• Butuh Restock: Menampilkan produk yang stoknya menipis (current_stock <= min_stock dan min_stock > 0).
• Stok Habis (0): Menampilkan barang yang kehabisan persediaan untuk evaluasi pengadaan kembali.

1.2 Filter Dropdown Kategori Barang (Category Filter)

• Dropdown kategori dinamis yang diambil dari product_categories unit terkait.
• Contoh kategori: Pakan Ternak Jadi, Bahan Baku Pakan, Kemasan & Egg Tray, Obat & Vitamin, Sarana & APD, Peralatan.
• Mendukung pencarian instan: Misal tim kandang memilih kategori "Pakan", maka tabel hanya menyajikan baris ransum pakan.

1.3 Ekspor Excel Mengikuti Filter Aktif (WYSIWYG Export)

• Fungsi exportStockLedgerExcel disesuaikan agar menerima daftar produk yang sudah difilter di layar (filtered inventory).
• Menghasilkan berkas Excel yang bersih, rapi, dan langsung siap dicetak sebagai lampiran laporan mingguan unit.

---

🟡 FASE 2: Multi-Warehouse & Audit Mutasi Rantai Pasok (Target: Sprint 2)

Fokus: Visibilitas multi-fasilitas penyimpanan dan penelusuran histori mutasi fisik barang.

2.1 Filter Fasilitas Gudang / Kandang Spesifik (Warehouse-Level Filter)

• Saat sebuah unit membawahi beberapa fasilitas fisik (contoh Unit Peternakan membawahi Kandang Dusun 3, Gudang Pakan Reguler, dan Ruang Penyimpanan Telur), pengguna dapat memilih gudang tertentu.
• Tabel akan menghitung ulang stok dan valuasi khusus untuk gudang yang dipilih berdasarkan data relasional tabel warehouse_stocks.

2.2 Filter Canggih pada Tab "Riwayat Mutasi Barang" (Audit Log Filter)

Tab mutasi ditingkatkan dari sekadar daftar 50 transaksi statis menjadi mesin audit forensik:

• Filter Tipe Mutasi: Penerimaan Pembelian/Panen (IN), Pemakaian Harian/Penjualan (OUT), atau Koreksi Fisik Opname (ADJUSTMENT).
• Pemilih Rentang Tanggal (Date Range Picker): Mampu menyaring pergerakan barang pada periode tanggal tertentu (contoh: seluruh mutasi tanggal 1 s.d. 31 Oktober 2025).
• Pencarian No. Referensi Voucher: Pengguna dapat mengetik nomor voucher (misal: MEMO-20251002-BIOLIV-02 atau nomor BAST) untuk melihat seluruh mutasi fisik yang dihasilkan dari voucher tersebut.

---

🟣 FASE 3: Analitik Valuasi Cerdas & Keputusan Strategis (Target: Sprint 3)

Fokus: Memberikan data intelijen bisnis bagi Direktur dan Manajer Keuangan untuk efisiensi modal kerja.

3.1 Klasifikasi ABC / Analisis Valuasi Pareto

Pengelompokan persediaan otomatis berdasarkan nilai modal yang terserap:

• Kelas A (Prioritas Tinggi): 10-20% item yang menyerap 70-80% total nilai persediaan (contoh: Pakan Mix konsentrat). Butuh pengawasan harian ketat dan stock opname berkala.
• Kelas B (Prioritas Sedang): 30% item dengan bobot nilai 15-20% (contoh: Tray telur, suplemen obat).
• Kelas C (Prioritas Rendah): 50% item perlengkapan habis pakai bernilai rendah (contoh: masker, sapu).

3.2 Deteksi Barang Bergerak Cepat (Fast-Moving) vs Barang Mengendap (Dead Stock)

• Algoritma membaca kecepatan mutasi keluar (OUT) dalam 30–90 hari terakhir.
• Memberikan peringatan (warning badge) jika ada barang yang tidak pernah bergerak selama lebih dari 60 hari untuk mencegah kadaluarsa atau kerusakan fisik di gudang.

3.3 Saran Pengadaan Otomatis Terpadu (Smart Reorder & Auto-PO)

• Tombol Saran Restock mengkalkulasi kebutuhan belanja berdasarkan rata-rata konsumsi harian dan lead time pengiriman pemasok, terhubung langsung ke draf modul Pengadaan Barang (/dashboard/inventori/pembelian).

---

🛠️ 4. Spesifikasi Teknis & Skema Data Terkait#

4.1 Tabel Database Supabase yang Terlibat

1. products: Menyimpan data produk, SKU, current_stock, min_stock, cost_price, unit_id, category_id.
2. warehouse_stocks: Menyimpan alokasi fisik kuantitas stok per gudang (warehouse_id, product_id, quantity).
3. stock_movements: Kartu stok riil mencatat setiap perubahan (movement_type, quantity, notes, created_at).
4. warehouses: Master daftar fasilitas gudang/kandang per unit usaha.
5. product_categories: Master kategori barang.

4.2 Arsitektur Sinkronisasi Parameter URL (Query State)

Untuk memastikan tautan filter dapat dibagikan (shareable URL) dan tetap bertahan saat halaman dimuat ulang:

text
/dashboard/inventori/stok?unitId=[UUID]&consolidated=[true|false]&status=[all|in_stock|low_stock|empty]&cat=[UUID]&wh=[UUID]

---

👥 5. Matriks Hak Akses (RBAC Matrix)#

---

📅 6. Jadwal & Milestone Pelaksanaan#

---

✍️ 7. Lembar Pengesahan Regulasi#

Dokumen roadmap ini telah diverifikasi memenuhi kaidah Standar Pendokumentasian Sistem ERP BUMDes (Grand Standard v2026.2), bebas dari notasi matematika LaTeX non-standar, mematuhi prinsip Zero Directory Collision, dan siap dijadikan acuan baku dalam sprint backlog pengembangan modul rantai pasok BUMDes.

Disahkan di: Bolulango, 17 Oktober 2026 Tim Pengembang Perangkat Lunak & Tata Kelola Digital BUMDes Bolulango