# Finalisasi Modul Aset Tetap

## Arsitektur kanonis

- Menu resmi: `Aset Tetap` → `/fixedassets`.
- Controller transaksi: `Fixedassets.php`.
- Aturan bisnis dan transaksi database: `FixedAssetService.php`.
- Query register, detail, lookup, opname, laporan: `FixedAssetModel.php`.
- `Asset.php` dan `Lokasiasset.php` hanya alias kompatibilitas. Keduanya tidak lagi boleh menulis stok, jurnal, atau aset.

## Alur perolehan

`Draft → Diajukan → Disetujui/Ditolak → Dikapitalisasi`

Dokumen pendukung wajib tersedia sebelum pengajuan. Pembuat dan approver dipisahkan, kecuali Master Admin yang memang memiliki seluruh kewenangan aplikasi.

### Input langsung

- `Buat jurnal kapitalisasi`: debit akun aset, kredit akun lawan yang dipilih.
- `Hubungkan jurnal posted`: tidak membuat jurnal kedua; jurnal sumber hanya boleh dipakai satu aset.
- `Saldo awal/tanpa jurnal baru`: khusus migrasi/saldo awal yang memang telah direkonsiliasi. Alasan dan dokumen wajib lengkap.

### Dari gudang

- Hanya item aktif dan barcode `available` yang dapat dipilih.
- Biaya berasal dari inventory ledger, bukan input manual.
- Kapitalisasi menggunakan transaksi database dan row locking.
- Otomatis membuat jurnal debit Aset / kredit Persediaan, inventory ledger keluar, stock log, item movement, dan memperbarui barcode serta cache stok.
- Barang `UNIT` selalu satu barcode untuk satu aset. Barang `QTY` dapat dikapitalisasi sebagian sesuai saldo tersedia.

## Siklus hidup

- Penyusutan bulanan/catch-up tidak boleh melewati nilai residu dan unik per aset-periode.
- Penambahan nilai, impairment, revaluasi, pelepasan/penjualan, hilang, dan rusak menghasilkan jurnal serta event immutable.
- Transfer lokasi, perubahan PIC, maintenance, dan opname tersimpan sebagai audit trail.
- Koreksi transaksi posted dilakukan melalui reversal event terakhir; histori tidak dihapus.
- Hasil opname `hilang/rusak` tidak otomatis menjurnal. Setelah opname diposting, lakukan mutasi resmi pada aset terkait agar user memverifikasi nilai dan akun sebelum posting.

## Dokumen dan laporan

- Kartu aset dan histori mutasi PDF.
- Label QR yang membuka identitas aset company-scoped.
- Berita acara opname PDF dengan pembuat, approver, dan poster.
- Daftar aset, jadwal penyusutan, maintenance, mutasi/audit, serta rekonsiliasi subledger ke buku besar tersedia dalam layar, PDF, dan Excel.

## Database produksi

Sebelum deploy:

1. Backup database dan file lampiran.
2. Jalankan migrasi berurutan sampai `20260906000900`.
3. Periksa mapping `inventory`, `asset_disposal_gain`, dan `asset_disposal_loss` untuk tiap perusahaan.
4. Lengkapi mapping akun default pada setiap kategori aset.
5. Tinjau aset legacy yang memakai mode `no_journal`, lalu rekonsiliasi saldo awal dengan GL.
6. Jalankan `php index.php fixedassetcheck` dan tindak lanjuti semua baris `[WARN]`.
7. Uji maker/approver dengan dua akun non-Admin dan satu Master Admin.

Migrasi `20260906000400` menambah workflow, company scope, histori, attachment scope, indeks, dan event immutable. Migrasi `20260906000500` mengubah nominal aset menjadi `DECIMAL` agar nilai setelah koma tidak hilang. Migrasi `20260906000600`–`20260906000700` menormalkan akun harga perolehan aset legacy: kategori yang semula menunjuk akun induk diarahkan ke akun detail yang dapat menerima posting. Migrasi `20260906000800` mengisi nilai draft aset gudang lama yang masih nol berdasarkan inventory ledger. Migrasi `20260906000900` melengkapi `stock_logs.company_id`, backfill dari master barang, dan indeks tenant untuk kapitalisasi/reversal aset gudang. Production wajib meninjau nama/kode akun detail dan nilai draft hasil migrasi bersama Finance sebelum go-live.

## Kontrol akses

- `can_view`: daftar, detail, lookup, dan laporan layar.
- `can_create`: membuat dan mengajukan draft perolehan/opname.
- `can_update`: mengubah draft/master, transfer, PIC, dan maintenance.
- `can_approve`: approve/reject perolehan dan opname.
- `can_post`: kapitalisasi, penyusutan, mutasi nilai, posting opname, dan reversal.
- `can_export`: PDF, Excel, kartu aset, dan berita acara.

## Checklist penerimaan

- Input langsung dan dari gudang berjalan sampai kapitalisasi.
- Posting gudang hanya sekali walaupun tombol diklik ulang.
- Debit dan kredit setiap jurnal aset seimbang.
- Barcode/qty, inventory ledger, stock log, item movement, dan stok item konsisten.
- Penyusutan periode yang sama tidak terduplikasi dan tidak di bawah residu.
- Periode tertutup menolak kapitalisasi, penyusutan, mutasi, dan reversal.
- Aset perusahaan lain tidak muncul pada register, lookup, detail, lampiran, atau laporan.
- Tugas utama dapat dilakukan pada laptop dan HP; modal menjadi layar penuh di HP.