fix: qa report all

.env.example

@@ -1,4 +1,4 @@
-APP_NAME=Laravel
+APP_NAME="RAG Hub"
 APP_ENV=local
 APP_KEY=
 APP_DEBUG=true

resources/css/app.css

@@ -501,7 +501,7 @@ @layer components {
     }
 
     .register-card {
-        @apply w-full max-w-[559px] gap-0 rounded-[17px] border py-0;
+        @apply w-full max-w-[460px] gap-0 rounded-[17px] border py-0;
         background-color: var(--register-card-bg) !important;
         border-color: var(--register-card-border) !important;
         box-shadow: var(--register-card-shadow) !important;
@@ -570,7 +570,7 @@ @layer components {
     }
 
     .register-error {
-        @apply text-sm leading-snug font-medium;
+        @apply text-xs leading-snug;
         color: var(--register-danger);
     }
 
@@ -590,7 +590,7 @@ @layer components {
     }
 
     .login-card {
-        @apply max-w-[561px];
+        @apply max-w-[460px];
     }
 
     .login-card-content {
@@ -1632,7 +1632,7 @@ @layer components {
     }
 
     .lecturer-user-button {
-        @apply mb-3 w-fit gap-2 rounded-[6px] shadow-none;
+        @apply mb-3 w-fit gap-2 rounded-[6px] shadow-none cursor-default;
         background-color: var(--lecturer-surface-soft);
         color: var(--lecturer-text);
         height: auto !important;

resources/js/components/admin/admin-llm-form.tsx

@@ -16,7 +16,8 @@ import {
 import { Spinner } from '@/components/ui/spinner';
 import { stringValue } from '@/lib/admin';
 import { cn } from '@/lib/utils';
-import { patchLlmConfig } from '@/lib/rag-client';
+import { getLlmProviderOptions, patchLlmConfig } from '@/lib/rag-client';
+import type { LlmProviderConfig } from '@/lib/rag-client';
 import type { LlmConfig, LlmForm } from '@/types/admin';
 
 const PROVIDER_CONFIG: Record<
@@ -292,6 +293,13 @@ export function AdminLlmForm({ llm }: { llm?: LlmConfig | null }) {
     });
     const [isSubmitting, setIsSubmitting] = useState(false);
     const [error, setError] = useState<string | undefined>();
+    const [providerOptions, setProviderOptions] = useState<Record<string, LlmProviderConfig>>(PROVIDER_CONFIG);
+
+    useEffect(() => {
+        getLlmProviderOptions()
+            .then(setProviderOptions)
+            .catch(() => {}); // fallback ke PROVIDER_CONFIG jika gagal
+    }, []);
 
     function setField<K extends keyof LlmForm>(
         key: K,
@@ -301,13 +309,13 @@ export function AdminLlmForm({ llm }: { llm?: LlmConfig | null }) {
     }
 
     function handleProviderChange(provider: string): void {
-        const config = PROVIDER_CONFIG[provider];
+        const config = providerOptions[provider];
         setFormData((prev) => ({
             ...prev,
             provider,
             model: '',
             reasoning_effort: '',
-            base_url: config?.base_urls[0] ?? '',
+            base_url: config?.base_urls?.[0] ?? '',
         }));
     }
 
@@ -359,7 +367,7 @@ export function AdminLlmForm({ llm }: { llm?: LlmConfig | null }) {
         }
     }
 
-    const providerConfig = PROVIDER_CONFIG[formData.provider];
+    const providerConfig = providerOptions[formData.provider];
 
     return (
         <Card className="border-(--lecturer-border) bg-(--lecturer-surface)">
@@ -386,8 +394,11 @@ export function AdminLlmForm({ llm }: { llm?: LlmConfig | null }) {
                                     <SelectValue placeholder="Pilih provider" />
                                 </SelectTrigger>
                                 <SelectContent>
-                                    <SelectItem value="openai">OpenAI</SelectItem>
-                                    <SelectItem value="deepseek">Deepseek</SelectItem>
+                                    {Object.keys(providerOptions).map((p) => (
+                                        <SelectItem key={p} value={p}>
+                                            {p.charAt(0).toUpperCase() + p.slice(1)}
+                                        </SelectItem>
+                                    ))}
                                 </SelectContent>
                             </Select>
                         </Field>

resources/js/components/admin/admin-shell.tsx

@@ -98,7 +98,7 @@ function getInitials(name: string): string {
 
 function confirmLogout(): void {
     clearAuthSession();
-    router.visit(adminLogin());
+    router.visit(adminLogin.url());
 }
 
 function AdminSidebarBrand() {

resources/js/components/admin/admin-user-management.tsx

@@ -80,7 +80,7 @@ export function AdminUserCreateCard({
         setError(undefined);
 
         try {
-            const payload = buildUserPayload(formData);
+            const payload = buildCreatePayload(formData);
             const created = await createAdminUser(payload);
             setFormData(emptyUserForm);
             onCreated?.(created);
@@ -192,7 +192,7 @@ export function AdminUserManagement({
         setCreateError(undefined);
 
         try {
-            const payload = buildUserPayload(createFormData);
+            const payload = buildCreatePayload(createFormData);
             const created = await createAdminUser(payload);
             setUsers((prev) => [created, ...prev]);
             setCreateFormData(emptyUserForm);
@@ -219,7 +219,7 @@ export function AdminUserManagement({
         setEditError(undefined);
 
         try {
-            const payload = buildUserPayload(editFormData);
+            const payload = buildUpdatePayload(editFormData);
             const updated = await updateAdminUser(editingUser.id, payload);
             setUsers((prev) =>
                 prev.map((u) => (u.id === updated.id ? updated : u)),
@@ -522,19 +522,28 @@ export function AdminUserManagement({
     );
 }
 
-function buildUserPayload(form: UserForm): Record<string, unknown> {
+function buildCreatePayload(form: UserForm): Record<string, unknown> {
+    // POST /auth/register — RegisterRequest schema
+    const payload: Record<string, unknown> = { role: form.role };
+    if (form.email) payload.email = form.email;
+    if (form.name) payload.name = form.name;
+    if (form.password) payload.password = form.password;
+    if (form.identity_number) payload.identity_number = form.identity_number;
+    if (form.phone) payload.phone = form.phone;
+    return payload;
+}
+
+function buildUpdatePayload(form: UserForm): Record<string, unknown> {
+    // PATCH /user/{id} — PatchUser schema (additionalProperties: false)
+    // Only: email, name, phone, role, is_active, password
     const payload: Record<string, unknown> = {
         is_active: form.is_active,
-        is_superuser: form.is_superuser,
         role: form.role,
     };
-    if (form.name) payload.name = form.name;
     if (form.email) payload.email = form.email;
-    if (form.password) payload.password = form.password;
-    if (form.identity_number) payload.identity_number = form.identity_number;
+    if (form.name) payload.name = form.name;
     if (form.phone) payload.phone = form.phone;
-    if (form.user_token) payload.user_token = form.user_token;
-
+    if (form.password) payload.password = form.password;
     return payload;
 }
 

resources/js/components/auth/register-role-form.tsx

@@ -83,11 +83,11 @@ function validateRegisterForm(
     const normalizedIdentityNumber = values.identity_number.trim();
 
     if (!normalizedName) {
-        errors.name = 'Nama lengkap wajib diisi.';
+        errors.name = 'Nama lengkap wajib diisi';
     } else if (normalizedName.length < 3) {
-        errors.name = 'Nama lengkap minimal 3 karakter.';
+        errors.name = 'Nama lengkap minimal 3 karakter';
     } else if (!namePattern.test(normalizedName)) {
-        errors.name = 'Nama hanya boleh berisi huruf dan tanda nama.';
+        errors.name = 'Nama hanya boleh berisi huruf dan tanda nama';
     }
 
     if (!normalizedIdentityNumber) {
@@ -101,27 +101,27 @@ function validateRegisterForm(
     }
 
     if (!normalizedEmail) {
-        errors.email = 'Email wajib diisi.';
+        errors.email = 'Email wajib diisi';
     } else if (
         normalizedEmail.includes(' ') ||
         !emailPattern.test(normalizedEmail)
     ) {
-        errors.email = 'Format email tidak valid.';
+        errors.email = 'Format email tidak valid';
     }
 
     const normalizedPhone = values.phone.trim().replace(/[\s().-]/g, '');
 
     if (normalizedPhone && !phonePattern.test(normalizedPhone)) {
         errors.phone =
-            'Nomor telepon hanya boleh angka dan opsional diawali tanda +.';
+            'Nomor telepon hanya boleh angka dan opsional diawali tanda +';
     }
 
     if (!values.password) {
-        errors.password = 'Password wajib diisi.';
+        errors.password = 'Password wajib diisi';
     } else if (values.password.length < 6) {
-        errors.password = 'Password minimal 6 karakter.';
+        errors.password = 'Password minimal 6 karakter';
     } else if (/\s/.test(values.password)) {
-        errors.password = 'Password tidak boleh mengandung spasi.';
+        errors.password = 'Password tidak boleh mengandung spasi';
     }
 
     return errors;

resources/js/lib/rag-client.ts

@@ -329,10 +329,20 @@ export function getRagConfig(): Promise<RagConfig> {
     return ragGet('/admin/rag/config');
 }
 
+export type LlmProviderConfig = {
+    base_urls?: string[];
+    models?: string[];
+    reasoning_efforts?: string[];
+};
+
 export function getLlmConfig(): Promise<LlmConfig> {
     return ragGet('/admin/rag/config/llm');
 }
 
+export function getLlmProviderOptions(): Promise<Record<string, LlmProviderConfig>> {
+    return ragGet('/admin/rag/config/llm/options');
+}
+
 export function patchLlmConfig(
     payload: Record<string, unknown>,
 ): Promise<LlmConfig> {
@@ -376,10 +386,15 @@ export function listAdminUsers(
     return ragGet(path);
 }
 
-export function createAdminUser(
+export async function createAdminUser(
     payload: Record<string, unknown>,
 ): Promise<AdminUser> {
-    return ragJson('/user', 'POST', payload);
+    const response = await ragJson<{ message: string; user: AdminUser }>(
+        '/auth/register',
+        'POST',
+        payload,
+    );
+    return response.user;
 }
 
 export function updateAdminUser(

resources/js/pages/dosen-detail.tsx

@@ -11,10 +11,12 @@ import {
 } from 'lucide-react';
 import type { ChangeEvent, DragEvent, FormEvent } from 'react';
 import { useEffect, useRef, useState } from 'react';
+import { toast } from 'sonner';
 
 import { DosenShell } from '@/components/dosen/dosen-shell';
 import { Button } from '@/components/ui/button';
 import { Card, CardContent } from '@/components/ui/card';
+import { Skeleton } from '@/components/ui/skeleton';
 import {
     Dialog,
     DialogContent,
@@ -177,6 +179,7 @@ export default function DosenDetail({ courseId }: DosenDetailProps) {
     const [editFormError, setEditFormError] = useState<string>();
     const [isUpdatingCourse, setIsUpdatingCourse] = useState(false);
     const [isDeletingCourse, setIsDeletingCourse] = useState(false);
+    const [isLoading, setIsLoading] = useState(true);
     const fileInputRef = useRef<HTMLInputElement>(null);
 
     const hasProcessingDocuments = documents.some(
@@ -184,13 +187,12 @@ export default function DosenDetail({ courseId }: DosenDetailProps) {
     );
 
     useEffect(() => {
-        getCourse(courseId)
-            .then((c) => setCourse(c))
-            .catch((e: Error) => setBackendMessage(e.message));
-
-        listCourseDocuments(courseId)
-            .then((r) => setDocuments(r.data))
-            .catch(() => {});
+        Promise.all([
+            getCourse(courseId).then(setCourse),
+            listCourseDocuments(courseId).then((r) => setDocuments(r.data)).catch(() => {}),
+        ])
+            .catch((e: Error) => setBackendMessage(e.message))
+            .finally(() => setIsLoading(false));
     }, [courseId]);
 
     useEffect(() => {
@@ -290,6 +292,7 @@ export default function DosenDetail({ courseId }: DosenDetailProps) {
 
         try {
             await deleteCourse(courseId);
+            toast.success('Mata kuliah berhasil dihapus');
             router.visit(dosen());
         } catch (e) {
             setBackendMessage(
@@ -338,6 +341,30 @@ export default function DosenDetail({ courseId }: DosenDetailProps) {
 
             <DosenShell>
                 <main className="lecturer-detail-page">
+                    {isLoading ? (
+                        <>
+                            <section className="lecturer-detail-header">
+                                <Skeleton className="size-8 rounded-full shrink-0" />
+                                <div className="lecturer-detail-heading flex-1">
+                                    <Skeleton className="h-7 w-48" />
+                                    <Skeleton className="mt-2 h-4 w-72" />
+                                </div>
+                                <div className="lecturer-detail-actions">
+                                    <Skeleton className="h-9 w-20" />
+                                    <Skeleton className="h-9 w-9" />
+                                </div>
+                            </section>
+                            <section className="lecturer-detail-content">
+                                <Skeleton className="h-36 w-full rounded-xl" />
+                                <div className="mt-4 grid gap-3">
+                                    {Array.from({ length: 3 }).map((_, i) => (
+                                        <Skeleton className="h-20 w-full rounded-xl" key={i} />
+                                    ))}
+                                </div>
+                            </section>
+                        </>
+                    ) : (
+                    <>
                     <section className="lecturer-detail-header">
                         <button
                             aria-label="Kembali ke dashboard dosen"
@@ -462,6 +489,8 @@ export default function DosenDetail({ courseId }: DosenDetailProps) {
                             </div>
                         </section>
                     </section>
+                    </>
+                    )}
                 </main>
 
                 <Dialog
@@ -570,18 +599,14 @@ export default function DosenDetail({ courseId }: DosenDetailProps) {
                     <DialogContent className="lecturer-course-dialog">
                         <DialogHeader>
                             <DialogTitle>Hapus Mata Kuliah</DialogTitle>
-                            <DialogDescription>
-                                Tindakan ini akan menghapus knowledge base dari
-                                backend.
-                            </DialogDescription>
                         </DialogHeader>
 
                         <div className="lecturer-course-form">
                             <p className="lecturer-delete-copy">
                                 Mata kuliah{' '}
                                 <strong>{course?.title ?? title}</strong> akan
-                                dihapus. Pastikan data ini memang sudah tidak
-                                dipakai.
+                                dihapus permanen. Pastikan data ini memang sudah
+                                tidak digunakan.
                             </p>
 
                             <DialogFooter className="lecturer-course-footer">

resources/js/pages/welcome.tsx

@@ -48,7 +48,7 @@ function AuthEntryCard({
 export default function Welcome({ canRegister = true }: WelcomeProps) {
     return (
         <>
-            <Head title="Welcome" />
+            <Head title="Selamat Datang" />
 
             <main className="welcome-shell">
                 <AppearanceToggle />

resources/views/app.blade.php

@@ -31,9 +31,9 @@
             }
         </style>
 
-        <link rel="icon" href="/favicon.ico" sizes="any">
-        <link rel="icon" href="/favicon.svg" type="image/svg+xml">
-        <link rel="apple-touch-icon" href="/apple-touch-icon.png">
+        <link rel="icon" href="/logo-sevima.svg" type="image/svg+xml">
+        <link rel="icon" href="/logo-sevima.png" type="image/png">
+        <link rel="apple-touch-icon" href="/logo-sevima.png">
 
         @fonts
 

sevima-raghub.json

@@ -23,7 +23,7 @@
         },
         "/api/v1/auth/register": {
             "post": {
-                "tags": ["v1", "auth"],
+                "tags": ["v1", "auth", "auth", "user"],
                 "summary": "Register",
                 "description": "Register a new user (student or lecturer). Source: openapi-spec /auth/register",
                 "operationId": "register_api_v1_auth_register_post",
@@ -182,31 +182,6 @@
                 }
             }
         },
-        "/api/v1/auth/api-keys": {
-            "post": {
-                "tags": ["v1", "auth"],
-                "summary": "Generate Api Key",
-                "description": "Generate a new API key. Restricted to lecturers and admins. Source: openapi-spec /auth/api-keys",
-                "operationId": "generate_api_key_api_v1_auth_api_keys_post",
-                "responses": {
-                    "201": {
-                        "description": "Successful Response",
-                        "content": {
-                            "application/json": {
-                                "schema": {
-                                    "$ref": "#/components/schemas/ApiKeyGenerateResponse"
-                                }
-                            }
-                        }
-                    }
-                },
-                "security": [
-                    {
-                        "JWTBearer": []
-                    }
-                ]
-            }
-        },
         "/api/v1/documents/upload": {
             "post": {
                 "tags": ["v1", "documents"],
@@ -539,131 +514,6 @@
                 "tags": ["v1", "user"],
                 "summary": "Get User List",
                 "operationId": "get_user_list_api_v1_user_get",
-                "parameters": [
-                    {
-                        "required": false,
-                        "schema": {
-                            "type": "string",
-                            "title": "Email"
-                        },
-                        "name": "email",
-                        "in": "query"
-                    },
-                    {
-                        "required": false,
-                        "schema": {
-                            "type": "string",
-                            "title": "User Token"
-                        },
-                        "name": "user_token",
-                        "in": "query"
-                    },
-                    {
-                        "required": false,
-                        "schema": {
-                            "type": "string",
-                            "title": "Name"
-                        },
-                        "name": "name",
-                        "in": "query"
-                    },
-                    {
-                        "required": false,
-                        "schema": {
-                            "type": "string",
-                            "title": "Phone"
-                        },
-                        "name": "phone",
-                        "in": "query"
-                    },
-                    {
-                        "required": false,
-                        "schema": {
-                            "$ref": "#/components/schemas/app__schema__user_schema__Role"
-                        },
-                        "name": "role",
-                        "in": "query"
-                    },
-                    {
-                        "required": false,
-                        "schema": {
-                            "type": "string",
-                            "title": "Identity Number"
-                        },
-                        "name": "identity_number",
-                        "in": "query"
-                    },
-                    {
-                        "required": false,
-                        "schema": {
-                            "type": "boolean",
-                            "title": "Is Active"
-                        },
-                        "name": "is_active",
-                        "in": "query"
-                    },
-                    {
-                        "required": false,
-                        "schema": {
-                            "type": "boolean",
-                            "title": "Is Superuser"
-                        },
-                        "name": "is_superuser",
-                        "in": "query"
-                    },
-                    {
-                        "required": false,
-                        "schema": {
-                            "type": "string",
-                            "title": "Ordering"
-                        },
-                        "name": "ordering",
-                        "in": "query"
-                    },
-                    {
-                        "required": false,
-                        "schema": {
-                            "type": "integer",
-                            "title": "Page"
-                        },
-                        "name": "page",
-                        "in": "query"
-                    },
-                    {
-                        "required": false,
-                        "schema": {
-                            "anyOf": [
-                                {
-                                    "type": "integer"
-                                },
-                                {
-                                    "type": "string"
-                                }
-                            ],
-                            "title": "Page Size"
-                        },
-                        "name": "page_size",
-                        "in": "query"
-                    },
-                    {
-                        "required": false,
-                        "schema": {
-                            "type": "string",
-                            "title": "Email  Eq"
-                        },
-                        "name": "email__eq",
-                        "in": "query"
-                    },
-                    {
-                        "required": false,
-                        "schema": {
-                            "type": "string",
-                            "title": "Identity Number  Eq"
-                        },
-                        "name": "identity_number__eq",
-                        "in": "query"
-                    }
-                ],
                 "responses": {
                     "200": {
                         "description": "Successful Response",
@@ -674,61 +524,6 @@
                                 }
                             }
                         }
-                    },
-                    "422": {
-                        "description": "Validation Error",
-                        "content": {
-                            "application/json": {
-                                "schema": {
-                                    "$ref": "#/components/schemas/HTTPValidationError"
-                                }
-                            }
-                        }
-                    }
-                },
-                "security": [
-                    {
-                        "JWTBearer": []
-                    },
-                    {
-                        "JWTBearer": []
-                    }
-                ]
-            },
-            "post": {
-                "tags": ["v1", "user"],
-                "summary": "Create User",
-                "operationId": "create_user_api_v1_user_post",
-                "requestBody": {
-                    "content": {
-                        "application/json": {
-                            "schema": {
-                                "$ref": "#/components/schemas/UpsertUser"
-                            }
-                        }
-                    },
-                    "required": true
-                },
-                "responses": {
-                    "200": {
-                        "description": "Successful Response",
-                        "content": {
-                            "application/json": {
-                                "schema": {
-                                    "$ref": "#/components/schemas/User"
-                                }
-                            }
-                        }
-                    },
-                    "422": {
-                        "description": "Validation Error",
-                        "content": {
-                            "application/json": {
-                                "schema": {
-                                    "$ref": "#/components/schemas/HTTPValidationError"
-                                }
-                            }
-                        }
                     }
                 },
                 "security": [
@@ -804,15 +599,8 @@
                     }
                 ],
                 "responses": {
-                    "200": {
-                        "description": "Successful Response",
-                        "content": {
-                            "application/json": {
-                                "schema": {
-                                    "$ref": "#/components/schemas/Blank"
-                                }
-                            }
-                        }
+                    "204": {
+                        "description": "Successful Response"
                     },
                     "422": {
                         "description": "Validation Error",
@@ -853,7 +641,7 @@
                     "content": {
                         "application/json": {
                             "schema": {
-                                "$ref": "#/components/schemas/UpsertUser"
+                                "$ref": "#/components/schemas/PatchUser"
                             }
                         }
                     },
@@ -1266,56 +1054,11 @@
                 ]
             }
         },
-        "/api/v1/ai/query": {
-            "post": {
-                "tags": ["v1", "Chat"],
-                "summary": "Query Ai Direct",
-                "description": "Send a direct question to AI (without session history).",
-                "operationId": "query_ai_direct_api_v1_ai_query_post",
-                "requestBody": {
-                    "content": {
-                        "application/json": {
-                            "schema": {
-                                "$ref": "#/components/schemas/ChatQueryRequest"
-                            }
-                        }
-                    },
-                    "required": true
-                },
-                "responses": {
-                    "200": {
-                        "description": "Successful Response",
-                        "content": {
-                            "application/json": {
-                                "schema": {
-                                    "$ref": "#/components/schemas/ChatQueryResponse"
-                                }
-                            }
-                        }
-                    },
-                    "422": {
-                        "description": "Validation Error",
-                        "content": {
-                            "application/json": {
-                                "schema": {
-                                    "$ref": "#/components/schemas/HTTPValidationError"
-                                }
-                            }
-                        }
-                    }
-                },
-                "security": [
-                    {
-                        "JWTBearer": []
-                    }
-                ]
-            }
-        },
         "/api/v1/admin/rag/config": {
             "get": {
                 "tags": ["v1", "admin"],
                 "summary": "Get full RAG config",
-                "description": "Returns the current LLM, VectorDB, and Retrieval configuration from the YAML file.",
+                "description": "Returns the current LLM, VectorDB, and Retrieval configuration from the database.",
                 "operationId": "get_full_config_api_v1_admin_rag_config_get",
                 "responses": {
                     "200": {
@@ -1404,6 +1147,32 @@
                 ]
             }
         },
+        "/api/v1/admin/rag/config/llm/options": {
+            "get": {
+                "tags": ["v1", "admin"],
+                "summary": "Get LLM provider options",
+                "description": "Returns a tree-like mapping of available LLM providers and their corresponding models and base URLs for frontend dropdowns.",
+                "operationId": "get_llm_provider_options_api_v1_admin_rag_config_llm_options_get",
+                "responses": {
+                    "200": {
+                        "description": "Successful Response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "type": "object",
+                                    "title": "Response Get Llm Provider Options Api V1 Admin Rag Config Llm Options Get"
+                                }
+                            }
+                        }
+                    }
+                },
+                "security": [
+                    {
+                        "JWTBearer": []
+                    }
+                ]
+            }
+        },
         "/api/v1/admin/rag/config/vector_db": {
             "get": {
                 "tags": ["v1", "admin"],
@@ -1431,7 +1200,7 @@
             "patch": {
                 "tags": ["v1", "admin"],
                 "summary": "Update VectorDB config",
-                "description": "Partially update the VectorDB configuration. Only provided fields will be changed.",
+                "description": "Partially update the VectorDB configuration. persist_path is read-only.",
                 "operationId": "update_vector_db_config_api_v1_admin_rag_config_vector_db_patch",
                 "requestBody": {
                     "content": {
@@ -1472,6 +1241,32 @@
                 ]
             }
         },
+        "/api/v1/admin/rag/config/vector_db/options": {
+            "get": {
+                "tags": ["v1", "admin"],
+                "summary": "Get Vector DB options",
+                "description": "Returns available embedding models for frontend dropdowns.",
+                "operationId": "get_vector_db_options_api_v1_admin_rag_config_vector_db_options_get",
+                "responses": {
+                    "200": {
+                        "description": "Successful Response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "type": "object",
+                                    "title": "Response Get Vector Db Options Api V1 Admin Rag Config Vector Db Options Get"
+                                }
+                            }
+                        }
+                    }
+                },
+                "security": [
+                    {
+                        "JWTBearer": []
+                    }
+                ]
+            }
+        },
         "/api/v1/admin/rag/config/retrieval": {
             "get": {
                 "tags": ["v1", "admin"],
@@ -1540,6 +1335,32 @@
                 ]
             }
         },
+        "/api/v1/admin/rag/config/retrieval/options": {
+            "get": {
+                "tags": ["v1", "admin"],
+                "summary": "Get Retrieval options",
+                "description": "Returns available reranker models for frontend dropdowns.",
+                "operationId": "get_retrieval_options_api_v1_admin_rag_config_retrieval_options_get",
+                "responses": {
+                    "200": {
+                        "description": "Successful Response",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "type": "object",
+                                    "title": "Response Get Retrieval Options Api V1 Admin Rag Config Retrieval Options Get"
+                                }
+                            }
+                        }
+                    }
+                },
+                "security": [
+                    {
+                        "JWTBearer": []
+                    }
+                ]
+            }
+        },
         "/api/v1/auth/api-key/generate": {
             "post": {
                 "tags": ["v1", "auth-iframe"],
@@ -1851,23 +1672,6 @@
                 "required": ["message", "user"],
                 "title": "ActivateAccountResponse"
             },
-            "ApiKeyGenerateResponse": {
-                "properties": {
-                    "api_key": {
-                        "type": "string",
-                        "title": "Api Key"
-                    },
-                    "expires_at": {
-                        "type": "string",
-                        "format": "date-time",
-                        "title": "Expires At"
-                    }
-                },
-                "type": "object",
-                "required": ["api_key"],
-                "title": "ApiKeyGenerateResponse",
-                "description": "POST /auth/api-keys — 201 response. Raw key returned ONCE."
-            },
             "ApiKeyLoginRequest": {
                 "properties": {
                     "api_key": {
@@ -1880,11 +1684,6 @@
                 "title": "ApiKeyLoginRequest",
                 "description": "POST /auth/login/api-key — body."
             },
-            "Blank": {
-                "properties": {},
-                "type": "object",
-                "title": "Blank"
-            },
             "Body_upload_document_api_v1_documents_upload_post": {
                 "properties": {
                     "file": {
@@ -1952,58 +1751,6 @@
                 "title": "ChatMessageResponse",
                 "description": "Mirrors the message object in OpenAPI spec."
             },
-            "ChatQueryRequest": {
-                "properties": {
-                    "prompt": {
-                        "type": "string",
-                        "title": "Prompt",
-                        "description": "The user\u0027s prompt text."
-                    },
-                    "course_id": {
-                        "type": "string",
-                        "title": "Course Id",
-                        "description": "UUID of the course context."
-                    }
-                },
-                "type": "object",
-                "required": ["prompt", "course_id"],
-                "title": "ChatQueryRequest",
-                "description": "Payload for direct AI query (non-session)."
-            },
-            "ChatQueryResponse": {
-                "properties": {
-                    "message_id": {
-                        "type": "string",
-                        "title": "Message Id"
-                    },
-                    "role": {
-                        "type": "string",
-                        "title": "Role",
-                        "default": "assistant"
-                    },
-                    "content": {
-                        "type": "string",
-                        "title": "Content"
-                    },
-                    "sources": {
-                        "items": {
-                            "$ref": "#/components/schemas/DocumentSourceDTO"
-                        },
-                        "type": "array",
-                        "title": "Sources",
-                        "default": []
-                    },
-                    "created_at": {
-                        "type": "string",
-                        "format": "date-time",
-                        "title": "Created At"
-                    }
-                },
-                "type": "object",
-                "required": ["message_id", "content", "created_at"],
-                "title": "ChatQueryResponse",
-                "description": "Response format for POST /ai/query (direct query without session)."
-            },
             "ChatRESTRequest": {
                 "properties": {
                     "content": {
@@ -2409,7 +2156,7 @@
                     "reasoning_effort": {
                         "type": "string",
                         "title": "Reasoning Effort",
-                        "description": "Reasoning effort for supported models. Use null for models without reasoning effort."
+                        "description": "Provider/model-specific reasoning effort. OpenAI reasoning models use values such as none, minimal, low, medium, high, or xhigh depending on the model. DeepSeek thinking mode uses high or max. Use null for models without reasoning effort."
                     },
                     "temperature": {
                         "type": "number",
@@ -2538,6 +2285,38 @@
                 "required": ["page", "limit", "total", "total_pages"],
                 "title": "PaginationDTO"
             },
+            "PatchUser": {
+                "properties": {
+                    "email": {
+                        "type": "string",
+                        "format": "email",
+                        "title": "Email"
+                    },
+                    "name": {
+                        "type": "string",
+                        "title": "Name"
+                    },
+                    "phone": {
+                        "type": "integer",
+                        "title": "Phone"
+                    },
+                    "role": {
+                        "$ref": "#/components/schemas/app__schema__auth_schema__Role"
+                    },
+                    "is_active": {
+                        "type": "boolean",
+                        "title": "Is Active"
+                    },
+                    "password": {
+                        "type": "string",
+                        "title": "Password"
+                    }
+                },
+                "additionalProperties": false,
+                "type": "object",
+                "title": "PatchUser",
+                "description": "PATCH user untuk admin: semua field opsional agar bisa edit parsial.\n\nDilarang mengubah: id, user_token."
+            },
             "RAGConfigResponse": {
                 "properties": {
                     "path": {
@@ -2582,8 +2361,9 @@
                     },
                     "identity_number": {
                         "type": "string",
+                        "pattern": "^[0-9]+$",
                         "title": "Identity Number",
-                        "description": "Student ID (NIM), Lecturer ID (NIP), or uppercase code followed by digits"
+                        "description": "Student ID (NIM) or Lecturer ID (NIP) – numbers only"
                     }
                 },
                 "type": "object",
@@ -2804,43 +2584,6 @@
                 "title": "UploadDocumentResponse",
                 "description": "POST /documents/upload — 202 Accepted response.\nSource: openapi-spec.yml /documents/upload 202 schema"
             },
-            "UpsertUser": {
-                "properties": {
-                    "email": {
-                        "type": "string",
-                        "title": "Email"
-                    },
-                    "user_token": {
-                        "type": "string",
-                        "title": "User Token"
-                    },
-                    "name": {
-                        "type": "string",
-                        "title": "Name"
-                    },
-                    "phone": {
-                        "type": "string",
-                        "title": "Phone"
-                    },
-                    "role": {
-                        "$ref": "#/components/schemas/app__schema__user_schema__Role"
-                    },
-                    "identity_number": {
-                        "type": "string",
-                        "title": "Identity Number"
-                    },
-                    "is_active": {
-                        "type": "boolean",
-                        "title": "Is Active"
-                    },
-                    "is_superuser": {
-                        "type": "boolean",
-                        "title": "Is Superuser"
-                    }
-                },
-                "type": "object",
-                "title": "UpsertUser"
-            },
             "UpsertWhitelist": {
                 "properties": {
                     "source_type": {
@@ -2871,10 +2614,6 @@
                         "type": "string",
                         "title": "Email"
                     },
-                    "user_token": {
-                        "type": "string",
-                        "title": "User Token"
-                    },
                     "name": {
                         "type": "string",
                         "title": "Name"
@@ -2911,6 +2650,10 @@
                         "type": "string",
                         "format": "date-time",
                         "title": "Updated At"
+                    },
+                    "user_token": {
+                        "type": "string",
+                        "title": "User Token"
                     }
                 },
                 "type": "object",
@@ -3059,7 +2802,7 @@
             },
             "app__schema__user_schema__Role": {
                 "type": "string",
-                "enum": ["student", "lecturer", "admin"],
+                "enum": ["admin", "student", "lecturer"],
                 "title": "Role",
                 "description": "An enumeration."
             }