@extends('docs.layout')

@section('title', 'Master Data')

@section('breadcrumb')
  <li class="breadcrumb-item active">Master Data</li>
@endsection

@section('page_header')
  <span class="doc-page-badge fase-1"><i class="bi bi-database me-1"></i> Data Induk</span>
  <h1 class="doc-page-title">Master Data & On-the-Fly Entry</h1>
  <p class="doc-page-description">Dokumentasi pengelolaan seluruh entitas data induk (Proyek, Vendor, Material, Satuan, Kategori RAB) serta mekanisme cerdas penambahan master on-the-fly dari form transaksi proyek.</p>
@endsection

@section('content')
  <section id="pengantar-master-data">
    <h2>1. Pengantar & Tujuan Modul</h2>
    <p>Modul Master Data bertindak sebagai fondasi utama integritas data sistem. Data induk yang terdefinisi di sini akan menjadi referensi dropdown di seluruh modul transaksi proyek (RAB, Purchasing, Usage, Stok, dan Upah).</p>
  </section>

  <section id="enam-submodul-master">
    <h2>2. Rincian 6 Sub-Modul Master Data</h2>
    
    <div class="table-responsive">
      <table class="table table-bordered table-striped">
        <thead class="table-dark">
          <tr>
            <th>Sub-Modul</th>
            <th>Controller & Model</th>
            <th>Field / Struktur Data</th>
            <th>Peran dalam Transaksi</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td><strong>1. Master Proyek</strong></td>
            <td><code>ProjectController.php</code><br><code>Project.php</code></td>
            <td><code>kode_proyek</code>, <code>nama_proyek</code>, <code>client</code>, <code>lokasi</code>, <code>status</code> (draft/ongoing/completed), <code>tanggal_mulai</code>, <code>tanggal_selesai</code>.</td>
            <td>Menjadi entitas induk (Parent) utama dari seluruh modul transaksi (RAB, Barang Masuk, Barang Keluar, Stok, Upah, dan File Lampiran). Menyediakan navigasi Tab Horizontal ERP.</td>
          </tr>
          <tr>
            <td><strong>2. Master Vendor</strong></td>
            <td><code>VendorController.php</code><br><code>Vendor.php</code></td>
            <td><code>nama_vendor</code>, <code>kontak_person</code>, <code>telepon</code>, <code>alamat</code>.</td>
            <td>Sebagai penyedia/toko tempat material dibeli pada transaksi Barang Masuk (Purchasing).</td>
          </tr>
          <tr>
            <td><strong>3. Master Kategori Barang</strong></td>
            <td><code>ItemCategoryController.php</code><br><code>ItemCategory.php</code></td>
            <td><code>nama_kategori</code>, <code>kode_kategori</code>, <code>deskripsi</code>.</td>
            <td>Mengelompokkan barang ke dalam kelompok fungsional (cth: <em>Material Bangunan, Alat Kerja, Perlengkapan</em>).</td>
          </tr>
          <tr>
            <td><strong>4. Master Material (Item)</strong></td>
            <td><code>ItemController.php</code><br><code>Item.php</code></td>
            <td><code>kode_barang</code> (auto-generate cth: <code>BRG-001</code>), <code>nama_barang</code>, <code>item_category_id</code>, <code>unit_id</code>, <code>harga_estimasi</code>, <code>deskripsi</code>.</td>
            <td>Katalog material yang dapat dibeli, dipakai, dan dilacak ketersediaan stok fisiknya di kartu gudang.</td>
          </tr>
          <tr>
            <td><strong>5. Master Kategori RAB</strong></td>
            <td><code>RabCategoryController.php</code><br><code>RabCategory.php</code></td>
            <td><code>kode_kategori</code>, <code>nama_kategori</code>, <code>deskripsi</code>.</td>
            <td>Header kelompok pekerjaan konstruksi (cth: <em>Pekerjaan Persiapan, Tanah, Pondasi, Struktur Beton, Pasangan Dinding, Plafond, Sanitasi, Listrik</em>).</td>
          </tr>
          <tr>
            <td><strong>6. Master Satuan (Unit)</strong></td>
            <td><code>UnitController.php</code><br><code>Unit.php</code></td>
            <td><code>nama_satuan</code> (cth: <code>M3</code>, <code>KG</code>, <code>ZAK</code>, <code>BTG</code>, <code>LBR</code>, <code>BH</code>, <code>LS</code>), <code>keterangan</code>.</td>
            <td>Satuan ukur seragam yang dikonsumsi oleh RAB, transaksi Pembelian, Pemakaian, dan Rekap Stok.</td>
          </tr>
        </tbody>
      </table>
    </div>
  </section>

  <section id="on-the-fly-mechanism">
    <h2>3. Mekanisme Unggulan: On-The-Fly Master Entry</h2>
    <p>Untuk memastikan kecepatan input data di lapangan, staf tidak perlu bolak-balik keluar-masuk menu Master Data hanya untuk mendaftarkan vendor, material, satuan, atau kategori baru. Sistem mendukung <strong>On-The-Fly Tagging</strong> via <code>Select2 (tags: true)</code> di kelima modul proyek:</p>
    
    <div class="callout callout-tip">
      <span class="callout-icon"><i class="bi bi-lightbulb"></i></span>
      <div class="callout-body">
        <span class="callout-title">Cara Kerja Sinkronisasi On-The-Fly di Backend</span>
        <p>Ketika pengguna mengetik nama baru yang belum ada di dropdown (misal: material baru <em>"Genteng Keramik Kanmuri"</em> atau satuan <em>"BOX"</em>):</p>
        <ol>
          <li>Komponen Select2 menangkap teks tersebut dan mengirimkannya dalam form POST request.</li>
          <li>Di Controller (<code>PurchaseController@store</code>, <code>UsageController@store</code>, atau <code>RabController@storeDetail</code>), sistem mengecek apakah input berupa ID integer atau teks string baru.</li>
          <li>Jika berupa string baru, sistem otomatis mengeksekusi <code>firstOrCreate</code> untuk mendaftarkan record baru di tabel master (lengkap dengan kode otomatis dan kategori default).</li>
          <li>ID baru yang baru saja terbentuk langsung dihubungkan ke transaksi saat itu juga secara transparan.</li>
        </ol>
      </div>
    </div>
  </section>

  <section id="database-seeders">
    <h2>4. Inisialisasi Data Master (Seeders)</h2>
    <p>Aplikasi dilengkapi dengan 2 file Seeder untuk instalasi awal:</p>
    <ul>
      <li><code>UnitSeeder.php</code>: Mengisi 16+ daftar satuan standar industri konstruksi (BH, KG, LBR, M3, BTG, ZAK, ROLL, IKAT, PCS, SET, LS, M2, M1, MTR, BOX, PAKET) dan otomatis mengimpor satuan unik dari histori item.</li>
      <li><code>DatabaseSeeder.php</code>: Memuat 4 akun default staf, 5 proyek riil (GATR, GBR, GCR, GBTR, MATOA), 5 vendor rekanan, 23 master material, dan 11 kategori RAB standar.</li>
    </ul>
  </section>
@endsection