Update besar apk finance

docs/BUDGET-FINALIZATION.md

@@ -0,0 +1,53 @@
+# Finalisasi Budget Pengeluaran
+
+## Ruang lingkup aktif
+
+Modul ini mengelola budget berdasarkan **akun pengeluaran** saja. Dimensi cabang,
+departemen, proyek, cost center, profit center, dan salesperson tidak digunakan
+oleh UI maupun proses Budget pada versi ini.
+
+Setiap dokumen Budget berlaku untuk satu perusahaan dan satu tahun fiskal. Nilai
+tahunan merupakan akumulasi Januari sampai Desember. Pengguna dapat memasukkan
+total setahun lalu membaginya rata ke 12 bulan, kemudian mengubah nominal setiap
+bulan mengikuti perkembangan usaha.
+
+## Alur dokumen
+
+1. Buat Budget tahunan berstatus `draft`.
+2. Pilih akun pengeluaran dan isi nominal per bulan.
+3. Ajukan Budget menjadi `submitted`.
+4. Penyetuju mengaktifkan atau menolak Budget.
+5. Perubahan terhadap Budget aktif dibuat melalui revisi agar histori terjaga.
+
+Hanya satu Budget berstatus `active` untuk kombinasi perusahaan dan tahun.
+
+## Monitoring
+
+- Budget: nominal akun pada Budget aktif sesuai rentang bulan.
+- Realisasi: debit bersih akun pengeluaran dari jurnal posted/reversed.
+- Komitmen: sisa nilai PO approved/diterima yang menggunakan akun budget dan
+  belum ditagihkan pada invoice supplier.
+- Sisa: Budget dikurangi realisasi dan komitmen.
+
+Budget bersifat monitoring. Proses pembuatan dan posting Jurnal tidak diubah atau
+diblokir oleh Budget. Realisasi tetap dibaca dari jurnal yang telah ter-posting.
+
+## Kompatibilitas database
+
+Kolom dan tabel dimensi dari implementasi Tahap 13 tidak dihapus secara fisik.
+Tujuannya menjaga kompatibilitas data Development/Production dan modul lain yang
+mungkin telah menyimpan referensi tersebut. Modul Budget saat ini mengabaikan
+kolom-kolom itu dan hanya memakai `account_id`. Bila dimensi diaktifkan kembali,
+harus dibuat migration baru beserta rencana migrasi data dan pengujian akses.
+
+## Pemeriksaan ringkas
+
+Jalankan dari root aplikasi:
+
+```bash
+php index.php budgetcheck
+php index.php budgetcheck workflow
+```
+
+Pemeriksaan workflow membuat data sementara, menguji Draft -> Submit -> Aktif ->
+Revisi, lalu menghapus kembali data uji tersebut.