# Rancangan Fitur Verifikasi Pendaftaran Admin

## Deskripsi

Fitur verifikasi pendaftaran memungkinkan admin untuk:
1. Melihat daftar semua pendaftar yang sudah submit (step >= 5)
2. Melihat detail lengkap data pendaftar
3. Melihat dan mengunduh dokumen yang diunggah
4. Melakukan verifikasi (terima/tolak) dengan catatan

---

## Perubahan Database

### Migrasi: `add_verification_fields_to_registrations_table`

Tambahkan kolom baru pada tabel `registrations`:

```php
$table->enum('verification_status', ['pending', 'approved', 'rejected'])->default('pending');
$table->text('verification_notes')->nullable();
$table->foreignId('verified_by')->nullable()->constrained('users')->nullOnDelete();
$table->timestamp('verified_at')->nullable();
```

---

## Backend

### Model: `Registration.php`

Tambahkan:
- Field baru ke `$fillable`
- Relationship `verifiedBy()` ke `User`
- Scope `submitted()` untuk filter step >= 5

---

### Controller: `Admin/VerificationController.php`

| Method   | Route                              | Deskripsi                          |
|----------|------------------------------------|------------------------------------|
| `index`  | GET `/admin/verifications`         | Daftar pendaftar dengan pagination & filter |
| `show`   | GET `/admin/verifications/{id}`    | Detail lengkap pendaftar           |
| `verify` | POST `/admin/verifications/{id}/verify` | Proses verifikasi (approve/reject) |

---

### Middleware

Buat middleware `AdminMiddleware` untuk memproteksi route admin:

```php
if (auth()->user()->role !== 'admin') {
    abort(403);
}
```

---

## Routes

Tambahkan di `routes/web.php`:

```php
Route::middleware(['auth', 'admin'])->prefix('admin')->name('admin.')->group(function () {
    Route::get('/dashboard', [AdminController::class, 'dashboard'])->name('dashboard');
    Route::get('/verifications', [VerificationController::class, 'index'])->name('verifications.index');
    Route::get('/verifications/{registration}', [VerificationController::class, 'show'])->name('verifications.show');
    Route::post('/verifications/{registration}/verify', [VerificationController::class, 'verify'])->name('verifications.verify');
});
```

---

## Frontend (Views)

### Layout: `layouts/app.blade.php` (Modifikasi)

Gunakan **satu layout** untuk admin dan siswa, dengan **sidebar dinamis berdasarkan role**:

```blade
<nav class="flex-1 px-4 py-6 space-y-1">
    @if(Auth::user()->role === 'admin')
        {{-- Sidebar Menu Admin --}}
        <a href="{{ route('admin.dashboard') }}" class="...">
            <span class="material-icons-outlined mr-3">dashboard</span>
            Dashboard
        </a>
        <a href="{{ route('admin.verifications.index') }}" class="...">
            <span class="material-icons-outlined mr-3">fact_check</span>
            Verifikasi Pendaftaran
        </a>
    @else
        {{-- Sidebar Menu Siswa --}}
        <a href="{{ route('dashboard') }}" class="...">
            <span class="material-icons-outlined mr-3">home</span>
            Beranda
        </a>
        <a href="{{ route('registration.step1') }}" class="...">
            <span class="material-icons-outlined mr-3">description</span>
            Pendaftaran
        </a>
        <a href="#" class="...">
            <span class="material-icons-outlined mr-3">help_outline</span>
            Bantuan
        </a>
    @endif
    
    {{-- Logout (untuk semua role) --}}
    <div class="pt-4 mt-4 border-t border-border-light dark:border-border-dark">
        <form action="{{ route('logout') }}" method="POST">
            @csrf
            <button type="submit" class="...">
                <span class="material-icons-outlined mr-3">logout</span>
                Keluar
            </button>
        </form>
    </div>
</nav>
```

---

### Halaman Index: `admin/verifications/index.blade.php`

**Fitur:**
- Tabel daftar pendaftar dengan kolom:
  - No. Pendaftaran (ID)
  - Nama Pendaftar
  - Email
  - Asal Sekolah
  - Tanggal Daftar
  - Status Verifikasi (badge warna)
  - Aksi (Lihat Detail)
- Filter berdasarkan status verifikasi
- Pagination

---

### Halaman Detail: `admin/verifications/show.blade.php`

**Sections:**

1. **Informasi Akun** - Nama, Email

2. **Data Pribadi** - NISN, NIK, No. KK, Jenis Kelamin, TTL, Status Keluarga, Anak ke-, Jumlah Saudara, Alamat

3. **Data Orang Tua** - Data Ayah & Ibu (Status, Nama, NIK, No. HP, Pekerjaan, Pendidikan), Penghasilan, Kepemilikan Rumah

4. **Data Wali** - Pilihan Wali, Nama, NIK, No. HP, Pekerjaan, Pendidikan

5. **Data Sekolah Asal** - NPSN, Nama, Alamat, Jenis, Status, Pesantren/IT, Jumlah Rombel & Siswa

6. **Jalur Pendaftaran** - Jalur Tes / Prestasi

7. **Nilai Rapor** - Nilai Semester 1-5

8. **Dokumen Pendukung** - Pas Foto (preview), Akta/KK, KKS, Rapor, Rekomendasi (link unduh)

9. **Form Verifikasi** - Radio (Terima/Tolak), Catatan, Tombol Submit

---

## Verification Status Flow

```
[Pending] ──approve──> [Approved]
    │
    └───reject───> [Rejected]
```

---

## File yang Perlu Dibuat/Dimodifikasi

### [NEW] Files

| Path | Deskripsi |
|------|-----------|
| `database/migrations/xxxx_add_verification_fields_to_registrations_table.php` | Migrasi kolom verifikasi |
| `app/Http/Middleware/AdminMiddleware.php` | Middleware cek role admin |
| `app/Http/Controllers/Admin/VerificationController.php` | Controller verifikasi |
| `resources/views/admin/verifications/index.blade.php` | Halaman daftar pendaftar |
| `resources/views/admin/verifications/show.blade.php` | Halaman detail & form verifikasi |

### [MODIFY] Files

| Path | Deskripsi |
|------|-----------|
| `resources/views/layouts/app.blade.php` | Tambah kondisi sidebar berdasarkan role |
| `app/Models/Registration.php` | Tambah fields & relationships |
| `routes/web.php` | Tambah routes admin |
| `bootstrap/app.php` | Register middleware admin |

---

## Verifikasi

### Manual Testing

1. Login sebagai admin → sidebar menampilkan menu admin
2. Login sebagai siswa → sidebar menampilkan menu siswa
3. Akses `/admin/verifications` sebagai admin
4. Pastikan hanya pendaftar dengan step >= 5 yang muncul
5. Klik detail, verifikasi semua data tampil
6. Approve/Reject dan cek status berubah

### Authorization Testing

1. Login sebagai user biasa
2. Akses `/admin/verifications` → harus mendapat 403 Forbidden
