# TODO — Sistem Inventaris, Operasional & Keuangan

**Fitur Baru - Purchase dan Sales Return**
**Akan Dilanjutkan - Penambahan Pagination:** Setiap page harus ada pagination, karena nantinya akan ada ribuan data. sehingga harusnya juga tidak hanya pagination tapi termasuk bagaimana agar page tetap optimal meskipun datanya sudah ribuan.

## ✅ Fase 1 — Database (Migration)

- [x] `categories`, `products` (dengan cache `qty_on_hand`)
- [x] `suppliers`, `customers`
- [x] `purchase_orders`, `purchase_order_items`, `purchase_payments`
- [x] `stock_batches` (inti FIFO), `stock_movements` (audit trail stok)
- [x] `sales_orders`, `sale_items`, `sale_item_allocations` (mapping FIFO), `sales_payments`
- [x] `expense_categories`, `expenses`
- [x] `cash_flows` (ledger kas masuk/keluar)
- [x] `users` (custom: username + role), `activity_logs` (custom, manual)

## ✅ Fase 2 — Activity Log Otomatis

- [x] Model `ActivityLog`
- [x] `GlobalActivityObserver` — mencatat created/updated/deleted semua model otomatis
- [x] `AppServiceProvider` — auto-register observer ke semua model di `app/Models`, tanpa edit tiap model

## ✅ Fase 3 — Model Eloquent + Relasi

- [x] Semua model dibuat lengkap dengan relasi (`Category`, `Product`, `Supplier`, `Customer`,
      `PurchaseOrder`, `PurchaseOrderItem`, `StockBatch`, `PurchasePayment`,
      `SalesOrder`, `SaleItem`, `SaleItemAllocation`, `SalesPayment`,
      `ExpenseCategory`, `Expense`, `StockMovement`, `CashFlow`, `User`)
- [x] Standar: kolom `decimal` (uang) di-cast `'amount' => 'decimal:2'` dst di semua model
      supaya konsisten sebagai angka, bukan string mentah dari MySQL — **wajib diikuti**
      kalau nambah kolom uang baru di model manapun nanti.
- [x] `Category`, `Customer`, `Supplier`, `ExpenseCategory` sengaja tetap minimal
      (murni master data, tanpa logika) — bukan kelupaan.

## ✅ Fase 4 — Service Layer (Logika Bisnis Inti)

- [x] `StockService` — FIFO allocation, sync qty_on_hand, batch breakdown, reverse allocation (retur)
- [x] `CashFlowService` — pencatat ledger kas masuk/keluar
- [x] `PurchaseOrderService` — create PO + item + auto stok masuk + payment
- [x] `SalesOrderService` — create SO + item + auto FIFO + HPP + payment
- [x] `ExpenseService` — create expense + catat kas keluar
- [x] `DocumentNumberService` — nomor otomatis `PO/{Bulan Romawi}/{Tahun}/{Urut}`, reset per bulan

## ✅ Fase 5 — Controller & Validasi (Web)

- [x] `PurchaseOrderController` + `StorePurchaseOrderRequest` + `StorePurchasePaymentRequest`
      — plus `edit()`/`update()`/`destroy()` + `UpdatePurchaseOrderRequest` (edit/hapus cuma
      untuk PO yang belum dibayar sama sekali & barangnya belum kepakai)
- [x] `SalesOrderController` + `StoreSalesOrderRequest` + `StoreSalesPaymentRequest`
      — plus `edit()`/`update()`/`destroy()` + `UpdateSalesOrderRequest` (edit/hapus cuma
      untuk transaksi yang belum dibayar sama sekali)
- [x] Routes snippet siap tempel ke `routes/web.php`
- [x] `ProductController`, `CategoryController` (CRUD lengkap, pola sama seperti contoh di atas)
- [x] `SupplierController`, `CustomerController` (CRUD lengkap)
- [x] `ExpenseController`, `ExpenseCategoryController` (CRUD lengkap + pakai `ExpenseService`,
      termasuk `ExpenseService::update()`/`delete()` baru supaya `cash_flows` tetap sinkron)
- [x] `routes/web.php` sudah full diupdate dengan resource routes 6 controller di atas
      (index/show di grup `auth`, create/store/edit/update/destroy di grup `role:superadmin`)
- [x] Model `Category`, `Supplier`, `Customer`, `ExpenseCategory` ditambahkan `$fillable` + relasi yang dibutuhkan controller (`products()`, `purchaseOrders()`, `salesOrders()`, `expenses()`)

## ✅ Fase 6 — Laporan (Reports)

- [x] `ReportService` — Stok breakdown, Laba Rugi, Cash Flow, AP (hutang), AR (piutang)
- [x] `ReportController` + routes
- [x] View/Blade untuk tiap laporan (Stok, Laba Rugi, Arus Kas, AP, AR) — sudah ada semua
- [x] Export Excel untuk semua laporan (`ReportExportController` + `ExcelStyler`, lihat catatan
      fitur baru di atas)

## ✅ Fase 7 — Autentikasi & Otorisasi

- [x] `AuthController` (login/logout) + `LoginRequest` (login pakai `username`, dengan rate-limit)
- [x] `EnsureUserHasRole` middleware (pakai: `->middleware('role:admin,finance')`)
- [x] Daftarkan middleware `role` di Kernel.php (manual, lihat `AUTH_SETUP.md`)

## 🟡 Fase 8 — Views / Frontend (sebagian selesai)

- [x] Layout master `layouts/app.blade.php` — semua view lain wajib `@extends` dari sini
- [x] Sidebar (`layouts/partials/sidebar.blade.php`) — grup menu semua modul, responsive (drawer di mobile)
- [x] Topbar (`layouts/partials/topbar.blade.php`) — hamburger mobile + judul halaman
- [x] Halaman login (`auth/login.blade.php`) — desain 2 kolom, standalone (tanpa sidebar)
- [x] Dashboard (`dashboard.blade.php`) — KPI, ringkasan laba rugi, piutang/hutang, stok menipis
- [x] `PurchaseOrderController::create()` + route `purchase-orders.create` (didaftarkan
      SEBELUM `resource(['index','show'])` supaya path literal `/create` tidak ketangkep
      wildcard `{purchaseOrder}` milik route `show`)
- [x] Halaman index PO (`purchase-orders/index.blade.php`) — tabel + status badge + link detail
- [x] Form input PO (`purchase-orders/create.blade.php`) — dynamic add/remove item baris pakai
      Alpine, select2 per baris (produk + supplier), input Rupiah terformat, form submit biasa
      (bukan AJAX, sesuai pola controller yang redirect/back()->withErrors())
- [x] Form input SO (dynamic add item baris, tampilkan stok tersedia per produk)
- [x] Halaman detail PO (`purchase-orders/show.blade.php`) — breakdown item + sisa batch,
      ringkasan pembayaran, riwayat pembayaran, form tambah pembayaran (superadmin, muncul
      kalau masih ada sisa hutang), edit inline per pembayaran (lihat catatan fitur baru di atas)
- [x] Halaman detail SO (breakdown batch FIFO yang kepakai, histori pembayaran, edit inline per
      pembayaran sama seperti PO)
- [x] Halaman Stok (`stock/index.blade.php`, route `stock.index`, menu "Persediaan → Stok") —
      view cek cepat: search instan nama produk (client-side), expand/collapse breakdown batch
      per produk, KPI ringkas. Data dari `ReportService::stockReport()` yang sama dipakai
      `reports.stock`, cuma tampilannya beda (operasional harian vs laporan formal)
- [x] Halaman index untuk Product, Category, Supplier, Customer, Expense, ExpenseCategory —
      1 view per modul, create/edit pakai modal Alpine.js + AJAX (bukan halaman terpisah),
      konsisten dengan token desain (border tipis, bukan shadow). Controller-nya sekarang
      return JSON untuk store/update/destroy (route create/edit dihapus dari `routes/web.php`
      karena tidak dipakai lagi).
- [x] Halaman laporan (Stok, Laba Rugi, Cash Flow, AP/AR) — sudah ada semua + export Excel
      (lihat Fase 6 & catatan fitur baru di atas)
- [ ] Penambahan Pagination pada setiap page yang memungkinkan diberikan pagination

## 🟡 Fase 9 — Data Pendukung

- [x] Seeder data contoh (kategori, produk, supplier, customer) untuk development/testing —
      `CategorySeeder` (6 kategori), `ProductSeeder` (18 produk, terhubung ke kategori via nama,
      tanpa `sku` karena kolom itu sudah sengaja didrop dari tabel `products`, `qty_on_hand`
      sengaja 0 karena itu cache dari `StockService`), `SupplierSeeder` (4 supplier),
      `CustomerSeeder` (5 customer). Semua sudah didaftarkan di `DatabaseSeeder` dengan urutan
      `UserSeeder → CategorySeeder → ProductSeeder → SupplierSeeder → CustomerSeeder`.

---