ProjectRAB adalah aplikasi manajemen proyek dan kontrol biaya untuk kontraktor, interior & fit-out, MEP, developer properti, dan konsultan biaya. Satu alur dari RAB pertama sampai termin terakhir: susun RAB, setujui anggaran, belanja lewat PO, catat realisasi biaya, pantau progres lapangan, dan tagih klien per termin. Setiap rupiah tercatat, disetujui, dan dapat ditelusuri.

Dibangun dengan Laravel 13, Inertia.js 2, Vue 3 (TypeScript), dan Tailwind CSS sebagai satu aplikasi monolit yang mudah dipasang di server sendiri.

---

✨ Keunggulan

1. RAB bertingkat dengan revisi
   Kelompok dan item pekerjaan, harga satuan langsung atau dari komponen (material, upah, alat), overhead, margin, diskon, dan pajak opsional. RAB melewati alur Draft → Diajukan → Disetujui. Perubahan setelah disetujui menjadi revisi baru dengan histori dan perbandingan per item.
2. Sisa anggaran yang jujur
   Komitmen PO ikut dikurangkan sebelum barangnya ditagih, jadi anggaran tidak terlihat longgar padahal sudah dipesan. Begitu tagihan diposting, komitmen turun sebesar nilai yang sama, tanpa hitung ganda.
3. Realisasi biaya dengan persetujuan
   Pengeluaran berbukti melewati alur Draft → Diajukan → Disetujui → Diposting. Koreksi dilakukan lewat void beralasan, bukan dihapus.
4. Progres tertimbang nilai pekerjaan
   Bobot aktivitas diambil dari nilai item RAB, jadi progres proyek mencerminkan nilai pekerjaan, bukan sekadar jumlah tugas selesai.
5. Termin & tagihan klien
   Termin persentase atau nominal dari nilai kontrak, invoice PDF, pembayaran sebagian, void pembayaran, dan sisa piutang per proyek.
6. Dashboard kontrol biaya
   Kartu ringkasan, tren biaya aktual, donat biaya per kategori, anggaran vs realisasi per proyek, peringatan anggaran (80% dan 100%), termin jatuh tempo, dan aktivitas yang melewati target. Pengguna tanpa akses keuangan melihat progres dan status proyek.
7. Presisi desimal
   Semua angka uang dihitung ulang di server dengan aritmetika desimal (bcmath), bukan floating point. Pratinjau di browser memakai rumus yang identik.
8. Panduan bergambar di dalam aplikasi
   Menu Panduan Penggunaan berisi 11 bagian dengan langkah, ilustrasi layar, alur status, dan peran yang terlibat.

---

🚀 Fitur & Modul

Modul	Isi
Dashboard	Filter periode/status/proyek, kartu ringkasan, tren biaya, biaya per kategori, anggaran vs realisasi per proyek, peringatan anggaran, tabel progres proyek, daftar perlu tindakan, termin jatuh tempo, aktivitas terlambat.
Proyek	Nomor otomatis PRJ-2026-0001, klien, lokasi, periode, PM, anggota, nilai kontrak, status Draft → Direncanakan → Aktif ⇄ Ditunda → Selesai (atau Dibatalkan), arsip. Detail proyek bertab: Ringkasan, RAB, Progres, Pengeluaran, Pembelian, Termin, Dokumen, Riwayat.
RAB & Estimasi	Item langsung atau komponen, katalog item, duplikasi baris & RAB, input keyboard, import/export Excel, PDF beridentitas perusahaan, revisi dengan perbandingan per item.
Progres	Aktivitas dengan penanggung jawab, target, status, foto, dan histori perubahan.
Pembelian	PO → penerimaan barang (parsial) → tagihan, komitmen dihitung otomatis.
Pengeluaran	Kategori biaya, supplier/penerima, pajak, bukti transaksi privat, persetujuan, posting, void.
Termin & Tagihan	Termin per proyek, invoice PDF, pembayaran sebagian, sisa piutang.
Laporan	8 laporan: RAB per proyek, ringkasan proyek & progres, realisasi biaya per kategori, anggaran vs realisasi, komitmen pembelian, histori revisi anggaran, daftar pengeluaran, tagihan & pembayaran termin. Tampil di layar, cetak, PDF, dan Excel dengan angka yang sama.
Data Master	Klien & supplier dalam satu direktori, katalog item, satuan, kategori biaya.
Sistem	Role & permission, pengguna, menu dinamis, profil perusahaan, pengaturan sistem, audit log, mode gelap, antarmuka Bahasa Indonesia.

---

👥 Peran Bawaan

Peran	Tugas
Owner	Menyetujui RAB, PO, dan pengeluaran; melihat seluruh proyek.
Project Manager	Mengelola proyek, tim, aktivitas lapangan, dan pembelian.
Estimator	Menyusun RAB, katalog harga, dan revisi anggaran.
Finance	Memposting biaya, mengelola termin, dan pembayaran klien.
Staff	Memperbarui progres pekerjaan dari lapangan.

Ditambah Super Admin untuk administrasi sistem. Setiap permission bisa diatur ulang per peran dan selalu diperiksa di backend, termasuk akses per proyek.

---

💻 Kebutuhan Sistem

• PHP 8.4 atau 8.5 (ekstensi bcmath, gd, mbstring, pdo_mysql, zip, dll.)
• Composer 2.x
• Node.js 20.19+ atau 22.12+ (hanya untuk build aset; aset siap pakai sudah disertakan)
• MySQL 8.x
• Nginx atau Apache dengan PHP-FPM

⚙️ Instalasi Singkat

composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan db:seed --class=DemoSeeder   # opsional: 5 proyek simulasi lengkap
php artisan storage:link
composer dev

Panduan production (Nginx, PHP-FPM, Supervisor, cron, HTTPS), backup & restore, rancangan database, hak akses, format import Excel, dan definisi rumus keuangan tersedia di folder docs/. Mode DEMO_MODE=true membuat aplikasi hanya-baca untuk demo publik, dengan reset data otomatis setiap malam.

🔑 Akun Demo (lokal)

Peran	Email	Password
Super Admin	superadmin@example.com	password
Owner	owner@projectrab.test	password
Project Manager	pm@projectrab.test	password
Estimator	estimator@projectrab.test	password
Finance	finance@projectrab.test	password
Staff	staff@projectrab.test	password

Akun demo tidak dibuat bila APP_ENV=production. Administrator production dibuat dengan php artisan app:create-super-admin.

---

🔐 Lisensi

Setelah pembelian, Anda mendapat kode lisensi RL-XXXX-XXXX-XXXX-XXXX di halaman Unduhan akun RadhCloud dan di email pembelian. Kode dimasukkan sekali saat aplikasi pertama dibuka (atau lewat php artisan license:activate). Internet hanya dibutuhkan saat aktivasi.

• Lisensi disimpan sebagai file, bukan di database. migrate:fresh atau key:generate tidak menghapusnya.
• File lisensi bisa diunduh sebagai cadangan dari Pengaturan › Lisensi dan dipulihkan di server baru.
• Install ulang di domain yang sama cukup dengan kode yang sama.
• Satu lisensi berlaku untuk satu domain instalasi.
• Pindah domain: hubungi RadhCloud untuk reset lisensi.

---

✅ Kualitas Kode

• 143 tes otomatis (Pest) untuk kalkulasi RAB, revisi, kontrol biaya & komitmen, hak akses per proyek, dashboard, lisensi, mode demo, dan halaman.
• Uang memakai DECIMAL dan dihitung dengan bcmath di server, dibulatkan 2 desimal (half-up).
• Perubahan bisnis berjalan di service layer dengan transaksi database dan penguncian baris.
• Lampiran disimpan di disk privat dan hanya dibuka setelah pengecekan izin.