@extends('docs.layout')

@section('title', 'Stok & Upah Terbayar')

@section('breadcrumb')
  <li class="breadcrumb-item active">Stok & Upah Terbayar</li>
@endsection

@section('page_header')
  <span class="doc-page-badge fase-1"><i class="bi bi-file-earmark-bar-graph me-1"></i> Modul Monitoring</span>
  <h1 class="doc-page-title">Rekap Stok, Buku Besar & Upah Terbayar</h1>
  <p class="doc-page-description">Dokumentasi monitoring ketersediaan saldo material gudang (Kartu Stok & Buku Besar Ledger) serta pencatatan realisasi pembayaran upah tenaga kerja proyek.</p>
@endsection

@section('content')
  <section id="rekap-stok-proyek">
    <h2>1. Modul Rekap Stok Material Proyek</h2>
    <p>Dikelola oleh <code>StockController.php</code>, modul ini memberikan visibilitas penuh atas pergerakan logistik seluruh material yang pernah ditransaksikan pada proyek yang bersangkutan:</p>
    
    <div class="table-responsive">
      <table class="table table-bordered table-striped">
        <thead class="table-dark">
          <tr>
            <th>Fitur / Tampilan</th>
            <th>File View Terkait</th>
            <th>Deskripsi Fungsional</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td><strong>Kartu Rekapitulasi Stok</strong></td>
            <td><code>resources/views/admin/stocks/index.blade.php</code></td>
            <td>Tabel agregasi yang menampilkan seluruh material proyek, <strong>Total Kuantitas Masuk</strong> (dari Purchasing), <strong>Total Kuantitas Keluar</strong> (dari Usage), <strong>Sisa Saldo Stok</strong>, Satuan, dan Status Badge indikator (<em>Aman / Menipis / Habis</em>).</td>
          </tr>
          <tr>
            <td><strong>Buku Besar (Ledger Detail)</strong></td>
            <td><code>resources/views/admin/stocks/detail.blade.php</code></td>
            <td>Riwayat mutasi kronologis untuk satu jenis barang tertentu. Menampilkan tanggal transaksi, tipe mutasi (Masuk / Keluar), referensi nomor PO/Surat Jalan, keterangan pihak terkait, dan <strong>Saldo Berjalan (Running Balance)</strong>.</td>
          </tr>
          <tr>
            <td><strong>Cetak Laporan Stok Resmi</strong></td>
            <td><code>resources/views/admin/stocks/print.blade.php</code></td>
            <td>Format laporan cetak bersih dengan kop surat proyek, tanggal cetak otomatis, dan kolom tanda tangan pengawas gudang.</td>
          </tr>
        </tbody>
      </table>
    </div>
  </section>

  <section id="catatan-upah-terbayar">
    <h2>2. Modul Catatan Upah Terbayar (Paid Wages)</h2>
    <p>Dikelola oleh <code>PaidWageController.php</code>, modul ini mencatat pengeluaran kas proyek untuk pembayaran upah tukang, mandor, atau pekerja borongan:</p>
    
    <div class="callout callout-tip">
      <span class="callout-icon"><i class="bi bi-person-workspace"></i></span>
      <div class="callout-body">
        <span class="callout-title">Struktur & Integrasi ke RAB Upah</span>
        <ul>
          <li><strong>Relasi ke RAB Upah:</strong> Bidang <code>rab_detail_id</code> menghubungkan pembayaran langsung ke item uraian pekerjaan yang telah direncanakan pada RAB Upah proyek.</li>
          <li><strong>Data Transaksi:</strong> Mencatat <code>tanggal_bayar</code>, <code>nama_tukang</code> (mandor/pekerja), <code>jumlah_hari</code>, <code>tarif_harian</code> (atau nilai borongan), <code>total_bayar</code>, dan <code>keterangan</code>.</li>
          <li><strong>Monitoring Realisasi:</strong> Header halaman menyajikan kartu statistik komparatif: <strong>Total Upah Terbayar</strong> vs <strong>Total Alokasi Pagu RAB Upah</strong> beserta persentase serapan biaya tenaga kerja.</li>
          <li><strong>Cetak Laporan Upah:</strong> File <code>paid-wages/print.blade.php</code> menyediakan lembar pertanggungjawaban pembayaran upah mingguan/bulanan siap cetak atau ekspor PDF.</li>
        </ul>
      </div>
    </div>
  </section>

  <section id="pemetaan-file-monitoring">
    <h2>3. Pemetaan File Kode Terkait</h2>
    <div class="table-responsive">
      <table class="table table-bordered table-striped">
        <thead class="table-dark">
          <tr>
            <th>Modul</th>
            <th>Controller</th>
            <th>Model</th>
            <th>Views</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>Rekap Stok</td>
            <td><code>StockController.php</code></td>
            <td><code>PurchaseDetail.php</code>, <code>UsageDetail.php</code>, <code>Item.php</code></td>
            <td><code>stocks/index.blade.php</code>, <code>stocks/detail.blade.php</code>, <code>stocks/print.blade.php</code></td>
          </tr>
          <tr>
            <td>Upah Terbayar</td>
            <td><code>PaidWageController.php</code></td>
            <td><code>PaidWage.php</code>, <code>RabDetail.php</code>, <code>Project.php</code></td>
            <td><code>paid-wages/index.blade.php</code>, <code>paid-wages/create.blade.php</code>, <code>paid-wages/edit.blade.php</code>, <code>paid-wages/print.blade.php</code></td>
          </tr>
        </tbody>
      </table>
    </div>
  </section>
@endsection