@extends('docs.layout')

@section('title', 'Autentikasi & Hak Akses')

@section('breadcrumb')
  <li class="breadcrumb-item active">Autentikasi & Hak Akses</li>
@endsection

@section('page_header')
  <span class="doc-page-badge fase-1"><i class="bi bi-shield-lock me-1"></i> Keamanan & Akses</span>
  <h1 class="doc-page-title">Autentikasi, Keamanan & RBAC</h1>
  <p class="doc-page-description">Dokumentasi mekanisme autentikasi berbasis username, pengamanan rate limiting lockout, pencatatan waktu akses terakhir, serta pembagian peran (RBAC) 4 tingkatan.</p>
@endsection

@section('content')
  <section id="mekanisme-login">
    <h2>1. Mekanisme Autentikasi Berbasis Username</h2>
    <p>Berbeda dengan konfigurasi standar Laravel yang menggunakan email, sistem SSE menggunakan <strong>Username</strong> unik dan <strong>Password</strong> terenkripsi (Bcrypt) untuk proses autentikasi.</p>
    
    <div class="table-responsive">
      <table class="table table-bordered table-striped">
        <thead class="table-dark">
          <tr>
            <th>Komponen</th>
            <th>File Kode Terkait</th>
            <th>Penjelasan Teknis</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td><strong>Form Login</strong></td>
            <td><code>resources/views/auth/login.blade.php</code></td>
            <td>Menyediakan form input username & password dengan validasi client/server, toggle remember me, dan countdown timer saat terkena blokir lockout.</td>
          </tr>
          <tr>
            <td><strong>Controller Auth</strong></td>
            <td><code>app/Http/Controllers/AuthController.php</code></td>
            <td>Memvalidasi kredensial via <code>Auth::attempt()</code>, mengelola Rate Limiter, meregenerasi session ID untuk mencegah session fixation attack, dan mencatat <code>last_login_at</code>.</td>
          </tr>
          <tr>
            <td><strong>Pencatatan Akses</strong></td>
            <td><code>app/Models/User.php</code></td>
            <td>Kolom <code>last_login_at</code> diperbarui secara otomatis setiap kali login berhasil (<code>$user->update(['last_login_at' => now()])</code>), dan ditampilkan di tabel Manajemen Pengguna.</td>
          </tr>
        </tbody>
      </table>
    </div>
  </section>

  <section id="keamanan-rate-limiter">
    <h2>2. Proteksi Keamanan: Rate Limiter Lockout</h2>
    <p>Untuk mencegah serangan <em>Brute Force</em> (percobaan tebak kata sandi secara berulang), <code>AuthController</code> mengimplementasikan <strong>RateLimiter Throttling</strong>:</p>
    
    <div class="callout callout-warning">
      <span class="callout-icon"><i class="bi bi-exclamation-triangle"></i></span>
      <div class="callout-body">
        <span class="callout-title">Aturan Blokir Sementara (Lockout Policy)</span>
        <p>Jika pengguna salah memasukkan password sebanyak <strong>5 kali berturut-turut</strong> dalam waktu 60 detik (dihitung per kombinasi <code>username + IP Address</code>):</p>
        <ul>
          <li>Akses login ke sistem akan langsung diblokir sementara.</li>
          <li>Sistem menghitung sisa waktu cooldown (misal: 60 detik) dan menyimpannya di flash session <code>lockout_until</code>.</li>
          <li>Form login akan menampilkan pesan peringatan merah: <em>"Akses diblokir sementara. Coba lagi dalam XX detik."</em> dengan countdown interaktif.</li>
          <li>Setelah masa cooldown berakhir atau setelah berhasil login, counter kesalahan direset (<code>RateLimiter::clear</code>).</li>
        </ul>
      </div>
    </div>
  </section>

  <section id="role-based-access-control">
    <h2>3. Role-Based Access Control (RBAC)</h2>
    <p>Pengamanan otorisasi hak akses ditegakkan oleh middleware khusus <code>RoleMiddleware.php</code> yang didaftarkan sebagai route alias <code>role</code> di <code>app/Http/Kernel.php</code>:</p>

    <div class="table-responsive">
      <table class="table table-bordered table-hover">
        <thead class="table-light">
          <tr>
            <th>Role</th>
            <th>Tanggung Jawab Utama</th>
            <th>Hak Akses Modul</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td><span class="badge bg-danger">admin</span></td>
            <td>Super Administrator sistem.</td>
            <td>Memiliki akses 100% tanpa batas ke seluruh modul, Master Data, pembuatan & edit User, reset password, dan Dokumentasi Teknis.</td>
          </tr>
          <tr>
            <td><span class="badge bg-primary">staf_rab</span></td>
            <td>Staf Estimator & Perencanaan Anggaran.</td>
            <td>Mengelola Proyek, menyusun RAB Upah & Material (Unified RAP), mengimpor file Excel RAP, mengelola Master Satuan & Kategori, serta melihat ringkasan stok.</td>
          </tr>
          <tr>
            <td><span class="badge bg-success">staf_purchasing</span></td>
            <td>Staf Pengadaan & Logistik Lapangan.</td>
            <td>Mencatat transaksi Barang Masuk (Purchasing), mencatat transaksi Barang Keluar (Usage), mengelola Master Vendor & Material, serta memantau kartu stok proyek.</td>
          </tr>
          <tr>
            <td><span class="badge bg-secondary">manajer</span></td>
            <td>Manajemen & Pengambil Keputusan.</td>
            <td>Akses monitoring (View-Only) ke Dashboard eksekutif, memantau realisasi anggaran RAB vs Pembelian, melihat kartu stok & buku besar, serta mencetak laporan format PDF.</td>
          </tr>
        </tbody>
      </table>
    </div>
  </section>

  <section id="manajemen-pengguna">
    <h2>4. Modul Manajemen Pengguna (User Management)</h2>
    <p>Khusus pengguna dengan role <strong>Admin</strong>, tersedia modul pengelolaan akun di menu <em>Master Data &rarr; Pengguna</em> (<code>UserController.php</code>):</p>
    <ul>
      <li><strong>Tambah Pengguna Baru:</strong> Menetapkan Nama, Username unik, Email, Password, Role, dan mengunggah Foto Profil (avatar).</li>
      <li><strong>Edit Pengguna:</strong> Memperbarui identitas, mengubah hak akses (role), atau mengganti password (opsional; jika dikosongkan maka password lama tetap digunakan).</li>
      <li><strong>Monitoring Terakhir Akses:</strong> Kolom "Terakhir Akses" di tabel pengguna menampilkan tanggal presisi beserta waktu relatif (misal: <em>"2 jam yang lalu"</em> menggunakan <code>diffForHumans()</code>).</li>
      <li><strong>Hapus Pengguna:</strong> Admin dapat menghapus akun staf yang sudah tidak aktif (dengan proteksi konfirmasi).</li>
    </ul>
  </section>

  <section id="troubleshooting-auth">
    <h2>5. Pemecahan Masalah (Troubleshooting)</h2>
    <div class="accordion" id="accordionAuth">
      <div class="accordion-item">
        <h3 class="accordion-header">
          <button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#authTrouble1">
            Muncul Error 403 (Forbidden) "Akses tidak diizinkan"
          </button>
        </h3>
        <div id="authTrouble1" class="accordion-collapse collapse" data-bs-parent="#accordionAuth">
          <div class="accordion-body">
            Hal ini terjadi jika akun Anda tidak memiliki role yang diizinkan untuk membuka halaman tersebut (misal: Staf Purchasing mencoba membuka menu Pengguna yang hanya untuk Admin). Hubungi Administrator jika membutuhkan penyesuaian hak akses role.
          </div>
        </div>
      </div>
      <div class="accordion-item">
        <h3 class="accordion-header">
          <button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#authTrouble2">
            Akun Terkena Lockout (Blokir Sementara)
          </button>
        </h3>
        <div id="authTrouble2" class="accordion-collapse collapse" data-bs-parent="#accordionAuth">
          <div class="accordion-body">
            Tunggu hingga penghitung waktu mundur di layar login selesai (maksimal 60 detik). Pastikan tombol Caps Lock tidak aktif sebelum mencoba memasukkan kata sandi kembali.
          </div>
        </div>
      </div>
    </div>
  </section>
@endsection