@extends('docs.layout')

@section('title', 'RAB & Anggaran Proyek')

@section('breadcrumb')
  <li class="breadcrumb-item active">RAB & Anggaran</li>
@endsection

@section('page_header')
  <span class="doc-page-badge fase-1"><i class="bi bi-cash-coin me-1"></i> Modul Anggaran</span>
  <h1 class="doc-page-title">RAB & Impor Excel RAP Terpadu</h1>
  <p class="doc-page-description">Dokumentasi modul penyusunan Rencana Anggaran Biaya (RAB), konsolidasi komponen Upah & Material, form dinamis multi-baris, auto-suggest cerdas, dan algoritma impor Excel RAP.</p>
@endsection

@section('content')
  <section id="konsep-unified-rab">
    <h2>1. Konsep RAB Terpadu (Unified RAP)</h2>
    <p>Pada format konstruksi resmi perusahaan, suatu rincian pekerjaan memiliki estimasi <strong>Alokasi Upah Tenaga Kerja</strong> dan <strong>Alokasi Belanja Material</strong> dalam 1 dokumen kerja yang sama. Sistem SSE mengonsolidasikan kedua komponen ini ke dalam 1 tabel terpadu pada <code>rab_details</code>.</p>
    
    <div class="table-responsive">
      <table class="table table-bordered table-striped">
        <thead class="table-dark">
          <tr>
            <th>Kolom Database</th>
            <th>Tipe Data</th>
            <th>Fungsi & Formula Kalkulasi</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td><code>kategori_nama</code></td>
            <td><code>VARCHAR</code></td>
            <td>Nama kelompok pekerjaan utama (cth: <em>PEKERJAAN STRUKTUR BETON</em>).</td>
          </tr>
          <tr>
            <td><code>uraian_pekerjaan</code></td>
            <td><code>VARCHAR</code></td>
            <td>Rincian pekerjaan atau spesifikasi material (cth: <em>Pek. Cor Kolom 13x13</em>).</td>
          </tr>
          <tr>
            <td><code>volume</code></td>
            <td><code>DECIMAL(12,2)</code></td>
            <td>Besaran kuantitas volume pekerjaan di lapangan.</td>
          </tr>
          <tr>
            <td><code>satuan</code> / <code>unit_id</code></td>
            <td><code>VARCHAR / FK</code></td>
            <td>Satuan ukur pekerjaan (cth: <code>m3</code>, <code>m2</code>, <code>kg</code>, <code>ls</code>).</td>
          </tr>
          <tr>
            <td><code>harga_satuan_upah</code></td>
            <td><code>DECIMAL(15,2)</code></td>
            <td>Estimasi tarif upah tenaga per satuan.</td>
          </tr>
          <tr>
            <td><code>total_harga_upah</code></td>
            <td><code>DECIMAL(15,2)</code></td>
            <td><code>volume &times; harga_satuan_upah</code>. Menjadi pagu batas untuk modul <strong>Upah Terbayar</strong>.</td>
          </tr>
          <tr>
            <td><code>harga_satuan_material</code></td>
            <td><code>DECIMAL(15,2)</code></td>
            <td>Estimasi harga pengadaan material per satuan.</td>
          </tr>
          <tr>
            <td><code>total_harga_material</code></td>
            <td><code>DECIMAL(15,2)</code></td>
            <td><code>volume &times; harga_satuan_material</code>. Menjadi pagu batas untuk modul <strong>Barang Masuk (Purchasing)</strong>.</td>
          </tr>
          <tr>
            <td><code>total_harga</code></td>
            <td><code>DECIMAL(15,2)</code></td>
            <td><code>total_harga_upah + total_harga_material</code>. Nilai total rincian baris.</td>
          </tr>
        </tbody>
      </table>
    </div>
  </section>

  <section id="dynamic-input-autosuggest">
    <h2>2. Form Multi-Baris Dinamis & Auto-Suggest</h2>
    <p>Penginputan RAB dirancang untuk efisiensi tinggi melalui <code>resources/views/admin/rab/show.blade.php</code>:</p>
    <ul>
      <li><strong>Dynamic Multi-Row Input:</strong> Pengguna cukup memilih 1 Kategori utama di header form, lalu dapat menambahkan beberapa baris uraian pekerjaan sekaligus dalam satu kali klik simpan (<code>storeDetail</code> memproses array <code>items[]</code> dalam 1 <code>DB::transaction</code>).</li>
      <li><strong>Live Kalkulasi Preview:</strong> Setiap perubahan volume atau harga satuan langsung menghitung subtotal baris dan akumulasi grand total secara real-time via JavaScript.</li>
      <li><strong>Auto-Suggest per Kategori:</strong> AJAX endpoint <code>getSuggestions()</code> otomatis memicu saat Kategori dipilih, menyajikan opsi Uraian Pekerjaan beserta preset satuan dan estimasi harga dari database riwayat proyek lain.</li>
    </ul>
  </section>

  <section id="impor-excel-rap">
    <h2>3. Algoritma Impor Excel RAP (PhpSpreadsheet)</h2>
    <p>Fitur Impor Excel (<code>RabController@importExcel</code>) membaca file Excel dokumen RAP asli dari manajemen:</p>
    
    <div class="callout callout-best-practice">
      <span class="callout-icon"><i class="bi bi-file-earmark-excel"></i></span>
      <div class="callout-body">
        <span class="callout-title">Fitur State Machine Parser</span>
        <ol>
          <li><strong>Pemisahan Hierarki Otomatis:</strong> Mendeteksi Header Kategori (huruf kapital / kode <code>A, B, C</code>), Sub-Header (angka <code>1, 2, 3</code>), dan Rincian Pekerjaan (huruf <code>a, b, c</code>).</li>
          <li><strong>Pembersihan Baris Akumulasi:</strong> Baris bertuliskan <em>"Sub Total"</em>, <em>"Total"</em>, atau <em>"Jumlah"</em> otomatis diabaikan agar tidak terjadi duplikasi kalkulasi nilai.</li>
          <li><strong>Sinkronisasi Satuan Baru:</strong> Satuan yang tercantum di Excel otomatis didaftarkan ke tabel <code>units</code> via <code>Unit::firstOrCreate</code> jika belum ada.</li>
          <li><strong>Pilihan Mode Impor:</strong>
            <ul>
              <li><strong>Mode Timpa (Overwrite):</strong> Menghapus rincian RAB lama proyek ini sebelum memasukkan data Excel yang baru.</li>
              <li><strong>Mode Tambah (Append):</strong> Menggabungkan baris dari file Excel ke data RAB yang sudah ada tanpa menghapus data sebelumnya.</li>
            </ul>
          </li>
        </ol>
      </div>
    </div>
  </section>

  <section id="template-print-attachments">
    <h2>4. Download Template, Cetak Dokumen & Lampiran</h2>
    <ul>
      <li><strong>Download Template Excel:</strong> Method <code>downloadTemplate()</code> menghasilkan template resmi Excel lengkap dengan format kolom <code>NO</code>, <code>URAIAN PEKERJAAN</code>, <code>SAT</code>, <code>VOL</code>, <code>HARSAT UPAH</code>, <code>HARSAT MATERIAL</code>, dan contoh data sampel.</li>
      <li><strong>Cetak Dokumen Resmi:</strong> Method <code>printUpah()</code> dan <code>printMaterial()</code> merender tampilan laporan bersih siap cetak kop surat perusahaan atau ekspor langsung ke PDF melalui dialog print browser.</li>
      <li><strong>Lampiran File Baris RAB:</strong> Setiap baris tabel RAB memiliki tombol paperclip dan indikator interaktif <code>📎 N</code>. Staf dapat melampirkan gambar kerja teknik, spesifikasi material, atau analisis harga satuan khusus untuk baris bersangkutan.</li>
    </ul>
  </section>
@endsection