Improve self-service access management and polish public student lookup

app/Http/Controllers/PublicStudentLookupController.php

@@ -4,7 +4,9 @@ namespace App\Http\Controllers;
 
 use App\Models\DocumentType;
 use App\Models\Student;
+use App\Models\StudentDocument;
 use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Storage;
 use Illuminate\View\View;
 
 class PublicStudentLookupController extends Controller
@@ -75,23 +77,63 @@ class PublicStudentLookupController extends Controller
     protected function resolvePhotoUrl(Student $student): ?string
     {
         $photoDocument = $student->documents
-            ->filter(function ($document) {
+            ->filter(fn ($document) => $this->isPhotoDocument($document))
-                $code = strtoupper((string) ($document->documentType?->code ?? ''));
+            ->sortByDesc(function ($document) {
-                $name = strtolower((string) ($document->documentType?->name ?? ''));
+                return sprintf(
-
+                    '%d-%s',
-                return $code === 'PAS_FOTO'
+                    $document->verification_status === 'valid' ? 1 : 0,
-                    || $code === 'PASFOTO'
+                    optional($document->created_at)?->format('YmdHis') ?? '00000000000000'
-                    || str_contains($name, 'pas foto')
+                );
-                    || str_contains($name, 'pasfoto');
             })
-            ->sortByDesc('created_at')
             ->first();
 
+        if (! $photoDocument && $student->relationLoaded('documents') === false) {
+            $photoDocument = StudentDocument::query()
+                ->with('documentType')
+                ->where('student_id', $student->id)
+                ->get()
+                ->filter(fn ($document) => $this->isPhotoDocument($document))
+                ->sortByDesc(function ($document) {
+                    return sprintf(
+                        '%d-%s',
+                        $document->verification_status === 'valid' ? 1 : 0,
+                        optional($document->created_at)?->format('YmdHis') ?? '00000000000000'
+                    );
+                })
+                ->first();
+        }
+
         if (! $photoDocument?->file_path) {
             return null;
         }
 
-        return asset('storage/' . $photoDocument->file_path);
+        if (! Storage::disk('public')->exists($photoDocument->file_path)) {
+            return null;
+        }
+
+        return asset('storage/' . ltrim($photoDocument->file_path, '/'));
+    }
+
+    protected function isPhotoDocument(StudentDocument $document): bool
+    {
+        $code = strtoupper((string) ($document->documentType?->code ?? ''));
+        $name = strtolower((string) ($document->documentType?->name ?? ''));
+        $fileName = strtolower((string) ($document->file_name ?? ''));
+        $mimeType = strtolower((string) ($document->mime_type ?? ''));
+
+        $looksLikePhoto = $code === 'PAS_FOTO'
+            || $code === 'PASFOTO'
+            || str_contains($name, 'pas foto')
+            || str_contains($name, 'pasfoto')
+            || str_contains($fileName, 'pas foto')
+            || str_contains($fileName, 'pasfoto');
+
+        if ($looksLikePhoto) {
+            return true;
+        }
+
+        return str_starts_with($mimeType, 'image/')
+            && (str_contains($name, 'foto') || str_contains($fileName, 'foto'));
     }
 
     protected function buildRequiredDocumentSummary(Student $student): array

app/Http/Controllers/StudentSelfServiceController.php

@@ -5,8 +5,11 @@ namespace App\Http\Controllers;
 use App\Models\AcademicYear;
 use App\Models\SchoolClass;
 use App\Models\Student;
+use Illuminate\Http\RedirectResponse;
 use Illuminate\Http\Request;
+use Illuminate\Support\Str;
 use Illuminate\View\View;
+use RealRashid\SweetAlert\Facades\Alert;
 
 class StudentSelfServiceController extends Controller
 {
@@ -34,6 +37,11 @@ class StudentSelfServiceController extends Controller
             ->withQueryString();
 
         $summaryBaseQuery = Student::query();
+        $statusLabels = [
+            'not_started' => 'Belum Mulai',
+            'draft' => 'Draft',
+            'submitted' => 'Sudah Dikirim',
+        ];
 
         return view('student-self-service.index', [
             'students' => $students,
@@ -45,17 +53,115 @@ class StudentSelfServiceController extends Controller
             ],
             'academicYears' => AcademicYear::orderBy('name')->pluck('name', 'id'),
             'classes' => SchoolClass::orderBy('name')->pluck('name', 'id'),
-            'statuses' => [
+            'statuses' => $statusLabels,
-                'not_started' => 'Belum Mulai',
-                'draft' => 'Draft',
-                'submitted' => 'Sudah Dikirim',
-            ],
             'summary' => [
                 'total' => (clone $summaryBaseQuery)->count(),
                 'not_started' => (clone $summaryBaseQuery)->where('self_service_status', 'not_started')->count(),
                 'draft' => (clone $summaryBaseQuery)->where('self_service_status', 'draft')->count(),
                 'submitted' => (clone $summaryBaseQuery)->where('self_service_status', 'submitted')->count(),
+                'with_code' => (clone $summaryBaseQuery)->whereNotNull('self_service_access_code')->count(),
+                'without_code' => (clone $summaryBaseQuery)->whereNull('self_service_access_code')->count(),
             ],
         ]);
     }
+
+    public function generateMissingCodes(): RedirectResponse
+    {
+        $students = Student::query()->whereNull('self_service_access_code')->get();
+
+        if ($students->isEmpty()) {
+            Alert::info('Tidak ada perubahan', 'Semua siswa sudah memiliki kode akses.');
+
+            return redirect()->route('student-self-service.index')->with('success', 'Semua siswa sudah memiliki kode akses.');
+        }
+
+        foreach ($students as $student) {
+            $student->forceFill([
+                'self_service_access_code' => $this->generateUniqueCode(),
+                'self_service_code_generated_at' => now(),
+            ])->save();
+        }
+
+        Alert::success('Berhasil', $students->count() . ' kode akses berhasil digenerate.');
+
+        return redirect()->route('student-self-service.index')->with('success', $students->count() . ' kode akses berhasil digenerate.');
+    }
+
+    public function regenerateAllCodes(): RedirectResponse
+    {
+        $students = Student::query()->get();
+
+        foreach ($students as $student) {
+            $student->forceFill([
+                'self_service_access_code' => $this->generateUniqueCode(),
+                'self_service_code_generated_at' => now(),
+            ])->save();
+        }
+
+        Alert::success('Berhasil', 'Semua kode akses siswa berhasil direset dan digenerate ulang.');
+
+        return redirect()->route('student-self-service.index')->with('success', 'Semua kode akses siswa berhasil direset dan digenerate ulang.');
+    }
+
+    public function regenerateStudentCode(Student $student): RedirectResponse
+    {
+        $student->forceFill([
+            'self_service_access_code' => $this->generateUniqueCode(),
+            'self_service_code_generated_at' => now(),
+        ])->save();
+
+        Alert::success('Berhasil', 'Kode akses untuk ' . $student->full_name . ' berhasil digenerate ulang.');
+
+        return redirect()->route('student-self-service.index')->with('success', 'Kode akses untuk ' . $student->full_name . ' berhasil digenerate ulang.');
+    }
+
+    public function exportClassCodes(Request $request): View|RedirectResponse
+    {
+        $validated = $request->validate([
+            'class_id' => ['required', 'exists:classes,id'],
+        ], [
+            'class_id.required' => 'Pilih kelas terlebih dahulu sebelum export kode.',
+        ]);
+
+        $class = SchoolClass::with(['academicYear', 'department'])->findOrFail($validated['class_id']);
+        $students = Student::query()
+            ->with(['classRoom'])
+            ->where('class_id', $class->id)
+            ->orderBy('full_name')
+            ->get();
+
+        if ($students->isEmpty()) {
+            return redirect()->route('student-self-service.index', ['class_id' => $class->id])
+                ->withErrors(['class_id' => 'Kelas terpilih belum memiliki data siswa.']);
+        }
+
+        $studentsWithoutCode = $students->filter(fn (Student $student) => blank($student->self_service_access_code));
+
+        foreach ($studentsWithoutCode as $student) {
+            $student->forceFill([
+                'self_service_access_code' => $this->generateUniqueCode(),
+                'self_service_code_generated_at' => now(),
+            ])->save();
+        }
+
+        $students = Student::query()
+            ->where('class_id', $class->id)
+            ->orderBy('full_name')
+            ->get();
+
+        return view('student-self-service.export-class-codes', [
+            'class' => $class,
+            'students' => $students,
+            'generatedCount' => $studentsWithoutCode->count(),
+        ]);
+    }
+
+    protected function generateUniqueCode(): string
+    {
+        do {
+            $code = strtoupper(Str::random(8));
+        } while (Student::where('self_service_access_code', $code)->exists());
+
+        return $code;
+    }
 }

resources/views/public/student-lookup.blade.php

@@ -142,42 +142,33 @@
 
                             <div class="overflow-hidden rounded-3xl border border-emerald-200 bg-white shadow-sm shadow-emerald-100/60">
                                 <div class="border-b border-emerald-100 bg-gradient-to-r from-emerald-50 via-white to-sky-50 px-5 py-5 sm:px-6">
-                                    <div class="flex flex-col gap-5 lg:flex-row lg:items-start lg:justify-between">
+                                    <div class="grid gap-4 lg:grid-cols-[minmax(0,1fr)_auto] lg:items-start">
                                         <div class="min-w-0">
-                                            <div class="text-xs font-semibold uppercase tracking-[0.16em] text-emerald-600">Data ditemukan</div>
+                                            <div class="inline-flex items-center rounded-full bg-emerald-100 px-3 py-1 text-[11px] font-semibold uppercase tracking-[0.16em] text-emerald-700">
-                                            <h2 class="mt-2 text-2xl font-bold tracking-tight text-slate-900 sm:text-3xl">{{ $student->full_name }}</h2>
+                                                Data ditemukan
-                                            <p class="mt-2 text-sm leading-6 text-slate-500">Pencarian cocok berdasarkan {{ strtolower($matchedBy ?? 'data siswa') }} dan menampilkan ringkasan informasi siswa yang tersedia untuk publik.</p>
-                                        </div>
-                                        <div class="grid w-full gap-3 sm:grid-cols-2 lg:w-auto lg:min-w-[320px]">
-                                            <div class="rounded-2xl border border-emerald-100 bg-white/80 px-4 py-4 text-center shadow-sm">
-                                                <div class="text-2xl font-bold text-slate-900 sm:text-3xl">{{ $student->classRoom?->name ?: '-' }}</div>
-                                                <div class="mt-1 text-xs font-semibold uppercase tracking-[0.14em] text-emerald-600">Kelas saat ini</div>
                                             </div>
-                                            <div class="rounded-2xl border border-amber-100 bg-white/80 px-4 py-4 text-center shadow-sm">
+                                            <h2 class="mt-3 text-2xl font-bold tracking-tight text-slate-900 sm:text-3xl">{{ $student->full_name }}</h2>
-                                                <div class="text-2xl font-bold text-slate-900 sm:text-3xl">{{ $studentAchievements->count() }}</div>
+                                            <p class="mt-2 max-w-2xl text-sm leading-6 text-slate-500">
-                                                <div class="mt-1 text-xs font-semibold uppercase tracking-[0.14em] {{ $studentAchievements->count() > 0 ? 'text-amber-600' : 'text-slate-500' }}">
+                                                Pencarian cocok berdasarkan {{ strtolower($matchedBy ?? 'data siswa') }} dan menampilkan ringkasan informasi siswa yang tersedia untuk publik.
-                                                    {{ $studentAchievements->count() > 0 ? 'Prestasi tercatat' : 'Belum ada prestasi' }}
+                                            </p>
+                                        </div>
+
+                                        <div class="grid gap-3 sm:grid-cols-2 lg:min-w-[320px]">
+                                            <div class="rounded-2xl border border-emerald-100 bg-white px-4 py-4 text-center shadow-sm shadow-emerald-100/40">
+                                                <div class="text-[11px] font-semibold uppercase tracking-[0.16em] text-emerald-600">Kelas Saat Ini</div>
+                                                <div class="mt-2 text-2xl font-bold text-slate-900 sm:text-3xl">{{ $student->classRoom?->name ?: '-' }}</div>
+                                            </div>
+                                            <div class="rounded-2xl border border-amber-100 bg-white px-4 py-4 text-center shadow-sm shadow-amber-100/40">
+                                                <div class="text-[11px] font-semibold uppercase tracking-[0.16em] {{ $studentAchievements->count() > 0 ? 'text-amber-600' : 'text-slate-500' }}">
+                                                    {{ $studentAchievements->count() > 0 ? 'Prestasi Tercatat' : 'Status Prestasi' }}
                                                 </div>
+                                                <div class="mt-2 text-2xl font-bold text-slate-900 sm:text-3xl">{{ $studentAchievements->count() }}</div>
                                             </div>
                                         </div>
                                     </div>
                                 </div>
 
-                                <div class="grid gap-4 px-5 py-5 sm:px-6 lg:grid-cols-[auto_1fr] lg:items-center">
+                                <div class="grid gap-4 px-5 py-5 sm:px-6">
-                                    <div class="flex items-center gap-4">
-                                        @if ($student->public_photo_url)
-                                            <img src="{{ $student->public_photo_url }}" alt="{{ $student->full_name }}" class="h-24 w-24 rounded-[28px] object-cover ring-1 ring-slate-200 shadow-sm sm:h-28 sm:w-28">
-                                        @else
-                                            <div class="flex h-24 w-24 items-center justify-center rounded-[28px] bg-gradient-to-br from-slate-100 via-white to-slate-200 text-3xl font-bold text-slate-700 ring-1 ring-slate-200 shadow-sm sm:h-28 sm:w-28">
-                                                {{ strtoupper(mb_substr($student->full_name, 0, 1)) }}
-                                            </div>
-                                        @endif
-                                        <div class="sm:hidden">
-                                            <div class="text-lg font-semibold text-slate-900">{{ $student->full_name }}</div>
-                                            <div class="mt-1 text-xs text-slate-500">NIS: {{ $student->student_number ?: '-' }} · NISN: {{ $student->nisn ?: '-' }}</div>
-                                        </div>
-                                    </div>
-
                                     <div class="grid gap-3 sm:grid-cols-2 xl:grid-cols-4">
                                         <div class="rounded-2xl border border-slate-200 bg-slate-50 px-4 py-3">
                                             <div class="text-[11px] font-semibold uppercase tracking-[0.16em] text-slate-400">NIS</div>
@@ -199,38 +190,91 @@
                                 </div>
                             </div>
 
-                            <div class="grid grid-cols-1 gap-6 xl:grid-cols-3">
+                            <div class="rounded-3xl border border-slate-200 bg-white p-5 shadow-sm shadow-slate-200/50 sm:p-6">
-                                <div class="rounded-3xl border border-slate-200 bg-white p-5 shadow-sm shadow-slate-200/50 sm:p-6">
+                                <div class="flex flex-col gap-5 lg:flex-row lg:items-start">
-                                    <h3 class="text-base font-semibold text-slate-900">Biodata Siswa</h3>
+                                    <div class="inline-flex shrink-0 flex-col items-center border border-slate-300 bg-slate-50 p-2 shadow-sm">
-                                    <div class="mt-4 space-y-3 text-sm text-slate-600">
+                                        @if ($student->public_photo_url)
-                                        <div><span class="font-semibold text-slate-800">Nama:</span> {{ $student->full_name }}</div>
+                                            <img src="{{ $student->public_photo_url }}" alt="{{ $student->full_name }}" class="h-32 w-24 object-cover border border-slate-300 bg-white sm:h-36 sm:w-[108px]">
-                                        <div><span class="font-semibold text-slate-800">NIS:</span> {{ $student->student_number ?: '-' }}</div>
+                                        @else
-                                        <div><span class="font-semibold text-slate-800">NISN:</span> {{ $student->nisn ?: '-' }}</div>
+                                            <div class="flex h-32 w-24 flex-col items-center justify-center border border-slate-300 bg-gradient-to-b from-slate-100 to-white px-2 text-center sm:h-36 sm:w-[108px]">
-                                        <div><span class="font-semibold text-slate-800">Jenis Kelamin:</span> {{ $student->gender === 'L' ? 'Laki-laki' : 'Perempuan' }}</div>
+                                                <div class="text-[10px] font-semibold uppercase tracking-[0.18em] text-slate-400">Pas Foto</div>
-                                        <div><span class="font-semibold text-slate-800">Tempat, Tanggal Lahir:</span> {{ $student->place_of_birth ?: '-' }}, {{ $student->date_of_birth?->format('d-m-Y') ?: '-' }}</div>
+                                                <div class="mt-2 text-xs font-medium leading-4 text-slate-500">Belum ada foto</div>
+                                            </div>
+                                        @endif
+                                        <div class="mt-2 text-[10px] font-semibold uppercase tracking-[0.16em] text-slate-500">Pas Foto</div>
                                     </div>
-                                </div>
 
-                                <div class="rounded-3xl border border-slate-200 bg-white p-5 shadow-sm shadow-slate-200/50 sm:p-6">
+                                    <div class="min-w-0 flex-1 space-y-6">
-                                    <h3 class="text-base font-semibold text-slate-900">Informasi Akademik</h3>
+                                        <div class="border border-slate-200 bg-slate-50 px-4 py-3">
-                                    <div class="mt-4 space-y-3 text-sm text-slate-600">
+                                            <div class="text-[11px] font-semibold uppercase tracking-[0.18em] text-slate-400">Profil Siswa</div>
-                                        <div><span class="font-semibold text-slate-800">Tahun Angkatan:</span> {{ $student->academicYear?->name ?: '-' }}</div>
+                                            <div class="mt-1 text-lg font-semibold uppercase tracking-[0.04em] text-slate-900">Data Identitas dan Akademik Siswa</div>
-                                        <div><span class="font-semibold text-slate-800">Program Keahlian:</span> {{ $student->department?->name ?: '-' }}</div>
+                                            <div class="mt-1 text-xs text-slate-500">Ringkasan profil siswa yang tersedia untuk tampilan publik terbatas.</div>
-                                        <div><span class="font-semibold text-slate-800">Kelas:</span> {{ $student->classRoom?->name ?: '-' }}</div>
+                                        </div>
-                                        <div><span class="font-semibold text-slate-800">Status:</span> {{ ucfirst($student->status) }}</div>
-                                        <div><span class="font-semibold text-slate-800">Tanggal Masuk:</span> {{ $student->entry_date?->format('d-m-Y') ?: '-' }}</div>
-                                    </div>
-                                </div>
 
-                                <div class="rounded-3xl border border-slate-200 bg-white p-5 shadow-sm shadow-slate-200/50 sm:p-6">
+                                        <div class="grid gap-6 xl:grid-cols-3">
-                                    <h3 class="text-base font-semibold text-slate-900">Alamat Siswa</h3>
+                                            <div class="xl:pr-4 xl:border-r xl:border-dashed xl:border-slate-300">
-                                    <div class="mt-4 space-y-3 text-sm text-slate-600">
+                                                <h3 class="text-sm font-semibold text-slate-900">Biodata Siswa</h3>
-                                        <div><span class="font-semibold text-slate-800">Alamat Lengkap:</span> {{ $student->address ?: '-' }}</div>
+                                                <div class="mt-3 grid gap-2.5 text-sm text-slate-600 sm:grid-cols-[150px_1fr] sm:items-start xl:grid-cols-[120px_1fr]">
-                                        <div><span class="font-semibold text-slate-800">Desa/Kelurahan:</span> {{ $student->village ?: '-' }}</div>
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Nama</div>
-                                        <div><span class="font-semibold text-slate-800">Kecamatan:</span> {{ $student->district ?: '-' }}</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->full_name }}</div>
-                                        <div><span class="font-semibold text-slate-800">Kabupaten/Kota:</span> {{ $student->city ?: '-' }}</div>
+
-                                        <div><span class="font-semibold text-slate-800">Provinsi:</span> {{ $student->province ?: '-' }}</div>
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">NIS</div>
-                                        <div><span class="font-semibold text-slate-800">Kode Pos:</span> {{ $student->postal_code ?: '-' }}</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->student_number ?: '-' }}</div>
+
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">NISN</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->nisn ?: '-' }}</div>
+
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Gender</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->gender === 'L' ? 'Laki-laki' : 'Perempuan' }}</div>
+
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Lahir</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->place_of_birth ?: '-' }}, {{ $student->date_of_birth?->format('d-m-Y') ?: '-' }}</div>
+                                                </div>
+                                            </div>
+
+                                            <div class="xl:px-4 xl:border-r xl:border-dashed xl:border-slate-300">
+                                                <h3 class="text-sm font-semibold text-slate-900">Informasi Akademik</h3>
+                                                <div class="mt-3 grid gap-2.5 text-sm text-slate-600 sm:grid-cols-[150px_1fr] sm:items-start xl:grid-cols-[120px_1fr]">
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Angkatan</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->academicYear?->name ?: '-' }}</div>
+
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Program</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->department?->name ?: '-' }}</div>
+
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Kelas</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->classRoom?->name ?: '-' }}</div>
+
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Status</div>
+                                                    <div class="font-medium text-slate-700">{{ ucfirst($student->status) }}</div>
+
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Masuk</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->entry_date?->format('d-m-Y') ?: '-' }}</div>
+                                                </div>
+                                            </div>
+
+                                            <div class="xl:pl-4">
+                                                <h3 class="text-sm font-semibold text-slate-900">Alamat Siswa</h3>
+                                                <div class="mt-3 grid gap-2.5 text-sm text-slate-600 sm:grid-cols-[150px_1fr] sm:items-start xl:grid-cols-[120px_1fr]">
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Alamat</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->address ?: '-' }}</div>
+
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Desa</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->village ?: '-' }}</div>
+
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Kecamatan</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->district ?: '-' }}</div>
+
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Kota</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->city ?: '-' }}</div>
+
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Provinsi</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->province ?: '-' }}</div>
+
+                                                    <div class="text-xs font-semibold uppercase tracking-[0.14em] text-slate-400">Kode Pos</div>
+                                                    <div class="font-medium text-slate-700">{{ $student->postal_code ?: '-' }}</div>
+                                                </div>
+                                            </div>
+                                        </div>
                                     </div>
                                 </div>
                             </div>

resources/views/student-self-service/export-class-codes.blade.php

@@ -0,0 +1,441 @@
+@php
+    $portalUrl = route('public.student-self-service.index');
+    $qrUrl = 'https://api.qrserver.com/v1/create-qr-code/?size=180x180&margin=8&data=' . urlencode($portalUrl);
+@endphp
+<!DOCTYPE html>
+<html lang="id">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Daftar Kode Akses Self Servis - {{ $class->name }}</title>
+    <style>
+        body {
+            font-family: "Times New Roman", Times, serif;
+            color: #111827;
+            margin: 24px;
+            line-height: 1.45;
+        }
+
+        .document {
+            max-width: 100%;
+        }
+
+        .top-actions {
+            margin-bottom: 18px;
+        }
+
+        .print-button {
+            background: #0f172a;
+            color: #ffffff;
+            border: none;
+            border-radius: 8px;
+            padding: 10px 16px;
+            font-size: 13px;
+            font-weight: 700;
+            cursor: pointer;
+        }
+
+        .letterhead {
+            text-align: center;
+            border-bottom: 3px solid #111827;
+            padding-bottom: 14px;
+            margin-bottom: 18px;
+        }
+
+        .letterhead-small {
+            font-size: 12px;
+            text-transform: uppercase;
+            letter-spacing: 0.18em;
+        }
+
+        .letterhead-title {
+            margin-top: 6px;
+            font-size: 24px;
+            font-weight: 700;
+            text-transform: uppercase;
+            letter-spacing: 0.06em;
+        }
+
+        .letterhead-subtitle {
+            margin-top: 4px;
+            font-size: 13px;
+        }
+
+        .document-title {
+            text-align: center;
+            margin: 18px 0 14px;
+        }
+
+        .document-title h1 {
+            margin: 0;
+            font-size: 18px;
+            font-weight: 700;
+            text-transform: uppercase;
+            text-decoration: underline;
+            letter-spacing: 0.04em;
+        }
+
+        .document-title p {
+            margin: 6px 0 0;
+            font-size: 13px;
+        }
+
+        .meta-box {
+            border: 1px solid #374151;
+            padding: 12px 14px;
+            margin-bottom: 16px;
+            font-size: 13px;
+        }
+
+        .access-panel {
+            display: table;
+            width: 100%;
+            border: 1px solid #374151;
+            margin-bottom: 16px;
+        }
+
+        .access-panel-row {
+            display: table-row;
+        }
+
+        .access-panel-main,
+        .access-panel-qr {
+            display: table-cell;
+            vertical-align: top;
+            padding: 16px 18px;
+        }
+
+        .access-panel-main {
+            border-right: 1px solid #374151;
+        }
+
+        .access-panel-qr {
+            width: 220px;
+            text-align: center;
+            background: #fafafa;
+        }
+
+        .portal-badge {
+            display: inline-block;
+            border: 1px solid #d1d5db;
+            padding: 4px 10px;
+            font-size: 10px;
+            font-weight: 700;
+            text-transform: uppercase;
+            letter-spacing: 0.14em;
+            margin-bottom: 10px;
+            background: #f9fafb;
+        }
+
+        .portal-title {
+            font-size: 16px;
+            font-weight: 700;
+            margin-bottom: 8px;
+        }
+
+        .portal-description {
+            font-size: 12px;
+            color: #374151;
+            line-height: 1.7;
+        }
+
+        .portal-link-box {
+            margin-top: 14px;
+            border: 1px solid #d1d5db;
+            background: #ffffff;
+            padding: 10px 12px;
+        }
+
+        .portal-link-label {
+            font-size: 10px;
+            font-weight: 700;
+            text-transform: uppercase;
+            letter-spacing: 0.12em;
+            color: #4b5563;
+            margin-bottom: 6px;
+        }
+
+        .portal-url {
+            font-size: 12px;
+            line-height: 1.6;
+            word-break: break-word;
+        }
+
+        .portal-url a {
+            color: #111827;
+            text-decoration: none;
+        }
+
+        .qr-card {
+            display: inline-block;
+            background: #ffffff;
+            border: 1px solid #d1d5db;
+            padding: 10px;
+        }
+
+        .qr-title {
+            font-size: 11px;
+            font-weight: 700;
+            text-transform: uppercase;
+            letter-spacing: 0.12em;
+            color: #374151;
+            margin-bottom: 10px;
+        }
+
+        .qr-image {
+            width: 150px;
+            height: 150px;
+            object-fit: contain;
+            display: block;
+        }
+
+        .qr-caption {
+            margin-top: 10px;
+            font-size: 11px;
+            color: #4b5563;
+            line-height: 1.5;
+        }
+
+        .meta-grid {
+            width: 100%;
+            border-collapse: collapse;
+        }
+
+        .meta-grid td {
+            padding: 2px 0;
+            vertical-align: top;
+            font-size: 13px;
+        }
+
+        .meta-grid .label {
+            width: 160px;
+        }
+
+        .notice {
+            margin-bottom: 14px;
+            font-size: 12px;
+            color: #374151;
+        }
+
+        table {
+            width: 100%;
+            border-collapse: collapse;
+            margin-top: 8px;
+        }
+
+        th,
+        td {
+            border: 1px solid #111827;
+            padding: 8px 10px;
+            vertical-align: middle;
+            font-size: 12px;
+        }
+
+        th {
+            text-align: center;
+            font-weight: 700;
+            text-transform: uppercase;
+            letter-spacing: 0.05em;
+        }
+
+        td.center {
+            text-align: center;
+        }
+
+        .code {
+            font-family: "Courier New", Courier, monospace;
+            font-size: 13px;
+            font-weight: 700;
+            letter-spacing: 0.16em;
+            text-align: center;
+        }
+
+        .notes {
+            margin-top: 18px;
+            font-size: 12px;
+        }
+
+        .notes-title {
+            font-weight: 700;
+            margin-bottom: 6px;
+        }
+
+        .notes ol {
+            margin: 0;
+            padding-left: 18px;
+        }
+
+        .signature {
+            width: 100%;
+            margin-top: 28px;
+            border-collapse: collapse;
+        }
+
+        .signature td {
+            width: 50%;
+            vertical-align: top;
+            font-size: 12px;
+            border: none;
+        }
+
+        .signature-box {
+            text-align: center;
+            padding-top: 8px;
+        }
+
+        .signature-space {
+            height: 64px;
+        }
+
+        .footer {
+            margin-top: 18px;
+            font-size: 11px;
+            color: #4b5563;
+            text-align: center;
+        }
+
+        @media print {
+            body {
+                margin: 12mm;
+            }
+
+            .no-print {
+                display: none !important;
+            }
+        }
+    </style>
+</head>
+<body>
+    <div class="document">
+        <div class="top-actions no-print">
+            <button type="button" class="print-button" onclick="window.print()">Cetak / Simpan PDF</button>
+        </div>
+
+        <div class="letterhead">
+            <div class="letterhead-small">Dokumen Internal Sekolah</div>
+            <div class="letterhead-title">Database Kesiswaan</div>
+            <div class="letterhead-subtitle">Lembar Distribusi Kode Akses Self Servis Siswa</div>
+        </div>
+
+        <div class="document-title">
+            <h1>Daftar Kode Akses Self Servis</h1>
+            <p>Digunakan untuk proses pelengkapan data siswa secara mandiri melalui portal sekolah.</p>
+        </div>
+
+        <div class="meta-box">
+            <table class="meta-grid">
+                <tr>
+                    <td class="label">Kelas</td>
+                    <td>: {{ $class->name }}</td>
+                </tr>
+                <tr>
+                    <td class="label">Tahun Angkatan</td>
+                    <td>: {{ $class->academicYear?->name ?: '-' }}</td>
+                </tr>
+                <tr>
+                    <td class="label">Program Keahlian</td>
+                    <td>: {{ $class->department?->name ?: '-' }}</td>
+                </tr>
+                <tr>
+                    <td class="label">Tanggal Cetak</td>
+                    <td>: {{ now()->format('d-m-Y H:i') }}</td>
+                </tr>
+                <tr>
+                    <td class="label">Jumlah Siswa</td>
+                    <td>: {{ $students->count() }} siswa</td>
+                </tr>
+                <tr>
+                    <td class="label">Kode Baru Tergenerate</td>
+                    <td>: {{ $generatedCount }}</td>
+                </tr>
+            </table>
+        </div>
+
+        <div class="access-panel">
+            <div class="access-panel-row">
+                <div class="access-panel-main">
+                    <div class="portal-badge">Akses Digital Siswa</div>
+                    <div class="portal-title">Portal Self Servis Siswa</div>
+                    <div class="portal-description">
+                        Gunakan lembar ini sebagai panduan akses awal ke portal self servis siswa. Siswa atau orang tua/wali dapat membuka portal menggunakan tautan di bawah atau scan QR di samping, lalu masuk dengan <strong>NIS/NISN</strong> dan <strong>kode akses</strong> masing-masing.
+                    </div>
+
+                    <div class="portal-link-box">
+                        <div class="portal-link-label">Link Portal Self Servis</div>
+                        <div class="portal-url">
+                            <a href="{{ $portalUrl }}">{{ $portalUrl }}</a>
+                        </div>
+                    </div>
+                </div>
+                <div class="access-panel-qr">
+                    <div class="qr-title">Scan QR Portal</div>
+                    <div class="qr-card">
+                        <img src="{{ $qrUrl }}" alt="QR Portal Self Servis" class="qr-image">
+                    </div>
+                    <div class="qr-caption">Arahkan kamera ponsel untuk membuka portal self servis siswa.</div>
+                </div>
+            </div>
+        </div>
+
+        <table>
+            <thead>
+                <tr>
+                    <th style="width: 42px;">No</th>
+                    <th>Nama Siswa</th>
+                    <th style="width: 120px;">NIS</th>
+                    <th style="width: 140px;">NISN</th>
+                    <th style="width: 170px;">Kode Akses</th>
+                    <th style="width: 120px;">Tanda Terima</th>
+                </tr>
+            </thead>
+            <tbody>
+                @foreach ($students as $index => $student)
+                    <tr>
+                        <td class="center">{{ $index + 1 }}</td>
+                        <td>{{ $student->full_name }}</td>
+                        <td class="center">{{ $student->student_number ?: '-' }}</td>
+                        <td class="center">{{ $student->nisn ?: '-' }}</td>
+                        <td class="code">{{ $student->self_service_access_code ?: '-' }}</td>
+                        <td></td>
+                    </tr>
+                @endforeach
+            </tbody>
+        </table>
+
+        <div class="notes">
+            <div class="notes-title">Catatan Penggunaan:</div>
+            <ol>
+                <li>Siswa masuk ke portal self servis menggunakan NIS/NISN dan kode akses pada lembar ini.</li>
+                <li>Siswa juga dapat membuka portal dengan scan QR atau mengetik link portal yang tercantum di dokumen ini.</li>
+                <li>Jika kode akses hilang atau perlu diganti, admin sekolah dapat melakukan generate ulang dari panel admin.</li>
+                <li>Disarankan wali kelas memastikan setiap siswa menerima kode akses yang benar.</li>
+            </ol>
+        </div>
+
+        <table class="signature">
+            <tr>
+                <td>
+                    <div class="signature-box">
+                        Mengetahui,<br>
+                        Admin Kesiswaan
+                        <div class="signature-space"></div>
+                        (........................................)
+                    </div>
+                </td>
+                <td>
+                    <div class="signature-box">
+                        Diterima oleh,<br>
+                        Wali Kelas / Petugas
+                        <div class="signature-space"></div>
+                        (........................................)
+                    </div>
+                </td>
+            </tr>
+        </table>
+
+        <div class="footer">
+            Dokumen ini digenerate dari sistem Database Kesiswaan · Export kode akses self servis siswa per kelas
+        </div>
+    </div>
+</body>
+</html>

resources/views/student-self-service/index.blade.php

@@ -1,5 +1,5 @@
 <x-master-page title="Self Servis Siswa" description="Pantau progres pelengkapan data mandiri siswa dan kelola kode akses portal self servis.">
-    <div class="grid grid-cols-1 gap-4 md:grid-cols-2 xl:grid-cols-4">
+    <div class="grid grid-cols-1 gap-4 md:grid-cols-2 xl:grid-cols-5">
         <div class="rounded-3xl border border-slate-200 bg-white p-6 shadow-sm shadow-slate-200/50">
             <div class="text-sm font-medium text-slate-500">Total Siswa</div>
             <div class="mt-3 text-3xl font-bold text-slate-900">{{ $summary['total'] }}</div>
@@ -16,8 +16,76 @@
             <div class="text-sm font-medium text-emerald-700">Sudah Dikirim</div>
             <div class="mt-3 text-3xl font-bold text-emerald-800">{{ $summary['submitted'] }}</div>
         </div>
+        <div class="rounded-3xl border {{ $summary['without_code'] > 0 ? 'border-rose-200 bg-rose-50' : 'border-sky-200 bg-sky-50' }} p-6 shadow-sm {{ $summary['without_code'] > 0 ? 'shadow-rose-100/50' : 'shadow-sky-100/50' }}">
+            <div class="text-sm font-medium {{ $summary['without_code'] > 0 ? 'text-rose-700' : 'text-sky-700' }}">Belum Punya Kode</div>
+            <div class="mt-3 text-3xl font-bold {{ $summary['without_code'] > 0 ? 'text-rose-800' : 'text-sky-800' }}">{{ $summary['without_code'] }}</div>
+        </div>
     </div>
 
+    <x-master-card title="Manajemen Kode Akses" subtitle="Kelola pembuatan kode akses siswa dan siapkan daftar kode per kelas untuk dibagikan ke wali kelas, siswa, atau orang tua.">
+        <div class="space-y-4">
+            <div class="rounded-2xl border {{ $summary['without_code'] > 0 ? 'border-amber-200 bg-amber-50' : 'border-emerald-200 bg-emerald-50' }} px-4 py-3 shadow-sm {{ $summary['without_code'] > 0 ? 'shadow-amber-100/40' : 'shadow-emerald-100/40' }}">
+                <div class="flex flex-col gap-2 lg:flex-row lg:items-center lg:justify-between">
+                    <div>
+                        <div class="text-sm font-semibold {{ $summary['without_code'] > 0 ? 'text-amber-800' : 'text-emerald-800' }}">
+                            {{ $summary['without_code'] > 0 ? 'Masih ada siswa yang belum punya kode akses' : 'Semua siswa sudah memiliki kode akses' }}
+                        </div>
+                        <p class="mt-0.5 text-xs leading-5 {{ $summary['without_code'] > 0 ? 'text-amber-700' : 'text-emerald-700' }}">
+                            {{ $summary['without_code'] > 0
+                                ? $summary['without_code'] . ' siswa belum memiliki kode. Gunakan generate massal agar portal self servis bisa langsung dipakai.'
+                                : 'Kode akses sudah lengkap. Anda bisa reset bila sekolah ingin mengganti seluruh batch kode.' }}
+                        </p>
+                    </div>
+                    <div class="inline-flex items-center rounded-full {{ $summary['without_code'] > 0 ? 'bg-white text-amber-800' : 'bg-white text-emerald-800' }} px-3 py-1.5 text-[11px] font-semibold uppercase tracking-[0.16em] shadow-sm">
+                        {{ $summary['with_code'] }} siswa sudah punya kode
+                    </div>
+                </div>
+            </div>
+
+            <div class="grid grid-cols-1 gap-4 xl:grid-cols-[1.15fr_0.85fr]">
+                <div class="rounded-2xl border border-slate-200 bg-slate-50 p-4">
+                    <div class="mb-3">
+                        <h4 class="text-xs font-semibold uppercase tracking-[0.16em] text-slate-500">Aksi Massal Kode Akses</h4>
+                        <p class="mt-1 text-sm text-slate-500">Bootstrap awal atau ganti seluruh kode akses.</p>
+                    </div>
+
+                    <div class="grid grid-cols-1 gap-3 md:grid-cols-2">
+                        <form method="POST" action="{{ route('student-self-service.generate-missing-codes') }}">
+                            @csrf
+                            <button type="submit" class="flex w-full flex-col rounded-2xl border border-indigo-200 bg-white px-4 py-3 text-left transition hover:border-indigo-300 hover:bg-indigo-50/60">
+                                <span class="text-sm font-semibold text-indigo-800">Generate Kode yang Belum Ada</span>
+                                <span class="mt-1 text-xs leading-5 text-slate-500">Tidak mengubah kode yang sudah dibagikan.</span>
+                            </button>
+                        </form>
+
+                        <form method="POST" action="{{ route('student-self-service.regenerate-all-codes') }}" class="delete-form" data-entity="seluruh kode akses self servis siswa">
+                            @csrf
+                            <button type="submit" class="flex w-full flex-col rounded-2xl border border-rose-200 bg-white px-4 py-3 text-left transition hover:border-rose-300 hover:bg-rose-50/60">
+                                <span class="text-sm font-semibold text-rose-800">Reset Semua Kode</span>
+                                <span class="mt-1 text-xs leading-5 text-slate-500">Ganti seluruh batch kode lama.</span>
+                            </button>
+                        </form>
+                    </div>
+                </div>
+
+                <div class="rounded-2xl border border-slate-200 bg-slate-50 p-4">
+                    <div class="mb-3">
+                        <h4 class="text-xs font-semibold uppercase tracking-[0.16em] text-slate-500">Export Kode per Kelas</h4>
+                        <p class="mt-1 text-sm text-slate-500">Siapkan lembar siap cetak / PDF per kelas.</p>
+                    </div>
+
+                    <form method="GET" action="{{ route('student-self-service.export-class-codes') }}" target="_blank" class="space-y-3">
+                        <x-form-select name="class_id" label="Kelas Tujuan Export" :options="$classes->all()" :value="$filters['class_id']" placeholder="-- Pilih kelas untuk export --" />
+
+                        <button type="submit" class="inline-flex w-full items-center justify-center rounded-2xl bg-slate-900 px-4 py-3 text-sm font-semibold text-white transition hover:bg-slate-800">
+                            Export Siap Cetak / PDF
+                        </button>
+                    </form>
+                </div>
+            </div>
+        </div>
+    </x-master-card>
+
     <x-master-card title="Filter Self Servis Siswa" subtitle="Cari siswa, filter per tahun angkatan, kelas, atau status self servis.">
         <form method="GET" action="{{ route('student-self-service.index') }}" class="grid grid-cols-1 gap-4 md:grid-cols-2 xl:grid-cols-4">
             <x-form-input name="search" label="Pencarian" :value="$search" placeholder="Nama / NIS / NISN" />
@@ -43,6 +111,7 @@
                         <th class="px-6 py-4 text-left text-xs font-semibold uppercase tracking-[0.16em] text-slate-500">Status</th>
                         <th class="px-6 py-4 text-left text-xs font-semibold uppercase tracking-[0.16em] text-slate-500">Kode Akses</th>
                         <th class="px-6 py-4 text-left text-xs font-semibold uppercase tracking-[0.16em] text-slate-500">Aktivitas</th>
+                        <th class="px-6 py-4 text-left text-xs font-semibold uppercase tracking-[0.16em] text-slate-500">Aksi</th>
                     </tr>
                 </thead>
                 <tbody class="divide-y divide-slate-100 bg-white">
@@ -77,10 +146,25 @@
                                 <div>Terakhir akses: {{ $student->self_service_last_access_at?->format('d-m-Y H:i') ?: '-' }}</div>
                                 <div class="mt-1">Submitted: {{ $student->self_service_submitted_at?->format('d-m-Y H:i') ?: '-' }}</div>
                             </td>
+                            <td class="px-6 py-4 text-sm text-slate-600">
+                                <div class="flex flex-wrap items-center gap-2">
+                                    @if ($student->self_service_access_code)
+                                        <button type="button" class="rounded-xl border border-sky-200 px-3 py-2 text-xs font-semibold text-sky-700 transition hover:bg-sky-50" onclick="navigator.clipboard.writeText('{{ $student->self_service_access_code }}')">
+                                            Copy Kode
+                                        </button>
+                                    @endif
+                                    <form method="POST" action="{{ route('student-self-service.regenerate-student-code', $student) }}" class="delete-form" data-entity="kode akses {{ $student->full_name }}">
+                                        @csrf
+                                        <button type="submit" class="rounded-xl border border-amber-200 px-3 py-2 text-xs font-semibold text-amber-700 transition hover:bg-amber-50">
+                                            {{ $student->self_service_access_code ? 'Reset Kode' : 'Generate Kode' }}
+                                        </button>
+                                    </form>
+                                </div>
+                            </td>
                         </tr>
                     @empty
                         <tr>
-                            <td colspan="5" class="px-6 py-10 text-center text-sm text-slate-500">Belum ada data siswa untuk self servis.</td>
+                            <td colspan="6" class="px-6 py-10 text-center text-sm text-slate-500">Belum ada data siswa untuk self servis.</td>
                         </tr>
                     @endforelse
                 </tbody>

routes/web.php

@@ -74,6 +74,10 @@ Route::middleware(['auth', 'verified'])->group(function () {
     Route::post('student-promotions', [StudentPromotionController::class, 'store'])->name('student-promotions.store');
     Route::resource('student-achievements', StudentAchievementController::class)->except(['show']);
     Route::get('student-self-service', [StudentSelfServiceController::class, 'index'])->name('student-self-service.index');
+    Route::post('student-self-service/generate-missing-codes', [StudentSelfServiceController::class, 'generateMissingCodes'])->name('student-self-service.generate-missing-codes');
+    Route::post('student-self-service/regenerate-all-codes', [StudentSelfServiceController::class, 'regenerateAllCodes'])->name('student-self-service.regenerate-all-codes');
+    Route::post('student-self-service/{student}/regenerate-code', [StudentSelfServiceController::class, 'regenerateStudentCode'])->name('student-self-service.regenerate-student-code');
+    Route::get('student-self-service/export-class-codes', [StudentSelfServiceController::class, 'exportClassCodes'])->name('student-self-service.export-class-codes');
     Route::resource('students.parents', StudentParentController::class)->except(['index', 'show']);
     Route::resource('students.documents', StudentDocumentController::class)->except(['index', 'show']);
     Route::post('students/{student}/documents/{document}/quick-verify', [StudentDocumentController::class, 'quickVerify'])->name('students.documents.quick-verify');