RAB Analyzer (Node.js Wrapper)

This package provides a Node.js wrapper for the rab_analyzer.py tool, which extracts data from Indonesian RAB (Rencana Anggaran Biaya) files in PDF or Excel format.

🛠 System Requirements

Agar package ini dapat berjalan dengan lancar, pastikan sistem Anda memenuhi persyaratan berikut:

1. Lingkungan Node.js (Runtime)

• Node.js: Versi v14.0.0 atau yang lebih baru.
• NPM: Terinstal (biasanya sepaket dengan Node.js).

2. Lingkungan Python (Execution Engine)

• Python 3.7+: Harus terinstal dan terdaftar di PATH (sebagai perintah python).
• Akses Executable: Alat ini secara otomatis akan mencari file executable Python di folder venv (virtual environment) lokal jika tersedia, atau menggunakan python global sebagai cadangan.

3. Library Python (Dependencies)

Dua library berikut wajib diinstal di environment Python Anda:

• pdfplumber: Digunakan untuk ekstraksi data dari file PDF.
• openpyxl: Digunakan untuk membaca file Excel (.xlsx).

Instalasi Library Python: Library Python (pdfplumber dan openpyxl) akan diinstal secara otomatis ke dalam virtual environment (venv) lokal saat Anda menjalankan npm install. Pastikan saja Python 3 sudah tersedia di PATH sistem Anda.

# Otomatis dilakukan saat npm install
node scripts/setup-venv.js

4. Sistem Operasi

• Windows: Didukung penuh (menggunakan venv\Scripts\python.exe).
• Linux/macOS: Didukung (menggunakan venv/bin/python).

🚀 Installation

Anda dapat menginstal package ini secara lokal dalam project Anda:

npm install ./path-to-this-folder

Atau gunakan sebagai CLI tool global (menggunakan npm link untuk pengembangan lokal):

cd path-to-this-folder
npm link

📊 Usage

Command Line Interface (CLI)

Setelah diinstal/link, Anda bisa menjalankan perintah berikut dari terminal mana saja:

# Analisis file PDF
rab-analyze "data/document.pdf"

# Analisis file Excel
rab-analyze "data/budget.xlsx"

Programmatic API (Node.js)

Gunakan dalam kode Javascript Anda:

const { analyzeRAB } = require('rab-analyzer');

// Fungsi mengembalikan Promise berisi path ke file CSV hasil ekstrak
analyzeRAB('path/to/my_rab.pdf')
  .then(outputPath => {
    console.log('✅ Analisis Berhasil! File disimpan di:', outputPath);
  })
  .catch(err => {
    console.error('❌ Terjadi Kesalahan:', err.message);
  });

📂 Supported Formats

• PDF: Format standar RAB dengan kolom Uraian, Satuan, Volume, Harga Satuan, dan Total.
• Excel (.xlsx): Format Excel dengan berbagai variasi header:
  • Header Uraian / Barang (format lama)
  • Header Item Pekerjaan (format baru, e.g. RAB MCK Terbaru)
  • Auto-detect sheet: RAB, RAB MCK, RAB MCK IND, RAB MCK KOM, atau partial match

⚙️ How it Works

Node.js wrapper ini menggunakan child_process.spawn untuk mengeksekusi script rab_analyzer.py. Komunikasi antar bahasa dilakukan melalui stdout/stderr untuk menangkap log proses dan path file CSV hasil keluaran.

📝 Changelog

v1.1.0

• Support format RAB baru: Menambah deteksi kolom Item Pekerjaan, Harga Satuan, Jumlah Harga Satuan
• Fix total calculation: Per-item total sekarang = Volume × Harga (tanpa PPN per item). PPN 11% dihitung sekali di akhir sebagai grand total
• Sub-section headers: Menambah deteksi header huruf (A, B, C, ...) selain Roman numerals (I, II, III)
• Smart sheet detection: Auto-detect sheet RAB dengan partial match
• Summary rows: Output CSV sekarang menyertakan baris JUMLAH, PPN 11%, dan GRAND TOTAL di akhir

v1.0.0

• Initial release dengan support PDF dan Excel
• Dynamic column detection
• CLI dan programmatic API