# KapokHub v2 — Model Inventory + Kartu Stok

Versi ini membangun ulang inti aplikasi sesuai dokumen *Requirement Awal*:
dari "Excel yang dipindah" menjadi **sistem transaksi + Kartu Stok** dengan
prinsip SOURCE → PROCESS → OUTPUT dan persediaan sebagai pusat.

## Cara deploy (AMAN — folder terpisah dulu)

Supaya sistem lama Bapak tetap utuh selama pengujian, pasang v2 di folder
**baru** — misal `erp` — jangan menimpa `produksi`.

1. cPanel File Manager → `public_html` → buat folder **`erp`**.
2. Upload `kapokhub-v2.zip` ke folder `erp` → **Extract**.
3. Set permission: folder 0755, file 0644, `database/` 0775, `database/kapokhub.sqlite` 0664, `public/uploads/` 0755.
4. Buka `https://kapokhub.net/erp/public/` → login pakai akun yang sama
   (database sudah termasuk akun & data termigrasi).

Kalau nanti v2 sudah terbukti benar, baru kita pindahkan jadi sistem utama
(retire folder `produksi`). Sistem lama tidak disentuh sampai saat itu.

## Yang SUDAH jadi di rilis ini (fondasi + inti terverifikasi)

- **Master Barang** — daftar item konsisten (Gelondong, Odolan, Odolan Jelek, Aten, FG per grade+packing). Bisa tambah/ubah.
- **Kartu Stok (ledger)** — jantung sistem. Saldo tiap barang = saldo awal + masuk − keluar. Klik "Kartu Stok" untuk lihat seluruh riwayat pergerakan satu barang dengan saldo berjalan.
- **Pembelian** — satu pintu untuk semua pembelian (gelondong/odolan/FG/packing), form multi-baris, barang otomatis masuk Kartu Stok. Termasuk analisis per supplier & per item.
- **Migrasi data terverifikasi**:
  - Saldo awal FG dari data bal yang akurat → **24.785,2 kg** (cocok 100% dengan sistem lama).
  - 706 nota pembelian & 3 invoice penjualan termigrasi sebagai riwayat.

## Yang PERLU tindakan Bapak/tim

- **Opname pembuka Gelondong & Odolan.** Saldo awal keduanya sengaja 0 —
  karena data lama tidak rekonsiliasi (kalau dihitung masuk−keluar hasilnya
  264 ton gelondong, jelas bukan stok nyata). Hitung fisik sekali, lalu kita
  masukkan sebagai saldo awal. (Menu opname menyusul di rilis berikutnya, atau
  saya bantu masukkan manual sekarang bila angka fisiknya sudah ada.)

## Yang MENYUSUL (rilis berikutnya, di atas fondasi ini)

Dibangun berikutnya karena butuh fondasi Kartu Stok yang sudah terbukti benar
dulu (agar data hasil migrasi aman):

- **Proses Produksi** (Kupas/Giling/Press25/Repack100) dengan batch multi-sumber
  (SOURCE→PROCESS→OUTPUT): banyak baris bahan + banyak baris hasil, loss/sortir/sisa.
- **PO (pesanan customer)** dengan alokasi dari stok (FG beli / produksi sendiri / campur).
- **Penjualan** (invoice header+detail) yang mengurangi stok saat pengiriman.
- **Mutasi, Penyesuaian, Stock Opname** (tabelnya sudah disiapkan di skema).

Semua tabel untuk modul di atas **sudah ada** di skema v2, tinggal antarmuka +
endpoint-nya. Alur inti "pembelian → kartu stok" (kriteria sukses #1 di dokumen)
sudah bisa diuji sekarang.