Merge pull request 'feat: implement letter request management with CRUD operations' (#28) from feat/implement-letter-request into dev

Reviewed-on: itm/siakad-itm#28

app/Enums/LetterStatus.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Enums;
+
+enum LetterStatus: string
+{
+    case Submitted = 'submitted';
+    case InProcess = 'in_process';
+    case Completed = 'completed';
+    case Rejected = 'rejected';
+
+    public function label(): string
+    {
+        return match ($this) {
+            self::Submitted => 'Diajukan',
+            self::InProcess => 'Diproses',
+            self::Completed => 'Selesai',
+            self::Rejected => 'Ditolak',
+        };
+    }
+}

app/Http/Controllers/Admin/Manage/LetterRequestController.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Manage;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Admin\Manage\LetterRequestRequest;
+use App\Http\Requests\PaginatedRequest;
+use App\Models\LetterRequest;
+use App\Services\Admin\Manage\LetterRequestService;
+use App\Services\Admin\Users\StudentService;
+use Illuminate\Http\RedirectResponse;
+use Inertia\Inertia;
+use Inertia\Response;
+
+class LetterRequestController extends Controller
+{
+    public function __construct(
+        private readonly LetterRequestService $service,
+        private readonly StudentService $studentService,
+    ) {}
+
+    public function index(PaginatedRequest $request): Response
+    {
+        return Inertia::render('admin/manage/letter-requests/index', [
+            'letterRequests' => $this->service->paginated(...$request->validatedWithDefaults()),
+            'students' => $this->studentService->getAllForSelect(),
+        ]);
+    }
+
+    public function store(LetterRequestRequest $request): RedirectResponse
+    {
+        $this->service->create($request->validated(), $request->file('result'));
+
+        Inertia::flash('toast', ['type' => 'success', 'message' => 'Surat permohonan berhasil ditambahkan.']);
+
+        return to_route('admin.manage.letter-requests.index');
+    }
+
+    public function update(LetterRequestRequest $request, LetterRequest $letterRequest): RedirectResponse
+    {
+        $this->service->update($letterRequest, $request->validated(), $request->file('result'));
+
+        Inertia::flash('toast', ['type' => 'success', 'message' => 'Surat permohonan berhasil diperbarui.']);
+
+        return to_route('admin.manage.letter-requests.index');
+    }
+
+    public function destroy(LetterRequest $letterRequest): RedirectResponse
+    {
+        $this->service->delete($letterRequest);
+
+        return Inertia::flash('toast', ['type' => 'success', 'message' => 'Surat permohonan berhasil dihapus.'])->back();
+    }
+}

app/Http/Requests/Admin/Manage/LetterRequestRequest.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Http\Requests\Admin\Manage;
+
+use App\Enums\LetterStatus;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class LetterRequestRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'student_id' => ['required', 'integer', Rule::exists('students', 'id')],
+            'letter_type' => ['required', 'string', 'max:100'],
+            'purpose' => ['nullable', 'string'],
+            'status' => ['nullable', Rule::enum(LetterStatus::class)],
+            'result' => ['nullable', 'file', 'max:10240', 'mimes:pdf,jpg,jpeg,png,doc,docx'],
+        ];
+    }
+}

app/Models/LetterRequest.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace App\Models;
+
+use App\Enums\LetterStatus;
+use Illuminate\Database\Eloquent\Attributes\Appends;
+use Illuminate\Database\Eloquent\Attributes\Guarded;
+use Illuminate\Database\Eloquent\Casts\Attribute;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Spatie\MediaLibrary\HasMedia;
+use Spatie\MediaLibrary\InteractsWithMedia;
+
+#[Guarded(['id'])]
+#[Appends(['result_url', 'result_name'])]
+class LetterRequest extends Model implements HasMedia
+{
+    use HasFactory, InteractsWithMedia;
+
+    protected function casts(): array
+    {
+        return [
+            'status' => LetterStatus::class,
+            'submitted_at' => 'datetime',
+            'completed_at' => 'datetime',
+        ];
+    }
+
+    public function registerMediaCollections(): void
+    {
+        $this->addMediaCollection('letter_result')->singleFile();
+    }
+
+    public function student(): BelongsTo
+    {
+        return $this->belongsTo(Student::class);
+    }
+
+    public function processor(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'processed_by');
+    }
+
+    protected function resultUrl(): Attribute
+    {
+        return Attribute::make(
+            get: fn () => $this->getFirstMediaUrl('letter_result') ?: null,
+        );
+    }
+
+    protected function resultName(): Attribute
+    {
+        return Attribute::make(
+            get: fn () => $this->getFirstMedia('letter_result')?->file_name,
+        );
+    }
+}

app/Models/Student.php

@@ -61,4 +61,9 @@ public function courseRegistrations(): HasMany
     {
         return $this->hasMany(CourseRegistration::class);
     }
+
+    public function letterRequests(): HasMany
+    {
+        return $this->hasMany(LetterRequest::class);
+    }
 }

app/Services/Admin/Manage/LetterRequestService.php

@@ -0,0 +1,70 @@
+<?php
+
+namespace App\Services\Admin\Manage;
+
+use App\Enums\LetterStatus;
+use App\Models\LetterRequest;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
+use Illuminate\Http\UploadedFile;
+
+class LetterRequestService
+{
+    public function paginated(int $perPage = 25, string $search = '', string $sort = 'created_at', string $direction = 'desc', array $filters = []): LengthAwarePaginator
+    {
+        return LetterRequest::query()
+            ->select(['id', 'student_id', 'letter_type', 'purpose', 'status', 'processed_by', 'submitted_at', 'completed_at'])
+            ->with(['student.user.profile', 'student.department', 'processor.profile'])
+            ->when($search, fn ($q) => $q->where('letter_type', 'like', "%{$search}%")
+                ->orWhereHas('student', fn ($q) => $q->where('student_number', 'like', "%{$search}%")
+                    ->orWhereHas('user.profile', fn ($q) => $q->where('full_name', 'like', "%{$search}%"))))
+            ->orderBy($sort, $direction)
+            ->paginate($perPage);
+    }
+
+    public function create(array $data, ?UploadedFile $result): LetterRequest
+    {
+        $status = $data['status'] ?? LetterStatus::Submitted->value;
+
+        $letterRequest = LetterRequest::create([
+            'student_id' => $data['student_id'],
+            'letter_type' => $data['letter_type'],
+            'purpose' => $data['purpose'] ?? null,
+            'status' => $status,
+            'processed_by' => $status !== LetterStatus::Submitted->value ? auth()->id() : null,
+            'submitted_at' => now(),
+            'completed_at' => $status === LetterStatus::Completed->value ? now() : null,
+        ]);
+
+        if ($result) {
+            $letterRequest->addMedia($result)->toMediaCollection('letter_result');
+        }
+
+        return $letterRequest;
+    }
+
+    public function update(LetterRequest $letterRequest, array $data, ?UploadedFile $result): LetterRequest
+    {
+        $status = $data['status'] ?? LetterStatus::Submitted->value;
+
+        $letterRequest->student_id = $data['student_id'];
+        $letterRequest->letter_type = $data['letter_type'];
+        $letterRequest->purpose = $data['purpose'] ?? null;
+        $letterRequest->status = $status;
+        $letterRequest->processed_by = $status !== LetterStatus::Submitted->value ? auth()->id() : null;
+        $letterRequest->completed_at = $status === LetterStatus::Completed->value
+            ? ($letterRequest->completed_at ?? now())
+            : null;
+        $letterRequest->update();
+
+        if ($result) {
+            $letterRequest->addMedia($result)->toMediaCollection('letter_result');
+        }
+
+        return $letterRequest;
+    }
+
+    public function delete(LetterRequest $letterRequest): bool
+    {
+        return $letterRequest->delete();
+    }
+}

database/migrations/2026_08_25_000003_create_letter_requests_table.php

@@ -0,0 +1,29 @@
+<?php
+
+use App\Enums\LetterStatus;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('letter_requests', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('student_id')->constrained()->cascadeOnDelete();
+            $table->string('letter_type', 100);
+            $table->text('purpose')->nullable();
+            $table->enum('status', array_values(LetterStatus::cases()))->nullable()->default(LetterStatus::Submitted->value);
+            $table->foreignId('processed_by')->nullable()->constrained('users')->nullOnDelete();
+            $table->timestamp('submitted_at')->nullable()->useCurrent();
+            $table->timestamp('completed_at')->nullable();
+            $table->timestamps();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('letter_requests');
+    }
+};

database/seeders/DatabaseSeeder.php

@@ -29,6 +29,7 @@ public function run(): void
             TuitionInvoiceSeeder::class,
             TuitionPaymentSeeder::class,
             AnnouncementSeeder::class,
+            LetterRequestSeeder::class,
         ]);
     }
 }

database/seeders/LetterRequestSeeder.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace Database\Seeders;
+
+use App\Models\LetterRequest;
+use Illuminate\Database\Seeder;
+
+class LetterRequestSeeder extends Seeder
+{
+    public function run(): void
+    {
+        LetterRequest::insert([
+            [
+                'student_id' => 1,
+                'letter_type' => 'Surat Aktif Kuliah',
+                'purpose' => 'Persyaratan pengajuan beasiswa',
+                'status' => 'completed',
+                'processed_by' => 5,
+                'submitted_at' => '2026-07-01 09:00:00',
+                'completed_at' => '2026-07-02 14:00:00',
+                'created_at' => '2026-07-01 09:00:00',
+                'updated_at' => '2026-07-02 14:00:00',
+            ],
+            [
+                'student_id' => 2,
+                'letter_type' => 'Surat Keterangan Lulus Sementara',
+                'purpose' => 'Persyaratan melamar magang',
+                'status' => 'in_process',
+                'processed_by' => 5,
+                'submitted_at' => '2026-08-01 09:00:00',
+                'completed_at' => null,
+                'created_at' => '2026-08-01 09:00:00',
+                'updated_at' => '2026-08-01 09:00:00',
+            ],
+        ]);
+    }
+}

resources/js/components/app-sidebar.tsx

@@ -16,6 +16,7 @@ import {
     FileCheck2,
     FileText,
     GraduationCap,
+    Mail,
     Megaphone,
     Receipt,
     School,
@@ -42,6 +43,7 @@ import { index as attendancesRoute } from '@/routes/admin/manage/attendances';
 import { index as courseClassesRoute } from '@/routes/admin/manage/course-classes';
 import { index as courseRegistrationsRoute } from '@/routes/admin/manage/course-registrations';
 import { index as coursesRoute } from '@/routes/admin/manage/courses';
+import { index as letterRequestsRoute } from '@/routes/admin/manage/letter-requests';
 import { index as materialsRoute } from '@/routes/admin/manage/materials';
 import { index as schedulesRoute } from '@/routes/admin/manage/schedules';
 import { index as tuitionInvoicesRoute } from '@/routes/admin/manage/tuition-invoices';
@@ -141,6 +143,16 @@ const data: {
                 },
             ],
         },
+        {
+            label: 'Layanan',
+            items: [
+                {
+                    name: 'Surat Permohonan',
+                    url: letterRequestsRoute.url(),
+                    icon: Mail,
+                },
+            ],
+        },
         {
             label: 'Pengguna',
             items: [

resources/js/pages/admin/manage/letter-requests/columns.tsx

@@ -0,0 +1,160 @@
+import type { ColumnDef } from '@tanstack/react-table';
+import { format } from 'date-fns';
+import { Paperclip, Pencil, Trash2 } from 'lucide-react';
+import { RowActions } from '@/components/row-actions';
+import { Badge } from '@/components/ui/badge';
+import type { LetterRequest, LetterStatus } from '@/types/letter-request';
+import { LetterStatusLabels } from '@/types/letter-request';
+
+export type { LetterRequest } from '@/types/letter-request';
+
+type CreateColumnsParams = {
+    handleEdit: (letterRequest: LetterRequest) => void;
+    handleDeleteClick: (letterRequest: LetterRequest) => void;
+};
+
+export function createLetterRequestColumns(
+    params: CreateColumnsParams,
+): ColumnDef<LetterRequest>[] {
+    const { handleEdit, handleDeleteClick } = params;
+
+    return [
+        {
+            accessorKey: 'student.student_number',
+            header: () => <span>Mahasiswa</span>,
+            cell: ({ row }) => {
+                const student = row.original.student;
+
+                return (
+                    <div>
+                        <p className="font-medium">
+                            {student?.user?.profile?.full_name ?? 'N/A'}
+                        </p>
+                        <p className="text-xs text-muted-foreground">
+                            {student?.student_number} &middot;{' '}
+                            {student?.department?.name ?? '-'}
+                        </p>
+                    </div>
+                );
+            },
+        },
+        {
+            accessorKey: 'letter_type',
+            header: () => <span>Jenis Surat</span>,
+            cell: ({ row }) => {
+                const letterRequest = row.original;
+
+                return (
+                    <div>
+                        <p className="font-medium">
+                            {letterRequest.letter_type}
+                        </p>
+                        {letterRequest.purpose && (
+                            <p className="line-clamp-1 max-w-xs text-xs text-muted-foreground">
+                                {letterRequest.purpose}
+                            </p>
+                        )}
+                    </div>
+                );
+            },
+        },
+        {
+            accessorKey: 'status',
+            header: () => <span className="block text-center">Status</span>,
+            meta: {
+                className: 'w-[120px] text-center',
+                headerClassName: 'w-[120px] text-center',
+            },
+            cell: ({ row }) => {
+                const status = row.getValue('status') as LetterStatus | null;
+
+                const variant =
+                    status === 'completed'
+                        ? 'default'
+                        : status === 'rejected'
+                          ? 'destructive'
+                          : status === 'in_process'
+                            ? 'secondary'
+                            : 'outline';
+
+                return (
+                    <div className="flex justify-center">
+                        {status ? (
+                            <Badge variant={variant}>
+                                {LetterStatusLabels[status]}
+                            </Badge>
+                        ) : (
+                            <span className="text-muted-foreground">-</span>
+                        )}
+                    </div>
+                );
+            },
+        },
+        {
+            accessorKey: 'processor.profile.full_name',
+            header: () => <span>Diproses Oleh</span>,
+            cell: ({ row }) =>
+                row.original.processor?.profile?.full_name ?? '-',
+        },
+        {
+            accessorKey: 'submitted_at',
+            header: () => <span>Diajukan</span>,
+            cell: ({ row }) => {
+                const submittedAt = row.original.submitted_at;
+
+                return submittedAt
+                    ? format(new Date(submittedAt), 'd MMM yyyy, HH:mm')
+                    : '-';
+            },
+        },
+        {
+            accessorKey: 'result_name',
+            header: () => <span>Dokumen</span>,
+            cell: ({ row }) => {
+                const letterRequest = row.original;
+
+                if (!letterRequest.result_url) {
+                    return <span className="text-muted-foreground">-</span>;
+                }
+
+                return (
+                    <a
+                        href={letterRequest.result_url}
+                        target="_blank"
+                        rel="noreferrer"
+                        className="inline-flex items-center gap-1 text-primary underline underline-offset-4 hover:text-primary/80"
+                    >
+                        <Paperclip className="h-3.5 w-3.5" />
+                        {letterRequest.result_name}
+                    </a>
+                );
+            },
+        },
+        {
+            id: 'actions',
+            header: () => <span className="block text-center">Aksi</span>,
+            meta: {
+                className: 'w-[100px] text-center',
+                headerClassName: 'w-[100px] text-center',
+            },
+            cell: ({ row }) => (
+                <RowActions
+                    actions={[
+                        {
+                            label: 'Edit',
+                            icon: <Pencil className="h-4 w-4" />,
+                            onClick: () => handleEdit(row.original),
+                        },
+                        {
+                            label: 'Hapus',
+                            icon: (
+                                <Trash2 className="h-4 w-4 text-destructive" />
+                            ),
+                            onClick: () => handleDeleteClick(row.original),
+                        },
+                    ]}
+                />
+            ),
+        },
+    ];
+}

resources/js/pages/admin/manage/letter-requests/index.tsx

@@ -0,0 +1,329 @@
+import { Head, router } from '@inertiajs/react';
+import { Plus } from 'lucide-react';
+import { useState } from 'react';
+import type { PaginationState } from '@/components/data-table';
+import { DataTable } from '@/components/data-table';
+import { DeleteConfirmDialog } from '@/components/delete-confirm-dialog';
+import { FileUploadField } from '@/components/file-upload-field';
+import { FormDialog } from '@/components/form-dialog';
+import InputError from '@/components/input-error';
+import { PageHeader } from '@/components/page-header';
+import { Button } from '@/components/ui/button';
+import { Input } from '@/components/ui/input';
+import { Label } from '@/components/ui/label';
+import {
+    Select,
+    SelectContent,
+    SelectItem,
+    SelectTrigger,
+    SelectValue,
+} from '@/components/ui/select';
+import { Textarea } from '@/components/ui/textarea';
+import { useServerTable } from '@/hooks/use-server-table';
+import {
+    index as letterRequestIndex,
+    destroy,
+    store,
+    update,
+} from '@/routes/admin/manage/letter-requests';
+import type {
+    LetterRequest,
+    LetterRequestStudent,
+} from '@/types/letter-request';
+import { LetterStatuses, LetterStatusLabels } from '@/types/letter-request';
+import { createLetterRequestColumns } from './columns';
+
+type Props = {
+    letterRequests: {
+        data: LetterRequest[];
+        current_page: number;
+        last_page: number;
+        per_page: number;
+        total: number;
+    };
+    students: LetterRequestStudent[];
+    highlight?: number;
+};
+
+function studentLabel(student: LetterRequestStudent): string {
+    return `${student.user?.profile?.full_name ?? 'N/A'} - ${student.student_number}`;
+}
+
+export default function LetterRequestIndex({
+    letterRequests,
+    students,
+    highlight,
+}: Props) {
+    const [createOpen, setCreateOpen] = useState(false);
+    const [editing, setEditing] = useState<LetterRequest | null>(null);
+    const [deleting, setDeleting] = useState<LetterRequest | null>(null);
+
+    const pagination: PaginationState = {
+        current_page: letterRequests.current_page,
+        last_page: letterRequests.last_page,
+        per_page: letterRequests.per_page,
+        total: letterRequests.total,
+    };
+
+    const {
+        search,
+        handlePageChange,
+        handlePerPageChange,
+        handleSearchChange,
+    } = useServerTable({
+        route: () => letterRequestIndex.url(),
+        pagination,
+    });
+
+    function handleDelete() {
+        if (!deleting) {
+            return;
+        }
+
+        router.delete(destroy(deleting.id), {
+            onSuccess: () => setDeleting(null),
+        });
+    }
+
+    const columns = createLetterRequestColumns({
+        handleEdit: (letterRequest) => setEditing(letterRequest),
+        handleDeleteClick: (letterRequest) => setDeleting(letterRequest),
+    });
+
+    return (
+        <>
+            <Head title="Surat Permohonan" />
+
+            <div className="flex h-full flex-1 flex-col gap-6 overflow-x-auto p-4 md:p-6">
+                <PageHeader
+                    title="Surat Permohonan"
+                    description={
+                        highlight && (
+                            <p className="mt-1 text-sm text-muted-foreground">
+                                Menampilkan surat permohonan dari notifikasi.
+                            </p>
+                        )
+                    }
+                    actions={
+                        <Button asChild>
+                            <button
+                                type="button"
+                                onClick={() => setCreateOpen(true)}
+                            >
+                                <Plus className="h-4 w-4" />
+                                Tambah
+                            </button>
+                        </Button>
+                    }
+                />
+
+                <CreateForm
+                    open={createOpen}
+                    onOpenChange={setCreateOpen}
+                    students={students}
+                />
+
+                <EditForm
+                    key={editing?.id}
+                    open={editing !== null}
+                    onOpenChange={(open) => {
+                        if (!open) {
+                            setEditing(null);
+                        }
+                    }}
+                    editing={editing}
+                    students={students}
+                />
+
+                <DataTable
+                    columns={columns}
+                    data={letterRequests.data}
+                    emptyText="Belum ada surat permohonan."
+                    pagination={pagination}
+                    onPageChange={handlePageChange}
+                    onPerPageChange={handlePerPageChange}
+                    onSearchChange={handleSearchChange}
+                    searchValue={search}
+                    searchKey="student"
+                    searchPlaceholder="Cari nama, NIM, atau jenis surat..."
+                />
+
+                <DeleteConfirmDialog
+                    target={deleting}
+                    onOpenChange={(open) => {
+                        if (!open) {
+                            setDeleting(null);
+                        }
+                    }}
+                    title="Hapus Surat Permohonan"
+                    description={(letterRequest) =>
+                        `Apakah Anda yakin ingin menghapus permohonan "${letterRequest.letter_type}" milik "${letterRequest.student?.user?.profile?.full_name ?? 'mahasiswa ini'}"? Tindakan ini tidak dapat dibatalkan.`
+                    }
+                    onConfirm={handleDelete}
+                />
+            </div>
+        </>
+    );
+}
+
+function LetterRequestFields({
+    errors,
+    editing,
+    students,
+    resetKey,
+}: {
+    errors: Record<string, string>;
+    editing?: LetterRequest;
+    students: LetterRequestStudent[];
+    resetKey?: string;
+}) {
+    return (
+        <>
+            <div className="grid gap-2">
+                <Label>
+                    Mahasiswa <span className="text-destructive">*</span>
+                </Label>
+                {!editing && <input type="hidden" name="student_id" />}
+                <Select
+                    name="student_id"
+                    defaultValue={
+                        editing ? String(editing.student_id) : undefined
+                    }
+                >
+                    <SelectTrigger className="w-full">
+                        <SelectValue placeholder="Pilih mahasiswa" />
+                    </SelectTrigger>
+                    <SelectContent>
+                        {students.map((student) => (
+                            <SelectItem
+                                key={student.id}
+                                value={String(student.id)}
+                            >
+                                {studentLabel(student)}
+                            </SelectItem>
+                        ))}
+                    </SelectContent>
+                </Select>
+                <InputError message={errors.student_id} />
+            </div>
+            <div className="grid gap-2">
+                <Label htmlFor="letter_type">
+                    Jenis Surat <span className="text-destructive">*</span>
+                </Label>
+                <Input
+                    id="letter_type"
+                    name="letter_type"
+                    placeholder="Contoh: Surat Aktif Kuliah"
+                    defaultValue={editing?.letter_type ?? ''}
+                    aria-invalid={!!errors.letter_type}
+                />
+                <InputError message={errors.letter_type} />
+            </div>
+            <div className="grid gap-2">
+                <Label htmlFor="purpose">Keperluan</Label>
+                <Textarea
+                    id="purpose"
+                    name="purpose"
+                    placeholder="Keperluan pengajuan surat"
+                    defaultValue={editing?.purpose ?? ''}
+                    aria-invalid={!!errors.purpose}
+                />
+                <InputError message={errors.purpose} />
+            </div>
+            <div className="grid gap-2">
+                <Label>Status</Label>
+                <input type="hidden" name="status" />
+                <Select
+                    name="status"
+                    defaultValue={editing?.status ?? 'submitted'}
+                >
+                    <SelectTrigger className="w-full">
+                        <SelectValue placeholder="Pilih status" />
+                    </SelectTrigger>
+                    <SelectContent>
+                        {LetterStatuses.map((status) => (
+                            <SelectItem key={status} value={status}>
+                                {LetterStatusLabels[status]}
+                            </SelectItem>
+                        ))}
+                    </SelectContent>
+                </Select>
+                <InputError message={errors.status} />
+            </div>
+            <FileUploadField
+                key={resetKey}
+                name="result"
+                label="Dokumen Hasil"
+                existingFileName={editing?.result_name}
+                existingFileUrl={editing?.result_url}
+                error={errors.result}
+            />
+        </>
+    );
+}
+
+function CreateForm({
+    open,
+    onOpenChange,
+    students,
+}: {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    students: LetterRequestStudent[];
+}) {
+    return (
+        <FormDialog
+            open={open}
+            onOpenChange={onOpenChange}
+            title="Tambah Surat Permohonan"
+            action={store()}
+            resetOnSuccess
+            onSuccess={() => onOpenChange(false)}
+        >
+            {({ errors }) => (
+                <div className="grid gap-4">
+                    <LetterRequestFields
+                        errors={errors}
+                        students={students}
+                        resetKey={open ? 'open' : 'closed'}
+                    />
+                </div>
+            )}
+        </FormDialog>
+    );
+}
+
+function EditForm({
+    open,
+    onOpenChange,
+    editing,
+    students,
+}: {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    editing: LetterRequest | null;
+    students: LetterRequestStudent[];
+}) {
+    return (
+        <FormDialog
+            open={open}
+            onOpenChange={onOpenChange}
+            title="Edit Surat Permohonan"
+            action={editing ? update(editing.id) : ''}
+            resetOnSuccess
+            onSuccess={() => onOpenChange(false)}
+        >
+            {({ errors }) =>
+                editing && (
+                    <div className="grid gap-4">
+                        <LetterRequestFields
+                            errors={errors}
+                            editing={editing}
+                            students={students}
+                        />
+                    </div>
+                )
+            }
+        </FormDialog>
+    );
+}

resources/js/types/letter-request.ts

@@ -0,0 +1,44 @@
+export const LetterStatuses = [
+    'submitted',
+    'in_process',
+    'completed',
+    'rejected',
+] as const;
+
+export type LetterStatus = (typeof LetterStatuses)[number];
+
+export const LetterStatusLabels: Record<LetterStatus, string> = {
+    submitted: 'Diajukan',
+    in_process: 'Diproses',
+    completed: 'Selesai',
+    rejected: 'Ditolak',
+};
+
+export type LetterRequestStudent = {
+    id: number;
+    student_number: string;
+    department: { id: number; name: string } | null;
+    user: { profile: { full_name: string } | null } | null;
+};
+
+export type LetterRequestProcessor = {
+    id: number;
+    profile: { full_name: string } | null;
+};
+
+export type LetterRequest = {
+    id: number;
+    student_id: number;
+    student: LetterRequestStudent | null;
+    letter_type: string;
+    purpose: string | null;
+    status: LetterStatus | null;
+    processed_by: number | null;
+    processor: LetterRequestProcessor | null;
+    submitted_at: string | null;
+    completed_at: string | null;
+    result_url: string | null;
+    result_name: string | null;
+    created_at: string;
+    updated_at: string;
+};

routes/admin.php

@@ -7,6 +7,7 @@
 use App\Http\Controllers\Admin\Manage\CourseClassController;
 use App\Http\Controllers\Admin\Manage\CourseController;
 use App\Http\Controllers\Admin\Manage\CourseRegistrationController;
+use App\Http\Controllers\Admin\Manage\LetterRequestController;
 use App\Http\Controllers\Admin\Manage\MaterialController;
 use App\Http\Controllers\Admin\Manage\ScheduleController;
 use App\Http\Controllers\Admin\Manage\SubmissionController;
@@ -73,6 +74,8 @@
         });
 
         Route::resource('announcements', AnnouncementController::class)->except(['create', 'edit', 'show']);
+
+        Route::resource('letter-requests', LetterRequestController::class)->except(['create', 'edit', 'show']);
     });
 
     Route::prefix('admin/users')->name('admin.users.')->group(function () {